@cleocode/cleo 2026.4.161 → 2026.5.0

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

@@ -0,0 +1,164 @@
+/**
+ * CLI `cleo update <taskId>` command — update a task's FIELDS.
+ *
+ * Not to be confused with:
+ *   - `cleo upgrade` (see upgrade.ts) — project maintenance (schema/migration repair)
+ *   - `cleo self-update` (see self-update.ts) — upgrade the CLI binary itself via npm
+ *
+ * This command mutates task-row columns (title, status, priority, etc.).
+ * Accepts up to 20 options covering title, status, priority, type, size,
+ * phase, description, labels, dependencies, notes, acceptance criteria,
+ * files, blocked-by, parent, auto-complete control, pipeline stage,
+ * role, and scope.
+ *
+ * Task CLI command convention: task operations are split root commands, not a
+ * `tasks.ts` command group. CLI-only compatibility aliases are normalized in
+ * the owning command file before dispatch so the wire params stay canonical.
+ *
+ * @task T4461
+ * @epic T4454
+ */
+/**
+ * Update a task by ID, applying only the fields that are explicitly provided.
+ */
+export declare const updateCommand: import("citty").CommandDef<{
+    readonly taskId: {
+        readonly type: "positional";
+        readonly description: "Task ID to update";
+        readonly required: false;
+    };
+    readonly title: {
+        readonly type: "string";
+        readonly description: "New title";
+    };
+    readonly status: {
+        readonly type: "string";
+        readonly description: "New status (pending|active|blocked|done|cancelled)";
+        readonly alias: "s";
+    };
+    readonly priority: {
+        readonly type: "string";
+        readonly description: "New priority (critical|high|medium|low)";
+        readonly alias: "p";
+    };
+    readonly type: {
+        readonly type: "string";
+        readonly description: "New type (task|epic|subtask|bug)";
+        readonly alias: "t";
+    };
+    readonly size: {
+        readonly type: "string";
+        readonly description: "New size";
+    };
+    readonly phase: {
+        readonly type: "string";
+        readonly description: "New phase";
+        readonly alias: "P";
+    };
+    readonly description: {
+        readonly type: "string";
+        readonly description: "New description";
+        readonly alias: "d";
+    };
+    readonly labels: {
+        readonly type: "string";
+        readonly description: "Set labels (comma-separated)";
+        readonly alias: "l";
+    };
+    readonly 'add-labels': {
+        readonly type: "string";
+        readonly description: "Add labels (comma-separated)";
+    };
+    readonly 'remove-labels': {
+        readonly type: "string";
+        readonly description: "Remove labels (comma-separated)";
+    };
+    readonly depends: {
+        readonly type: "string";
+        readonly description: "Set dependencies (comma-separated)";
+        readonly alias: "D";
+    };
+    readonly 'add-depends': {
+        readonly type: "string";
+        readonly description: "Add dependencies (comma-separated)";
+    };
+    readonly 'remove-depends': {
+        readonly type: "string";
+        readonly description: "Remove dependencies (comma-separated)";
+    };
+    readonly notes: {
+        readonly type: "string";
+        readonly description: "Add a note";
+    };
+    readonly note: {
+        readonly type: "string";
+        readonly description: "Alias for --notes";
+    };
+    readonly acceptance: {
+        readonly type: "string";
+        readonly description: "Set acceptance criteria (pipe-separated, e.g. \"AC1|AC2|AC3\")";
+    };
+    readonly files: {
+        readonly type: "string";
+        readonly description: "Set files (comma-separated)";
+    };
+    readonly 'blocked-by': {
+        readonly type: "string";
+        readonly description: "Set blocked-by reason";
+    };
+    readonly parent: {
+        readonly type: "string";
+        readonly description: "Set parent ID";
+    };
+    readonly 'parent-id': {
+        readonly type: "string";
+        readonly description: "Alias for --parent (legacy parentId compatibility)";
+    };
+    readonly 'no-auto-complete': {
+        readonly type: "boolean";
+        readonly description: "Disable auto-complete for epic";
+    };
+    readonly 'pipeline-stage': {
+        readonly type: "string";
+        readonly description: "Set pipeline stage (forward-only: research|consensus|architecture_decision|specification|decomposition|implementation|validation|testing|release|contribution)";
+    };
+    /**
+     * Task role axis — intent of work.
+     * Values: work | research | experiment | bug | spike | release
+     * @task T944
+     */
+    readonly role: {
+        readonly type: "string";
+        readonly description: "Task role / intent axis (work|research|experiment|bug|spike|release) — orthogonal to --type (T944)";
+    };
+    /**
+     * Backward-compatible alias for --role (fractal-ontology spec used "kind").
+     * @task T1472
+     */
+    readonly kind: {
+        readonly type: "string";
+        readonly description: "Alias for --role (T944 fractal-ontology compat)";
+    };
+    /**
+     * Task scope axis — granularity of work.
+     * Values: project | feature | unit
+     * @task T944
+     */
+    readonly scope: {
+        readonly type: "string";
+        readonly description: "Task scope / granularity axis (project|feature|unit) — orthogonal to --type (T944)";
+    };
+    /**
+     * Operator-supplied justification required to override the
+     * acceptance-criteria immutability guard once a task has entered the
+     * implementation pipeline stage. Audit log: `.cleo/audit/ac-changes.jsonl`.
+     *
+     * @epic T1586 Foundation Lockdown
+     * @task T1590
+     */
+    readonly reason: {
+        readonly type: "string";
+        readonly description: "Operator override reason for AC-immutability guard (required to mutate --acceptance once stage >= implementation; T1590)";
+    };
+}>;
+//# sourceMappingURL=update.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/update.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAKH;;GAEG;AACH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAwGtB;;;;OAIG;;;;;IAMH;;;OAGG;;;;;IAKH;;;;OAIG;;;;;IAMH;;;;;;;OAOG;;;;;EAqDL,CAAC"}

package/dist/cli/commands/update.js

@@ -0,0 +1,234 @@
+/**
+ * CLI `cleo update <taskId>` command — update a task's FIELDS.
+ *
+ * Not to be confused with:
+ *   - `cleo upgrade` (see upgrade.ts) — project maintenance (schema/migration repair)
+ *   - `cleo self-update` (see self-update.ts) — upgrade the CLI binary itself via npm
+ *
+ * This command mutates task-row columns (title, status, priority, etc.).
+ * Accepts up to 20 options covering title, status, priority, type, size,
+ * phase, description, labels, dependencies, notes, acceptance criteria,
+ * files, blocked-by, parent, auto-complete control, pipeline stage,
+ * role, and scope.
+ *
+ * Task CLI command convention: task operations are split root commands, not a
+ * `tasks.ts` command group. CLI-only compatibility aliases are normalized in
+ * the owning command file before dispatch so the wire params stay canonical.
+ *
+ * @task T4461
+ * @epic T4454
+ */
+import { defineCommand, showUsage } from 'citty';
+import { dispatchFromCli } from '../../dispatch/adapters/cli.js';
+/**
+ * Update a task by ID, applying only the fields that are explicitly provided.
+ */
+export const updateCommand = defineCommand({
+    meta: { name: 'update', description: 'Update a task' },
+    args: {
+        taskId: {
+            type: 'positional',
+            description: 'Task ID to update',
+            required: false,
+        },
+        title: {
+            type: 'string',
+            description: 'New title',
+        },
+        status: {
+            type: 'string',
+            description: 'New status (pending|active|blocked|done|cancelled)',
+            alias: 's',
+        },
+        priority: {
+            type: 'string',
+            description: 'New priority (critical|high|medium|low)',
+            alias: 'p',
+        },
+        type: {
+            type: 'string',
+            description: 'New type (task|epic|subtask|bug)',
+            alias: 't',
+        },
+        size: {
+            type: 'string',
+            description: 'New size',
+        },
+        phase: {
+            type: 'string',
+            description: 'New phase',
+            alias: 'P',
+        },
+        description: {
+            type: 'string',
+            description: 'New description',
+            alias: 'd',
+        },
+        labels: {
+            type: 'string',
+            description: 'Set labels (comma-separated)',
+            alias: 'l',
+        },
+        'add-labels': {
+            type: 'string',
+            description: 'Add labels (comma-separated)',
+        },
+        'remove-labels': {
+            type: 'string',
+            description: 'Remove labels (comma-separated)',
+        },
+        depends: {
+            type: 'string',
+            description: 'Set dependencies (comma-separated)',
+            alias: 'D',
+        },
+        'add-depends': {
+            type: 'string',
+            description: 'Add dependencies (comma-separated)',
+        },
+        'remove-depends': {
+            type: 'string',
+            description: 'Remove dependencies (comma-separated)',
+        },
+        notes: {
+            type: 'string',
+            description: 'Add a note',
+        },
+        note: {
+            type: 'string',
+            description: 'Alias for --notes',
+        },
+        acceptance: {
+            type: 'string',
+            description: 'Set acceptance criteria (pipe-separated, e.g. "AC1|AC2|AC3")',
+        },
+        files: {
+            type: 'string',
+            description: 'Set files (comma-separated)',
+        },
+        'blocked-by': {
+            type: 'string',
+            description: 'Set blocked-by reason',
+        },
+        parent: {
+            type: 'string',
+            description: 'Set parent ID',
+        },
+        'parent-id': {
+            type: 'string',
+            description: 'Alias for --parent (legacy parentId compatibility)',
+        },
+        'no-auto-complete': {
+            type: 'boolean',
+            description: 'Disable auto-complete for epic',
+        },
+        'pipeline-stage': {
+            type: 'string',
+            description: 'Set pipeline stage (forward-only: research|consensus|architecture_decision|specification|decomposition|implementation|validation|testing|release|contribution)',
+        },
+        /**
+         * Task role axis — intent of work.
+         * Values: work | research | experiment | bug | spike | release
+         * @task T944
+         */
+        role: {
+            type: 'string',
+            description: 'Task role / intent axis (work|research|experiment|bug|spike|release) — orthogonal to --type (T944)',
+        },
+        /**
+         * Backward-compatible alias for --role (fractal-ontology spec used "kind").
+         * @task T1472
+         */
+        kind: {
+            type: 'string',
+            description: 'Alias for --role (T944 fractal-ontology compat)',
+        },
+        /**
+         * Task scope axis — granularity of work.
+         * Values: project | feature | unit
+         * @task T944
+         */
+        scope: {
+            type: 'string',
+            description: 'Task scope / granularity axis (project|feature|unit) — orthogonal to --type (T944)',
+        },
+        /**
+         * Operator-supplied justification required to override the
+         * acceptance-criteria immutability guard once a task has entered the
+         * implementation pipeline stage. Audit log: `.cleo/audit/ac-changes.jsonl`.
+         *
+         * @epic T1586 Foundation Lockdown
+         * @task T1590
+         */
+        reason: {
+            type: 'string',
+            description: 'Operator override reason for AC-immutability guard (required to mutate --acceptance once stage >= implementation; T1590)',
+        },
+    },
+    async run({ args, cmd }) {
+        if (!args.taskId) {
+            await showUsage(cmd);
+            return;
+        }
+        const params = { taskId: args.taskId };
+        if (args.title !== undefined)
+            params['title'] = args.title;
+        if (args.status !== undefined)
+            params['status'] = args.status;
+        if (args.priority !== undefined)
+            params['priority'] = args.priority;
+        if (args.type !== undefined)
+            params['type'] = args.type;
+        if (args.size !== undefined)
+            params['size'] = args.size;
+        if (args.phase !== undefined)
+            params['phase'] = args.phase;
+        if (args.description !== undefined)
+            params['description'] = args.description;
+        if (args.labels)
+            params['labels'] = args.labels.split(',').map((s) => s.trim());
+        if (args['add-labels'])
+            params['addLabels'] = args['add-labels'].split(',').map((s) => s.trim());
+        if (args['remove-labels'])
+            params['removeLabels'] = args['remove-labels'].split(',').map((s) => s.trim());
+        if (args.depends)
+            params['depends'] = args.depends.split(',').map((s) => s.trim());
+        if (args['add-depends'])
+            params['addDepends'] = args['add-depends'].split(',').map((s) => s.trim());
+        if (args['remove-depends'])
+            params['removeDepends'] = args['remove-depends'].split(',').map((s) => s.trim());
+        if (args.notes !== undefined)
+            params['notes'] = args.notes;
+        if (args.note !== undefined)
+            params['notes'] = params['notes'] ?? args.note;
+        if (args.acceptance)
+            params['acceptance'] = args.acceptance
+                .split('|')
+                .map((s) => s.trim())
+                .filter(Boolean);
+        if (args.files)
+            params['files'] = args.files.split(',').map((s) => s.trim());
+        if (args['blocked-by'] !== undefined)
+            params['blockedBy'] = args['blocked-by'];
+        if (args.parent !== undefined)
+            params['parent'] = args.parent;
+        if (args['parent-id'] !== undefined)
+            params['parent'] = params['parent'] ?? args['parent-id'];
+        if (args['no-auto-complete'] === true)
+            params['noAutoComplete'] = true;
+        if (args['pipeline-stage'] !== undefined)
+            params['pipelineStage'] = args['pipeline-stage'];
+        // T944: orthogonal axes
+        if (args.role !== undefined)
+            params['role'] = args.role;
+        if (args.kind !== undefined)
+            params['role'] = params['role'] ?? args.kind;
+        if (args.scope !== undefined)
+            params['scope'] = args.scope;
+        // T1590: AC-immutability override reason — forwarded as `reason`.
+        if (args.reason !== undefined)
+            params['reason'] = args.reason;
+        await dispatchFromCli('mutate', 'tasks', 'update', params, { command: 'update' });
+    },
+});
+//# sourceMappingURL=update.js.map

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

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

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

@@ -0,0 +1,76 @@
+/**
+ * CLI `cleo upgrade` command — unified PROJECT maintenance.
+ *
+ * Not to be confused with:
+ *   - `cleo update <taskId>` (see update.ts) — edit a task's fields
+ *   - `cleo self-update` (see self-update.ts) — upgrade the CLI binary via npm
+ *
+ * This command repairs the CURRENT project's `.cleo/` state in place.
+ * It does NOT fetch a new CLI version — only `cleo self-update` does that.
+ *
+ * Delegates to core upgrade logic. Handles:
+ *   - Storage migration (JSON -> SQLite, automatic)
+ *   - Schema version upgrades
+ *   - Structural repairs (checksums, missing fields)
+ *   - Global `{cleoHome}` data checks (via --include-global)
+ *   - Deep diagnostics via --diagnose
+ *
+ * Global output flags (--json, --human, --quiet) are declared in args so
+ * citty parses them directly. This replaces the Commander.js optsWithGlobals()
+ * pattern that is unavailable in native citty commands.
+ *
+ * @task T4699
+ * @task T5243
+ * @task T131
+ * @epic T4454
+ */
+/**
+ * Upgrade command — unified project maintenance (storage migration, schema repair, structural fixes).
+ */
+export declare const upgradeCommand: import("citty").CommandDef<{
+    readonly status: {
+        readonly type: "boolean";
+        readonly description: "Show what needs updating without making changes";
+    };
+    readonly 'dry-run': {
+        readonly type: "boolean";
+        readonly description: "Preview changes without applying";
+    };
+    readonly diagnose: {
+        readonly type: "boolean";
+        readonly description: "Deep inspection of schema, columns, and migration journals";
+    };
+    readonly 'include-global': {
+        readonly type: "boolean";
+        readonly description: "Also check global ~/.cleo data";
+    };
+    readonly 'no-auto-migrate': {
+        readonly type: "boolean";
+        readonly description: "Skip automatic JSON->SQLite migration";
+    };
+    readonly detect: {
+        readonly type: "boolean";
+        readonly description: "Force re-detection of project type (ignores staleness)";
+    };
+    readonly 'map-codebase': {
+        readonly type: "boolean";
+        readonly description: "Run full codebase analysis and store findings to brain.db";
+    };
+    readonly name: {
+        readonly type: "string";
+        readonly description: "Update project name in project-info and nexus registry";
+    };
+    readonly json: {
+        readonly type: "boolean";
+        readonly description: "Output as JSON";
+    };
+    readonly human: {
+        readonly type: "boolean";
+        readonly description: "Force human-readable output";
+    };
+    readonly quiet: {
+        readonly type: "boolean";
+        readonly description: "Suppress non-essential output";
+    };
+}>;
+//# 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;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAOH;;GAEG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA0IzB,CAAC"}

package/dist/cli/commands/upgrade.js

@@ -0,0 +1,154 @@
+/**
+ * CLI `cleo upgrade` command — unified PROJECT maintenance.
+ *
+ * Not to be confused with:
+ *   - `cleo update <taskId>` (see update.ts) — edit a task's fields
+ *   - `cleo self-update` (see self-update.ts) — upgrade the CLI binary via npm
+ *
+ * This command repairs the CURRENT project's `.cleo/` state in place.
+ * It does NOT fetch a new CLI version — only `cleo self-update` does that.
+ *
+ * Delegates to core upgrade logic. Handles:
+ *   - Storage migration (JSON -> SQLite, automatic)
+ *   - Schema version upgrades
+ *   - Structural repairs (checksums, missing fields)
+ *   - Global `{cleoHome}` data checks (via --include-global)
+ *   - Deep diagnostics via --diagnose
+ *
+ * Global output flags (--json, --human, --quiet) are declared in args so
+ * citty parses them directly. This replaces the Commander.js optsWithGlobals()
+ * pattern that is unavailable in native citty commands.
+ *
+ * @task T4699
+ * @task T5243
+ * @task T131
+ * @epic T4454
+ */
+import { CleoError, diagnoseUpgrade, formatError, runUpgrade } from '@cleocode/core/internal';
+import { defineCommand } from 'citty';
+import { createUpgradeProgress } from '../progress.js';
+import { cliOutput } from '../renderers/index.js';
+/**
+ * Upgrade command — unified project maintenance (storage migration, schema repair, structural fixes).
+ */
+export const upgradeCommand = defineCommand({
+    meta: {
+        name: 'upgrade',
+        description: 'Unified project maintenance (storage migration, schema repair, structural fixes, doc refresh)',
+    },
+    args: {
+        status: {
+            type: 'boolean',
+            description: 'Show what needs updating without making changes',
+        },
+        'dry-run': {
+            type: 'boolean',
+            description: 'Preview changes without applying',
+        },
+        diagnose: {
+            type: 'boolean',
+            description: 'Deep inspection of schema, columns, and migration journals',
+        },
+        'include-global': {
+            type: 'boolean',
+            description: 'Also check global ~/.cleo data',
+        },
+        'no-auto-migrate': {
+            type: 'boolean',
+            description: 'Skip automatic JSON->SQLite migration',
+        },
+        detect: {
+            type: 'boolean',
+            description: 'Force re-detection of project type (ignores staleness)',
+        },
+        'map-codebase': {
+            type: 'boolean',
+            description: 'Run full codebase analysis and store findings to brain.db',
+        },
+        name: {
+            type: 'string',
+            description: 'Update project name in project-info and nexus registry',
+        },
+        // Global output format flags — read directly from args (no optsWithGlobals in citty)
+        json: {
+            type: 'boolean',
+            description: 'Output as JSON',
+        },
+        human: {
+            type: 'boolean',
+            description: 'Force human-readable output',
+        },
+        quiet: {
+            type: 'boolean',
+            description: 'Suppress non-essential output',
+        },
+    },
+    async run({ args }) {
+        const isHuman = args.human === true || (!!process.stdout.isTTY && args.json !== true);
+        const progress = createUpgradeProgress(isHuman);
+        try {
+            if (args.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 = !!args['dry-run'] || !!args.status;
+            const includeGlobal = !!args['include-global'];
+            const autoMigrate = args['no-auto-migrate'] !== true;
+            const forceDetect = !!args.detect;
+            const mapCodebase = !!args['map-codebase'];
+            const projectName = args.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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"}