@cleocode/cleo 2026.2.5

package/dist/cli/commands/verify.js

@@ -0,0 +1,153 @@
+/**
+ * CLI verify command - manage verification gates for tasks.
+ * @task T4454
+ */
+import { formatError } from '../../core/output.js';
+import { cliOutput } from '../renderers/index.js';
+import { CleoError } from '../../core/errors.js';
+import { ExitCode } from '../../types/exit-codes.js';
+import { getAccessor } from '../../store/data-accessor.js';
+import { computeChecksum } from '../../store/json.js';
+const VALID_GATES = [
+    'implemented', 'testsPassed', 'qaPassed', 'cleanupDone', 'securityPassed', 'documented',
+];
+const DEFAULT_REQUIRED_GATES = [
+    'implemented', 'testsPassed', 'qaPassed', 'securityPassed', 'documented',
+];
+function initVerification() {
+    return {
+        passed: false,
+        round: 0,
+        gates: {},
+        lastAgent: null,
+        lastUpdated: null,
+        failureLog: [],
+    };
+}
+function computePassed(verification) {
+    for (const gate of DEFAULT_REQUIRED_GATES) {
+        if (verification.gates[gate] !== true)
+            return false;
+    }
+    return true;
+}
+function getMissingGates(verification) {
+    return DEFAULT_REQUIRED_GATES.filter((g) => verification.gates[g] !== true);
+}
+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) => {
+        try {
+            const idPattern = /^T\d{3,}$/;
+            if (!idPattern.test(taskId)) {
+                throw new CleoError(ExitCode.INVALID_INPUT, `Invalid task ID format: ${taskId}`);
+            }
+            const accessor = await getAccessor();
+            const data = await accessor.loadTaskFile();
+            const task = data.tasks.find((t) => t.id === taskId);
+            if (!task) {
+                throw new CleoError(ExitCode.NOT_FOUND, `Task ${taskId} not found`);
+            }
+            // View mode (no gate, --all, or --reset specified)
+            if (!opts['gate'] && !opts['all'] && !opts['reset']) {
+                const verification = task.verification ?? initVerification();
+                const missing = getMissingGates(verification);
+                cliOutput({
+                    task: taskId,
+                    title: task.title,
+                    status: task.status,
+                    type: task.type ?? 'task',
+                    verification,
+                    verificationStatus: verification.passed ? 'passed' : 'pending',
+                    passed: verification.passed,
+                    round: verification.round,
+                    requiredGates: DEFAULT_REQUIRED_GATES,
+                    missingGates: missing,
+                }, { command: 'verify' });
+                return;
+            }
+            let verification = task.verification ?? initVerification();
+            const now = new Date().toISOString();
+            if (opts['reset']) {
+                verification = initVerification();
+            }
+            else if (opts['all']) {
+                for (const gate of DEFAULT_REQUIRED_GATES) {
+                    verification.gates[gate] = true;
+                }
+                if (opts['agent']) {
+                    verification.lastAgent = opts['agent'];
+                }
+                verification.lastUpdated = now;
+            }
+            else if (opts['gate']) {
+                const gate = opts['gate'];
+                if (!VALID_GATES.includes(gate)) {
+                    throw new CleoError(ExitCode.INVALID_GATE, `Invalid gate: ${gate}. Valid: ${VALID_GATES.join(', ')}`);
+                }
+                const value = opts['value'] === 'false' ? false : true;
+                verification.gates[gate] = value;
+                if (opts['agent']) {
+                    verification.lastAgent = opts['agent'];
+                }
+                verification.lastUpdated = now;
+                if (!value) {
+                    verification.round++;
+                    verification.failureLog.push({
+                        round: verification.round,
+                        agent: opts['agent'] ?? 'unknown',
+                        reason: `Gate ${gate} set to false`,
+                        timestamp: now,
+                    });
+                }
+            }
+            verification.passed = computePassed(verification);
+            task.verification = verification;
+            task.updatedAt = now;
+            data._meta.checksum = computeChecksum(data.tasks);
+            data.lastUpdated = now;
+            await accessor.saveTaskFile(data);
+            if (opts['reset']) {
+                cliOutput({
+                    task: taskId,
+                    action: 'reset',
+                    verification,
+                }, { command: 'verify' });
+            }
+            else if (opts['all']) {
+                cliOutput({
+                    task: taskId,
+                    action: 'set_all',
+                    gatesSet: DEFAULT_REQUIRED_GATES,
+                    verification,
+                    passed: verification.passed,
+                }, { command: 'verify' });
+            }
+            else {
+                cliOutput({
+                    task: taskId,
+                    gate: opts['gate'],
+                    value: opts['value'] === 'false' ? false : true,
+                    agent: opts['agent'] ?? null,
+                    verification,
+                    passed: verification.passed,
+                }, { command: 'verify' });
+            }
+        }
+        catch (err) {
+            if (err instanceof CleoError) {
+                console.error(formatError(err));
+                process.exit(err.code);
+            }
+            throw err;
+        }
+    });
+}
+//# 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":"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"}

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 { Command } from 'commander';
+/**
+ * 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;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA6EpC;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA6NzD"}

package/dist/cli/commands/web.js

@@ -0,0 +1,281 @@
+/**
+ * CLI web command - manage CLEO Web UI server lifecycle.
+ * Ported from scripts/web.sh
+ * @task T4551
+ * @epic T4545
+ */
+import { spawn, execFileSync } from 'node:child_process';
+import { readFile, writeFile, mkdir, rm, stat } from 'node:fs/promises';
+import { join } from 'node:path';
+import { formatError } from '../../core/output.js';
+import { cliOutput } from '../renderers/index.js';
+import { CleoError } from '../../core/errors.js';
+import { ExitCode } from '../../types/exit-codes.js';
+import { getCleoHome } from '../../core/paths.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 (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})`);
+            }
+            // Find MCP server directory
+            let mcpServerDir = '';
+            const candidates = [
+                join(process.cwd(), 'mcp-server'),
+                process.env['CLEO_MCP_SERVER'] ?? '',
+                join(getCleoHome(), 'mcp-server'),
+            ];
+            for (const candidate of candidates) {
+                if (!candidate)
+                    continue;
+                try {
+                    await stat(candidate);
+                    mcpServerDir = candidate;
+                    break;
+                }
+                catch {
+                    continue;
+                }
+            }
+            if (!mcpServerDir) {
+                throw new CleoError(ExitCode.NOT_FOUND, 'MCP server not found. Run from a CLEO project or set CLEO_MCP_SERVER');
+            }
+            // 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 web server is built
+            const webIndexPath = join(mcpServerDir, 'dist', 'web', 'index.js');
+            try {
+                await stat(webIndexPath);
+            }
+            catch {
+                // Need to build
+                try {
+                    execFileSync('npm', ['run', 'build'], { cwd: mcpServerDir, stdio: 'ignore' });
+                }
+                catch {
+                    throw new CleoError(ExitCode.GENERAL_ERROR, `Build failed. Check logs: ${logFile}`);
+                }
+            }
+            // Start server
+            const serverProcess = spawn('node', [webIndexPath], {
+                cwd: mcpServerDir,
+                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
+            try {
+                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 {
+                    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();
+                }
+            }
+            catch {
+                // Can't open browser
+            }
+            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/format-context.d.ts

@@ -0,0 +1,32 @@
+/**
+ * CLI output format resolution context.
+ *
+ * Singleton that holds the resolved output format for the current CLI invocation.
+ * Set once in the Commander.js preAction hook; read by cliOutput() and renderers.
+ *
+ * @task T4665
+ * @epic T4663
+ */
+import type { FlagResolution } from '@cleocode/lafs-protocol';
+/**
+ * Set the resolved format for this CLI invocation.
+ * Called once from the preAction hook in src/cli/index.ts.
+ */
+export declare function setFormatContext(resolution: FlagResolution): void;
+/**
+ * Get the current resolved format.
+ */
+export declare function getFormatContext(): FlagResolution;
+/**
+ * Check if output should be JSON format.
+ */
+export declare function isJsonFormat(): boolean;
+/**
+ * Check if output should be human-readable format.
+ */
+export declare function isHumanFormat(): boolean;
+/**
+ * Check if quiet mode is enabled (suppress non-essential output).
+ */
+export declare function isQuiet(): boolean;
+//# sourceMappingURL=format-context.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"format-context.d.ts","sourceRoot":"","sources":["../../src/cli/format-context.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAY9D;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,cAAc,GAAG,IAAI,CAEjE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,cAAc,CAEjD;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,OAAO,CAEtC;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,OAAO,CAEvC;AAED;;GAEG;AACH,wBAAgB,OAAO,IAAI,OAAO,CAEjC"}

package/dist/cli/format-context.js

@@ -0,0 +1,50 @@
+/**
+ * CLI output format resolution context.
+ *
+ * Singleton that holds the resolved output format for the current CLI invocation.
+ * Set once in the Commander.js preAction hook; read by cliOutput() and renderers.
+ *
+ * @task T4665
+ * @epic T4663
+ */
+/**
+ * Current resolved format for this CLI invocation.
+ * Defaults to JSON (agent-first) until resolved by preAction hook.
+ */
+let currentResolution = {
+    format: 'json',
+    source: 'default',
+    quiet: false,
+};
+/**
+ * Set the resolved format for this CLI invocation.
+ * Called once from the preAction hook in src/cli/index.ts.
+ */
+export function setFormatContext(resolution) {
+    currentResolution = resolution;
+}
+/**
+ * Get the current resolved format.
+ */
+export function getFormatContext() {
+    return currentResolution;
+}
+/**
+ * Check if output should be JSON format.
+ */
+export function isJsonFormat() {
+    return currentResolution.format === 'json';
+}
+/**
+ * Check if output should be human-readable format.
+ */
+export function isHumanFormat() {
+    return currentResolution.format === 'human';
+}
+/**
+ * Check if quiet mode is enabled (suppress non-essential output).
+ */
+export function isQuiet() {
+    return currentResolution.quiet;
+}
+//# sourceMappingURL=format-context.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"format-context.js","sourceRoot":"","sources":["../../src/cli/format-context.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH;;;GAGG;AACH,IAAI,iBAAiB,GAAmB;IACtC,MAAM,EAAE,MAAM;IACd,MAAM,EAAE,SAAS;IACjB,KAAK,EAAE,KAAK;CACb,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,UAA0B;IACzD,iBAAiB,GAAG,UAAU,CAAC;AACjC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB;IAC9B,OAAO,iBAAiB,CAAC;AAC3B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY;IAC1B,OAAO,iBAAiB,CAAC,MAAM,KAAK,MAAM,CAAC;AAC7C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa;IAC3B,OAAO,iBAAiB,CAAC,MAAM,KAAK,OAAO,CAAC;AAC9C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,OAAO;IACrB,OAAO,iBAAiB,CAAC,KAAK,CAAC;AACjC,CAAC"}

package/dist/cli/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * CLEO V2 CLI entry point.
+ * @epic T4454
+ * @task T4455
+ */
+export {};
+//# 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":"AAAA;;;;GAIG"}