@cleocode/cleo 2026.4.11 → 2026.4.13

package/dist/cli/commands/complete.js

@@ -4,23 +4,72 @@
  * @epic T4454
  */
 import { dispatchRaw, handleRawError } from '../../dispatch/adapters/cli.js';
+import { applyParamDefsToCommand, buildOperationHelp } from '../help-generator.js';
 import { cliOutput } from '../renderers/index.js';
+// ---------------------------------------------------------------------------
+// ParamDef array for tasks.complete
+//
+// Mirrors STATIC_PARAMS_TABLE in packages/lafs/src/operation-gates.ts.
+// Will be upstreamed into registry.ts during the T4897 migration.
+// ---------------------------------------------------------------------------
+const COMPLETE_PARAMS = [
+    {
+        name: 'taskId',
+        type: 'string',
+        required: true,
+        description: 'ID of the task to complete',
+        cli: { positional: true },
+    },
+    {
+        name: 'notes',
+        type: 'string',
+        required: false,
+        description: 'Completion notes',
+        cli: { flag: 'notes' },
+    },
+    {
+        name: 'changeset',
+        type: 'string',
+        required: false,
+        description: 'Changeset reference',
+        cli: { flag: 'changeset' },
+    },
+    {
+        name: 'force',
+        type: 'boolean',
+        required: false,
+        description: 'Force completion even when children are not done or dependencies unresolved',
+        cli: { flag: 'force' },
+    },
+    {
+        name: 'verificationNote',
+        type: 'string',
+        required: false,
+        description: 'Evidence that acceptance criteria were met',
+        cli: { flag: 'verification-note' },
+    },
+];
 /**
  * Register the complete command.
  * @task T4461
  */
 export function registerCompleteCommand(program) {
-    program
-        .command('complete <taskId>')
+    const cmd = program
+        .command('complete')
         .alias('done')
-        .description('Mark a task as completed')
-        .option('--notes <note>', 'Completion notes')
-        .option('--changeset <changeset>', 'Changeset reference')
-        .action(async (taskId, opts) => {
+        .description(buildOperationHelp('tasks.complete', 'Mark a task as completed', COMPLETE_PARAMS));
+    // Auto-generate <taskId> positional arg and flag options from the ParamDef
+    // registry.  Replaces hand-written .option('--notes', ...) etc. and surfaces
+    // the children-completion, dependency-check, and verification-required gates
+    // in --help output.
+    applyParamDefsToCommand(cmd, COMPLETE_PARAMS, 'tasks.complete');
+    cmd.action(async (taskId, opts) => {
         const response = await dispatchRaw('mutate', 'tasks', 'complete', {
             taskId,
             notes: opts['notes'],
             changeset: opts['changeset'],
+            force: opts['force'],
+            verificationNote: opts['verificationNote'],
         });
         if (!response.success) {
             handleRawError(response, { command: 'complete', operation: 'tasks.complete' });

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

@@ -1 +1 @@
-{"version":3,"file":"complete.js","sourceRoot":"","sources":["../../../src/cli/commands/complete.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAE7E,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAElD;;;GAGG;AACH,MAAM,UAAU,uBAAuB,CAAC,OAAgB;IACtD,OAAO;SACJ,OAAO,CAAC,mBAAmB,CAAC;SAC5B,KAAK,CAAC,MAAM,CAAC;SACb,WAAW,CAAC,0BAA0B,CAAC;SACvC,MAAM,CAAC,gBAAgB,EAAE,kBAAkB,CAAC;SAC5C,MAAM,CAAC,yBAAyB,EAAE,qBAAqB,CAAC;SACxD,MAAM,CAAC,KAAK,EAAE,MAAc,EAAE,IAA6B,EAAE,EAAE;QAC9D,MAAM,QAAQ,GAAG,MAAM,WAAW,CAAC,QAAQ,EAAE,OAAO,EAAE,UAAU,EAAE;YAChE,MAAM;YACN,KAAK,EAAE,IAAI,CAAC,OAAO,CAAuB;YAC1C,SAAS,EAAE,IAAI,CAAC,WAAW,CAAuB;SACnD,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;YACtB,cAAc,CAAC,QAAQ,EAAE,EAAE,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,gBAAgB,EAAE,CAAC,CAAC;QACjF,CAAC;QAED,MAAM,IAAI,GAAG,QAAQ,CAAC,IAA2C,CAAC;QAClE,8DAA8D;QAC9D,MAAM,IAAI,GAAG,IAAI,EAAE,IAAI,IAAI,IAAI,CAAC;QAChC,MAAM,MAAM,GAA4B,EAAE,IAAI,EAAE,CAAC;QACjD,MAAM,aAAa,GAAG,IAAI,EAAE,aAAa,CAAC;QAC1C,IAAI,KAAK,CAAC,OAAO,CAAC,aAAa,CAAC,IAAI,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC7D,MAAM,CAAC,eAAe,CAAC,GAAG,aAAa,CAAC;QAC1C,CAAC;QACD,MAAM,cAAc,GAAG,IAAI,EAAE,cAAc,CAAC;QAC5C,IAAI,KAAK,CAAC,OAAO,CAAC,cAAc,CAAC,IAAI,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC/D,MAAM,CAAC,gBAAgB,CAAC,GAAG,cAAc,CAAC;QAC5C,CAAC;QAED,SAAS,CAAC,MAAM,EAAE,EAAE,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,gBAAgB,EAAE,CAAC,CAAC;IAC1E,CAAC,CAAC,CAAC;AACP,CAAC"}
+{"version":3,"file":"complete.js","sourceRoot":"","sources":["../../../src/cli/commands/complete.ts"],"names":[],"mappings":"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"}

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

@@ -1 +1 @@
-{"version":3,"file":"find.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/find.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EAAE,WAAW,IAAI,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAGnE;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAoD1D"}
+{"version":3,"file":"find.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/find.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,OAAO,KAAK,EAAE,WAAW,IAAI,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAuEnE;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAqD1D"}

package/dist/cli/commands/find.js

@@ -7,24 +7,88 @@
 import { ExitCode } from '@cleocode/contracts';
 import { createPage } from '@cleocode/core';
 import { dispatchRaw, handleRawError } from '../../dispatch/adapters/cli.js';
+import { applyParamDefsToCommand, buildOperationHelp } from '../help-generator.js';
 import { cliOutput } from '../renderers/index.js';
+// ---------------------------------------------------------------------------
+// ParamDef array for tasks.find
+//
+// The registry entry for tasks.find lacks a params array (T4897 migration
+// pending).  This local definition is the CLI-visible source of truth until
+// the upstream migration completes.
+// ---------------------------------------------------------------------------
+const FIND_PARAMS = [
+    {
+        name: 'query',
+        type: 'string',
+        required: false,
+        description: 'Fuzzy search query (title/description)',
+        cli: { positional: true },
+    },
+    {
+        name: 'id',
+        type: 'string',
+        required: false,
+        description: 'Search by ID prefix',
+        cli: { flag: 'id' },
+    },
+    {
+        name: 'exact',
+        type: 'boolean',
+        required: false,
+        description: 'Exact title match',
+        cli: { flag: 'exact' },
+    },
+    {
+        name: 'status',
+        type: 'string',
+        required: false,
+        description: 'Filter by status',
+        enum: ['pending', 'active', 'blocked', 'done', 'cancelled'],
+        cli: { flag: 'status' },
+    },
+    {
+        name: 'field',
+        type: 'string',
+        required: false,
+        description: 'Field to search in (title, description, etc.)',
+        cli: { flag: 'in' },
+    },
+    {
+        name: 'includeArchive',
+        type: 'boolean',
+        required: false,
+        description: 'Include archived tasks',
+        cli: { flag: 'include-archive' },
+    },
+    {
+        name: 'limit',
+        type: 'number',
+        required: false,
+        description: 'Max results (default: 20)',
+        cli: { flag: 'limit', parse: parseInt },
+    },
+    {
+        name: 'offset',
+        type: 'number',
+        required: false,
+        description: 'Skip first N results',
+        cli: { flag: 'offset', parse: parseInt },
+    },
+];
 /**
  * Register the find command.
  * @task T4460
  * @task T4668
  */
 export function registerFindCommand(program) {
-    program
-        .command('find [query]')
-        .description('Fuzzy search tasks by title/description')
-        .option('--id <id>', 'Search by ID prefix')
-        .option('--exact', 'Exact title match')
-        .option('--status <status>', 'Filter by status')
-        .option('--in <field>', 'Field to search in (title, description, etc.)')
-        .option('--include-archive', 'Include archived tasks')
-        .option('--limit <n>', 'Max results (default: 20)', parseInt)
-        .option('--offset <n>', 'Skip first N results', parseInt)
-        .action(async (query, opts) => {
+    const cmd = program
+        .command('find')
+        .description(buildOperationHelp('tasks.find', 'Fuzzy search tasks by title/description', FIND_PARAMS));
+    // Auto-generate [query] positional arg and flag options from the ParamDef
+    // registry.  Replaces the previous hand-written .option() chain and surfaces
+    // enum values (e.g. status) in --help output.
+    applyParamDefsToCommand(cmd, FIND_PARAMS, 'tasks.find');
+    cmd.action(async (query, opts) => {
         const limit = opts['limit'];
         const offset = opts['offset'];
         const params = {};

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

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

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

@@ -1 +1 @@
-{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/list.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EAAE,WAAW,IAAI,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAGnE;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAoD1D"}
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/list.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,OAAO,KAAK,EAAE,WAAW,IAAI,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAiFnE;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAiD1D"}

package/dist/cli/commands/list.js

@@ -7,27 +7,99 @@
 import { ExitCode } from '@cleocode/contracts';
 import { createPage } from '@cleocode/core';
 import { dispatchRaw, handleRawError } from '../../dispatch/adapters/cli.js';
+import { applyParamDefsToCommand, buildOperationHelp } from '../help-generator.js';
 import { cliOutput } from '../renderers/index.js';
+// ---------------------------------------------------------------------------
+// ParamDef array for tasks.list
+//
+// The registry entry for tasks.list has a params array (already migrated in
+// T4897 partial work), but it is reproduced here as ParamDef objects so that
+// applyParamDefsToCommand can wire the CLI flags with short aliases and parse
+// functions that the plain registry entry omits.
+// ---------------------------------------------------------------------------
+const LIST_PARAMS = [
+    {
+        name: 'status',
+        type: 'string',
+        required: false,
+        description: 'Filter by status',
+        enum: ['pending', 'active', 'blocked', 'done', 'cancelled'],
+        cli: { flag: 'status' },
+    },
+    {
+        name: 'priority',
+        type: 'string',
+        required: false,
+        description: 'Filter by priority',
+        enum: ['low', 'medium', 'high', 'critical'],
+        cli: { flag: 'priority' },
+    },
+    {
+        name: 'type',
+        type: 'string',
+        required: false,
+        description: 'Filter by task type',
+        enum: ['epic', 'task', 'subtask', 'bug'],
+        cli: { flag: 'type' },
+    },
+    {
+        name: 'parent',
+        type: 'string',
+        required: false,
+        description: 'Filter by parent task ID',
+        cli: { flag: 'parent' },
+    },
+    {
+        name: 'phase',
+        type: 'string',
+        required: false,
+        description: 'Filter by phase slug',
+        cli: { flag: 'phase' },
+    },
+    {
+        name: 'label',
+        type: 'string',
+        required: false,
+        description: 'Filter by label',
+        cli: { flag: 'label' },
+    },
+    {
+        name: 'children',
+        type: 'boolean',
+        required: false,
+        description: 'Show direct children only (requires --parent)',
+        cli: { flag: 'children' },
+    },
+    {
+        name: 'limit',
+        type: 'number',
+        required: false,
+        description: 'Limit number of results',
+        cli: { flag: 'limit', parse: parseInt },
+    },
+    {
+        name: 'offset',
+        type: 'number',
+        required: false,
+        description: 'Skip first N results',
+        cli: { flag: 'offset', parse: parseInt },
+    },
+];
 /**
  * Register the list command.
  * @task T4460
  * @task T4668
  */
 export function registerListCommand(program) {
-    program
+    const cmd = program
         .command('list')
         .alias('ls')
-        .description('List tasks with optional filters')
-        .option('--status <status>', 'Filter by status')
-        .option('--priority <priority>', 'Filter by priority')
-        .option('--type <type>', 'Filter by type')
-        .option('--parent <id>', 'Filter by parent ID')
-        .option('--phase <phase>', 'Filter by phase')
-        .option('--label <label>', 'Filter by label')
-        .option('--children', 'Show direct children only (requires --parent)')
-        .option('--limit <n>', 'Limit number of results', parseInt)
-        .option('--offset <n>', 'Skip first N results', parseInt)
-        .action(async (opts) => {
+        .description(buildOperationHelp('tasks.list', 'List tasks with optional filters', LIST_PARAMS));
+    // Auto-generate flag options from the ParamDef registry.  Replaces the
+    // previous hand-written .option() chain and surfaces enum values (status,
+    // priority, type) in --help output.
+    applyParamDefsToCommand(cmd, LIST_PARAMS, 'tasks.list');
+    cmd.action(async (opts) => {
         const limit = opts['limit'];
         const offset = opts['offset'];
         const params = {};

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

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

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

@@ -3,6 +3,9 @@
  * Saves an observation to brain.db via the memory system.
  *
  * Provides CLI parity for the `mutate memory observe` dispatch operation.
+ *
+ * @task T338 — migrated from custom {success, result} envelope to canonical
+ *   CliEnvelope via cliOutput() (ADR-039).
  */
 import type { ShimCommand as Command } from '../commander-shim.js';
 export declare function registerObserveCommand(program: Command): void;

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

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

package/dist/cli/commands/observe.js

@@ -3,8 +3,12 @@
  * Saves an observation to brain.db via the memory system.
  *
  * Provides CLI parity for the `mutate memory observe` dispatch operation.
+ *
+ * @task T338 — migrated from custom {success, result} envelope to canonical
+ *   CliEnvelope via cliOutput() (ADR-039).
  */
 import { getProjectRoot } from '@cleocode/core';
+import { cliError, cliOutput } from '../renderers/index.js';
 export function registerObserveCommand(program) {
     program
         .command('observe <text>')
@@ -21,17 +25,16 @@ export function registerObserveCommand(program) {
                 type: opts.type,
                 sourceType: 'manual',
             });
-            process.stdout.write(JSON.stringify({
-                success: true,
-                result: {
-                    id: result.id,
-                    type: result.type,
-                    createdAt: result.createdAt,
-                },
-            }) + '\n');
+            // Use cliOutput to emit the canonical CliEnvelope shape (ADR-039).
+            // Replaces the previous custom {success, result} output.
+            cliOutput({
+                id: result.id,
+                type: result.type,
+                createdAt: result.createdAt,
+            }, { command: 'observe', operation: 'memory.observe' });
         }
         catch (err) {
-            process.stderr.write(`Error: ${err instanceof Error ? err.message : String(err)}\n`);
+            cliError(err instanceof Error ? err.message : String(err), 1);
             process.exitCode = 1;
         }
     });

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

@@ -1 +1 @@
-{"version":3,"file":"observe.js","sourceRoot":"","sources":["../../../src/cli/commands/observe.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAGhD,MAAM,UAAU,sBAAsB,CAAC,OAAgB;IACrD,OAAO;SACJ,OAAO,CAAC,gBAAgB,CAAC;SACzB,WAAW,CAAC,iCAAiC,CAAC;SAC9C,MAAM,CAAC,qBAAqB,EAAE,sDAAsD,CAAC;SACrF,MAAM,CACL,eAAe,EACf,qGAAqG,CACtG;SACA,MAAM,CAAC,KAAK,EAAE,IAAY,EAAE,IAAuC,EAAE,EAAE;QACtE,MAAM,UAAU,GAAG,cAAc,EAAE,CAAC;QACpC,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,MAAM,CAAC,gBAAgB,CAAC,CAAC;QAExD,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,UAAU,EAAE;gBAC5C,IAAI;gBACJ,KAAK,EAAE,IAAI,CAAC,KAAK;gBACjB,IAAI,EAAE,IAAI,CAAC,IAAkD;gBAC7D,UAAU,EAAE,QAAQ;aACrB,CAAC,CAAC;YAEH,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,IAAI,CAAC,SAAS,CAAC;gBACb,OAAO,EAAE,IAAI;gBACb,MAAM,EAAE;oBACN,EAAE,EAAE,MAAM,CAAC,EAAE;oBACb,IAAI,EAAE,MAAM,CAAC,IAAI;oBACjB,SAAS,EAAE,MAAM,CAAC,SAAS;iBAC5B;aACF,CAAC,GAAG,IAAI,CACV,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YACrF,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;QACvB,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC"}
+{"version":3,"file":"observe.js","sourceRoot":"","sources":["../../../src/cli/commands/observe.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEhD,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAE5D,MAAM,UAAU,sBAAsB,CAAC,OAAgB;IACrD,OAAO;SACJ,OAAO,CAAC,gBAAgB,CAAC;SACzB,WAAW,CAAC,iCAAiC,CAAC;SAC9C,MAAM,CAAC,qBAAqB,EAAE,sDAAsD,CAAC;SACrF,MAAM,CACL,eAAe,EACf,qGAAqG,CACtG;SACA,MAAM,CAAC,KAAK,EAAE,IAAY,EAAE,IAAuC,EAAE,EAAE;QACtE,MAAM,UAAU,GAAG,cAAc,EAAE,CAAC;QACpC,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,MAAM,CAAC,gBAAgB,CAAC,CAAC;QAExD,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,UAAU,EAAE;gBAC5C,IAAI;gBACJ,KAAK,EAAE,IAAI,CAAC,KAAK;gBACjB,IAAI,EAAE,IAAI,CAAC,IAAkD;gBAC7D,UAAU,EAAE,QAAQ;aACrB,CAAC,CAAC;YAEH,mEAAmE;YACnE,yDAAyD;YACzD,SAAS,CACP;gBACE,EAAE,EAAE,MAAM,CAAC,EAAE;gBACb,IAAI,EAAE,MAAM,CAAC,IAAI;gBACjB,SAAS,EAAE,MAAM,CAAC,SAAS;aAC5B,EACD,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,gBAAgB,EAAE,CACpD,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,QAAQ,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;YAC9D,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;QACvB,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC"}

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

@@ -5,6 +5,7 @@
  * @task T4795
  * @task T4904
  * @task T5329
+ * @task T306 — added --scope flag to restore backup (epic T299)
  */
 import type { ShimCommand as Command } from '../commander-shim.js';
 export declare function registerRestoreCommand(program: Command): void;

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

@@ -1 +1 @@
-{"version":3,"file":"restore.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/restore.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,OAAO,KAAK,EAAE,WAAW,IAAI,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAGnE,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAsQ7D"}
+{"version":3,"file":"restore.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/restore.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,OAAO,KAAK,EAAE,WAAW,IAAI,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAGnE,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA6Q7D"}

package/dist/cli/commands/restore.js

@@ -5,6 +5,7 @@
  * @task T4795
  * @task T4904
  * @task T5329
+ * @task T306 — added --scope flag to restore backup (epic T299)
  */
 import { ExitCode } from '@cleocode/contracts';
 import { CleoError, formatError, getAccessor } from '@cleocode/core';
@@ -20,13 +21,16 @@ export function registerRestoreCommand(program) {
         .description('Restore todo files from backup')
         .option('--file <name>', 'Specific file to restore (tasks.db, config.json, etc.)')
         .option('--dry-run', 'Preview what would be restored')
+        .option('--scope <scope>', 'Backup scope to restore from: project or global (default: project)', 'project')
         .action(async (opts) => {
         try {
             const fileName = opts['file'] || 'tasks.db';
+            const scope = opts['scope'] || 'project';
             const response = await dispatchRaw('mutate', 'admin', 'backup', {
                 action: 'restore',
                 file: fileName,
                 dryRun: opts['dryRun'],
+                scope,
             });
             if (!response.success) {
                 const code = ExitCode[response.error?.code] ?? ExitCode.GENERAL_ERROR;

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

@@ -1 +1 @@
-{"version":3,"file":"restore.js","sourceRoot":"","sources":["../../../src/cli/commands/restore.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"restore.js","sourceRoot":"","sources":["../../../src/cli/commands/restore.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AACrE,OAAO,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAE7D,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAElD,MAAM,UAAU,sBAAsB,CAAC,OAAgB;IACrD,MAAM,UAAU,GAAG,OAAO;SACvB,OAAO,CAAC,SAAS,CAAC;SAClB,WAAW,CACV,4FAA4F,CAC7F,CAAC;IAEJ,6BAA6B;IAC7B,UAAU;SACP,OAAO,CAAC,QAAQ,CAAC;SACjB,WAAW,CAAC,gCAAgC,CAAC;SAC7C,MAAM,CAAC,eAAe,EAAE,wDAAwD,CAAC;SACjF,MAAM,CAAC,WAAW,EAAE,gCAAgC,CAAC;SACrD,MAAM,CACL,iBAAiB,EACjB,oEAAoE,EACpE,SAAS,CACV;SACA,MAAM,CAAC,KAAK,EAAE,IAA6B,EAAE,EAAE;QAC9C,IAAI,CAAC;YACH,MAAM,QAAQ,GAAI,IAAI,CAAC,MAAM,CAAY,IAAI,UAAU,CAAC;YACxD,MAAM,KAAK,GAAI,IAAI,CAAC,OAAO,CAAY,IAAI,SAAS,CAAC;YAErD,MAAM,QAAQ,GAAG,MAAM,WAAW,CAAC,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE;gBAC9D,MAAM,EAAE,SAAS;gBACjB,IAAI,EAAE,QAAQ;gBACd,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAwB;gBAC7C,KAAK;aACN,CAAC,CAAC;YAEH,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;gBACtB,MAAM,IAAI,GACR,QAAQ,CAAC,QAAQ,CAAC,KAAK,EAAE,IAA6B,CAAC,IAAI,QAAQ,CAAC,aAAa,CAAC;gBACpF,MAAM,IAAI,SAAS,CAAC,IAAI,EAAE,QAAQ,CAAC,KAAK,EAAE,OAAO,IAAI,uBAAuB,CAAC,CAAC;YAChF,CAAC;YAED,MAAM,IAAI,GAAG,QAAQ,CAAC,IAA+B,CAAC;YAEtD,IAAI,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;gBACnB,SAAS,CACP;oBACE,MAAM,EAAE,IAAI;oBACZ,IAAI,EAAE,QAAQ;oBACd,YAAY,EAAE,IAAI,EAAE,IAAI;oBACxB,UAAU,EAAE,IAAI,EAAE,UAAU;iBAC7B,EACD;oBACE,OAAO,EAAE,SAAS;oBAClB,OAAO,EAAE,2BAA2B;oBACpC,SAAS,EAAE,sBAAsB;iBAClC,CACF,CAAC;gBACF,OAAO;YACT,CAAC;YAED,SAAS,CACP;gBACE,QAAQ,EAAE,IAAI;gBACd,IAAI,EAAE,QAAQ;gBACd,YAAY,EAAE,IAAI,EAAE,IAAI;gBACxB,UAAU,EAAE,IAAI,EAAE,UAAU;aAC7B,EACD,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,sBAAsB,EAAE,CAC1D,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,GAAG,YAAY,SAAS,EAAE,CAAC;gBAC7B,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC;gBAChC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YACzB,CAAC;YACD,MAAM,GAAG,CAAC;QACZ,CAAC;IACH,CAAC,CAAC,CAAC;IAEL,4EAA4E;IAC5E,UAAU;SACP,OAAO,CAAC,gBAAgB,CAAC;SACzB,WAAW,CACV,qFAAqF,CACtF;SACA,MAAM,CAAC,mBAAmB,EAAE,8CAA8C,EAAE,SAAS,CAAC;SACtF,MAAM,CAAC,mBAAmB,EAAE,+BAA+B,CAAC;SAC5D,MAAM,CAAC,mBAAmB,EAAE,yCAAyC,CAAC;SACtE,MAAM,CAAC,WAAW,EAAE,kCAAkC,CAAC;SACvD,MAAM,CAAC,KAAK,EAAE,MAAc,EAAE,IAA6B,EAAE,EAAE;QAC9D,IAAI,CAAC;YACH,MAAM,SAAS,GAAG,WAAW,CAAC;YAC9B,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC5B,MAAM,IAAI,SAAS,CAAC,QAAQ,CAAC,aAAa,EAAE,oBAAoB,MAAM,EAAE,CAAC,CAAC;YAC5E,CAAC;YAED,MAAM,QAAQ,GAAG,MAAM,WAAW,EAAE,CAAC;YAErC,8CAA8C;YAC9C,MAAM,UAAU,GAAG,MAAM,QAAQ,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;YAEzD,IAAI,UAAU,EAAE,CAAC;gBACf,kEAAkE;gBAClE,IAAI,UAAU,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;oBACtC,IAAI,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;wBACnB,SAAS,CACP;4BACE,MAAM,EAAE,IAAI;4BACZ,MAAM;4BACN,KAAK,EAAE,UAAU,CAAC,KAAK;4BACvB,cAAc,EAAE,UAAU,CAAC,MAAM;4BACjC,SAAS,EAAE,IAAI,CAAC,gBAAgB,CAAC;gCAC/B,CAAC,CAAC,UAAU,CAAC,MAAM;gCACnB,CAAC,CAAE,IAAI,CAAC,QAAQ,CAAY;4BAC9B,MAAM,EAAE,cAAc;yBACvB,EACD;4BACE,OAAO,EAAE,SAAS;4BAClB,OAAO,EAAE,2BAA2B;4BACpC,SAAS,EAAE,eAAe;yBAC3B,CACF,CAAC;wBACF,OAAO;oBACT,CAAC;oBACD,MAAM,QAAQ,GAAG,MAAM,WAAW,CAAC,QAAQ,EAAE,OAAO,EAAE,SAAS,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;oBAC7E,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;wBACtB,MAAM,IAAI,GACR,QAAQ,CAAC,QAAQ,CAAC,KAAK,EAAE,IAA6B,CAAC,IAAI,QAAQ,CAAC,aAAa,CAAC;wBACpF,MAAM,IAAI,SAAS,CAAC,IAAI,EAAE,QAAQ,CAAC,KAAK,EAAE,OAAO,IAAI,qBAAqB,CAAC,CAAC;oBAC9E,CAAC;oBACD,MAAM,UAAU,GAAG,QAAQ,CAAC,IAA+B,CAAC;oBAC5D,SAAS,CACP;wBACE,QAAQ,EAAE,IAAI;wBACd,MAAM,EAAE,UAAU,EAAE,IAAI;wBACxB,KAAK,EAAE,UAAU,EAAE,KAAK;wBACxB,MAAM,EAAE,cAAc;qBACvB,EACD,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,eAAe,EAAE,CACnD,CAAC;oBACF,OAAO;gBACT,CAAC;qBAAM,IAAI,UAAU,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;oBACxC,IAAI,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;wBACnB,MAAM,SAAS,GAAG,IAAI,CAAC,gBAAgB,CAAC;4BACtC,CAAC,CAAC,UAAU,CAAC,MAAM;4BACnB,CAAC,CAAE,IAAI,CAAC,QAAQ,CAAY,CAAC;wBAC/B,SAAS,CACP;4BACE,MAAM,EAAE,IAAI;4BACZ,MAAM;4BACN,KAAK,EAAE,UAAU,CAAC,KAAK;4BACvB,cAAc,EAAE,UAAU,CAAC,MAAM;4BACjC,SAAS;4BACT,MAAM,EAAE,cAAc;yBACvB,EACD;4BACE,OAAO,EAAE,SAAS;4BAClB,OAAO,EAAE,2BAA2B;4BACpC,SAAS,EAAE,eAAe;yBAC3B,CACF,CAAC;wBACF,OAAO;oBACT,CAAC;oBACD,MAAM,YAAY,GAAG,IAAI,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAE,IAAI,CAAC,QAAQ,CAAY,CAAC;oBACrF,MAAM,QAAQ,GAAG,MAAM,WAAW,CAAC,QAAQ,EAAE,OAAO,EAAE,SAAS,EAAE;wBAC/D,MAAM;wBACN,IAAI,EAAE,MAAM;wBACZ,MAAM,EAAE,YAAY;wBACpB,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAuB;qBAC7C,CAAC,CAAC;oBACH,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;wBACtB,MAAM,IAAI,GACR,QAAQ,CAAC,QAAQ,CAAC,KAAK,EAAE,IAA6B,CAAC,IAAI,QAAQ,CAAC,aAAa,CAAC;wBACpF,MAAM,IAAI,SAAS,CAAC,IAAI,EAAE,QAAQ,CAAC,KAAK,EAAE,OAAO,IAAI,qBAAqB,CAAC,CAAC;oBAC9E,CAAC;oBACD,MAAM,UAAU,GAAG,QAAQ,CAAC,IAA+B,CAAC;oBAC5D,SAAS,CACP;wBACE,QAAQ,EAAE,IAAI;wBACd,MAAM,EAAE,UAAU,EAAE,IAAI;wBACxB,cAAc,EAAE,UAAU,EAAE,cAAc;wBAC1C,SAAS,EAAE,UAAU,EAAE,SAAS;wBAChC,MAAM,EAAE,cAAc;qBACvB,EACD,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,eAAe,EAAE,CACnD,CAAC;oBACF,OAAO;gBACT,CAAC;qBAAM,CAAC;oBACN,MAAM,IAAI,SAAS,CACjB,QAAQ,CAAC,gBAAgB,EACzB,QAAQ,MAAM,mCAAmC,UAAU,CAAC,MAAM,EAAE,CACrE,CAAC;gBACJ,CAAC;YACH,CAAC;YAED,0CAA0C;YAC1C,IAAI,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;gBACnB,MAAM,WAAW,GAAG,MAAM,QAAQ,CAAC,WAAW,EAAE,CAAC;gBACjD,IAAI,WAAW,EAAE,CAAC;oBAChB,MAAM,aAAa,GAAG,WAAW,CAAC,aAErB,CAAC;oBACd,IAAI,KAAK,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE,CAAC;wBACjC,MAAM,IAAI,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,MAAM,CAAC,CAAC;wBACxD,IAAI,IAAI,EAAE,CAAC;4BACT,SAAS,CACP;gCACE,MAAM,EAAE,IAAI;gCACZ,MAAM;gCACN,KAAK,EAAE,IAAI,CAAC,KAAK;gCACjB,cAAc,EAAE,IAAI,CAAC,MAAM;gCAC3B,SAAS,EAAE,IAAI,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAE,IAAI,CAAC,QAAQ,CAAY;gCAC5E,MAAM,EAAE,SAAS;6BAClB,EACD;gCACE,OAAO,EAAE,SAAS;gCAClB,OAAO,EAAE,2BAA2B;gCACpC,SAAS,EAAE,eAAe;6BAC3B,CACF,CAAC;4BACF,OAAO;wBACT,CAAC;oBACH,CAAC;gBACH,CAAC;gBACD,MAAM,IAAI,SAAS,CACjB,QAAQ,CAAC,SAAS,EAClB,QAAQ,MAAM,uCAAuC,EACrD;oBACE,GAAG,EAAE,cAAc,MAAM,0BAA0B;iBACpD,CACF,CAAC;YACJ,CAAC;YAED,qCAAqC;YACrC,IAAI,CAAC;gBACH,MAAM,YAAY,GAAG,IAAI,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAE,IAAI,CAAC,QAAQ,CAAY,CAAC;gBACrF,MAAM,QAAQ,GAAG,MAAM,WAAW,CAAC,QAAQ,EAAE,OAAO,EAAE,SAAS,EAAE;oBAC/D,MAAM;oBACN,IAAI,EAAE,SAAS;oBACf,MAAM,EAAE,YAAY;oBACpB,cAAc,EAAE,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC;iBACzC,CAAC,CAAC;gBACH,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;oBACtB,MAAM,IAAI,GACR,QAAQ,CAAC,QAAQ,CAAC,KAAK,EAAE,IAA6B,CAAC,IAAI,QAAQ,CAAC,aAAa,CAAC;oBACpF,MAAM,IAAI,SAAS,CAAC,IAAI,EAAE,QAAQ,CAAC,KAAK,EAAE,OAAO,IAAI,uBAAuB,CAAC,CAAC;gBAChF,CAAC;gBACD,MAAM,UAAU,GAAG,QAAQ,CAAC,IAA+B,CAAC;gBAC5D,SAAS,CACP;oBACE,QAAQ,EAAE,IAAI;oBACd,MAAM,EAAE,UAAU,EAAE,IAAI;oBACxB,KAAK,EAAE,UAAU,EAAE,KAAK;oBACxB,SAAS,EAAE,UAAU,EAAE,MAAM;oBAC7B,MAAM,EAAE,SAAS;iBAClB,EACD,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,eAAe,EAAE,CACnD,CAAC;YACJ,CAAC;YAAC,MAAM,CAAC;gBACP,MAAM,IAAI,SAAS,CACjB,QAAQ,CAAC,SAAS,EAClB,QAAQ,MAAM,uCAAuC,EACrD;oBACE,GAAG,EAAE,cAAc,MAAM,0BAA0B;iBACpD,CACF,CAAC;YACJ,CAAC;QACH,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,GAAG,YAAY,SAAS,EAAE,CAAC;gBAC7B,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC;gBAChC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YACzB,CAAC;YACD,MAAM,GAAG,CAAC;QACZ,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC"}

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

@@ -0,0 +1,27 @@
+/**
+ * CLI `schema` command — operation introspection for agents.
+ *
+ * Allows agents to inspect the full parameter signature and declared precondition
+ * gates for any CLEO operation before calling it, replacing trial-and-error.
+ *
+ * Usage:
+ *   cleo schema <domain.operation>
+ *   cleo schema tasks.add
+ *   cleo schema tasks.add --format human
+ *   cleo schema tasks.add --include-examples
+ *
+ * @task T340
+ * @epic T335
+ */
+import type { ShimCommand as Command } from '../commander-shim.js';
+/**
+ * Register the `cleo schema <operation>` command.
+ *
+ * @param program - The root ShimCommand to register against.
+ *
+ * @remarks
+ * Does NOT dispatch through the main dispatcher — schema introspection is
+ * pure metadata over the registry and does not require a live session or DB.
+ */
+export declare function registerSchemaCommand(program: Command): void;
+//# sourceMappingURL=schema.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAKH,OAAO,KAAK,EAAE,WAAW,IAAI,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAoGnE;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAyD5D"}