@cleocode/cleo 2026.4.158 → 2026.5.0

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

@@ -0,0 +1,23 @@
+/**
+ * CLI sticky command group — quick project-wide ephemeral captures.
+ *
+ * Sticky notes fill the gap between session notes (bound to sessions),
+ * tasks (formal work items), and BRAIN observations (distilled knowledge).
+ *
+ *   cleo sticky add <content>    — create a sticky note (alias: jot)
+ *   cleo sticky list             — list active sticky notes (alias: ls)
+ *   cleo sticky show <id>        — show a specific sticky note
+ *   cleo sticky convert <id>     — convert to task or memory
+ *   cleo sticky archive <id>     — archive a sticky note
+ *   cleo sticky purge <id>       — permanently delete a sticky note
+ *
+ * @task T5281
+ * @epic T5267
+ */
+/**
+ * Root sticky command group — manage quick project-wide ephemeral captures.
+ *
+ * Aliases: `add` → `jot`, `list` → `ls` (duplicated subcommand keys per citty convention).
+ */
+export declare const stickyCommand: import("citty").CommandDef<import("citty").ArgsDef>;
+//# sourceMappingURL=sticky.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sticky.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/sticky.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAkUH;;;;GAIG;AACH,eAAO,MAAM,aAAa,qDAoBxB,CAAC"}

package/dist/cli/commands/sticky.js

@@ -0,0 +1,315 @@
+/**
+ * CLI sticky command group — quick project-wide ephemeral captures.
+ *
+ * Sticky notes fill the gap between session notes (bound to sessions),
+ * tasks (formal work items), and BRAIN observations (distilled knowledge).
+ *
+ *   cleo sticky add <content>    — create a sticky note (alias: jot)
+ *   cleo sticky list             — list active sticky notes (alias: ls)
+ *   cleo sticky show <id>        — show a specific sticky note
+ *   cleo sticky convert <id>     — convert to task or memory
+ *   cleo sticky archive <id>     — archive a sticky note
+ *   cleo sticky purge <id>       — permanently delete a sticky note
+ *
+ * @task T5281
+ * @epic T5267
+ */
+import { ExitCode } from '@cleocode/contracts';
+import { CleoError, formatError } from '@cleocode/core';
+import { defineCommand, showUsage } from 'citty';
+import { dispatchFromCli, dispatchRaw, handleRawError } from '../../dispatch/adapters/cli.js';
+import { cliOutput } from '../renderers/index.js';
+/** cleo sticky add <content> — create a new sticky note (alias: jot) */
+const addCommand = defineCommand({
+    meta: { name: 'add', description: 'Create a new sticky note' },
+    args: {
+        content: {
+            type: 'positional',
+            description: 'Sticky note content',
+            required: true,
+        },
+        tag: {
+            type: 'string',
+            description: 'Comma-separated tags (e.g. "bug,urgent")',
+        },
+        color: {
+            type: 'string',
+            description: 'Sticky color: yellow|blue|green|red|purple',
+            default: 'yellow',
+        },
+        priority: {
+            type: 'string',
+            description: 'Priority: low|medium|high',
+            default: 'medium',
+        },
+    },
+    async run({ args }) {
+        try {
+            const rawTag = args.tag;
+            const tags = rawTag
+                ? rawTag
+                    .split(',')
+                    .map((t) => t.trim())
+                    .filter(Boolean)
+                : [];
+            await dispatchFromCli('mutate', 'sticky', 'add', {
+                content: args.content,
+                tags,
+                color: args.color,
+                priority: args.priority,
+            }, { command: 'sticky', operation: 'sticky.add' });
+        }
+        catch (err) {
+            if (err instanceof CleoError) {
+                console.error(formatError(err));
+                process.exit(err.code);
+            }
+            throw err;
+        }
+    },
+});
+/** cleo sticky list — list active sticky notes (alias: ls) */
+const listCommand = defineCommand({
+    meta: { name: 'list', description: 'List active sticky notes' },
+    args: {
+        tag: {
+            type: 'string',
+            description: 'Filter by tags (comma-separated, e.g. "bug,urgent")',
+        },
+        color: {
+            type: 'string',
+            description: 'Filter by color',
+        },
+        status: {
+            type: 'string',
+            description: 'Filter by status: active|converted|archived',
+            default: 'active',
+        },
+        limit: {
+            type: 'string',
+            description: 'Max results',
+            default: '50',
+        },
+    },
+    async run({ args }) {
+        try {
+            const rawTag = args.tag;
+            const tags = rawTag
+                ? rawTag
+                    .split(',')
+                    .map((t) => t.trim())
+                    .filter(Boolean)
+                : undefined;
+            const response = await dispatchRaw('query', 'sticky', 'list', {
+                tags,
+                color: args.color,
+                status: args.status,
+                limit: Number.parseInt(args.limit, 10),
+            });
+            if (!response.success) {
+                handleRawError(response, { command: 'sticky list', operation: 'sticky.list' });
+                return;
+            }
+            const data = response.data;
+            if (!data?.stickies || data.stickies.length === 0) {
+                cliOutput({ stickies: [], total: 0 }, { command: 'sticky list', message: 'No sticky notes found', operation: 'sticky.list' });
+                process.exit(ExitCode.NO_DATA);
+                return;
+            }
+            cliOutput(data, { command: 'sticky list', operation: 'sticky.list', page: response.page });
+        }
+        catch (err) {
+            if (err instanceof CleoError) {
+                console.error(formatError(err));
+                process.exit(err.code);
+            }
+            throw err;
+        }
+    },
+});
+/** cleo sticky show <id> — show a specific sticky note */
+const showCommand = defineCommand({
+    meta: { name: 'show', description: 'Show a specific sticky note' },
+    args: {
+        id: {
+            type: 'positional',
+            description: 'Sticky note ID',
+            required: true,
+        },
+    },
+    async run({ args }) {
+        try {
+            const response = await dispatchRaw('query', 'sticky', 'show', {
+                stickyId: args.id,
+            });
+            if (!response.success) {
+                handleRawError(response, { command: 'sticky show', operation: 'sticky.show' });
+                return;
+            }
+            const data = response.data;
+            if (!data) {
+                cliOutput({ sticky: null }, {
+                    command: 'sticky show',
+                    message: `Sticky note not found: ${args.id}`,
+                    operation: 'sticky.show',
+                });
+                process.exit(ExitCode.NO_DATA);
+                return;
+            }
+            cliOutput({ sticky: data }, { command: 'sticky show', operation: 'sticky.show' });
+        }
+        catch (err) {
+            if (err instanceof CleoError) {
+                console.error(formatError(err));
+                process.exit(err.code);
+            }
+            throw err;
+        }
+    },
+});
+/** cleo sticky convert <id> — convert sticky note to task or memory */
+const convertCommand = defineCommand({
+    meta: { name: 'convert', description: 'Convert sticky note to task or memory' },
+    args: {
+        id: {
+            type: 'positional',
+            description: 'Sticky note ID to convert',
+            required: true,
+        },
+        'to-task': {
+            type: 'boolean',
+            description: 'Convert to a task',
+        },
+        'to-memory': {
+            type: 'boolean',
+            description: 'Convert to a memory observation',
+        },
+        title: {
+            type: 'string',
+            description: 'Title for the converted item (tasks only)',
+        },
+        type: {
+            type: 'string',
+            description: 'Memory type: pattern|learning|decision|observation (memory only)',
+            default: 'observation',
+        },
+        epic: {
+            type: 'string',
+            description: 'Epic ID for the new task (e.g., epic:T###)',
+        },
+    },
+    async run({ args }) {
+        try {
+            const toTask = args['to-task'];
+            const toMemory = args['to-memory'];
+            if (!toTask && !toMemory) {
+                console.error('Error: Must specify either --to-task or --to-memory');
+                process.exit(ExitCode.INVALID_INPUT);
+                return;
+            }
+            if (toTask && toMemory) {
+                console.error('Error: Cannot specify both --to-task and --to-memory');
+                process.exit(ExitCode.INVALID_INPUT);
+                return;
+            }
+            const convertParams = {
+                stickyId: args.id,
+                targetType: toTask ? 'task' : 'memory',
+            };
+            if (toTask) {
+                if (args.title)
+                    convertParams['title'] = args.title;
+                if (args.epic)
+                    convertParams['epic'] = args.epic;
+            }
+            if (toMemory) {
+                convertParams['memoryType'] = args.type;
+            }
+            await dispatchFromCli('mutate', 'sticky', 'convert', convertParams, {
+                command: 'sticky convert',
+                operation: 'sticky.convert',
+            });
+        }
+        catch (err) {
+            if (err instanceof CleoError) {
+                console.error(formatError(err));
+                process.exit(err.code);
+            }
+            throw err;
+        }
+    },
+});
+/** cleo sticky archive <id> — archive a sticky note */
+const archiveCommand = defineCommand({
+    meta: { name: 'archive', description: 'Archive a sticky note' },
+    args: {
+        id: {
+            type: 'positional',
+            description: 'Sticky note ID to archive',
+            required: true,
+        },
+    },
+    async run({ args }) {
+        try {
+            await dispatchFromCli('mutate', 'sticky', 'archive', { stickyId: args.id }, { command: 'sticky archive', operation: 'sticky.archive' });
+        }
+        catch (err) {
+            if (err instanceof CleoError) {
+                console.error(formatError(err));
+                process.exit(err.code);
+            }
+            throw err;
+        }
+    },
+});
+/** cleo sticky purge <id> — permanently delete a sticky note */
+const purgeCommand = defineCommand({
+    meta: { name: 'purge', description: 'Permanently delete a sticky note (cannot be undone)' },
+    args: {
+        id: {
+            type: 'positional',
+            description: 'Sticky note ID to purge',
+            required: true,
+        },
+    },
+    async run({ args }) {
+        try {
+            await dispatchFromCli('mutate', 'sticky', 'purge', { stickyId: args.id }, { command: 'sticky purge', operation: 'sticky.purge' });
+        }
+        catch (err) {
+            if (err instanceof CleoError) {
+                console.error(formatError(err));
+                process.exit(err.code);
+            }
+            throw err;
+        }
+    },
+});
+/**
+ * Root sticky command group — manage quick project-wide ephemeral captures.
+ *
+ * Aliases: `add` → `jot`, `list` → `ls` (duplicated subcommand keys per citty convention).
+ */
+export const stickyCommand = defineCommand({
+    meta: {
+        name: 'sticky',
+        description: 'Manage sticky notes - quick project-wide ephemeral captures',
+    },
+    subCommands: {
+        add: addCommand,
+        jot: addCommand,
+        list: listCommand,
+        ls: listCommand,
+        show: showCommand,
+        convert: convertCommand,
+        archive: archiveCommand,
+        purge: purgeCommand,
+    },
+    async run({ cmd, rawArgs }) {
+        const firstArg = rawArgs?.find((a) => !a.startsWith('-'));
+        if (firstArg && cmd.subCommands && firstArg in cmd.subCommands)
+            return;
+        await showUsage(cmd);
+    },
+});
+//# sourceMappingURL=sticky.js.map

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

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

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

@@ -0,0 +1,15 @@
+/**
+ * CLI stop command - stop working on the current task.
+ * @task T4756
+ * @epic T4732
+ */
+/**
+ * Native citty command for `cleo stop` — clears the active task from the
+ * current session, returning `{cleared: boolean, previousTask: string|null}`.
+ *
+ * @task T4756
+ * @task T4666
+ * @epic T487
+ */
+export declare const stopCommand: import("citty").CommandDef<import("citty").ArgsDef>;
+//# sourceMappingURL=stop.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"stop.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/stop.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH;;;;;;;GAOG;AACH,eAAO,MAAM,WAAW,qDAStB,CAAC"}

package/dist/cli/commands/stop.js

@@ -0,0 +1,25 @@
+/**
+ * CLI stop command - stop working on the current task.
+ * @task T4756
+ * @epic T4732
+ */
+import { defineCommand } from 'citty';
+import { dispatchFromCli } from '../../dispatch/adapters/cli.js';
+/**
+ * Native citty command for `cleo stop` — clears the active task from the
+ * current session, returning `{cleared: boolean, previousTask: string|null}`.
+ *
+ * @task T4756
+ * @task T4666
+ * @epic T487
+ */
+export const stopCommand = defineCommand({
+    meta: {
+        name: 'stop',
+        description: 'Stop working on the current task (clears the active task, returns {cleared: boolean, previousTask: string|null})',
+    },
+    async run() {
+        await dispatchFromCli('mutate', 'tasks', 'stop', {}, { command: 'stop' });
+    },
+});
+//# sourceMappingURL=stop.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"stop.js","sourceRoot":"","sources":["../../../src/cli/commands/stop.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AACtC,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAEjE;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,aAAa,CAAC;IACvC,IAAI,EAAE;QACJ,IAAI,EAAE,MAAM;QACZ,WAAW,EACT,kHAAkH;KACrH;IACD,KAAK,CAAC,GAAG;QACP,MAAM,eAAe,CAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;IAC5E,CAAC;CACF,CAAC,CAAC"}

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

@@ -0,0 +1,25 @@
+/**
+ * CLI sync command group — external task synchronisation management.
+ *
+ * Surfaces the tasks.sync sub-domain for inspecting and removing external
+ * task links, and for reconciling an external task list from a JSON file.
+ *
+ * Commands:
+ *   cleo sync links                        — list all external task links
+ *   cleo sync links --provider <id>        — filter by provider
+ *   cleo sync links --task <taskId>        — filter by CLEO task ID
+ *   cleo sync links remove <providerId>    — remove all links for a provider
+ *   cleo sync reconcile <file> --provider <id> [--conflict-policy <policy>]
+ *                                          — reconcile external tasks from a JSON file
+ *
+ * @task T473
+ * @task T483
+ * @epic T443
+ */
+/**
+ * Root sync command group — registers all sync subcommands.
+ *
+ * Dispatches to `tasks.sync.*` registry operations.
+ */
+export declare const syncCommand: import("citty").CommandDef<import("citty").ArgsDef>;
+//# sourceMappingURL=sync.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sync.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/sync.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAgHH;;;;GAIG;AACH,eAAO,MAAM,WAAW,qDAWtB,CAAC"}

package/dist/cli/commands/sync.js

@@ -0,0 +1,125 @@
+/**
+ * CLI sync command group — external task synchronisation management.
+ *
+ * Surfaces the tasks.sync sub-domain for inspecting and removing external
+ * task links, and for reconciling an external task list from a JSON file.
+ *
+ * Commands:
+ *   cleo sync links                        — list all external task links
+ *   cleo sync links --provider <id>        — filter by provider
+ *   cleo sync links --task <taskId>        — filter by CLEO task ID
+ *   cleo sync links remove <providerId>    — remove all links for a provider
+ *   cleo sync reconcile <file> --provider <id> [--conflict-policy <policy>]
+ *                                          — reconcile external tasks from a JSON file
+ *
+ * @task T473
+ * @task T483
+ * @epic T443
+ */
+import { ExitCode } from '@cleocode/contracts';
+import { defineCommand, showUsage } from 'citty';
+import { dispatchFromCli } from '../../dispatch/adapters/cli.js';
+/** cleo sync links remove — remove all external task links for a provider */
+const linksRemoveCommand = defineCommand({
+    meta: { name: 'remove', description: 'Remove all external task links for a provider' },
+    args: {
+        providerId: {
+            type: 'positional',
+            description: 'Provider ID whose links should be removed',
+            required: true,
+        },
+    },
+    async run({ args }) {
+        await dispatchFromCli('mutate', 'tasks', 'sync.links.remove', { providerId: args.providerId }, { command: 'sync', operation: 'tasks.sync.links.remove' });
+    },
+});
+/** cleo sync links — list external task links, with optional filters */
+const linksCommand = defineCommand({
+    meta: { name: 'links', description: 'List external task links' },
+    args: {
+        provider: {
+            type: 'string',
+            description: 'Filter links by provider (e.g. linear, jira, github)',
+        },
+        task: {
+            type: 'string',
+            description: 'Filter links by CLEO task ID',
+        },
+    },
+    subCommands: {
+        remove: linksRemoveCommand,
+    },
+    async run({ args }) {
+        const providerId = args.provider;
+        const taskId = args.task;
+        if (!providerId && !taskId) {
+            console.error('Error: at least one of --provider or --task is required for sync links list');
+            process.exit(ExitCode.INVALID_INPUT);
+        }
+        await dispatchFromCli('query', 'tasks', 'sync.links', { providerId, taskId }, { command: 'sync', operation: 'tasks.sync.links' });
+    },
+});
+/** cleo sync reconcile — reconcile external tasks from a JSON file against CLEO tasks */
+const reconcileCommand = defineCommand({
+    meta: {
+        name: 'reconcile',
+        description: 'Reconcile external tasks from a JSON file against CLEO tasks',
+    },
+    args: {
+        file: {
+            type: 'positional',
+            description: 'Path to JSON file containing external tasks array',
+            required: true,
+        },
+        provider: {
+            type: 'string',
+            description: 'Provider ID (e.g. linear, jira, github)',
+            required: true,
+        },
+        'conflict-policy': {
+            type: 'string',
+            description: 'How to resolve conflicts: keep-cleo, keep-external, or newest (default: keep-cleo)',
+            default: 'keep-cleo',
+        },
+    },
+    async run({ args }) {
+        const { readFileSync } = await import('node:fs');
+        let externalTasks;
+        try {
+            externalTasks = JSON.parse(readFileSync(args.file, 'utf8'));
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            console.error(`Failed to read or parse external tasks file: ${message}`);
+            process.exit(2);
+        }
+        if (!Array.isArray(externalTasks)) {
+            console.error('External tasks file must contain a JSON array');
+            process.exit(2);
+        }
+        await dispatchFromCli('mutate', 'tasks', 'sync.reconcile', {
+            providerId: args.provider,
+            externalTasks,
+            conflictPolicy: args['conflict-policy'],
+        }, { command: 'sync', operation: 'tasks.sync.reconcile' });
+    },
+});
+/**
+ * Root sync command group — registers all sync subcommands.
+ *
+ * Dispatches to `tasks.sync.*` registry operations.
+ */
+export const syncCommand = defineCommand({
+    meta: { name: 'sync', description: 'External task synchronisation management' },
+    subCommands: {
+        links: linksCommand,
+        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=sync.js.map

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

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

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

@@ -0,0 +1,22 @@
+/**
+ * CLI testing command group — validate testing protocol compliance.
+ *
+ * Ported from scripts/testing.sh
+ *
+ * Commands:
+ *   cleo testing validate <taskId>         — validate testing protocol for a task
+ *   cleo testing check <manifestFile>      — validate from a manifest file
+ *   cleo testing status                    — show test suite status
+ *   cleo testing coverage                  — show test coverage
+ *   cleo testing run                       — run test suite
+ *
+ * @task T4551
+ * @epic T4545
+ */
+/**
+ * Root testing command group — registers all testing subcommands.
+ *
+ * Dispatches to `check.*` registry operations.
+ */
+export declare const testingCommand: import("citty").CommandDef<import("citty").ArgsDef>;
+//# sourceMappingURL=testing.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"testing.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/testing.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAgHH;;;;GAIG;AACH,eAAO,MAAM,cAAc,qDAczB,CAAC"}