@remnic/core 9.3.710 → 9.3.711

package/dist/schemas.d.ts

@@ -290,12 +290,12 @@ declare const EntityMentionSchema: z.ZodObject<{
         title: z.ZodString;
         facts: z.ZodArray<z.ZodString, "many">;
     }, "strip", z.ZodTypeAny, {
-        title: string;
         key: string;
+        title: string;
         facts: string[];
     }, {
-        title: string;
         key: string;
+        title: string;
         facts: string[];
     }>, "many">>>;
 }, "strip", z.ZodTypeAny, {
@@ -303,8 +303,8 @@ declare const EntityMentionSchema: z.ZodObject<{
     name: string;
     facts: string[];
     structuredSections?: {
-        title: string;
         key: string;
+        title: string;
         facts: string[];
     }[] | null | undefined;
     promptedByQuestion?: string | null | undefined;
@@ -313,8 +313,8 @@ declare const EntityMentionSchema: z.ZodObject<{
     name: string;
     facts: string[];
     structuredSections?: {
-        title: string;
         key: string;
+        title: string;
         facts: string[];
     }[] | null | undefined;
     promptedByQuestion?: string | null | undefined;
@@ -614,12 +614,12 @@ declare const ProactiveExtractionResultSchema: z.ZodObject<{
             title: z.ZodString;
             facts: z.ZodArray<z.ZodString, "many">;
         }, "strip", z.ZodTypeAny, {
-            title: string;
             key: string;
+            title: string;
             facts: string[];
         }, {
-            title: string;
             key: string;
+            title: string;
             facts: string[];
         }>, "many">>>;
     }, "strip", z.ZodTypeAny, {
@@ -627,8 +627,8 @@ declare const ProactiveExtractionResultSchema: z.ZodObject<{
         name: string;
         facts: string[];
         structuredSections?: {
-            title: string;
             key: string;
+            title: string;
             facts: string[];
         }[] | null | undefined;
         promptedByQuestion?: string | null | undefined;
@@ -637,8 +637,8 @@ declare const ProactiveExtractionResultSchema: z.ZodObject<{
         name: string;
         facts: string[];
         structuredSections?: {
-            title: string;
             key: string;
+            title: string;
             facts: string[];
         }[] | null | undefined;
         promptedByQuestion?: string | null | undefined;
@@ -698,8 +698,8 @@ declare const ProactiveExtractionResultSchema: z.ZodObject<{
         name: string;
         facts: string[];
         structuredSections?: {
-            title: string;
             key: string;
+            title: string;
             facts: string[];
         }[] | null | undefined;
         promptedByQuestion?: string | null | undefined;
@@ -750,8 +750,8 @@ declare const ProactiveExtractionResultSchema: z.ZodObject<{
         name: string;
         facts: string[];
         structuredSections?: {
-            title: string;
             key: string;
+            title: string;
             facts: string[];
         }[] | null | undefined;
         promptedByQuestion?: string | null | undefined;
@@ -1003,12 +1003,12 @@ declare const ExtractionResultSchema: z.ZodObject<{
             title: z.ZodString;
             facts: z.ZodArray<z.ZodString, "many">;
         }, "strip", z.ZodTypeAny, {
-            title: string;
             key: string;
+            title: string;
             facts: string[];
         }, {
-            title: string;
             key: string;
+            title: string;
             facts: string[];
         }>, "many">>>;
     }, "strip", z.ZodTypeAny, {
@@ -1016,8 +1016,8 @@ declare const ExtractionResultSchema: z.ZodObject<{
         name: string;
         facts: string[];
         structuredSections?: {
-            title: string;
             key: string;
+            title: string;
             facts: string[];
         }[] | null | undefined;
         promptedByQuestion?: string | null | undefined;
@@ -1026,8 +1026,8 @@ declare const ExtractionResultSchema: z.ZodObject<{
         name: string;
         facts: string[];
         structuredSections?: {
-            title: string;
             key: string;
+            title: string;
             facts: string[];
         }[] | null | undefined;
         promptedByQuestion?: string | null | undefined;
@@ -1106,8 +1106,8 @@ declare const ExtractionResultSchema: z.ZodObject<{
         name: string;
         facts: string[];
         structuredSections?: {
-            title: string;
             key: string;
+            title: string;
             facts: string[];
         }[] | null | undefined;
         promptedByQuestion?: string | null | undefined;
@@ -1164,8 +1164,8 @@ declare const ExtractionResultSchema: z.ZodObject<{
         name: string;
         facts: string[];
         structuredSections?: {
-            title: string;
             key: string;
+            title: string;
             facts: string[];
         }[] | null | undefined;
         promptedByQuestion?: string | null | undefined;
@@ -1229,12 +1229,12 @@ declare const ConsolidationResultSchema: z.ZodObject<{
             title: z.ZodString;
             facts: z.ZodArray<z.ZodString, "many">;
         }, "strip", z.ZodTypeAny, {
-            title: string;
             key: string;
+            title: string;
             facts: string[];
         }, {
-            title: string;
             key: string;
+            title: string;
             facts: string[];
         }>, "many">>>;
     }, "strip", z.ZodTypeAny, {
@@ -1242,8 +1242,8 @@ declare const ConsolidationResultSchema: z.ZodObject<{
         name: string;
         facts: string[];
         structuredSections?: {
-            title: string;
             key: string;
+            title: string;
             facts: string[];
         }[] | null | undefined;
         promptedByQuestion?: string | null | undefined;
@@ -1252,8 +1252,8 @@ declare const ConsolidationResultSchema: z.ZodObject<{
         name: string;
         facts: string[];
         structuredSections?: {
-            title: string;
             key: string;
+            title: string;
             facts: string[];
         }[] | null | undefined;
         promptedByQuestion?: string | null | undefined;
@@ -1272,8 +1272,8 @@ declare const ConsolidationResultSchema: z.ZodObject<{
         name: string;
         facts: string[];
         structuredSections?: {
-            title: string;
             key: string;
+            title: string;
             facts: string[];
         }[] | null | undefined;
         promptedByQuestion?: string | null | undefined;
@@ -1292,8 +1292,8 @@ declare const ConsolidationResultSchema: z.ZodObject<{
         name: string;
         facts: string[];
         structuredSections?: {
-            title: string;
             key: string;
+            title: string;
             facts: string[];
         }[] | null | undefined;
         promptedByQuestion?: string | null | undefined;

package/dist/transfer/types.d.ts

@@ -313,13 +313,13 @@ declare const CapsuleBlockSchema: z.ZodObject<{
         peerProfiles: boolean;
     }>;
 }, "strip", z.ZodTypeAny, {
-    schemaVersion: string;
     includes: {
         procedural: boolean;
         taxonomy: boolean;
         identityAnchors: boolean;
         peerProfiles: boolean;
     };
+    schemaVersion: string;
     id: string;
     version: string;
     description: string;
@@ -334,13 +334,13 @@ declare const CapsuleBlockSchema: z.ZodObject<{
         directAnswerEnabled: boolean;
     };
 }, {
-    schemaVersion: string;
     includes: {
         procedural: boolean;
         taxonomy: boolean;
         identityAnchors: boolean;
         peerProfiles: boolean;
     };
+    schemaVersion: string;
     id: string;
     version: string;
     description: string;
@@ -464,13 +464,13 @@ declare const ExportManifestV2Schema: z.ZodObject<{
             peerProfiles: boolean;
         }>;
     }, "strip", z.ZodTypeAny, {
-        schemaVersion: string;
         includes: {
             procedural: boolean;
             taxonomy: boolean;
             identityAnchors: boolean;
             peerProfiles: boolean;
         };
+        schemaVersion: string;
         id: string;
         version: string;
         description: string;
@@ -485,13 +485,13 @@ declare const ExportManifestV2Schema: z.ZodObject<{
             directAnswerEnabled: boolean;
         };
     }, {
-        schemaVersion: string;
         includes: {
             procedural: boolean;
             taxonomy: boolean;
             identityAnchors: boolean;
             peerProfiles: boolean;
         };
+        schemaVersion: string;
         id: string;
         version: string;
         description: string;
@@ -518,13 +518,13 @@ declare const ExportManifestV2Schema: z.ZodObject<{
     pluginVersion: string;
     includesTranscripts: boolean;
     capsule: {
-        schemaVersion: string;
         includes: {
             procedural: boolean;
             taxonomy: boolean;
             identityAnchors: boolean;
             peerProfiles: boolean;
         };
+        schemaVersion: string;
         id: string;
         version: string;
         description: string;
@@ -551,13 +551,13 @@ declare const ExportManifestV2Schema: z.ZodObject<{
     pluginVersion: string;
     includesTranscripts: boolean;
     capsule: {
-        schemaVersion: string;
         includes: {
             procedural: boolean;
             taxonomy: boolean;
             identityAnchors: boolean;
             peerProfiles: boolean;
         };
+        schemaVersion: string;
         id: string;
         version: string;
         description: string;
@@ -683,13 +683,13 @@ declare const ExportBundleV2Schema: z.ZodObject<{
                 peerProfiles: boolean;
             }>;
         }, "strip", z.ZodTypeAny, {
-            schemaVersion: string;
             includes: {
                 procedural: boolean;
                 taxonomy: boolean;
                 identityAnchors: boolean;
                 peerProfiles: boolean;
             };
+            schemaVersion: string;
             id: string;
             version: string;
             description: string;
@@ -704,13 +704,13 @@ declare const ExportBundleV2Schema: z.ZodObject<{
                 directAnswerEnabled: boolean;
             };
         }, {
-            schemaVersion: string;
             includes: {
                 procedural: boolean;
                 taxonomy: boolean;
                 identityAnchors: boolean;
                 peerProfiles: boolean;
             };
+            schemaVersion: string;
             id: string;
             version: string;
             description: string;
@@ -737,13 +737,13 @@ declare const ExportBundleV2Schema: z.ZodObject<{
         pluginVersion: string;
         includesTranscripts: boolean;
         capsule: {
-            schemaVersion: string;
             includes: {
                 procedural: boolean;
                 taxonomy: boolean;
                 identityAnchors: boolean;
                 peerProfiles: boolean;
             };
+            schemaVersion: string;
             id: string;
             version: string;
             description: string;
@@ -770,13 +770,13 @@ declare const ExportBundleV2Schema: z.ZodObject<{
         pluginVersion: string;
         includesTranscripts: boolean;
         capsule: {
-            schemaVersion: string;
             includes: {
                 procedural: boolean;
                 taxonomy: boolean;
                 identityAnchors: boolean;
                 peerProfiles: boolean;
             };
+            schemaVersion: string;
             id: string;
             version: string;
             description: string;
@@ -819,13 +819,13 @@ declare const ExportBundleV2Schema: z.ZodObject<{
         pluginVersion: string;
         includesTranscripts: boolean;
         capsule: {
-            schemaVersion: string;
             includes: {
                 procedural: boolean;
                 taxonomy: boolean;
                 identityAnchors: boolean;
                 peerProfiles: boolean;
             };
+            schemaVersion: string;
             id: string;
             version: string;
             description: string;
@@ -858,13 +858,13 @@ declare const ExportBundleV2Schema: z.ZodObject<{
         pluginVersion: string;
         includesTranscripts: boolean;
         capsule: {
-            schemaVersion: string;
             includes: {
                 procedural: boolean;
                 taxonomy: boolean;
                 identityAnchors: boolean;
                 peerProfiles: boolean;
             };
+            schemaVersion: string;
             id: string;
             version: string;
             description: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@remnic/core",
-  "version": "9.3.710",
+  "version": "9.3.711",
   "description": "Framework-agnostic Remnic memory engine — orchestrator, storage, extraction, search, trust zones",
   "type": "module",
   "main": "dist/index.js",
@@ -2966,7 +2966,7 @@
     "core"
   ],
   "peerDependencies": {
-    "@remnic/coding-graph": "^9.3.710"
+    "@remnic/coding-graph": "^9.3.711"
   },
   "peerDependenciesMeta": {
     "@remnic/coding-graph": {

package/src/operator-toolkit.ts

@@ -1060,6 +1060,25 @@ async function buildOperatorConfigReviewReport(input: {
   };
 }
 
+/**
+ * Summarize the provenance coverage of a set of memories (issue #1575 PR 3).
+ * Pure function — counts the verified/unverified/none distribution so the
+ * doctor check and any future surface can consume it without coupling to the
+ * orchestrator. Legacy memories (no `provenance` field) count as `"none"`.
+ */
+export function summarizeProvenanceCoverage(
+  memories: ReadonlyArray<{ frontmatter: { provenance?: string } }>,
+): { counts: { verified: number; unverified: number; none: number }; total: number } {
+  const counts = { verified: 0, unverified: 0, none: 0 };
+  for (const mem of memories) {
+    const tag = mem.frontmatter.provenance ?? "none";
+    if (tag === "verified") counts.verified += 1;
+    else if (tag === "unverified") counts.unverified += 1;
+    else counts.none += 1;
+  }
+  return { counts, total: memories.length };
+}
+
 export async function runOperatorDoctor(options: OperatorDoctorOptions): Promise<OperatorDoctorReport> {
   const now = options.now ?? new Date();
   const configStatus = await loadCliPluginConfig(options.configPath);
@@ -1177,6 +1196,67 @@ export async function runOperatorDoctor(options: OperatorDoctorOptions): Promise
     details: meta,
   });
 
+  // Provenance coverage (issue #1575 PR 3). Operators need to see the
+  // verified/unverified/none distribution grow as extraction backfills.
+  // Best-effort: a read failure surfaces as a warn, not an error.
+  let provenanceCoverage: ReturnType<typeof summarizeProvenanceCoverage> = {
+    counts: { verified: 0, unverified: 0, none: 0 },
+    total: 0,
+  };
+  let provenanceReadOk = true;
+  let provenancePartialTiers: string[] = [];
+  try {
+    // Include all tiers so cold-migrated and archived memories are counted
+    // (codex thread PRRT_kwDORJXyws6Ojqz8 — readAllMemories is hot-only).
+    // Use allSettled so a real read failure (e.g. locked encrypted store)
+    // is surfaced as a partial-read warning, not silently swallowed
+    // (codex thread PRRT_kwDORJXyws6OjygQ).
+    const [hot, archived, cold] = await Promise.allSettled([
+      storage.readAllMemories(),
+      storage.readArchivedMemories(),
+      storage.readAllColdMemories(),
+    ]);
+    const all: { frontmatter: { provenance?: string } }[] = [];
+    if (hot.status === "fulfilled") all.push(...hot.value);
+    else provenancePartialTiers.push("hot");
+    if (archived.status === "fulfilled") all.push(...archived.value);
+    else provenancePartialTiers.push("archived");
+    if (cold.status === "fulfilled") all.push(...cold.value);
+    else provenancePartialTiers.push("cold");
+    provenanceCoverage = summarizeProvenanceCoverage(all);
+  } catch {
+    provenanceReadOk = false;
+  }
+  const pc = provenanceCoverage.counts;
+  const totalProvenance = provenanceCoverage.total;
+  const provenanceCovered = pc.verified + pc.unverified;
+  const partialSuffix = provenancePartialTiers.length > 0
+    ? ` (partial: ${provenancePartialTiers.join("/")} tier unreadable)`
+    : "";
+  checks.push({
+    key: "provenance_coverage",
+    status: !provenanceReadOk || provenancePartialTiers.length > 0
+      ? "warn"
+      : totalProvenance === 0
+        ? "warn"
+        : provenanceCovered === 0
+          ? "warn"
+          : "ok",
+    summary: !provenanceReadOk
+      ? "Could not read memories for provenance coverage."
+      : totalProvenance === 0
+        ? "No memories found yet — provenance coverage is empty."
+        : `Provenance coverage: ${pc.verified} verified, ${pc.unverified} unverified, ${pc.none} none (${totalProvenance} total).${partialSuffix}`,
+    remediation: !provenanceReadOk
+      ? undefined
+      : provenancePartialTiers.length > 0
+        ? `Some tiers could not be read (${provenancePartialTiers.join(", ")}). Check storage health and re-run.`
+        : provenanceCovered === 0 && totalProvenance > 0
+          ? "New extractions will carry source spans. Existing legacy memories remain `none` until re-extracted."
+          : undefined,
+    details: { provenanceCounts: pc, total: totalProvenance, partialTiers: provenancePartialTiers.length > 0 ? provenancePartialTiers : undefined },
+  });
+
   const syncedChunkCount =
     nativeKnowledgeStatus.curatedIncludeSync.activeChunkCount +
     nativeKnowledgeStatus.obsidianSync.activeChunkCount +

package/src/orchestrator.ts

@@ -11918,6 +11918,7 @@ export class Orchestrator {
           }
           const resultNamespace = this.namespaceFromPath(recalledPath);
           let provenance: RecallXrayResult["provenance"] | undefined;
+          let sourceSpan: RecallXrayResult["sourceSpan"] | undefined;
           try {
             const resultStorage =
               await this.storageRouter.storageFor(resultNamespace);
@@ -11928,6 +11929,17 @@ export class Orchestrator {
                 retrievalReason: `served-by=${servedBy}`,
                 currentContextScopes: options.currentContextScopes,
               });
+              // Claim-level provenance span (#1575 PR 3): surface the first
+              // source excerpt so the X-ray shows the literal utterance this
+              // fact derives from. Thin read from already-loaded frontmatter.
+              const fm = memory.frontmatter;
+              if (fm.sources && fm.sources.length > 0) {
+                sourceSpan = {
+                  quote: fm.sources[0]!.quote,
+                  observedAt: fm.sources[0]!.observedAt,
+                  provenance: fm.provenance ?? "none",
+                };
+              }
             }
           } catch {
             // X-ray capture is best-effort; missing provenance must not
@@ -11940,6 +11952,7 @@ export class Orchestrator {
             scoreDecomposition,
             admittedBy: [],
             ...(provenance ? { provenance } : {}),
+            ...(sourceSpan ? { sourceSpan } : {}),
           });
         }
         // `considered` must reflect the pool size of the branch that