@planu/cli 0.43.1 → 0.44.0

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"}

package/dist/tools/start-hooks.js

@@ -0,0 +1,209 @@
+// tools/start-hooks.ts — Start file watcher + hook engine (SPEC-130)
+import { HookEngine } from '../engine/hooks/hook-engine.js';
+import { EventBus } from '../engine/hooks/event-bus.js';
+import { FileWatcher } from '../engine/hooks/file-watcher.js';
+import { ConfigLoader } from '../engine/hooks/config-loader.js';
+import { Debouncer } from '../engine/hooks/debouncer.js';
+// ---------------------------------------------------------------------------
+// Singleton state
+// ---------------------------------------------------------------------------
+let engineInstance = null;
+let watcherInstance = null;
+let debouncerInstance = null;
+let configLoaderInstance = null;
+/**
+ * Get the current engine instance (for testing/internal use).
+ */
+export function getEngineInstance() {
+    return engineInstance;
+}
+/**
+ * Get the current watcher instance (for testing/internal use).
+ */
+export function getWatcherInstance() {
+    return watcherInstance;
+}
+// ---------------------------------------------------------------------------
+// Start hooks
+// ---------------------------------------------------------------------------
+export async function handleStartHooks(args) {
+    // Idempotent — if already running, return status
+    if (engineInstance?.status().running) {
+        const status = engineInstance.status();
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({
+                        message: 'Hook engine already running',
+                        ...status,
+                    }, null, 2),
+                },
+            ],
+        };
+    }
+    const projectPath = args.projectPath;
+    const enabledHooks = args.hooks ?? ['on-save', 'on-create', 'on-delete'];
+    // Load config
+    configLoaderInstance = new ConfigLoader(projectPath);
+    const config = await configLoaderInstance.load();
+    // Create event bus and engine
+    const eventBus = new EventBus();
+    engineInstance = new HookEngine(eventBus);
+    // Create file watcher
+    watcherInstance = new FileWatcher({
+        rootDir: projectPath,
+        include: config.hooks['on-save']?.include,
+        exclude: config.hooks['on-save']?.exclude,
+    });
+    // Create debouncer
+    debouncerInstance = new Debouncer((event) => {
+        const hookType = mapEventToHookType(event);
+        if (hookType && enabledHooks.includes(hookType)) {
+            void engineInstance?.dispatch(event, hookType);
+        }
+    }, {
+        debounceMs: config.debounceMs,
+        rateLimitPerFileMs: config.rateLimitPerFileMs,
+    });
+    // Wire watcher -> debouncer
+    watcherInstance.on('change', (event) => {
+        eventBus.emitEvent('file:change', {
+            path: event.path,
+            type: event.type,
+            timestamp: event.timestamp,
+        });
+        debouncerInstance?.push(event);
+    });
+    // Start watching config for live reload
+    configLoaderInstance.startWatching();
+    // Start engine and watcher
+    engineInstance.start();
+    watcherInstance.start();
+    return {
+        content: [
+            {
+                type: 'text',
+                text: JSON.stringify({
+                    message: 'Hook engine started',
+                    projectPath,
+                    enabledHooks,
+                    config: {
+                        debounceMs: config.debounceMs,
+                        rateLimitPerFileMs: config.rateLimitPerFileMs,
+                    },
+                }, null, 2),
+            },
+        ],
+    };
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function mapEventToHookType(event) {
+    switch (event.type) {
+        case 'modify':
+            return 'on-save';
+        case 'create':
+            return 'on-create';
+        case 'delete':
+            return 'on-delete';
+        default:
+            return null;
+    }
+}
+// ---------------------------------------------------------------------------
+// Stop hooks
+// ---------------------------------------------------------------------------
+export async function handleStopHooks(_args) {
+    await Promise.resolve(); // Ensure async for safeLicensed wrapper
+    if (!engineInstance) {
+        return {
+            content: [{ type: 'text', text: JSON.stringify({ message: 'Hook engine not running' }) }],
+        };
+    }
+    engineInstance.stop();
+    watcherInstance?.close();
+    debouncerInstance?.dispose();
+    configLoaderInstance?.close();
+    const message = 'Hook engine stopped and resources cleaned up';
+    engineInstance = null;
+    watcherInstance = null;
+    debouncerInstance = null;
+    configLoaderInstance = null;
+    return {
+        content: [{ type: 'text', text: JSON.stringify({ message }) }],
+    };
+}
+// ---------------------------------------------------------------------------
+// Hook status
+// ---------------------------------------------------------------------------
+export async function handleHookStatus() {
+    await Promise.resolve(); // Ensure async for safeLicensed wrapper
+    if (!engineInstance) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({
+                        running: false,
+                        activeHooks: [],
+                        pendingEvents: 0,
+                        telemetry: {},
+                        eventHistory: 0,
+                    }),
+                },
+            ],
+        };
+    }
+    const status = engineInstance.status();
+    const eventBus = engineInstance.getEventBus();
+    return {
+        content: [
+            {
+                type: 'text',
+                text: JSON.stringify({
+                    ...status,
+                    eventHistory: eventBus.getFullHistory().length,
+                }, null, 2),
+            },
+        ],
+    };
+}
+// ---------------------------------------------------------------------------
+// Configure hooks
+// ---------------------------------------------------------------------------
+export async function handleConfigureHooks(args) {
+    if (!configLoaderInstance) {
+        // Not running — just load and report current config
+        const loader = new ConfigLoader(args.projectPath);
+        const config = await loader.load();
+        loader.close();
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({
+                        message: 'Hook engine not running. Current config:',
+                        config,
+                    }, null, 2),
+                },
+            ],
+        };
+    }
+    // Reload config
+    const config = await configLoaderInstance.load();
+    return {
+        content: [
+            {
+                type: 'text',
+                text: JSON.stringify({
+                    message: 'Configuration reloaded',
+                    config,
+                    engineRunning: engineInstance?.status().running ?? false,
+                }, null, 2),
+            },
+        ],
+    };
+}
+//# sourceMappingURL=start-hooks.js.map

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

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

package/dist/tools/sync-code-to-spec.d.ts

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

package/dist/tools/sync-code-to-spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-code-to-spec.d.ts","sourceRoot":"","sources":["../../src/tools/sync-code-to-spec.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,mBAAmB,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEzE,wBAAsB,oBAAoB,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,UAAU,CAAC,CAyDzF"}

package/dist/tools/sync-code-to-spec.js

@@ -0,0 +1,51 @@
+// tools/sync-code-to-spec.ts — sync_code_to_spec handler
+import { specStore, syncLogStore } from '../storage/index.js';
+import { generateProgressUpdates, detectConflicts, buildCodeToSpecResult, parseAnnotationsFromProject, } from '../engine/living-spec/index.js';
+import { extractCriteria } from '../engine/validator/extractors.js';
+export async function handleSyncCodeToSpec(args) {
+    const { projectId, specId, projectPath } = args;
+    // 1. Load spec
+    const spec = await specStore.getSpec(projectId, specId);
+    if (!spec) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({ message: `Spec ${specId} not found` }, null, 2),
+                },
+            ],
+            isError: true,
+        };
+    }
+    // 2. Parse annotations from code
+    const parseResult = await parseAnnotationsFromProject(projectPath, specId);
+    // 3. Build criteria status map (default: pending)
+    const criteriaList = await extractCriteria(spec);
+    const statusMap = new Map();
+    for (let i = 0; i < criteriaList.length; i++) {
+        statusMap.set(`${specId}:AC-${i + 1}`, 'pending');
+    }
+    // 4. Generate progress updates
+    const updates = generateProgressUpdates(parseResult.annotations, statusMap);
+    // 5. Detect conflicts
+    const conflicts = detectConflicts(parseResult.annotations, statusMap, 'code-to-spec');
+    // 6. Build result
+    const result = buildCodeToSpecResult(specId, updates, conflicts);
+    // 7. Persist
+    await syncLogStore.appendSyncLog(projectId, result.logEntries);
+    if (conflicts.length > 0) {
+        await syncLogStore.addConflicts(projectId, conflicts);
+    }
+    return {
+        content: [
+            {
+                type: 'text',
+                text: JSON.stringify({
+                    ...result,
+                    message: `Code-to-spec sync: ${updates.length} progress update(s), ${conflicts.length} conflict(s)`,
+                }, null, 2),
+            },
+        ],
+    };
+}
+//# sourceMappingURL=sync-code-to-spec.js.map

package/dist/tools/sync-code-to-spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-code-to-spec.js","sourceRoot":"","sources":["../../src/tools/sync-code-to-spec.ts"],"names":[],"mappings":"AAAA,yDAAyD;AAEzD,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAC9D,OAAO,EACL,uBAAuB,EACvB,eAAe,EACf,qBAAqB,EACrB,2BAA2B,GAC5B,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AAGpE,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,IAAyB;IAClE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG,IAAI,CAAC;IAEhD,eAAe;IACf,MAAM,IAAI,GAAG,MAAM,SAAS,CAAC,OAAO,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IACxD,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,QAAQ,MAAM,YAAY,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;iBACvE;aACF;YACD,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;IAED,iCAAiC;IACjC,MAAM,WAAW,GAAG,MAAM,2BAA2B,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;IAE3E,kDAAkD;IAClD,MAAM,YAAY,GAAG,MAAM,eAAe,CAAC,IAAI,CAAC,CAAC;IACjD,MAAM,SAAS,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC5C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,YAAY,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAC7C,SAAS,CAAC,GAAG,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE,SAAS,CAAC,CAAC;IACpD,CAAC;IAED,+BAA+B;IAC/B,MAAM,OAAO,GAAG,uBAAuB,CAAC,WAAW,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;IAE5E,sBAAsB;IACtB,MAAM,SAAS,GAAG,eAAe,CAAC,WAAW,CAAC,WAAW,EAAE,SAAS,EAAE,cAAc,CAAC,CAAC;IAEtF,kBAAkB;IAClB,MAAM,MAAM,GAAG,qBAAqB,CAAC,MAAM,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC;IAEjE,aAAa;IACb,MAAM,YAAY,CAAC,aAAa,CAAC,SAAS,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC;IAC/D,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzB,MAAM,YAAY,CAAC,YAAY,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;IACxD,CAAC;IAED,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAe;gBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAClB;oBACE,GAAG,MAAM;oBACT,OAAO,EAAE,sBAAsB,OAAO,CAAC,MAAM,wBAAwB,SAAS,CAAC,MAAM,cAAc;iBACpG,EACD,IAAI,EACJ,CAAC,CACF;aACF;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/tools/sync-spec-to-code.d.ts

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

package/dist/tools/sync-spec-to-code.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-spec-to-code.d.ts","sourceRoot":"","sources":["../../src/tools/sync-spec-to-code.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,mBAAmB,EAAE,UAAU,EAAiB,MAAM,mBAAmB,CAAC;AAExF,wBAAsB,oBAAoB,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,UAAU,CAAC,CAgEzF"}