open-wiki-spec 0.1.0

package/dist/cli/commands/init.js

@@ -0,0 +1,36 @@
+import { initVault } from '../init/init-engine.js';
+export function registerInitCommand(program) {
+    program
+        .command('init [path]')
+        .description('Initialize a new open-wiki-spec vault')
+        .option('--force', 'Force re-initialization, recreating meta files')
+        .option('--json', 'Output result as JSON')
+        .action(async (targetPath, opts) => {
+        try {
+            const result = await initVault({ path: targetPath, force: opts.force });
+            if (opts.json) {
+                console.log(JSON.stringify(result, null, 2));
+            }
+            else {
+                if (result.mode === 'fresh') {
+                    console.log(`Vault initialized at ${result.wikiPath}`);
+                }
+                else {
+                    console.log(`Vault extended at ${result.wikiPath}`);
+                }
+                console.log(`  Directories: ${result.directoriesCreated.length} created`);
+                console.log(`  Meta files: ${result.metaFilesCreated.length} created`);
+                console.log(`  Skill files: ${result.skillFilesGenerated.length} generated`);
+                if (result.warnings.length > 0) {
+                    for (const w of result.warnings)
+                        console.log(`  Warning: ${w}`);
+                }
+            }
+        }
+        catch (err) {
+            console.error(`Error: ${err.message}`);
+            process.exitCode = 1;
+        }
+    });
+}
+//# sourceMappingURL=init.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../../src/cli/commands/init.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAEnD,MAAM,UAAU,mBAAmB,CAAC,OAAgB;IAClD,OAAO;SACJ,OAAO,CAAC,aAAa,CAAC;SACtB,WAAW,CAAC,uCAAuC,CAAC;SACpD,MAAM,CAAC,SAAS,EAAE,gDAAgD,CAAC;SACnE,MAAM,CAAC,QAAQ,EAAE,uBAAuB,CAAC;SACzC,MAAM,CAAC,KAAK,EAAE,UAA8B,EAAE,IAAyC,EAAE,EAAE;QAC1F,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;YACxE,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;gBACd,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;YAC/C,CAAC;iBAAM,CAAC;gBACN,IAAI,MAAM,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;oBAC5B,OAAO,CAAC,GAAG,CAAC,wBAAwB,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;gBACzD,CAAC;qBAAM,CAAC;oBACN,OAAO,CAAC,GAAG,CAAC,qBAAqB,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;gBACtD,CAAC;gBACD,OAAO,CAAC,GAAG,CAAC,kBAAkB,MAAM,CAAC,kBAAkB,CAAC,MAAM,UAAU,CAAC,CAAC;gBAC1E,OAAO,CAAC,GAAG,CAAC,iBAAiB,MAAM,CAAC,gBAAgB,CAAC,MAAM,UAAU,CAAC,CAAC;gBACvE,OAAO,CAAC,GAAG,CAAC,kBAAkB,MAAM,CAAC,mBAAmB,CAAC,MAAM,YAAY,CAAC,CAAC;gBAC7E,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBAC/B,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,QAAQ;wBAAE,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,EAAE,CAAC,CAAC;gBAClE,CAAC;YACH,CAAC;QACH,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,KAAK,CAAC,UAAW,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC;YAClD,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;QACvB,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/cli/commands/list.d.ts

@@ -0,0 +1,28 @@
+/**
+ * CLI handler for `ows list`.
+ */
+import type { Command } from 'commander';
+import type { VaultIndex } from '../../types/index.js';
+import type { NoteType } from '../../types/notes.js';
+export interface ListItem {
+    id: string;
+    type: NoteType;
+    title: string;
+    status: string;
+    path: string;
+    linkedFeature?: string;
+    taskProgress?: {
+        total: number;
+        completed: number;
+    };
+}
+export interface ListResult {
+    type: 'changes' | 'features' | 'all';
+    items: ListItem[];
+}
+export declare function registerListCommand(program: Command): void;
+/**
+ * List notes from the vault index.
+ */
+export declare function listNotes(index: VaultIndex, filterType: 'changes' | 'features' | 'all'): ListResult;
+//# sourceMappingURL=list.d.ts.map

package/dist/cli/commands/list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/list.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,KAAK,EAAE,UAAU,EAAe,MAAM,sBAAsB,CAAC;AACpE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAErD,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,QAAQ,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;CACrD;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,SAAS,GAAG,UAAU,GAAG,KAAK,CAAC;IACrC,KAAK,EAAE,QAAQ,EAAE,CAAC;CACnB;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAmC1D;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,SAAS,GAAG,UAAU,GAAG,KAAK,GAAG,UAAU,CA8CnG"}

package/dist/cli/commands/list.js

@@ -0,0 +1,85 @@
+import { discoverVaultPath } from '../vault-discovery.js';
+export function registerListCommand(program) {
+    program
+        .command('list')
+        .description('List notes in the vault')
+        .option('--changes', 'List only changes')
+        .option('--features', 'List only features')
+        .option('--json', 'Output result as JSON')
+        .action(async (opts) => {
+        try {
+            const vaultPath = discoverVaultPath();
+            const { buildIndex } = await import('../../core/index/index.js');
+            const index = await buildIndex(vaultPath);
+            const filterType = opts.changes ? 'changes' : opts.features ? 'features' : 'all';
+            const result = listNotes(index, filterType);
+            if (opts.json) {
+                console.log(JSON.stringify(result, null, 2));
+            }
+            else {
+                if (result.items.length === 0) {
+                    console.log('No notes found.');
+                }
+                else {
+                    for (const item of result.items) {
+                        const extra = item.taskProgress
+                            ? ` [${item.taskProgress.completed}/${item.taskProgress.total}]`
+                            : '';
+                        console.log(`  ${item.status.padEnd(12)} ${item.type.padEnd(8)} ${item.title}${extra}`);
+                    }
+                }
+            }
+        }
+        catch (err) {
+            console.error(`Error: ${err.message}`);
+            process.exitCode = 1;
+        }
+    });
+}
+/**
+ * List notes from the vault index.
+ */
+export function listNotes(index, filterType) {
+    const items = [];
+    for (const record of index.records.values()) {
+        if (filterType === 'changes' && record.type !== 'change')
+            continue;
+        if (filterType === 'features' && record.type !== 'feature')
+            continue;
+        const item = {
+            id: record.id,
+            type: record.type,
+            title: record.title,
+            status: record.status,
+            path: record.path,
+        };
+        if (record.type === 'change') {
+            item.linkedFeature = record.feature ?? record.features?.[0];
+            item.taskProgress = {
+                total: record.tasks.length,
+                completed: record.tasks.filter((t) => t.done).length,
+            };
+        }
+        items.push(item);
+    }
+    // Sort by status priority then by id
+    const statusPriority = {
+        in_progress: 0,
+        planned: 1,
+        proposed: 2,
+        active: 3,
+        draft: 4,
+        applied: 5,
+        archived: 6,
+        deprecated: 7,
+    };
+    items.sort((a, b) => {
+        const ap = statusPriority[a.status] ?? 99;
+        const bp = statusPriority[b.status] ?? 99;
+        if (ap !== bp)
+            return ap - bp;
+        return a.id.localeCompare(b.id);
+    });
+    return { type: filterType, items };
+}
+//# sourceMappingURL=list.js.map

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

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

package/dist/cli/commands/migrate.d.ts

@@ -0,0 +1,6 @@
+/**
+ * CLI handler for `ows migrate`.
+ */
+import type { Command } from 'commander';
+export declare function registerMigrateCommand(program: Command): void;
+//# sourceMappingURL=migrate.d.ts.map

package/dist/cli/commands/migrate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrate.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/migrate.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIzC,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA4C7D"}

package/dist/cli/commands/migrate.js

@@ -0,0 +1,103 @@
+import { migrate, planMigration } from '../../core/migrate/migrate.js';
+export function registerMigrateCommand(program) {
+    program
+        .command('migrate [openspec-dir]')
+        .description('Migrate an existing OpenSpec project to open-wiki-spec format')
+        .option('--dry-run', 'Show what would be migrated without writing files')
+        .option('--json', 'Output result as JSON')
+        .option('--skip-archive', 'Skip migrating archived changes')
+        .action(async (openspecDir, opts) => {
+        try {
+            const options = {
+                openspecDir,
+                dryRun: opts.dryRun,
+                skipArchive: opts.skipArchive,
+                json: opts.json,
+            };
+            if (opts.dryRun) {
+                const plan = planMigration(options);
+                if (opts.json) {
+                    console.log(JSON.stringify(plan, null, 2));
+                }
+                else {
+                    printPlan(plan);
+                }
+            }
+            else {
+                const result = await migrate(options);
+                if (opts.json) {
+                    console.log(JSON.stringify(result, null, 2));
+                }
+                else {
+                    printResult(result);
+                }
+            }
+        }
+        catch (err) {
+            if (opts.json) {
+                console.log(JSON.stringify({ error: err.message }));
+            }
+            else {
+                console.error(`Error: ${err.message}`);
+            }
+            process.exitCode = 1;
+        }
+    });
+}
+function printPlan(plan) {
+    console.log('Migration Plan (dry run)');
+    console.log('========================');
+    console.log(`  Source: ${plan.openspecPath}`);
+    console.log(`  Target: ${plan.wikiPath}`);
+    console.log();
+    for (const step of plan.steps) {
+        console.log(`Step: ${step.name}`);
+        console.log(`  ${step.description}`);
+        if (step.outputs.length > 0) {
+            console.log(`  Files to create:`);
+            for (const output of step.outputs) {
+                console.log(`    - ${output.targetPath} (from ${output.sourceDescription})`);
+            }
+        }
+        if (step.warnings.length > 0) {
+            for (const w of step.warnings) {
+                console.log(`  Warning: ${w}`);
+            }
+        }
+        console.log();
+    }
+    console.log(`Total: ${plan.totalFiles} files, ${plan.totalWarnings} warnings`);
+}
+function printResult(result) {
+    console.log('Migration Complete');
+    console.log('==================');
+    if (result.filesWritten.length > 0) {
+        console.log(`  Files written: ${result.filesWritten.length}`);
+        for (const f of result.filesWritten) {
+            console.log(`    + ${f}`);
+        }
+    }
+    if (result.filesSkipped.length > 0) {
+        console.log(`  Files skipped (already exist): ${result.filesSkipped.length}`);
+        for (const f of result.filesSkipped) {
+            console.log(`    ~ ${f}`);
+        }
+    }
+    if (result.errors.length > 0) {
+        console.log(`  Errors: ${result.errors.length}`);
+        for (const e of result.errors) {
+            console.log(`    ! ${e}`);
+        }
+    }
+    // Print warnings from plan
+    const totalWarnings = result.plan.steps.reduce((sum, s) => sum + s.warnings.length, 0);
+    if (totalWarnings > 0) {
+        console.log(`  Warnings: ${totalWarnings}`);
+        for (const step of result.plan.steps) {
+            for (const w of step.warnings) {
+                console.log(`    ? ${w}`);
+            }
+        }
+    }
+}
+//# sourceMappingURL=migrate.js.map

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

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

package/dist/cli/commands/propose.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from 'commander';
+export declare function registerProposeCommand(program: Command): void;
+//# sourceMappingURL=propose.d.ts.map

package/dist/cli/commands/propose.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"propose.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/propose.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIzC,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA4D7D"}

package/dist/cli/commands/propose.js

@@ -0,0 +1,64 @@
+/**
+ * CLI handler for `ows propose`.
+ * Thin wrapper around the propose workflow.
+ */
+import * as path from 'node:path';
+import { discoverVaultPath } from '../vault-discovery.js';
+import { appendLogEntry } from '../init/meta-files.js';
+export function registerProposeCommand(program) {
+    program
+        .command('propose <description>')
+        .description('Propose a new change to the codebase wiki')
+        .option('--json', 'Output result as JSON')
+        .option('--dry-run', 'Show what would happen without writing files')
+        .option('--force-classification <type>', 'Override classification (existing_change, existing_feature, new_feature)')
+        .action(async (description, opts) => {
+        try {
+            const vaultPath = discoverVaultPath();
+            const { buildIndex } = await import('../../core/index/index.js');
+            const { retrieve } = await import('../../core/retrieval/index.js');
+            const { analyzeSequencing } = await import('../../core/sequencing/index.js');
+            const { parseNote } = await import('../../core/parser/index.js');
+            const { propose } = await import('../../core/workflow/propose/index.js');
+            const { writeFileSync, readFileSync } = await import('node:fs');
+            const validClassifications = ['existing_change', 'existing_feature', 'new_feature'];
+            let forceClassification;
+            if (opts.forceClassification) {
+                if (!validClassifications.includes(opts.forceClassification)) {
+                    throw new Error(`Invalid --force-classification value: "${opts.forceClassification}". ` +
+                        `Must be one of: ${validClassifications.join(', ')}`);
+                }
+                forceClassification = opts.forceClassification;
+            }
+            const result = await propose(description, {
+                vaultRoot: vaultPath,
+                dryRun: opts.dryRun,
+                forceClassification,
+            }, {
+                buildIndex: (root) => buildIndex(root),
+                retrieve,
+                analyzeSequencing,
+                parseNote,
+                writeFile: (p, c) => writeFileSync(p, c, 'utf-8'),
+                readFile: (p) => readFileSync(p, 'utf-8'),
+            });
+            if (result.target_change) {
+                appendLogEntry(path.join(vaultPath, 'wiki'), 'propose', result.target_change.id);
+            }
+            if (opts.json) {
+                console.log(JSON.stringify(result, null, 2));
+            }
+            else {
+                console.log('Propose workflow completed.');
+                if (result.target_change) {
+                    console.log(`  Created change: ${result.target_change.id}`);
+                }
+            }
+        }
+        catch (err) {
+            console.error(`Error: ${err.message}`);
+            process.exitCode = 1;
+        }
+    });
+}
+//# sourceMappingURL=propose.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"propose.js","sourceRoot":"","sources":["../../../src/cli/commands/propose.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAElC,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD,MAAM,UAAU,sBAAsB,CAAC,OAAgB;IACrD,OAAO;SACJ,OAAO,CAAC,uBAAuB,CAAC;SAChC,WAAW,CAAC,2CAA2C,CAAC;SACxD,MAAM,CAAC,QAAQ,EAAE,uBAAuB,CAAC;SACzC,MAAM,CAAC,WAAW,EAAE,8CAA8C,CAAC;SACnE,MAAM,CAAC,+BAA+B,EAAE,0EAA0E,CAAC;SACnH,MAAM,CAAC,KAAK,EAAE,WAAmB,EAAE,IAAwE,EAAE,EAAE;QAC9G,IAAI,CAAC;YACH,MAAM,SAAS,GAAG,iBAAiB,EAAE,CAAC;YACtC,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,MAAM,CAAC,2BAA2B,CAAC,CAAC;YACjE,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,MAAM,CAAC,+BAA+B,CAAC,CAAC;YACnE,MAAM,EAAE,iBAAiB,EAAE,GAAG,MAAM,MAAM,CAAC,gCAAgC,CAAC,CAAC;YAC7E,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,MAAM,CAAC,4BAA4B,CAAC,CAAC;YACjE,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,MAAM,CAAC,sCAAsC,CAAC,CAAC;YACzE,MAAM,EAAE,aAAa,EAAE,YAAY,EAAE,GAAG,MAAM,MAAM,CAAC,SAAS,CAAC,CAAC;YAEhE,MAAM,oBAAoB,GAAG,CAAC,iBAAiB,EAAE,kBAAkB,EAAE,aAAa,CAAU,CAAC;YAE7F,IAAI,mBAAoD,CAAC;YACzD,IAAI,IAAI,CAAC,mBAAmB,EAAE,CAAC;gBAC7B,IAAI,CAAC,oBAAoB,CAAC,QAAQ,CAAC,IAAI,CAAC,mBAA0C,CAAC,EAAE,CAAC;oBACpF,MAAM,IAAI,KAAK,CACb,0CAA0C,IAAI,CAAC,mBAAmB,KAAK;wBACvE,mBAAmB,oBAAoB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACrD,CAAC;gBACJ,CAAC;gBACD,mBAAmB,GAAG,IAAI,CAAC,mBAA0C,CAAC;YACxE,CAAC;YAED,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,WAAW,EAAE;gBACxC,SAAS,EAAE,SAAS;gBACpB,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,mBAAmB;aACpB,EAAE;gBACD,UAAU,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC;gBACtC,QAAQ;gBACR,iBAAiB;gBACjB,SAAS;gBACT,SAAS,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,aAAa,CAAC,CAAC,EAAE,CAAC,EAAE,OAAO,CAAC;gBACjD,QAAQ,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,YAAY,CAAC,CAAC,EAAE,OAAO,CAAC;aAC1C,CAAC,CAAC;YAEH,IAAI,MAAM,CAAC,aAAa,EAAE,CAAC;gBACzB,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,MAAM,CAAC,EAAE,SAAS,EAAE,MAAM,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC;YACnF,CAAC;YAED,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;gBACd,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;YAC/C,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,GAAG,CAAC,6BAA6B,CAAC,CAAC;gBAC3C,IAAI,MAAM,CAAC,aAAa,EAAE,CAAC;oBACzB,OAAO,CAAC,GAAG,CAAC,qBAAqB,MAAM,CAAC,aAAa,CAAC,EAAE,EAAE,CAAC,CAAC;gBAC9D,CAAC;YACH,CAAC;QACH,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,KAAK,CAAC,UAAW,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC;YAClD,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;QACvB,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/cli/commands/query.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from 'commander';
+export declare function registerQueryCommand(program: Command): void;
+//# sourceMappingURL=query.d.ts.map

package/dist/cli/commands/query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/query.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKzC,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAoD3D"}

package/dist/cli/commands/query.js

@@ -0,0 +1,62 @@
+/**
+ * CLI handler for `ows query`.
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { discoverVaultPath } from '../vault-discovery.js';
+import { queryWorkflow } from '../../core/workflow/query/query.js';
+import { createQueryNote } from '../../core/workflow/query/query-note-creator.js';
+export function registerQueryCommand(program) {
+    program
+        .command('query <question>')
+        .description('Search the vault graph and optionally create a Query note')
+        .option('--json', 'Output result as JSON')
+        .option('--save', 'Save the Query note to the vault if assessment recommends it')
+        .action(async (question, opts) => {
+        try {
+            const vaultPath = discoverVaultPath();
+            const { buildIndex } = await import('../../core/index/index.js');
+            const index = await buildIndex(vaultPath);
+            const result = queryWorkflow({ question }, index);
+            if (opts.json) {
+                console.log(JSON.stringify(result, null, 2));
+            }
+            else {
+                console.log(result.contextDocument);
+                console.log();
+                if (result.assessment.shouldCreate) {
+                    console.log(`Recommendation: Create a Query note (confidence: ${result.assessment.confidence})`);
+                }
+                else {
+                    console.log(`Recommendation: No Query note needed (confidence: ${result.assessment.confidence})`);
+                }
+                for (const reason of result.assessment.reasons) {
+                    console.log(`  - ${reason}`);
+                }
+            }
+            // Save query note if --save and assessment recommends it
+            if (opts.save && result.assessment.shouldCreate) {
+                const note = createQueryNote({
+                    question,
+                    title: question.slice(0, 80),
+                    context: result.contextDocument,
+                    findings: result.searchResult.candidates.map((c) => `- ${c.title} (${c.id})`).join('\n'),
+                    conclusion: result.assessment.reasons.join('; '),
+                    consultedNotes: result.searchResult.candidates.map((c) => c.id),
+                });
+                const notePath = path.join(vaultPath, note.path);
+                const noteDir = path.dirname(notePath);
+                if (!fs.existsSync(noteDir)) {
+                    fs.mkdirSync(noteDir, { recursive: true });
+                }
+                fs.writeFileSync(notePath, note.content, 'utf-8');
+                console.log(`\nQuery note saved: ${note.path}`);
+            }
+        }
+        catch (err) {
+            console.error(`Error: ${err.message}`);
+            process.exitCode = 1;
+        }
+    });
+}
+//# sourceMappingURL=query.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"query.js","sourceRoot":"","sources":["../../../src/cli/commands/query.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAElC,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,oCAAoC,CAAC;AACnE,OAAO,EAAE,eAAe,EAAE,MAAM,iDAAiD,CAAC;AAElF,MAAM,UAAU,oBAAoB,CAAC,OAAgB;IACnD,OAAO;SACJ,OAAO,CAAC,kBAAkB,CAAC;SAC3B,WAAW,CAAC,2DAA2D,CAAC;SACxE,MAAM,CAAC,QAAQ,EAAE,uBAAuB,CAAC;SACzC,MAAM,CAAC,QAAQ,EAAE,8DAA8D,CAAC;SAChF,MAAM,CAAC,KAAK,EAAE,QAAgB,EAAE,IAAwC,EAAE,EAAE;QAC3E,IAAI,CAAC;YACH,MAAM,SAAS,GAAG,iBAAiB,EAAE,CAAC;YACtC,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,MAAM,CAAC,2BAA2B,CAAC,CAAC;YACjE,MAAM,KAAK,GAAG,MAAM,UAAU,CAAC,SAAS,CAAC,CAAC;YAE1C,MAAM,MAAM,GAAG,aAAa,CAAC,EAAE,QAAQ,EAAE,EAAE,KAAK,CAAC,CAAC;YAElD,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;gBACd,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;YAC/C,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC;gBACpC,OAAO,CAAC,GAAG,EAAE,CAAC;gBACd,IAAI,MAAM,CAAC,UAAU,CAAC,YAAY,EAAE,CAAC;oBACnC,OAAO,CAAC,GAAG,CAAC,oDAAoD,MAAM,CAAC,UAAU,CAAC,UAAU,GAAG,CAAC,CAAC;gBACnG,CAAC;qBAAM,CAAC;oBACN,OAAO,CAAC,GAAG,CAAC,qDAAqD,MAAM,CAAC,UAAU,CAAC,UAAU,GAAG,CAAC,CAAC;gBACpG,CAAC;gBACD,KAAK,MAAM,MAAM,IAAI,MAAM,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC;oBAC/C,OAAO,CAAC,GAAG,CAAC,OAAO,MAAM,EAAE,CAAC,CAAC;gBAC/B,CAAC;YACH,CAAC;YAED,yDAAyD;YACzD,IAAI,IAAI,CAAC,IAAI,IAAI,MAAM,CAAC,UAAU,CAAC,YAAY,EAAE,CAAC;gBAChD,MAAM,IAAI,GAAG,eAAe,CAAC;oBAC3B,QAAQ;oBACR,KAAK,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;oBAC5B,OAAO,EAAE,MAAM,CAAC,eAAe;oBAC/B,QAAQ,EAAE,MAAM,CAAC,YAAY,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;oBACxF,UAAU,EAAE,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC;oBAChD,cAAc,EAAE,MAAM,CAAC,YAAY,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;iBAChE,CAAC,CAAC;gBACH,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;gBACjD,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;gBACvC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;oBAC5B,EAAE,CAAC,SAAS,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;gBAC7C,CAAC;gBACD,EAAE,CAAC,aAAa,CAAC,QAAQ,EAAE,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;gBAClD,OAAO,CAAC,GAAG,CAAC,uBAAuB,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;YAClD,CAAC;QACH,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,KAAK,CAAC,UAAW,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC;YAClD,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;QACvB,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/cli/commands/status.d.ts

@@ -0,0 +1,30 @@
+/**
+ * CLI handler for `ows status`.
+ */
+import type { Command } from 'commander';
+import type { VaultIndex } from '../../types/index.js';
+import type { NextAction } from '../../types/next-action.js';
+export interface StatusResult {
+    changeId: string;
+    status: string;
+    features: string[];
+    sectionCompleteness: {
+        why: boolean;
+        deltaSummary: boolean;
+        tasks: boolean;
+        validation: boolean;
+        designApproach?: boolean;
+    };
+    taskProgress: {
+        total: number;
+        completed: number;
+    };
+    nextAction: NextAction;
+    blockedBy: string[];
+}
+export declare function registerStatusCommand(program: Command): void;
+/**
+ * Get the status of a change, including section completeness and next action.
+ */
+export declare function getChangeStatus(changeId: string, index: VaultIndex): StatusResult;
+//# sourceMappingURL=status.d.ts.map

package/dist/cli/commands/status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/status.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,KAAK,EAAE,UAAU,EAAe,MAAM,sBAAsB,CAAC;AACpE,OAAO,KAAK,EAAE,UAAU,EAAkB,MAAM,4BAA4B,CAAC;AAG7E,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,mBAAmB,EAAE;QACnB,GAAG,EAAE,OAAO,CAAC;QACb,YAAY,EAAE,OAAO,CAAC;QACtB,KAAK,EAAE,OAAO,CAAC;QACf,UAAU,EAAE,OAAO,CAAC;QACpB,cAAc,CAAC,EAAE,OAAO,CAAC;KAC1B,CAAC;IACF,YAAY,EAAE;QACZ,KAAK,EAAE,MAAM,CAAC;QACd,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,UAAU,EAAE,UAAU,CAAC;IACvB,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAuB5D;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,YAAY,CA8CjF"}

package/dist/cli/commands/status.js

@@ -0,0 +1,144 @@
+import { discoverVaultPath } from '../vault-discovery.js';
+export function registerStatusCommand(program) {
+    program
+        .command('status <changeId>')
+        .description('Show current state of a Change')
+        .option('--json', 'Output result as JSON')
+        .action(async (changeId, opts) => {
+        try {
+            const vaultPath = discoverVaultPath();
+            const { buildIndex } = await import('../../core/index/index.js');
+            const index = await buildIndex(vaultPath);
+            const result = getChangeStatus(changeId, index);
+            if (opts.json) {
+                console.log(JSON.stringify(result, null, 2));
+            }
+            else {
+                console.log(formatStatusHuman(result));
+            }
+        }
+        catch (err) {
+            console.error(`Error: ${err.message}`);
+            process.exitCode = 1;
+        }
+    });
+}
+/**
+ * Get the status of a change, including section completeness and next action.
+ */
+export function getChangeStatus(changeId, index) {
+    const change = index.records.get(changeId);
+    if (!change) {
+        throw new Error(`Change "${changeId}" not found in the vault index.`);
+    }
+    if (change.type !== 'change') {
+        throw new Error(`"${changeId}" is a ${change.type}, not a change.`);
+    }
+    const features = [];
+    if (change.feature)
+        features.push(change.feature);
+    if (change.features)
+        features.push(...change.features);
+    const sectionCompleteness = {
+        why: change.headings.includes('Why'),
+        deltaSummary: change.delta_summary.length > 0,
+        tasks: change.tasks.length > 0,
+        validation: change.headings.includes('Validation'),
+        designApproach: change.headings.includes('Design Approach') ? true : undefined,
+    };
+    const taskProgress = {
+        total: change.tasks.length,
+        completed: change.tasks.filter((t) => t.done).length,
+    };
+    // Check blocked dependencies
+    const blockedBy = [];
+    for (const dep of change.depends_on) {
+        const depRecord = index.records.get(dep);
+        if (depRecord && depRecord.status !== 'applied') {
+            blockedBy.push(dep);
+        }
+    }
+    const nextAction = computeNextAction(change, sectionCompleteness, taskProgress, blockedBy);
+    return {
+        changeId,
+        status: change.status,
+        features,
+        sectionCompleteness,
+        taskProgress,
+        nextAction,
+        blockedBy,
+    };
+}
+/**
+ * Compute the next recommended action for a change.
+ * Based on overview.md section 15 lifecycle.
+ */
+function computeNextAction(change, sectionCompleteness, taskProgress, blockedBy) {
+    // Blocked check
+    if (blockedBy.length > 0) {
+        return {
+            action: 'blocked',
+            reason: `Blocked by: ${blockedBy.join(', ')}`,
+            blockers: blockedBy,
+        };
+    }
+    switch (change.status) {
+        case 'proposed': {
+            // Check if ready to transition to planned
+            if (!sectionCompleteness.why)
+                return { action: 'fill_section', target: 'Why' };
+            if (!sectionCompleteness.deltaSummary)
+                return { action: 'fill_section', target: 'Delta Summary' };
+            if (!sectionCompleteness.tasks)
+                return { action: 'fill_section', target: 'Tasks' };
+            if (!sectionCompleteness.validation)
+                return { action: 'fill_section', target: 'Validation' };
+            return { action: 'transition', to: 'planned' };
+        }
+        case 'planned': {
+            return { action: 'start_implementation' };
+        }
+        case 'in_progress': {
+            if (taskProgress.completed < taskProgress.total) {
+                const nextTask = change.tasks.find((t) => !t.done);
+                return { action: 'continue_task', target: nextTask?.text };
+            }
+            return { action: 'ready_to_apply' };
+        }
+        case 'applied': {
+            return { action: 'verify_then_archive' };
+        }
+        default:
+            return { action: 'fill_section', target: 'Why' };
+    }
+}
+function formatStatusHuman(result) {
+    const lines = [];
+    lines.push(`Change: ${result.changeId}`);
+    lines.push(`Status: ${result.status}`);
+    lines.push(`Features: ${result.features.join(', ') || 'none'}`);
+    lines.push('');
+    lines.push('Section Completeness:');
+    lines.push(`  Why: ${result.sectionCompleteness.why ? 'yes' : 'NO'}`);
+    lines.push(`  Delta Summary: ${result.sectionCompleteness.deltaSummary ? 'yes' : 'NO'}`);
+    lines.push(`  Tasks: ${result.sectionCompleteness.tasks ? 'yes' : 'NO'}`);
+    lines.push(`  Validation: ${result.sectionCompleteness.validation ? 'yes' : 'NO'}`);
+    if (result.sectionCompleteness.designApproach !== undefined) {
+        lines.push(`  Design Approach: ${result.sectionCompleteness.designApproach ? 'yes' : 'NO'}`);
+    }
+    lines.push('');
+    lines.push(`Task Progress: ${result.taskProgress.completed}/${result.taskProgress.total}`);
+    lines.push('');
+    lines.push(`Next Action: ${result.nextAction.action}`);
+    if (result.nextAction.target)
+        lines.push(`  Target: ${result.nextAction.target}`);
+    if (result.nextAction.to)
+        lines.push(`  Transition to: ${result.nextAction.to}`);
+    if (result.nextAction.reason)
+        lines.push(`  Reason: ${result.nextAction.reason}`);
+    if (result.blockedBy.length > 0) {
+        lines.push(`  Blocked by: ${result.blockedBy.join(', ')}`);
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=status.js.map

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

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

package/dist/cli/commands/verify.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from 'commander';
+export declare function registerVerifyCommand(program: Command): void;
+//# sourceMappingURL=verify.d.ts.map