sift-light 1.1.0 → 1.1.1-2

package/src/source-document.ts

@@ -222,7 +222,7 @@ export async function readWorkspaceDocument(
   });
   if (!before) throw new SourceDocumentError("source-unavailable", "Source is unavailable");
   if (expected && !sameSourceRevision(before, expected.revision)) {
-    throw new SourceDocumentError("source-changed", "Source changed; start a new inspection");
+    throw new SourceDocumentError("source-changed", "Source changed; refresh the search");
   }
   if (before.size > Math.min(MAX_SOURCE_FILE_BYTES, readBudget)) {
     throw new SourceDocumentError("file-too-large", "Source exceeds the 5 MiB file limit");
@@ -261,10 +261,7 @@ export async function readWorkspaceDocument(
   if (signal?.aborted) throw abortError();
   const hash = contentHash(bytes);
   if (expected && expected.contentHash !== hash) {
-    throw new SourceDocumentError(
-      "source-changed",
-      "Source content changed; start a new inspection",
-    );
+    throw new SourceDocumentError("source-changed", "Source content changed; refresh the search");
   }
   return new SourceDocument(
     {

package/src/source-inspection.ts

@@ -74,6 +74,7 @@ export function matchInspectionTarget(target: InspectionTarget): SourceInspectio
     path: target.path,
     line: target.line,
     unverified: target.unverified,
+    ...(target.expectedReference ? { reference: target.expectedReference } : {}),
     ...(target.expectedRevision ? { expectedRevision: target.expectedRevision } : {}),
     ...(target.retainedMatch?.occurrences[0]
       ? { focus: target.retainedMatch.occurrences[0].byteStart }

package/src/types.ts

@@ -231,6 +231,8 @@ export interface SearchScan {
   totalMatches: number;
   fileCounts: Map<string, number>;
   sourceRevisions: Map<string, SourceRevision>;
+  /** Full content identities for retained worktree matches; missing entries are unverified. */
+  sourceReferences?: Map<string, SourceReference>;
   snapshotComplete: boolean;
   filesystemCoverage?: "complete" | "policy-filtered" | "partial";
   filesystemCoverageReasons?: string[];