@danielmarbach/mnemonic-mcp 0.27.1 → 0.28.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"relate.d.ts","sourceRoot":"","sources":["../../src/tools/relate.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAqB1D,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,aAAa,GAAG,IAAI,CA8L9E"}

package/build/tools/relate.js

@@ -0,0 +1,180 @@
+import { z } from "zod";
+import path from "node:path";
+import { RELATIONSHIP_TYPES } from "../storage.js";
+import { RelateResultSchema, } from "../structured-content.js";
+import { projectParam, ensureBranchSynced, } from "../helpers/project.js";
+import { memoryId, isoDateString } from "../brands.js";
+import { formatCommitBody } from "../helpers/git-commit.js";
+import { buildMutationRetryContract, formatRetrySummary, pushAfterMutation, } from "../helpers/persistence.js";
+import { invalidateActiveProjectCache } from "../cache.js";
+export function registerRelateTool(server, ctx) {
+    server.registerTool("relate", {
+        title: "Relate Memories",
+        description: "Use after you have identified the exact memories to connect.\n\n" +
+            "Create a typed bidirectional relationship between two memories.\n\n" +
+            "Use this when:\n" +
+            "- A newly stored or updated note meaningfully connects to another note\n" +
+            "- One note explains, exemplifies, supersedes, or closely relates to another\n\n" +
+            "Do not use this when:\n" +
+            "- The connection is weak or speculative\n" +
+            "- You need to remove a relationship rather than add one\n\n" +
+            "Returns:\n" +
+            "- Both memory ids and the created relationship type\n\n" +
+            "Side effects: modifies both notes, git commits per affected vault, and may push.\n\n" +
+            "Typical next step:\n" +
+            "- Use `get` on both notes to verify the relationship context reads well.",
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+        inputSchema: z.object({
+            fromId: z.string().describe("Source memory id"),
+            toId: z.string().describe("Target memory id"),
+            type: z.enum(RELATIONSHIP_TYPES).default("related-to").describe("Relationship type: 'related-to' (same topic), 'explains' (clarifies why), 'example-of' (instance of pattern), 'supersedes' (replaces), 'derives-from' (derived artifact), 'follows' (sequence order)"),
+            bidirectional: z.boolean().optional().default(true).describe("Add relationship in both directions (default: true)"),
+            cwd: projectParam,
+        }),
+        outputSchema: RelateResultSchema,
+    }, async ({ fromId, toId, type, bidirectional, cwd }) => {
+        await ensureBranchSynced(ctx, cwd);
+        const [foundFrom, foundTo] = await Promise.all([
+            ctx.vaultManager.findNote(fromId, cwd),
+            ctx.vaultManager.findNote(toId, cwd),
+        ]);
+        if (!foundFrom)
+            return { content: [{ type: "text", text: `No memory found with id '${fromId}'` }], isError: true };
+        if (!foundTo)
+            return { content: [{ type: "text", text: `No memory found with id '${toId}'` }], isError: true };
+        const { note: fromNote, vault: fromVault } = foundFrom;
+        const { note: toNote, vault: toVault } = foundTo;
+        const now = isoDateString(new Date().toISOString());
+        // Group changes by vault so notes in the same vault share one commit
+        const vaultChanges = new Map();
+        const fromRels = fromNote.relatedTo ?? [];
+        const fromRelExists = fromRels.some((r) => r.id === toId);
+        if (!fromRelExists) {
+            await fromVault.storage.writeNote({ ...fromNote, relatedTo: [...fromRels, { id: memoryId(toId), type }], updatedAt: now });
+            const files = vaultChanges.get(fromVault) ?? [];
+            files.push(ctx.vaultManager.noteRelPath(fromVault, fromId));
+            vaultChanges.set(fromVault, files);
+        }
+        const toRels = toNote.relatedTo ?? [];
+        const toRelExists = toRels.some((r) => r.id === fromId);
+        if (bidirectional && !toRelExists) {
+            await toVault.storage.writeNote({ ...toNote, relatedTo: [...toRels, { id: memoryId(fromId), type }], updatedAt: now });
+            const files = vaultChanges.get(toVault) ?? [];
+            files.push(ctx.vaultManager.noteRelPath(toVault, toId));
+            vaultChanges.set(toVault, files);
+        }
+        // Check for uncommitted changes from a previous failed attempt
+        if (vaultChanges.size === 0) {
+            // If relationships exist in note content, check git status for pending changes
+            const allVaults = new Set([fromVault, ...(bidirectional && toVault !== fromVault ? [toVault] : [])]);
+            for (const vault of allVaults) {
+                const noteIds = vault === fromVault
+                    ? (bidirectional && vault === toVault ? [fromId, toId] : [fromId])
+                    : [toId];
+                const pendingFiles = await ctx.vaultManager.getPendingNoteFiles(vault, noteIds);
+                if (pendingFiles.length > 0) {
+                    // Commit the pending changes from previous failed attempt
+                    const commitBody = formatCommitBody({
+                        noteId: fromId,
+                        noteTitle: fromNote.title,
+                        projectName: fromNote.projectName,
+                        relationship: { fromId, toId, type },
+                    });
+                    const commitMessage = `relate: ${fromNote.title} ↔ ${toNote.title}`;
+                    const commitStatus = await vault.git.commitWithStatus(commitMessage, pendingFiles, commitBody);
+                    if (commitStatus.status === "committed") {
+                        await pushAfterMutation(ctx, vault);
+                    }
+                    const retry = buildMutationRetryContract({
+                        commit: commitStatus,
+                        commitMessage,
+                        commitBody,
+                        files: pendingFiles,
+                        cwd,
+                        vault,
+                        mutationApplied: true,
+                        preferredRecovery: "rerun-tool-call-serial",
+                    });
+                    const structuredContent = {
+                        action: "related",
+                        fromId,
+                        toId,
+                        type,
+                        bidirectional,
+                        notesModified: pendingFiles.map((f) => path.basename(f, '.md')),
+                        retry,
+                    };
+                    const retrySummary = formatRetrySummary(retry);
+                    return {
+                        content: [{
+                                type: "text",
+                                text: `Reconciled pending commit for relationship \`${fromId}\` ${bidirectional ? "↔" : "→"} \`${toId}\` (${type})${retrySummary ? `\n${retrySummary}` : ""}`,
+                            }],
+                        structuredContent,
+                    };
+                }
+            }
+            return { content: [{ type: "text", text: `Relationship already exists between '${fromId}' and '${toId}'` }], isError: true };
+        }
+        const modifiedNoteIds = [];
+        let retry;
+        for (const [vault, files] of vaultChanges) {
+            const isFromVault = vault === fromVault;
+            const thisNote = isFromVault ? fromNote : toNote;
+            const otherNote = isFromVault ? toNote : fromNote;
+            const commitBody = formatCommitBody({
+                noteId: thisNote.id,
+                noteTitle: thisNote.title,
+                projectName: thisNote.projectName,
+                relationship: {
+                    fromId: thisNote.id,
+                    toId: otherNote.id,
+                    type,
+                },
+            });
+            const commitMessage = `relate: ${fromNote.title} ↔ ${toNote.title}`;
+            const commitStatus = await vault.git.commitWithStatus(commitMessage, files, commitBody);
+            if (!retry) {
+                retry = buildMutationRetryContract({
+                    commit: commitStatus,
+                    commitMessage,
+                    commitBody,
+                    files,
+                    cwd,
+                    vault,
+                    mutationApplied: true,
+                    preferredRecovery: "rerun-tool-call-serial",
+                });
+            }
+            if (commitStatus.status === "committed") {
+                await pushAfterMutation(ctx, vault);
+            }
+            modifiedNoteIds.push(...files.map(f => path.basename(f, '.md')));
+        }
+        const dirStr = bidirectional ? "↔" : "→";
+        const structuredContent = {
+            action: "related",
+            fromId,
+            toId,
+            type,
+            bidirectional,
+            notesModified: modifiedNoteIds,
+            retry,
+        };
+        const retrySummary = formatRetrySummary(retry);
+        invalidateActiveProjectCache();
+        return {
+            content: [{
+                    type: "text",
+                    text: `Linked \`${fromId}\` ${dirStr} \`${toId}\` (${type})${retrySummary ? `\n${retrySummary}` : ""}`,
+                }],
+            structuredContent,
+        };
+    });
+}
+//# sourceMappingURL=relate.js.map

package/build/tools/relate.js.map

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

package/build/tools/remember.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 registerRememberTool(server: McpServer, ctx: ServerContext): void;
+//# sourceMappingURL=remember.d.ts.map

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

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

package/build/tools/remember.js

@@ -0,0 +1,219 @@
+import { z } from "zod";
+import { NOTE_LIFECYCLES, NOTE_ROLES } from "../storage.js";
+import { isoDateString } from "../brands.js";
+import { getErrorMessage } from "../error-utils.js";
+import { embed, embedModel } from "../embeddings.js";
+import { invalidateActiveProjectCache, getRecentSessionNoteAccesses, getSessionCachedNote, getRecentSessionAccessNote, } from "../cache.js";
+import { suggestAutoRelationships } from "../auto-relate.js";
+import { MarkdownLintError, cleanMarkdown } from "../markdown.js";
+import { resolveWriteScope, WRITE_SCOPES } from "../project-memory-policy.js";
+import { resolveProject, resolveWriteVault, ensureBranchSynced, describeProject, } from "../helpers/project.js";
+import { extractSummary, formatCommitBody, formatAskForWriteScope, shouldBlockProtectedBranchCommit, } from "../helpers/git-commit.js";
+import { embedTextForNote } from "../helpers/embed.js";
+import { buildPersistenceStatus, formatPersistenceSummary, buildMutationRetryContract, pushAfterMutation, } from "../helpers/persistence.js";
+import { storageLabel, ROLE_LIFECYCLE_DEFAULTS } from "../helpers/vault.js";
+import { makeId } from "../helpers/index.js";
+import { RememberResultSchema } from "../structured-content.js";
+export function registerRememberTool(server, ctx) {
+    server.registerTool("remember", {
+        title: "Remember",
+        description: "REQUIRES: Call `recall` or `list` first to check whether this memory already exists.\n\n" +
+            "Create a new memory as a markdown note with embeddings for future recall.\n\n" +
+            "Use this when:\n" +
+            "- A decision, preference, bug fix, or durable context should survive beyond this session\n" +
+            "- No existing note already covers the topic\n\n" +
+            "Do not use this when:\n" +
+            "- A memory may already exist; use `recall` first to check\n" +
+            "- You need to change an existing memory; use `update`\n" +
+            "- Several overlapping notes should be merged; use `consolidate`\n\n" +
+            "Returns:\n" +
+            "- The created memory id, scope, vault label, lifecycle, and persistence status\n\n" +
+            "Side effects: writes a note, writes embeddings, git commits, and may push.\n\n" +
+            "Typical next step:\n" +
+            "- Use `relate` if this new memory connects to something recalled earlier.",
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: true,
+        },
+        inputSchema: z.object({
+            title: z.string().max(500, "Title must be at most 500 characters").describe("Specific, retrieval-friendly title. Prefer the concrete topic or decision, not a vague label."),
+            content: z.string().max(100000, "Content must be at most 100,000 characters").describe("Markdown note body. Put the key fact, decision, or outcome in the opening lines, then supporting detail. Embeddings weight early content more heavily. " +
+                "Content must pass markdown lint. Auto-fixable issues are fixed automatically. Common unfixable issues: fenced code blocks need a language tag (e.g. use ```text not bare ```), and broken links are rejected. " +
+                "If lint fails, fix the specific issues listed in the error and retry the same call."),
+            tags: z.array(z.string()).optional().default([]).describe("Optional tags for later filtering. Use a small number of stable, meaningful tags."),
+            lifecycle: z
+                .enum(NOTE_LIFECYCLES)
+                .optional()
+                .describe("Memory lifetime. Use `temporary` for short-lived working context such as active investigations or transient status. " +
+                "Use `permanent` for durable knowledge such as decisions, fixes, patterns, and preferences. " +
+                "When omitted, defaults based on role: research/plan/review → temporary, decision/summary/reference → permanent."),
+            role: z
+                .enum(NOTE_ROLES)
+                .optional()
+                .describe("Optional prioritization hint for the note. Inferred automatically when omitted. " +
+                "Set explicitly for workflow artifacts like research or review notes."),
+            summary: z.string().optional().describe("Git commit summary only. Imperative mood, concise, and focused on why the change matters."),
+            alwaysLoad: z
+                .boolean()
+                .optional()
+                .describe("When true, this note loads automatically at session start and receives priority in recall and relationship expansion. " +
+                "Use for session anchors and critical context that should always be available."),
+            cwd: z
+                .string()
+                .optional()
+                .describe("Absolute project working directory. Pass this whenever the task is related to a repository so routing, search boosting, policy lookup, and vault selection work correctly."),
+            scope: z
+                .enum(WRITE_SCOPES)
+                .optional()
+                .describe("Where to store: 'project' writes to the shared project vault visible to all contributors; " +
+                "'global' writes to the private main vault visible only on this machine. " +
+                "When omitted, uses the project's saved policy or defaults to 'project'."),
+            allowProtectedBranch: z
+                .boolean()
+                .optional()
+                .describe("One-time override for protected branch checks. " +
+                "When true, remember can commit on a protected branch without changing project policy."),
+            checkedForExisting: z
+                .boolean()
+                .optional()
+                .describe("Optional agent hint indicating that `recall` or `list` was already used to check for an existing memory on this topic."),
+        }),
+        outputSchema: RememberResultSchema,
+    }, async ({ title, content, tags, lifecycle, role, summary, alwaysLoad, cwd, scope, allowProtectedBranch = false }) => {
+        await ensureBranchSynced(ctx, cwd);
+        const project = await resolveProject(ctx, cwd);
+        let cleanedContent;
+        try {
+            cleanedContent = await cleanMarkdown(content);
+        }
+        catch (err) {
+            if (err instanceof MarkdownLintError) {
+                const message = `Markdown lint issues prevented this note from being stored. Fix the specific lint errors listed below in your content and retry the remember call — the note was NOT stored.\n\n${err.message}`;
+                return {
+                    content: [{ type: "text", text: message }],
+                    structuredContent: { action: "lint_error", tool: "remember", issues: err.issues },
+                    isError: true,
+                };
+            }
+            throw err;
+        }
+        const policy = project ? await ctx.configStore.getProjectPolicy(project.id) : undefined;
+        const policyScope = policy?.defaultScope;
+        const projectVaultExists = cwd ? Boolean(await ctx.vaultManager.getProjectVaultIfExists(cwd)) : true;
+        const writeScope = resolveWriteScope(scope, policyScope, Boolean(project), projectVaultExists);
+        if (writeScope === "ask") {
+            const unadopted = !projectVaultExists && !policyScope;
+            return { content: [{ type: "text", text: formatAskForWriteScope(project, unadopted) }], isError: true };
+        }
+        const protectedBranchCheck = await shouldBlockProtectedBranchCommit({
+            cwd,
+            writeScope,
+            automaticCommit: true,
+            projectLabel: project ? `${project.name} (${project.id})` : "this context",
+            policy,
+            allowProtectedBranch,
+            toolName: "remember",
+            ctx,
+        });
+        if (protectedBranchCheck.blocked) {
+            return { content: [{ type: "text", text: protectedBranchCheck.message ?? "Protected branch policy blocked this commit." }], isError: true };
+        }
+        const vault = await resolveWriteVault(ctx, cwd, writeScope);
+        const id = makeId(title);
+        const now = isoDateString(new Date().toISOString());
+        const note = {
+            id, title, content: cleanedContent, tags,
+            lifecycle: lifecycle ?? (role ? ROLE_LIFECYCLE_DEFAULTS[role] : undefined) ?? "permanent",
+            ...(role ? { role } : {}),
+            alwaysLoad: alwaysLoad ?? false,
+            project: project?.id,
+            projectName: project?.name,
+            createdAt: now,
+            updatedAt: now,
+            memoryVersion: 1,
+        };
+        if (project) {
+            const accessCandidates = getRecentSessionNoteAccesses(project.id)
+                .map((entry) => {
+                const cachedNote = getSessionCachedNote(project.id, entry.vaultPath, entry.noteId)
+                    ?? getRecentSessionAccessNote(project.id, entry.vaultPath, entry.noteId);
+                return cachedNote
+                    ? { note: cachedNote, accessedAt: entry.accessedAt, accessKind: entry.accessKind, score: entry.score }
+                    : null;
+            })
+                .filter((entry) => entry !== null);
+            const autoRelationships = suggestAutoRelationships(note, accessCandidates);
+            if (autoRelationships.length > 0) {
+                note.relatedTo = autoRelationships;
+            }
+        }
+        await vault.storage.writeNote(note);
+        let embeddingStatus = { status: "written" };
+        try {
+            const text = await embedTextForNote(vault.storage, note);
+            const vector = await embed(text);
+            await vault.storage.writeEmbedding({ id, model: embedModel, embedding: vector, updatedAt: now });
+        }
+        catch (err) {
+            embeddingStatus = { status: "skipped", reason: getErrorMessage(err) };
+            console.error(`[embedding] Skipped for '${id}': ${err}`);
+        }
+        const projectScope = describeProject(project);
+        const commitSummary = summary ?? extractSummary(cleanedContent);
+        const commitBody = formatCommitBody({
+            summary: commitSummary,
+            noteId: id,
+            noteTitle: title,
+            projectName: project?.name,
+            scope: writeScope,
+            tags: tags,
+        });
+        const commitMessage = `remember: ${title}`;
+        const commitFiles = [ctx.vaultManager.noteRelPath(vault, id)];
+        const commitStatus = await vault.git.commitWithStatus(commitMessage, commitFiles, commitBody);
+        const pushStatus = commitStatus.status === "committed"
+            ? await pushAfterMutation(ctx, vault)
+            : { status: "skipped", reason: "commit-failed" };
+        const retry = buildMutationRetryContract({
+            commit: commitStatus,
+            commitMessage,
+            commitBody,
+            files: commitFiles,
+            cwd,
+            vault,
+            mutationApplied: true,
+        });
+        const persistence = buildPersistenceStatus({
+            storage: vault.storage,
+            id,
+            embedding: embeddingStatus,
+            commit: commitStatus,
+            push: pushStatus,
+            commitMessage,
+            commitBody,
+            retry,
+        });
+        const vaultLabel = vault.isProject ? " [project vault]" : " [main vault]";
+        const textContent = `Remembered as \`${id}\` [${projectScope}, stored=${writeScope}]${vaultLabel}\n${formatPersistenceSummary(persistence)}`;
+        const structuredContent = {
+            action: "remembered",
+            id,
+            title,
+            project: project ? { id: project.id, name: project.name } : undefined,
+            scope: writeScope,
+            vault: storageLabel(vault),
+            tags: tags || [],
+            lifecycle: note.lifecycle,
+            timestamp: now,
+            persistence,
+        };
+        invalidateActiveProjectCache();
+        return {
+            content: [{ type: "text", text: textContent }],
+            structuredContent,
+        };
+    });
+}
+//# sourceMappingURL=remember.js.map

package/build/tools/remember.js.map

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

package/build/tools/set-project-identity.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 registerSetProjectIdentityTool(server: McpServer, ctx: ServerContext): void;
+//# sourceMappingURL=set-project-identity.d.ts.map

package/build/tools/set-project-identity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"set-project-identity.d.ts","sourceRoot":"","sources":["../../src/tools/set-project-identity.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAO1D,wBAAgB,8BAA8B,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,aAAa,GAAG,IAAI,CAwH1F"}

package/build/tools/set-project-identity.js

@@ -0,0 +1,113 @@
+import { z } from "zod";
+import { resolveProjectIdentity } from "../project.js";
+import { projectNotFoundResponse } from "../helpers/vault.js";
+import { formatCommitBody } from "../helpers/git-commit.js";
+import { pushAfterMutation as pushAfterMutationFromModule, buildMutationRetryContract, formatRetrySummary } from "../helpers/persistence.js";
+import { RemoteNameSchema, ProjectIdentityResultSchema } from "../structured-content.js";
+export function registerSetProjectIdentityTool(server, ctx) {
+    server.registerTool("set_project_identity", {
+        title: "Set Project Identity",
+        description: "Override which git remote defines project identity for a repo.\n\n" +
+            "Use this when:\n" +
+            "- A fork should associate memory with the upstream project rather than the fork remote\n" +
+            "- Project detection is resolving to the wrong canonical repo\n\n" +
+            "Do not use this when:\n" +
+            "- The default remote already identifies the correct project\n\n" +
+            "Returns:\n" +
+            "- The new effective project identity after applying the override\n\n" +
+            "Side effects: writes config, git commits, and may push.\n\n" +
+            "Typical next step:\n" +
+            "- Re-run `detect_project` or `get_project_identity` to verify the result.",
+        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."),
+            remoteName: RemoteNameSchema.describe("Git remote name to use as the canonical project identity, such as `upstream`")
+        }),
+        outputSchema: ProjectIdentityResultSchema,
+    }, async ({ cwd, remoteName }) => {
+        const defaultIdentity = await resolveProjectIdentity(cwd);
+        if (!defaultIdentity) {
+            return projectNotFoundResponse(cwd);
+        }
+        const defaultProject = defaultIdentity.project;
+        if (defaultProject.source !== "git-remote") {
+            return {
+                content: [{
+                        type: "text",
+                        text: `Project identity override requires a git remote. Current source: ${defaultProject.source}`,
+                    }],
+            };
+        }
+        const now = new Date().toISOString();
+        const candidateIdentity = await resolveProjectIdentity(cwd, {
+            getProjectIdentityOverride: async () => ({ remoteName, updatedAt: now }),
+        });
+        if (!candidateIdentity || !candidateIdentity.identityOverrideApplied) {
+            return {
+                content: [{
+                        type: "text",
+                        text: `Could not resolve git remote '${remoteName}' for ${defaultProject.name}.`,
+                    }],
+            };
+        }
+        await ctx.configStore.setProjectIdentityOverride(defaultProject.id, { remoteName, updatedAt: now });
+        const commitBody = formatCommitBody({
+            summary: `Use ${remoteName} as canonical project identity`,
+            projectName: defaultProject.name,
+            description: `Default identity: ${defaultProject.id}\n` +
+                `Resolved identity: ${candidateIdentity.project.id}\n` +
+                `Remote: ${remoteName}`,
+        });
+        const commitMessage = `identity: ${defaultProject.name} use remote ${remoteName}`;
+        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: "project_identity_set",
+            project: {
+                id: candidateIdentity.project.id,
+                name: candidateIdentity.project.name,
+                source: candidateIdentity.project.source,
+                remoteName: candidateIdentity.project.remoteName,
+            },
+            defaultProject: {
+                id: defaultProject.id,
+                name: defaultProject.name,
+                remoteName: defaultProject.remoteName,
+            },
+            identityOverride: {
+                remoteName,
+                updatedAt: now,
+            },
+            retry,
+        };
+        return {
+            content: [{
+                    type: "text",
+                    text: `Project identity override set for ${defaultProject.name}: ` +
+                        `default=\`${defaultProject.id}\`, effective=\`${candidateIdentity.project.id}\`, remote=${remoteName}` +
+                        `${commitStatus.status === "failed"
+                            ? `\n${formatRetrySummary(retry) ?? `Commit failed. Push status: ${pushStatus.status}.`}`
+                            : ""}`,
+                }],
+            structuredContent,
+        };
+    });
+}
+//# sourceMappingURL=set-project-identity.js.map

package/build/tools/set-project-identity.js.map

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

package/build/tools/sync.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 registerSyncTool(server: McpServer, ctx: ServerContext): void;
+//# sourceMappingURL=sync.d.ts.map

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

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