@gmickel/gno 1.27.0 → 1.28.0

package/src/mcp/tools/get.ts

@@ -15,6 +15,10 @@ import {
   type DocumentCapabilities,
 } from "../../core/document-capabilities";
 import { resolveEffectiveIndex } from "../../core/indexed-reference";
+import {
+  projectRecordEvidenceMetadata,
+  type RecordEvidenceMetadata,
+} from "../../core/record-metadata";
 import { parseRef } from "../../core/ref-parser";
 import {
   attachRetrievalTraceMetadata,
@@ -54,6 +58,7 @@ interface GetResponse {
     converterVersion?: string;
     mirrorHash?: string;
   };
+  record?: RecordEvidenceMetadata;
   capabilities: DocumentCapabilities;
 }
 
@@ -210,13 +215,14 @@ export function handleGet(
 
         // Build absPath
         const uriParsed = parseUri(doc.uri);
+        const sourceRelPath = doc.recordSourcePath ?? doc.relPath;
         let absPath: string | undefined;
         if (uriParsed) {
           const collection = ctx.collections.find(
             (c) => c.name === uriParsed.collection
           );
           if (collection) {
-            absPath = pathJoin(collection.path, doc.relPath);
+            absPath = pathJoin(collection.path, sourceRelPath);
           }
         }
 
@@ -230,7 +236,7 @@ export function handleGet(
           language: doc.languageHint ?? undefined,
           source: {
             absPath,
-            relPath: doc.relPath,
+            relPath: sourceRelPath,
             mime: doc.sourceMime,
             ext: doc.sourceExt,
             modifiedAt: doc.sourceMtime,
@@ -244,10 +250,12 @@ export function handleGet(
                 mirrorHash: doc.mirrorHash,
               }
             : undefined,
+          record: projectRecordEvidenceMetadata(doc),
           capabilities: getDocumentCapabilities({
             sourceExt: doc.sourceExt,
             sourceMime: doc.sourceMime,
             contentAvailable: doc.mirrorHash !== null,
+            recordKey: doc.recordKey,
           }),
         };
 

package/src/mcp/tools/multi-get.ts

@@ -11,6 +11,10 @@ import type { ToolContext } from "../server";
 
 import { decorateUriForIndex, parseUri } from "../../app/constants";
 import { resolveEffectiveIndex } from "../../core/indexed-reference";
+import {
+  projectRecordEvidenceMetadata,
+  type RecordEvidenceMetadata,
+} from "../../core/record-metadata";
 import { parseRef } from "../../core/ref-parser";
 import { openScopedIndexStore } from "../../store/sqlite/scoped-index";
 import { runTool, type ToolResult } from "./index";
@@ -37,6 +41,7 @@ interface DocumentResult {
     modifiedAt?: string;
     sizeBytes?: number;
   };
+  record?: RecordEvidenceMetadata;
 }
 
 interface MultiGetResponse {
@@ -234,13 +239,14 @@ export function handleMultiGet(
 
           // Build absPath
           const uriParsed = parseUri(doc.uri);
+          const sourceRelPath = doc.recordSourcePath ?? doc.relPath;
           let absPath: string | undefined;
           if (uriParsed) {
             const collection = ctx.collections.find(
               (c) => c.name === uriParsed.collection
             );
             if (collection) {
-              absPath = pathJoin(collection.path, doc.relPath);
+              absPath = pathJoin(collection.path, sourceRelPath);
             }
           }
 
@@ -253,12 +259,13 @@ export function handleMultiGet(
             truncated,
             source: {
               absPath,
-              relPath: doc.relPath,
+              relPath: sourceRelPath,
               mime: doc.sourceMime,
               ext: doc.sourceExt,
               modifiedAt: doc.sourceMtime,
               sizeBytes: doc.sourceSize,
             },
+            record: projectRecordEvidenceMetadata(doc),
           });
         }
 

package/src/mcp/tools/workspace-write.ts

@@ -141,11 +141,13 @@ function ensureEditable(doc: {
   sourceExt: string;
   sourceMime: string;
   mirrorHash: string | null;
+  recordKey?: string | null;
 }) {
   const capabilities = getDocumentCapabilities({
     sourceExt: doc.sourceExt,
     sourceMime: doc.sourceMime,
     contentAvailable: doc.mirrorHash !== null,
+    recordKey: doc.recordKey,
   });
   if (!capabilities.editable) {
     throw new Error(

package/src/pipeline/filters.ts

@@ -62,7 +62,7 @@ export function evaluateDocumentChunkFilters(
     matchesExcludedText(
       [
         doc.title ?? "",
-        doc.relPath,
+        doc.recordSourcePath ?? doc.relPath,
         doc.author ?? "",
         doc.contentType ?? "",
         ...(doc.categories ?? []),

package/src/pipeline/graph-retrieval.ts

@@ -42,6 +42,9 @@ const EMPTY_EDGE_CONFIDENCE: Record<GraphEdgeConfidence, number> = {
   similarity: 0,
 };
 
+const sourceRelPath = (doc: DocumentRow): string =>
+  doc.recordSourcePath ?? doc.relPath;
+
 const confidenceWeight = (confidence: GraphEdgeConfidence): number => {
   switch (confidence) {
     case "explicit":
@@ -253,8 +256,8 @@ export async function expandGraphCandidates(
     }
     if (
       options.relPathPrefix !== undefined &&
-      doc.relPath !== options.relPathPrefix &&
-      !doc.relPath.startsWith(`${options.relPathPrefix}/`)
+      sourceRelPath(doc) !== options.relPathPrefix &&
+      !sourceRelPath(doc).startsWith(`${options.relPathPrefix}/`)
     ) {
       continue;
     }
@@ -337,8 +340,8 @@ export async function expandGraphCandidates(
     (doc) =>
       doc.mirrorHash &&
       (options.relPathPrefix === undefined ||
-        doc.relPath === options.relPathPrefix ||
-        doc.relPath.startsWith(`${options.relPathPrefix}/`)) &&
+        sourceRelPath(doc) === options.relPathPrefix ||
+        sourceRelPath(doc).startsWith(`${options.relPathPrefix}/`)) &&
       matchesDocumentFilters(doc, options)
   );
   const docs = await filterDocsByTags(store, metadataFilteredDocs, options);

package/src/pipeline/hybrid.ts

@@ -21,6 +21,7 @@ import type {
 } from "./types";
 
 import { normalizeContentTypes } from "../config/content-types";
+import { projectRecordEvidenceMetadata } from "../core/record-metadata";
 import { embedTextsWithRecovery } from "../embed/batch";
 import { err, ok } from "../store/types";
 import { createChunkLookup } from "./chunk-lookup";
@@ -840,10 +841,11 @@ export async function searchHybrid(
   };
   const matchesMetadataFilters = (doc: DocumentRow): boolean => {
     const relPathPrefix = options.retrievalScope?.relPathPrefix;
+    const sourceRelPath = doc.recordSourcePath ?? doc.relPath;
     if (
       relPathPrefix !== undefined &&
-      doc.relPath !== relPathPrefix &&
-      !doc.relPath.startsWith(`${relPathPrefix}/`)
+      sourceRelPath !== relPathPrefix &&
+      !sourceRelPath.startsWith(`${relPathPrefix}/`)
     ) {
       return false;
     }
@@ -1052,9 +1054,9 @@ export async function searchHybrid(
         snippetLanguage: chunk.language ?? undefined,
         snippetRange,
         source: {
-          relPath: doc.relPath,
+          relPath: doc.recordSourcePath ?? doc.relPath,
           absPath: collectionPath
-            ? `${collectionPath}/${doc.relPath}`
+            ? `${collectionPath}/${doc.recordSourcePath ?? doc.relPath}`
             : undefined,
           mime: doc.sourceMime,
           ext: doc.sourceExt,
@@ -1068,6 +1070,7 @@ export async function searchHybrid(
           converterId: doc.converterId ?? undefined,
           converterVersion: doc.converterVersion ?? undefined,
         },
+        record: projectRecordEvidenceMetadata(doc),
       };
       const auxiliaryBaseScore =
         auxiliaryBaseScores.get(`${candidate.mirrorHash}:${candidate.seq}`) ??

package/src/pipeline/result-context.ts

@@ -16,10 +16,18 @@ export async function attachSearchResultContexts(
   results: SearchResult[]
 ): Promise<void> {
   const validResults = results
-    .map((result) => ({
-      identity: contextIdentityFromUri(result.uri),
-      result,
-    }))
+    .map((result) => {
+      const uriIdentity = contextIdentityFromUri(result.uri);
+      return {
+        identity: uriIdentity
+          ? {
+              collection: uriIdentity.collection,
+              relPath: result.source.relPath,
+            }
+          : null,
+        result,
+      };
+    })
     .filter(
       (
         entry

package/src/pipeline/search.ts

@@ -15,6 +15,7 @@ import type {
   SearchResults,
 } from "./types";
 
+import { projectRecordEvidenceMetadata } from "../core/record-metadata";
 import { getContentBatch } from "../store/content-batch";
 import { err, ok } from "../store/types";
 import { createChunkLookup } from "./chunk-lookup";
@@ -85,8 +86,9 @@ interface BuildResultContext {
 /** Build SearchResult from FtsResult and related data */
 function buildSearchResult(ctx: BuildResultContext): SearchResult {
   const { fts, chunk, collectionPath, options, fullContent } = ctx;
+  const sourceRelPath = fts.recordSourcePath ?? fts.relPath ?? "";
   const source: SearchResultSource = {
-    relPath: fts.relPath ?? "",
+    relPath: sourceRelPath,
     // Use actual source metadata with fallback to markdown defaults
     mime: fts.sourceMime ?? "text/markdown",
     ext: fts.sourceExt ?? ".md",
@@ -97,8 +99,8 @@ function buildSearchResult(ctx: BuildResultContext): SearchResult {
   };
 
   // Add absPath if we have collection path (cross-platform safe)
-  if (collectionPath && fts.relPath) {
-    source.absPath = pathJoin(collectionPath, fts.relPath);
+  if (collectionPath && sourceRelPath) {
+    source.absPath = pathJoin(collectionPath, sourceRelPath);
   }
 
   // Determine snippet content and range
@@ -134,6 +136,7 @@ function buildSearchResult(ctx: BuildResultContext): SearchResult {
     snippetRange,
     source,
     conversion: fts.mirrorHash ? { mirrorHash: fts.mirrorHash } : undefined,
+    record: projectRecordEvidenceMetadata(fts),
   };
   if (!(chunk && fts.mirrorHash)) return result;
   return attachSearchResultPlannerMetadata(result, {
@@ -287,7 +290,11 @@ export async function searchBm25(
 
     const excluded =
       matchesExcludedText(
-        [fts.title ?? "", fts.relPath ?? "", fts.snippet ?? ""],
+        [
+          fts.title ?? "",
+          fts.recordSourcePath ?? fts.relPath ?? "",
+          fts.snippet ?? "",
+        ],
         options.exclude
       ) ||
       matchesExcludedChunks(

package/src/pipeline/types.ts

@@ -10,6 +10,7 @@ import type {
   ContextCapsuleV1,
   ContextCapsuleVerification,
 } from "../core/context-capsule";
+import type { RecordEvidenceMetadata } from "../core/record-metadata";
 import type { RetrievalTraceSession } from "../core/retrieval-trace-session";
 import type { StoreResult } from "../store/types";
 import type { ClaimVerificationResult } from "./claim-verification";
@@ -86,6 +87,8 @@ export interface SearchResult {
   context?: string;
   source: SearchResultSource;
   conversion?: SearchResultConversion;
+  /** Bounded logical-record provenance for file/export adapters. */
+  record?: RecordEvidenceMetadata;
   [SEARCH_RESULT_PLANNER_METADATA]?: SearchResultPlannerMetadata;
 }
 

package/src/pipeline/vsearch.ts

@@ -7,11 +7,12 @@
 
 import type { Config } from "../config/types";
 import type { EmbeddingPort } from "../llm/types";
-import type { StorePort } from "../store/types";
+import type { DocumentRow, StorePort } from "../store/types";
 import type { VectorIndexPort } from "../store/vector/types";
 import type { SearchOptions, SearchResult, SearchResults } from "./types";
 
 import { normalizeContentTypes } from "../config/content-types";
+import { projectRecordEvidenceMetadata } from "../core/record-metadata";
 import { getContentBatch } from "../store/content-batch";
 import { err, ok } from "../store/types";
 import { createChunkLookup } from "./chunk-lookup";
@@ -213,11 +214,12 @@ export async function searchVectorWithEmbedding(
     const docs = auxiliaryRankingActive ? matchingDocs : [matchingDocs.at(-1)!];
     for (const doc of docs) {
       const collectionPath = collectionPaths.get(doc.collection);
+      const sourceRelPath = doc.recordSourcePath ?? doc.relPath;
       const excluded =
         matchesExcludedText(
           [
             doc.title ?? "",
-            doc.relPath,
+            sourceRelPath,
             doc.author ?? "",
             doc.contentType ?? "",
             ...(doc.categories ?? []),
@@ -248,9 +250,9 @@ export async function searchVectorWithEmbedding(
             endLine: chunk.endLine,
           },
           source: {
-            relPath: doc.relPath,
+            relPath: sourceRelPath,
             absPath: collectionPath
-              ? `${collectionPath}/${doc.relPath}`
+              ? `${collectionPath}/${sourceRelPath}`
               : undefined,
             mime: doc.sourceMime,
             ext: doc.sourceExt,
@@ -266,6 +268,7 @@ export async function searchVectorWithEmbedding(
                 converterVersion: doc.converterVersion ?? undefined,
               }
             : undefined,
+          record: projectRecordEvidenceMetadata(doc),
         },
         doc.collection,
         contentTypeRules,
@@ -332,6 +335,7 @@ export async function searchVectorWithEmbedding(
         : undefined;
 
       const collectionPath = collectionPaths.get(doc.collection);
+      const sourceRelPath = doc.recordSourcePath ?? doc.relPath;
 
       const result = applyContentTypeBoost(
         {
@@ -349,9 +353,9 @@ export async function searchVectorWithEmbedding(
             ? undefined
             : { startLine: chunk.startLine, endLine: chunk.endLine },
           source: {
-            relPath: doc.relPath,
+            relPath: sourceRelPath,
             absPath: collectionPath
-              ? `${collectionPath}/${doc.relPath}`
+              ? `${collectionPath}/${sourceRelPath}`
               : undefined,
             mime: doc.sourceMime,
             ext: doc.sourceExt,
@@ -367,6 +371,7 @@ export async function searchVectorWithEmbedding(
                 converterVersion: doc.converterVersion ?? undefined,
               }
             : undefined,
+          record: projectRecordEvidenceMetadata(doc),
         },
         doc.collection,
         contentTypeRules,
@@ -514,6 +519,12 @@ interface DocumentInfo {
   mirrorHash: string | null;
   converterId: string | null;
   converterVersion: string | null;
+  recordKey: DocumentRow["recordKey"];
+  recordSourcePath: DocumentRow["recordSourcePath"];
+  recordSourceLocator: DocumentRow["recordSourceLocator"];
+  recordMetadata: DocumentRow["recordMetadata"];
+  recordAnchors: DocumentRow["recordAnchors"];
+  recordAdapterFingerprint: DocumentRow["recordAdapterFingerprint"];
 }
 
 // ─────────────────────────────────────────────────────────────────────────────
@@ -611,10 +622,11 @@ async function buildDocumentMap(
   }
 
   for (const doc of activeDocs) {
+    const sourceRelPath = doc.recordSourcePath ?? doc.relPath;
     if (
       options.relPathPrefix !== undefined &&
-      doc.relPath !== options.relPathPrefix &&
-      !doc.relPath.startsWith(`${options.relPathPrefix}/`)
+      sourceRelPath !== options.relPathPrefix &&
+      !sourceRelPath.startsWith(`${options.relPathPrefix}/`)
     ) {
       continue;
     }
@@ -655,6 +667,12 @@ async function buildDocumentMap(
       mirrorHash: doc.mirrorHash,
       converterId: doc.converterId,
       converterVersion: doc.converterVersion,
+      recordKey: doc.recordKey,
+      recordSourcePath: doc.recordSourcePath,
+      recordSourceLocator: doc.recordSourceLocator,
+      recordMetadata: doc.recordMetadata,
+      recordAnchors: doc.recordAnchors,
+      recordAdapterFingerprint: doc.recordAdapterFingerprint,
     };
     const matchingDocuments = result.get(doc.mirrorHash!) ?? [];
     matchingDocuments.push(documentInfo);

package/src/sdk/documents.ts

@@ -23,6 +23,7 @@ import type {
 } from "./types";
 
 import { getDocumentCapabilities } from "../core/document-capabilities";
+import { projectRecordEvidenceMetadata } from "../core/record-metadata";
 import { isGlobPattern, parseRef, splitRefs } from "../core/ref-parser";
 import {
   attachRetrievalTraceMetadata,
@@ -53,9 +54,10 @@ function buildSourceMeta(
   config: Config
 ): GetResponse["source"] {
   const coll = config.collections.find((c) => c.name === doc.collection);
+  const relPath = doc.recordSourcePath ?? doc.relPath;
   return {
-    absPath: coll ? `${coll.path}/${doc.relPath}` : undefined,
-    relPath: doc.relPath,
+    absPath: coll ? `${coll.path}/${relPath}` : undefined,
+    relPath,
     mime: doc.sourceMime,
     ext: doc.sourceExt,
     sizeBytes: doc.sourceSize,
@@ -129,10 +131,12 @@ async function getDocumentByRefUntraced(
       language: doc.languageHint ?? undefined,
       source: buildSourceMeta(doc, config),
       conversion: buildConversionMeta(doc),
+      record: projectRecordEvidenceMetadata(doc),
       capabilities: getDocumentCapabilities({
         sourceExt: doc.sourceExt,
         sourceMime: doc.sourceMime,
         contentAvailable: doc.mirrorHash !== null,
+        recordKey: doc.recordKey,
       }),
     };
   }
@@ -156,10 +160,12 @@ async function getDocumentByRefUntraced(
     language: doc.languageHint ?? undefined,
     source: buildSourceMeta(doc, config),
     conversion: buildConversionMeta(doc),
+    record: projectRecordEvidenceMetadata(doc),
     capabilities: getDocumentCapabilities({
       sourceExt: doc.sourceExt,
       sourceMime: doc.sourceMime,
       contentAvailable: doc.mirrorHash !== null,
+      recordKey: doc.recordKey,
     }),
   };
 }
@@ -318,6 +324,7 @@ export async function multiGetDocuments(
       maxBytes
     );
     const coll = config.collections.find((c) => c.name === doc.collection);
+    const sourceRelPath = doc.recordSourcePath ?? doc.relPath;
     documents.push({
       docid: doc.docid,
       uri: doc.uri,
@@ -326,11 +333,12 @@ export async function multiGetDocuments(
       truncated: truncated || undefined,
       totalLines: content.split("\n").length,
       source: {
-        absPath: coll ? `${coll.path}/${doc.relPath}` : undefined,
-        relPath: doc.relPath,
+        absPath: coll ? `${coll.path}/${sourceRelPath}` : undefined,
+        relPath: sourceRelPath,
         mime: doc.sourceMime,
         ext: doc.sourceExt,
       },
+      record: projectRecordEvidenceMetadata(doc),
     });
   }
 
@@ -385,7 +393,7 @@ export async function listDocuments(
       uri: d.uri,
       title: d.title ?? undefined,
       source: {
-        relPath: d.relPath,
+        relPath: d.recordSourcePath ?? d.relPath,
         mime: d.sourceMime,
         ext: d.sourceExt,
       },

package/src/serve/browse-tree.ts

@@ -15,7 +15,7 @@ export interface BrowseTreeNode {
 type BrowseCollectionLike = Pick<CollectionRow, "name">;
 type BrowseDocumentLike = Pick<
   DocumentRow,
-  "collection" | "relPath" | "active"
+  "collection" | "relPath" | "recordSourcePath" | "active"
 >;
 type BrowseFolderLike = {
   collection: string;
@@ -128,7 +128,9 @@ export function buildBrowseTree(
 
     root.documentCount += 1;
 
-    const normalizedRelPath = normalizeBrowsePath(doc.relPath);
+    const normalizedRelPath = normalizeBrowsePath(
+      doc.recordSourcePath ?? doc.relPath
+    );
     const parts = normalizedRelPath.split("/").filter(Boolean);
     const folderParts = parts.slice(0, -1);