@cleocode/cleo 2026.4.10 → 2026.4.12

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

@@ -0,0 +1,18 @@
+/**
+ * CLI upgrade command - unified project maintenance.
+ *
+ * Delegates to core upgrade logic. Handles:
+ *   - Storage migration (JSON -> SQLite, automatic)
+ *   - Schema version upgrades
+ *   - Structural repairs (checksums, missing fields)
+ *   - Global ~/.cleo data checks
+ *   - Deep diagnostics via --diagnose
+ *
+ * @task T4699
+ * @task T5243
+ * @task T131
+ * @epic T4454
+ */
+import type { ShimCommand as Command } from '../commander-shim.js';
+export declare function registerUpgradeCommand(program: Command): void;
+//# sourceMappingURL=upgrade.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"upgrade.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/upgrade.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,KAAK,EAAE,WAAW,IAAI,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAInE,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAwG7D"}

package/dist/cli/commands/upgrade.js

@@ -0,0 +1,103 @@
+/**
+ * CLI upgrade command - unified project maintenance.
+ *
+ * Delegates to core upgrade logic. Handles:
+ *   - Storage migration (JSON -> SQLite, automatic)
+ *   - Schema version upgrades
+ *   - Structural repairs (checksums, missing fields)
+ *   - Global ~/.cleo data checks
+ *   - Deep diagnostics via --diagnose
+ *
+ * @task T4699
+ * @task T5243
+ * @task T131
+ * @epic T4454
+ */
+import { CleoError, diagnoseUpgrade, formatError, runUpgrade } from '@cleocode/core/internal';
+import { createUpgradeProgress } from '../progress.js';
+import { cliOutput } from '../renderers/index.js';
+export function registerUpgradeCommand(program) {
+    program
+        .command('upgrade')
+        .description('Unified project maintenance (storage migration, schema repair, structural fixes, doc refresh)')
+        .option('--status', 'Show what needs updating without making changes')
+        .option('--dry-run', 'Preview changes without applying')
+        .option('--diagnose', 'Deep inspection of schema, columns, and migration journals')
+        .option('--include-global', 'Also check global ~/.cleo data')
+        .option('--no-auto-migrate', 'Skip automatic JSON->SQLite migration')
+        .option('--detect', 'Force re-detection of project type (ignores staleness)')
+        .option('--map-codebase', 'Run full codebase analysis and store findings to brain.db')
+        .option('--name <name>', 'Update project name in project-info and nexus registry')
+        .action(async (opts, command) => {
+        // Merge citty-parsed opts with global flags (--json, --human, etc.)
+        const globalOpts = command.optsWithGlobals ? command.optsWithGlobals() : command.opts();
+        const mergedOpts = { ...globalOpts, ...opts };
+        const isHuman = mergedOpts['human'] === true || (!!process.stdout.isTTY && mergedOpts['json'] !== true);
+        const progress = createUpgradeProgress(isHuman);
+        try {
+            // --diagnose: deep read-only inspection
+            if (mergedOpts['diagnose']) {
+                progress.start();
+                progress.step(0, 'Running deep schema/migration diagnostics');
+                const result = await diagnoseUpgrade();
+                progress.step(4, 'Diagnostics complete');
+                cliOutput(result, { command: 'upgrade', operation: 'upgrade.diagnose' });
+                if (!result.success) {
+                    progress.error(`${result.summary.errors} error(s) found`);
+                    process.exit(1);
+                }
+                progress.complete(`Diagnostics complete: ${result.summary.ok} ok, ${result.summary.warnings} warning(s), ${result.summary.errors} error(s)`);
+                return;
+            }
+            const isDryRun = !!mergedOpts['dryRun'] || !!mergedOpts['status'];
+            const includeGlobal = !!mergedOpts['includeGlobal'];
+            const autoMigrate = mergedOpts['autoMigrate'] !== false;
+            const forceDetect = !!mergedOpts['detect'];
+            const mapCodebase = !!mergedOpts['mapCodebase'];
+            const projectName = mergedOpts['name'];
+            progress.start();
+            progress.step(0, 'Analyzing current state');
+            if (includeGlobal) {
+                progress.step(1, 'Checking global ~/.cleo data');
+            }
+            else {
+                progress.step(1, 'Checking storage migration needs');
+            }
+            progress.step(2, 'Validating schemas');
+            progress.step(3, isDryRun ? 'Previewing changes' : 'Applying fixes');
+            const result = await runUpgrade({
+                dryRun: isDryRun,
+                includeGlobal,
+                autoMigrate,
+                forceDetect,
+                mapCodebase,
+                projectName,
+            });
+            progress.step(4, 'Verifying results');
+            cliOutput({
+                upToDate: result.upToDate,
+                dryRun: result.dryRun,
+                actions: result.actions,
+                applied: result.applied,
+                errors: result.errors.length > 0 ? result.errors : undefined,
+                summary: result.summary,
+                storageMigration: result.storageMigration,
+            }, { command: 'upgrade' });
+            if (!result.success) {
+                progress.error('Upgrade failed with errors');
+                process.exit(1);
+            }
+            progress.complete(isDryRun ? 'Preview complete' : 'Upgrade complete');
+        }
+        catch (err) {
+            if (err instanceof CleoError) {
+                progress.error(err.message);
+                console.error(formatError(err));
+                process.exit(err.code);
+            }
+            progress.error('Unexpected error during upgrade');
+            throw err;
+        }
+    });
+}
+//# sourceMappingURL=upgrade.js.map

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

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

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

@@ -0,0 +1,12 @@
+/**
+ * CLI validate command - check file integrity, schema compliance, checksum.
+ * Delegates to dispatch layer: check.schema.
+ * @task T4454
+ * @task T4659
+ * @task T4795
+ * @epic T4654
+ * @task T4904
+ */
+import type { ShimCommand as Command } from '../commander-shim.js';
+export declare function registerValidateCommand(program: Command): void;
+//# sourceMappingURL=validate.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/validate.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAAE,WAAW,IAAI,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAEnE,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAiB9D"}

package/dist/cli/commands/validate.js

@@ -0,0 +1,23 @@
+/**
+ * CLI validate command - check file integrity, schema compliance, checksum.
+ * Delegates to dispatch layer: check.schema.
+ * @task T4454
+ * @task T4659
+ * @task T4795
+ * @epic T4654
+ * @task T4904
+ */
+import { dispatchFromCli } from '../../dispatch/adapters/cli.js';
+export function registerValidateCommand(program) {
+    program
+        .command('validate')
+        .description('Validate task data against schema and business rules')
+        .option('--strict', 'Treat warnings as errors')
+        .action(async (opts) => {
+        await dispatchFromCli('query', 'check', 'schema', {
+            type: 'todo',
+            strict: opts['strict'],
+        }, { command: 'validate', operation: 'check.schema' });
+    });
+}
+//# sourceMappingURL=validate.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"validate.js","sourceRoot":"","sources":["../../../src/cli/commands/validate.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAGjE,MAAM,UAAU,uBAAuB,CAAC,OAAgB;IACtD,OAAO;SACJ,OAAO,CAAC,UAAU,CAAC;SACnB,WAAW,CAAC,sDAAsD,CAAC;SACnE,MAAM,CAAC,UAAU,EAAE,0BAA0B,CAAC;SAC9C,MAAM,CAAC,KAAK,EAAE,IAA6B,EAAE,EAAE;QAC9C,MAAM,eAAe,CACnB,OAAO,EACP,OAAO,EACP,QAAQ,EACR;YACE,IAAI,EAAE,MAAM;YACZ,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC;SACvB,EACD,EAAE,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,cAAc,EAAE,CACnD,CAAC;IACJ,CAAC,CAAC,CAAC;AACP,CAAC"}

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

@@ -0,0 +1,8 @@
+/**
+ * CLI verify command - manage verification gates for tasks.
+ * Routes through dispatch layer to check.gate.verify.
+ * @task T4454
+ */
+import type { ShimCommand as Command } from '../commander-shim.js';
+export declare function registerVerifyCommand(program: Command): void;
+//# sourceMappingURL=verify.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"verify.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/verify.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,WAAW,IAAI,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAEnE,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA0B5D"}

package/dist/cli/commands/verify.js

@@ -0,0 +1,28 @@
+/**
+ * CLI verify command - manage verification gates for tasks.
+ * Routes through dispatch layer to check.gate.verify.
+ * @task T4454
+ */
+import { dispatchFromCli } from '../../dispatch/adapters/cli.js';
+export function registerVerifyCommand(program) {
+    program
+        .command('verify <task-id>')
+        .description('View or modify verification gates for a task')
+        .option('--gate <name>', 'Set specific gate')
+        .option('--value <bool>', 'Gate value: true or false', 'true')
+        .option('--agent <name>', 'Agent setting the gate')
+        .option('--all', 'Mark all required gates as passed')
+        .option('--reset', 'Reset verification to initial state')
+        .action(async (taskId, opts) => {
+        const isWrite = !!(opts['gate'] || opts['all'] || opts['reset']);
+        await dispatchFromCli(isWrite ? 'mutate' : 'query', 'check', isWrite ? 'gate.set' : 'gate.status', {
+            taskId,
+            gate: opts['gate'],
+            value: opts['value'] === 'false' ? false : opts['gate'] ? true : undefined,
+            agent: opts['agent'],
+            all: opts['all'],
+            reset: opts['reset'],
+        }, { command: 'verify' });
+    });
+}
+//# sourceMappingURL=verify.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"verify.js","sourceRoot":"","sources":["../../../src/cli/commands/verify.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAGjE,MAAM,UAAU,qBAAqB,CAAC,OAAgB;IACpD,OAAO;SACJ,OAAO,CAAC,kBAAkB,CAAC;SAC3B,WAAW,CAAC,8CAA8C,CAAC;SAC3D,MAAM,CAAC,eAAe,EAAE,mBAAmB,CAAC;SAC5C,MAAM,CAAC,gBAAgB,EAAE,2BAA2B,EAAE,MAAM,CAAC;SAC7D,MAAM,CAAC,gBAAgB,EAAE,wBAAwB,CAAC;SAClD,MAAM,CAAC,OAAO,EAAE,mCAAmC,CAAC;SACpD,MAAM,CAAC,SAAS,EAAE,qCAAqC,CAAC;SACxD,MAAM,CAAC,KAAK,EAAE,MAAc,EAAE,IAA6B,EAAE,EAAE;QAC9D,MAAM,OAAO,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;QACjE,MAAM,eAAe,CACnB,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,EAC5B,OAAO,EACP,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,aAAa,EACpC;YACE,MAAM;YACN,IAAI,EAAE,IAAI,CAAC,MAAM,CAAuB;YACxC,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS;YAC1E,KAAK,EAAE,IAAI,CAAC,OAAO,CAAuB;YAC1C,GAAG,EAAE,IAAI,CAAC,KAAK,CAAwB;YACvC,KAAK,EAAE,IAAI,CAAC,OAAO,CAAwB;SAC5C,EACD,EAAE,OAAO,EAAE,QAAQ,EAAE,CACtB,CAAC;IACJ,CAAC,CAAC,CAAC;AACP,CAAC"}

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

@@ -0,0 +1,13 @@
+/**
+ * CLI web command - manage CLEO Web UI server lifecycle.
+ * Ported from scripts/web.sh
+ * @task T4551
+ * @epic T4545
+ */
+import type { ShimCommand as Command } from '../commander-shim.js';
+/**
+ * Register the web command.
+ * @task T4551
+ */
+export declare function registerWebCommand(program: Command): void;
+//# sourceMappingURL=web.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"web.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/web.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH,OAAO,KAAK,EAAE,WAAW,IAAI,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAsEnE;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAgOzD"}

package/dist/cli/commands/web.js

@@ -0,0 +1,277 @@
+/**
+ * CLI web command - manage CLEO Web UI server lifecycle.
+ * Ported from scripts/web.sh
+ * @task T4551
+ * @epic T4545
+ */
+import { execFileSync, spawn } from 'node:child_process';
+import { mkdir, readFile, rm, stat, writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { ExitCode } from '@cleocode/contracts';
+import { CleoError, formatError, getCleoHome } from '@cleocode/core';
+import { cliOutput } from '../renderers/index.js';
+const DEFAULT_PORT = 3456;
+const DEFAULT_HOST = '127.0.0.1';
+/**
+ * Get web server file paths.
+ * @task T4551
+ */
+function getWebPaths() {
+    const cleoHome = getCleoHome();
+    return {
+        pidFile: join(cleoHome, 'web-server.pid'),
+        configFile: join(cleoHome, 'web-server.json'),
+        logFile: join(cleoHome, 'logs', 'web-server.log'),
+    };
+}
+/**
+ * Check if a process is running by PID.
+ * @task T4551
+ */
+function isProcessRunning(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Get server status.
+ * @task T4551
+ */
+async function getStatus() {
+    const { pidFile, configFile } = getWebPaths();
+    try {
+        const pidStr = (await readFile(pidFile, 'utf-8')).trim();
+        const pid = parseInt(pidStr, 10);
+        if (Number.isNaN(pid) || !isProcessRunning(pid)) {
+            return { running: false, pid: null, port: null, host: null, url: null };
+        }
+        let port = DEFAULT_PORT;
+        let host = DEFAULT_HOST;
+        try {
+            const config = JSON.parse(await readFile(configFile, 'utf-8'));
+            port = config.port ?? DEFAULT_PORT;
+            host = config.host ?? DEFAULT_HOST;
+        }
+        catch {
+            // Use defaults
+        }
+        return { running: true, pid, port, host, url: `http://${host}:${port}` };
+    }
+    catch {
+        return { running: false, pid: null, port: null, host: null, url: null };
+    }
+}
+/**
+ * Register the web command.
+ * @task T4551
+ */
+export function registerWebCommand(program) {
+    const webCmd = program.command('web').description('Manage CLEO Web UI server');
+    webCmd
+        .command('start')
+        .description('Start the web server')
+        .option('--port <port>', 'Server port', String(DEFAULT_PORT))
+        .option('--host <host>', 'Server host', DEFAULT_HOST)
+        .action(async (opts) => {
+        try {
+            const port = parseInt(opts['port'], 10);
+            const host = opts['host'];
+            const { pidFile, configFile, logFile } = getWebPaths();
+            // Check if already running
+            const status = await getStatus();
+            if (status.running) {
+                throw new CleoError(ExitCode.GENERAL_ERROR, `Server already running (PID: ${status.pid})`);
+            }
+            // Resolve server location from the main @cleocode/cleo package
+            const projectRoot = process.env['CLEO_ROOT'] ?? process.cwd();
+            const distServerDir = join(projectRoot, 'dist', 'cli');
+            // Ensure log directory exists
+            await mkdir(join(getCleoHome(), 'logs'), { recursive: true });
+            // Save config
+            await writeFile(configFile, JSON.stringify({
+                port,
+                host,
+                startedAt: new Date().toISOString(),
+            }));
+            // Check if server is built (dist/cli/index.js from @cleocode/cleo)
+            const webIndexPath = join(distServerDir, 'index.js');
+            try {
+                await stat(webIndexPath);
+            }
+            catch {
+                // Need to build
+                try {
+                    execFileSync('npm', ['run', 'build'], { cwd: projectRoot, stdio: 'ignore' });
+                }
+                catch {
+                    throw new CleoError(ExitCode.GENERAL_ERROR, `Build failed. Check logs: ${logFile}`);
+                }
+            }
+            // Start server
+            const serverProcess = spawn('node', [webIndexPath], {
+                cwd: projectRoot,
+                env: {
+                    ...process.env,
+                    CLEO_WEB_PORT: String(port),
+                    CLEO_WEB_HOST: host,
+                },
+                detached: true,
+                stdio: 'ignore',
+            });
+            serverProcess.unref();
+            await writeFile(pidFile, String(serverProcess.pid));
+            // Wait for server to respond
+            const maxAttempts = 30;
+            let started = false;
+            for (let i = 0; i < maxAttempts; i++) {
+                try {
+                    const response = await fetch(`http://${host}:${port}/api/health`);
+                    if (response.ok) {
+                        started = true;
+                        break;
+                    }
+                }
+                catch {
+                    // Not ready yet
+                }
+                await new Promise((resolve) => setTimeout(resolve, 500));
+            }
+            if (!started) {
+                try {
+                    process.kill(serverProcess.pid);
+                }
+                catch {
+                    /* ignore */
+                }
+                await rm(pidFile, { force: true });
+                throw new CleoError(ExitCode.GENERAL_ERROR, 'Server failed to start within 15 seconds');
+            }
+            cliOutput({
+                pid: serverProcess.pid,
+                port,
+                host,
+                url: `http://${host}:${port}`,
+            }, { command: 'web', message: `CLEO Web UI running on port ${port}` });
+        }
+        catch (err) {
+            if (err instanceof CleoError) {
+                console.error(formatError(err));
+                process.exit(err.code);
+            }
+            throw err;
+        }
+    });
+    webCmd
+        .command('stop')
+        .description('Stop the web server')
+        .action(async () => {
+        try {
+            const { pidFile } = getWebPaths();
+            const status = await getStatus();
+            if (!status.running || !status.pid) {
+                // Clean up stale PID file
+                await rm(pidFile, { force: true });
+                cliOutput({ running: false }, { command: 'web', message: 'Server is not running' });
+                return;
+            }
+            // Graceful shutdown (cross-platform)
+            try {
+                if (process.platform === 'win32') {
+                    spawn('taskkill', ['/PID', String(status.pid), '/T'], { stdio: 'ignore' });
+                }
+                else {
+                    process.kill(status.pid, 'SIGTERM');
+                }
+            }
+            catch {
+                /* ignore */
+            }
+            // Wait for exit
+            for (let i = 0; i < 10; i++) {
+                if (!isProcessRunning(status.pid))
+                    break;
+                await new Promise((resolve) => setTimeout(resolve, 500));
+            }
+            // Force kill if still running
+            if (isProcessRunning(status.pid)) {
+                try {
+                    if (process.platform === 'win32') {
+                        spawn('taskkill', ['/PID', String(status.pid), '/F', '/T'], { stdio: 'ignore' });
+                    }
+                    else {
+                        process.kill(status.pid, 'SIGKILL');
+                    }
+                }
+                catch {
+                    /* ignore */
+                }
+            }
+            await rm(pidFile, { force: true });
+            cliOutput({ stopped: true }, { command: 'web', message: 'CLEO Web UI stopped' });
+        }
+        catch (err) {
+            if (err instanceof CleoError) {
+                console.error(formatError(err));
+                process.exit(err.code);
+            }
+            throw err;
+        }
+    });
+    webCmd
+        .command('status')
+        .description('Check server status')
+        .action(async () => {
+        try {
+            const status = await getStatus();
+            cliOutput(status, { command: 'web' });
+        }
+        catch (err) {
+            if (err instanceof CleoError) {
+                console.error(formatError(err));
+                process.exit(err.code);
+            }
+            throw err;
+        }
+    });
+    webCmd
+        .command('open')
+        .description('Open browser to the UI')
+        .action(async () => {
+        try {
+            const status = await getStatus();
+            if (!status.running || !status.url) {
+                throw new CleoError(ExitCode.GENERAL_ERROR, 'Web server is not running. Start with: cleo web start');
+            }
+            // Try to open browser
+            const url = status.url;
+            const platform = process.platform;
+            try {
+                if (platform === 'linux') {
+                    spawn('xdg-open', [url], { detached: true, stdio: 'ignore' }).unref();
+                }
+                else if (platform === 'darwin') {
+                    spawn('open', [url], { detached: true, stdio: 'ignore' }).unref();
+                }
+                else if (platform === 'win32') {
+                    spawn('cmd', ['/c', 'start', '', url], { detached: true, stdio: 'ignore' }).unref();
+                }
+            }
+            catch {
+                // Can't open browser — user can open manually
+            }
+            cliOutput({ url }, { command: 'web', message: `Open browser to: ${url}` });
+        }
+        catch (err) {
+            if (err instanceof CleoError) {
+                console.error(formatError(err));
+                process.exit(err.code);
+            }
+            throw err;
+        }
+    });
+}
+//# sourceMappingURL=web.js.map

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

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

package/dist/cli/field-context.d.ts

@@ -0,0 +1,32 @@
+/**
+ * CLI field extraction context.
+ *
+ * Singleton that holds the resolved field extraction options for the current
+ * CLI invocation. Set once in the Commander.js preAction hook; read by
+ * dispatchFromCli() to apply field filtering and MVI control universally
+ * across all commands.
+ *
+ * Delegates to @cleocode/lafs v1.5.0 resolveFieldExtraction()
+ * for canonical conflict detection, flag parsing, and type resolution.
+ * Mirrors the format-context.ts pattern for --json/--human/--quiet.
+ *
+ * @epic T4953
+ * @task T4979
+ */
+import { type FieldExtractionResolution } from '@cleocode/lafs';
+export type { FieldExtractionResolution as FieldContext };
+/**
+ * Set the field extraction context for this CLI invocation.
+ * Called once from the preAction hook in src/cli/index.ts.
+ */
+export declare function setFieldContext(ctx: FieldExtractionResolution): void;
+/**
+ * Get the current field extraction context.
+ */
+export declare function getFieldContext(): FieldExtractionResolution;
+/**
+ * Parse global field options from Commander.js parsed opts and resolve via
+ * the canonical LAFS SDK resolver (conflict detection, type narrowing).
+ */
+export declare function resolveFieldContext(opts: Record<string, unknown>): FieldExtractionResolution;
+//# sourceMappingURL=field-context.d.ts.map

package/dist/cli/field-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-context.d.ts","sourceRoot":"","sources":["../../src/cli/field-context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAEL,KAAK,yBAAyB,EAE/B,MAAM,gBAAgB,CAAC;AAExB,YAAY,EAAE,yBAAyB,IAAI,YAAY,EAAE,CAAC;AAQ1D;;;GAGG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,yBAAyB,GAAG,IAAI,CAEpE;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,yBAAyB,CAE3D;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,yBAAyB,CAO5F"}

package/dist/cli/field-context.js

@@ -0,0 +1,47 @@
+/**
+ * CLI field extraction context.
+ *
+ * Singleton that holds the resolved field extraction options for the current
+ * CLI invocation. Set once in the Commander.js preAction hook; read by
+ * dispatchFromCli() to apply field filtering and MVI control universally
+ * across all commands.
+ *
+ * Delegates to @cleocode/lafs v1.5.0 resolveFieldExtraction()
+ * for canonical conflict detection, flag parsing, and type resolution.
+ * Mirrors the format-context.ts pattern for --json/--human/--quiet.
+ *
+ * @epic T4953
+ * @task T4979
+ */
+import { resolveFieldExtraction, } from '@cleocode/lafs';
+let currentContext = {
+    mvi: 'minimal',
+    mviSource: 'default',
+    expectsCustomMvi: false,
+};
+/**
+ * Set the field extraction context for this CLI invocation.
+ * Called once from the preAction hook in src/cli/index.ts.
+ */
+export function setFieldContext(ctx) {
+    currentContext = ctx;
+}
+/**
+ * Get the current field extraction context.
+ */
+export function getFieldContext() {
+    return currentContext;
+}
+/**
+ * Parse global field options from Commander.js parsed opts and resolve via
+ * the canonical LAFS SDK resolver (conflict detection, type narrowing).
+ */
+export function resolveFieldContext(opts) {
+    const input = {
+        fieldFlag: typeof opts['field'] === 'string' ? opts['field'] : undefined,
+        fieldsFlag: typeof opts['fields'] === 'string' ? opts['fields'] : undefined,
+        mviFlag: typeof opts['mvi'] === 'string' ? opts['mvi'] : undefined,
+    };
+    return resolveFieldExtraction(input);
+}
+//# sourceMappingURL=field-context.js.map

package/dist/cli/field-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-context.js","sourceRoot":"","sources":["../../src/cli/field-context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAGL,sBAAsB,GACvB,MAAM,gBAAgB,CAAC;AAIxB,IAAI,cAAc,GAA8B;IAC9C,GAAG,EAAE,SAAS;IACd,SAAS,EAAE,SAAS;IACpB,gBAAgB,EAAE,KAAK;CACxB,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,GAA8B;IAC5D,cAAc,GAAG,GAAG,CAAC;AACvB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe;IAC7B,OAAO,cAAc,CAAC;AACxB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAA6B;IAC/D,MAAM,KAAK,GAAyB;QAClC,SAAS,EAAE,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS;QACxE,UAAU,EAAE,OAAO,IAAI,CAAC,QAAQ,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS;QAC3E,OAAO,EAAE,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS;KACnE,CAAC;IACF,OAAO,sBAAsB,CAAC,KAAK,CAAC,CAAC;AACvC,CAAC"}