@planu/cli 0.43.1 → 0.45.0

package/dist/tools/schemas/spec-registry-schemas.d.ts

@@ -0,0 +1,39 @@
+import { z } from 'zod';
+/** Input schema for registry_search tool. */
+export declare const RegistrySearchInputSchema: z.ZodObject<{
+    query: z.ZodString;
+    stack: z.ZodOptional<z.ZodString>;
+    category: z.ZodOptional<z.ZodString>;
+    difficulty: z.ZodOptional<z.ZodObject<{
+        min: z.ZodOptional<z.ZodNumber>;
+        max: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    sort: z.ZodOptional<z.ZodEnum<{
+        downloads: "downloads";
+        rating: "rating";
+        recent: "recent";
+    }>>;
+    page: z.ZodDefault<z.ZodNumber>;
+    limit: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>;
+/** Input schema for registry_install tool. */
+export declare const RegistryInstallInputSchema: z.ZodObject<{
+    specName: z.ZodString;
+    version: z.ZodOptional<z.ZodString>;
+    projectPath: z.ZodString;
+    adapt: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>;
+/** Input schema for registry_publish tool. */
+export declare const RegistryPublishInputSchema: z.ZodObject<{
+    specDir: z.ZodString;
+    projectPath: z.ZodString;
+}, z.core.$strip>;
+/** Input schema for registry_login tool. */
+export declare const RegistryLoginInputSchema: z.ZodObject<{
+    token: z.ZodString;
+}, z.core.$strip>;
+/** Input schema for registry_logout tool. */
+export declare const RegistryLogoutInputSchema: z.ZodObject<{}, z.core.$strip>;
+/** Input schema for registry_whoami tool. */
+export declare const RegistryWhoamiInputSchema: z.ZodObject<{}, z.core.$strip>;
+//# sourceMappingURL=spec-registry-schemas.d.ts.map

package/dist/tools/schemas/spec-registry-schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-registry-schemas.d.ts","sourceRoot":"","sources":["../../../src/tools/schemas/spec-registry-schemas.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,6CAA6C;AAC7C,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;iBAgCpC,CAAC;AAEH,8CAA8C;AAC9C,eAAO,MAAM,0BAA0B;;;;;iBAkBrC,CAAC;AAEH,8CAA8C;AAC9C,eAAO,MAAM,0BAA0B;;;iBASrC,CAAC;AAEH,4CAA4C;AAC5C,eAAO,MAAM,wBAAwB;;iBAEnC,CAAC;AAEH,6CAA6C;AAC7C,eAAO,MAAM,yBAAyB,gCAAe,CAAC;AAEtD,6CAA6C;AAC7C,eAAO,MAAM,yBAAyB,gCAAe,CAAC"}

package/dist/tools/schemas/spec-registry-schemas.js

@@ -0,0 +1,72 @@
+// schemas/spec-registry-schemas.ts — Zod schemas for SPEC-127 registry tools
+import { z } from 'zod';
+/** Input schema for registry_search tool. */
+export const RegistrySearchInputSchema = z.object({
+    query: z
+        .string()
+        .max(500)
+        .describe('Free-text search query to find specs (e.g. "auth next.js", "stripe payments")'),
+    stack: z
+        .string()
+        .max(200)
+        .optional()
+        .describe('Filter by stack ID: next.js | express | fastapi | django | rails | spring-boot | laravel | gin | actix-web | phoenix | sveltekit | nuxt | remix | astro'),
+    category: z
+        .string()
+        .max(200)
+        .optional()
+        .describe('Filter by category ID: auth | payments | crud | api | database | testing | ci-cd | deployment | monitoring | notifications | file-upload | search | caching | i18n | seo | analytics | security | performance'),
+    difficulty: z
+        .object({
+        min: z.number().min(1).max(5).optional().describe('Minimum difficulty level (1-5)'),
+        max: z.number().min(1).max(5).optional().describe('Maximum difficulty level (1-5)'),
+    })
+        .optional()
+        .describe('Filter by difficulty range (1 = beginner, 5 = expert)'),
+    sort: z
+        .enum(['downloads', 'rating', 'recent'])
+        .optional()
+        .describe('Sort order: downloads | rating | recent'),
+    page: z.number().min(1).default(1).describe('Page number, 1-based (default: 1)'),
+    limit: z.number().min(1).max(100).default(20).describe('Results per page, max 100 (default: 20)'),
+});
+/** Input schema for registry_install tool. */
+export const RegistryInstallInputSchema = z.object({
+    specName: z
+        .string()
+        .max(500)
+        .describe('Spec identifier in org/name format (e.g. "planu/auth-nextjs")'),
+    version: z
+        .string()
+        .max(100)
+        .optional()
+        .describe('Specific semver version to install (default: latest)'),
+    projectPath: z
+        .string()
+        .max(2000)
+        .describe('Absolute path to the target project where the spec will be installed'),
+    adapt: z
+        .boolean()
+        .default(true)
+        .describe('Whether to adapt the spec to the detected project stack (default: true)'),
+});
+/** Input schema for registry_publish tool. */
+export const RegistryPublishInputSchema = z.object({
+    specDir: z
+        .string()
+        .max(2000)
+        .describe('Absolute path to the spec directory containing planu-registry.json'),
+    projectPath: z
+        .string()
+        .max(2000)
+        .describe('Absolute path to the project root (used for context resolution)'),
+});
+/** Input schema for registry_login tool. */
+export const RegistryLoginInputSchema = z.object({
+    token: z.string().max(1000).describe('API token obtained from planu.dev account settings'),
+});
+/** Input schema for registry_logout tool. */
+export const RegistryLogoutInputSchema = z.object({});
+/** Input schema for registry_whoami tool. */
+export const RegistryWhoamiInputSchema = z.object({});
+//# sourceMappingURL=spec-registry-schemas.js.map

package/dist/tools/schemas/spec-registry-schemas.js.map

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

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