mcp-context-sync 1.0.0

package/dist/tools/amend-snapshot.js

@@ -0,0 +1,126 @@
+import { AmendSnapshotInputSchema } from '../lib/types.js';
+import { projectIdFromPath, displayNameFromPath, } from '../lib/project-id.js';
+import { getLatestSnapshot, updateSnapshot, insertDecision } from '../db/queries.js';
+import { generateId } from '../lib/uuid.js';
+export function registerAmendSnapshotTool(server, db) {
+    server.registerTool('amend-snapshot', {
+        title: 'Amend Last Snapshot',
+        description: 'Update the most recent snapshot for a project. Useful for adding forgotten tasks, ' +
+            'correcting decisions, or updating next steps before another agent resumes.',
+        inputSchema: AmendSnapshotInputSchema,
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: false,
+        },
+    }, async (input) => {
+        const projectId = projectIdFromPath(input.projectDir);
+        const displayName = displayNameFromPath(input.projectDir);
+        const snapshot = getLatestSnapshot(db, projectId);
+        if (!snapshot) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `No snapshot found for project "${displayName}" to amend.`,
+                    },
+                ],
+            };
+        }
+        const now = new Date().toISOString();
+        const changes = [];
+        // Tasks completed
+        if (input.addTasksCompleted?.length) {
+            const current = JSON.parse(snapshot.tasks_completed);
+            current.push(...input.addTasksCompleted);
+            updateSnapshot(db, snapshot.id, {
+                tasks_completed: JSON.stringify(current),
+            });
+            changes.push(`Added ${input.addTasksCompleted.length} completed tasks`);
+        }
+        // Tasks remaining
+        let remaining = JSON.parse(snapshot.tasks_remaining);
+        if (input.removeTasksRemaining?.length) {
+            const toRemove = new Set(input.removeTasksRemaining);
+            remaining = remaining.filter((t) => !toRemove.has(t));
+            changes.push(`Removed ${input.removeTasksRemaining.length} remaining tasks`);
+        }
+        if (input.addTasksRemaining?.length) {
+            remaining.push(...input.addTasksRemaining);
+            changes.push(`Added ${input.addTasksRemaining.length} remaining tasks`);
+        }
+        if (input.removeTasksRemaining?.length || input.addTasksRemaining?.length) {
+            updateSnapshot(db, snapshot.id, {
+                tasks_remaining: JSON.stringify(remaining),
+            });
+        }
+        // Decisions
+        if (input.addDecisions?.length) {
+            const current = JSON.parse(snapshot.decisions);
+            current.push(...input.addDecisions);
+            updateSnapshot(db, snapshot.id, {
+                decisions: JSON.stringify(current),
+            });
+            for (const d of input.addDecisions) {
+                insertDecision(db, {
+                    id: generateId(),
+                    project_id: projectId,
+                    snapshot_id: snapshot.id,
+                    agent: input.agent,
+                    decision: d.decision,
+                    reasoning: d.reasoning,
+                    alternatives: JSON.stringify(d.alternatives ?? []),
+                    category: null,
+                    related_files: '[]',
+                    created_at: now,
+                });
+            }
+            changes.push(`Added ${input.addDecisions.length} decisions`);
+        }
+        // Next steps
+        if (input.updateNextSteps) {
+            updateSnapshot(db, snapshot.id, {
+                next_steps: input.updateNextSteps,
+            });
+            changes.push('Updated next steps');
+        }
+        // Blockers
+        let blockers = JSON.parse(snapshot.blockers);
+        if (input.removeBlockers?.length) {
+            const toRemove = new Set(input.removeBlockers);
+            blockers = blockers.filter((b) => !toRemove.has(b));
+            changes.push(`Removed ${input.removeBlockers.length} blockers`);
+        }
+        if (input.addBlockers?.length) {
+            blockers.push(...input.addBlockers);
+            changes.push(`Added ${input.addBlockers.length} blockers`);
+        }
+        if (input.removeBlockers?.length || input.addBlockers?.length) {
+            updateSnapshot(db, snapshot.id, {
+                blockers: JSON.stringify(blockers),
+            });
+        }
+        // Tags
+        if (input.addTags?.length) {
+            const current = JSON.parse(snapshot.tags);
+            const unique = [...new Set([...current, ...input.addTags])];
+            updateSnapshot(db, snapshot.id, { tags: JSON.stringify(unique) });
+            changes.push(`Added ${input.addTags.length} tags`);
+        }
+        // Mark as amended
+        updateSnapshot(db, snapshot.id, {
+            amended_at: now,
+            amended_by: input.agent,
+        });
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Snapshot #${snapshot.sequence_number} amended for "${displayName}":\n\n${changes.map((c) => `- ${c}`).join('\n')}`,
+                },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=amend-snapshot.js.map

package/dist/tools/amend-snapshot.js.map

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

package/dist/tools/get-history.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type Database from 'better-sqlite3';
+export declare function registerGetHistoryTool(server: McpServer, db: Database.Database): void;

package/dist/tools/get-history.js

@@ -0,0 +1,58 @@
+import { GetHistoryInputSchema } from '../lib/types.js';
+import { projectIdFromPath, displayNameFromPath, } from '../lib/project-id.js';
+import { getProject, getSnapshotsByProject, getHandoffsByProject, } from '../db/queries.js';
+export function registerGetHistoryTool(server, db) {
+    server.registerTool('get-history', {
+        title: 'Get Project Handoff History',
+        description: 'View the timeline of agent handoffs, snapshots, and decisions for a project.',
+        inputSchema: GetHistoryInputSchema,
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+    }, async (input) => {
+        const projectId = projectIdFromPath(input.projectDir);
+        const displayName = displayNameFromPath(input.projectDir);
+        const project = getProject(db, projectId);
+        if (!project) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `No history found for project "${displayName}".`,
+                    },
+                ],
+            };
+        }
+        let snapshots = getSnapshotsByProject(db, projectId, input.limit);
+        if (input.agentFilter !== 'all') {
+            snapshots = snapshots.filter((s) => s.agent === input.agentFilter);
+        }
+        const handoffs = getHandoffsByProject(db, projectId, 50);
+        const lines = [];
+        lines.push(`# Project Timeline: ${displayName}`);
+        lines.push(`Total: ${project.snapshot_count} snapshots, ${project.handoff_count} handoffs`);
+        lines.push('');
+        for (const s of snapshots.reverse()) {
+            lines.push(`## Snapshot #${s.sequence_number} -- ${s.agent} -- ${s.created_at}`);
+            lines.push(s.summary);
+            if (input.includeDecisions) {
+                const decs = JSON.parse(s.decisions);
+                for (const d of decs) {
+                    lines.push(`  Decision: ${d.decision}`);
+                }
+            }
+            const ho = handoffs.find((h) => h.snapshot_id === s.id);
+            if (ho) {
+                lines.push(`  Handoff: ${ho.from_agent} -> ${ho.to_agent} (${ho.to_timestamp})`);
+            }
+            lines.push('');
+        }
+        return {
+            content: [{ type: 'text', text: lines.join('\n') }],
+        };
+    });
+}
+//# sourceMappingURL=get-history.js.map

package/dist/tools/get-history.js.map

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

package/dist/tools/list-projects.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type Database from 'better-sqlite3';
+export declare function registerListProjectsTool(server: McpServer, db: Database.Database): void;

package/dist/tools/list-projects.js

@@ -0,0 +1,40 @@
+import { ListProjectsInputSchema } from '../lib/types.js';
+import { listProjects } from '../db/queries.js';
+export function registerListProjectsTool(server, db) {
+    server.registerTool('list-projects', {
+        title: 'List Synced Projects',
+        description: 'List all projects that have context-sync snapshots, with summary stats.',
+        inputSchema: ListProjectsInputSchema,
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+    }, async () => {
+        const projects = listProjects(db);
+        if (projects.length === 0) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: 'No projects have been synced yet. Use the "sync" tool to create your first snapshot.',
+                    },
+                ],
+            };
+        }
+        const lines = ['# Synced Projects', ''];
+        for (const p of projects) {
+            lines.push(`## ${p.display_name}`);
+            lines.push(`- **Path:** ${p.normalized_path}`);
+            lines.push(`- **Snapshots:** ${p.snapshot_count}`);
+            lines.push(`- **Handoffs:** ${p.handoff_count}`);
+            lines.push(`- **Last synced:** ${p.last_synced_at ?? 'never'}`);
+            lines.push('');
+        }
+        return {
+            content: [{ type: 'text', text: lines.join('\n') }],
+        };
+    });
+}
+//# sourceMappingURL=list-projects.js.map

package/dist/tools/list-projects.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-projects.js","sourceRoot":"","sources":["../../src/tools/list-projects.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAEhD,MAAM,UAAU,wBAAwB,CACtC,MAAiB,EACjB,EAAqB;IAErB,MAAM,CAAC,YAAY,CACjB,eAAe,EACf;QACE,KAAK,EAAE,sBAAsB;QAC7B,WAAW,EACT,yEAAyE;QAC3E,WAAW,EAAE,uBAAuB;QACpC,WAAW,EAAE;YACX,YAAY,EAAE,IAAI;YAClB,eAAe,EAAE,KAAK;YACtB,cAAc,EAAE,IAAI;YACpB,aAAa,EAAE,KAAK;SACrB;KACF,EACD,KAAK,IAAI,EAAE;QACT,MAAM,QAAQ,GAAG,YAAY,CAAC,EAAE,CAAC,CAAC;QAElC,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC1B,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,sFAAsF;qBAC7F;iBACF;aACF,CAAC;QACJ,CAAC;QAED,MAAM,KAAK,GAAa,CAAC,mBAAmB,EAAE,EAAE,CAAC,CAAC;QAClD,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;YACzB,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,YAAY,EAAE,CAAC,CAAC;YACnC,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,eAAe,EAAE,CAAC,CAAC;YAC/C,KAAK,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC,cAAc,EAAE,CAAC,CAAC;YACnD,KAAK,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC,aAAa,EAAE,CAAC,CAAC;YACjD,KAAK,CAAC,IAAI,CACR,sBAAsB,CAAC,CAAC,cAAc,IAAI,OAAO,EAAE,CACpD,CAAC;YACF,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjB,CAAC;QAED,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;SAC7D,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/log-decision.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type Database from 'better-sqlite3';
+export declare function registerLogDecisionTool(server: McpServer, db: Database.Database): void;

package/dist/tools/log-decision.js

@@ -0,0 +1,46 @@
+import { LogDecisionInputSchema } from '../lib/types.js';
+import { projectIdFromPath, normalizePath, displayNameFromPath, } from '../lib/project-id.js';
+import { generateId } from '../lib/uuid.js';
+import { upsertProject, insertDecision } from '../db/queries.js';
+export function registerLogDecisionTool(server, db) {
+    server.registerTool('log-decision', {
+        title: 'Log Decision',
+        description: 'Record an architectural or implementation decision for the project. ' +
+            'Useful during a session when a significant decision is made that future agents should know about.',
+        inputSchema: LogDecisionInputSchema,
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: false,
+        },
+    }, async (input) => {
+        const projectId = projectIdFromPath(input.projectDir);
+        const normalized = normalizePath(input.projectDir);
+        const displayName = displayNameFromPath(input.projectDir);
+        const now = new Date().toISOString();
+        const decisionId = generateId();
+        upsertProject(db, projectId, normalized, displayName);
+        insertDecision(db, {
+            id: decisionId,
+            project_id: projectId,
+            snapshot_id: null,
+            agent: input.agent,
+            decision: input.decision,
+            reasoning: input.reasoning,
+            alternatives: JSON.stringify(input.alternatives ?? []),
+            category: input.category ?? null,
+            related_files: JSON.stringify(input.relatedFiles ?? []),
+            created_at: now,
+        });
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Decision logged for "${displayName}":\n\n**${input.decision}**\n${input.reasoning}\n\nID: ${decisionId}`,
+                },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=log-decision.js.map

package/dist/tools/log-decision.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-decision.js","sourceRoot":"","sources":["../../src/tools/log-decision.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,EACL,iBAAiB,EACjB,aAAa,EACb,mBAAmB,GACpB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEjE,MAAM,UAAU,uBAAuB,CACrC,MAAiB,EACjB,EAAqB;IAErB,MAAM,CAAC,YAAY,CACjB,cAAc,EACd;QACE,KAAK,EAAE,cAAc;QACrB,WAAW,EACT,sEAAsE;YACtE,mGAAmG;QACrG,WAAW,EAAE,sBAAsB;QACnC,WAAW,EAAE;YACX,YAAY,EAAE,KAAK;YACnB,eAAe,EAAE,KAAK;YACtB,cAAc,EAAE,KAAK;YACrB,aAAa,EAAE,KAAK;SACrB;KACF,EACD,KAAK,EAAE,KAAK,EAAE,EAAE;QACd,MAAM,SAAS,GAAG,iBAAiB,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QACtD,MAAM,UAAU,GAAG,aAAa,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QACnD,MAAM,WAAW,GAAG,mBAAmB,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QAC1D,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QACrC,MAAM,UAAU,GAAG,UAAU,EAAE,CAAC;QAEhC,aAAa,CAAC,EAAE,EAAE,SAAS,EAAE,UAAU,EAAE,WAAW,CAAC,CAAC;QAEtD,cAAc,CAAC,EAAE,EAAE;YACjB,EAAE,EAAE,UAAU;YACd,UAAU,EAAE,SAAS;YACrB,WAAW,EAAE,IAAI;YACjB,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,YAAY,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,YAAY,IAAI,EAAE,CAAC;YACtD,QAAQ,EAAE,KAAK,CAAC,QAAQ,IAAI,IAAI;YAChC,aAAa,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,YAAY,IAAI,EAAE,CAAC;YACvD,UAAU,EAAE,GAAG;SAChB,CAAC,CAAC;QAEH,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE,wBAAwB,WAAW,WAAW,KAAK,CAAC,QAAQ,OAAO,KAAK,CAAC,SAAS,WAAW,UAAU,EAAE;iBAChH;aACF;SACF,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/resume.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type Database from 'better-sqlite3';
+export declare function registerResumeTool(server: McpServer, db: Database.Database): void;

package/dist/tools/resume.js

@@ -0,0 +1,113 @@
+import { ResumeInputSchema } from '../lib/types.js';
+import { projectIdFromPath, displayNameFromPath, normalizePath, } from '../lib/project-id.js';
+import { generateId } from '../lib/uuid.js';
+import { renderSnapshotMarkdown } from '../lib/snapshot-renderer.js';
+import { getProject, getLatestSnapshot, getSnapshotById, insertHandoff, updateProjectSyncStats, getProjectAgents, listProjects, } from '../db/queries.js';
+export function registerResumeTool(server, db) {
+    server.registerTool('resume', {
+        title: 'Resume from Context Snapshot',
+        description: 'Load the latest context snapshot for a project to continue where another agent left off. ' +
+            'Returns the full snapshot with summary, pending tasks, decisions, and next steps.',
+        inputSchema: ResumeInputSchema,
+        annotations: {
+            readOnlyHint: false, // writes a handoff record
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: false,
+        },
+    }, async (input) => {
+        const projectId = projectIdFromPath(input.projectDir);
+        const displayName = displayNameFromPath(input.projectDir);
+        const project = getProject(db, projectId);
+        if (!project) {
+            return { content: [{ type: 'text', text: buildNotFoundMessage(db, input.projectDir, displayName, projectId) }] };
+        }
+        const snapshot = input.snapshotId
+            ? getSnapshotById(db, input.snapshotId)
+            : getLatestSnapshot(db, projectId);
+        if (!snapshot) {
+            return {
+                content: [{
+                        type: 'text',
+                        text: `Project "${displayName}" exists but has no snapshots${input.snapshotId ? ` with ID "${input.snapshotId}"` : ''}.`,
+                    }],
+            };
+        }
+        // Register the handoff in a transaction
+        const now = new Date().toISOString();
+        const agents = db.transaction(() => {
+            insertHandoff(db, {
+                id: generateId(),
+                project_id: projectId,
+                snapshot_id: snapshot.id,
+                from_agent: snapshot.agent,
+                to_agent: input.agent,
+                from_timestamp: snapshot.created_at,
+                to_timestamp: now,
+                created_at: now,
+            });
+            updateProjectSyncStats(db, projectId);
+            return getProjectAgents(db, projectId);
+        })();
+        const markdown = renderSnapshotMarkdown(snapshot, displayName, {
+            totalSnapshots: project.snapshot_count,
+            totalHandoffs: project.handoff_count + 1,
+            agents,
+        });
+        return { content: [{ type: 'text', text: markdown }] };
+    });
+}
+// ---------------------------------------------------------------------------
+// Error message builder
+// ---------------------------------------------------------------------------
+function buildNotFoundMessage(db, inputPath, displayName, projectId) {
+    const normalized = normalizePath(inputPath);
+    const allProjects = listProjects(db);
+    const lines = [
+        `No context-sync data found for project "${displayName}"`,
+        '',
+        '**Searched for:**',
+        `- Path: \`${normalized}\``,
+        `- ID: \`${projectId}\``,
+        '',
+    ];
+    if (allProjects.length === 0) {
+        lines.push('No projects have been synced yet. Use the `sync` tool first.');
+        return lines.join('\n');
+    }
+    lines.push(`**Available projects (${allProjects.length}):**`);
+    // Rank projects by path similarity (shared prefix segments)
+    const ranked = allProjects
+        .map((p) => ({ ...p, score: pathSimilarity(normalized, p.normalized_path) }))
+        .sort((a, b) => b.score - a.score);
+    for (const p of ranked) {
+        const marker = p === ranked[0] ? '> ' : '  ';
+        lines.push(`${marker}\`${p.normalized_path}\`  (${p.snapshot_count} snapshots)`);
+    }
+    // Suggest the best match if reasonably close
+    const best = ranked[0];
+    if (best.score > 0.5) {
+        lines.push('', `**Suggestion:** Did you mean \`${best.normalized_path}\`?`);
+    }
+    lines.push('', '**Troubleshooting:**', '- Use the absolute path to the **project root**, not a subdirectory', '- Path normalization is automatic (lowercase, forward slashes)', '- If none match, create a new snapshot with `sync`');
+    return lines.join('\n');
+}
+// ---------------------------------------------------------------------------
+// Path similarity: ratio of shared prefix segments to total segments
+// ---------------------------------------------------------------------------
+function pathSimilarity(a, b) {
+    const segsA = a.split('/').filter(Boolean);
+    const segsB = b.split('/').filter(Boolean);
+    const maxLen = Math.max(segsA.length, segsB.length);
+    if (maxLen === 0)
+        return 0;
+    let shared = 0;
+    for (let i = 0; i < Math.min(segsA.length, segsB.length); i++) {
+        if (segsA[i] === segsB[i])
+            shared++;
+        else
+            break;
+    }
+    return shared / maxLen;
+}
+//# sourceMappingURL=resume.js.map

package/dist/tools/resume.js.map

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

package/dist/tools/search-snapshots.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type Database from 'better-sqlite3';
+export declare function registerSearchSnapshotsTool(server: McpServer, db: Database.Database): void;

package/dist/tools/search-snapshots.js

@@ -0,0 +1,71 @@
+import { SearchSnapshotsInputSchema } from '../lib/types.js';
+import { projectIdFromPath } from '../lib/project-id.js';
+import { searchSnapshots, getSnapshotsByProject } from '../db/queries.js';
+export function registerSearchSnapshotsTool(server, db) {
+    server.registerTool('search-snapshots', {
+        title: 'Search Snapshots',
+        description: 'Search across context snapshots by keyword, tag, date range, or agent.',
+        inputSchema: SearchSnapshotsInputSchema,
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+    }, async (input) => {
+        const projectId = input.projectDir
+            ? projectIdFromPath(input.projectDir)
+            : undefined;
+        let results;
+        if (input.query) {
+            results = searchSnapshots(db, input.query, projectId, input.agent, input.since, input.until, input.limit);
+        }
+        else if (projectId) {
+            // No query text, just filter by project
+            results = getSnapshotsByProject(db, projectId, input.limit);
+            if (input.agent) {
+                results = results.filter((s) => s.agent === input.agent);
+            }
+            if (input.since) {
+                results = results.filter((s) => s.created_at >= input.since);
+            }
+            if (input.until) {
+                results = results.filter((s) => s.created_at <= input.until);
+            }
+        }
+        else {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: 'Please provide a "query" for full-text search or a "projectDir" to list snapshots.',
+                    },
+                ],
+            };
+        }
+        if (!results || results.length === 0) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `No snapshots found matching your search criteria.`,
+                    },
+                ],
+            };
+        }
+        const lines = [`# Search Results (${results.length} found)`, ''];
+        for (const s of results) {
+            lines.push(`### Snapshot #${s.sequence_number} -- ${s.agent} -- ${s.created_at}`);
+            lines.push(s.summary);
+            const tags = JSON.parse(s.tags);
+            if (tags.length > 0) {
+                lines.push(`Tags: ${tags.map((t) => `\`${t}\``).join(', ')}`);
+            }
+            lines.push('');
+        }
+        return {
+            content: [{ type: 'text', text: lines.join('\n') }],
+        };
+    });
+}
+//# sourceMappingURL=search-snapshots.js.map

package/dist/tools/search-snapshots.js.map

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

package/dist/tools/sync.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type Database from 'better-sqlite3';
+export declare function registerSyncTool(server: McpServer, db: Database.Database): void;

package/dist/tools/sync.js

@@ -0,0 +1,102 @@
+import { SyncInputSchema } from '../lib/types.js';
+import { projectIdFromPath, normalizePath, displayNameFromPath, } from '../lib/project-id.js';
+import { generateId } from '../lib/uuid.js';
+import { upsertProject, getNextSequenceNumber, insertSnapshot, insertDecision, updateProjectSyncStats, } from '../db/queries.js';
+import { validateProjectDir, suggestProjectRoot, formatWarnings, } from '../lib/validation.js';
+export function registerSyncTool(server, db) {
+    server.registerTool('sync', {
+        title: 'Sync Context Snapshot',
+        description: 'Save a structured snapshot of current work state for cross-agent handoff. ' +
+            'Call this when finishing a work session so another agent can resume.',
+        inputSchema: SyncInputSchema,
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: false,
+        },
+    }, async (input) => {
+        const projectId = projectIdFromPath(input.projectDir);
+        const normalized = normalizePath(input.projectDir);
+        const displayName = displayNameFromPath(input.projectDir);
+        const now = new Date().toISOString();
+        const validation = validateProjectDir(input.projectDir);
+        const suggestedRoot = suggestProjectRoot(input.projectDir);
+        const txn = db.transaction(() => {
+            upsertProject(db, projectId, normalized, displayName);
+            const seqNum = getNextSequenceNumber(db, projectId);
+            const snapshotId = generateId();
+            // Serialize all arrays once
+            const serialized = {
+                decisions: JSON.stringify(input.decisions ?? []),
+                files: JSON.stringify(input.filesModified ?? []),
+                blockers: JSON.stringify(input.blockers ?? []),
+                tags: JSON.stringify(input.tags ?? []),
+                tasksCompleted: JSON.stringify(input.tasksCompleted),
+                tasksRemaining: JSON.stringify(input.tasksRemaining),
+            };
+            insertSnapshot(db, {
+                id: snapshotId,
+                project_id: projectId,
+                sequence_number: seqNum,
+                agent: input.agent,
+                summary: input.summary,
+                tasks_completed: serialized.tasksCompleted,
+                tasks_remaining: serialized.tasksRemaining,
+                decisions: serialized.decisions,
+                files_modified: serialized.files,
+                blockers: serialized.blockers,
+                next_steps: input.nextSteps,
+                tags: serialized.tags,
+                created_at: now,
+            });
+            // Also insert decisions as first-class entities
+            if (input.decisions) {
+                for (const d of input.decisions) {
+                    insertDecision(db, {
+                        id: generateId(),
+                        project_id: projectId,
+                        snapshot_id: snapshotId,
+                        agent: input.agent,
+                        decision: d.decision,
+                        reasoning: d.reasoning,
+                        alternatives: JSON.stringify(d.alternatives ?? []),
+                        category: null,
+                        related_files: '[]',
+                        created_at: now,
+                    });
+                }
+            }
+            updateProjectSyncStats(db, projectId);
+            return { snapshotId, seqNum };
+        });
+        const { snapshotId, seqNum } = txn();
+        // Build response
+        const lines = [
+            `Snapshot #${seqNum} saved for project "${displayName}".`,
+            '',
+            `- ID: \`${snapshotId}\``,
+            `- Agent: ${input.agent}`,
+            `- Time: ${now}`,
+            `- Path: \`${normalized}\``,
+        ];
+        // Append path warnings if any
+        if (suggestedRoot) {
+            lines.push('', `**Warning:** Path looks like a subdirectory. Consider using the project root:`, `\`${suggestedRoot}\``, 'Subdirectory paths cause mismatches when other agents resume.');
+        }
+        const warnings = formatWarnings(validation);
+        if (warnings)
+            lines.push('', warnings);
+        lines.push('', `Another agent can call \`resume\` with \`projectDir: "${normalized}"\` to continue.`);
+        const message = lines.join('\n');
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: message,
+                },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=sync.js.map

package/dist/tools/sync.js.map

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