@danielmarbach/mnemonic-mcp 0.27.2 → 0.28.0

package/build/tools/migration.d.ts

@@ -0,0 +1,5 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { ServerContext } from "../server-context.js";
+export declare function registerListMigrationsTool(server: McpServer, ctx: ServerContext): void;
+export declare function registerExecuteMigrationTool(server: McpServer, ctx: ServerContext): void;
+//# sourceMappingURL=migration.d.ts.map

package/build/tools/migration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration.d.ts","sourceRoot":"","sources":["../../src/tools/migration.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAM1D,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,aAAa,GAAG,IAAI,CAqEtF;AAED,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,aAAa,GAAG,IAAI,CAuGxF"}

package/build/tools/migration.js

@@ -0,0 +1,157 @@
+import { z } from "zod";
+import { readVaultSchemaVersion } from "../config.js";
+import { MigrationListResultSchema, MigrationExecuteResultSchema } from "../structured-content.js";
+import { getErrorMessage } from "../error-utils.js";
+import { ensureBranchSynced as ensureBranchSyncedFromModule, projectParam } from "../helpers/project.js";
+export function registerListMigrationsTool(server, ctx) {
+    server.registerTool("list_migrations", {
+        title: "List Migrations",
+        description: "List available schema migrations and show which ones are pending for each vault.\n\n" +
+            "Use this when:\n" +
+            "- Checking whether a mnemonic upgrade requires vault changes\n" +
+            "- Preparing to run `execute_migration`\n\n" +
+            "Do not use this when:\n" +
+            "- You already know the exact migration to run and only need to execute it\n\n" +
+            "Returns:\n" +
+            "- Available migrations, vault schema versions, and pending counts\n\n" +
+            "Read-only.\n\n" +
+            "Typical next step:\n" +
+            "- Run `execute_migration` with `dryRun: true` first.",
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+        inputSchema: z.object({}),
+        outputSchema: MigrationListResultSchema,
+    }, async () => {
+        const available = ctx.migrator.listAvailableMigrations();
+        const lines = [];
+        lines.push("Vault schema versions:");
+        let totalPending = 0;
+        const vaultsInfo = [];
+        for (const vault of ctx.vaultManager.allKnownVaults()) {
+            const version = await readVaultSchemaVersion(vault.storage.vaultPath);
+            const pending = await ctx.migrator.getPendingMigrations(version);
+            totalPending += pending.length;
+            const label = vault.isProject ? "project" : "main";
+            lines.push(`  ${label} (${vault.storage.vaultPath}): ${version} — ${pending.length} pending`);
+            vaultsInfo.push({
+                path: vault.storage.vaultPath,
+                type: vault.isProject ? "project" : "main",
+                version,
+                pending: pending.length,
+            });
+        }
+        lines.push("");
+        lines.push("Available migrations:");
+        for (const migration of available) {
+            lines.push(`  ${migration.name}`);
+            lines.push(`   ${migration.description}`);
+        }
+        lines.push("");
+        if (totalPending > 0) {
+            lines.push("Run migration with: mnemonic migrate (CLI) or execute_migration (MCP)");
+        }
+        const structuredContent = {
+            action: "migration_list",
+            vaults: vaultsInfo,
+            available: available.map(m => ({ name: m.name, description: m.description })),
+            totalPending,
+        };
+        return { content: [{ type: "text", text: lines.join("\n") }], structuredContent };
+    });
+}
+export function registerExecuteMigrationTool(server, ctx) {
+    server.registerTool("execute_migration", {
+        title: "Execute Migration",
+        description: "Execute a named schema migration on vault notes.\n\n" +
+            "Use this when:\n" +
+            "- `list_migrations` shows pending migrations that should be applied\n\n" +
+            "Do not use this when:\n" +
+            "- You have not checked pending migrations yet\n" +
+            "- You have not previewed the migration with `dryRun: true`\n\n" +
+            "Returns:\n" +
+            "- Per-vault migration results, counts, warnings, and errors\n\n" +
+            "Side effects: modifies note files, git commits per affected vault, and may push.\n\n" +
+            "Typical next step:\n" +
+            "- Re-run `list_migrations` to confirm nothing is pending.",
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+        inputSchema: z.object({
+            migrationName: z.string().describe("Name of the migration to execute (get names from `list_migrations`)"),
+            dryRun: z.boolean().default(true).describe("If true, show what would change without actually modifying notes. Always try dry-run first."),
+            backup: z.boolean().default(true).describe("If true, warn about backing up before real migration"),
+            cwd: projectParam.optional().describe("Optional: limit migration to a specific project vault"),
+        }),
+        outputSchema: MigrationExecuteResultSchema,
+    }, async ({ migrationName, dryRun, backup, cwd }) => {
+        await ensureBranchSyncedFromModule(ctx, cwd);
+        try {
+            const { results, vaultsProcessed } = await ctx.migrator.runMigration(migrationName, {
+                dryRun,
+                backup,
+                cwd,
+            });
+            const lines = [];
+            lines.push(`Migration: ${migrationName}`);
+            lines.push(`Mode: ${dryRun ? "DRY-RUN" : "EXECUTE"}`);
+            lines.push(`Vaults processed: ${vaultsProcessed}`);
+            lines.push("");
+            const vaultResults = [];
+            for (const [vaultPath, result] of results) {
+                lines.push(`Vault: ${vaultPath}`);
+                lines.push(`  Notes processed: ${result.notesProcessed}`);
+                lines.push(`  Notes modified: ${result.notesModified}`);
+                const vaultResultErrors = [];
+                const vaultResultWarnings = [];
+                if (result.errors.length > 0) {
+                    lines.push(`  Errors: ${result.errors.length}`);
+                    result.errors.forEach(e => lines.push(`    - ${e.noteId}: ${e.error}`));
+                    vaultResultErrors.push(...result.errors.map(e => ({ noteId: e.noteId, error: e.error })));
+                }
+                if (result.warnings.length > 0) {
+                    lines.push(`  Warnings: ${result.warnings.length}`);
+                    result.warnings.forEach(w => lines.push(`    - ${w}`));
+                    vaultResultWarnings.push(...result.warnings);
+                }
+                vaultResults.push({
+                    path: vaultPath,
+                    notesProcessed: result.notesProcessed,
+                    notesModified: result.notesModified,
+                    errors: vaultResultErrors,
+                    warnings: vaultResultWarnings,
+                });
+                lines.push("");
+            }
+            if (!dryRun) {
+                lines.push("Migration executed. Modified vaults were auto-committed and pushed when git was available.");
+            }
+            else {
+                lines.push("✓ Dry-run completed - no changes made");
+            }
+            const structuredContent = {
+                action: "migration_executed",
+                migration: migrationName,
+                dryRun,
+                vaultsProcessed,
+                vaultResults,
+            };
+            return { content: [{ type: "text", text: lines.join("\n") }], structuredContent };
+        }
+        catch (err) {
+            return {
+                content: [{
+                        type: "text",
+                        text: `Migration failed: ${getErrorMessage(err)}`,
+                    }],
+            };
+        }
+    });
+}
+//# sourceMappingURL=migration.js.map

package/build/tools/migration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration.js","sourceRoot":"","sources":["../../src/tools/migration.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,EAAE,yBAAyB,EAA4B,4BAA4B,EAA+B,MAAM,0BAA0B,CAAC;AAC1J,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,kBAAkB,IAAI,4BAA4B,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAEzG,MAAM,UAAU,0BAA0B,CAAC,MAAiB,EAAE,GAAkB;IAC9E,MAAM,CAAC,YAAY,CACjB,iBAAiB,EACjB;QACE,KAAK,EAAE,iBAAiB;QACxB,WAAW,EACT,sFAAsF;YACtF,kBAAkB;YAClB,gEAAgE;YAChE,4CAA4C;YAC5C,yBAAyB;YACzB,+EAA+E;YAC/E,YAAY;YACZ,uEAAuE;YACvE,gBAAgB;YAChB,sBAAsB;YACtB,sDAAsD;QACxD,WAAW,EAAE;YACX,YAAY,EAAE,IAAI;YAClB,eAAe,EAAE,KAAK;YACtB,cAAc,EAAE,IAAI;YACpB,aAAa,EAAE,KAAK;SACrB;QACD,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;QACzB,YAAY,EAAE,yBAAyB;KACxC,EACD,KAAK,IAAI,EAAE;QACT,MAAM,SAAS,GAAG,GAAG,CAAC,QAAQ,CAAC,uBAAuB,EAAE,CAAC;QACzD,MAAM,KAAK,GAAa,EAAE,CAAC;QAE3B,KAAK,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;QACrC,IAAI,YAAY,GAAG,CAAC,CAAC;QACrB,MAAM,UAAU,GAAkC,EAAE,CAAC;QACrD,KAAK,MAAM,KAAK,IAAI,GAAG,CAAC,YAAY,CAAC,cAAc,EAAE,EAAE,CAAC;YACtD,MAAM,OAAO,GAAG,MAAM,sBAAsB,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;YACtE,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,QAAQ,CAAC,oBAAoB,CAAC,OAAO,CAAC,CAAC;YACjE,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC;YAC/B,MAAM,KAAK,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC;YACnD,KAAK,CAAC,IAAI,CAAC,KAAK,KAAK,KAAK,KAAK,CAAC,OAAO,CAAC,SAAS,MAAM,OAAO,MAAM,OAAO,CAAC,MAAM,UAAU,CAAC,CAAC;YAC9F,UAAU,CAAC,IAAI,CAAC;gBACd,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,SAAS;gBAC7B,IAAI,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM;gBAC1C,OAAO;gBACP,OAAO,EAAE,OAAO,CAAC,MAAM;aACxB,CAAC,CAAC;QACL,CAAC;QAED,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;QACpC,KAAK,MAAM,SAAS,IAAI,SAAS,EAAE,CAAC;YAClC,KAAK,CAAC,IAAI,CAAC,KAAK,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC;YAClC,KAAK,CAAC,IAAI,CAAC,MAAM,SAAS,CAAC,WAAW,EAAE,CAAC,CAAC;QAC5C,CAAC;QAED,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,IAAI,YAAY,GAAG,CAAC,EAAE,CAAC;YACrB,KAAK,CAAC,IAAI,CAAC,uEAAuE,CAAC,CAAC;QACtF,CAAC;QAED,MAAM,iBAAiB,GAAwB;YAC7C,MAAM,EAAE,gBAAgB;YACxB,MAAM,EAAE,UAAU;YAClB,SAAS,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;YAC7E,YAAY;SACb,CAAC;QAEF,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,iBAAiB,EAAE,CAAC;IACpF,CAAC,CACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,4BAA4B,CAAC,MAAiB,EAAE,GAAkB;IAChF,MAAM,CAAC,YAAY,CACjB,mBAAmB,EACnB;QACE,KAAK,EAAE,mBAAmB;QAC1B,WAAW,EACT,sDAAsD;YACtD,kBAAkB;YAClB,yEAAyE;YACzE,yBAAyB;YACzB,iDAAiD;YACjD,gEAAgE;YAChE,YAAY;YACZ,iEAAiE;YACjE,sFAAsF;YACtF,sBAAsB;YACtB,2DAA2D;QAC7D,WAAW,EAAE;YACX,YAAY,EAAE,KAAK;YACnB,eAAe,EAAE,KAAK;YACtB,cAAc,EAAE,IAAI;YACpB,aAAa,EAAE,KAAK;SACrB;QACD,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;YACpB,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,qEAAqE,CAAC;YACzG,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,6FAA6F,CAAC;YACzI,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,sDAAsD,CAAC;YAClG,GAAG,EAAE,YAAY,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,uDAAuD,CAAC;SAC/F,CAAC;QACF,YAAY,EAAE,4BAA4B;KAC3C,EACD,KAAK,EAAE,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,EAAE,EAAE;QAC/C,MAAM,4BAA4B,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;QAE7C,IAAI,CAAC;YACH,MAAM,EAAE,OAAO,EAAE,eAAe,EAAE,GAAG,MAAM,GAAG,CAAC,QAAQ,CAAC,YAAY,CAAC,aAAa,EAAE;gBAClF,MAAM;gBACN,MAAM;gBACN,GAAG;aACJ,CAAC,CAAC;YAEH,MAAM,KAAK,GAAa,EAAE,CAAC;YAC3B,KAAK,CAAC,IAAI,CAAC,cAAc,aAAa,EAAE,CAAC,CAAC;YAC1C,KAAK,CAAC,IAAI,CAAC,SAAS,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC;YACtD,KAAK,CAAC,IAAI,CAAC,qBAAqB,eAAe,EAAE,CAAC,CAAC;YACnD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;YAEd,MAAM,YAAY,GAAiJ,EAAE,CAAC;YACtK,KAAK,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;gBAC1C,KAAK,CAAC,IAAI,CAAC,UAAU,SAAS,EAAE,CAAC,CAAC;gBAClC,KAAK,CAAC,IAAI,CAAC,sBAAsB,MAAM,CAAC,cAAc,EAAE,CAAC,CAAC;gBAC1D,KAAK,CAAC,IAAI,CAAC,qBAAqB,MAAM,CAAC,aAAa,EAAE,CAAC,CAAC;gBAExD,MAAM,iBAAiB,GAA6C,EAAE,CAAC;gBACvE,MAAM,mBAAmB,GAAa,EAAE,CAAC;gBAEzC,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBAC7B,KAAK,CAAC,IAAI,CAAC,aAAa,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;oBAChD,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;oBACxE,iBAAiB,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC;gBAC5F,CAAC;gBAED,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBAC/B,KAAK,CAAC,IAAI,CAAC,eAAe,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;oBACpD,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,CAAC;oBACvD,mBAAmB,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC;gBAC/C,CAAC;gBAED,YAAY,CAAC,IAAI,CAAC;oBAChB,IAAI,EAAE,SAAS;oBACf,cAAc,EAAE,MAAM,CAAC,cAAc;oBACrC,aAAa,EAAE,MAAM,CAAC,aAAa;oBACnC,MAAM,EAAE,iBAAiB;oBACzB,QAAQ,EAAE,mBAAmB;iBAC9B,CAAC,CAAC;gBACH,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACjB,CAAC;YAED,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,KAAK,CAAC,IAAI,CAAC,4FAA4F,CAAC,CAAC;YAC3G,CAAC;iBAAM,CAAC;gBACN,KAAK,CAAC,IAAI,CAAC,uCAAuC,CAAC,CAAC;YACtD,CAAC;YAED,MAAM,iBAAiB,GAA2B;gBAChD,MAAM,EAAE,oBAAoB;gBAC5B,SAAS,EAAE,aAAa;gBACxB,MAAM;gBACN,eAAe;gBACf,YAAY;aACb,CAAC;YAEF,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,iBAAiB,EAAE,CAAC;QACpF,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO;gBACL,OAAO,EAAE,CAAC;wBACR,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,qBAAqB,eAAe,CAAC,GAAG,CAAC,EAAE;qBAClD,CAAC;aACH,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/build/tools/move-memory.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { ServerContext } from "../server-context.js";
+export declare function registerMoveMemoryTool(server: McpServer, ctx: ServerContext): void;
+//# sourceMappingURL=move-memory.d.ts.map

package/build/tools/move-memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"move-memory.d.ts","sourceRoot":"","sources":["../../src/tools/move-memory.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAwB1D,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,aAAa,GAAG,IAAI,CAoLlF"}

package/build/tools/move-memory.js

@@ -0,0 +1,170 @@
+import { z } from "zod";
+import { NoteIdSchema, MoveResultSchema, } from "../structured-content.js";
+import { projectParam, resolveProject, ensureBranchSynced, } from "../helpers/project.js";
+import { memoryId, isoDateString } from "../brands.js";
+import { shouldBlockProtectedBranchCommit } from "../helpers/git-commit.js";
+import { formatPersistenceSummary, } from "../helpers/persistence.js";
+import { moveNoteBetweenVaults, projectNotFoundResponse, storageLabel, } from "../helpers/vault.js";
+import { invalidateActiveProjectCache } from "../cache.js";
+export function registerMoveMemoryTool(server, ctx) {
+    server.registerTool("move_memory", {
+        title: "Move Memory",
+        description: "Use after `where_is_memory` or `get` confirms a memory is stored in the wrong place.\n\n" +
+            "Move a memory between main storage and project storage, optionally targeting a specific sub-vault folder.\n\n" +
+            "Use this when:\n" +
+            "- A note is stored in the wrong place\n" +
+            "- Project-specific knowledge should move between shared project storage and main storage\n" +
+            "- A note should live in a specific sub-vault such as `.mnemonic-lib`\n\n" +
+            "Do not use this when:\n" +
+            "- You only need to edit the note content; use `update`\n" +
+            "- You want to delete the note; use `forget`\n\n" +
+            "Returns:\n" +
+            "- The moved memory id, resulting storage label, project association, and persistence status\n\n" +
+            "Side effects: rewrites storage location, may adjust project association, git commits, and may push.\n\n" +
+            "Typical next step:\n" +
+            "- Use `where_is_memory` or `get` to verify the final state.\n" +
+            "- Use `relate` if the moved memory connects to existing notes in the new vault.",
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+        inputSchema: z.object({
+            id: NoteIdSchema.describe("Exact memory id. Use an id returned by `recall`, `list`, `recent_memories`, or `where_is`."),
+            target: z.enum(["main-vault", "project-vault"]).describe("Destination: 'main-vault' for private/global storage, 'project-vault' for shared project storage"),
+            vaultFolder: z
+                .string()
+                .optional()
+                .describe("Optional target project vault folder name, such as `.mnemonic-lib`. " +
+                "Use this only when moving into a specific sub-vault instead of the primary project vault."),
+            cwd: projectParam,
+            allowProtectedBranch: z
+                .boolean()
+                .optional()
+                .describe("One-time override for protected branch checks. " +
+                "When true, move_memory can commit on a protected branch without changing project policy."),
+        }),
+        outputSchema: MoveResultSchema,
+    }, async ({ id, target, vaultFolder, cwd, allowProtectedBranch = false }) => {
+        await ensureBranchSynced(ctx, cwd);
+        const found = await ctx.vaultManager.findNote(id, cwd);
+        if (!found) {
+            return { content: [{ type: "text", text: `No memory found with id '${id}'` }], isError: true };
+        }
+        const currentStorage = storageLabel(found.vault);
+        let targetVault;
+        let targetProject;
+        if (target === "main-vault") {
+            targetVault = ctx.vaultManager.main;
+        }
+        else {
+            if (!cwd) {
+                return {
+                    content: [{
+                            type: "text",
+                            text: "Moving into a project vault requires `cwd` so mnemonic can resolve the destination project.",
+                        }],
+                    isError: true,
+                };
+            }
+            if (vaultFolder) {
+                // Target a specific submodule vault by folder name.
+                const subVault = await ctx.vaultManager.getVaultByFolder(cwd, vaultFolder);
+                if (!subVault) {
+                    return {
+                        content: [{ type: "text", text: `Vault folder '${vaultFolder}' not found under the git root for: ${cwd}` }],
+                        isError: true,
+                    };
+                }
+                targetVault = subVault;
+            }
+            else {
+                // Default: primary project vault (.mnemonic).
+                const projectVault = await ctx.vaultManager.getOrCreateProjectVault(cwd);
+                if (!projectVault) {
+                    return { content: [{ type: "text", text: `Could not resolve a project vault for: ${cwd}` }], isError: true };
+                }
+                targetVault = projectVault;
+            }
+            targetProject = await resolveProject(ctx, cwd);
+            if (!targetProject) {
+                return projectNotFoundResponse(cwd);
+            }
+        }
+        // Check if the note is already in the target vault.
+        if (found.vault.storage.vaultPath === targetVault.storage.vaultPath) {
+            const targetLabel = storageLabel(targetVault);
+            return { content: [{ type: "text", text: `Memory '${id}' is already stored in ${targetLabel}.` }], isError: true };
+        }
+        if (found.vault.isProject || targetVault.isProject) {
+            const resolvedProject = targetProject ?? await resolveProject(ctx, cwd);
+            const projectLabel = resolvedProject
+                ? `${resolvedProject.name} (${resolvedProject.id})`
+                : `${found.note.projectName ?? "project"} (${found.note.project ?? "unknown"})`;
+            const projectId = targetProject?.id ?? found.note.project;
+            const policy = projectId ? await ctx.configStore.getProjectPolicy(projectId) : undefined;
+            const protectedBranchCheck = await shouldBlockProtectedBranchCommit({
+                ctx,
+                cwd,
+                writeScope: "project",
+                automaticCommit: true,
+                projectLabel,
+                policy,
+                allowProtectedBranch,
+                toolName: "move_memory",
+            });
+            if (protectedBranchCheck.blocked) {
+                return {
+                    content: [{ type: "text", text: protectedBranchCheck.message ?? "Protected branch policy blocked this commit." }],
+                    isError: true,
+                };
+            }
+        }
+        const targetLabel = storageLabel(targetVault);
+        const existing = await targetVault.storage.readNote(memoryId(id));
+        if (existing) {
+            return { content: [{ type: "text", text: `Cannot move '${id}' because a note with that id already exists in ${targetLabel}.` }], isError: true };
+        }
+        let noteToWrite = found.note;
+        let metadataRewritten = false;
+        if (target === "project-vault" && targetProject) {
+            const rewrittenProject = targetProject.id;
+            const rewrittenProjectName = targetProject.name;
+            metadataRewritten = noteToWrite.project !== rewrittenProject || noteToWrite.projectName !== rewrittenProjectName;
+            noteToWrite = {
+                ...noteToWrite,
+                project: rewrittenProject,
+                projectName: rewrittenProjectName,
+                updatedAt: isoDateString(new Date().toISOString()),
+            };
+        }
+        const moveResult = await moveNoteBetweenVaults(ctx, found, targetVault, noteToWrite, cwd);
+        const movedNote = moveResult.note;
+        const associationValue = movedNote.projectName && movedNote.project
+            ? `${movedNote.projectName} (${movedNote.project})`
+            : movedNote.projectName ?? movedNote.project ?? "global";
+        const structuredContent = {
+            action: "moved",
+            id,
+            fromVault: currentStorage,
+            toVault: targetLabel,
+            projectAssociation: associationValue,
+            title: movedNote.title,
+            metadataRewritten,
+            persistence: moveResult.persistence,
+        };
+        const associationText = metadataRewritten
+            ? `Project association is now ${associationValue}.`
+            : `Project association remains ${associationValue}.`;
+        invalidateActiveProjectCache();
+        return {
+            content: [{
+                    type: "text",
+                    text: `Moved '${id}' from ${currentStorage} to ${targetLabel}. ${associationText}\n${formatPersistenceSummary(moveResult.persistence)}`,
+                }],
+            structuredContent,
+        };
+    });
+}
+//# sourceMappingURL=move-memory.js.map

package/build/tools/move-memory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"move-memory.js","sourceRoot":"","sources":["../../src/tools/move-memory.ts"],"names":[],"mappings":"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"}

package/build/tools/policy.d.ts

@@ -0,0 +1,5 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { ServerContext } from "../server-context.js";
+export declare function registerSetProjectMemoryPolicyTool(server: McpServer, ctx: ServerContext): void;
+export declare function registerGetProjectMemoryPolicyTool(server: McpServer, ctx: ServerContext): void;
+//# sourceMappingURL=policy.d.ts.map

package/build/tools/policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"policy.d.ts","sourceRoot":"","sources":["../../src/tools/policy.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAQ1D,wBAAgB,kCAAkC,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,aAAa,GAAG,IAAI,CA6I9F;AAED,wBAAgB,kCAAkC,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,aAAa,GAAG,IAAI,CA8E9F"}

package/build/tools/policy.js

@@ -0,0 +1,195 @@
+import { z } from "zod";
+import { resolveProject as resolveProjectFromModule } from "../helpers/project.js";
+import { projectNotFoundResponse } from "../helpers/vault.js";
+import { CONSOLIDATION_MODES, PROTECTED_BRANCH_BEHAVIORS, PROJECT_POLICY_SCOPES } from "../project-memory-policy.js";
+import { formatCommitBody } from "../helpers/git-commit.js";
+import { pushAfterMutation as pushAfterMutationFromModule, buildMutationRetryContract, formatRetrySummary } from "../helpers/persistence.js";
+import { PolicyResultSchema } from "../structured-content.js";
+export function registerSetProjectMemoryPolicyTool(server, ctx) {
+    server.registerTool("set_project_memory_policy", {
+        title: "Set Project Memory Policy",
+        description: "Set the default write scope and memory behavior for a project.\n\n" +
+            "Use this when:\n" +
+            "- A project should default to project or global storage\n" +
+            "- Protected-branch handling or consolidation behavior should be standardized\n\n" +
+            "Do not use this when:\n" +
+            "- You only need a one-off write location for a single `remember` call\n\n" +
+            "Returns:\n" +
+            "- The saved project policy and effective values\n\n" +
+            "Side effects: writes config, git commits, and may push.\n\n" +
+            "Typical next step:\n" +
+            "- Use `get_project_memory_policy` to verify the saved policy.",
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+        inputSchema: z.object({
+            cwd: z.string().describe("Absolute project working directory. Pass this whenever the task is project-related so routing, search boosting, policy, and vault selection work correctly."),
+            defaultScope: z.enum(PROJECT_POLICY_SCOPES).optional().describe("Default storage: 'project' = shared project vault, 'global' = private main vault, 'ask' = prompt each time"),
+            consolidationMode: z.enum(CONSOLIDATION_MODES).optional().describe("Default consolidation mode: 'supersedes' preserves history (default), 'delete' removes sources immediately"),
+            protectedBranchBehavior: z.enum(PROTECTED_BRANCH_BEHAVIORS).optional().describe("Behavior for protected-branch matches during project-vault commits by mutating tools: 'ask', 'block', or 'allow'"),
+            protectedBranchPatterns: z.array(z.string()).optional().describe("Protected branch glob patterns. Defaults to [\"main\", \"master\", \"release*\"] when not set"),
+        }),
+        outputSchema: PolicyResultSchema,
+    }, async ({ cwd, defaultScope, consolidationMode, protectedBranchBehavior, protectedBranchPatterns }) => {
+        const project = await resolveProjectFromModule(ctx, cwd);
+        if (!project) {
+            return projectNotFoundResponse(cwd);
+        }
+        if (defaultScope === undefined
+            && consolidationMode === undefined
+            && protectedBranchBehavior === undefined
+            && protectedBranchPatterns === undefined) {
+            return {
+                content: [{
+                        type: "text",
+                        text: "No policy fields provided. Set at least one of: defaultScope, consolidationMode, protectedBranchBehavior, protectedBranchPatterns.",
+                    }],
+                isError: true,
+            };
+        }
+        const existing = await ctx.configStore.getProjectPolicy(project.id);
+        const effectiveDefaultScope = defaultScope ?? existing?.defaultScope ?? "project";
+        const effectiveConsolidationMode = consolidationMode ?? existing?.consolidationMode;
+        const effectiveProtectedBranchBehavior = protectedBranchBehavior ?? existing?.protectedBranchBehavior;
+        const effectiveProtectedBranchPatterns = protectedBranchPatterns
+            ? protectedBranchPatterns.map((pattern) => pattern.trim()).filter((pattern) => pattern.length > 0)
+            : existing?.protectedBranchPatterns;
+        const now = new Date().toISOString();
+        const policy = {
+            projectId: project.id,
+            projectName: project.name,
+            defaultScope: effectiveDefaultScope,
+            consolidationMode: effectiveConsolidationMode,
+            protectedBranchBehavior: effectiveProtectedBranchBehavior,
+            protectedBranchPatterns: effectiveProtectedBranchPatterns,
+            updatedAt: now,
+        };
+        await ctx.configStore.setProjectPolicy(policy);
+        const modeStr = effectiveConsolidationMode ? `, consolidationMode=${effectiveConsolidationMode}` : "";
+        const branchBehaviorStr = effectiveProtectedBranchBehavior
+            ? `, protectedBranchBehavior=${effectiveProtectedBranchBehavior}`
+            : "";
+        const branchPatternsStr = effectiveProtectedBranchPatterns && effectiveProtectedBranchPatterns.length > 0
+            ? `, protectedBranchPatterns=${effectiveProtectedBranchPatterns.join("|")}`
+            : "";
+        const commitBody = formatCommitBody({
+            projectName: project.name,
+            description: `Default scope: ${effectiveDefaultScope}` +
+                `${effectiveConsolidationMode ? `\nConsolidation mode: ${effectiveConsolidationMode}` : ""}` +
+                `${effectiveProtectedBranchBehavior ? `\nProtected branch behavior: ${effectiveProtectedBranchBehavior}` : ""}` +
+                `${effectiveProtectedBranchPatterns && effectiveProtectedBranchPatterns.length > 0
+                    ? `\nProtected branch patterns: ${effectiveProtectedBranchPatterns.join(", ")}`
+                    : ""}`,
+        });
+        const commitMessage = `policy: ${project.name} default scope ${effectiveDefaultScope}`;
+        const commitFiles = ["config.json"];
+        const commitStatus = await ctx.vaultManager.main.git.commitWithStatus(commitMessage, commitFiles, commitBody);
+        const pushStatus = commitStatus.status === "committed"
+            ? await pushAfterMutationFromModule(ctx, ctx.vaultManager.main)
+            : { status: "skipped", reason: "commit-failed" };
+        const retry = buildMutationRetryContract({
+            commit: commitStatus,
+            commitMessage,
+            commitBody,
+            files: commitFiles,
+            cwd,
+            vault: ctx.vaultManager.main,
+            mutationApplied: true,
+        });
+        const structuredContent = {
+            action: "policy_set",
+            project: { id: project.id, name: project.name },
+            defaultScope: effectiveDefaultScope,
+            consolidationMode: effectiveConsolidationMode,
+            protectedBranchBehavior: effectiveProtectedBranchBehavior,
+            protectedBranchPatterns: effectiveProtectedBranchPatterns,
+            updatedAt: now,
+            retry,
+        };
+        return {
+            content: [{
+                    type: "text",
+                    text: `Project memory policy set for ${project.name}: defaultScope=${effectiveDefaultScope}` +
+                        `${modeStr}${branchBehaviorStr}${branchPatternsStr}` +
+                        `${commitStatus.status === "failed"
+                            ? `\n${formatRetrySummary(retry) ?? `Commit failed. Push status: ${pushStatus.status}.`}`
+                            : ""}`,
+                }],
+            structuredContent,
+        };
+    });
+}
+export function registerGetProjectMemoryPolicyTool(server, ctx) {
+    server.registerTool("get_project_memory_policy", {
+        title: "Get Project Memory Policy",
+        description: "Show the saved memory policy for a project.\n\n" +
+            "Use this when:\n" +
+            "- You want to confirm the default write scope before storing memory\n" +
+            "- You are debugging why notes land in an unexpected vault\n" +
+            "- You need to inspect protected-branch or consolidation defaults\n\n" +
+            "Do not use this when:\n" +
+            "- You want to change the policy; use `set_project_memory_policy`\n\n" +
+            "Returns:\n" +
+            "- Saved policy values or an explanation of the fallback behavior\n\n" +
+            "Read-only.\n\n" +
+            "Typical next step:\n" +
+            "- Call `remember` with explicit `scope` for a one-off override, or `set_project_memory_policy` to change defaults.",
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+        inputSchema: z.object({
+            cwd: z.string().describe("Absolute project working directory. Pass this whenever the task is project-related so routing, search boosting, policy, and vault selection work correctly."),
+        }),
+        outputSchema: PolicyResultSchema,
+    }, async ({ cwd }) => {
+        const project = await resolveProjectFromModule(ctx, cwd);
+        if (!project) {
+            return projectNotFoundResponse(cwd);
+        }
+        const policy = await ctx.configStore.getProjectPolicy(project.id);
+        if (!policy) {
+            const structuredContent = {
+                action: "policy_shown",
+                project: { id: project.id, name: project.name },
+            };
+            return {
+                content: [{
+                        type: "text",
+                        text: `No project memory policy set for ${project.name}. Default write behavior remains scope=project when cwd is present.`,
+                    }],
+                structuredContent,
+            };
+        }
+        const structuredContent = {
+            action: "policy_shown",
+            project: { id: project.id, name: project.name },
+            defaultScope: policy.defaultScope,
+            consolidationMode: policy.consolidationMode,
+            protectedBranchBehavior: policy.protectedBranchBehavior,
+            protectedBranchPatterns: policy.protectedBranchPatterns,
+            updatedAt: policy.updatedAt,
+        };
+        const details = [
+            `defaultScope=${policy.defaultScope}`,
+            policy.consolidationMode ? `consolidationMode=${policy.consolidationMode}` : undefined,
+            policy.protectedBranchBehavior ? `protectedBranchBehavior=${policy.protectedBranchBehavior}` : undefined,
+            policy.protectedBranchPatterns && policy.protectedBranchPatterns.length > 0
+                ? `protectedBranchPatterns=${policy.protectedBranchPatterns.join("|")}`
+                : undefined,
+        ].filter(Boolean).join(", ");
+        return {
+            content: [{
+                    type: "text",
+                    text: `Project memory policy for ${project.name}: ${details} (updated ${policy.updatedAt})`,
+                }],
+            structuredContent,
+        };
+    });
+}
+//# sourceMappingURL=policy.js.map

package/build/tools/policy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"policy.js","sourceRoot":"","sources":["../../src/tools/policy.ts"],"names":[],"mappings":"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"}

package/build/tools/project-memory-summary.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { ServerContext } from "../server-context.js";
+export declare function registerProjectMemorySummaryTool(server: McpServer, ctx: ServerContext): void;
+//# sourceMappingURL=project-memory-summary.d.ts.map

package/build/tools/project-memory-summary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-memory-summary.d.ts","sourceRoot":"","sources":["../../src/tools/project-memory-summary.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAsC1D,wBAAgB,gCAAgC,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,aAAa,GAAG,IAAI,CAkhB5F"}