@planu/cli 0.43.0 → 0.44.0

package/dist/tools/register-hooks-tools.js

@@ -1,8 +1,89 @@
-// tools/register-hooks-tools.ts — Registers manage_hooks on the MCP server (SPEC-071)
+// tools/register-hooks-tools.ts — Registers manage_hooks + SPEC-130 hook engine tools (SPEC-071, SPEC-130)
 import { z } from 'zod';
 import { safeLicensed } from './safe-handler.js';
 import { handleManageHooks } from './manage-hooks.js';
+import { handleStartHooks, handleStopHooks, handleHookStatus, handleConfigureHooks, } from './start-hooks.js';
 export function registerHooksTools(server) {
+    // ----- SPEC-130: Hook Engine Tools -----
+    server.registerTool('start_hooks', {
+        description: 'Start the file watcher and hook engine for a project. ' +
+            'Idempotent — if already running, returns current status. ' +
+            'Watches for file changes and dispatches to registered hook handlers.',
+        inputSchema: {
+            projectPath: z
+                .string()
+                .max(1000)
+                .describe('Absolute path to the project root directory to watch'),
+            hooks: z
+                .array(z.string().max(100))
+                .optional()
+                .describe('Hook types to enable. Valid values: on-save | on-create | on-delete | on-test-pass | on-commit. ' +
+                'Defaults to [on-save, on-create, on-delete]'),
+        },
+        annotations: {
+            title: 'Start Hook Engine',
+            readOnlyHint: false,
+        },
+    }, safeLicensed('start_hooks', async (args) => handleStartHooks(args)));
+    server.registerTool('stop_hooks', {
+        description: 'Stop the file watcher and hook engine. Cleans up all resources including ' +
+            'watchers, timers, and event listeners.',
+        inputSchema: {
+            reason: z
+                .string()
+                .max(500)
+                .optional()
+                .describe('Optional reason for stopping the hook engine'),
+        },
+        annotations: {
+            title: 'Stop Hook Engine',
+            readOnlyHint: false,
+        },
+    }, safeLicensed('stop_hooks', async (args) => handleStopHooks(args)));
+    server.registerTool('hook_status', {
+        description: 'Get the current status of the hook engine including running state, ' +
+            'active hooks, pending events, telemetry (execution count, avg latency, error rate), ' +
+            'and event history count.',
+        inputSchema: {},
+        annotations: {
+            title: 'Hook Engine Status',
+            readOnlyHint: true,
+        },
+    }, safeLicensed('hook_status', async () => handleHookStatus()));
+    server.registerTool('configure_hooks', {
+        description: 'View or update hook engine configuration at runtime. ' +
+            'If the engine is running, reloads config from .planu/hooks.json. ' +
+            'If not running, shows current config from disk.',
+        inputSchema: {
+            projectPath: z.string().max(1000).describe('Absolute path to the project root directory'),
+            enabled: z.boolean().optional().describe('Master switch for all hooks (true = enabled)'),
+            debounceMs: z
+                .number()
+                .min(50)
+                .max(10000)
+                .optional()
+                .describe('Debounce window in milliseconds (50-10000, default: 300)'),
+            rateLimitPerFileMs: z
+                .number()
+                .min(1000)
+                .max(60000)
+                .optional()
+                .describe('Rate limit per file in milliseconds (1000-60000, default: 5000)'),
+            hooks: z
+                .record(z.string().max(100), z.object({
+                enabled: z.boolean().optional().describe('Whether this hook type is enabled'),
+                include: z.array(z.string().max(500)).optional().describe('Glob patterns to include'),
+                exclude: z.array(z.string().max(500)).optional().describe('Glob patterns to exclude'),
+            }))
+                .optional()
+                .describe('Per-hook-type configuration overrides'),
+        },
+        annotations: {
+            title: 'Configure Hooks',
+            readOnlyHint: false,
+        },
+    }, safeLicensed('configure_hooks', async (args) => handleConfigureHooks(args)));
+    // ----- SPEC-071: manage_hooks -----
     server.registerTool('manage_hooks', {
         description: 'Create, list, delete, enable/disable, and install templates for agent hooks. ' +
             'Hooks automate actions when Planu events fire (spec created, status change, drift detected, commit). ' +

package/dist/tools/register-hooks-tools.js.map

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

package/dist/tools/register-living-spec-advanced-tools.d.ts

@@ -0,0 +1,6 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+/**
+ * Registers SPEC-121 living spec advanced tools on the MCP server.
+ */
+export declare function registerLivingSpecAdvancedTools(server: McpServer): void;
+//# sourceMappingURL=register-living-spec-advanced-tools.d.ts.map

package/dist/tools/register-living-spec-advanced-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-living-spec-advanced-tools.d.ts","sourceRoot":"","sources":["../../src/tools/register-living-spec-advanced-tools.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAUzE;;GAEG;AACH,wBAAgB,+BAA+B,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA4IvE"}

package/dist/tools/register-living-spec-advanced-tools.js

@@ -0,0 +1,113 @@
+// tools/register-living-spec-advanced-tools.ts — SPEC-121 Living Spec Advanced tools
+// Registers: living_spec_watch, living_spec_status, spec_diff, living_spec_coverage,
+//            sync_spec_to_code, sync_code_to_spec, resolve_sync_conflict
+import { z } from 'zod';
+import { safeLicensed } from './safe-handler.js';
+import { handleLivingSpecWatch, handleLivingSpecStatus } from './living-spec-watch.js';
+import { handleSpecDiff } from './spec-diff.js';
+import { handleLivingSpecCoverage } from './living-spec-coverage.js';
+import { handleSyncSpecToCode } from './sync-spec-to-code.js';
+import { handleSyncCodeToSpec } from './sync-code-to-spec.js';
+import { handleResolveSyncConflict } from './resolve-sync-conflict.js';
+/**
+ * Registers SPEC-121 living spec advanced tools on the MCP server.
+ */
+export function registerLivingSpecAdvancedTools(server) {
+    // living_spec_watch
+    server.registerTool('living_spec_watch', {
+        description: 'Start, stop, or check status of the in-memory drift watcher for a project. The watcher caches drift detection results with a configurable TTL to avoid redundant computations.',
+        inputSchema: {
+            projectId: z.string().max(500).describe('Project ID'),
+            action: z
+                .enum(['start', 'stop', 'status'])
+                .describe('Action to perform. Valid values: "start", "stop", "status"'),
+            ttlSeconds: z
+                .number()
+                .int()
+                .min(5)
+                .max(3600)
+                .optional()
+                .describe('Cache TTL in seconds (5-3600). Default: 60. Only used with "start" action'),
+            excludePatterns: z
+                .array(z.string().max(500))
+                .max(50)
+                .optional()
+                .describe('Glob patterns to exclude from drift watching (e.g., ["node_modules/**", "dist/**"])'),
+        },
+    }, safeLicensed('living_spec_watch', async (args) => handleLivingSpecWatch(args)));
+    // living_spec_status
+    server.registerTool('living_spec_status', {
+        description: 'Get detailed status of the living spec watcher including cache state and configuration. Read-only diagnostic tool.',
+        annotations: { readOnlyHint: true },
+        inputSchema: {
+            projectId: z.string().max(500).describe('Project ID'),
+            specId: z
+                .string()
+                .max(500)
+                .optional()
+                .describe('Optional spec ID to get cached drift data for'),
+        },
+    }, safeLicensed('living_spec_status', async (args) => handleLivingSpecStatus(args)));
+    // spec_diff
+    server.registerTool('spec_diff', {
+        description: 'Compare spec hash snapshots to detect file and signature changes. Shows a Markdown-formatted diff table. Use after snapshot_spec_hashes to see what changed.',
+        annotations: { readOnlyHint: true },
+        inputSchema: {
+            projectId: z.string().max(500).describe('Project ID'),
+            specId: z
+                .string()
+                .max(500)
+                .optional()
+                .describe('Specific spec ID to diff (if omitted, diffs all specs)'),
+        },
+    }, safeLicensed('spec_diff', async (args) => handleSpecDiff(args)));
+    // living_spec_coverage
+    server.registerTool('living_spec_coverage', {
+        description: 'Correlate test coverage with spec acceptance criteria. Parses Vitest JSON or JUnit XML reports and groups results by @spec annotations to determine criterion status (verified/regression/untested).',
+        annotations: { readOnlyHint: true },
+        inputSchema: {
+            projectId: z.string().max(500).describe('Project ID'),
+            coverageJsonPath: z
+                .string()
+                .max(4096)
+                .optional()
+                .describe('Path to Vitest JSON report file'),
+            junitXmlPath: z.string().max(4096).optional().describe('Path to JUnit XML report file'),
+        },
+    }, safeLicensed('living_spec_coverage', async (args) => handleLivingSpecCoverage(args)));
+    // sync_spec_to_code
+    server.registerTool('sync_spec_to_code', {
+        description: 'Sync from spec to code: generate TODO comments for pending acceptance criteria that lack @spec annotations. Also detects conflicts between spec and code state.',
+        inputSchema: {
+            projectId: z.string().max(500).describe('Project ID'),
+            specId: z.string().max(500).describe('Spec ID to sync from'),
+            projectPath: z.string().max(4096).describe('Path to the project root directory'),
+        },
+    }, safeLicensed('sync_spec_to_code', async (args) => handleSyncSpecToCode(args)));
+    // sync_code_to_spec
+    server.registerTool('sync_code_to_spec', {
+        description: 'Sync from code to spec: detect @spec annotations in source code and generate progress updates for the corresponding spec criteria. Also detects conflicts.',
+        inputSchema: {
+            projectId: z.string().max(500).describe('Project ID'),
+            specId: z.string().max(500).describe('Spec ID to sync to'),
+            projectPath: z.string().max(4096).describe('Path to the project root directory'),
+        },
+    }, safeLicensed('sync_code_to_spec', async (args) => handleSyncCodeToSpec(args)));
+    // resolve_sync_conflict
+    server.registerTool('resolve_sync_conflict', {
+        description: 'Resolve a sync conflict detected by sync_spec_to_code or sync_code_to_spec. Choose to accept the code state, accept the spec state, or provide a manual resolution.',
+        inputSchema: {
+            projectId: z.string().max(500).describe('Project ID'),
+            conflictId: z.string().max(100).describe('Conflict ID from the sync result'),
+            resolution: z
+                .enum(['accept-code', 'accept-spec', 'manual'])
+                .describe('Resolution strategy. Valid values: "accept-code", "accept-spec", "manual"'),
+            manualResolution: z
+                .string()
+                .max(2000)
+                .optional()
+                .describe('Description of manual resolution (required when resolution is "manual")'),
+        },
+    }, safeLicensed('resolve_sync_conflict', async (args) => handleResolveSyncConflict(args)));
+}
+//# sourceMappingURL=register-living-spec-advanced-tools.js.map

package/dist/tools/register-living-spec-advanced-tools.js.map

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

package/dist/tools/register-living-spec-tools.d.ts

@@ -0,0 +1,6 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+/**
+ * Registers living spec tools on the MCP server.
+ */
+export declare function registerLivingSpecTools(server: McpServer): void;
+//# sourceMappingURL=register-living-spec-tools.d.ts.map

package/dist/tools/register-living-spec-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-living-spec-tools.d.ts","sourceRoot":"","sources":["../../src/tools/register-living-spec-tools.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAQzE;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA+E/D"}

package/dist/tools/register-living-spec-tools.js

@@ -0,0 +1,67 @@
+import { z } from 'zod';
+import { safeLicensed } from './safe-handler.js';
+import { handleValidateAnnotations } from './validate-annotations.js';
+import { handleGenerateAnnotations } from './generate-annotations.js';
+import { handleSnapshotSpecHashes } from './snapshot-spec-hashes.js';
+import { handleAutoReconcile } from './auto-reconcile.js';
+/**
+ * Registers living spec tools on the MCP server.
+ */
+export function registerLivingSpecTools(server) {
+    // validate_annotations
+    server.registerTool('validate_annotations', {
+        description: 'Validate @spec annotations in source code. Checks that all annotated spec IDs exist and criteria numbers are valid. Use after adding annotations to verify correctness.',
+        annotations: { readOnlyHint: true },
+        inputSchema: {
+            projectId: z.string().max(500).describe('Project ID'),
+            projectPath: z
+                .string()
+                .max(4096)
+                .describe('Path to the project root directory'),
+            specId: z
+                .string()
+                .max(500)
+                .optional()
+                .describe('Optional spec ID to filter annotations for a specific spec'),
+        },
+    }, safeLicensed('validate_annotations', async (args) => handleValidateAnnotations(args)));
+    // generate_annotations
+    server.registerTool('generate_annotations', {
+        description: 'Suggest @spec annotations for unannotated source files. Uses living-spec-analyzer heuristics to match files to spec criteria and generates annotation comments to add.',
+        annotations: { readOnlyHint: true },
+        inputSchema: {
+            projectId: z.string().max(500).describe('Project ID'),
+            projectPath: z
+                .string()
+                .max(4096)
+                .describe('Path to the project root directory'),
+            specId: z.string().max(500).describe('Spec ID to generate annotations for'),
+        },
+    }, safeLicensed('generate_annotations', async (args) => handleGenerateAnnotations(args)));
+    // snapshot_spec_hashes
+    server.registerTool('snapshot_spec_hashes', {
+        description: 'Create or update a SHA-256 hash snapshot for a spec. Tracks file hashes and exported function signatures of all files referenced in the spec technical.md File Plan section. Used for drift detection.',
+        inputSchema: {
+            projectId: z.string().max(500).describe('Project ID'),
+            specId: z.string().max(500).describe('Spec ID to snapshot'),
+        },
+    }, safeLicensed('snapshot_spec_hashes', async (args) => handleSnapshotSpecHashes(args)));
+    // auto_reconcile
+    server.registerTool('auto_reconcile', {
+        description: 'Auto-reconcile specs after code changes. Applies safe changes automatically (completion %, status flip, hash update, timestamp). Unsafe changes (status downgrade, criterion removal) are skipped and require manual approval. Rate-limited: max 1 per spec per 5 minutes.',
+        inputSchema: {
+            projectId: z.string().max(500).describe('Project ID'),
+            specId: z
+                .string()
+                .max(500)
+                .optional()
+                .describe('Specific spec ID to reconcile (if omitted, finds affected specs from changedFiles)'),
+            changedFiles: z
+                .array(z.string().max(4096))
+                .max(1000)
+                .optional()
+                .describe('List of changed file paths to find affected specs'),
+        },
+    }, safeLicensed('auto_reconcile', async (args) => handleAutoReconcile(args)));
+}
+//# sourceMappingURL=register-living-spec-tools.js.map

package/dist/tools/register-living-spec-tools.js.map

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

package/dist/tools/resolve-sync-conflict.d.ts

@@ -0,0 +1,3 @@
+import type { ResolveSyncConflictInput, ToolResult } from '../types/index.js';
+export declare function handleResolveSyncConflict(args: ResolveSyncConflictInput): Promise<ToolResult>;
+//# sourceMappingURL=resolve-sync-conflict.d.ts.map

package/dist/tools/resolve-sync-conflict.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-sync-conflict.d.ts","sourceRoot":"","sources":["../../src/tools/resolve-sync-conflict.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,wBAAwB,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAE9E,wBAAsB,yBAAyB,CAC7C,IAAI,EAAE,wBAAwB,GAC7B,OAAO,CAAC,UAAU,CAAC,CAoDrB"}

package/dist/tools/resolve-sync-conflict.js

@@ -0,0 +1,38 @@
+// tools/resolve-sync-conflict.ts — resolve_sync_conflict handler
+import { syncLogStore } from '../storage/index.js';
+import { createSyncLogEntry } from '../engine/living-spec/index.js';
+export async function handleResolveSyncConflict(args) {
+    const { projectId, conflictId, resolution, manualResolution } = args;
+    const resolutionText = resolution === 'manual'
+        ? (manualResolution ?? 'Manual resolution (no details provided)')
+        : `Auto-resolved: ${resolution}`;
+    const conflict = await syncLogStore.resolveConflict(projectId, conflictId, resolutionText);
+    if (!conflict) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({
+                        message: `Conflict ${conflictId} not found. Use sync_spec_to_code or sync_code_to_spec to detect conflicts first.`,
+                    }, null, 2),
+                },
+            ],
+            isError: true,
+        };
+    }
+    // Log the resolution
+    const logEntry = createSyncLogEntry(conflict.direction, conflict.specId, 'resolve-conflict', `Resolved conflict ${conflictId}: ${resolutionText}`);
+    await syncLogStore.appendSyncLog(projectId, [logEntry]);
+    return {
+        content: [
+            {
+                type: 'text',
+                text: JSON.stringify({
+                    conflict,
+                    message: `Conflict ${conflictId} resolved: ${resolutionText}`,
+                }, null, 2),
+            },
+        ],
+    };
+}
+//# sourceMappingURL=resolve-sync-conflict.js.map

package/dist/tools/resolve-sync-conflict.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-sync-conflict.js","sourceRoot":"","sources":["../../src/tools/resolve-sync-conflict.ts"],"names":[],"mappings":"AAAA,iEAAiE;AAEjE,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AAGpE,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAC7C,IAA8B;IAE9B,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,UAAU,EAAE,gBAAgB,EAAE,GAAG,IAAI,CAAC;IAErE,MAAM,cAAc,GAClB,UAAU,KAAK,QAAQ;QACrB,CAAC,CAAC,CAAC,gBAAgB,IAAI,yCAAyC,CAAC;QACjE,CAAC,CAAC,kBAAkB,UAAU,EAAE,CAAC;IAErC,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,eAAe,CAAC,SAAS,EAAE,UAAU,EAAE,cAAc,CAAC,CAAC;IAE3F,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAClB;wBACE,OAAO,EAAE,YAAY,UAAU,mFAAmF;qBACnH,EACD,IAAI,EACJ,CAAC,CACF;iBACF;aACF;YACD,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;IAED,qBAAqB;IACrB,MAAM,QAAQ,GAAG,kBAAkB,CACjC,QAAQ,CAAC,SAAS,EAClB,QAAQ,CAAC,MAAM,EACf,kBAAkB,EAClB,qBAAqB,UAAU,KAAK,cAAc,EAAE,CACrD,CAAC;IACF,MAAM,YAAY,CAAC,aAAa,CAAC,SAAS,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC;IAExD,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAe;gBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAClB;oBACE,QAAQ;oBACR,OAAO,EAAE,YAAY,UAAU,cAAc,cAAc,EAAE;iBAC9D,EACD,IAAI,EACJ,CAAC,CACF;aACF;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/tools/snapshot-spec-hashes.d.ts

@@ -0,0 +1,3 @@
+import type { SnapshotSpecHashesInput, ToolResult } from '../types/index.js';
+export declare function handleSnapshotSpecHashes(args: SnapshotSpecHashesInput): Promise<ToolResult>;
+//# sourceMappingURL=snapshot-spec-hashes.d.ts.map

package/dist/tools/snapshot-spec-hashes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot-spec-hashes.d.ts","sourceRoot":"","sources":["../../src/tools/snapshot-spec-hashes.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,uBAAuB,EAAoB,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAG/F,wBAAsB,wBAAwB,CAC5C,IAAI,EAAE,uBAAuB,GAC5B,OAAO,CAAC,UAAU,CAAC,CA6GrB"}

package/dist/tools/snapshot-spec-hashes.js

@@ -0,0 +1,100 @@
+// tools/snapshot-spec-hashes.ts — Create/update hash snapshots for a spec
+// Tracks file hashes and function signatures of files referenced in technical.md
+import { readFile } from 'node:fs/promises';
+import { specStore, knowledgeStore, hashSnapshotStore } from '../storage/index.js';
+import { createFileHashEntries, extractFilePlanPaths, extractSignaturesFromFiles, diffFileHashes, diffSignatures, } from '../engine/living-spec/index.js';
+import { stripFrontmatter } from '../engine/frontmatter-parser.js';
+export async function handleSnapshotSpecHashes(args) {
+    const { projectId, specId } = args;
+    // 1. Load spec
+    const spec = await specStore.getSpec(projectId, specId);
+    if (!spec) {
+        return {
+            content: [{ type: 'text', text: `Spec ${specId} not found` }],
+            isError: true,
+        };
+    }
+    // 2. Load project path
+    const knowledge = await knowledgeStore.getKnowledge(projectId);
+    if (!knowledge?.projectPath) {
+        return {
+            content: [{ type: 'text', text: 'Project not found. Run init_project first.' }],
+            isError: true,
+        };
+    }
+    const projectPath = knowledge.projectPath;
+    // 3. Extract file paths from technical.md File Plan section
+    let filePaths;
+    try {
+        const rawContent = await readFile(spec.technicalPath, 'utf-8');
+        const content = stripFrontmatter(rawContent);
+        filePaths = extractFilePlanPaths(content);
+    }
+    catch {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Could not read technical.md for ${specId}. Ensure it exists at ${spec.technicalPath}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+    if (filePaths.length === 0) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `No file paths found in technical.md File Plan section for ${specId}. Add files in a markdown table or list.`,
+                },
+            ],
+        };
+    }
+    // 4. Create hash entries and extract signatures
+    const files = await createFileHashEntries(projectPath, filePaths);
+    const signatures = await extractSignaturesFromFiles(projectPath, filePaths);
+    // 5. Load previous snapshot for comparison
+    const previousSnapshot = await hashSnapshotStore.getSnapshot(projectId, specId);
+    // 6. Save new snapshot
+    const newSnapshot = {
+        specId,
+        createdAt: new Date().toISOString(),
+        files,
+        signatures,
+    };
+    await hashSnapshotStore.saveSnapshot(projectId, specId, newSnapshot);
+    // 7. Generate diff report if previous snapshot exists
+    let diffReport = null;
+    if (previousSnapshot) {
+        const fileDiffs = await diffFileHashes(projectPath, previousSnapshot, filePaths);
+        const sigChanges = diffSignatures(previousSnapshot.signatures, signatures);
+        diffReport = {
+            changedFiles: fileDiffs.length,
+            signatureChanges: sigChanges.length,
+            details: {
+                files: fileDiffs,
+                signatures: sigChanges,
+            },
+        };
+    }
+    return {
+        content: [
+            {
+                type: 'text',
+                text: JSON.stringify({
+                    specId,
+                    filesTracked: files.length,
+                    signaturesTracked: signatures.length,
+                    totalPathsInPlan: filePaths.length,
+                    missingFiles: filePaths.length - files.length,
+                    ...(diffReport ? { diff: diffReport } : {}),
+                    message: previousSnapshot
+                        ? `Hash snapshot updated for ${specId}. ${String(diffReport?.changedFiles ?? 0)} file(s) changed.`
+                        : `Initial hash snapshot created for ${specId}.`,
+                }, null, 2),
+            },
+        ],
+    };
+}
+//# sourceMappingURL=snapshot-spec-hashes.js.map

package/dist/tools/snapshot-spec-hashes.js.map

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

package/dist/tools/spec-diff.d.ts

@@ -0,0 +1,3 @@
+import type { SpecDiffInput, ToolResult } from '../types/index.js';
+export declare function handleSpecDiff(args: SpecDiffInput): Promise<ToolResult>;
+//# sourceMappingURL=spec-diff.d.ts.map

package/dist/tools/spec-diff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-diff.d.ts","sourceRoot":"","sources":["../../src/tools/spec-diff.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEnE,wBAAsB,cAAc,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,UAAU,CAAC,CAiE7E"}

package/dist/tools/spec-diff.js

@@ -0,0 +1,58 @@
+// tools/spec-diff.ts — spec_diff handler
+import { hashSnapshotStore, specStore } from '../storage/index.js';
+import { buildSpecDiffRows, formatMarkdownDiff } from '../engine/living-spec/index.js';
+export async function handleSpecDiff(args) {
+    const { projectId, specId } = args;
+    // If specId provided, diff that spec; otherwise diff all specs
+    const specIds = [];
+    if (specId) {
+        specIds.push(specId);
+    }
+    else {
+        const allSpecs = await specStore.listSpecs(projectId);
+        specIds.push(...allSpecs.map((s) => s.id));
+    }
+    if (specIds.length === 0) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({ message: 'No specs found for this project' }, null, 2),
+                },
+            ],
+        };
+    }
+    const allRows = [];
+    for (const sid of specIds) {
+        const snapshot = await hashSnapshotStore.getSnapshot(projectId, sid);
+        if (!snapshot) {
+            continue;
+        }
+        // Build hash maps from snapshot
+        const oldHashes = new Map();
+        for (const f of snapshot.files) {
+            oldHashes.set(f.file, f.hash);
+        }
+        // For diff, we compare stored snapshot with current (re-use stored as "old")
+        const newHashes = new Map(oldHashes);
+        const rows = buildSpecDiffRows(oldHashes, newHashes, sid);
+        allRows.push(...rows);
+    }
+    const markdown = formatMarkdownDiff(allRows);
+    return {
+        content: [
+            {
+                type: 'text',
+                text: JSON.stringify({
+                    specCount: specIds.length,
+                    diffRows: allRows.length,
+                    markdown,
+                    message: allRows.length > 0
+                        ? `Found ${allRows.length} change(s) across ${specIds.length} spec(s)`
+                        : `No changes detected across ${specIds.length} spec(s)`,
+                }, null, 2),
+            },
+        ],
+    };
+}
+//# sourceMappingURL=spec-diff.js.map

package/dist/tools/spec-diff.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-diff.js","sourceRoot":"","sources":["../../src/tools/spec-diff.ts"],"names":[],"mappings":"AAAA,yCAAyC;AAEzC,OAAO,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AACnE,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AAGvF,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,IAAmB;IACtD,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IAEnC,+DAA+D;IAC/D,MAAM,OAAO,GAAa,EAAE,CAAC;IAE7B,IAAI,MAAM,EAAE,CAAC;QACX,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACvB,CAAC;SAAM,CAAC;QACN,MAAM,QAAQ,GAAG,MAAM,SAAS,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;QACtD,OAAO,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC7C,CAAC;IAED,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,iCAAiC,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;iBAC9E;aACF;SACF,CAAC;IACJ,CAAC;IAED,MAAM,OAAO,GAAG,EAAE,CAAC;IACnB,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;QAC1B,MAAM,QAAQ,GAAG,MAAM,iBAAiB,CAAC,WAAW,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;QACrE,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,SAAS;QACX,CAAC;QAED,gCAAgC;QAChC,MAAM,SAAS,GAAG,IAAI,GAAG,EAAkB,CAAC;QAC5C,KAAK,MAAM,CAAC,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC;YAC/B,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;QAChC,CAAC;QAED,6EAA6E;QAC7E,MAAM,SAAS,GAAG,IAAI,GAAG,CAAiB,SAAS,CAAC,CAAC;QACrD,MAAM,IAAI,GAAG,iBAAiB,CAAC,SAAS,EAAE,SAAS,EAAE,GAAG,CAAC,CAAC;QAC1D,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;IACxB,CAAC;IAED,MAAM,QAAQ,GAAG,kBAAkB,CAAC,OAAO,CAAC,CAAC;IAE7C,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAe;gBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAClB;oBACE,SAAS,EAAE,OAAO,CAAC,MAAM;oBACzB,QAAQ,EAAE,OAAO,CAAC,MAAM;oBACxB,QAAQ;oBACR,OAAO,EACL,OAAO,CAAC,MAAM,GAAG,CAAC;wBAChB,CAAC,CAAC,SAAS,OAAO,CAAC,MAAM,qBAAqB,OAAO,CAAC,MAAM,UAAU;wBACtE,CAAC,CAAC,8BAA8B,OAAO,CAAC,MAAM,UAAU;iBAC7D,EACD,IAAI,EACJ,CAAC,CACF;aACF;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/tools/start-hooks.d.ts

@@ -0,0 +1,17 @@
+import type { ToolResult } from '../types/index.js';
+import type { StartHooksInput, StopHooksInput, ConfigureHooksInput } from '../types/file-hooks.js';
+import { HookEngine } from '../engine/hooks/hook-engine.js';
+import { FileWatcher } from '../engine/hooks/file-watcher.js';
+/**
+ * Get the current engine instance (for testing/internal use).
+ */
+export declare function getEngineInstance(): HookEngine | null;
+/**
+ * Get the current watcher instance (for testing/internal use).
+ */
+export declare function getWatcherInstance(): FileWatcher | null;
+export declare function handleStartHooks(args: StartHooksInput): Promise<ToolResult>;
+export declare function handleStopHooks(_args: StopHooksInput): Promise<ToolResult>;
+export declare function handleHookStatus(): Promise<ToolResult>;
+export declare function handleConfigureHooks(args: ConfigureHooksInput): Promise<ToolResult>;
+//# sourceMappingURL=start-hooks.d.ts.map

package/dist/tools/start-hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"start-hooks.d.ts","sourceRoot":"","sources":["../../src/tools/start-hooks.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EAGV,eAAe,EACf,cAAc,EACd,mBAAmB,EACpB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAC;AAE5D,OAAO,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AAa9D;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,UAAU,GAAG,IAAI,CAErD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,WAAW,GAAG,IAAI,CAEvD;AAMD,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,UAAU,CAAC,CA0FjF;AAuBD,wBAAsB,eAAe,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,UAAU,CAAC,CAuBhF;AAMD,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,UAAU,CAAC,CAqC5D;AAMD,wBAAsB,oBAAoB,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,UAAU,CAAC,CA0CzF"}