@agentteams/cli 0.1.97 → 0.1.99

package/dist/index.js

@@ -1,1357 +1,10 @@
 #!/usr/bin/env node
 import { createRequire } from 'node:module';
-import { mkdirSync, writeFileSync } from 'node:fs';
-import { dirname, resolve } from 'node:path';
-import { Command, Option } from 'commander';
-import { executeCommand } from './commands/index.js';
-import { formatOutput } from './utils/formatter.js';
-import { formatAuthResultText } from './utils/authFormat.js';
-import { handleError } from './utils/errors.js';
-import { createSummaryLines, shouldPrintSummary } from './utils/outputPolicy.js';
-import { printInitResult } from './utils/initOutput.js';
-import { printDoctorResult, resolveDoctorExitCode } from './utils/doctorOutput.js';
-import { executeValidatedInteractiveCommand, normalizeInteractiveFormat } from './utils/interactiveCommand.js';
-import { startUpdateCheck, readCache, compareVersions, formatUpdateMessage } from './utils/updateCheck.js';
-import { MCP_CLIENT_IDS } from './mcp-registration/types.js';
-import { resolveApiKeyInput } from './utils/apiKeyInput.js';
+import { createProgram } from './program/index.js';
+import { compareVersions, formatUpdateMessage, readCache, startUpdateCheck } from './utils/updateCheck.js';
 const require = createRequire(import.meta.url);
 const pkg = require('../package.json');
-const program = new Command();
-function createApiKeyOption() {
-    return new Option('--api-key <key>', 'Deprecated: pass an API key in argv. Prefer AGENTTEAMS_API_KEY or --api-key-file.');
-}
-function createApiKeyFileOption() {
-    return new Option('--api-key-file <path>', 'Read the API key from a file, or use "-" to read stdin.');
-}
-program.hook('preAction', (_thisCommand, actionCommand) => {
-    try {
-        const commands = [];
-        for (let command = actionCommand; command; command = command.parent) {
-            commands.push(command);
-        }
-        const apiKeyCommand = commands.find((command) => command.opts().apiKey !== undefined);
-        const apiKeyFileCommand = commands.find((command) => command.opts().apiKeyFile !== undefined);
-        if (!apiKeyCommand && !apiKeyFileCommand)
-            return;
-        const apiKey = apiKeyCommand?.opts().apiKey;
-        const apiKeyFile = apiKeyFileCommand?.opts().apiKeyFile;
-        const resolved = resolveApiKeyInput({ apiKey, apiKeyFile });
-        (apiKeyFileCommand ?? apiKeyCommand ?? actionCommand).setOptionValue('apiKey', resolved);
-    }
-    catch (error) {
-        console.error(handleError(error));
-        process.exit(1);
-    }
-});
-function normalizeFormat(format) {
-    if (format === undefined || format === null || format === '')
-        return 'json';
-    if (format === 'json')
-        return 'json';
-    throw new Error(`Unsupported output format: ${String(format)}. Only json is supported.`);
-}
-function writeOutputFile(outputFile, content) {
-    const resolvedPath = resolve(outputFile);
-    mkdirSync(dirname(resolvedPath), { recursive: true });
-    writeFileSync(resolvedPath, content, 'utf-8');
-    const bytes = Buffer.byteLength(content, 'utf-8');
-    return { resolvedPath, bytes };
-}
-function printCommandResult(params) {
-    const outputText = typeof params.result === 'string' ? params.result : formatOutput(params.result);
-    const summaryLines = createSummaryLines(params.result, {
-        resource: params.resource,
-        action: params.action,
-    });
-    if (typeof params.outputFile === 'string' && params.outputFile.trim().length > 0) {
-        const { resolvedPath, bytes } = writeOutputFile(params.outputFile, outputText);
-        console.log(`Saved output to ${resolvedPath} (${bytes} bytes).`);
-        for (const line of summaryLines) {
-            console.log(line);
-        }
-        if (params.verbose) {
-            console.log(outputText);
-        }
-        return;
-    }
-    if (shouldPrintSummary({
-        resource: params.resource,
-        action: params.action,
-        format: params.format,
-        formatExplicit: params.formatExplicit,
-        outputFile: params.outputFile,
-        verbose: params.verbose,
-    })) {
-        for (const line of summaryLines) {
-            console.log(line);
-        }
-        return;
-    }
-    console.log(outputText);
-}
-/**
- * One constant for both `init` and `auth login`.
- *
- * The flag has to read identically in both `--help` outputs: a user who learns it
- * from one command types it at the other. Sharing the string makes that structural
- * rather than something a reviewer has to notice drifting.
- */
-const DEVICE_AUTH_OPTION_DESCRIPTION = 'authorize with a short code on another device instead of a local browser callback (for SSH, containers, and other headless shells)';
-const DEVICE_AUTH_SET_DEFAULT_DESCRIPTION = "with --device-auth: remember device-code login as this machine's default in ~/.agentteams/config.json";
-const CONVENTION_HINT = `\nFor workflow rules and reporting guidelines, see: .agentteams/convention.md`;
-program.name('agentteams').description('CLI tool for AgentTeams API').version(pkg.version);
-program
-    .command('init')
-    .description('Initialize AgentTeams CLI via OAuth')
-    // No commander `.default()` on purpose: init has to tell "the user asked for
-    // this credential" apart from "nothing was typed". A default would fill
-    // `options.auth` on every run, and `detectInitExecutionContext` reads a
-    // present value as an explicit relink request — which would make the
-    // configured-project fast path unreachable from the real CLI. The absent case
-    // is defaulted in `executeInitCommandWithContext`.
-    .addOption(new Option('--auth <mode>', 'Credential to configure. `personal-token` (default) stores a rotating personal login outside the repository — in the OS credential store, or in a permission-protected file when that store is unavailable — and refreshes itself; `api-key` writes a legacy agent key into .agentteams/config.json, which expires 30 days after issue and must be reissued by hand.').choices(['api-key', 'personal-token']))
-    // Entry point files are no longer written for every AI client on every run.
-    // Without a TTY the selection now comes from what is actually configured in
-    // the folder (.claude/, .cursor/, …), and this option is how an automated
-    // caller states the set explicitly instead.
-    .option('--agent-files <list>', "Comma-separated agent entry point files to create (CLAUDE.md, AGENTS.md, GEMINI.md, .cursor/rules/agentteams.mdc), or 'none'. Defaults to the AI clients detected in this folder.")
-    .option('--agent-files-example', 'When a selected entry point file already exists, write a <name>-example file next to it instead of leaving it alone.', false)
-    .option('--install-worktree-hook', "Install the managed git post-checkout hook even if this repository has no linked worktrees yet. By default the hook is installed only when linked worktrees exist; 'agentteams doctor' can install it later.", false)
-    // Explicit opt-in only. There is deliberately no `--no-device-auth`: the default
-    // already is the browser callback, so the way to turn this off is not to pass it.
-    .option('--device-auth', DEVICE_AUTH_OPTION_DESCRIPTION, false)
-    .option('--set-default', DEVICE_AUTH_SET_DEFAULT_DESCRIPTION, false)
-    .option('--format <format>', 'Output format (json; defaults to human-readable view)')
-    .option('--output-file <path>', 'Write full output to a file (stdout prints a short summary)')
-    .option('--verbose', 'Print full raw output to stdout; with --output-file, also echo it', false)
-    .addHelpText('after', CONVENTION_HINT)
-    .action(async (options) => {
-    try {
-        const result = await executeCommand('init', 'start', {
-            authMode: options.auth,
-            agentFiles: options.agentFiles,
-            agentFilesExample: options.agentFilesExample === true,
-            installWorktreeHook: options.installWorktreeHook === true,
-            deviceAuth: options.deviceAuth === true,
-            setDefault: options.setDefault === true,
-        });
-        const format = normalizeInteractiveFormat(options.format);
-        printInitResult(result, format);
-    }
-    catch (error) {
-        console.error(handleError(error));
-        process.exit(1);
-    }
-});
-program
-    .command('auth')
-    .description('Manage the personal AgentTeams login used by default')
-    .argument('<action>', 'Action to perform (login, status, logout)')
-    .option('--api-url <url>', 'API server to authenticate against (defaults to the project config or env)')
-    .option('--local', 'logout only: clear the local credential without contacting the server (the token stays valid — revoke it in the web app)', false)
-    // Same flag name as `init` on purpose — one vocabulary for one behaviour.
-    // Same flag name and same wording as `init` — one vocabulary for one behaviour.
-    .option('--device-auth', DEVICE_AUTH_OPTION_DESCRIPTION, false)
-    .option('--set-default', DEVICE_AUTH_SET_DEFAULT_DESCRIPTION, false)
-    .option('--format <format>', 'Output format (json; defaults to human-readable text)')
-    .option('--output-file <path>', 'Write full output to a file (stdout prints a short summary)')
-    .option('--verbose', 'Print full raw output to stdout; with --output-file, also echo it', false)
-    .addHelpText('after', CONVENTION_HINT)
-    .action(async (action, options) => {
-    try {
-        const result = await executeCommand('auth', action, {
-            apiUrl: options.apiUrl,
-            local: options.local === true,
-            deviceAuth: options.deviceAuth === true,
-            setDefault: options.setDefault === true,
-        });
-        // `auth` is read by a person, so text is the default; scripts that read the
-        // documented fields ask for JSON explicitly.
-        const wantsJson = options.format !== undefined;
-        printCommandResult({
-            result: wantsJson ? result : formatAuthResultText(action, result),
-            format: normalizeFormat(options.format),
-            outputFile: options.outputFile,
-            verbose: options.verbose,
-        });
-    }
-    catch (error) {
-        console.error(handleError(error));
-        process.exit(1);
-    }
-});
-program
-    .command('doctor')
-    .description('Diagnose convention reachability and install the worktree bootstrap hook')
-    .option('--format <format>', 'Output format (json; defaults to human-readable view)')
-    // The doctor honors the same gate `init` does — a repository with no linked
-    // worktree keeps its shared .git/hooks untouched — so opting in needs a flag
-    // on this command too, not just on `init`.
-    .option('--install-worktree-hook', 'Install the managed git post-checkout hook even if this repository has no linked worktrees yet.', false)
-    .addHelpText('after', CONVENTION_HINT)
-    .action(async (options) => {
-    try {
-        const { result, format } = await executeValidatedInteractiveCommand(options.format, async () => executeCommand('doctor', 'run', {
-            cwd: process.cwd(),
-            installWorktreeHook: options.installWorktreeHook === true,
-        }));
-        printDoctorResult(result, format);
-        // exitCode (not process.exit) lets stdout flush before termination.
-        process.exitCode = resolveDoctorExitCode(result);
-    }
-    catch (error) {
-        console.error(handleError(error));
-        process.exit(1);
-    }
-});
-program
-    .command('sync')
-    .description('Sync local convention files from API')
-    .option('--format <format>', 'Output format (json; defaults to human-readable view)')
-    .option('--output-file <path>', 'Write full output to a file (stdout prints a short summary)')
-    .option('--verbose', 'Print full raw output to stdout; with --output-file, also echo it', false)
-    .addHelpText('after', CONVENTION_HINT)
-    .action(async (options) => {
-    try {
-        const result = await executeCommand('sync', 'download', {
-            cwd: process.cwd(),
-        });
-        const format = normalizeInteractiveFormat(options.format);
-        if (format === 'human' && !options.outputFile) {
-            console.log(typeof result === 'string' ? result : formatOutput(result));
-            return;
-        }
-        printCommandResult({
-            result: format === 'json' && typeof result === 'string' ? { message: result } : result,
-            format: 'json',
-            outputFile: options.outputFile,
-            verbose: options.verbose,
-        });
-    }
-    catch (error) {
-        console.error(handleError(error));
-        process.exit(1);
-    }
-});
-program
-    .command('worktree')
-    .description('Report Orca worktree lifecycle events')
-    .argument('<action>', 'Action to perform (notify-created, notify-deleted)')
-    .option('--repository-id <id>', 'AgentTeams repository ID (optional when remote origin matches)')
-    .option('--local-key <key>', 'Opaque worktree identity (defaults to a Git-derived key)')
-    .option('--event-id <id>', 'Stable event ID for retries')
-    .option('--occurred-at <timestamp>', 'Event timestamp in ISO 8601 format')
-    .option('--after-removal', 'Send a deleted event only after the worktree path disappears', false)
-    .option('--format <format>', 'Output format (json)', 'json')
-    .option('--quiet', 'Do not print a successful result', false)
-    .action(async (action, options) => {
-    try {
-        const result = await executeCommand('worktree', action, {
-            cwd: process.cwd(),
-            repositoryId: options.repositoryId,
-            localKey: options.localKey,
-            eventId: options.eventId,
-            occurredAt: options.occurredAt,
-            afterRemoval: options.afterRemoval,
-        });
-        if (!options.quiet) {
-            printCommandResult({ result, format: normalizeFormat(options.format), resource: 'worktree', action });
-        }
-    }
-    catch (error) {
-        console.error(handleError(error));
-        process.exit(1);
-    }
-});
-program
-    .command('plan')
-    .description('Manage plans')
-    .argument('<action>', 'Action to perform (list, get, show, create, update, delete, download, cleanup, start, finish, quick, status, set-status, upload-html, link-issue, unlink-issue, list-issues)')
-    .option('--id <id>', 'Plan ID')
-    .option('--title <title>', 'Plan title')
-    .option('--search <text>', 'Plan title/ID search keyword (list only)')
-    .option('--content <content>', 'Plan content (plain text or Tiptap JSON)')
-    .option('--interpret-escapes', 'Interpret \\n sequences in --content as newlines (create/update only)', false)
-    .option('--file <path>', 'Read plan content from a local file (create/update/upload-html)')
-    .option('--keep-temp', 'Keep the uploaded file under .agentteams/cli/temp/ instead of deleting it after upload', false)
-    .option('--stdin', 'Read plan HTML summary from stdin (upload-html only)', false)
-    .option('--html-file <path>', 'Read a legacy V1 plan HTML preview from a local file (optional for create/update; not displayed for V2 plans)')
-    .option('--html-stdin', 'Read a legacy V1 plan HTML preview from stdin (optional for create/update; not displayed for V2 plans)', false)
-    .option('--source-label <label>', 'Optional source label for uploaded plan HTML summary')
-    .option('--template <name>', 'Plan content template (refactor-minimal, quick-minimal, create only)')
-    .option('--status <status>', 'Plan status for list/update/set-status; ignored by create because new plans start as BACKLOG')
-    .option('--type <type>', 'Plan type (FEATURE, BUG_FIX, ISSUE, REFACTOR, CHORE)')
-    .option('--complexity <level>', 'Plan complexity (MINIMAL, STANDARD, FULL; required for create)')
-    .option('--complexity-reason <text>', 'Reason for changing complexity (update only; recorded as a MODIFICATION comment)')
-    .option('--priority <priority>', 'Plan priority (LOW, MEDIUM, HIGH)')
-    .option('--repository-remote-url <url>', 'Repository remote origin URL (create/report attach; defaults to git origin)')
-    .option('--assigned-to <id>', 'Agent config ID or name. Filters plan list; assigns the agent on start/quick when the credential carries none (defaults to $AGENTTEAMS_AGENT_NAME)')
-    .option('--task <text>', 'Task summary for plan start/finish')
-    .option('--report-title <title>', 'Completion report title (plan finish)')
-    .option('--report-file <path>', 'Read completion report content from a local file (plan finish)')
-    .option('--report-status <status>', 'Completion report status: COMPLETED, FAILED, PARTIAL (plan finish)')
-    .option('--quality-score <n>', 'Quality score 0-100 (plan finish)')
-    .option('--review-recommendation <value>', 'Code review recommendation: REQUIRED or NOT_NEEDED (plan finish)')
-    .option('--review-reason <text>', 'One-line reason for the review recommendation (plan finish)')
-    .option('--commit-hash <hash>', 'Git commit hash (plan finish, manual override)')
-    .option('--branch-name <name>', 'Git branch name (plan finish, manual override)')
-    .option('--files-modified <n>', 'Number of modified files (plan finish, manual override)')
-    .option('--lines-added <n>', 'Number of added lines (plan finish, manual override)')
-    .option('--lines-deleted <n>', 'Number of deleted lines (plan finish, manual override)')
-    .option('--duration-seconds <n>', 'Duration in seconds (plan finish, manual only)')
-    .option('--commit-start <hash>', 'Commit range start hash (plan finish, manual only)')
-    .option('--commit-end <hash>', 'Commit range end hash (plan finish, manual only)')
-    .option('--pull-request-id <id>', 'Pull request ID (plan finish, manual only)')
-    .option('--runner-type <type>', 'Runner type snapshot: CLAUDE_CODE, CODEX, ANTIGRAVITY, AMP, OPENCODE (plan start/finish)')
-    .option('--model <model>', 'Model ID snapshot (plan start/finish)')
-    .option('--fast', 'Request fast mode for the selected model when supported', false)
-    .option('--no-git', 'Disable git metrics auto-collection (plan finish)')
-    .option('--page <number>', 'Page number (list only)')
-    .option('--page-size <number>', 'Page size (list only)')
-    .option('--provider <provider>', 'External issue provider (GITHUB, GITLAB, LINEAR)')
-    .option('--external-id <id>', 'External issue ID')
-    .option('--external-url <url>', 'External issue URL')
-    .option('--issue-id <id>', 'PlanExternalIssue ID (for unlink-issue)')
-    .option('--metadata <json>', 'Provider metadata as JSON (e.g. {"owner":"org","repo":"name"})')
-    .option('--include-deps', 'Include dependencies in plan get/show output', false)
-    .option('--format <format>', 'Output format (json)')
-    .option('--output-file <path>', 'Write full output to a file (stdout prints a short summary)')
-    .option('--verbose', 'Print full raw output to stdout; with --output-file, also echo it', false)
-    .addHelpText('after', CONVENTION_HINT)
-    .action(async (action, options) => {
-    try {
-        const normalizedFormat = normalizeFormat(options.format);
-        const result = await executeCommand('plan', action, {
-            id: options.id,
-            title: options.title,
-            search: options.search,
-            content: options.content,
-            interpretEscapes: options.interpretEscapes,
-            file: options.file,
-            stdin: options.stdin,
-            htmlFile: options.htmlFile,
-            htmlStdin: options.htmlStdin,
-            sourceLabel: options.sourceLabel,
-            template: options.template,
-            status: options.status,
-            type: options.type,
-            complexity: options.complexity,
-            complexityReason: options.complexityReason,
-            priority: options.priority,
-            repositoryRemoteUrl: options.repositoryRemoteUrl,
-            assignedTo: options.assignedTo,
-            task: options.task,
-            reportTitle: options.reportTitle,
-            reportFile: options.reportFile,
-            reportStatus: options.reportStatus,
-            qualityScore: options.qualityScore,
-            reviewRecommendation: options.reviewRecommendation,
-            reviewReason: options.reviewReason,
-            commitHash: options.commitHash,
-            branchName: options.branchName,
-            filesModified: options.filesModified,
-            linesAdded: options.linesAdded,
-            linesDeleted: options.linesDeleted,
-            durationSeconds: options.durationSeconds,
-            commitStart: options.commitStart,
-            commitEnd: options.commitEnd,
-            pullRequestId: options.pullRequestId,
-            git: options.git,
-            page: options.page,
-            pageSize: options.pageSize,
-            provider: options.provider,
-            externalId: options.externalId,
-            externalUrl: options.externalUrl,
-            issueId: options.issueId,
-            metadata: options.metadata,
-            includeDeps: options.includeDeps,
-            runnerType: options.runnerType,
-            model: options.model,
-            fast: options.fast,
-            format: normalizedFormat,
-            formatExplicit: typeof options.format === 'string',
-        });
-        printCommandResult({
-            result,
-            format: normalizedFormat,
-            outputFile: options.outputFile,
-            verbose: options.verbose,
-            resource: 'plan',
-            action,
-            formatExplicit: typeof options.format === 'string',
-        });
-    }
-    catch (error) {
-        console.error(handleError(error));
-        process.exit(1);
-    }
-});
-program
-    .command('resolve')
-    .description('Resolve an entity reference token to the right entity and fetch it')
-    .argument('<ref>', 'Reference token, e.g. "plan:agentteams_pln_<uuid>", "agentteams_doc_<uuid>", or a whole [label](type:id) link')
-    .option('--format <format>', 'Output format (json)')
-    .option('--output-file <path>', 'Write full output to a file (stdout prints a short summary)')
-    .option('--verbose', 'Print full raw output to stdout; with --output-file, also echo it', false)
-    .addHelpText('after', `\nReturns a "kind" that tells you what to do next:\n  file       read "filePath" (the entity body was downloaded)\n  record     use "record" (structured payload, already inline)\n  localFile  read "filePath" (the reference carried a local path)\n  external   open "url" or run "suggestedCommand" (gh/glab)\n${CONVENTION_HINT}`)
-    .action(async (ref, options) => {
-    try {
-        const normalizedFormat = normalizeFormat(options.format);
-        const result = await executeCommand('resolve', 'get', {
-            ref,
-            format: normalizedFormat,
-            formatExplicit: typeof options.format === 'string',
-        });
-        printCommandResult({
-            result,
-            format: normalizedFormat,
-            outputFile: options.outputFile,
-            verbose: options.verbose,
-            resource: 'resolve',
-            action: 'get',
-            formatExplicit: typeof options.format === 'string',
-        });
-    }
-    catch (error) {
-        console.error(handleError(error));
-        process.exit(1);
-    }
-});
-program
-    .command('task')
-    .description('Manage plan tasks')
-    .argument('<action>', 'Action to perform (get, start, finish)')
-    .option('--plan-id <id>', 'Plan ID (optional for get: bare task-id focus; required for start/finish)')
-    .option('--task-id <id>', 'Plan task ID')
-    .option('--status <status>', 'Task finish status: DONE, BLOCKED, or SKIPPED')
-    .option('--format <format>', 'Output format (json)')
-    .option('--output-file <path>', 'Write full output to a file (stdout prints a short summary)')
-    .option('--verbose', 'Print full raw output to stdout; with --output-file, also echo it', false)
-    .addHelpText('after', CONVENTION_HINT)
-    .action(async (action, options) => {
-    try {
-        const normalizedFormat = normalizeFormat(options.format);
-        const result = await executeCommand('task', action, {
-            planId: options.planId,
-            taskId: options.taskId,
-            status: options.status,
-            format: normalizedFormat,
-            formatExplicit: typeof options.format === 'string',
-        });
-        printCommandResult({
-            result,
-            format: normalizedFormat,
-            outputFile: options.outputFile,
-            verbose: options.verbose,
-            resource: 'task',
-            action,
-            formatExplicit: typeof options.format === 'string',
-        });
-    }
-    catch (error) {
-        console.error(handleError(error));
-        process.exit(1);
-    }
-});
-program
-    .command('comment')
-    .description('Manage plan, finding, and task comments with 1-depth replies')
-    .argument('<action>', 'Action to perform (list, get, create, update, delete, reply-list, reply-get, reply-create, reply-update, reply-delete)')
-    .option('--id <id>', 'Comment ID (parent comment ID for reply-list/reply-create)')
-    .option('--reply-id <id>', 'Reply ID (for reply-get/reply-update/reply-delete)')
-    .option('--plan-id <id>', 'Plan ID')
-    .option('--finding-id <id>', 'Code review finding ID')
-    .option('--task-id <id>', 'Plan task ID')
-    .option('--type <type>', 'Comment type (RISK, MODIFICATION, GENERAL)')
-    .option('--content <content>', 'Comment content')
-    .option('--affected-files <files>', 'Comma-separated list of affected file paths (create/update)')
-    .option('--page <number>', 'Page number (list only)')
-    .option('--page-size <number>', 'Page size (list only)')
-    .option('--guide-hash <hash>', 'Hash of the comment guide you followed (create/update/delete). Stale hash is rejected with GUIDE_OUTDATED.')
-    .option('--idempotency-key <key>', 'Retry-safe key (create/update/delete). Repeating the same key with the same request replays the first result.')
-    .option('--expected-updated-at <iso>', "The comment's updatedAt as you last read it (update/delete). Rejects the write if it changed meanwhile.")
-    .option('--format <format>', 'Output format (json)', 'json')
-    .option('--output-file <path>', 'Write full output to a file (stdout prints a short summary)')
-    .option('--verbose', 'Print full raw output to stdout; with --output-file, also echo it', false)
-    .addHelpText('after', CONVENTION_HINT)
-    .action(async (action, options) => {
-    try {
-        const result = await executeCommand('comment', action, {
-            id: options.id,
-            replyId: options.replyId,
-            planId: options.planId,
-            findingId: options.findingId,
-            taskId: options.taskId,
-            type: options.type,
-            content: options.content,
-            affectedFiles: options.affectedFiles,
-            page: options.page,
-            pageSize: options.pageSize,
-            guideHash: options.guideHash,
-            idempotencyKey: options.idempotencyKey,
-            expectedUpdatedAt: options.expectedUpdatedAt,
-        });
-        printCommandResult({
-            result,
-            format: normalizeFormat(options.format),
-            outputFile: options.outputFile,
-            verbose: options.verbose,
-        });
-    }
-    catch (error) {
-        console.error(handleError(error));
-        process.exit(1);
-    }
-});
-program
-    .command('attachment')
-    .description('Manage trigger, document, and evidence attachments')
-    .argument('<action>', 'Action to perform (list, create)')
-    .option('--trigger-id <id>', 'Daemon trigger ID (list)')
-    .option('--document-id <id>', 'Document ID (list or create)')
-    .option('--file <path>', 'Local file to upload (create)')
-    .option('--code-review-id <id>', 'Attach to this code review (create)')
-    .option('--completion-report-id <id>', 'Attach to this completion report (create)')
-    .option('--api-url <url>', 'Override API URL (optional)')
-    .addOption(createApiKeyOption())
-    .addOption(createApiKeyFileOption())
-    .option('--project-id <id>', 'Override project ID (optional)')
-    .option('--team-id <id>', 'Override team ID (optional)')
-    .option('--format <format>', 'Output format (json)')
-    .option('--output-file <path>', 'Write full output to a file (stdout prints a short summary)')
-    .option('--verbose', 'Print full raw output to stdout; with --output-file, also echo it', false)
-    .addHelpText('after', CONVENTION_HINT)
-    .action(async (action, options) => {
-    try {
-        const normalizedFormat = normalizeFormat(options.format);
-        const result = await executeCommand('attachment', action, {
-            triggerId: options.triggerId,
-            documentId: options.documentId,
-            file: options.file,
-            codeReviewId: options.codeReviewId,
-            completionReportId: options.completionReportId,
-            apiUrl: options.apiUrl,
-            apiKey: options.apiKey,
-            projectId: options.projectId,
-            teamId: options.teamId,
-        });
-        printCommandResult({
-            result,
-            format: normalizedFormat,
-            outputFile: options.outputFile,
-            verbose: options.verbose,
-            resource: 'attachment',
-            action,
-            formatExplicit: typeof options.format === 'string',
-        });
-    }
-    catch (error) {
-        console.error(handleError(error));
-        process.exit(1);
-    }
-});
-program
-    .command('report')
-    .description('Manage completion reports')
-    .argument('<action>', 'Action to perform (list, get, create, update, dismiss-review, delete)')
-    .option('--id <id>', 'Report ID')
-    .option('--plan-id <id>', 'Plan ID (optional)')
-    .option('--title <title>', 'Report title')
-    .option('--file <path>', 'Read report content from a local file (create/update)')
-    .option('--keep-temp', 'Keep the uploaded file under .agentteams/cli/temp/ instead of deleting it after upload', false)
-    .option('--status <status>', 'Report status (COMPLETED, FAILED, PARTIAL)')
-    .option('--commit-hash <hash>', 'Git commit hash (manual override)')
-    .option('--branch-name <name>', 'Git branch name (manual override)')
-    .option('--files-modified <n>', 'Number of modified files (manual override)')
-    .option('--lines-added <n>', 'Number of added lines (manual override)')
-    .option('--lines-deleted <n>', 'Number of deleted lines (manual override)')
-    .option('--duration-seconds <n>', 'Duration in seconds (manual only)')
-    .option('--commit-start <hash>', 'Commit range start hash (manual only)')
-    .option('--commit-end <hash>', 'Commit range end hash (manual only)')
-    .option('--pull-request-id <id>', 'Pull request ID (manual only)')
-    .option('--quality-score <n>', 'Quality score 0-100')
-    .option('--review-recommendation <value>', 'Code review recommendation: REQUIRED or NOT_NEEDED (create)')
-    .option('--review-reason <text>', 'One-line reason for the review recommendation (create)')
-    .option('--repository-remote-url <url>', 'Repository remote origin URL (create; defaults to git origin)')
-    .option('--runner-type <type>', 'Runner type snapshot: CLAUDE_CODE, CODEX, ANTIGRAVITY, AMP, OPENCODE (required for create)')
-    .option('--model <model>', 'Model ID snapshot (required for create)')
-    .option('--no-git', 'Disable git metrics auto-collection')
-    .option('--page <number>', 'Page number (list only)')
-    .option('--page-size <number>', 'Page size (list only)')
-    .option('--search <text>', 'Title keyword search (list only)')
-    .option('--limit <n>', 'Max results per page, alias for --page-size (list only)')
-    .option('--api-url <url>', 'Override API URL (optional)')
-    .addOption(createApiKeyOption())
-    .addOption(createApiKeyFileOption())
-    .option('--project-id <id>', 'Override project ID (optional)')
-    .option('--team-id <id>', 'Override team ID (optional)')
-    .option('--format <format>', 'Output format (json)')
-    .option('--output-file <path>', 'Write full output to a file (stdout prints a short summary)')
-    .option('--verbose', 'Print full raw output to stdout; with --output-file, also echo it', false)
-    .addHelpText('after', CONVENTION_HINT)
-    .action(async (action, options) => {
-    try {
-        const normalizedFormat = normalizeFormat(options.format);
-        const result = await executeCommand('report', action, {
-            id: options.id,
-            planId: options.planId,
-            title: options.title,
-            file: options.file,
-            status: options.status,
-            commitHash: options.commitHash,
-            branchName: options.branchName,
-            filesModified: options.filesModified,
-            linesAdded: options.linesAdded,
-            linesDeleted: options.linesDeleted,
-            durationSeconds: options.durationSeconds,
-            commitStart: options.commitStart,
-            commitEnd: options.commitEnd,
-            pullRequestId: options.pullRequestId,
-            qualityScore: options.qualityScore,
-            reviewRecommendation: options.reviewRecommendation,
-            reviewReason: options.reviewReason,
-            repositoryRemoteUrl: options.repositoryRemoteUrl,
-            git: options.git,
-            page: options.page,
-            pageSize: options.pageSize,
-            search: options.search,
-            limit: options.limit,
-            apiUrl: options.apiUrl,
-            apiKey: options.apiKey,
-            projectId: options.projectId,
-            teamId: options.teamId,
-            runnerType: options.runnerType,
-            model: options.model,
-        });
-        printCommandResult({
-            result,
-            format: normalizedFormat,
-            outputFile: options.outputFile,
-            verbose: options.verbose,
-            resource: 'report',
-            action,
-            formatExplicit: typeof options.format === 'string',
-        });
-    }
-    catch (error) {
-        console.error(handleError(error));
-        process.exit(1);
-    }
-});
-program
-    .command('code-review')
-    .description('Manage independent code reviews')
-    .argument('<action>', 'Action to perform (list, get, show, create, update, create-plan, submit-result, cancel, delete, dismiss, resolve, undismiss)')
-    .option('--id <id>', 'Code review ID')
-    .option('--finding-id <id>', 'Finding ID for get (single-finding focus), dismiss/resolve/undismiss')
-    .option('--title <title>', 'Code review or generated plan title')
-    .option('--target-type <type>', 'Review target type (BRANCH_DIFF, GITHUB_PR, GITLAB_MR, BITBUCKET_PR, LOCAL_DIFF, UPLOADED_DIFF, COMMIT_RANGE)')
-    .option('--target-ref <ref>', 'Target reference such as branch, PR URL, MR URL, or commit range')
-    .option('--repository-remote-url <url>', 'Repository remote origin URL (create; defaults to git origin)')
-    .option('--source-plan-id <id>', 'Source plan ID')
-    .option('--source-completion-report-id <id>', 'Source completion report ID')
-    .option('--source-commit-start <hash>', 'Source commit range start')
-    .option('--source-commit-end <hash>', 'Source commit range end')
-    .option('--source-branch-name <name>', 'Source branch name')
-    .option('--base-branch-name <name>', 'Base branch name')
-    .option('--diff-summary <text>', 'Diff summary text')
-    .option('--diff-file <path>', 'Read diff summary from a local file')
-    .option('--test-summary <text>', 'Verification summary text')
-    .option('--test-file <path>', 'Read verification summary from a local file')
-    .option('--reviewer-context <text>', 'Reviewer context or instructions')
-    .option('--recommendation-reason <text>', 'Why this review is recommended')
-    .option('--findings-file <path>', 'Read findings JSON array from a local file (create, submit-result)')
-    .option('--result-summary <text>', 'Review result summary (submit-result)')
-    .option('--error-message <text>', 'Failure reason when --status FAILED (submit-result)')
-    .option('--finding-ids <ids>', 'Comma-separated finding IDs for create-plan or resolve')
-    .option('--priority <priority>', 'Generated plan priority (LOW, MEDIUM, HIGH)')
-    .option('--type <type>', 'Generated plan type (FEATURE, BUG_FIX, ISSUE, REFACTOR, CHORE)')
-    .option('--runner-type <type>', 'Runner type snapshot: CLAUDE_CODE, CODEX, ANTIGRAVITY, AMP, OPENCODE')
-    .option('--model <model>', 'Model ID snapshot')
-    .option('--status <status>', 'Status filter (list); result status COMPLETED|FAILED (submit-result)')
-    .option('--search <text>', 'Search keyword (list only)')
-    .option('--page <number>', 'Page number (list only)')
-    .option('--page-size <number>', 'Page size (list only)')
-    .option('--api-url <url>', 'Override API URL (optional)')
-    .addOption(createApiKeyOption())
-    .addOption(createApiKeyFileOption())
-    .option('--project-id <id>', 'Override project ID (optional)')
-    .option('--team-id <id>', 'Override team ID (optional)')
-    .option('--format <format>', 'Output format (json)')
-    .option('--output-file <path>', 'Write full output to a file (stdout prints a short summary)')
-    .option('--verbose', 'Print full raw output to stdout; with --output-file, also echo it', false)
-    .addHelpText('after', CONVENTION_HINT)
-    .action(async (action, options) => {
-    try {
-        const normalizedFormat = normalizeFormat(options.format);
-        const result = await executeCommand('code-review', action, {
-            id: options.id,
-            findingId: options.findingId,
-            title: options.title,
-            targetType: options.targetType,
-            targetRef: options.targetRef,
-            repositoryRemoteUrl: options.repositoryRemoteUrl,
-            sourcePlanId: options.sourcePlanId,
-            sourceCompletionReportId: options.sourceCompletionReportId,
-            sourceCommitStart: options.sourceCommitStart,
-            sourceCommitEnd: options.sourceCommitEnd,
-            sourceBranchName: options.sourceBranchName,
-            baseBranchName: options.baseBranchName,
-            diffSummary: options.diffSummary,
-            diffFile: options.diffFile,
-            testSummary: options.testSummary,
-            testFile: options.testFile,
-            reviewerContext: options.reviewerContext,
-            recommendationReason: options.recommendationReason,
-            findingsFile: options.findingsFile,
-            resultSummary: options.resultSummary,
-            errorMessage: options.errorMessage,
-            findingIds: options.findingIds,
-            priority: options.priority,
-            type: options.type,
-            runnerType: options.runnerType,
-            model: options.model,
-            status: options.status,
-            search: options.search,
-            page: options.page,
-            pageSize: options.pageSize,
-            apiUrl: options.apiUrl,
-            apiKey: options.apiKey,
-            projectId: options.projectId,
-            teamId: options.teamId,
-        });
-        printCommandResult({
-            result,
-            format: normalizedFormat,
-            outputFile: options.outputFile,
-            verbose: options.verbose,
-            resource: 'code-review',
-            action,
-            formatExplicit: typeof options.format === 'string',
-        });
-    }
-    catch (error) {
-        console.error(handleError(error));
-        process.exit(1);
-    }
-});
-program
-    .command('change-set')
-    .description('Manage cross-repository change sets and merge order')
-    .argument('<action>', 'Action to perform (create, list, get, update, delete, add-item, remove-item)')
-    .option('--id <id>', 'Change set ID')
-    .option('--change-set-id <id>', 'Change set ID for item actions')
-    .option('--item-id <id>', 'Change set item ID')
-    .option('--title <title>', 'Change set title')
-    .option('--description <text>', 'Change set description')
-    .option('--status <status>', 'Status (OPEN, COMPLETED, CANCELLED)')
-    .option('--repository-id <id>', 'Project repository ID')
-    .option('--repository-remote-url <url>', 'Repository remote URL (add-item; defaults to git origin)')
-    .option('--no-git', 'Disable automatic git origin detection')
-    .option('--branch-name <name>', 'Branch name')
-    .option('--target-url <url>', 'Pull or merge request URL')
-    .option('--merge-order <number>', 'Merge order (positive integer)')
-    .option('--code-review-id <id>', 'Linked code review ID')
-    .option('--note <text>', 'Item note')
-    .option('--page <number>', 'Page number (list only)')
-    .option('--page-size <number>', 'Page size (list only)')
-    .option('--api-url <url>', 'Override API URL (optional)')
-    .addOption(createApiKeyOption())
-    .addOption(createApiKeyFileOption())
-    .option('--project-id <id>', 'Override project ID (optional)')
-    .option('--team-id <id>', 'Override team ID (optional)')
-    .option('--format <format>', 'Output format (json)')
-    .option('--output-file <path>', 'Write full output to a file (stdout prints a short summary)')
-    .option('--verbose', 'Print full raw output to stdout; with --output-file, also echo it', false)
-    .addHelpText('after', CONVENTION_HINT)
-    .action(async (action, options) => {
-    try {
-        const result = await executeCommand('change-set', action, options);
-        printCommandResult({
-            result,
-            format: normalizeFormat(options.format),
-            outputFile: options.outputFile,
-            verbose: options.verbose,
-            resource: 'change-set',
-            action,
-            formatExplicit: typeof options.format === 'string',
-        });
-    }
-    catch (error) {
-        console.error(handleError(error));
-        process.exit(1);
-    }
-});
-program
-    .command('postmortem')
-    .description('Manage post mortems')
-    .argument('<action>', 'Action to perform (list, get, create, update, delete)')
-    .option('--id <id>', 'Post mortem ID')
-    .option('--plan-id <id>', 'Plan ID (optional)')
-    .option('--title <title>', 'Post mortem title')
-    .option('--content <content>', 'Post mortem markdown content (short text; use --file for long content)')
-    .option('--file <path>', 'Read postmortem content from a local file (create/update)')
-    .option('--keep-temp', 'Keep the uploaded file under .agentteams/cli/temp/ instead of deleting it after upload', false)
-    .option('--action-items <csv>', 'Action items (comma-separated)')
-    .option('--status <status>', 'Post mortem status (OPEN, IN_PROGRESS, RESOLVED)')
-    .option('--repository-remote-url <url>', 'Repository remote origin URL (create; defaults to git origin)')
-    .option('--page <number>', 'Page number (list only)')
-    .option('--page-size <number>', 'Page size (list only)')
-    .option('--search <text>', 'Title keyword search (list only)')
-    .option('--limit <n>', 'Max results per page, alias for --page-size (list only)')
-    .option('--api-url <url>', 'Override API URL (optional)')
-    .addOption(createApiKeyOption())
-    .addOption(createApiKeyFileOption())
-    .option('--project-id <id>', 'Override project ID (optional)')
-    .option('--team-id <id>', 'Override team ID (optional)')
-    .option('--format <format>', 'Output format (json)')
-    .option('--output-file <path>', 'Write full output to a file (stdout prints a short summary)')
-    .option('--verbose', 'Print full raw output to stdout; with --output-file, also echo it', false)
-    .addHelpText('after', CONVENTION_HINT)
-    .action(async (action, options) => {
-    try {
-        const normalizedFormat = normalizeFormat(options.format);
-        const result = await executeCommand('postmortem', action, {
-            id: options.id,
-            planId: options.planId,
-            title: options.title,
-            content: options.content,
-            file: options.file,
-            actionItems: options.actionItems,
-            status: options.status,
-            repositoryRemoteUrl: options.repositoryRemoteUrl,
-            page: options.page,
-            pageSize: options.pageSize,
-            search: options.search,
-            limit: options.limit,
-            apiUrl: options.apiUrl,
-            apiKey: options.apiKey,
-            projectId: options.projectId,
-            teamId: options.teamId,
-        });
-        printCommandResult({
-            result,
-            format: normalizedFormat,
-            outputFile: options.outputFile,
-            verbose: options.verbose,
-            resource: 'postmortem',
-            action,
-            formatExplicit: typeof options.format === 'string',
-        });
-    }
-    catch (error) {
-        console.error(handleError(error));
-        process.exit(1);
-    }
-});
-program
-    .command('coaction')
-    .description('Manage co-actions (session context dumps)')
-    .argument('<action>', 'Action to perform (list, get, create, update, delete, download, cleanup, takeaway-list, takeaway-create, takeaway-update, takeaway-delete, history, link-plan, unlink-plan, link-completion-report, unlink-completion-report, link-post-mortem, unlink-post-mortem)')
-    .option('--id <id>', 'Co-action ID')
-    .option('--takeaway-id <id>', 'Co-action takeaway ID (for takeaway-update/takeaway-delete)')
-    .option('--plan-id <id>', 'Plan ID (for link-plan/unlink-plan)')
-    .option('--completion-report-id <id>', 'Completion report ID for linking/unlinking')
-    .option('--post-mortem-id <id>', 'Post-mortem ID for linking/unlinking')
-    .option('--title <title>', 'Co-action title')
-    .option('--content <content>', 'Co-action content (short text; use --file for long content)')
-    .option('--file <path>', 'Read co-action content from a local file (create/update)')
-    .option('--keep-temp', 'Keep the uploaded file under .agentteams/cli/temp/ instead of deleting it after upload', false)
-    .option('--status <status>', 'Co-action status (OPEN, CLOSED)')
-    .option('--visibility <visibility>', 'Co-action visibility (PRIVATE, PROJECT; also filters list)')
-    .option('--source <source>', 'Filter by source (MANUAL, AUTO_SESSION, ALL; list only, default MANUAL)')
-    .option('--page <number>', 'Page number (list only)')
-    .option('--page-size <number>', 'Page size (list only)')
-    .option('--search <text>', 'Title keyword search (list only)')
-    .option('--limit <n>', 'Max results per page, alias for --page-size (list only)')
-    .option('--api-url <url>', 'Override API URL (optional)')
-    .addOption(createApiKeyOption())
-    .addOption(createApiKeyFileOption())
-    .option('--project-id <id>', 'Override project ID (optional)')
-    .option('--team-id <id>', 'Override team ID (optional)')
-    .option('--format <format>', 'Output format (json)')
-    .option('--output-file <path>', 'Write full output to a file (stdout prints a short summary)')
-    .option('--verbose', 'Print full raw output to stdout; with --output-file, also echo it', false)
-    .addHelpText('after', CONVENTION_HINT)
-    .action(async (action, options) => {
-    try {
-        const normalizedFormat = normalizeFormat(options.format);
-        const result = await executeCommand('coaction', action, {
-            id: options.id,
-            takeawayId: options.takeawayId,
-            planId: options.planId,
-            completionReportId: options.completionReportId,
-            postMortemId: options.postMortemId,
-            title: options.title,
-            content: options.content,
-            file: options.file,
-            status: options.status,
-            visibility: options.visibility,
-            source: options.source,
-            page: options.page,
-            pageSize: options.pageSize,
-            search: options.search,
-            limit: options.limit,
-            apiUrl: options.apiUrl,
-            apiKey: options.apiKey,
-            projectId: options.projectId,
-            teamId: options.teamId,
-        });
-        printCommandResult({
-            result,
-            format: normalizedFormat,
-            outputFile: options.outputFile,
-            verbose: options.verbose,
-            resource: 'coaction',
-            action,
-            formatExplicit: typeof options.format === 'string',
-        });
-    }
-    catch (error) {
-        console.error(handleError(error));
-        process.exit(1);
-    }
-});
-program
-    .command('feedback')
-    .description('Manage platform feedback')
-    .argument('<action>', 'Action to perform (create)')
-    .option('--category <category>', 'Feedback category (BUG, SUGGESTION, CONVENTION, UX)')
-    .option('--title <title>', 'Feedback title')
-    .option('--content <content>', 'Feedback content')
-    .option('--api-url <url>', 'Override API URL (optional)')
-    .addOption(createApiKeyOption())
-    .addOption(createApiKeyFileOption())
-    .option('--project-id <id>', 'Override project ID (optional)')
-    .option('--team-id <id>', 'Override team ID (optional)')
-    .option('--format <format>', 'Output format (json)')
-    .option('--output-file <path>', 'Write full output to a file (stdout prints a short summary)')
-    .option('--verbose', 'Print full raw output to stdout; with --output-file, also echo it', false)
-    .addHelpText('after', CONVENTION_HINT)
-    .action(async (action, options) => {
-    try {
-        const normalizedFormat = normalizeFormat(options.format);
-        const result = await executeCommand('feedback', action, {
-            category: options.category,
-            title: options.title,
-            content: options.content,
-            apiUrl: options.apiUrl,
-            apiKey: options.apiKey,
-            projectId: options.projectId,
-            teamId: options.teamId,
-        });
-        printCommandResult({
-            result,
-            format: normalizedFormat,
-            outputFile: options.outputFile,
-            verbose: options.verbose,
-            resource: 'feedback',
-            action,
-            formatExplicit: typeof options.format === 'string',
-        });
-    }
-    catch (error) {
-        console.error(handleError(error));
-        process.exit(1);
-    }
-});
-program
-    .command('convention')
-    .description('Manage project conventions')
-    .argument('<action>', 'Action to perform (list, show, download, status, create, update, delete)')
-    .option('--cwd <path>', 'Working directory (defaults to current)')
-    .option('-f, --file <path>', 'Target convention markdown file (repeatable; create requires a file under .agentteams/<category>/)', (value, previous = []) => previous.concat([value]), [])
-    .option('--apply', 'Apply changes to server (default: dry-run)', false)
-    .addOption(new Option('--scope <scope>', 'Convention scope (create only; defaults to PROJECT)').choices([
-    'PROJECT',
-    'PERSONAL',
-]))
-    .option('--output-file <path>', 'Write full output to a file (stdout prints a short summary)')
-    .option('--verbose', 'Print full raw output to stdout; with --output-file, also echo it', false)
-    .addHelpText('after', CONVENTION_HINT)
-    .action(async (action, options) => {
-    try {
-        const result = await executeCommand('convention', action, {
-            cwd: options.cwd ?? process.cwd(),
-            file: options.file,
-            apply: options.apply,
-            scope: options.scope,
-        });
-        printCommandResult({
-            result,
-            format: 'json',
-            outputFile: options.outputFile,
-            verbose: options.verbose,
-        });
-    }
-    catch (error) {
-        console.error(handleError(error));
-        process.exit(1);
-    }
-});
-program
-    .command('document')
-    .description('Manage project documents')
-    .argument('<action>', 'Action to perform (create, update, download, list, tags, delete, archive, unarchive, revisions, revision-get, revision-restore, comment-list, comment-create, comment-update, comment-delete)')
-    .option('--id <id>', 'Document ID')
-    .option('--title <title>', 'Document title')
-    .option('--file <path>', 'Read markdown body from a local file')
-    .option('--tags <tags>', 'Comma-separated tags. List: filter. Create/update: sent as suggestions (not confirmed).')
-    .option('--suggested-tags <tags>', 'Comma-separated AI-suggested tags (auto-promoted when they match existing tags, else await user review)')
-    .option('--visibility <visibility>', 'Document visibility: PRIVATE or PROJECT (default: PRIVATE)')
-    .option('--archived <state>', 'Archive filter for list (ACTIVE, ARCHIVED, ALL)')
-    .option('--revision-id <id>', 'Document revision ID')
-    .option('--comment-id <id>', 'Document comment ID')
-    .option('--content <text>', 'Markdown content for document comments')
-    .option('--order <order>', 'Comment order (asc or desc)')
-    .option('--query <q>', 'Search query (list only)')
-    .option('--limit <n>', 'Max results per page, alias for --page-size (list/revisions/comment-list)')
-    .option('--page <number>', 'Page number (list/revisions/comment-list)')
-    .option('--page-size <number>', 'Page size (list/revisions/comment-list)')
-    .option('--guide-hash <hash>', 'Hash of the document guide you followed (create/update/delete). Stale hash is rejected with GUIDE_OUTDATED.')
-    .option('--idempotency-key <key>', 'Retry-safe key (create/update/delete). Repeating the same key with the same request replays the first result.')
-    .option('--expected-updated-at <iso>', "The document's updatedAt as you last read it (update/delete). Rejects the write if it changed meanwhile.")
-    .option('--api-url <url>', 'Override API URL (optional)')
-    .addOption(createApiKeyOption())
-    .addOption(createApiKeyFileOption())
-    .option('--project-id <id>', 'Override project ID (optional)')
-    .option('--team-id <id>', 'Override team ID (optional)')
-    .option('--format <format>', 'Output format (json)', 'json')
-    .option('--output-file <path>', 'Write full output to a file (stdout prints a short summary)')
-    .option('--verbose', 'Print full raw output to stdout; with --output-file, also echo it', false)
-    .addHelpText('after', CONVENTION_HINT)
-    .action(async (action, options) => {
-    try {
-        const result = await executeCommand('document', action, options);
-        printCommandResult({
-            result,
-            format: normalizeFormat(options.format),
-            outputFile: options.outputFile,
-            verbose: options.verbose,
-            resource: 'document',
-            action,
-            formatExplicit: typeof options.format === 'string',
-        });
-    }
-    catch (error) {
-        console.error(handleError(error));
-        process.exit(1);
-    }
-});
-program
-    .command('dependency')
-    .description('Manage plan dependencies')
-    .argument('<action>', 'Action to perform (list, create, delete)')
-    .option('--plan-id <id>', 'Plan ID')
-    .option('--blocking-plan-id <id>', 'Blocking plan ID')
-    .option('--dep-id <id>', 'Dependency ID to delete')
-    .option('--format <format>', 'Output format (json)', 'json')
-    .option('--output-file <path>', 'Write full output to a file (stdout prints a short summary)')
-    .option('--verbose', 'Print full raw output to stdout; with --output-file, also echo it', false)
-    .addHelpText('after', CONVENTION_HINT)
-    .action(async (action, options) => {
-    try {
-        const result = await executeCommand('dependency', action, {
-            planId: options.planId,
-            blockingPlanId: options.blockingPlanId,
-            depId: options.depId,
-        });
-        printCommandResult({
-            result,
-            format: normalizeFormat(options.format),
-            outputFile: options.outputFile,
-            verbose: options.verbose,
-        });
-    }
-    catch (error) {
-        console.error(handleError(error));
-        process.exit(1);
-    }
-});
-program
-    .command('agent-config')
-    .description('Manage agent configurations')
-    .argument('<action>', 'Action to perform (list, get, delete)')
-    .option('--id <id>', 'Agent config ID')
-    .option('--format <format>', 'Output format (json)', 'json')
-    .option('--output-file <path>', 'Write full output to a file (stdout prints a short summary)')
-    .option('--verbose', 'Print full raw output to stdout; with --output-file, also echo it', false)
-    .addHelpText('after', CONVENTION_HINT)
-    .action(async (action, options) => {
-    try {
-        const result = await executeCommand('agent-config', action, {
-            id: options.id,
-        });
-        printCommandResult({
-            result,
-            format: normalizeFormat(options.format),
-            outputFile: options.outputFile,
-            verbose: options.verbose,
-        });
-    }
-    catch (error) {
-        console.error(handleError(error));
-        process.exit(1);
-    }
-});
-program
-    .command('config')
-    .description('Manage configuration')
-    .argument('<action>', 'Action to perform (whoami)')
-    .option('--format <format>', 'Output format (json)', 'json')
-    .option('--output-file <path>', 'Write full output to a file (stdout prints a short summary)')
-    .option('--verbose', 'Print full raw output to stdout; with --output-file, also echo it', false)
-    .addHelpText('after', CONVENTION_HINT)
-    .action(async (action, options) => {
-    try {
-        const result = await executeCommand('config', action, {});
-        printCommandResult({
-            result,
-            format: normalizeFormat(options.format),
-            outputFile: options.outputFile,
-            verbose: options.verbose,
-        });
-    }
-    catch (error) {
-        console.error(handleError(error));
-        process.exit(1);
-    }
-});
-program
-    .command('search')
-    .description('Search across all entity types (plans, co-actions, reports, post-mortems, conventions, code reviews, documents)')
-    .option('--query <text>', 'Search query (required)')
-    .option('--types <types>', 'Comma-separated entity types to filter (PLAN, CO_ACTION, COMPLETION_REPORT, POST_MORTEM, CONVENTION, CODE_REVIEW, DOCUMENT)')
-    .option('--limit <n>', 'Max results (1-100, default: 20)')
-    .option('--max-tokens <n>', 'Token budget for response')
-    .option('--api-url <url>', 'Override API URL (optional)')
-    .addOption(createApiKeyOption())
-    .addOption(createApiKeyFileOption())
-    .option('--project-id <id>', 'Override project ID (optional)')
-    .option('--team-id <id>', 'Override team ID (optional)')
-    .option('--format <format>', 'Output format (json)', 'json')
-    .option('--output-file <path>', 'Write full output to a file (stdout prints a short summary)')
-    .option('--verbose', 'Print full raw output to stdout; with --output-file, also echo it', false)
-    .addHelpText('after', CONVENTION_HINT)
-    .action(async (options) => {
-    try {
-        const normalizedFormat = normalizeFormat(options.format);
-        const result = await executeCommand('search', '', {
-            query: options.query,
-            types: options.types,
-            limit: options.limit,
-            maxTokens: options.maxTokens,
-            apiUrl: options.apiUrl,
-            apiKey: options.apiKey,
-            projectId: options.projectId,
-            teamId: options.teamId,
-        });
-        printCommandResult({
-            result,
-            format: normalizedFormat,
-            outputFile: options.outputFile,
-            verbose: options.verbose,
-            resource: 'search',
-            formatExplicit: typeof options.format === 'string',
-        });
-    }
-    catch (error) {
-        console.error(handleError(error));
-        process.exit(1);
-    }
-});
-const mcpCommand = program
-    .command('mcp')
-    .description('Run an MCP server over stdio, exposing AgentTeams reads to MCP-capable coding agents')
-    .option('--tool-profile <profile>', 'Tool catalog profile (full, read, documents, comments, minimal); full is the compatibility default, limited profiles reduce upfront schemas', 'full')
-    .option('--api-url <url>', 'Override API URL (optional)')
-    .addOption(createApiKeyOption())
-    .addOption(createApiKeyFileOption())
-    .option('--project-id <id>', 'Override project ID (optional)')
-    .option('--team-id <id>', 'Override team ID (optional)')
-    .addHelpText('after', CONVENTION_HINT)
-    .action(async (options) => {
-    try {
-        // Loaded lazily so the MCP SDK — which requires a newer Node than some of
-        // the CLI's other commands need — never enters the other command paths.
-        const { startMcpServer } = await import('./commands/mcp.js');
-        // stdout carries JSON-RPC frames only: this action deliberately bypasses
-        // executeCommand()/printCommandResult() and never writes to stdout.
-        await startMcpServer({
-            apiUrl: options.apiUrl,
-            apiKey: options.apiKey,
-            projectId: options.projectId,
-            teamId: options.teamId,
-            toolProfile: options.toolProfile,
-        });
-    }
-    catch (error) {
-        // Staying alive without credentials would make the client retry forever.
-        console.error(handleError(error));
-        process.exit(1);
-    }
-});
-const MCP_CLIENT_CHOICES = MCP_CLIENT_IDS.join(', ');
-function addMcpRegistrationOptions(command) {
-    return command
-        .option('--client <id>', `Target client (${MCP_CLIENT_CHOICES})`)
-        .option('--scope <scope>', 'Configuration scope (user, project)', 'project')
-        .option('--tool-profile <profile>', 'Tool catalog profile (full, read, documents, comments, minimal); full is the compatibility default, limited profiles reduce upfront schemas. A client whose backend rejects part of the catalog is narrowed automatically unless you name a profile here')
-        .option('--server-entry <path>', 'Use a local `cli/dist/index.js` instead of the published package (for pre-release testing)')
-        .option('--json', 'Print the machine-readable result instead of the human-readable report', false)
-        .option('--api-url <url>', 'Override API URL (optional)')
-        .addOption(createApiKeyOption())
-        .addOption(createApiKeyFileOption())
-        .option('--project-id <id>', 'Override project ID (optional)')
-        .option('--team-id <id>', 'Override team ID (optional)');
-}
-/**
- * The registration surface is loaded lazily for the same reason the server is:
- * `agentteams mcp` must stay a thin stdio entry point, and no other command
- * should pay for the client registry.
- */
-async function runMcpRegistration(action, options, command) {
-    try {
-        const parentOptions = command.parent?.opts() ?? {};
-        const merged = { ...parentOptions, ...options };
-        const { runMcpConfigCommand, runMcpInstallCommand } = await import('./mcp-registration/index.js');
-        const output = action === 'config' ? runMcpConfigCommand(merged) : runMcpInstallCommand(merged);
-        console.log(options.json ? formatOutput(output.json) : output.text);
-        process.exitCode = output.exitCode;
-    }
-    catch (error) {
-        console.error(handleError(error));
-        process.exit(1);
-    }
-}
-addMcpRegistrationOptions(mcpCommand
-    .command('config')
-    .description('Print the MCP configuration snippet for a coding agent. Never writes files or credentials.'))
-    .addHelpText('after', CONVENTION_HINT)
-    .action((options, command) => runMcpRegistration('config', options, command));
-addMcpRegistrationOptions(mcpCommand
-    .command('install')
-    .description('Register AgentTeams with local MCP clients. Without --client it only prints a detection plan; batch apply requires --scope user --yes.'))
-    .option('--yes', 'Apply an explicitly selected user-scope batch plan instead of only printing it', false)
-    .addHelpText('after', CONVENTION_HINT)
-    .action((options, command) => runMcpRegistration('install', options, command));
-mcpCommand
-    .command('doctor')
-    .description('Find legacy plaintext MCP key copies; cleanup is applied only with explicit --yes confirmation.')
-    .option('--yes', 'Confirm safe cleanup after the audit', false)
-    .option('--json', 'Print the machine-readable result instead of the human-readable report', false)
-    .addHelpText('after', CONVENTION_HINT)
-    .action(async (options) => {
-    try {
-        const { runMcpDoctorCommand } = await import('./mcp-registration/doctor.js');
-        const output = await runMcpDoctorCommand({ yes: options.yes === true });
-        console.log(options.json ? formatOutput(output.json) : output.text);
-        process.exitCode = output.exitCode;
-    }
-    catch (error) {
-        console.error(handleError(error));
-        process.exit(1);
-    }
-});
-const linearCommand = program
-    .command('linear')
-    .description('Read Linear issues and add comments through the AgentTeams API')
-    .addHelpText('after', CONVENTION_HINT);
-linearCommand
-    .command('issue')
-    .description('Read, create, or update a Linear issue')
-    .argument('<action>', 'Action to perform (get, create, update)')
-    .option('--issue-id <id>', 'Linear issue ID (required for get, update)')
-    .option('--team-id <id>', 'Linear team ID (required for create)')
-    .option('--title <text>', 'Issue title (required for create)')
-    .option('--description <text>', 'Issue description (optional, for create)')
-    .option('--state <name>', 'Issue state name, e.g. "Done", "Todo" (required for update, optional for create)')
-    .option('--parent-id <id>', 'Linear parent issue UUID for creating a sub-issue (optional, for create)')
-    .option('--api-url <url>', 'Override API URL (optional)')
-    .addOption(createApiKeyOption())
-    .addOption(createApiKeyFileOption())
-    .option('--project-id <id>', 'Override project ID (optional)')
-    .option('--format <format>', 'Output format (json)', 'json')
-    .option('--output-file <path>', 'Write full output to a file (stdout prints a short summary)')
-    .option('--verbose', 'Print full raw output to stdout; with --output-file, also echo it', false)
-    .action(async (action, options) => {
-    try {
-        if (action !== 'get' && action !== 'create' && action !== 'update') {
-            throw new Error(`Unknown action: ${action}`);
-        }
-        const actionMap = { get: 'issue-get', create: 'issue-create', update: 'issue-update' };
-        const commandAction = actionMap[action];
-        const normalizedFormat = normalizeFormat(options.format);
-        const result = await executeCommand('linear', commandAction, {
-            issueId: options.issueId,
-            teamId: options.teamId,
-            title: options.title,
-            description: options.description,
-            state: options.state,
-            parentId: options.parentId,
-            apiUrl: options.apiUrl,
-            apiKey: options.apiKey,
-            projectId: options.projectId,
-        });
-        printCommandResult({
-            result,
-            format: normalizedFormat,
-            outputFile: options.outputFile,
-            verbose: options.verbose,
-            resource: 'linear',
-            action: commandAction,
-            formatExplicit: typeof options.format === 'string',
-        });
-    }
-    catch (error) {
-        console.error(handleError(error));
-        process.exit(1);
-    }
-});
-linearCommand
-    .command('comment')
-    .description('Manage comments on a Linear issue')
-    .argument('<action>', 'Action to perform (list, create)')
-    .option('--issue-id <id>', 'Linear issue ID')
-    .option('--body <text>', 'Comment body')
-    .option('--api-url <url>', 'Override API URL (optional)')
-    .addOption(createApiKeyOption())
-    .addOption(createApiKeyFileOption())
-    .option('--project-id <id>', 'Override project ID (optional)')
-    .option('--team-id <id>', 'Override team ID (optional)')
-    .option('--format <format>', 'Output format (json)', 'json')
-    .option('--output-file <path>', 'Write full output to a file (stdout prints a short summary)')
-    .option('--verbose', 'Print full raw output to stdout; with --output-file, also echo it', false)
-    .action(async (action, options) => {
-    try {
-        if (action !== 'list' && action !== 'create') {
-            throw new Error(`Unknown action: ${action}`);
-        }
-        const commentAction = action === 'list' ? 'comment-list' : 'comment-create';
-        const normalizedFormat = normalizeFormat(options.format);
-        const result = await executeCommand('linear', commentAction, {
-            issueId: options.issueId,
-            body: options.body,
-            apiUrl: options.apiUrl,
-            apiKey: options.apiKey,
-            projectId: options.projectId,
-            teamId: options.teamId,
-        });
-        printCommandResult({
-            result,
-            format: normalizedFormat,
-            outputFile: options.outputFile,
-            verbose: options.verbose,
-            resource: 'linear',
-            action: commentAction,
-            formatExplicit: typeof options.format === 'string',
-        });
-    }
-    catch (error) {
-        console.error(handleError(error));
-        process.exit(1);
-    }
-});
+const program = createProgram(pkg.version);
 startUpdateCheck(pkg.version);
 program.parse();
 process.on('beforeExit', () => {