@planu/cli 0.43.0 → 0.44.0

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/suggest-tooling/catalog-loader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"catalog-loader.d.ts","sourceRoot":"","sources":["../../../src/tools/suggest-tooling/catalog-loader.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAIhE,wBAAsB,WAAW,IAAI,OAAO,CAAC,mBAAmB,CAAC,CAehE"}
+{"version":3,"file":"catalog-loader.d.ts","sourceRoot":"","sources":["../../../src/tools/suggest-tooling/catalog-loader.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAIhE,wBAAsB,WAAW,IAAI,OAAO,CAAC,mBAAmB,CAAC,CAgBhE"}

package/dist/tools/suggest-tooling/catalog-loader.js

@@ -2,6 +2,7 @@
 import { readFile } from 'node:fs/promises';
 let catalogCache = null;
 export async function loadCatalog() {
+    /* v8 ignore next 3 -- cache hit path, depends on module-level state between test runs */
     if (catalogCache) {
         return catalogCache;
     }

package/dist/tools/suggest-tooling/catalog-loader.js.map

@@ -1 +1 @@
-{"version":3,"file":"catalog-loader.js","sourceRoot":"","sources":["../../../src/tools/suggest-tooling/catalog-loader.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAG5C,IAAI,YAAY,GAA+B,IAAI,CAAC;AAEpD,MAAM,CAAC,KAAK,UAAU,WAAW;IAC/B,IAAI,YAAY,EAAE,CAAC;QACjB,OAAO,YAAY,CAAC;IACtB,CAAC;IACD,IAAI,CAAC;QACH,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,yCAAyC,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACvF,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;QACpD,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAA4B,CAAC;QAC3D,0BAA0B;QAC1B,OAAO,GAAG,CAAC,YAAY,CAAC;QACxB,YAAY,GAAG,GAA0B,CAAC;QAC1C,OAAO,YAAY,CAAC;IACtB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC"}
+{"version":3,"file":"catalog-loader.js","sourceRoot":"","sources":["../../../src/tools/suggest-tooling/catalog-loader.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAG5C,IAAI,YAAY,GAA+B,IAAI,CAAC;AAEpD,MAAM,CAAC,KAAK,UAAU,WAAW;IAC/B,yFAAyF;IACzF,IAAI,YAAY,EAAE,CAAC;QACjB,OAAO,YAAY,CAAC;IACtB,CAAC;IACD,IAAI,CAAC;QACH,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,yCAAyC,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACvF,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;QACpD,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAA4B,CAAC;QAC3D,0BAA0B;QAC1B,OAAO,GAAG,CAAC,YAAY,CAAC;QACxB,YAAY,GAAG,GAA0B,CAAC;QAC1C,OAAO,YAAY,CAAC;IACtB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC"}

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

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

@@ -0,0 +1,58 @@
+// tools/sync-spec-to-code.ts — sync_spec_to_code handler
+import { specStore, syncLogStore } from '../storage/index.js';
+import { generateTodoComments, detectConflicts, buildSpecToCodeResult, parseAnnotationsFromProject, } from '../engine/living-spec/index.js';
+import { extractCriteria } from '../engine/validator/extractors.js';
+export async function handleSyncSpecToCode(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. Extract criteria
+    const criteriaList = await extractCriteria(spec);
+    const pendingCriteria = criteriaList.map((desc, i) => ({
+        specId,
+        criterion: i + 1,
+        description: desc,
+        status: 'pending',
+    }));
+    // 3. Parse existing annotations
+    const parseResult = await parseAnnotationsFromProject(projectPath, specId);
+    // 4. Generate TODOs for pending criteria
+    const defaultFile = `${projectPath}/TODO-${specId}.md`;
+    const todos = generateTodoComments(pendingCriteria, parseResult.annotations, defaultFile);
+    // 5. Detect conflicts
+    const statusMap = new Map();
+    for (const criterion of pendingCriteria) {
+        statusMap.set(`${specId}:AC-${criterion.criterion}`, criterion.status);
+    }
+    const conflicts = detectConflicts(parseResult.annotations, statusMap, 'spec-to-code');
+    // 6. Build result
+    const result = buildSpecToCodeResult(specId, todos, conflicts);
+    // 7. Persist sync log and conflicts
+    await syncLogStore.appendSyncLog(projectId, result.logEntries);
+    if (conflicts.length > 0) {
+        await syncLogStore.addConflicts(projectId, conflicts);
+    }
+    return {
+        content: [
+            {
+                type: 'text',
+                text: JSON.stringify({
+                    ...result,
+                    message: `Spec-to-code sync: ${todos.length} TODO(s) generated, ${conflicts.length} conflict(s) detected`,
+                }, null, 2),
+            },
+        ],
+    };
+}
+//# sourceMappingURL=sync-spec-to-code.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sync-spec-to-code.js","sourceRoot":"","sources":["../../src/tools/sync-spec-to-code.ts"],"names":[],"mappings":"AAAA,yDAAyD;AAEzD,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAC9D,OAAO,EACL,oBAAoB,EACpB,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,sBAAsB;IACtB,MAAM,YAAY,GAAG,MAAM,eAAe,CAAC,IAAI,CAAC,CAAC;IACjD,MAAM,eAAe,GAAoB,YAAY,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;QACtE,MAAM;QACN,SAAS,EAAE,CAAC,GAAG,CAAC;QAChB,WAAW,EAAE,IAAI;QACjB,MAAM,EAAE,SAAS;KAClB,CAAC,CAAC,CAAC;IAEJ,gCAAgC;IAChC,MAAM,WAAW,GAAG,MAAM,2BAA2B,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;IAE3E,yCAAyC;IACzC,MAAM,WAAW,GAAG,GAAG,WAAW,SAAS,MAAM,KAAK,CAAC;IACvD,MAAM,KAAK,GAAG,oBAAoB,CAAC,eAAe,EAAE,WAAW,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;IAE1F,sBAAsB;IACtB,MAAM,SAAS,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC5C,KAAK,MAAM,SAAS,IAAI,eAAe,EAAE,CAAC;QACxC,SAAS,CAAC,GAAG,CAAC,GAAG,MAAM,OAAO,SAAS,CAAC,SAAS,EAAE,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;IACzE,CAAC;IACD,MAAM,SAAS,GAAG,eAAe,CAAC,WAAW,CAAC,WAAW,EAAE,SAAS,EAAE,cAAc,CAAC,CAAC;IAEtF,kBAAkB;IAClB,MAAM,MAAM,GAAG,qBAAqB,CAAC,MAAM,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC;IAE/D,oCAAoC;IACpC,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,KAAK,CAAC,MAAM,uBAAuB,SAAS,CAAC,MAAM,uBAAuB;iBAC1G,EACD,IAAI,EACJ,CAAC,CACF;aACF;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/tools/validate-annotations.d.ts

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

package/dist/tools/validate-annotations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-annotations.d.ts","sourceRoot":"","sources":["../../src/tools/validate-annotations.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EACV,wBAAwB,EAGxB,UAAU,EACX,MAAM,mBAAmB,CAAC;AAE3B,wBAAsB,yBAAyB,CAC7C,IAAI,EAAE,wBAAwB,GAC7B,OAAO,CAAC,UAAU,CAAC,CAwGrB"}

package/dist/tools/validate-annotations.js

@@ -0,0 +1,90 @@
+// tools/validate-annotations.ts — Validate @spec annotations in source code
+// Checks that all annotated spec IDs exist and criteria numbers are valid.
+import { specStore } from '../storage/index.js';
+import { parseAnnotationsFromProject } from '../engine/living-spec/index.js';
+import { extractCriteria } from '../engine/validator/extractors.js';
+export async function handleValidateAnnotations(args) {
+    const { projectId, projectPath, specId: filterSpecId } = args;
+    // 1. Parse annotations from project
+    const parseResult = await parseAnnotationsFromProject(projectPath, filterSpecId);
+    if (parseResult.annotations.length === 0) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({
+                        message: 'No @spec annotations found in project',
+                        fileCount: parseResult.fileCount,
+                        annotatedFileCount: 0,
+                    }, null, 2),
+                },
+            ],
+        };
+    }
+    // 2. Validate each annotation against stored specs
+    const valid = [];
+    const invalid = [];
+    // Cache specs to avoid repeated lookups
+    const specCache = new Map();
+    const criteriaCache = new Map();
+    for (const annotation of parseResult.annotations) {
+        // Check if spec exists
+        let spec = specCache.get(annotation.specId);
+        if (spec === undefined) {
+            spec = await specStore.getSpec(projectId, annotation.specId);
+            specCache.set(annotation.specId, spec);
+        }
+        if (!spec) {
+            invalid.push({
+                annotation,
+                reason: `Spec ${annotation.specId} not found in project`,
+            });
+            continue;
+        }
+        // Check criteria numbers if specified
+        if (annotation.criteria.length > 0) {
+            let criteriaList = criteriaCache.get(annotation.specId);
+            if (criteriaList === undefined) {
+                criteriaList = await extractCriteria(spec);
+                criteriaCache.set(annotation.specId, criteriaList);
+            }
+            const maxCriterion = criteriaList.length;
+            const invalidCriteria = annotation.criteria.filter((c) => c > maxCriterion || c < 1);
+            if (invalidCriteria.length > 0) {
+                invalid.push({
+                    annotation,
+                    reason: `Invalid criteria AC-${invalidCriteria.join(', AC-')}: spec has ${maxCriterion} criteria`,
+                });
+                continue;
+            }
+        }
+        valid.push({
+            annotation,
+            reason: 'Valid annotation',
+        });
+    }
+    const result = {
+        valid,
+        invalid,
+        totalAnnotations: parseResult.annotations.length,
+        validCount: valid.length,
+        invalidCount: invalid.length,
+    };
+    return {
+        content: [
+            {
+                type: 'text',
+                text: JSON.stringify({
+                    ...result,
+                    fileCount: parseResult.fileCount,
+                    annotatedFileCount: parseResult.annotatedFileCount,
+                    message: invalid.length > 0
+                        ? `${invalid.length} invalid annotation(s) found. Review and fix before proceeding.`
+                        : `All ${valid.length} annotation(s) are valid.`,
+                }, null, 2),
+            },
+        ],
+        isError: invalid.length > 0 ? true : undefined,
+    };
+}
+//# sourceMappingURL=validate-annotations.js.map

package/dist/tools/validate-annotations.js.map

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

package/dist/types/cli.d.ts

@@ -0,0 +1,14 @@
+/**
+ * A CLI command handler that can be dispatched by the router.
+ */
+export interface CliCommand {
+    /** Command name (e.g. "init", "create") */
+    name: string;
+    /** Short description for help text */
+    description: string;
+    /** Usage string (e.g. "planu init [path]") */
+    usage: string;
+    /** Execute the command with parsed args */
+    run(args: string[]): Promise<void>;
+}
+//# sourceMappingURL=cli.d.ts.map

package/dist/types/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../src/types/cli.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,2CAA2C;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb,sCAAsC;IACtC,WAAW,EAAE,MAAM,CAAC;IACpB,8CAA8C;IAC9C,KAAK,EAAE,MAAM,CAAC;IACd,2CAA2C;IAC3C,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACpC"}

package/dist/types/cli.js

@@ -0,0 +1,3 @@
+// Planu — CLI type definitions (SPEC-124)
+export {};
+//# sourceMappingURL=cli.js.map

package/dist/types/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../src/types/cli.ts"],"names":[],"mappings":"AAAA,0CAA0C"}

package/dist/types/dashboard.d.ts

@@ -1,4 +1,4 @@
-import type { SpecStatus } from './common.js';
+import type { Difficulty, RiskLevel, SpecStatus } from './common.js';
 /** State of the dashboard HTTP server (singleton in memory) */
 export interface DashboardServerState {
     port: number;
@@ -24,6 +24,10 @@ export interface DashboardSpecCard {
     criteriaTotal: number;
     criteriaImplemented: number;
     progressPercent: number;
+    updatedAt?: string;
+    difficulty?: Difficulty;
+    risk?: RiskLevel;
+    tags?: string[];
 }
 /** Health metrics for a project displayed in the health panel */
 export interface ProjectHealthMetrics {
@@ -33,6 +37,70 @@ export interface ProjectHealthMetrics {
     activeImplementation: number;
     totalEstimation: number | null;
 }
+/** Trend direction indicator for dashboard metrics */
+export type TrendDirection = 'up' | 'down' | 'stable';
+/** Single metric with trend */
+export interface MetricTrend {
+    value: number;
+    trend: TrendDirection;
+}
+/** Dashboard metrics computed from spec data */
+export interface DashboardMetrics {
+    completionRate: number;
+    criteriaCoverage: number;
+    velocity: number;
+    driftScore: number;
+}
+/** Trend information for all dashboard metrics */
+export interface DashboardMetricTrends {
+    completionRate: TrendDirection;
+    criteriaCoverage: TrendDirection;
+    velocity: TrendDirection;
+    driftScore: TrendDirection;
+}
+/** WIP limits per kanban column */
+export type KanbanWipLimits = Record<string, number>;
+/** Valid status transitions map */
+export type StatusTransitionMap = Record<string, string[]>;
+/** Result of a spec status update operation */
+export interface SpecStatusUpdateResult {
+    success: boolean;
+    specId: string;
+    newStatus: string;
+    error?: string;
+}
+/** Project health score with weighted components */
+export interface ProjectHealthScore {
+    overall: number;
+    components: {
+        completion: number;
+        coverage: number;
+        drift: number;
+        velocity: number;
+    };
+}
+/** Raw constitution drift data */
+export interface RawConstitutionDrift {
+    score?: number;
+    violations?: number;
+}
+/** Frontmatter data parsed from spec.md YAML header */
+export interface SpecFrontmatter {
+    [key: string]: unknown;
+    status?: string;
+    difficulty?: number;
+    risk?: string;
+    tags?: string[];
+    updatedAt?: string;
+}
+/** Enhanced spec detail data with code links and frontmatter */
+export interface SpecDetailData {
+    hu: string | null;
+    ficha: string | null;
+    progress: string | null;
+    codeLinks: string[];
+    frontmatter: SpecFrontmatter;
+}
 /** Usage stats panel data read from data/global/ (SPEC-064) */
 export interface DashboardUsageStats {
     tier: string;
@@ -60,6 +128,10 @@ export interface RawSpecJson {
         totalDays?: number;
         totalPoints?: number;
     };
+    updatedAt?: string;
+    difficulty?: number;
+    risk?: string;
+    tags?: string[];
 }
 /** Raw structure of usage.json file read by data-loader */
 export interface RawUsageJson {
@@ -68,9 +140,22 @@ export interface RawUsageJson {
     dailyLimit?: number | null;
     trialDaysLeft?: number | null;
 }
+/** A single event representing a change in project data */
+export interface DashboardEvent {
+    type: 'spec_updated' | 'spec_created' | 'spec_deleted' | 'project_updated';
+    specId?: string;
+    timestamp: string;
+    data?: Record<string, unknown>;
+}
+/** Response from the events endpoint */
+export interface DashboardEventsResponse {
+    events: DashboardEvent[];
+    timestamp: string;
+}
 /** Input for start_dashboard MCP tool */
 export interface StartDashboardInput {
     port?: number;
+    open_browser?: boolean;
 }
 /** Input for stop_dashboard MCP tool */
 export type StopDashboardInput = Record<string, never>;

package/dist/types/dashboard.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dashboard.d.ts","sourceRoot":"","sources":["../../src/types/dashboard.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C,+DAA+D;AAC/D,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,IAAI,GAAG,IAAI,CAAC;CACxB;AAED,iDAAiD;AACjD,MAAM,WAAW,uBAAuB;IACtC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,iBAAiB,EAAE,CAAC;CAC5B;AAED,mDAAmD;AACnD,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,UAAU,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,iEAAiE;AACjE,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC;AAED,+DAA+D;AAC/D,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,8DAA8D;AAC9D,MAAM,WAAW,cAAc;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,2DAA2D;AAC3D,MAAM,WAAW,WAAW;IAC1B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC3D;AAED,2DAA2D;AAC3D,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAED,yCAAyC;AACzC,MAAM,WAAW,mBAAmB;IAClC,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,wCAAwC;AACxC,MAAM,MAAM,kBAAkB,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC"}
+{"version":3,"file":"dashboard.d.ts","sourceRoot":"","sources":["../../src/types/dashboard.ts"],"names":[],"mappings":"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"}