@cleocode/cleo 2026.4.158 → 2026.5.0

package/dist/cli/commands/release.js

@@ -0,0 +1,300 @@
+/**
+ * CLI release command group — release lifecycle management.
+ *
+ * Commands:
+ *   cleo release ship <version>         — composite release: gates → changelog → commit → tag → push
+ *   cleo release list                   — list all releases
+ *   cleo release show <version>         — show release details
+ *   cleo release cancel <version>       — cancel a draft/prepared release
+ *   cleo release changelog --since <tag> — generate CHANGELOG from git log (T820 RELEASE-02)
+ *   cleo release rollback <version>     — roll back a shipped release (metadata only)
+ *   cleo release rollback-full <version> — real rollback: delete tag, revert commit, remove record (T820 RELEASE-05)
+ *   cleo release channel                — show current release channel
+ *
+ * REMOVED: release add/plan commands were consolidated into release.ship as part
+ * of the API rationalization (T5615). For preview/dry-run: cleo release ship <version> --epic <id> --dry-run
+ *
+ * @task T4467
+ * @task T820
+ * @epic T4454
+ */
+import { release } from '@cleocode/core';
+import { defineCommand, showUsage } from 'citty';
+import { dispatchFromCli } from '../../dispatch/adapters/cli.js';
+/**
+ * cleo release ship — composite release: prepare → gates → changelog → commit → tag → push.
+ *
+ * Requires --epic <id>. Use --dry-run to preview without writing anything.
+ * Use --force to bypass IVTR gate check (T820 RELEASE-03).
+ */
+const shipCommand = defineCommand({
+    meta: {
+        name: 'ship',
+        description: 'Ship a release: gates → changelog → commit → tag → push',
+    },
+    args: {
+        version: {
+            type: 'positional',
+            description: 'Version string (e.g. 2026.4.77)',
+            required: true,
+        },
+        epic: {
+            type: 'string',
+            description: 'Epic task ID for commit message (e.g. T5576)',
+            required: true,
+        },
+        'dry-run': {
+            type: 'boolean',
+            description: 'Preview all actions without writing anything',
+        },
+        push: {
+            type: 'boolean',
+            description: 'Push commit and tag (default: true)',
+            default: true,
+        },
+        bump: {
+            type: 'boolean',
+            description: 'Bump version files (default: true)',
+            default: true,
+        },
+        remote: {
+            type: 'string',
+            description: 'Git remote to push to (default: origin)',
+        },
+        force: {
+            type: 'boolean',
+            description: 'Bypass IVTR gate check with owner warning (breaks accountability chain)',
+        },
+    },
+    async run({ args }) {
+        await dispatchFromCli('mutate', 'pipeline', 'release.ship', {
+            version: args.version,
+            epicId: args.epic,
+            dryRun: args['dry-run'],
+            push: args.push !== false,
+            bump: args.bump !== false,
+            remote: args.remote,
+            force: args.force,
+        }, { command: 'release' });
+    },
+});
+/** cleo release list — list all releases */
+const listCommand = defineCommand({
+    meta: { name: 'list', description: 'List all releases' },
+    async run() {
+        await dispatchFromCli('query', 'pipeline', 'release.list', {}, { command: 'release' });
+    },
+});
+/** cleo release show — show details for a specific release */
+const showCommand = defineCommand({
+    meta: { name: 'show', description: 'Show release details' },
+    args: {
+        version: {
+            type: 'positional',
+            description: 'Release version to show',
+            required: true,
+        },
+    },
+    async run({ args }) {
+        await dispatchFromCli('query', 'pipeline', 'release.show', { version: args.version }, { command: 'release' });
+    },
+});
+/** cleo release cancel — cancel and remove a release in draft or prepared state */
+const cancelCommand = defineCommand({
+    meta: {
+        name: 'cancel',
+        description: 'Cancel and remove a release in draft or prepared state',
+    },
+    args: {
+        version: {
+            type: 'positional',
+            description: 'Release version to cancel',
+            required: true,
+        },
+    },
+    async run({ args }) {
+        await dispatchFromCli('mutate', 'pipeline', 'release.cancel', { version: args.version }, { command: 'release' });
+    },
+});
+/**
+ * cleo release changelog — generate CHANGELOG from git log since a given tag.
+ *
+ * Parses epic/task IDs from commit messages (T\d+ patterns),
+ * groups by epic, and produces a structured CHANGELOG entry.
+ *
+ * @task T820 RELEASE-02
+ */
+const changelogCommand = defineCommand({
+    meta: {
+        name: 'changelog',
+        description: 'Generate CHANGELOG from git log since a given tag, with task/epic grouping',
+    },
+    args: {
+        since: {
+            type: 'string',
+            description: 'Git tag or ref to generate changelog from (e.g. v2026.4.75)',
+            required: true,
+        },
+    },
+    async run({ args }) {
+        await dispatchFromCli('query', 'pipeline', 'release.changelog.since', { sinceTag: args.since }, { command: 'release' });
+    },
+});
+/** cleo release rollback — roll back a shipped release (metadata only, no git ops) */
+const rollbackCommand = defineCommand({
+    meta: {
+        name: 'rollback',
+        description: 'Roll back a shipped release (marks it as rolled-back in CLEO records)',
+    },
+    args: {
+        version: {
+            type: 'positional',
+            description: 'Release version to roll back',
+            required: true,
+        },
+        reason: {
+            type: 'string',
+            description: 'Reason for rollback',
+        },
+    },
+    async run({ args }) {
+        await dispatchFromCli('mutate', 'pipeline', 'release.rollback', {
+            version: args.version,
+            reason: args.reason,
+        }, { command: 'release' });
+    },
+});
+/**
+ * cleo release rollback-full — real rollback: delete git tag, revert commit, remove record.
+ *
+ * Unlike release.rollback (which only flips the status field in the DB),
+ * this performs actual git operations to undo the release.
+ *
+ * @task T820 RELEASE-05
+ */
+const rollbackFullCommand = defineCommand({
+    meta: {
+        name: 'rollback-full',
+        description: 'Full rollback: delete git tag, revert commit, remove release record',
+    },
+    args: {
+        version: {
+            type: 'positional',
+            description: 'Release version to fully roll back (e.g. 2026.4.77)',
+            required: true,
+        },
+        reason: {
+            type: 'string',
+            description: 'Reason for rollback',
+        },
+        force: {
+            type: 'boolean',
+            description: 'Continue even if some git operations fail',
+        },
+    },
+    async run({ args }) {
+        await dispatchFromCli('mutate', 'pipeline', 'release.rollback.full', {
+            version: args.version,
+            reason: args.reason,
+            force: args.force,
+        }, { command: 'release' });
+    },
+});
+/** cleo release channel — show the current release channel based on git branch */
+const channelCommand = defineCommand({
+    meta: {
+        name: 'channel',
+        description: 'Show the current release channel based on git branch (latest/beta/alpha)',
+    },
+    async run() {
+        await dispatchFromCli('query', 'pipeline', 'release.channel.show', {}, { command: 'release' });
+    },
+});
+// ---------------------------------------------------------------------------
+// Canonical 4-step release pipeline (T1597 / ADR-063)
+// ---------------------------------------------------------------------------
+/** cleo release start — Step 1: validate version, capture branch, persist handle. */
+const startCommand = defineCommand({
+    meta: {
+        name: 'start',
+        description: 'Begin a release (validates version, captures branch, persists handle)',
+    },
+    args: {
+        version: { type: 'positional', description: 'Version to release', required: true },
+        epic: { type: 'string', description: 'Epic ID this release ships' },
+        branch: { type: 'string', description: 'Override detected branch' },
+    },
+    async run({ args }) {
+        const handle = await release.releaseStart(args.version, {
+            epicId: args.epic,
+            branch: args.branch,
+        });
+        process.stdout.write(`${JSON.stringify(handle, null, 2)}\n`);
+    },
+});
+/** cleo release verify — Step 2: run gates + audit child tasks of release epic. */
+const verifyCommand = defineCommand({
+    meta: { name: 'verify', description: 'Verify release gates + child task gate state' },
+    async run() {
+        const result = await release.releaseVerify(release.loadActiveReleaseHandle(process.cwd()));
+        process.stdout.write(`${JSON.stringify(result, null, 2)}\n`);
+        if (!result.passed)
+            process.exit(1);
+    },
+});
+/** cleo release publish — Step 3: invoke project-context publish.command. */
+const publishCommand = defineCommand({
+    meta: { name: 'publish', description: 'Publish release artifact (project-context driven)' },
+    args: { 'dry-run': { type: 'boolean', description: 'Print command without executing' } },
+    async run({ args }) {
+        const result = await release.releasePublish(release.loadActiveReleaseHandle(process.cwd()), {
+            dryRun: args['dry-run'] === true,
+        });
+        process.stdout.write(`${JSON.stringify(result, null, 2)}\n`);
+        if (!result.success)
+            process.exit(1);
+    },
+});
+/** cleo release reconcile — Step 4: run post-release invariants, auto-complete tasks. */
+const reconcileCommand = defineCommand({
+    meta: { name: 'reconcile', description: 'Run post-release invariants for the active release' },
+    args: { 'dry-run': { type: 'boolean', description: 'Preview without mutations' } },
+    async run({ args }) {
+        const result = await release.releaseReconcile(release.loadActiveReleaseHandle(process.cwd()), {
+            dryRun: args['dry-run'] === true,
+        });
+        process.stdout.write(`${JSON.stringify(result, null, 2)}\n`);
+        if (!result.success)
+            process.exit(1);
+    },
+});
+/**
+ * Root release command group — release lifecycle management.
+ *
+ * Dispatches to `pipeline.release.*` registry operations.
+ */
+export const releaseCommand = defineCommand({
+    meta: { name: 'release', description: 'Release lifecycle management' },
+    subCommands: {
+        ship: shipCommand,
+        list: listCommand,
+        show: showCommand,
+        cancel: cancelCommand,
+        changelog: changelogCommand,
+        rollback: rollbackCommand,
+        'rollback-full': rollbackFullCommand,
+        channel: channelCommand,
+        // Canonical 4-step pipeline (T1597 / ADR-063)
+        start: startCommand,
+        verify: verifyCommand,
+        publish: publishCommand,
+        reconcile: reconcileCommand,
+    },
+    async run({ cmd, rawArgs }) {
+        const firstArg = rawArgs?.find((a) => !a.startsWith('-'));
+        if (firstArg && cmd.subCommands && firstArg in cmd.subCommands)
+            return;
+        await showUsage(cmd);
+    },
+});
+//# sourceMappingURL=release.js.map

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

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

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

@@ -0,0 +1,49 @@
+/**
+ * CLI command group for .cleo/.git remote push/pull shared state management.
+ *
+ * Subcommands under `cleo remote`:
+ *   cleo remote add <url>    — add a git remote to .cleo/.git
+ *   cleo remote remove <name> — remove a git remote from .cleo/.git
+ *   cleo remote list         — list configured .cleo/.git remotes
+ *   cleo remote status       — show sync status between local and remote
+ *
+ * Top-level commands also provided:
+ *   cleo push  — push .cleo/ state to remote
+ *   cleo pull  — pull .cleo/ state from remote
+ *
+ * @task T4884
+ */
+/**
+ * cleo remote — manage .cleo/.git remotes for multi-contributor state sharing.
+ *
+ * Dispatches add/remove/list/status subcommands against the .cleo/.git repository.
+ */
+export declare const remoteCommand: import("citty").CommandDef<import("citty").ArgsDef>;
+/** cleo push — push .cleo/ state to remote */
+export declare const pushCommand: import("citty").CommandDef<{
+    readonly remote: {
+        readonly type: "string";
+        readonly description: "Remote name";
+        readonly alias: "r";
+        readonly default: "origin";
+    };
+    readonly 'set-upstream': {
+        readonly type: "boolean";
+        readonly description: "Set upstream tracking branch";
+        readonly alias: "u";
+    };
+    readonly force: {
+        readonly type: "boolean";
+        readonly description: "Force push (overwrite remote)";
+    };
+}>;
+/** cleo pull — pull .cleo/ state from remote */
+export declare const pullCommand: import("citty").CommandDef<{
+    readonly remote: {
+        readonly type: "string";
+        readonly description: "Remote name";
+        readonly alias: "r";
+        readonly default: "origin";
+    };
+}>;
+//# sourceMappingURL=remote.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"remote.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/remote.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AA+JH;;;;GAIG;AACH,eAAO,MAAM,aAAa,qDAgBxB,CAAC;AAEH,8CAA8C;AAC9C,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;EAgDtB,CAAC;AAEH,gDAAgD;AAChD,eAAO,MAAM,WAAW;;;;;;;EA4CtB,CAAC"}

package/dist/cli/commands/remote.js

@@ -0,0 +1,265 @@
+/**
+ * CLI command group for .cleo/.git remote push/pull shared state management.
+ *
+ * Subcommands under `cleo remote`:
+ *   cleo remote add <url>    — add a git remote to .cleo/.git
+ *   cleo remote remove <name> — remove a git remote from .cleo/.git
+ *   cleo remote list         — list configured .cleo/.git remotes
+ *   cleo remote status       — show sync status between local and remote
+ *
+ * Top-level commands also provided:
+ *   cleo push  — push .cleo/ state to remote
+ *   cleo pull  — pull .cleo/ state from remote
+ *
+ * @task T4884
+ */
+import { ExitCode } from '@cleocode/contracts';
+import { addRemote, CleoError, formatError, getRemoteSyncStatus as getRemoteGitStatus, listRemotes, pull, push, removeRemote, } from '@cleocode/core/internal';
+import { defineCommand, showUsage } from 'citty';
+import { cliError, cliOutput } from '../renderers/index.js';
+/** cleo remote add <url> — add a git remote to .cleo/.git */
+const addRemoteCommand = defineCommand({
+    meta: { name: 'add', description: 'Add a git remote to .cleo/.git for shared state syncing' },
+    args: {
+        url: {
+            type: 'positional',
+            description: 'Remote URL to add',
+            required: true,
+        },
+        name: {
+            type: 'string',
+            description: 'Remote name',
+            alias: 'n',
+            default: 'origin',
+        },
+    },
+    async run({ args }) {
+        try {
+            const name = args.name ?? 'origin';
+            await addRemote(args.url, name);
+            cliOutput({ added: true, name, url: args.url }, { command: 'remote', message: `Remote '${name}' added: ${args.url}` });
+        }
+        catch (err) {
+            if (err instanceof CleoError) {
+                console.error(formatError(err));
+                process.exit(err.code);
+            }
+            if (err instanceof Error) {
+                console.error(formatError(new CleoError(ExitCode.GENERAL_ERROR, err.message)));
+                process.exit(ExitCode.GENERAL_ERROR);
+            }
+            throw err;
+        }
+    },
+});
+/** cleo remote remove <name> — remove a git remote from .cleo/.git */
+const removeRemoteCommand = defineCommand({
+    meta: { name: 'remove', description: 'Remove a git remote from .cleo/.git' },
+    args: {
+        name: {
+            type: 'positional',
+            description: 'Remote name to remove',
+            required: true,
+        },
+    },
+    async run({ args }) {
+        try {
+            await removeRemote(args.name);
+            cliOutput({ removed: true, name: args.name }, { command: 'remote', message: `Remote '${args.name}' removed` });
+        }
+        catch (err) {
+            if (err instanceof CleoError) {
+                console.error(formatError(err));
+                process.exit(err.code);
+            }
+            if (err instanceof Error) {
+                console.error(formatError(new CleoError(ExitCode.GENERAL_ERROR, err.message)));
+                process.exit(ExitCode.GENERAL_ERROR);
+            }
+            throw err;
+        }
+    },
+});
+/** cleo remote list — list configured .cleo/.git remotes */
+const listRemoteCommand = defineCommand({
+    meta: { name: 'list', description: 'List configured .cleo/.git remotes' },
+    async run() {
+        try {
+            const remotes = await listRemotes();
+            cliOutput({ remotes, count: remotes.length }, {
+                command: 'remote',
+                message: remotes.length === 0
+                    ? 'No remotes configured. Add one with: cleo remote add <url>'
+                    : `${remotes.length} remote(s) configured`,
+            });
+        }
+        catch (err) {
+            if (err instanceof CleoError) {
+                console.error(formatError(err));
+                process.exit(err.code);
+            }
+            if (err instanceof Error) {
+                console.error(formatError(new CleoError(ExitCode.GENERAL_ERROR, err.message)));
+                process.exit(ExitCode.GENERAL_ERROR);
+            }
+            throw err;
+        }
+    },
+});
+/** cleo remote status — show sync status between local .cleo/.git and remote */
+const statusRemoteCommand = defineCommand({
+    meta: {
+        name: 'status',
+        description: 'Show sync status between local .cleo/.git and remote',
+    },
+    args: {
+        remote: {
+            type: 'string',
+            description: 'Remote name',
+            alias: 'r',
+            default: 'origin',
+        },
+    },
+    async run({ args }) {
+        try {
+            const remoteName = args.remote ?? 'origin';
+            const status = await getRemoteGitStatus(remoteName);
+            let message;
+            if (status.ahead === 0 && status.behind === 0) {
+                message = `Up to date with ${remoteName}/${status.branch}`;
+            }
+            else {
+                const parts = [];
+                if (status.ahead > 0)
+                    parts.push(`${status.ahead} ahead`);
+                if (status.behind > 0)
+                    parts.push(`${status.behind} behind`);
+                message = `${parts.join(', ')} ${remoteName}/${status.branch}`;
+            }
+            cliOutput({ ...status }, { command: 'remote', message });
+        }
+        catch (err) {
+            if (err instanceof CleoError) {
+                console.error(formatError(err));
+                process.exit(err.code);
+            }
+            if (err instanceof Error) {
+                console.error(formatError(new CleoError(ExitCode.GENERAL_ERROR, err.message)));
+                process.exit(ExitCode.GENERAL_ERROR);
+            }
+            throw err;
+        }
+    },
+});
+/**
+ * cleo remote — manage .cleo/.git remotes for multi-contributor state sharing.
+ *
+ * Dispatches add/remove/list/status subcommands against the .cleo/.git repository.
+ */
+export const remoteCommand = defineCommand({
+    meta: {
+        name: 'remote',
+        description: 'Manage .cleo/.git remotes for multi-contributor state sharing',
+    },
+    subCommands: {
+        add: addRemoteCommand,
+        remove: removeRemoteCommand,
+        list: listRemoteCommand,
+        status: statusRemoteCommand,
+    },
+    async run({ cmd, rawArgs }) {
+        const firstArg = rawArgs?.find((a) => !a.startsWith('-'));
+        if (firstArg && cmd.subCommands && firstArg in cmd.subCommands)
+            return;
+        await showUsage(cmd);
+    },
+});
+/** cleo push — push .cleo/ state to remote */
+export const pushCommand = defineCommand({
+    meta: { name: 'push', description: 'Push .cleo/ state to remote (operates on .cleo/.git)' },
+    args: {
+        remote: {
+            type: 'string',
+            description: 'Remote name',
+            alias: 'r',
+            default: 'origin',
+        },
+        'set-upstream': {
+            type: 'boolean',
+            description: 'Set upstream tracking branch',
+            alias: 'u',
+        },
+        force: {
+            type: 'boolean',
+            description: 'Force push (overwrite remote)',
+        },
+    },
+    async run({ args }) {
+        try {
+            const remoteName = args.remote ?? 'origin';
+            const result = await push(remoteName, {
+                force: args.force ?? false,
+                setUpstream: args['set-upstream'] ?? false,
+            });
+            if (!result.success) {
+                console.error(formatError(new CleoError(ExitCode.GENERAL_ERROR, result.message)));
+                process.exit(ExitCode.GENERAL_ERROR);
+            }
+            cliOutput({ pushed: true, branch: result.branch, remote: result.remote }, { command: 'push', message: result.message });
+        }
+        catch (err) {
+            if (err instanceof CleoError) {
+                console.error(formatError(err));
+                process.exit(err.code);
+            }
+            if (err instanceof Error) {
+                console.error(formatError(new CleoError(ExitCode.GENERAL_ERROR, err.message)));
+                process.exit(ExitCode.GENERAL_ERROR);
+            }
+            throw err;
+        }
+    },
+});
+/** cleo pull — pull .cleo/ state from remote */
+export const pullCommand = defineCommand({
+    meta: { name: 'pull', description: 'Pull .cleo/ state from remote (operates on .cleo/.git)' },
+    args: {
+        remote: {
+            type: 'string',
+            description: 'Remote name',
+            alias: 'r',
+            default: 'origin',
+        },
+    },
+    async run({ args }) {
+        try {
+            const remoteName = args.remote ?? 'origin';
+            const result = await pull(remoteName);
+            if (!result.success) {
+                const details = {
+                    pulled: false,
+                    branch: result.branch,
+                    remote: result.remote,
+                };
+                if (result.hasConflicts) {
+                    details['conflicts'] = result.conflictFiles;
+                }
+                cliError(result.message, ExitCode.GENERAL_ERROR, { details });
+                process.exit(ExitCode.GENERAL_ERROR);
+            }
+            cliOutput({ pulled: true, branch: result.branch, remote: result.remote }, { command: 'pull', message: result.message });
+        }
+        catch (err) {
+            if (err instanceof CleoError) {
+                console.error(formatError(err));
+                process.exit(err.code);
+            }
+            if (err instanceof Error) {
+                console.error(formatError(new CleoError(ExitCode.GENERAL_ERROR, err.message)));
+                process.exit(ExitCode.GENERAL_ERROR);
+            }
+            throw err;
+        }
+    },
+});
+//# sourceMappingURL=remote.js.map

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

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

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

@@ -0,0 +1,31 @@
+/**
+ * CLI command for changing task position within a sibling group.
+ *
+ * @task T4454
+ */
+/**
+ * cleo reorder — change task position within sibling group.
+ *
+ * Supports `--top` (position 0), `--bottom` (position 999999), or
+ * explicit `--position <n>` for precise placement.
+ */
+export declare const reorderCommand: import("citty").CommandDef<{
+    readonly 'task-id': {
+        readonly type: "positional";
+        readonly description: "Task ID to reorder";
+        readonly required: true;
+    };
+    readonly position: {
+        readonly type: "string";
+        readonly description: "Move to specific zero-based position among siblings";
+    };
+    readonly top: {
+        readonly type: "boolean";
+        readonly description: "Move to the top (position 0)";
+    };
+    readonly bottom: {
+        readonly type: "boolean";
+        readonly description: "Move to the bottom";
+    };
+}>;
+//# sourceMappingURL=reorder.d.ts.map