@cavelang/cli 0.27.3 → 0.29.0

package/dist/src/doctor.js

@@ -0,0 +1,284 @@
+/** Read-only installation, runtime, and store diagnostics for `cave doctor`. */
+import { existsSync, readFileSync, statSync } from 'node:fs';
+import { createRequire } from 'node:module';
+import { dirname, join, parse } from 'node:path';
+import { spawnSync } from 'node:child_process';
+import { parseArgs } from 'node:util';
+import { Version } from '@cavelang/core';
+import { Schema, defaultDbPath } from '@cavelang/store';
+import { nodeSqliteAdapter } from '@cavelang/store/adapter/node';
+const requiredNode = '22.18.0';
+const versionParts = (value) => {
+    const match = /^(\d+)\.(\d+)\.(\d+)/.exec(value);
+    return match === null ? undefined : [Number(match[1]), Number(match[2]), Number(match[3])];
+};
+const numericVersion = (value) => {
+    const parts = versionParts(value);
+    return parts === undefined ? undefined : parts.join('.');
+};
+const atLeast = (actual, required) => {
+    const a = versionParts(actual);
+    const b = versionParts(required);
+    if (a === undefined || b === undefined)
+        return false;
+    for (let index = 0; index < 3; index += 1) {
+        if (a[index] !== b[index])
+            return a[index] > b[index];
+    }
+    return true;
+};
+const check = (id, status, summary, remediation) => ({ id, status, summary, ...remediation === undefined ? {} : { remediation } });
+const nodeCheck = () => atLeast(process.versions.node, requiredNode) ?
+    check('runtime.node', 'pass', `Node ${process.versions.node} satisfies >=${requiredNode}`) :
+    check('runtime.node', 'fail', `Node ${process.versions.node} is unsupported`, `Install Node ${requiredNode} or newer and rerun cave doctor.`);
+const sqliteCheck = () => {
+    let db;
+    try {
+        db = nodeSqliteAdapter.open(':memory:');
+        db.exec('PRAGMA foreign_keys = ON');
+        const sqlite = db.prepare('SELECT sqlite_version() AS version').get()?.['version'];
+        const json = db.prepare(`SELECT json_valid('{}') AS available`).get()?.['available'];
+        const foreignKeys = db.prepare('PRAGMA foreign_keys').get()?.['foreign_keys'];
+        db.exec('CREATE VIRTUAL TABLE doctor_fts USING fts5(value)');
+        db.exec('DROP TABLE doctor_fts');
+        if (typeof sqlite !== 'string' || json !== 1 || foreignKeys !== 1 ||
+            nodeSqliteAdapter.capabilities.loadExtension === undefined) {
+            throw new Error('capability unavailable');
+        }
+        return check('runtime.sqlite', 'pass', `SQLite ${sqlite} supports FTS5, JSON functions, foreign keys, and extension loading`);
+    }
+    catch {
+        return check('runtime.sqlite', 'fail', 'The Node SQLite runtime lacks a required capability', `Use an official Node ${requiredNode}+ build with SQLite FTS5 and JSON support.`);
+    }
+    finally {
+        db?.close();
+    }
+};
+const grammarCheck = () => {
+    try {
+        const fromHighlight = createRequire(import.meta.resolve('@cavelang/highlight'));
+        const assets = [
+            fromHighlight.resolve('@cavelang/tree-sitter-cave/wasm'),
+            fromHighlight.resolve('@cavelang/tree-sitter-cave/highlights')
+        ];
+        if (assets.some(asset => !statSync(asset).isFile() || statSync(asset).size === 0)) {
+            throw new Error('asset unavailable');
+        }
+        return check('package.grammar', 'pass', 'Grammar WASM and highlight query are installed');
+    }
+    catch {
+        return check('package.grammar', 'fail', 'Grammar assets are missing from the installed package layout', 'Reinstall @cavelang/cli without omitting its production dependencies.');
+    }
+};
+const workspaceFrom = (start) => {
+    let directory = start;
+    while (true) {
+        if (existsSync(join(directory, 'pnpm-workspace.yaml'))) {
+            try {
+                const manifest = JSON.parse(readFileSync(join(directory, 'package.json'), 'utf8'));
+                if (typeof manifest.packageManager === 'string' && manifest.packageManager.startsWith('pnpm@')) {
+                    return { packageManager: manifest.packageManager };
+                }
+            }
+            catch {
+                return { packageManager: 'pnpm' };
+            }
+            return { packageManager: 'pnpm' };
+        }
+        const parent = dirname(directory);
+        if (parent === directory || directory === parse(directory).root)
+            return undefined;
+        directory = parent;
+    }
+};
+const pnpmCheck = () => {
+    const workspace = workspaceFrom(process.cwd());
+    if (workspace === undefined) {
+        return check('workspace.pnpm', 'pass', 'pnpm is not required for this installed CLI');
+    }
+    const result = spawnSync('pnpm', ['--version'], {
+        encoding: 'utf8',
+        timeout: 3_000,
+        stdio: ['ignore', 'pipe', 'ignore']
+    });
+    const actual = result.status === 0 ? numericVersion(result.stdout.trim()) : undefined;
+    const pinned = workspace.packageManager.startsWith('pnpm@');
+    const required = pinned ? numericVersion(workspace.packageManager.slice('pnpm@'.length)) : undefined;
+    if (actual === undefined) {
+        return check('workspace.pnpm', 'fail', 'This workspace requires pnpm, but pnpm is unavailable', 'Enable Corepack or install the pnpm version declared by the workspace.');
+    }
+    if (required !== undefined && !atLeast(actual, required)) {
+        return check('workspace.pnpm', 'fail', `pnpm ${actual} is older than the workspace requirement`, `Enable Corepack or install pnpm ${required}.`);
+    }
+    return check('workspace.pnpm', 'pass', `pnpm ${actual} satisfies the workspace requirement`);
+};
+const inspectDatabase = (path, source) => {
+    const memory = path === ':memory:';
+    const exists = memory || existsSync(path);
+    const base = { source, kind: memory ? 'memory' : 'file', exists };
+    if (!exists) {
+        return {
+            configuration: base,
+            checks: [check('store.database', 'warn', 'The configured database does not exist yet', 'Run cave add to create it, or pass --db for an existing store.')]
+        };
+    }
+    let db;
+    let observed = base;
+    try {
+        db = nodeSqliteAdapter.open(path, { readOnly: true });
+        const version = db.prepare('PRAGMA user_version').get()?.['user_version'];
+        if (typeof version !== 'number')
+            throw new Error('invalid version');
+        const caveObjects = db.prepare(`SELECT count(*) AS count FROM sqlite_schema WHERE name LIKE 'cave_%' OR name LIKE 'idx_cave_%'`).get()?.['count'];
+        const configuration = { ...base, schemaVersion: version };
+        observed = configuration;
+        if (version > Schema.currentVersion) {
+            return {
+                configuration,
+                checks: [check('store.database', 'fail', `Database schema ${version} is newer than supported schema ${Schema.currentVersion}`, 'Upgrade CAVE before opening this database.')]
+            };
+        }
+        if (version === 0 && caveObjects === 0) {
+            return {
+                configuration,
+                checks: [check('store.database', 'warn', 'The database is readable but is not initialized as a CAVE store', 'Run cave add to initialize it; cave doctor made no changes.')]
+            };
+        }
+        if (version < Schema.currentVersion) {
+            return {
+                configuration,
+                checks: [check('store.database', 'warn', `Database schema ${version} needs migration to schema ${Schema.currentVersion}`, 'Back up the database, then open it with a normal cave command to migrate it.')]
+            };
+        }
+        Schema.validate(db, version);
+        const integrity = db.prepare('PRAGMA integrity_check').all();
+        if (integrity.length !== 1 || integrity[0]?.['integrity_check'] !== 'ok') {
+            return {
+                configuration,
+                checks: [check('store.integrity', 'fail', 'SQLite integrity checking failed', 'Restore a verified backup or recover the database with SQLite tooling.')]
+            };
+        }
+        const foreignKeys = db.prepare('PRAGMA foreign_key_check').all();
+        if (foreignKeys.length > 0) {
+            return {
+                configuration,
+                checks: [check('store.integrity', 'fail', 'The store contains broken foreign-key references', 'Restore a verified backup or repair the affected database rows.')]
+            };
+        }
+        const claims = db.prepare('SELECT count(*) AS count FROM cave_claim').get()?.['count'];
+        if (typeof claims !== 'number')
+            throw new Error('invalid count');
+        return {
+            configuration: { ...configuration, claims },
+            checks: [
+                check('store.database', 'pass', `CAVE schema ${version} is compatible (${claims} claim(s))`),
+                check('store.integrity', 'pass', 'SQLite integrity and foreign-key checks passed')
+            ]
+        };
+    }
+    catch {
+        return {
+            configuration: observed,
+            checks: [check('store.database', 'fail', 'The configured database is unreadable or has an incompatible schema', 'Check file permissions, restore a verified backup, or pass --db for another store.')]
+        };
+    }
+    finally {
+        db?.close();
+    }
+};
+const inspectHooks = (path) => {
+    if (path === undefined) {
+        return {
+            configuration: { source: 'none', exists: false },
+            check: check('config.hooks', 'pass', 'No optional hooks file was configured')
+        };
+    }
+    const configuration = { source: 'flag', exists: existsSync(path) };
+    if (!configuration.exists) {
+        return {
+            configuration,
+            check: check('config.hooks', 'fail', 'The configured hooks file does not exist', 'Create a JSON object of hook names to shell command strings, or omit --hooks.')
+        };
+    }
+    try {
+        const parsed = JSON.parse(readFileSync(path, 'utf8'));
+        if (typeof parsed !== 'object' || parsed === null || Array.isArray(parsed))
+            throw new Error('invalid');
+        const entries = Object.entries(parsed);
+        if (entries.some(([name, command]) => name.trim() === '' || typeof command !== 'string')) {
+            throw new Error('invalid');
+        }
+        return {
+            configuration: { ...configuration, entries: entries.length },
+            check: check('config.hooks', 'pass', `Hooks configuration is valid (${entries.length} entr${entries.length === 1 ? 'y' : 'ies'})`)
+        };
+    }
+    catch {
+        return {
+            configuration,
+            check: check('config.hooks', 'fail', 'The configured hooks file is unreadable or malformed', 'Use a JSON object whose values are shell command strings.')
+        };
+    }
+};
+export const diagnose = (options = {}) => {
+    const databasePath = options.db ?? defaultDbPath();
+    const databaseSource = options.db !== undefined ? 'flag' :
+        process.env['CAVE_DB'] !== undefined ? 'environment' : 'default';
+    const database = inspectDatabase(databasePath, databaseSource);
+    const hooks = inspectHooks(options.hooks);
+    const checks = [
+        nodeCheck(),
+        sqliteCheck(),
+        grammarCheck(),
+        pnpmCheck(),
+        ...database.checks,
+        hooks.check
+    ];
+    return {
+        format: 'cave.doctor',
+        version: 1,
+        ok: checks.every(entry => entry.status !== 'fail'),
+        caveVersion: Version.current(),
+        runtime: { node: process.versions.node, platform: process.platform, arch: process.arch },
+        configuration: { database: database.configuration, hooks: hooks.configuration },
+        checks
+    };
+};
+const render = (report) => {
+    const lines = [`cave doctor ${report.caveVersion}`];
+    for (const entry of report.checks) {
+        lines.push(`${entry.status.toUpperCase().padEnd(4)} ${entry.summary}`);
+        if (entry.remediation !== undefined)
+            lines.push(`     ${entry.remediation}`);
+    }
+    const failures = report.checks.filter(entry => entry.status === 'fail').length;
+    const warnings = report.checks.filter(entry => entry.status === 'warn').length;
+    lines.push(report.ok ?
+        `result: ready${warnings === 0 ? '' : ` with ${warnings} warning(s)`}` :
+        `result: ${failures} problem(s), ${warnings} warning(s)`);
+    return `${lines.join('\n')}\n`;
+};
+export const doctorCommand = (argv) => {
+    const { values, positionals } = parseArgs({
+        args: [...argv],
+        options: {
+            db: { type: 'string' },
+            hooks: { type: 'string' },
+            json: { type: 'boolean' }
+        },
+        allowPositionals: true
+    });
+    if (positionals.length > 0) {
+        return { code: 2, out: '', err: 'cave doctor: unexpected positional arguments\n' };
+    }
+    const report = diagnose({
+        ...values.db === undefined ? {} : { db: values.db },
+        ...values.hooks === undefined ? {} : { hooks: values.hooks }
+    });
+    return {
+        code: report.ok ? 0 : 1,
+        out: values.json === true ? `${JSON.stringify(report, undefined, 2)}\n` : render(report),
+        err: ''
+    };
+};
+//# sourceMappingURL=doctor.js.map

package/dist/src/doctor.js.map

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

package/dist/src/eval.d.ts

@@ -0,0 +1,3 @@
+/** Compatibility subpath for the evaluation tooling. */
+export * from '@cavelang/cli/eval';
+//# sourceMappingURL=eval.d.ts.map

package/dist/src/eval.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"eval.d.ts","sourceRoot":"","sources":["../../src/eval.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,cAAc,gBAAgB,CAAA"}

package/dist/src/eval.js

@@ -0,0 +1,3 @@
+/** Compatibility subpath for the evaluation tooling. */
+export * from '@cavelang/cli/eval';
+//# sourceMappingURL=eval.js.map

package/dist/src/eval.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"eval.js","sourceRoot":"","sources":["../../src/eval.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,cAAc,gBAAgB,CAAA"}

package/dist/src/index.d.ts

@@ -1,7 +1,14 @@
 /**
  * `@cavelang/cli` — the `cave` command (parse / add / query / resolve / derive / act / check / suggest-alias / sync / export / report / reconstruct / demo).
- * Programmatic access to the same implementations lives here.
+ * Programmatic access to the same implementations lives here; `dispatch`
+ * and `runCli` expose the shared awaited command lifecycle.
  */
-export { actCommand, addCommand, cave, checkCommand, commandHelp, demoCommand, deriveCommand, exportCommand, helpCommand, highlightCommand, importCommand, parseCommand, queryCommand, reconstructCommand, reportCommand, resolveCommand, suggestAliasCommand, syncCommand, usage, versionCommand } from './cli.ts';
+export { actCommand, addCommand, backupCommand, cave, checkCommand, commandHelp, demoCommand, deriveCommand, exportCommand, generateCommand, helpCommand, highlightCommand, importCommand, parseCommand, queryCommand, reconstructCommand, reportCommand, resolveCommand, restoreCommand, suggestAliasCommand, syncCommand, usage, versionCommand } from './cli.ts';
+export { dispatch, runCli } from './dispatch.ts';
+export type { CommandRuntime } from './dispatch.ts';
+export { commandRegistry } from './commands.ts';
+export type { CommandReference } from './commands.ts';
 export type { Output } from './cli.ts';
+export { diagnose, doctorCommand } from './doctor.ts';
+export type { DoctorCheck, DoctorOutput, DoctorReport, DoctorStatus } from './doctor.ts';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,IAAI,EAAE,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,aAAa,EAAE,aAAa,EAAE,WAAW,EAAE,gBAAgB,EAAE,aAAa,EAAE,YAAY,EAAE,YAAY,EAAE,kBAAkB,EAAE,aAAa,EAAE,cAAc,EAAE,mBAAmB,EAAE,WAAW,EAAE,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAA;AACnT,YAAY,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,aAAa,EAAE,IAAI,EAAE,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,aAAa,EAAE,aAAa,EAAE,eAAe,EAAE,WAAW,EAAE,gBAAgB,EAAE,aAAa,EAAE,YAAY,EAAE,YAAY,EAAE,kBAAkB,EAAE,aAAa,EAAE,cAAc,EAAE,cAAc,EAAE,mBAAmB,EAAE,WAAW,EAAE,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAA;AACnW,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,eAAe,CAAA;AAChD,YAAY,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAC/C,YAAY,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA;AACrD,YAAY,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA;AACtC,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AACrD,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA"}

package/dist/src/index.js

@@ -1,6 +1,10 @@
 /**
  * `@cavelang/cli` — the `cave` command (parse / add / query / resolve / derive / act / check / suggest-alias / sync / export / report / reconstruct / demo).
- * Programmatic access to the same implementations lives here.
+ * Programmatic access to the same implementations lives here; `dispatch`
+ * and `runCli` expose the shared awaited command lifecycle.
  */
-export { actCommand, addCommand, cave, checkCommand, commandHelp, demoCommand, deriveCommand, exportCommand, helpCommand, highlightCommand, importCommand, parseCommand, queryCommand, reconstructCommand, reportCommand, resolveCommand, suggestAliasCommand, syncCommand, usage, versionCommand } from "./cli.js";
+export { actCommand, addCommand, backupCommand, cave, checkCommand, commandHelp, demoCommand, deriveCommand, exportCommand, generateCommand, helpCommand, highlightCommand, importCommand, parseCommand, queryCommand, reconstructCommand, reportCommand, resolveCommand, restoreCommand, suggestAliasCommand, syncCommand, usage, versionCommand } from "./cli.js";
+export { dispatch, runCli } from "./dispatch.js";
+export { commandRegistry } from "./commands.js";
+export { diagnose, doctorCommand } from "./doctor.js";
 //# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,IAAI,EAAE,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,aAAa,EAAE,aAAa,EAAE,WAAW,EAAE,gBAAgB,EAAE,aAAa,EAAE,YAAY,EAAE,YAAY,EAAE,kBAAkB,EAAE,aAAa,EAAE,cAAc,EAAE,mBAAmB,EAAE,WAAW,EAAE,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,aAAa,EAAE,IAAI,EAAE,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,aAAa,EAAE,aAAa,EAAE,eAAe,EAAE,WAAW,EAAE,gBAAgB,EAAE,aAAa,EAAE,YAAY,EAAE,YAAY,EAAE,kBAAkB,EAAE,aAAa,EAAE,cAAc,EAAE,cAAc,EAAE,mBAAmB,EAAE,WAAW,EAAE,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAA;AACnW,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,eAAe,CAAA;AAEhD,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAG/C,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA"}

package/dist/src/ingest.d.ts

@@ -0,0 +1,3 @@
+/** Compatibility subpath for the agent ingestion tooling. */
+export * from '@cavelang/cli/ingest';
+//# sourceMappingURL=ingest.d.ts.map

package/dist/src/ingest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ingest.d.ts","sourceRoot":"","sources":["../../src/ingest.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAC7D,cAAc,kBAAkB,CAAA"}

package/dist/src/ingest.js

@@ -0,0 +1,3 @@
+/** Compatibility subpath for the agent ingestion tooling. */
+export * from '@cavelang/cli/ingest';
+//# sourceMappingURL=ingest.js.map

package/dist/src/ingest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ingest.js","sourceRoot":"","sources":["../../src/ingest.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAC7D,cAAc,kBAAkB,CAAA"}

package/dist/src/loop.d.ts

@@ -0,0 +1,3 @@
+/** Compatibility subpath for reconstruction policies. */
+export * from '@cavelang/cli/loop';
+//# sourceMappingURL=loop.d.ts.map

package/dist/src/loop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loop.d.ts","sourceRoot":"","sources":["../../src/loop.ts"],"names":[],"mappings":"AAAA,yDAAyD;AACzD,cAAc,gBAAgB,CAAA"}

package/dist/src/loop.js

@@ -0,0 +1,3 @@
+/** Compatibility subpath for reconstruction policies. */
+export * from '@cavelang/cli/loop';
+//# sourceMappingURL=loop.js.map

package/dist/src/loop.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loop.js","sourceRoot":"","sources":["../../src/loop.ts"],"names":[],"mappings":"AAAA,yDAAyD;AACzD,cAAc,gBAAgB,CAAA"}

package/dist/src/main.d.ts

@@ -1,4 +1,4 @@
 #!/usr/bin/env node
-/** `cave` binary entry point — see `cli.ts` for the command implementations. */
+/** `cave` binary entry point — one lifecycle for every command. */
 export {};
 //# sourceMappingURL=main.d.ts.map

package/dist/src/main.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../../src/main.ts"],"names":[],"mappings":";AACA,gFAAgF"}
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../../src/main.ts"],"names":[],"mappings":";AACA,mEAAmE"}

package/dist/src/main.js

@@ -1,77 +1,5 @@
 #!/usr/bin/env node
-/** `cave` binary entry point — see `cli.ts` for the command implementations. */
-import { cave, highlightCommand, reconstructCommand, suggestAliasCommand } from "./cli.js";
-const write = (code, out, err) => {
-    if (out !== '') {
-        process.stdout.write(out);
-    }
-    if (err !== '') {
-        process.stderr.write(err);
-    }
-    process.exitCode = code;
-};
-// mcp, ingest, connect, eval, automate and serve own their help text, so `cave help X` becomes `cave X --help`.
-const raw = process.argv.slice(2);
-const argv = raw[0] === 'help' && (raw[1] === 'mcp' || raw[1] === 'ingest' || raw[1] === 'connect' || raw[1] === 'eval' || raw[1] === 'automate' || raw[1] === 'serve') ?
-    [raw[1], '--help'] :
-    raw;
-if (argv[0] === 'mcp') {
-    // Long-running: serves MCP on stdio until the client disconnects.
-    const { runMcp } = await import('@cavelang/mcp');
-    process.exitCode = await runMcp(argv.slice(1));
-}
-else if (argv[0] === 'ingest') {
-    // Long-running: drives an LLM agent over batches of files.
-    const { runIngest } = await import('@cavelang/ingest');
-    process.exitCode = await runIngest(argv.slice(1));
-}
-else if (argv[0] === 'eval') {
-    // Long-running: drives an agent (and optionally a judge) over eval fixtures.
-    const { runEval } = await import('@cavelang/eval');
-    process.exitCode = await runEval(argv.slice(1));
-}
-else if (argv[0] === 'connect') {
-    // Async (URL sources fetch) and potentially long-running (--watch).
-    const { runConnect } = await import('@cavelang/connect');
-    process.exitCode = await runConnect(argv.slice(1));
-}
-else if (argv[0] === 'automate') {
-    // Async (prompt steps run a shell agent) and potentially long-running (the loop).
-    const { runAutomate } = await import('@cavelang/automate');
-    process.exitCode = await runAutomate(argv.slice(1));
-}
-else if (argv[0] === 'serve') {
-    // Long-running: the human read surface serves HTTP until interrupted.
-    const { runServe } = await import('@cavelang/view');
-    process.exitCode = await runServe(argv.slice(1));
-}
-else if (argv[0] === 'reconstruct') {
-    // Async: the LLM policy runs a shell agent once per step.
-    const { code, out, err } = await reconstructCommand(argv.slice(1));
-    write(code, out, err);
-}
-else if (argv[0] === 'suggest-alias') {
-    // Async: the optional judge runs a shell agent.
-    const { code, out, err } = await suggestAliasCommand(argv.slice(1));
-    write(code, out, err);
-}
-else if (argv[0] === 'highlight' && !argv.includes('--help') && !argv.includes('-h')) {
-    // Async (grammar WASM loads on first use); --help stays on the sync path.
-    const { code, out, err } = await highlightCommand(argv.slice(1));
-    write(code, out, err);
-}
-else {
-    const { code, out, err } = cave(argv);
-    // Canonical CAVE text going to a terminal gets syntax colors from the same
-    // grammar query `cave highlight` uses; piping or NO_COLOR keeps bytes clean.
-    const colorize = code === 0 && argv[0] === 'export' && !argv.includes('--out') &&
-        out !== '' && process.stdout.isTTY === true && process.env['NO_COLOR'] === undefined;
-    if (colorize) {
-        const { highlighter } = await import('@cavelang/highlight');
-        write(code, (await highlighter()).ansi(out), err);
-    }
-    else {
-        write(code, out, err);
-    }
-}
+/** `cave` binary entry point — one lifecycle for every command. */
+import { runCli } from "./dispatch.js";
+process.exitCode = await runCli(process.argv.slice(2));
 //# sourceMappingURL=main.js.map

package/dist/src/main.js.map

@@ -1 +1 @@
-{"version":3,"file":"main.js","sourceRoot":"","sources":["../../src/main.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"main.js","sourceRoot":"","sources":["../../src/main.ts"],"names":[],"mappings":";AACA,mEAAmE;AAEnE,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAA;AAEtC,OAAO,CAAC,QAAQ,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAA"}

package/dist/src/mcp.d.ts

@@ -0,0 +1,3 @@
+/** Compatibility subpath for the MCP server API. */
+export * from '@cavelang/cli/mcp';
+//# sourceMappingURL=mcp.d.ts.map

package/dist/src/mcp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../../src/mcp.ts"],"names":[],"mappings":"AAAA,oDAAoD;AACpD,cAAc,eAAe,CAAA"}

package/dist/src/mcp.js

@@ -0,0 +1,3 @@
+/** Compatibility subpath for the MCP server API. */
+export * from '@cavelang/cli/mcp';
+//# sourceMappingURL=mcp.js.map

package/dist/src/mcp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.js","sourceRoot":"","sources":["../../src/mcp.ts"],"names":[],"mappings":"AAAA,oDAAoD;AACpD,cAAc,eAAe,CAAA"}

package/dist/src/rules.d.ts

@@ -0,0 +1,3 @@
+/** Compatibility subpath for the internal rules engine. */
+export * from '@cavelang/cli/rules';
+//# sourceMappingURL=rules.d.ts.map

package/dist/src/rules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rules.d.ts","sourceRoot":"","sources":["../../src/rules.ts"],"names":[],"mappings":"AAAA,2DAA2D;AAC3D,cAAc,iBAAiB,CAAA"}

package/dist/src/rules.js

@@ -0,0 +1,3 @@
+/** Compatibility subpath for the internal rules engine. */
+export * from '@cavelang/cli/rules';
+//# sourceMappingURL=rules.js.map

package/dist/src/rules.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rules.js","sourceRoot":"","sources":["../../src/rules.ts"],"names":[],"mappings":"AAAA,2DAA2D;AAC3D,cAAc,iBAAiB,CAAA"}

package/dist/src/shape.d.ts

@@ -0,0 +1,3 @@
+/** Compatibility subpath for shape checking and alias suggestions. */
+export * from '@cavelang/cli/shape';
+//# sourceMappingURL=shape.d.ts.map

package/dist/src/shape.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shape.d.ts","sourceRoot":"","sources":["../../src/shape.ts"],"names":[],"mappings":"AAAA,sEAAsE;AACtE,cAAc,iBAAiB,CAAA"}

package/dist/src/shape.js

@@ -0,0 +1,3 @@
+/** Compatibility subpath for shape checking and alias suggestions. */
+export * from '@cavelang/cli/shape';
+//# sourceMappingURL=shape.js.map

package/dist/src/shape.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shape.js","sourceRoot":"","sources":["../../src/shape.ts"],"names":[],"mappings":"AAAA,sEAAsE;AACtE,cAAc,iBAAiB,CAAA"}

package/dist/src/sync.d.ts

@@ -0,0 +1,3 @@
+/** Compatibility subpath for exact store synchronization. */
+export * from '@cavelang/cli/sync';
+//# sourceMappingURL=sync.d.ts.map

package/dist/src/sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync.d.ts","sourceRoot":"","sources":["../../src/sync.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAC7D,cAAc,gBAAgB,CAAA"}

package/dist/src/sync.js

@@ -0,0 +1,3 @@
+/** Compatibility subpath for exact store synchronization. */
+export * from '@cavelang/cli/sync';
+//# sourceMappingURL=sync.js.map

package/dist/src/sync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync.js","sourceRoot":"","sources":["../../src/sync.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAC7D,cAAc,gBAAgB,CAAA"}

package/dist/src/view.d.ts

@@ -0,0 +1,3 @@
+/** Compatibility subpath for reports and read-only views. */
+export * from '@cavelang/cli/view';
+//# sourceMappingURL=view.d.ts.map

package/dist/src/view.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"view.d.ts","sourceRoot":"","sources":["../../src/view.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAC7D,cAAc,gBAAgB,CAAA"}

package/dist/src/view.js

@@ -0,0 +1,3 @@
+/** Compatibility subpath for reports and read-only views. */
+export * from '@cavelang/cli/view';
+//# sourceMappingURL=view.js.map

package/dist/src/view.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"view.js","sourceRoot":"","sources":["../../src/view.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAC7D,cAAc,gBAAgB,CAAA"}