@planu/cli 0.43.1 → 0.44.0

package/dist/cli/commands/watch.js

@@ -0,0 +1,156 @@
+// cli/commands/watch.ts — planu watch command (SPEC-130)
+import { parseArgs } from 'node:util';
+import { resolve } from 'node:path';
+import { green, cyan, dim, yellow, red } from '../colors.js';
+export const watchCommand = {
+    name: 'watch',
+    description: 'Watch for file changes and run hook handlers',
+    usage: 'planu watch [path] [--hooks on-save,on-create] [--verbose] [--dry-run]',
+    async run(args) {
+        const { values, positionals } = parseArgs({
+            args,
+            options: {
+                hooks: { type: 'string', short: 'H' },
+                verbose: { type: 'boolean', short: 'V' },
+                'dry-run': { type: 'boolean' },
+                help: { type: 'boolean', short: 'h' },
+            },
+            strict: false,
+            allowPositionals: true,
+        });
+        if (values.help) {
+            printWatchHelp();
+            return;
+        }
+        const projectPath = resolve(positionals[0] ?? process.cwd());
+        const hookTypes = values.hooks?.split(',').map((h) => h.trim()) ?? [
+            'on-save',
+            'on-create',
+            'on-delete',
+        ];
+        const verbose = values.verbose ?? false;
+        const dryRun = values['dry-run'] ?? false;
+        process.stdout.write(`${green('Planu Watch')} — watching ${cyan(projectPath)}\n`);
+        process.stdout.write(`${dim('Hooks:')} ${hookTypes.join(', ')}${dryRun ? ` ${yellow('[dry-run]')}` : ''}\n`);
+        process.stdout.write(`${dim('Press Ctrl+C to stop.')}\n\n`);
+        // Lazy-load engine components
+        const { HookEngine } = await import('../../engine/hooks/hook-engine.js');
+        const { EventBus } = await import('../../engine/hooks/event-bus.js');
+        const { FileWatcher } = await import('../../engine/hooks/file-watcher.js');
+        const { ConfigLoader } = await import('../../engine/hooks/config-loader.js');
+        const { Debouncer } = await import('../../engine/hooks/debouncer.js');
+        // Load config
+        const configLoader = new ConfigLoader(projectPath);
+        const config = await configLoader.load();
+        // Create engine
+        const eventBus = new EventBus();
+        const engine = new HookEngine(eventBus);
+        // Verbose logging via event bus
+        if (verbose) {
+            eventBus.onEvent('hook:start', (evt) => {
+                const handler = evt.data.handler;
+                const path = evt.data.path;
+                process.stdout.write(`${dim(`[hook:start]`)} ${handler} → ${path}\n`);
+            });
+            eventBus.onEvent('hook:complete', (evt) => {
+                const handler = evt.data.handler;
+                const latency = evt.data.latencyMs;
+                process.stdout.write(`${green('[hook:complete]')} ${handler} (${String(latency)}ms)\n`);
+            });
+            eventBus.onEvent('hook:error', (evt) => {
+                const handler = evt.data.handler;
+                const error = evt.data.error;
+                process.stderr.write(`${red('[hook:error]')} ${handler}: ${error}\n`);
+            });
+        }
+        // Create watcher and debouncer
+        const watcher = new FileWatcher({
+            rootDir: projectPath,
+            include: config.hooks['on-save']?.include,
+            exclude: config.hooks['on-save']?.exclude,
+        });
+        const debouncer = new Debouncer((event) => {
+            const hookType = mapEventType(event.type);
+            if (!hookType || !hookTypes.includes(hookType)) {
+                return;
+            }
+            if (dryRun) {
+                process.stdout.write(`${yellow('[dry-run]')} Would dispatch ${hookType} for ${event.path}\n`);
+                return;
+            }
+            if (verbose) {
+                process.stdout.write(`${dim('[dispatch]')} ${hookType} → ${event.path}\n`);
+            }
+            void engine.dispatch(event, hookType);
+        }, {
+            debounceMs: config.debounceMs,
+            rateLimitPerFileMs: config.rateLimitPerFileMs,
+        });
+        // Wire watcher -> debouncer
+        watcher.on('change', (event) => {
+            eventBus.emitEvent('file:change', {
+                path: event.path,
+                type: event.type,
+                timestamp: event.timestamp,
+            });
+            debouncer.push(event);
+        });
+        // Start
+        engine.start();
+        watcher.start();
+        configLoader.startWatching();
+        // SIGINT/SIGTERM graceful shutdown
+        const cleanup = () => {
+            process.stdout.write(`\n${dim('Stopping watch...')}\n`);
+            engine.stop();
+            watcher.close();
+            debouncer.dispose();
+            configLoader.close();
+            process.stdout.write(`${green('Watch stopped.')}\n`);
+            process.exit(0);
+        };
+        process.on('SIGINT', cleanup);
+        process.on('SIGTERM', cleanup);
+        // Keep process alive
+        await new Promise(() => {
+            // Never resolves — process runs until signal
+        });
+    },
+};
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function mapEventType(type) {
+    switch (type) {
+        case 'modify':
+            return 'on-save';
+        case 'create':
+            return 'on-create';
+        case 'delete':
+            return 'on-delete';
+        default:
+            return null;
+    }
+}
+function printWatchHelp() {
+    const lines = [
+        `${green('planu watch')} — Watch for file changes and run hook handlers`,
+        '',
+        `${cyan('Usage:')} planu watch [path] [options]`,
+        '',
+        cyan('Options:'),
+        '  --hooks, -H    Comma-separated hook types (default: on-save,on-create,on-delete)',
+        '  --verbose, -V  Show detailed hook execution logs',
+        '  --dry-run      Preview which hooks would fire without executing',
+        '  --help, -h     Show this help message',
+        '',
+        cyan('Examples:'),
+        '  planu watch                    Watch current directory',
+        '  planu watch /path/to/project   Watch specific directory',
+        '  planu watch --hooks on-save    Only watch for file saves',
+        '  planu watch --verbose          Show detailed execution logs',
+        '  planu watch --dry-run          Preview without executing hooks',
+    ];
+    process.stdout.write(lines.join('\n') + '\n');
+}
+//# sourceMappingURL=watch.js.map

package/dist/cli/commands/watch.js.map

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

package/dist/cli/formatter.d.ts

@@ -0,0 +1,18 @@
+import type { ToolResult } from '../types/index.js';
+/**
+ * Format a ToolResult for terminal display.
+ * Parses JSON text content when possible, otherwise returns raw text.
+ */
+export declare function formatToolResult(result: ToolResult, options?: {
+    json?: boolean;
+}): string;
+/**
+ * Render an ASCII table with column alignment.
+ */
+export declare function table(headers: string[], rows: string[][]): string;
+/**
+ * Render a progress bar.
+ * Example: [--------] 67%
+ */
+export declare function progressBar(current: number, total: number, width?: number): string;
+//# sourceMappingURL=formatter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"formatter.d.ts","sourceRoot":"","sources":["../../src/cli/formatter.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE;IAAE,IAAI,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,MAAM,CAuBzF;AA2BD;;GAEG;AACH,wBAAgB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,MAAM,CAYjE;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,MAAM,CAM9E"}

package/dist/cli/formatter.js

@@ -0,0 +1,78 @@
+// cli/formatter.ts — Convert MCP ToolResult to terminal output (SPEC-124)
+/**
+ * Format a ToolResult for terminal display.
+ * Parses JSON text content when possible, otherwise returns raw text.
+ */
+export function formatToolResult(result, options) {
+    const parts = [];
+    for (const item of result.content) {
+        if (options?.json) {
+            parts.push(item.text);
+            continue;
+        }
+        // Try to parse as JSON for prettier output
+        try {
+            const parsed = JSON.parse(item.text);
+            if (typeof parsed === 'object' && parsed !== null) {
+                parts.push(formatObject(parsed));
+            }
+            else {
+                parts.push(String(parsed));
+            }
+        }
+        catch {
+            parts.push(item.text);
+        }
+    }
+    return parts.join('\n');
+}
+function formatObject(obj, indent = 0) {
+    const prefix = ' '.repeat(indent);
+    const lines = [];
+    for (const [key, value] of Object.entries(obj)) {
+        if (Array.isArray(value)) {
+            lines.push(`${prefix}${key}:`);
+            for (const item of value) {
+                if (typeof item === 'object' && item !== null) {
+                    lines.push(formatObject(item, indent + 2));
+                }
+                else {
+                    lines.push(`${prefix}  - ${String(item)}`);
+                }
+            }
+        }
+        else if (typeof value === 'object' && value !== null) {
+            lines.push(`${prefix}${key}:`);
+            lines.push(formatObject(value, indent + 2));
+        }
+        else {
+            lines.push(`${prefix}${key}: ${String(value)}`);
+        }
+    }
+    return lines.join('\n');
+}
+/**
+ * Render an ASCII table with column alignment.
+ */
+export function table(headers, rows) {
+    const widths = headers.map((h, i) => {
+        const maxRow = rows.reduce((max, row) => Math.max(max, (row[i] ?? '').length), 0);
+        return Math.max(h.length, maxRow);
+    });
+    const sep = widths.map((w) => '-'.repeat(w + 2)).join('+');
+    const formatRow = (row) => row.map((cell, i) => ` ${cell.padEnd(widths[i])} `).join('|');
+    const lines = [formatRow(headers), sep, ...rows.map(formatRow)];
+    return lines.join('\n');
+}
+/**
+ * Render a progress bar.
+ * Example: [--------] 67%
+ */
+export function progressBar(current, total, width = 20) {
+    const ratio = total > 0 ? Math.min(current / total, 1) : 0;
+    const filled = Math.round(ratio * width);
+    const empty = width - filled;
+    const pct = Math.round(ratio * 100);
+    return `[${'█'.repeat(filled)}${'░'.repeat(empty)}] ${String(pct)}%`;
+}
+//# sourceMappingURL=formatter.js.map

package/dist/cli/formatter.js.map

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

package/dist/cli/index.d.ts

@@ -0,0 +1,6 @@
+export { route } from './router.js';
+export { shouldColor, red, green, yellow, blue, cyan, bold, dim, gray } from './colors.js';
+export { formatToolResult, table, progressBar } from './formatter.js';
+export { detectProjectId } from './project-detector.js';
+export { ask, confirm, select } from './interactive.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,OAAO,EAAE,WAAW,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAC3F,OAAO,EAAE,gBAAgB,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AACtE,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/cli/index.js

@@ -0,0 +1,7 @@
+// cli/index.ts — Barrel export for CLI module (SPEC-124)
+export { route } from './router.js';
+export { shouldColor, red, green, yellow, blue, cyan, bold, dim, gray } from './colors.js';
+export { formatToolResult, table, progressBar } from './formatter.js';
+export { detectProjectId } from './project-detector.js';
+export { ask, confirm, select } from './interactive.js';
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"AAAA,yDAAyD;AAEzD,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,OAAO,EAAE,WAAW,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAC3F,OAAO,EAAE,gBAAgB,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AACtE,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/cli/interactive.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Ask a free-text question and return the answer.
+ */
+export declare function ask(question: string): Promise<string>;
+/**
+ * Ask a yes/no confirmation question.
+ */
+export declare function confirm(question: string, defaultYes?: boolean): Promise<boolean>;
+/**
+ * Present a numbered list and let the user pick one option.
+ */
+export declare function select(question: string, options: string[]): Promise<string>;
+//# sourceMappingURL=interactive.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"interactive.d.ts","sourceRoot":"","sources":["../../src/cli/interactive.ts"],"names":[],"mappings":"AAQA;;GAEG;AACH,wBAAgB,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAQrD;AAED;;GAEG;AACH,wBAAsB,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,UAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAOnF;AAED;;GAEG;AACH,wBAAsB,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CASjF"}

package/dist/cli/interactive.js

@@ -0,0 +1,42 @@
+// cli/interactive.ts — Interactive prompts via node:readline (SPEC-124)
+import { createInterface } from 'node:readline';
+function createRl() {
+    return createInterface({ input: process.stdin, output: process.stdout });
+}
+/**
+ * Ask a free-text question and return the answer.
+ */
+export function ask(question) {
+    return new Promise((resolve) => {
+        const rl = createRl();
+        rl.question(`${question} `, (answer) => {
+            rl.close();
+            resolve(answer.trim());
+        });
+    });
+}
+/**
+ * Ask a yes/no confirmation question.
+ */
+export async function confirm(question, defaultYes = true) {
+    const hint = defaultYes ? '[Y/n]' : '[y/N]';
+    const answer = await ask(`${question} ${hint}`);
+    if (answer === '') {
+        return defaultYes;
+    }
+    return answer.toLowerCase().startsWith('y');
+}
+/**
+ * Present a numbered list and let the user pick one option.
+ */
+export async function select(question, options) {
+    const lines = options.map((opt, i) => `  ${String(i + 1)}. ${opt}`);
+    const prompt = `${question}\n${lines.join('\n')}\nChoice: `;
+    const answer = await ask(prompt);
+    const idx = parseInt(answer, 10) - 1;
+    if (idx >= 0 && idx < options.length) {
+        return options[idx];
+    }
+    return options[0];
+}
+//# sourceMappingURL=interactive.js.map

package/dist/cli/interactive.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interactive.js","sourceRoot":"","sources":["../../src/cli/interactive.ts"],"names":[],"mappings":"AAAA,wEAAwE;AAExE,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAEhD,SAAS,QAAQ;IACf,OAAO,eAAe,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;AAC3E,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,GAAG,CAAC,QAAgB;IAClC,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,MAAM,EAAE,GAAG,QAAQ,EAAE,CAAC;QACtB,EAAE,CAAC,QAAQ,CAAC,GAAG,QAAQ,GAAG,EAAE,CAAC,MAAc,EAAE,EAAE;YAC7C,EAAE,CAAC,KAAK,EAAE,CAAC;YACX,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;QACzB,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,QAAgB,EAAE,UAAU,GAAG,IAAI;IAC/D,MAAM,IAAI,GAAG,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC;IAC5C,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,GAAG,QAAQ,IAAI,IAAI,EAAE,CAAC,CAAC;IAChD,IAAI,MAAM,KAAK,EAAE,EAAE,CAAC;QAClB,OAAO,UAAU,CAAC;IACpB,CAAC;IACD,OAAO,MAAM,CAAC,WAAW,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;AAC9C,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,QAAgB,EAAE,OAAiB;IAC9D,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,KAAK,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,GAAG,EAAE,CAAC,CAAC;IACpE,MAAM,MAAM,GAAG,GAAG,QAAQ,KAAK,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC;IAC5D,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,MAAM,CAAC,CAAC;IACjC,MAAM,GAAG,GAAG,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC;IACrC,IAAI,GAAG,IAAI,CAAC,IAAI,GAAG,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;QACrC,OAAO,OAAO,CAAC,GAAG,CAAE,CAAC;IACvB,CAAC;IACD,OAAO,OAAO,CAAC,CAAC,CAAE,CAAC;AACrB,CAAC"}

package/dist/cli/project-detector.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Compute a deterministic projectId from a filesystem path.
+ * Uses the same SHA-256 algorithm as storage/base-store.ts hashProjectPath.
+ */
+export declare function detectProjectId(path?: string): string;
+//# sourceMappingURL=project-detector.d.ts.map

package/dist/cli/project-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-detector.d.ts","sourceRoot":"","sources":["../../src/cli/project-detector.ts"],"names":[],"mappings":"AAKA;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAGrD"}

package/dist/cli/project-detector.js

@@ -0,0 +1,12 @@
+// cli/project-detector.ts — Detect projectId from path using same hash as storage (SPEC-124)
+import { createHash } from 'node:crypto';
+import { resolve } from 'node:path';
+/**
+ * Compute a deterministic projectId from a filesystem path.
+ * Uses the same SHA-256 algorithm as storage/base-store.ts hashProjectPath.
+ */
+export function detectProjectId(path) {
+    const resolved = resolve(path ?? process.cwd());
+    return createHash('sha256').update(resolved).digest('hex').slice(0, 16);
+}
+//# sourceMappingURL=project-detector.js.map

package/dist/cli/project-detector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-detector.js","sourceRoot":"","sources":["../../src/cli/project-detector.ts"],"names":[],"mappings":"AAAA,6FAA6F;AAE7F,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,IAAa;IAC3C,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IAChD,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AAC1E,CAAC"}

package/dist/cli/router.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Parse the first arg as a command name and dispatch to the appropriate handler.
+ */
+export declare function route(args: string[]): Promise<void>;
+//# sourceMappingURL=router.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../../src/cli/router.ts"],"names":[],"mappings":"AA6EA;;GAEG;AACH,wBAAsB,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAkDzD"}

package/dist/cli/router.js

@@ -0,0 +1,104 @@
+// cli/router.ts — Command dispatch for CLI mode (SPEC-124)
+import { parseArgs } from 'node:util';
+import { PLANU_VERSION } from '../config/version.js';
+import { red, bold, cyan, dim } from './colors.js';
+// Lazy-load commands to avoid importing tool handlers when not needed
+async function loadCommands() {
+    const [{ initCommand }, { createCommand }, { listCommand }, { statusCommand }, { estimateCommand }, { validateCommand }, { dashboardCommand }, { auditCommand }, { serveCommand }, { handoffCommand }, { watchCommand },] = await Promise.all([
+        import('./commands/init.js'),
+        import('./commands/create.js'),
+        import('./commands/list.js'),
+        import('./commands/status.js'),
+        import('./commands/estimate.js'),
+        import('./commands/validate.js'),
+        import('./commands/dashboard.js'),
+        import('./commands/audit.js'),
+        import('./commands/serve.js'),
+        import('./commands/handoff.js'),
+        import('./commands/watch.js'),
+    ]);
+    const cmds = [
+        initCommand,
+        createCommand,
+        listCommand,
+        statusCommand,
+        estimateCommand,
+        validateCommand,
+        dashboardCommand,
+        auditCommand,
+        serveCommand,
+        handoffCommand,
+        watchCommand,
+    ];
+    const map = new Map();
+    for (const cmd of cmds) {
+        map.set(cmd.name, cmd);
+    }
+    return map;
+}
+function printHelp(commands) {
+    const lines = [
+        `${bold('planu')} ${dim(`v${PLANU_VERSION}`)} — Spec Driven Development CLI`,
+        '',
+        `${cyan('Usage:')} planu <command> [options]`,
+        '',
+        cyan('Commands:'),
+    ];
+    for (const cmd of commands.values()) {
+        lines.push(`  ${cmd.name.padEnd(14)} ${dim(cmd.description)}`);
+    }
+    lines.push('');
+    lines.push(cyan('Options:'));
+    lines.push('  --help       Show help');
+    lines.push('  --version    Show version');
+    process.stdout.write(lines.join('\n') + '\n');
+}
+/**
+ * Parse the first arg as a command name and dispatch to the appropriate handler.
+ */
+export async function route(args) {
+    // Handle global flags
+    const { values } = parseArgs({
+        args,
+        options: {
+            help: { type: 'boolean', short: 'h' },
+            version: { type: 'boolean', short: 'v' },
+        },
+        strict: false,
+        allowPositionals: true,
+    });
+    if (values.version) {
+        process.stdout.write(`planu ${PLANU_VERSION}\n`);
+        return;
+    }
+    const commands = await loadCommands();
+    if (values.help && args.length <= 1) {
+        printHelp(commands);
+        return;
+    }
+    const commandName = args[0];
+    if (!commandName || commandName === 'help') {
+        printHelp(commands);
+        return;
+    }
+    if (commandName === 'version') {
+        process.stdout.write(`planu ${PLANU_VERSION}\n`);
+        return;
+    }
+    const cmd = commands.get(commandName);
+    if (!cmd) {
+        process.stderr.write(`${red('Error:')} Unknown command "${commandName}"\n`);
+        process.stderr.write(`Run ${cyan('planu --help')} to see available commands.\n`);
+        process.exitCode = 1;
+        return;
+    }
+    try {
+        await cmd.run(args.slice(1));
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        process.stderr.write(`${red('Error:')} ${message}\n`);
+        process.exitCode = 1;
+    }
+}
+//# sourceMappingURL=router.js.map

package/dist/cli/router.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.js","sourceRoot":"","sources":["../../src/cli/router.ts"],"names":[],"mappings":"AAAA,2DAA2D;AAE3D,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,aAAa,CAAC;AAEnD,sEAAsE;AACtE,KAAK,UAAU,YAAY;IACzB,MAAM,CACJ,EAAE,WAAW,EAAE,EACf,EAAE,aAAa,EAAE,EACjB,EAAE,WAAW,EAAE,EACf,EAAE,aAAa,EAAE,EACjB,EAAE,eAAe,EAAE,EACnB,EAAE,eAAe,EAAE,EACnB,EAAE,gBAAgB,EAAE,EACpB,EAAE,YAAY,EAAE,EAChB,EAAE,YAAY,EAAE,EAChB,EAAE,cAAc,EAAE,EAClB,EAAE,YAAY,EAAE,EACjB,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QACpB,MAAM,CAAC,oBAAoB,CAAC;QAC5B,MAAM,CAAC,sBAAsB,CAAC;QAC9B,MAAM,CAAC,oBAAoB,CAAC;QAC5B,MAAM,CAAC,sBAAsB,CAAC;QAC9B,MAAM,CAAC,wBAAwB,CAAC;QAChC,MAAM,CAAC,wBAAwB,CAAC;QAChC,MAAM,CAAC,yBAAyB,CAAC;QACjC,MAAM,CAAC,qBAAqB,CAAC;QAC7B,MAAM,CAAC,qBAAqB,CAAC;QAC7B,MAAM,CAAC,uBAAuB,CAAC;QAC/B,MAAM,CAAC,qBAAqB,CAAC;KAC9B,CAAC,CAAC;IAEH,MAAM,IAAI,GAAiB;QACzB,WAAW;QACX,aAAa;QACb,WAAW;QACX,aAAa;QACb,eAAe;QACf,eAAe;QACf,gBAAgB;QAChB,YAAY;QACZ,YAAY;QACZ,cAAc;QACd,YAAY;KACb,CAAC;IAEF,MAAM,GAAG,GAAG,IAAI,GAAG,EAAsB,CAAC;IAC1C,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IACzB,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,SAAS,CAAC,QAAiC;IAClD,MAAM,KAAK,GAAa;QACtB,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,GAAG,CAAC,IAAI,aAAa,EAAE,CAAC,gCAAgC;QAC5E,EAAE;QACF,GAAG,IAAI,CAAC,QAAQ,CAAC,4BAA4B;QAC7C,EAAE;QACF,IAAI,CAAC,WAAW,CAAC;KAClB,CAAC;IAEF,KAAK,MAAM,GAAG,IAAI,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC;QACpC,KAAK,CAAC,IAAI,CAAC,KAAK,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,GAAG,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;IACjE,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;IAC7B,KAAK,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC;IACvC,KAAK,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAC;IAE1C,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;AAChD,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,KAAK,CAAC,IAAc;IACxC,sBAAsB;IACtB,MAAM,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;QAC3B,IAAI;QACJ,OAAO,EAAE;YACP,IAAI,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,EAAE;YACrC,OAAO,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,EAAE;SACzC;QACD,MAAM,EAAE,KAAK;QACb,gBAAgB,EAAE,IAAI;KACvB,CAAC,CAAC;IAEH,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACnB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,aAAa,IAAI,CAAC,CAAC;QACjD,OAAO;IACT,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,YAAY,EAAE,CAAC;IAEtC,IAAI,MAAM,CAAC,IAAI,IAAI,IAAI,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;QACpC,SAAS,CAAC,QAAQ,CAAC,CAAC;QACpB,OAAO;IACT,CAAC;IAED,MAAM,WAAW,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IAC5B,IAAI,CAAC,WAAW,IAAI,WAAW,KAAK,MAAM,EAAE,CAAC;QAC3C,SAAS,CAAC,QAAQ,CAAC,CAAC;QACpB,OAAO;IACT,CAAC;IAED,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;QAC9B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,aAAa,IAAI,CAAC,CAAC;QACjD,OAAO;IACT,CAAC;IAED,MAAM,GAAG,GAAG,QAAQ,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IACtC,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,QAAQ,CAAC,qBAAqB,WAAW,KAAK,CAAC,CAAC;QAC5E,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,IAAI,CAAC,cAAc,CAAC,+BAA+B,CAAC,CAAC;QACjF,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;QACrB,OAAO;IACT,CAAC;IAED,IAAI,CAAC;QACH,MAAM,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/B,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACtB,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACjE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,QAAQ,CAAC,IAAI,OAAO,IAAI,CAAC,CAAC;QACtD,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;IACvB,CAAC;AACH,CAAC"}

package/dist/config/hook-defaults.json

@@ -0,0 +1,19 @@
+{
+  "enabled": true,
+  "debounceMs": 300,
+  "rateLimitPerFileMs": 5000,
+  "hooks": {
+    "on-save": {
+      "enabled": true,
+      "include": ["src/**/*.ts"],
+      "exclude": ["**/*.test.ts"]
+    },
+    "on-create": {
+      "enabled": true,
+      "include": ["src/**/*.ts"]
+    },
+    "on-delete": {
+      "enabled": true
+    }
+  }
+}

package/dist/config/license-plans.json

@@ -96,6 +96,10 @@
     "estimate_ai_cost",
     "generate_ci",
     "manage_hooks",
+    "start_hooks",
+    "stop_hooks",
+    "hook_status",
+    "configure_hooks",
     "apply_template",
     "check_spec_accuracy",
     "update_registry",
@@ -125,7 +129,18 @@
     "audit_claude_config",
     "generate_docs_site",
     "export_spec",
-    "analyze_spec_dependencies"
+    "analyze_spec_dependencies",
+    "validate_annotations",
+    "generate_annotations",
+    "snapshot_spec_hashes",
+    "auto_reconcile",
+    "living_spec_watch",
+    "living_spec_status",
+    "spec_diff",
+    "living_spec_coverage",
+    "sync_spec_to_code",
+    "sync_code_to_spec",
+    "resolve_sync_conflict"
   ],
   "alwaysAllowed": [
     "activate_license",

package/dist/config/tool-groups.json

@@ -45,7 +45,18 @@
         "reality_check",
         "check_spec_accuracy",
         "paradigm_report",
-        "spec_coverage"
+        "spec_coverage",
+        "validate_annotations",
+        "generate_annotations",
+        "snapshot_spec_hashes",
+        "auto_reconcile",
+        "living_spec_watch",
+        "living_spec_status",
+        "spec_diff",
+        "living_spec_coverage",
+        "sync_spec_to_code",
+        "sync_code_to_spec",
+        "resolve_sync_conflict"
       ],
       "defaultEnabled": false,
       "locked": false,

package/dist/engine/analyzer/analyze-project.d.ts

@@ -0,0 +1,15 @@
+import type { ProjectKnowledge, DatabaseEngine, SupportedLocale, ExperienceLevel, StackSignatures, ArchPatternsFile } from '../../types/index.js';
+/**
+ * Full project analysis: scans filesystem to build ProjectKnowledge.
+ */
+export declare function analyzeProject(projectPath: string, projectId: string, locale?: SupportedLocale, experienceLevel?: ExperienceLevel, stackSignatures?: StackSignatures, archPatterns?: ArchPatternsFile): Promise<ProjectKnowledge>;
+/**
+ * Quick analysis: only detects language, framework, and package manager.
+ */
+export declare function quickAnalyze(projectPath: string): Promise<{
+    language: string;
+    framework: string | null;
+    packageManager: string | null;
+    database: DatabaseEngine;
+}>;
+//# sourceMappingURL=analyze-project.d.ts.map

package/dist/engine/analyzer/analyze-project.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyze-project.d.ts","sourceRoot":"","sources":["../../../src/engine/analyzer/analyze-project.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,gBAAgB,EAChB,cAAc,EACd,eAAe,EACf,eAAe,EACf,eAAe,EACf,gBAAgB,EACjB,MAAM,sBAAsB,CAAC;AA6B9B;;GAEG;AAEH,wBAAsB,cAAc,CAClC,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,MAAM,GAAE,eAAsB,EAC9B,eAAe,GAAE,eAAgC,EACjD,eAAe,CAAC,EAAE,eAAe,EACjC,YAAY,CAAC,EAAE,gBAAgB,GAC9B,OAAO,CAAC,gBAAgB,CAAC,CAmG3B;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC;IAC/D,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,QAAQ,EAAE,cAAc,CAAC;CAC1B,CAAC,CASD"}