@cleocode/cleo 2026.4.57 → 2026.4.59

package/dist/cli/commands/schema.js

@@ -0,0 +1,160 @@
+/**
+ * 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 { describeOperation } from '@cleocode/lafs';
+import { OPERATIONS } from '../../dispatch/registry.js';
+import { cliError, cliOutput } from '../renderers/index.js';
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/**
+ * Resolve the target `OperationDef` from a `"domain.operation"` key.
+ *
+ * @param operationArg - The user-supplied string (e.g. `"tasks.add"`).
+ * @returns The matching `OperationDef`, or `null` if not found.
+ *
+ * @remarks
+ * The first dot separates domain from operation, so dotted operation names
+ * like `"complexity.estimate"` are handled correctly.
+ */
+function resolveOperationDef(operationArg) {
+    const dotIdx = operationArg.indexOf('.');
+    if (dotIdx === -1) {
+        // No domain separator — search all domains for unambiguous match
+        const matches = OPERATIONS.filter((op) => op.operation === operationArg);
+        if (matches.length === 1) {
+            return matches[0] ?? null;
+        }
+        return null;
+    }
+    const domain = operationArg.slice(0, dotIdx);
+    const operation = operationArg.slice(dotIdx + 1);
+    return OPERATIONS.find((op) => op.domain === domain && op.operation === operation) ?? null;
+}
+/**
+ * Format an `OperationSchema` as a human-readable summary table.
+ *
+ * @param schema - The operation schema to render.
+ * @returns Multi-line human-readable string.
+ */
+function renderSchemaHuman(schema) {
+    const lines = [];
+    lines.push(`Operation : ${schema.operation}`);
+    lines.push(`Gateway   : ${schema.gateway}`);
+    lines.push(`Description: ${schema.description}`);
+    lines.push('');
+    lines.push('Parameters:');
+    if (schema.params.length === 0) {
+        lines.push('  (none declared)');
+    }
+    else {
+        for (const p of schema.params) {
+            const req = p.required ? '[required]' : '[optional]';
+            const enumStr = p.enum ? `  enum: ${p.enum.join(' | ')}` : '';
+            let cliStr = '';
+            if (p.cli) {
+                const parts = [];
+                if (p.cli.positional)
+                    parts.push('positional');
+                if (p.cli.short)
+                    parts.push(`short: ${p.cli.short}`);
+                if (p.cli.flag)
+                    parts.push(`flag: --${p.cli.flag}`);
+                if (parts.length > 0)
+                    cliStr = `  cli: ${parts.join(', ')}`;
+            }
+            lines.push(`  ${p.name} (${p.type}) ${req}`);
+            lines.push(`    ${p.description}${enumStr}${cliStr}`);
+        }
+    }
+    if (schema.gates !== undefined) {
+        lines.push('');
+        lines.push('Gates:');
+        if (schema.gates.length === 0) {
+            lines.push('  (none declared — see note on static gate table)');
+        }
+        else {
+            for (const g of schema.gates) {
+                lines.push(`  ${g.name} → ${g.errorCode}`);
+                lines.push(`    ${g.description}`);
+                for (const t of g.triggers) {
+                    lines.push(`    - ${t}`);
+                }
+            }
+        }
+    }
+    if (schema.examples !== undefined && schema.examples.length > 0) {
+        lines.push('');
+        lines.push('Examples:');
+        for (const ex of schema.examples) {
+            lines.push(`  ${ex.command}`);
+            lines.push(`    ${ex.description}`);
+        }
+    }
+    return lines.join('\n');
+}
+// ---------------------------------------------------------------------------
+// Command registration
+// ---------------------------------------------------------------------------
+/**
+ * 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 function registerSchemaCommand(program) {
+    program
+        .command('schema <operation>')
+        .description('Introspect a CLEO operation: show params, types, enums, and declared gates')
+        .option('--format <format>', 'Output format: json (default) or human (pretty table)', 'json')
+        .option('--include-gates', 'Include precondition gates in output (default: true)')
+        .option('--no-include-gates', 'Exclude precondition gates from output')
+        .option('--include-examples', 'Include usage examples in output (default: false)')
+        .action(async (operationArg, opts) => {
+        const format = opts.format ?? 'json';
+        // When --no-include-gates is passed, Commander sets includeGates=false
+        const includeGates = opts.includeGates !== false;
+        const includeExamples = opts.includeExamples === true;
+        // Resolve operation from registry
+        const def = resolveOperationDef(operationArg);
+        if (def === null) {
+            cliError(`Unknown operation: "${operationArg}". Run \`cleo schema --list\` to see all operations.`, 4, {
+                name: 'E_NOT_FOUND',
+                fix: 'cleo schema --list',
+            });
+            process.exit(4);
+            return;
+        }
+        // Build schema via LAFS discovery
+        const schema = describeOperation(def, {
+            includeGates,
+            includeExamples,
+        });
+        if (format === 'human') {
+            console.log(renderSchemaHuman(schema));
+            return;
+        }
+        // JSON output — go through cliOutput for LAFS envelope compliance
+        cliOutput(schema, {
+            command: 'schema',
+            operation: `schema.${operationArg}`,
+            message: `Schema for ${schema.operation}`,
+        });
+    });
+}
+//# sourceMappingURL=schema.js.map

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

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

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

@@ -0,0 +1,15 @@
+/**
+ * CLI self-update command - check for and install updates.
+ *
+ * After updating, runs post-update diagnostics:
+ *   - Pre-flight storage migration check
+ *   - Auto-triggers upgrade if JSON data needs SQLite migration
+ *
+ * Designed for LLM agents: structured JSON output, actionable fix commands.
+ *
+ * @task T4699
+ * @epic T4454
+ */
+import type { ShimCommand as Command } from '../commander-shim.js';
+export declare function registerSelfUpdateCommand(program: Command): void;
+//# sourceMappingURL=self-update.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"self-update.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/self-update.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAkBH,OAAO,KAAK,EAAE,WAAW,IAAI,OAAO,EAAE,MAAM,sBAAsB,CAAC;AA8EnE,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAmMhE"}

package/dist/cli/commands/self-update.js

@@ -0,0 +1,363 @@
+/**
+ * CLI self-update command - check for and install updates.
+ *
+ * After updating, runs post-update diagnostics:
+ *   - Pre-flight storage migration check
+ *   - Auto-triggers upgrade if JSON data needs SQLite migration
+ *
+ * Designed for LLM agents: structured JSON output, actionable fix commands.
+ *
+ * @task T4699
+ * @epic T4454
+ */
+import { execFile } from 'node:child_process';
+import { readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import * as readline from 'node:readline';
+import { promisify } from 'node:util';
+import { ExitCode } from '@cleocode/contracts';
+import { BUILD_CONFIG, CleoError, checkStorageMigration, formatError, getCleoHome, getRuntimeDiagnostics, runUpgrade, } from '@cleocode/core/internal';
+import { createSelfUpdateProgress } from '../progress.js';
+import { cliOutput } from '../renderers/index.js';
+const execAsync = promisify(execFile);
+const GITHUB_REPO = BUILD_CONFIG.repository.fullName;
+async function getCurrentVersion() {
+    const cleoHome = getCleoHome();
+    try {
+        const content = await readFile(join(cleoHome, 'VERSION'), 'utf-8');
+        return (content.split('\n')[0] ?? 'unknown').trim();
+    }
+    catch {
+        return 'unknown';
+    }
+}
+async function getNpmInstalledVersion() {
+    try {
+        const { stdout } = await execAsync('npm', [
+            'ls',
+            '-g',
+            '@cleocode/cleo',
+            '--depth=0',
+            '--json',
+        ]);
+        const data = JSON.parse(stdout);
+        return data.dependencies?.['@cleocode/cleo']?.version ?? null;
+    }
+    catch {
+        return null;
+    }
+}
+async function getDistTagVersion(tag) {
+    try {
+        const { stdout } = await execAsync('npm', ['view', `@cleocode/cleo@${tag}`, 'version']);
+        const v = stdout.trim();
+        return v || null;
+    }
+    catch {
+        // Fallback to GitHub latest for stable only
+        if (tag === 'latest') {
+            try {
+                const { stdout } = await execAsync('curl', [
+                    '-sL',
+                    '--max-time',
+                    '10',
+                    `https://api.github.com/repos/${GITHUB_REPO}/releases/latest`,
+                ]);
+                const data = JSON.parse(stdout);
+                return data.tag_name?.replace(/^v/, '') ?? null;
+            }
+            catch {
+                return null;
+            }
+        }
+        return null;
+    }
+}
+async function writeRuntimeVersionMetadata(mode, source, version) {
+    const cleoHome = getCleoHome();
+    const lines = [
+        version,
+        `mode=${mode}`,
+        `source=${source}`,
+        `installed=${new Date().toISOString()}`,
+    ];
+    await import('node:fs/promises').then(({ writeFile, mkdir }) => mkdir(cleoHome, { recursive: true }).then(() => writeFile(join(cleoHome, 'VERSION'), `${lines.join('\n')}\n`, 'utf-8')));
+}
+export function registerSelfUpdateCommand(program) {
+    program
+        .command('self-update')
+        .description('Check for and install CLEO updates, then run post-update diagnostics')
+        .option('--check', 'Only check if update is available')
+        .option('--status', 'Show current vs latest version')
+        .option('--version <ver>', 'Update to specific version')
+        .option('--channel <channel>', 'Update channel: stable|beta')
+        .option('--beta', 'Shortcut for --channel beta')
+        .option('--force', 'Force update even if same version')
+        .option('--post-update', 'Run post-update diagnostics and migration only')
+        .option('--no-auto-upgrade', 'Skip automatic upgrade after update')
+        .option('--auto-migrate', 'Automatically migrate storage without prompting')
+        .action(async (_opts, command) => {
+        const opts = command.optsWithGlobals ? command.optsWithGlobals() : command.opts();
+        const isHuman = opts['human'] === true || (!!process.stdout.isTTY && opts['json'] !== true);
+        const progress = createSelfUpdateProgress(isHuman);
+        try {
+            const noAutoUpgrade = opts['autoUpgrade'] === false; // Commander normalizes --no-auto-upgrade to autoUpgrade=false
+            // --post-update: skip version check, just run diagnostics + upgrade
+            if (opts['postUpdate']) {
+                progress.start();
+                progress.step(4, 'Running post-update diagnostics');
+                await runPostUpdateDiagnostics({
+                    skipUpgrade: noAutoUpgrade,
+                    autoMigrate: !!opts['autoMigrate'] || !!opts['force'],
+                });
+                progress.complete('Post-update diagnostics complete');
+                return;
+            }
+            progress.start();
+            progress.step(0, 'Detecting installation type');
+            const runtime = await getRuntimeDiagnostics();
+            const script = runtime.invocation.script;
+            const fromNodeModules = script.includes('/node_modules/@cleocode/cleo/') ||
+                script.includes('\\node_modules\\@cleocode\\cleo\\');
+            const isDev = runtime.channel === 'dev' && !fromNodeModules;
+            progress.step(1, 'Checking current version');
+            const currentVersion = isDev
+                ? await getCurrentVersion()
+                : ((await getNpmInstalledVersion()) ?? (await getCurrentVersion()));
+            const rawChannel = opts['channel']?.toLowerCase();
+            if (rawChannel && rawChannel !== 'stable' && rawChannel !== 'beta') {
+                throw new CleoError(ExitCode.VALIDATION_ERROR, `Invalid --channel '${rawChannel}'. Expected stable|beta`);
+            }
+            const requestedChannel = opts['beta']
+                ? 'beta'
+                : (rawChannel ??
+                    (runtime.channel === 'beta' ? 'beta' : 'stable'));
+            if (isDev && !opts['force']) {
+                // For dev installs, still run post-update diagnostics
+                progress.step(4, 'Running post-update checks');
+                const preflight = checkStorageMigration();
+                cliOutput({
+                    devMode: true,
+                    channel: runtime.channel,
+                    currentVersion,
+                    message: 'Dev install detected. Use git pull to update.',
+                    storagePreflight: {
+                        migrationNeeded: preflight.migrationNeeded,
+                        summary: preflight.summary,
+                        fix: preflight.fix,
+                    },
+                }, { command: 'self-update' });
+                if (preflight.migrationNeeded) {
+                    progress.error(`Storage migration needed: ${preflight.summary}`);
+                    process.stderr.write(`\n⚠ Storage migration needed: ${preflight.summary}\n` +
+                        `  Fix: ${preflight.fix}\n` +
+                        `  Or run: cleo upgrade\n\n`);
+                }
+                else {
+                    progress.complete('Dev environment check complete');
+                }
+                process.exit(ExitCode.NO_DATA);
+                return;
+            }
+            if (opts['status'] || opts['check']) {
+                progress.step(2, 'Querying npm registry');
+                const latest = await getDistTagVersion(requestedChannel === 'beta' ? 'beta' : 'latest');
+                if (!latest) {
+                    throw new CleoError(ExitCode.DEPENDENCY_ERROR, 'Failed to check latest version from GitHub');
+                }
+                progress.step(3, 'Comparing versions');
+                const updateAvailable = latest !== currentVersion;
+                const preflight = checkStorageMigration();
+                cliOutput({
+                    currentVersion,
+                    latestVersion: latest,
+                    channel: requestedChannel,
+                    updateAvailable,
+                    storagePreflight: {
+                        migrationNeeded: preflight.migrationNeeded,
+                        summary: preflight.summary,
+                        fix: preflight.fix,
+                    },
+                }, { command: 'self-update' });
+                if (opts['check'] && updateAvailable) {
+                    process.exit(1); // exit 1 means update available for scripting
+                }
+                return;
+            }
+            // Actual update - delegated to shell for file system operations
+            progress.step(2, 'Querying npm registry');
+            const latest = opts['version'] ??
+                (await getDistTagVersion(requestedChannel === 'beta' ? 'beta' : 'latest'));
+            if (!latest) {
+                throw new CleoError(ExitCode.DEPENDENCY_ERROR, 'Failed to check latest version from GitHub');
+            }
+            progress.step(3, 'Comparing versions');
+            if (latest === currentVersion && !opts['force']) {
+                // Up to date - still run post-update diagnostics
+                progress.step(4, 'Running post-update checks');
+                await runPostUpdateDiagnostics({
+                    skipUpgrade: noAutoUpgrade,
+                    autoMigrate: !!opts['autoMigrate'] || !!opts['force'],
+                });
+                progress.complete('Already up to date');
+                cliOutput({
+                    currentVersion,
+                    upToDate: true,
+                }, { command: 'self-update', message: 'Already up to date' });
+                return;
+            }
+            const spec = opts['version']
+                ? `@cleocode/cleo@${latest}`
+                : requestedChannel === 'beta'
+                    ? '@cleocode/cleo@beta'
+                    : '@cleocode/cleo@latest';
+            progress.step(4, `Installing ${spec}`);
+            await execAsync('npm', ['install', '-g', spec], { maxBuffer: 10 * 1024 * 1024 });
+            await writeRuntimeVersionMetadata('prod-npm', 'npm', latest);
+            progress.step(5, 'Finalizing');
+            cliOutput({
+                currentVersion,
+                targetVersion: latest,
+                channel: requestedChannel,
+                updated: true,
+                command: `npm install -g ${spec}`,
+            }, { command: 'self-update', message: `Updated to ${latest}` });
+            await runPostUpdateDiagnostics({
+                skipUpgrade: noAutoUpgrade,
+                autoMigrate: !!opts['autoMigrate'] || !!opts['force'],
+            });
+            progress.complete(`Updated to ${latest}`);
+        }
+        catch (err) {
+            if (err instanceof CleoError) {
+                progress.error(err.message);
+                console.error(formatError(err));
+                process.exit(err.code);
+            }
+            progress.error('Unexpected error during update');
+            throw err;
+        }
+    });
+}
+/**
+ * Run post-update diagnostics and auto-upgrade.
+ *
+ * Called after a version update to detect and fix:
+ *   - JSON→SQLite storage migration
+ *   - Schema version mismatches
+ *   - Structural data repairs
+ *
+ * @task T4699
+ */
+async function runPostUpdateDiagnostics(opts) {
+    const preflight = checkStorageMigration();
+    if (preflight.migrationNeeded) {
+        if (opts?.skipUpgrade) {
+            process.stderr.write(`\n⚠ Storage migration detected: ${preflight.summary}\n` +
+                `  Auto-upgrade skipped (--no-auto-upgrade).\n` +
+                `  Run manually: cleo upgrade\n\n`);
+            cliOutput({
+                postUpdate: true,
+                upgradeSkipped: true,
+                storagePreflight: {
+                    migrationNeeded: true,
+                    summary: preflight.summary,
+                    fix: preflight.fix,
+                },
+            }, { command: 'self-update', message: 'Post-update upgrade skipped.' });
+            return;
+        }
+        process.stderr.write(`\n⚠ Storage migration detected: ${preflight.summary}\n`);
+        let shouldMigrate = !!opts?.autoMigrate;
+        if (!shouldMigrate) {
+            const rl = readline.createInterface({
+                input: process.stdin,
+                output: process.stdout,
+            });
+            shouldMigrate = await new Promise((resolve) => {
+                rl.question('  Do you want to run the upgrade now? [Y/n] ', (answer) => {
+                    rl.close();
+                    const clean = answer.trim().toLowerCase();
+                    resolve(clean === '' || clean === 'y' || clean === 'yes');
+                });
+            });
+        }
+        if (!shouldMigrate) {
+            process.stderr.write(`\n  Upgrade skipped. Run manually later: cleo upgrade\n\n`);
+            return;
+        }
+        process.stderr.write(`  Running upgrade...\n\n`);
+        const result = await runUpgrade({ autoMigrate: true });
+        // Show structured output of each action taken
+        if (result.actions.length > 0) {
+            process.stderr.write('Upgrade actions:\n');
+            for (const action of result.actions) {
+                const icon = action.status === 'applied' ? '  ✓' : action.status === 'error' ? '  ✗' : '  -';
+                process.stderr.write(`${icon} ${action.action}: ${action.details}\n`);
+            }
+            process.stderr.write('\n');
+        }
+        cliOutput({
+            postUpdate: true,
+            upgrade: {
+                success: result.success,
+                applied: result.applied,
+                actions: result.actions,
+                storageMigration: result.storageMigration,
+                errors: result.errors.length > 0 ? result.errors : undefined,
+            },
+        }, {
+            command: 'self-update',
+            message: result.success
+                ? 'Post-update upgrade complete.'
+                : 'Post-update upgrade had errors.',
+        });
+        if (!result.success) {
+            process.stderr.write(`\n⚠ Some upgrade steps failed. Manual fix:\n` + `  ${preflight.fix}\n\n`);
+        }
+    }
+    else {
+        // No storage migration needed, but still run structural upgrade to ensure
+        // all databases (brain.db, signaldock.db, conduit.db), adapters, schemas,
+        // memory-bridge.md, and other scaffold items are up to date.
+        if (!opts?.skipUpgrade) {
+            const result = await runUpgrade({ autoMigrate: false });
+            if (result.applied > 0 || result.errors.length > 0) {
+                // Show structured output of each action taken
+                if (result.actions.length > 0) {
+                    process.stderr.write('Post-update maintenance:\n');
+                    for (const action of result.actions) {
+                        if (action.status === 'skipped')
+                            continue;
+                        const icon = action.status === 'applied' ? '  ✓' : action.status === 'error' ? '  ✗' : '  -';
+                        process.stderr.write(`${icon} ${action.action}: ${action.details}\n`);
+                    }
+                    process.stderr.write('\n');
+                }
+                cliOutput({
+                    postUpdate: true,
+                    upgrade: {
+                        success: result.success,
+                        applied: result.applied,
+                        actions: result.actions,
+                        errors: result.errors.length > 0 ? result.errors : undefined,
+                    },
+                }, {
+                    command: 'self-update',
+                    message: result.success
+                        ? `Post-update maintenance complete (${result.applied} action(s) applied).`
+                        : 'Post-update maintenance had errors.',
+                });
+                return;
+            }
+        }
+        cliOutput({
+            postUpdate: true,
+            storagePreflight: {
+                migrationNeeded: false,
+                summary: preflight.summary,
+            },
+        }, { command: 'self-update', message: 'No post-update actions needed.' });
+    }
+}
+//# sourceMappingURL=self-update.js.map

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

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

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

@@ -0,0 +1,11 @@
+/**
+ * CLI sequence command - task ID sequence management.
+ * @task T4538
+ * @epic T4454
+ * @task T480 — fix sequence repair: route to systemSequenceRepair instead of
+ *              misrouted config.set (admin.sequence mutate was removed in T5615
+ *              but no correct CLI path remained).
+ */
+import type { ShimCommand as Command } from '../commander-shim.js';
+export declare function registerSequenceCommand(program: Command): void;
+//# sourceMappingURL=sequence.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sequence.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/sequence.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAE,WAAW,IAAI,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAGnE,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA0C9D"}

package/dist/cli/commands/sequence.js

@@ -0,0 +1,40 @@
+/**
+ * CLI sequence command - task ID sequence management.
+ * @task T4538
+ * @epic T4454
+ * @task T480 — fix sequence repair: route to systemSequenceRepair instead of
+ *              misrouted config.set (admin.sequence mutate was removed in T5615
+ *              but no correct CLI path remained).
+ */
+import { getProjectRoot } from '@cleocode/core/internal';
+import { dispatchFromCli } from '../../dispatch/adapters/cli.js';
+import { cliOutput } from '../renderers/index.js';
+export function registerSequenceCommand(program) {
+    const sequence = program
+        .command('sequence')
+        .description('Inspect and manage task ID sequence (show/check/repair)');
+    sequence
+        .command('show')
+        .description('Display current sequence state')
+        .action(async () => {
+        await dispatchFromCli('query', 'admin', 'sequence', { action: 'show' }, { command: 'sequence' });
+    });
+    sequence
+        .command('check')
+        .description('Verify counter >= max(todo + archive)')
+        .action(async () => {
+        await dispatchFromCli('query', 'admin', 'sequence', { action: 'check' }, { command: 'sequence' });
+    });
+    sequence
+        .command('repair')
+        .description('Reset counter to max + 1 if behind')
+        .action(async () => {
+        // admin.sequence (mutate) was removed in T5615 with no CLI path retained.
+        // Call the engine function directly, mirroring the detect command pattern.
+        const { systemSequenceRepair } = await import('../../dispatch/engines/system-engine.js');
+        const projectRoot = getProjectRoot();
+        const result = await systemSequenceRepair(projectRoot);
+        cliOutput(result, { command: 'sequence', operation: 'admin.sequence.repair' });
+    });
+}
+//# sourceMappingURL=sequence.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sequence.js","sourceRoot":"","sources":["../../../src/cli/commands/sequence.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAEjE,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAElD,MAAM,UAAU,uBAAuB,CAAC,OAAgB;IACtD,MAAM,QAAQ,GAAG,OAAO;SACrB,OAAO,CAAC,UAAU,CAAC;SACnB,WAAW,CAAC,yDAAyD,CAAC,CAAC;IAE1E,QAAQ;SACL,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,gCAAgC,CAAC;SAC7C,MAAM,CAAC,KAAK,IAAI,EAAE;QACjB,MAAM,eAAe,CACnB,OAAO,EACP,OAAO,EACP,UAAU,EACV,EAAE,MAAM,EAAE,MAAM,EAAE,EAClB,EAAE,OAAO,EAAE,UAAU,EAAE,CACxB,CAAC;IACJ,CAAC,CAAC,CAAC;IAEL,QAAQ;SACL,OAAO,CAAC,OAAO,CAAC;SAChB,WAAW,CAAC,uCAAuC,CAAC;SACpD,MAAM,CAAC,KAAK,IAAI,EAAE;QACjB,MAAM,eAAe,CACnB,OAAO,EACP,OAAO,EACP,UAAU,EACV,EAAE,MAAM,EAAE,OAAO,EAAE,EACnB,EAAE,OAAO,EAAE,UAAU,EAAE,CACxB,CAAC;IACJ,CAAC,CAAC,CAAC;IAEL,QAAQ;SACL,OAAO,CAAC,QAAQ,CAAC;SACjB,WAAW,CAAC,oCAAoC,CAAC;SACjD,MAAM,CAAC,KAAK,IAAI,EAAE;QACjB,0EAA0E;QAC1E,2EAA2E;QAC3E,MAAM,EAAE,oBAAoB,EAAE,GAAG,MAAM,MAAM,CAAC,yCAAyC,CAAC,CAAC;QACzF,MAAM,WAAW,GAAG,cAAc,EAAE,CAAC;QACrC,MAAM,MAAM,GAAG,MAAM,oBAAoB,CAAC,WAAW,CAAC,CAAC;QACvD,SAAS,CAAC,MAAM,EAAE,EAAE,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,uBAAuB,EAAE,CAAC,CAAC;IACjF,CAAC,CAAC,CAAC;AACP,CAAC"}

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

@@ -0,0 +1,12 @@
+/**
+ * CLI session command group.
+ * @task T4463
+ * @epic T4454
+ */
+import type { ShimCommand as Command } from '../commander-shim.js';
+/**
+ * Register the session command group.
+ * @task T4463
+ */
+export declare function registerSessionCommand(program: Command): void;
+//# sourceMappingURL=session.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/session.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,WAAW,IAAI,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAGnE;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAmT7D"}