move the SHA1 commit field from the VolumeMetadata to Vertex.Global

Author: tayloraswift

Sources/SwiftinitPages/Surfaces/Vertices/Swiftinit.Docs.Package.swift

@@ -302,7 +302,7 @@ extension Swiftinit.Docs.Package:Swiftinit.VersionedPage
                 $0[.dt] = "Symbol Graph ABI"
                 $0[.dd] = "\(self.vertex.snapshot.abi)"
 
-                if  let commit:SHA1 = self.volume.commit
+                if  let commit:SHA1 = self.vertex.snapshot.commit
                 {
                     $0[.dt] = "Git Revision"
                     $0[.dd]

Sources/UnidocDB/UnidocDatabase.swift

@@ -556,7 +556,6 @@ extension UnidocDatabase
             dependencies: dependencies,
             display: snapshot.metadata.display,
             refname: snapshot.metadata.commit?.refname,
-            commit: snapshot.metadata.commit?.hash,
             symbol: .init(
                 //  We want the version component of the volume symbol to be stable,
                 //  so we only encode the patch version, even if the symbol graph is

Sources/UnidocLinker/Linker/DynamicLinker.Mesh.swift

@@ -61,7 +61,8 @@ extension DynamicLinker.Mesh
         }
 
         var snapshot:Unidoc.SnapshotDetails = .init(abi: context.current.metadata.abi,
-            requirements: context.current.metadata.requirements)
+            requirements: context.current.metadata.requirements,
+            commit: context.current.metadata.commit?.hash)
         var foreign:[Unidoc.Vertex.Foreign] = []
 
         //  Compute shoots for out-of-package extended types.

Sources/UnidocQueries/Volumes/Unidoc.VertexQuery.swift

@@ -239,7 +239,6 @@ extension Unidoc.VertexQuery:Unidoc.VolumeQuery
                             .version,
                             .display,
                             .refname,
-                            .commit,
                             .patch,
 
                             //  TODO: we only need this for top-level queries and

Sources/UnidocRecords/Volumes/Metadata/Unidoc.VolumeMetadata.swift

@@ -19,8 +19,6 @@ extension Unidoc
         var display:String?
         public
         var refname:String?
-        public
-        var commit:SHA1?
 
         public
         var symbol:Symbol.Edition
@@ -43,7 +41,6 @@ extension Unidoc
             dependencies:[Dependency] = [],
             display:String? = nil,
             refname:String? = nil,
-            commit:SHA1? = nil,
             symbol:Symbol.Edition,
             latest:Bool,
             realm:Unidoc.Realm?,
@@ -56,7 +53,6 @@ extension Unidoc
             self.dependencies = dependencies
             self.display = display
             self.refname = refname
-            self.commit = commit
             self.symbol = symbol
             self.latest = latest
             self.realm = realm
@@ -103,7 +99,10 @@ extension Unidoc.VolumeMetadata
         /// to match (and duplicate) the refname in the associated ``Unidoc.EditionMetadata``
         /// record.
         case refname = "G"
+
+        @available(*, unavailable)
         case commit = "H"
+
         case patch = "S"
         case tree = "X"
 
@@ -143,7 +142,6 @@ extension Unidoc.VolumeMetadata:BSONDocumentEncodable
 
         bson[.display] = self.display
         bson[.refname] = self.refname
-        bson[.commit] = self.commit
 
         bson[.latest] = self.latest ? true : nil
         bson[.realm] = self.realm
@@ -173,7 +171,6 @@ extension Unidoc.VolumeMetadata:BSONDocumentDecodable
             dependencies: try bson[.dependencies]?.decode() ?? [],
             display: try bson[.display]?.decode(),
             refname: try bson[.refname]?.decode(),
-            commit: try bson[.commit]?.decode(),
             symbol: .init(
                 package: try bson[.package].decode(),
                 version: try bson[.version].decode()),
@@ -182,6 +179,6 @@ extension Unidoc.VolumeMetadata:BSONDocumentDecodable
             patch: try bson[.patch]?.decode(),
             tree: try bson[.tree]?.decode(as: Unidoc.NounTable.self, with: \.rows) ?? [])
 
-        self.abi = try bson[.abi]?.decode() ?? .v(0, 1)
+        self.abi = try bson[.abi].decode()
     }
 }

Sources/UnidocRecords/Volumes/Unidoc.Volume.swift

@@ -11,7 +11,7 @@ extension Unidoc
         var latest:Edition?
 
         public
-        var metadata:Unidoc.VolumeMetadata
+        var metadata:VolumeMetadata
         public
         var vertices:Vertices
         public
@@ -22,8 +22,8 @@ extension Unidoc
         var trees:[TypeTree]
 
         @inlinable public
-        init(latest:Unidoc.Edition?,
-            metadata:Unidoc.VolumeMetadata,
+        init(latest:Edition?,
+            metadata:VolumeMetadata,
             vertices:Vertices,
             groups:Groups,
             index:JSON,

Sources/UnidocRecords/Volumes/Vertices/Unidoc.SnapshotDetails.swift

@@ -1,5 +1,6 @@
 import BSON
 import SemanticVersions
+import SHA1
 import SymbolGraphs
 
 extension Unidoc
@@ -15,6 +16,9 @@ extension Unidoc
         /// `Package.swift` manifest.
         public
         var requirements:[SymbolGraphMetadata.PlatformRequirement]
+        /// The git commit to associate with this snapshot.
+        public
+        var commit:SHA1?
         /// Top-level linker statistics.
         public
         var census:Unidoc.Census
@@ -24,10 +28,12 @@ extension Unidoc
         @inlinable public
         init(abi:PatchVersion,
             requirements:[SymbolGraphMetadata.PlatformRequirement],
+            commit:SHA1?,
             census:Unidoc.Census = .init())
         {
             self.abi = abi
             self.requirements = requirements
+            self.commit = commit
             self.census = census
         }
     }
@@ -39,6 +45,7 @@ extension Unidoc.SnapshotDetails
     {
         case abi = "B"
         case requirements = "O"
+        case commit = "H"
         case census = "C"
     }
 }
@@ -49,6 +56,7 @@ extension Unidoc.SnapshotDetails:BSONDocumentEncodable
     {
         bson[.abi] = self.abi
         bson[.requirements] = self.requirements.isEmpty ? nil : self.requirements
+        bson[.commit] = self.commit
         bson[.census] = self.census
     }
 }
@@ -59,6 +67,7 @@ extension Unidoc.SnapshotDetails:BSONDocumentDecodable
     {
         self.init(abi: try bson[.abi].decode(),
             requirements: try bson[.requirements]?.decode() ?? [],
+            commit: try bson[.commit]?.decode(),
             census: try bson[.census].decode())
     }
 }