@danielmarbach/mnemonic-mcp 0.27.2 → 0.29.0

package/build/structured-content.d.ts

@@ -1,5 +1,6 @@
 import { z } from "zod";
 import type { NoteLifecycle, NoteRole, RelationshipType } from "./storage.js";
+import type { MergeRisk } from "./consolidate.js";
 export interface PersistenceStatus {
     notePath: string;
     embeddingPath: string;
@@ -93,6 +94,9 @@ export interface RecallResult extends Record<string, unknown> {
     action: "recalled";
     query: string;
     scope: "project" | "global" | "all";
+    recallScopeNoteCount?: number;
+    diversity?: RecallDiversity;
+    retrievalCoverage?: RecallRetrievalCoverage;
     results: Array<{
         id: string;
         title: string;
@@ -106,6 +110,7 @@ export interface RecallResult extends Record<string, unknown> {
         updatedAt: string;
         provenance?: Provenance;
         confidence?: Confidence;
+        signalStrength?: number;
         history?: Array<{
             commitHash: string;
             timestamp: string;
@@ -125,6 +130,20 @@ export interface RecallResult extends Record<string, unknown> {
         retrievalEvidence?: RetrievalEvidence;
     }>;
 }
+export interface RecallDiversity {
+    themeCount: number;
+    roleMix: Partial<Record<NoteRole, number>>;
+    lifecycleMix: Partial<Record<NoteLifecycle, number>>;
+}
+export interface RecallRetrievalCoverage {
+    anchorsInResults: number;
+    highPriorityAnchorsTotal: number;
+    fraction: number;
+    missingAnchors: Array<{
+        id: string;
+        title: string;
+    }>;
+}
 export type RetrievalEvidenceChannel = "semantic" | "lexical" | "graph" | "temporal-boost" | "canonical" | "rescue";
 export type RetrievalEvidenceRankBand = "top3" | "top10" | "lower";
 export type RetrievalEvidenceFreshness = "today" | "thisWeek" | "thisMonth" | "older";
@@ -224,12 +243,16 @@ export interface ForgetResult extends Record<string, unknown> {
     vaultsModified: string[];
     retry?: MutationRetryContract;
 }
-export interface SyncVaultGitError {
+export type SyncVaultGitError = {
     phase: "fetch" | "pull" | "push";
     message: string;
-    isConflict: boolean;
-    conflictFiles?: string[];
-}
+    isConflict: false;
+} | {
+    phase: "pull";
+    message: string;
+    isConflict: true;
+    conflictFiles: string[];
+};
 export interface SyncResult extends Record<string, unknown> {
     action: "synced";
     vaults: Array<{
@@ -281,7 +304,6 @@ export interface ConsolidateResult extends Record<string, unknown> {
     persistence?: PersistenceStatus;
     retry?: MutationRetryContract;
 }
-export type MergeRisk = "low" | "medium" | "high";
 export interface ConsolidateNoteMergeEvidence {
     id: string;
     title: string;
@@ -457,7 +479,8 @@ export interface Provenance {
     lastCommitMessage: string;
     recentlyChanged: boolean;
 }
-export type Confidence = "high" | "medium" | "low";
+export declare const CONFIDENCE_LEVELS: readonly ["high", "medium", "low"];
+export type Confidence = typeof CONFIDENCE_LEVELS[number];
 export interface Orientation {
     primaryEntry: OrientationNote;
     suggestedNext: OrientationNote[];
@@ -507,24 +530,26 @@ export interface ProjectSummaryResult extends Record<string, unknown> {
         computedAt: string;
     };
 }
+export declare const NoteIdSchema: z.ZodString;
+export declare const RemoteNameSchema: z.ZodString;
 export declare const RelatedNotePreviewSchema: z.ZodObject<{
     id: z.ZodString;
     title: z.ZodString;
     projectId: z.ZodOptional<z.ZodString>;
     theme: z.ZodOptional<z.ZodString>;
     relationType: z.ZodOptional<z.ZodEnum<{
+        supersedes: "supersedes";
         "related-to": "related-to";
         explains: "explains";
         "example-of": "example-of";
-        supersedes: "supersedes";
         "derives-from": "derives-from";
         follows: "follows";
     }>>;
     updatedAt: z.ZodString;
     confidence: z.ZodOptional<z.ZodEnum<{
-        high: "high";
-        medium: "medium";
         low: "low";
+        medium: "medium";
+        high: "high";
     }>>;
 }, z.core.$strip>;
 export declare const RelationshipPreviewSchema: z.ZodObject<{
@@ -535,18 +560,18 @@ export declare const RelationshipPreviewSchema: z.ZodObject<{
         projectId: z.ZodOptional<z.ZodString>;
         theme: z.ZodOptional<z.ZodString>;
         relationType: z.ZodOptional<z.ZodEnum<{
+            supersedes: "supersedes";
             "related-to": "related-to";
             explains: "explains";
             "example-of": "example-of";
-            supersedes: "supersedes";
             "derives-from": "derives-from";
             follows: "follows";
         }>>;
         updatedAt: z.ZodString;
         confidence: z.ZodOptional<z.ZodEnum<{
-            high: "high";
-            medium: "medium";
             low: "low";
+            medium: "medium";
+            high: "high";
         }>>;
     }, z.core.$strip>>;
     truncated: z.ZodBoolean;
@@ -556,16 +581,16 @@ export declare const PersistenceStatusSchema: z.ZodObject<{
     embeddingPath: z.ZodString;
     embedding: z.ZodObject<{
         status: z.ZodEnum<{
-            skipped: "skipped";
             written: "written";
+            skipped: "skipped";
         }>;
         model: z.ZodString;
         reason: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>;
     git: z.ZodObject<{
         commit: z.ZodEnum<{
-            committed: "committed";
             skipped: "skipped";
+            committed: "committed";
             failed: "failed";
         }>;
         push: z.ZodEnum<{
@@ -662,16 +687,16 @@ export declare const RememberResultSchema: z.ZodObject<{
         embeddingPath: z.ZodString;
         embedding: z.ZodObject<{
             status: z.ZodEnum<{
-                skipped: "skipped";
                 written: "written";
+                skipped: "skipped";
             }>;
             model: z.ZodString;
             reason: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>;
         git: z.ZodObject<{
             commit: z.ZodEnum<{
-                committed: "committed";
                 skipped: "skipped";
+                committed: "committed";
                 failed: "failed";
             }>;
             push: z.ZodEnum<{
@@ -745,6 +770,21 @@ export declare const RecallResultSchema: z.ZodObject<{
         global: "global";
         all: "all";
     }>;
+    recallScopeNoteCount: z.ZodOptional<z.ZodNumber>;
+    diversity: z.ZodOptional<z.ZodObject<{
+        themeCount: z.ZodNumber;
+        roleMix: z.ZodRecord<z.ZodString, z.ZodNumber>;
+        lifecycleMix: z.ZodRecord<z.ZodString, z.ZodNumber>;
+    }, z.core.$strip>>;
+    retrievalCoverage: z.ZodOptional<z.ZodObject<{
+        anchorsInResults: z.ZodNumber;
+        highPriorityAnchorsTotal: z.ZodNumber;
+        fraction: z.ZodNumber;
+        missingAnchors: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            title: z.ZodString;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
     results: z.ZodArray<z.ZodObject<{
         id: z.ZodString;
         title: z.ZodString;
@@ -777,10 +817,11 @@ export declare const RecallResultSchema: z.ZodObject<{
             recentlyChanged: z.ZodBoolean;
         }, z.core.$strip>>;
         confidence: z.ZodOptional<z.ZodEnum<{
-            high: "high";
-            medium: "medium";
             low: "low";
+            medium: "medium";
+            high: "high";
         }>>;
+        signalStrength: z.ZodOptional<z.ZodNumber>;
         history: z.ZodOptional<z.ZodArray<z.ZodObject<{
             commitHash: z.ZodString;
             timestamp: z.ZodString;
@@ -797,13 +838,13 @@ export declare const RecallResultSchema: z.ZodObject<{
                 }>;
             }, z.core.$strip>>;
             changeCategory: z.ZodOptional<z.ZodEnum<{
-                reverse: "reverse";
                 create: "create";
                 refine: "refine";
                 expand: "expand";
                 clarify: "clarify";
                 connect: "connect";
                 restructure: "restructure";
+                reverse: "reverse";
                 unknown: "unknown";
             }>>;
             changeDescription: z.ZodOptional<z.ZodString>;
@@ -817,18 +858,18 @@ export declare const RecallResultSchema: z.ZodObject<{
                 projectId: z.ZodOptional<z.ZodString>;
                 theme: z.ZodOptional<z.ZodString>;
                 relationType: z.ZodOptional<z.ZodEnum<{
+                    supersedes: "supersedes";
                     "related-to": "related-to";
                     explains: "explains";
                     "example-of": "example-of";
-                    supersedes: "supersedes";
                     "derives-from": "derives-from";
                     follows: "follows";
                 }>>;
                 updatedAt: z.ZodString;
                 confidence: z.ZodOptional<z.ZodEnum<{
-                    high: "high";
-                    medium: "medium";
                     low: "low";
+                    medium: "medium";
+                    high: "high";
                 }>>;
             }, z.core.$strip>>;
             truncated: z.ZodBoolean;
@@ -938,16 +979,16 @@ export declare const UpdateResultSchema: z.ZodObject<{
         embeddingPath: z.ZodString;
         embedding: z.ZodObject<{
             status: z.ZodEnum<{
-                skipped: "skipped";
                 written: "written";
+                skipped: "skipped";
             }>;
             model: z.ZodString;
             reason: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>;
         git: z.ZodObject<{
             commit: z.ZodEnum<{
-                committed: "committed";
                 skipped: "skipped";
+                committed: "committed";
                 failed: "failed";
             }>;
             push: z.ZodEnum<{
@@ -1077,16 +1118,16 @@ export declare const MoveResultSchema: z.ZodObject<{
         embeddingPath: z.ZodString;
         embedding: z.ZodObject<{
             status: z.ZodEnum<{
-                skipped: "skipped";
                 written: "written";
+                skipped: "skipped";
             }>;
             model: z.ZodString;
             reason: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>;
         git: z.ZodObject<{
             commit: z.ZodEnum<{
-                committed: "committed";
                 skipped: "skipped";
+                committed: "committed";
                 failed: "failed";
             }>;
             push: z.ZodEnum<{
@@ -1160,10 +1201,10 @@ export declare const RelateResultSchema: z.ZodObject<{
     fromId: z.ZodString;
     toId: z.ZodString;
     type: z.ZodEnum<{
+        supersedes: "supersedes";
         "related-to": "related-to";
         explains: "explains";
         "example-of": "example-of";
-        supersedes: "supersedes";
         "derives-from": "derives-from";
         follows: "follows";
     }>;
@@ -1247,10 +1288,10 @@ export declare const MemoryGraphResultSchema: z.ZodObject<{
         edges: z.ZodArray<z.ZodObject<{
             toId: z.ZodString;
             type: z.ZodEnum<{
+                supersedes: "supersedes";
                 "related-to": "related-to";
                 explains: "explains";
                 "example-of": "example-of";
-                supersedes: "supersedes";
                 "derives-from": "derives-from";
                 follows: "follows";
             }>;
@@ -1303,9 +1344,9 @@ export declare const OrientationNoteSchema: z.ZodObject<{
         recentlyChanged: z.ZodBoolean;
     }, z.core.$strip>>;
     confidence: z.ZodOptional<z.ZodEnum<{
-        high: "high";
-        medium: "medium";
         low: "low";
+        medium: "medium";
+        high: "high";
     }>>;
     relationships: z.ZodOptional<z.ZodObject<{
         totalDirectRelations: z.ZodNumber;
@@ -1315,18 +1356,18 @@ export declare const OrientationNoteSchema: z.ZodObject<{
             projectId: z.ZodOptional<z.ZodString>;
             theme: z.ZodOptional<z.ZodString>;
             relationType: z.ZodOptional<z.ZodEnum<{
+                supersedes: "supersedes";
                 "related-to": "related-to";
                 explains: "explains";
                 "example-of": "example-of";
-                supersedes: "supersedes";
                 "derives-from": "derives-from";
                 follows: "follows";
             }>>;
             updatedAt: z.ZodString;
             confidence: z.ZodOptional<z.ZodEnum<{
-                high: "high";
-                medium: "medium";
                 low: "low";
+                medium: "medium";
+                high: "high";
             }>>;
         }, z.core.$strip>>;
         truncated: z.ZodBoolean;
@@ -1344,9 +1385,9 @@ export declare const OrientationSchema: z.ZodObject<{
             recentlyChanged: z.ZodBoolean;
         }, z.core.$strip>>;
         confidence: z.ZodOptional<z.ZodEnum<{
-            high: "high";
-            medium: "medium";
             low: "low";
+            medium: "medium";
+            high: "high";
         }>>;
         relationships: z.ZodOptional<z.ZodObject<{
             totalDirectRelations: z.ZodNumber;
@@ -1356,18 +1397,18 @@ export declare const OrientationSchema: z.ZodObject<{
                 projectId: z.ZodOptional<z.ZodString>;
                 theme: z.ZodOptional<z.ZodString>;
                 relationType: z.ZodOptional<z.ZodEnum<{
+                    supersedes: "supersedes";
                     "related-to": "related-to";
                     explains: "explains";
                     "example-of": "example-of";
-                    supersedes: "supersedes";
                     "derives-from": "derives-from";
                     follows: "follows";
                 }>>;
                 updatedAt: z.ZodString;
                 confidence: z.ZodOptional<z.ZodEnum<{
-                    high: "high";
-                    medium: "medium";
                     low: "low";
+                    medium: "medium";
+                    high: "high";
                 }>>;
             }, z.core.$strip>>;
             truncated: z.ZodBoolean;
@@ -1384,9 +1425,9 @@ export declare const OrientationSchema: z.ZodObject<{
             recentlyChanged: z.ZodBoolean;
         }, z.core.$strip>>;
         confidence: z.ZodOptional<z.ZodEnum<{
-            high: "high";
-            medium: "medium";
             low: "low";
+            medium: "medium";
+            high: "high";
         }>>;
         relationships: z.ZodOptional<z.ZodObject<{
             totalDirectRelations: z.ZodNumber;
@@ -1396,18 +1437,18 @@ export declare const OrientationSchema: z.ZodObject<{
                 projectId: z.ZodOptional<z.ZodString>;
                 theme: z.ZodOptional<z.ZodString>;
                 relationType: z.ZodOptional<z.ZodEnum<{
+                    supersedes: "supersedes";
                     "related-to": "related-to";
                     explains: "explains";
                     "example-of": "example-of";
-                    supersedes: "supersedes";
                     "derives-from": "derives-from";
                     follows: "follows";
                 }>>;
                 updatedAt: z.ZodString;
                 confidence: z.ZodOptional<z.ZodEnum<{
-                    high: "high";
-                    medium: "medium";
                     low: "low";
+                    medium: "medium";
+                    high: "high";
                 }>>;
             }, z.core.$strip>>;
             truncated: z.ZodBoolean;
@@ -1480,9 +1521,9 @@ export declare const ProjectSummaryResultSchema: z.ZodObject<{
                 recentlyChanged: z.ZodBoolean;
             }, z.core.$strip>>;
             confidence: z.ZodOptional<z.ZodEnum<{
-                high: "high";
-                medium: "medium";
                 low: "low";
+                medium: "medium";
+                high: "high";
             }>>;
             relationships: z.ZodOptional<z.ZodObject<{
                 totalDirectRelations: z.ZodNumber;
@@ -1492,18 +1533,18 @@ export declare const ProjectSummaryResultSchema: z.ZodObject<{
                     projectId: z.ZodOptional<z.ZodString>;
                     theme: z.ZodOptional<z.ZodString>;
                     relationType: z.ZodOptional<z.ZodEnum<{
+                        supersedes: "supersedes";
                         "related-to": "related-to";
                         explains: "explains";
                         "example-of": "example-of";
-                        supersedes: "supersedes";
                         "derives-from": "derives-from";
                         follows: "follows";
                     }>>;
                     updatedAt: z.ZodString;
                     confidence: z.ZodOptional<z.ZodEnum<{
-                        high: "high";
-                        medium: "medium";
                         low: "low";
+                        medium: "medium";
+                        high: "high";
                     }>>;
                 }, z.core.$strip>>;
                 truncated: z.ZodBoolean;
@@ -1520,9 +1561,9 @@ export declare const ProjectSummaryResultSchema: z.ZodObject<{
                 recentlyChanged: z.ZodBoolean;
             }, z.core.$strip>>;
             confidence: z.ZodOptional<z.ZodEnum<{
-                high: "high";
-                medium: "medium";
                 low: "low";
+                medium: "medium";
+                high: "high";
             }>>;
             relationships: z.ZodOptional<z.ZodObject<{
                 totalDirectRelations: z.ZodNumber;
@@ -1532,18 +1573,18 @@ export declare const ProjectSummaryResultSchema: z.ZodObject<{
                     projectId: z.ZodOptional<z.ZodString>;
                     theme: z.ZodOptional<z.ZodString>;
                     relationType: z.ZodOptional<z.ZodEnum<{
+                        supersedes: "supersedes";
                         "related-to": "related-to";
                         explains: "explains";
                         "example-of": "example-of";
-                        supersedes: "supersedes";
                         "derives-from": "derives-from";
                         follows: "follows";
                     }>>;
                     updatedAt: z.ZodString;
                     confidence: z.ZodOptional<z.ZodEnum<{
-                        high: "high";
-                        medium: "medium";
                         low: "low";
+                        medium: "medium";
+                        high: "high";
                     }>>;
                 }, z.core.$strip>>;
                 truncated: z.ZodBoolean;
@@ -1638,10 +1679,10 @@ export declare const GetResultSchema: z.ZodObject<{
         relatedTo: z.ZodOptional<z.ZodArray<z.ZodObject<{
             id: z.ZodString;
             type: z.ZodEnum<{
+                supersedes: "supersedes";
                 "related-to": "related-to";
                 explains: "explains";
                 "example-of": "example-of";
-                supersedes: "supersedes";
                 "derives-from": "derives-from";
                 follows: "follows";
             }>;
@@ -1657,18 +1698,18 @@ export declare const GetResultSchema: z.ZodObject<{
                 projectId: z.ZodOptional<z.ZodString>;
                 theme: z.ZodOptional<z.ZodString>;
                 relationType: z.ZodOptional<z.ZodEnum<{
+                    supersedes: "supersedes";
                     "related-to": "related-to";
                     explains: "explains";
                     "example-of": "example-of";
-                    supersedes: "supersedes";
                     "derives-from": "derives-from";
                     follows: "follows";
                 }>>;
                 updatedAt: z.ZodString;
                 confidence: z.ZodOptional<z.ZodEnum<{
-                    high: "high";
-                    medium: "medium";
                     low: "low";
+                    medium: "medium";
+                    high: "high";
                 }>>;
             }, z.core.$strip>>;
             truncated: z.ZodBoolean;
@@ -1738,9 +1779,9 @@ export declare const ConsolidateResultSchema: z.ZodObject<{
             relatedCount: z.ZodNumber;
             warnings: z.ZodOptional<z.ZodArray<z.ZodString>>;
             mergeRisk: z.ZodEnum<{
-                high: "high";
-                medium: "medium";
                 low: "low";
+                medium: "medium";
+                high: "high";
             }>;
         }, z.core.$strip>;
         noteB: z.ZodObject<{
@@ -1766,16 +1807,16 @@ export declare const ConsolidateResultSchema: z.ZodObject<{
             relatedCount: z.ZodNumber;
             warnings: z.ZodOptional<z.ZodArray<z.ZodString>>;
             mergeRisk: z.ZodEnum<{
-                high: "high";
-                medium: "medium";
                 low: "low";
+                medium: "medium";
+                high: "high";
             }>;
         }, z.core.$strip>;
         warnings: z.ZodOptional<z.ZodArray<z.ZodString>>;
         mergeRisk: z.ZodEnum<{
-            high: "high";
-            medium: "medium";
             low: "low";
+            medium: "medium";
+            high: "high";
         }>;
     }, z.core.$strip>>>;
     mergeSuggestions: z.ZodOptional<z.ZodArray<z.ZodObject<{
@@ -1808,16 +1849,16 @@ export declare const ConsolidateResultSchema: z.ZodObject<{
             relatedCount: z.ZodNumber;
             warnings: z.ZodOptional<z.ZodArray<z.ZodString>>;
             mergeRisk: z.ZodEnum<{
-                high: "high";
-                medium: "medium";
                 low: "low";
+                medium: "medium";
+                high: "high";
             }>;
         }, z.core.$strip>>;
         warnings: z.ZodOptional<z.ZodArray<z.ZodString>>;
         mergeRisk: z.ZodEnum<{
-            high: "high";
-            medium: "medium";
             low: "low";
+            medium: "medium";
+            high: "high";
         }>;
     }, z.core.$strip>>>;
     executeMergeEvidence: z.ZodOptional<z.ZodObject<{
@@ -1844,16 +1885,16 @@ export declare const ConsolidateResultSchema: z.ZodObject<{
             relatedCount: z.ZodNumber;
             warnings: z.ZodOptional<z.ZodArray<z.ZodString>>;
             mergeRisk: z.ZodEnum<{
-                high: "high";
-                medium: "medium";
                 low: "low";
+                medium: "medium";
+                high: "high";
             }>;
         }, z.core.$strip>>;
         warnings: z.ZodOptional<z.ZodArray<z.ZodString>>;
         mergeRisk: z.ZodEnum<{
-            high: "high";
-            medium: "medium";
             low: "low";
+            medium: "medium";
+            high: "high";
         }>;
     }, z.core.$strip>>;
     persistence: z.ZodOptional<z.ZodObject<{
@@ -1861,16 +1902,16 @@ export declare const ConsolidateResultSchema: z.ZodObject<{
         embeddingPath: z.ZodString;
         embedding: z.ZodObject<{
             status: z.ZodEnum<{
-                skipped: "skipped";
                 written: "written";
+                skipped: "skipped";
             }>;
             model: z.ZodString;
             reason: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>;
         git: z.ZodObject<{
             commit: z.ZodEnum<{
-                committed: "committed";
                 skipped: "skipped";
+                committed: "committed";
                 failed: "failed";
             }>;
             push: z.ZodEnum<{
@@ -2133,7 +2174,7 @@ export interface RelatedNotePreview {
     theme?: string;
     relationType?: RelationshipType;
     updatedAt: string;
-    confidence?: "high" | "medium" | "low";
+    confidence?: Confidence;
 }
 export interface RelationshipPreview {
     totalDirectRelations: number;