@agentskit/doc-bridge 1.10.0 → 1.10.1

package/CHANGELOG.md

@@ -1,5 +1,31 @@
 # Changelog
 
+## 1.10.1
+
+### Patch Changes
+
+- 0926c57: Keep a committed index fresh across commits.
+  
+  The retrieval projection sealed its content hash over the discovery snapshot's hash, and a
+  snapshot's hash covers its `sourceRevision` — the commit SHA when the working tree is clean, a
+  digest of the scanned files when it is not. That is right for an artifact whose job is to say what
+  one revision looked like, and wrong as a projection input: the projection is a function of what the
+  snapshot observed, not of where it observed it.
+  
+  The consequence only appears in a repository that commits `.doc-bridge/index.json`, which is the
+  recommended setup: committing the index changes the revision that the next run hashes, so the
+  artifact was stale the moment it landed — landing it is a commit. `ak-docs gate run` reported
+  `index-freshness` failing on an index that nothing had invalidated, and no regenerate could fix it,
+  because the fix was itself a commit. Dogfooding on a 25-package monorepo, the gate could not be
+  made to pass twice in a row.
+  
+  The seal is now over what the snapshot observed: the entities, the relations and the analyzer
+  identity that produced them, alongside the overlay and configuration hashes it already covered. The
+  artifact still carries `snapshotHash`, now documented as provenance rather than a seal input, so a
+  reader can still say which snapshot a projection came from. `RETRIEVAL_PROJECTION_VERSION` goes to
+  2, so no reader compares a hash across the change, and every index's content hash changes once on
+  the next `ak-docs index`.
+
 ## 1.10.0
 
 ### Minor Changes

package/action.yml

@@ -20,7 +20,7 @@ inputs:
   package-version:
     description: Exact @agentskit/doc-bridge npm version (kept in sync with this Action release)
     required: false
-    default: '1.10.0'
+    default: '1.10.1'
 
 runs:
   using: composite

package/dist/cli/program.js

@@ -3616,8 +3616,13 @@ var RetrievalIndexV1Schema = z5.object({
   schemaVersion: z5.literal(RETRIEVAL_INDEX_SCHEMA_VERSION),
   contentHash: hash2,
   contentHashAlgo: z5.literal("sha256-normalized-v1"),
-  /** The three inputs the projection is a function of. Same three hashes, same projection. */
+  /**
+   * Which snapshot this was projected from. Provenance, not a seal input: it carries the
+   * snapshot's `sourceRevision`, and the projection is a function of what the snapshot observed
+   * rather than of the revision it was observed at.
+   */
   snapshotHash: hash2,
+  /** The inputs the projection is a function of. Same hashes, same projection. */
   overlayHash: hash2,
   configurationHash: hash2,
   lexiconVersion: z5.number().int().nonnegative().max(1e3),
@@ -4055,7 +4060,7 @@ var buildLookup = (config, packages, corpus, indexOutFile, humanDocs = {}, root
 };
 
 // src/version.ts
-var PACKAGE_VERSION = "1.10.0";
+var PACKAGE_VERSION = "1.10.1";
 
 // src/index-builder/capabilities.ts
 var renderCapabilitiesJson = (config, index, paths) => {
@@ -5633,7 +5638,7 @@ var resolveSearchParams = (configured) => ({
 });
 
 // src/retrieval/project.ts
-var RETRIEVAL_PROJECTION_VERSION = 1;
+var RETRIEVAL_PROJECTION_VERSION = 2;
 var DOCUMENT_BODY_LIMIT = 4e3;
 var MAX_EDGES = 64;
 var MAX_ALIASES = 32;
@@ -5641,6 +5646,12 @@ var MAX_TAGS = 32;
 var MAX_SYMBOLS = 256;
 var MAX_SUMMARY = 400;
 var EMPTY_OVERLAY_HASH = sha256NormalizedV1({ accepted: [] });
+var snapshotObservationHash = (snapshot) => sha256NormalizedV1({
+  pipelineVersion: snapshot.pipelineVersion,
+  analyzerVersions: snapshot.analyzerVersions,
+  entities: snapshot.entities,
+  relations: snapshot.relations
+});
 var CONFIDENCE_RANK = { observed: 0, declared: 1, fuzzy: 2, proposed: 3 };
 var weakerConfidence = (a, b) => CONFIDENCE_RANK[a] >= CONFIDENCE_RANK[b] ? a : b;
 var relationConfidence = (relation) => relation.metadata?.confidence === "fuzzy" ? "fuzzy" : relation.provenance;
@@ -5901,7 +5912,7 @@ var projectRetrievalIndex = (options) => {
   };
   const contentHash = sha256NormalizedV1({
     projectionVersion: RETRIEVAL_PROJECTION_VERSION,
-    snapshotHash: base.snapshotHash,
+    observationHash: snapshotObservationHash(snapshot),
     overlayHash: base.overlayHash,
     configurationHash: base.configurationHash,
     lexiconVersion: base.lexiconVersion,