@zaowu-labs/cli 1.0.1

package/dist/root-doctor.js

@@ -0,0 +1,231 @@
+import path from 'node:path';
+import { validateAIProviderConfig } from '@zaowu-labs/ai';
+import { findConfigFile, loadResolvedConfig } from '@zaowu-labs/config';
+import { createOperationPlan, isZaoWuError } from '@zaowu-labs/core';
+import { COMMAND_CONTRACTS } from './command-contracts.js';
+import { runSystemCommand } from './system-command.js';
+const MINIMUM_NODE_VERSION = '20.19.0';
+const MINIMUM_PNPM_VERSION = '10.34.1';
+const MAXIMUM_PNPM_MAJOR = 11;
+const ADDITIONAL_ROOT_SURFACES_IN_CAPABILITY_MATRIX = 3;
+const PNPM_MISSING_FIX = 'Run `corepack enable` or install pnpm.';
+const PNPM_VERSION_FIX = `Use pnpm ${MINIMUM_PNPM_VERSION} through Corepack: ` +
+    `corepack prepare pnpm@${MINIMUM_PNPM_VERSION} --activate.`;
+const satisfiesMinimumVersion = (version, minimum) => {
+    const parse = (value) => value
+        .replace(/^v/, '')
+        .split('.')
+        .map((part) => Number.parseInt(part, 10) || 0);
+    const actual = parse(version);
+    const required = parse(minimum);
+    const length = Math.max(actual.length, required.length);
+    for (let index = 0; index < length; index += 1) {
+        const actualPart = actual[index] ?? 0;
+        const requiredPart = required[index] ?? 0;
+        if (actualPart > requiredPart) {
+            return true;
+        }
+        if (actualPart < requiredPart) {
+            return false;
+        }
+    }
+    return true;
+};
+const extractVersion = (output) => {
+    const match = output.match(/v?\d+(?:\.\d+)+(?:[-.\w]*)?/);
+    return match?.[0];
+};
+const getMajorVersion = (version) => Number.parseInt(version.replace(/^v/, '').split('.')[0] ?? '', 10) || 0;
+const satisfiesPnpmVersion = (version) => Boolean(version &&
+    satisfiesMinimumVersion(version, MINIMUM_PNPM_VERSION) &&
+    getMajorVersion(version) < MAXIMUM_PNPM_MAJOR);
+const checkCommand = (name, command, args, fix, commandRunner, details) => {
+    try {
+        const output = commandRunner(command, args);
+        return {
+            name,
+            status: 'ok',
+            version: extractVersion(output),
+            details,
+        };
+    }
+    catch {
+        return {
+            name,
+            status: 'missing',
+            fix,
+        };
+    }
+};
+const checkPnpmCommand = (command, args, commandRunner, details) => {
+    try {
+        const output = commandRunner(command, args);
+        const version = extractVersion(output);
+        const isSupported = satisfiesPnpmVersion(version);
+        return {
+            name: 'pnpm',
+            status: isSupported ? 'ok' : 'warning',
+            version,
+            details,
+            fix: isSupported ? undefined : PNPM_VERSION_FIX,
+        };
+    }
+    catch {
+        return {
+            name: 'pnpm',
+            status: 'missing',
+            fix: PNPM_MISSING_FIX,
+        };
+    }
+};
+const checkPnpm = (commandRunner) => {
+    const pnpmCheck = checkPnpmCommand('pnpm', ['--version'], commandRunner);
+    if (pnpmCheck.status === 'ok') {
+        return pnpmCheck;
+    }
+    const corepackPnpmCheck = checkPnpmCommand('corepack', ['pnpm', '--version'], commandRunner, 'via corepack');
+    if (corepackPnpmCheck.status === 'ok') {
+        return corepackPnpmCheck;
+    }
+    if (pnpmCheck.status !== 'missing') {
+        return pnpmCheck;
+    }
+    return corepackPnpmCheck.status !== 'missing' ? corepackPnpmCheck : pnpmCheck;
+};
+const getConfigCheck = async (cwd) => {
+    const configFile = await findConfigFile({ cwd });
+    if (!configFile) {
+        return {
+            check: {
+                name: 'Config',
+                status: 'missing',
+                fix: 'Run `zw init` to preview config creation, then `zw init --yes` to create it.',
+            },
+            checkedInvalidConfig: false,
+        };
+    }
+    try {
+        const resolvedConfig = await loadResolvedConfig(cwd);
+        return {
+            check: {
+                name: 'Config',
+                status: 'ok',
+                details: path.relative(cwd, resolvedConfig.filePath) || 'zw.yml',
+            },
+            resolvedConfig,
+            checkedInvalidConfig: false,
+        };
+    }
+    catch (error) {
+        return {
+            check: {
+                name: 'Config',
+                status: 'warning',
+                details: path.relative(cwd, configFile) || 'zw.yml',
+                fix: isZaoWuError(error)
+                    ? error.fix
+                    : 'Run `zw config validate` to inspect and repair the config file.',
+            },
+            checkedInvalidConfig: true,
+        };
+    }
+};
+const checkAIProvider = (resolvedConfig, checkedInvalidConfig) => {
+    if (!resolvedConfig && checkedInvalidConfig) {
+        return {
+            name: 'AI provider',
+            status: 'warning',
+            details: 'not checked because config is invalid',
+            fix: 'Run `zw config validate` before enabling provider-backed AI commands.',
+        };
+    }
+    try {
+        const validation = validateAIProviderConfig(resolvedConfig?.config.ai.provider);
+        const provider = validation.provider;
+        const location = provider.network ? 'network' : 'local';
+        const configStatus = provider.configured ? 'configured' : 'missing config';
+        return {
+            name: 'AI provider',
+            status: validation.status,
+            details: `${provider.id} (${location}, ${configStatus})`,
+            fix: validation.warnings[0],
+        };
+    }
+    catch (error) {
+        return {
+            name: 'AI provider',
+            status: 'warning',
+            details: String(resolvedConfig?.config.ai.provider ?? 'default'),
+            fix: isZaoWuError(error)
+                ? error.fix
+                : 'Run `zw ai providers --json` to inspect supported AI providers.',
+        };
+    }
+};
+const checkCommandMatrix = () => ({
+    name: 'Command matrix',
+    status: 'ok',
+    details: `${COMMAND_CONTRACTS.length + ADDITIONAL_ROOT_SURFACES_IN_CAPABILITY_MATRIX} command surface(s) tracked`,
+});
+export const buildDoctorResult = async (options = {}) => {
+    const cwd = options.cwd ?? process.cwd();
+    const nodeVersion = options.nodeVersion ?? process.versions.node;
+    const commandRunner = options.commandRunner ?? runSystemCommand;
+    const checks = [];
+    checks.push({
+        name: 'Node.js',
+        status: satisfiesMinimumVersion(nodeVersion, MINIMUM_NODE_VERSION) ? 'ok' : 'warning',
+        version: `v${nodeVersion.replace(/^v/, '')}`,
+        fix: satisfiesMinimumVersion(nodeVersion, MINIMUM_NODE_VERSION)
+            ? undefined
+            : `Install Node.js ${MINIMUM_NODE_VERSION} or newer.`,
+    });
+    checks.push(checkCommand('Git', 'git', ['--version'], 'Install Git and make sure it is on PATH.', commandRunner));
+    checks.push(checkPnpm(commandRunner));
+    const config = await getConfigCheck(cwd);
+    checks.push(config.check);
+    checks.push(checkAIProvider(config.resolvedConfig, config.checkedInvalidConfig ?? false));
+    checks.push(checkCommandMatrix());
+    const nextSteps = checks
+        .filter((check) => check.status !== 'ok' && check.fix)
+        .map((check) => check.fix);
+    return {
+        schemaVersion: 1,
+        status: checks.some((check) => check.status !== 'ok') ? 'warning' : 'ok',
+        checks,
+        nextSteps,
+        operationPlan: createOperationPlan({
+            risk: 'low',
+            reads: [
+                'nearest ZaoWu config path',
+                'resolved ZaoWu config',
+                'AI provider environment variable presence',
+                'command contract registry',
+            ],
+            executes: ['git --version', 'pnpm --version', 'corepack pnpm --version'],
+            notes: ['Doctor runs fixed local diagnostics and does not write files.'],
+        }),
+    };
+};
+export const formatDoctorHuman = (doctor) => {
+    const lines = [
+        'ZaoWu Doctor',
+        '',
+        `Status: ${doctor.status === 'ok' ? 'OK' : 'Warning'}`,
+        '',
+        'Checks:',
+    ];
+    for (const check of doctor.checks) {
+        const parts = [check.status, check.version, check.details].filter(Boolean);
+        const suffix = parts.join(' ');
+        lines.push(`- ${check.name}: ${suffix}`);
+    }
+    if (doctor.nextSteps.length > 0) {
+        lines.push('', 'Next steps:');
+        doctor.nextSteps.forEach((step, index) => {
+            lines.push(`${index + 1}. ${step}`);
+        });
+    }
+    return lines.join('\n');
+};
+//# sourceMappingURL=root-doctor.js.map

package/dist/root-doctor.js.map

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

package/dist/root-help.d.ts

@@ -0,0 +1,8 @@
+import type { DomainDefinition, OperationPlan } from '@zaowu-labs/core';
+export declare const formatHelp: () => string;
+export declare const formatDomainHelp: (domain: DomainDefinition) => string;
+export declare const formatActionHelp: (domain: DomainDefinition, action: string) => string;
+export declare const formatInitHelp: () => string;
+export declare const formatDoctorHelp: () => string;
+export declare const formatInlineOperationPlan: (plan: OperationPlan) => string;
+//# sourceMappingURL=root-help.d.ts.map

package/dist/root-help.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"root-help.d.ts","sourceRoot":"","sources":["../src/root-help.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAOxE,eAAO,MAAM,UAAU,QAAO,MAoC7B,CAAC;AAEF,eAAO,MAAM,gBAAgB,GAAI,QAAQ,gBAAgB,KAAG,MAoC3D,CAAC;AAEF,eAAO,MAAM,gBAAgB,GAAI,QAAQ,gBAAgB,EAAE,QAAQ,MAAM,KAAG,MAS1B,CAAC;AAEnD,eAAO,MAAM,cAAc,QAAO,MAqBjB,CAAC;AAElB,eAAO,MAAM,gBAAgB,QAAO,MAcjB,CAAC;AAEpB,eAAO,MAAM,yBAAyB,GAAI,MAAM,aAAa,KAAG,MAYlD,CAAC"}

package/dist/root-help.js

@@ -0,0 +1,130 @@
+import { DOMAIN_DEFINITIONS } from './domains.js';
+import { ACTION_HELP } from './help-text.js';
+import { formatRows } from './output.js';
+const toTitleCase = (value) => `${value.charAt(0).toUpperCase()}${value.slice(1)}`;
+export const formatHelp = () => {
+    const commands = formatRows([
+        ['zw init', 'Preview or create a ZaoWu config file'],
+        ['zw doctor', 'Check local environment health'],
+        ['zw help', 'Show this help'],
+    ]);
+    const domains = formatRows(DOMAIN_DEFINITIONS.map((domain) => [`zw ${domain.name}`, domain.summary]));
+    return `ZaoWu / 造物
+
+Usage:
+  zw <command> [options]
+
+Commands:
+${commands}
+
+Domains:
+${domains}
+
+Global options:
+  --help             Show help
+  --version          Show version
+  --json             Output machine-readable JSON
+  --dry-run          Preview without applying changes
+  --yes              Apply a safe confirmed action
+  --plan-fingerprint <hash>
+                     Require confirmed actions to match a previewed plan
+
+Examples:
+  zw doctor
+  zw doctor --json
+  zw init --dry-run
+  zw init --yes
+  zw dev --help`;
+};
+export const formatDomainHelp = (domain) => {
+    const commands = formatRows(domain.commands.map((command) => {
+        const flags = [command.status, command.sensitive ? 'sensitive' : undefined]
+            .filter(Boolean)
+            .join(', ');
+        return [`zw ${domain.name} ${command.name}`, `${flags} - ${command.summary}`];
+    }));
+    const capabilities = domain.capabilities
+        ? Object.entries(domain.capabilities)
+            .filter(([, enabled]) => enabled)
+            .map(([name]) => `- ${name}`)
+            .join('\n') || '- none'
+        : '- none';
+    return `ZaoWu ${toTitleCase(domain.name)} Domain
+
+Usage:
+  zw ${domain.name} <action> [target] [options]
+
+Description:
+  ${domain.summary}
+
+Commands:
+${commands}
+
+Capabilities:
+${capabilities}
+
+Global options:
+  --help             Show help
+  --json             Output machine-readable JSON
+  --dry-run          Preview without applying changes
+  --yes              Apply a safe confirmed action`;
+};
+export const formatActionHelp = (domain, action) => ACTION_HELP[domain.name]?.[action] ??
+    `ZaoWu ${toTitleCase(domain.name)} ${toTitleCase(action)}
+
+Usage:
+  zw ${domain.name} ${action} [target] [options]
+
+Options:
+  --help             Show help
+  --json             Output machine-readable JSON`;
+export const formatInitHelp = () => `ZaoWu Init
+
+Usage:
+  zw init [options]
+
+Description:
+  Preview or create a starter ZaoWu config file.
+
+Options:
+  --dry-run          Preview without writing files
+  --yes              Create zw.yml
+  --plan-fingerprint <hash>
+                     Require confirmed creation to match a preview
+  --json             Output machine-readable JSON
+  --help             Show this help
+
+Examples:
+  zw init
+  zw init --dry-run
+  zw init --yes
+  zw init --yes --plan-fingerprint <hash>
+  zw init --json`;
+export const formatDoctorHelp = () => `ZaoWu Doctor
+
+Usage:
+  zw doctor [options]
+
+Description:
+  Check local environment health.
+
+Options:
+  --json             Output machine-readable JSON
+  --help             Show this help
+
+Examples:
+  zw doctor
+  zw doctor --json`;
+export const formatInlineOperationPlan = (plan) => [
+    'Operation plan:',
+    `Risk: ${plan.risk}`,
+    `Confirmation required: ${plan.confirmationRequired ? 'yes' : 'no'}`,
+    `Fingerprint: ${plan.fingerprint}`,
+    ...(plan.confirmationRequired
+        ? [`Base confirmation flags: --yes --plan-fingerprint ${plan.fingerprint}`]
+        : []),
+    `Subjects: ${plan.subjects.length > 0 ? plan.subjects.join(', ') : 'none'}`,
+    `Writes: ${plan.writes.length > 0 ? plan.writes.join(', ') : 'none'}`,
+    `Deletes: ${plan.deletes.length > 0 ? plan.deletes.join(', ') : 'none'}`,
+].join('\n');
+//# sourceMappingURL=root-help.js.map

package/dist/root-help.js.map

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

package/dist/root-init.d.ts

@@ -0,0 +1,4 @@
+import type { CliExecutionOptions, CliResult } from './types.js';
+export declare const DEFAULT_CONFIG_FILE_NAME = "zw.yml";
+export declare const handleInit: (args: readonly string[], options: CliExecutionOptions, json: boolean) => Promise<CliResult>;
+//# sourceMappingURL=root-init.d.ts.map

package/dist/root-init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"root-init.d.ts","sourceRoot":"","sources":["../src/root-init.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,mBAAmB,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAEjE,eAAO,MAAM,wBAAwB,WAAW,CAAC;AA2BjD,eAAO,MAAM,UAAU,GACrB,MAAM,SAAS,MAAM,EAAE,EACvB,SAAS,mBAAmB,EAC5B,MAAM,OAAO,KACZ,OAAO,CAAC,SAAS,CA2EnB,CAAC"}

package/dist/root-init.js

@@ -0,0 +1,87 @@
+import { existsSync } from 'node:fs';
+import { writeFile } from 'node:fs/promises';
+import path from 'node:path';
+import { getDefaultConfigContent } from '@zaowu-labs/config';
+import { assertOperationPlanFingerprint, createContentOperationSubjects, createOperationPlan, ZaoWuError, } from '@zaowu-labs/core';
+import { getValue, parseArgs } from './args.js';
+import { createResult } from './output.js';
+import { formatInlineOperationPlan } from './root-help.js';
+export const DEFAULT_CONFIG_FILE_NAME = 'zw.yml';
+const hasFlag = (args, flag) => args.includes(flag);
+const formatInitPreview = (configPath, content, operationPlan) => `ZaoWu Init
+
+No files were written.
+
+Would create:
+  ${path.basename(configPath)}
+
+${formatInlineOperationPlan(operationPlan)}
+
+Preview:
+${content
+    .trimEnd()
+    .split('\n')
+    .map((line) => (line ? `  ${line}` : ''))
+    .join('\n')}
+
+To create exactly this file, run:
+  zw init --yes --plan-fingerprint ${operationPlan.fingerprint}`;
+export const handleInit = async (args, options, json) => {
+    const cwd = options.cwd ?? process.cwd();
+    const dryRun = hasFlag(args, '--dry-run');
+    const yes = hasFlag(args, '--yes');
+    const configPath = path.join(cwd, DEFAULT_CONFIG_FILE_NAME);
+    const content = getDefaultConfigContent(configPath);
+    const operationPlan = createOperationPlan({
+        risk: 'medium',
+        confirmationRequired: !yes || dryRun,
+        subjects: [`init:${configPath}`, ...createContentOperationSubjects(content)],
+        writes: [configPath],
+        notes: ['Init creates a config file only when --yes is provided and --dry-run is absent.'],
+    });
+    if (existsSync(configPath)) {
+        throw new ZaoWuError({
+            code: 'CONFIG_ALREADY_EXISTS',
+            message: 'ZaoWu config already exists.',
+            why: `${DEFAULT_CONFIG_FILE_NAME} already exists in the current directory.`,
+            fix: 'Open the existing config file or run `zw doctor` to check it.',
+        });
+    }
+    if (dryRun || !yes) {
+        const payload = {
+            schemaVersion: 1,
+            status: 'ok',
+            dryRun: true,
+            wouldCreate: configPath,
+            content,
+            operationPlan,
+        };
+        return createResult(0, json ? JSON.stringify(payload) : formatInitPreview(configPath, content, operationPlan));
+    }
+    assertOperationPlanFingerprint(getValue(parseArgs(args), '--plan-fingerprint'), operationPlan, yes && !dryRun, ZaoWuError);
+    try {
+        await writeFile(configPath, content, { encoding: 'utf8', flag: 'wx' });
+    }
+    catch {
+        throw new ZaoWuError({
+            code: 'CONFIG_WRITE_FAILED',
+            message: 'Could not write ZaoWu config.',
+            why: `ZaoWu tried to create ${DEFAULT_CONFIG_FILE_NAME} in the current directory, ` +
+                'but the file system rejected the write.',
+            fix: 'Check directory permissions and make sure the config file does not already exist.',
+        });
+    }
+    const payload = {
+        schemaVersion: 1,
+        status: 'ok',
+        created: configPath,
+        operationPlan: {
+            ...operationPlan,
+            confirmationRequired: false,
+        },
+    };
+    return createResult(0, json
+        ? JSON.stringify(payload)
+        : `ZaoWu Init\n\nCreated:\n  ${path.basename(configPath)}\n\nNext step:\n  zw doctor`);
+};
+//# sourceMappingURL=root-init.js.map

package/dist/root-init.js.map

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

package/dist/run.d.ts

@@ -0,0 +1,8 @@
+import { DOMAIN_DEFINITIONS } from './domains.js';
+import { DEFAULT_CONFIG_FILE_NAME } from './root-init.js';
+import type { CliExecutionOptions, CliResult } from './types.js';
+export declare const ZAOWU_CLI_VERSION: string;
+export { DEFAULT_CONFIG_FILE_NAME, DOMAIN_DEFINITIONS };
+export declare const executeCli: (args: readonly string[], options?: CliExecutionOptions) => Promise<CliResult>;
+export declare const runCli: (args: readonly string[]) => Promise<number>;
+//# sourceMappingURL=run.d.ts.map

package/dist/run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../src/run.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,kBAAkB,EAAc,MAAM,cAAc,CAAC;AAe9D,OAAO,EAAE,wBAAwB,EAAc,MAAM,gBAAgB,CAAC;AAEtE,OAAO,KAAK,EAAE,mBAAmB,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAGjE,eAAO,MAAM,iBAAiB,QAAkB,CAAC;AACjD,OAAO,EAAE,wBAAwB,EAAE,kBAAkB,EAAE,CAAC;AAyBxD,eAAO,MAAM,UAAU,GACrB,MAAM,SAAS,MAAM,EAAE,EACvB,UAAS,mBAAwB,KAChC,OAAO,CAAC,SAAS,CAyInB,CAAC;AAEF,eAAO,MAAM,MAAM,GAAU,MAAM,SAAS,MAAM,EAAE,KAAG,OAAO,CAAC,MAAM,CAgBpE,CAAC"}

package/dist/run.js

@@ -0,0 +1,152 @@
+import { findDomainCommand, isZaoWuError, ZaoWuError } from '@zaowu-labs/core';
+import { getValue, hasFlag, parseArgs } from './args.js';
+import { getDomainActionHandler } from './domain-handlers.js';
+import { DOMAIN_DEFINITIONS, findDomain } from './domains.js';
+import { assertNoMissingOptionValues, assertSupportedOptions, assertValidOptionValues, } from './option-validation.js';
+import { createResult } from './output.js';
+import { buildDoctorResult, formatDoctorHuman } from './root-doctor.js';
+import { formatActionHelp, formatDoctorHelp, formatDomainHelp, formatHelp, formatInitHelp, } from './root-help.js';
+import { DEFAULT_CONFIG_FILE_NAME, handleInit } from './root-init.js';
+import { runSystemCommand } from './system-command.js';
+import { getCliVersion } from './version.js';
+export const ZAOWU_CLI_VERSION = getCliVersion();
+export { DEFAULT_CONFIG_FILE_NAME, DOMAIN_DEFINITIONS };
+const handleError = (error, json) => {
+    const zaowuError = isZaoWuError(error)
+        ? error
+        : new ZaoWuError({
+            code: 'INTERNAL_ERROR',
+            message: 'Unexpected internal error.',
+            why: 'ZaoWu hit an error that is not yet handled as a user-facing case.',
+            fix: 'Report this issue at https://github.com/zaowu-labs/zaowu/issues with the command you ran.',
+        });
+    return createResult(zaowuError.exitCode, '', json ? zaowuError.formatJSON() : zaowuError.formatHuman());
+};
+const createHelpResult = (help, json, details = {}) => createResult(0, json ? JSON.stringify({ schemaVersion: 1, status: 'ok', ...details, help }) : help);
+export const executeCli = async (args, options = {}) => {
+    const parsed = parseArgs(args);
+    const json = hasFlag(parsed, '--json');
+    const wantsHelp = hasFlag(parsed, '--help');
+    const wantsVersion = hasFlag(parsed, '--version');
+    const commandArgs = parsed.positionals;
+    const command = commandArgs[0];
+    const domain = command ? findDomain(command) : undefined;
+    const cwd = options.cwd ?? process.cwd();
+    const commandRunner = options.commandRunner ?? runSystemCommand;
+    try {
+        if (wantsVersion || command === 'version') {
+            return createResult(0, json
+                ? JSON.stringify({ schemaVersion: 1, status: 'ok', version: ZAOWU_CLI_VERSION })
+                : ZAOWU_CLI_VERSION);
+        }
+        if (!command || command === 'help') {
+            return createHelpResult(formatHelp(), json);
+        }
+        if (wantsHelp) {
+            if (command === 'init') {
+                return createHelpResult(formatInitHelp(), json);
+            }
+            if (command === 'doctor') {
+                return createHelpResult(formatDoctorHelp(), json);
+            }
+            if (domain) {
+                const action = commandArgs[1];
+                if (action) {
+                    const domainCommand = findDomainCommand(domain, action);
+                    if (!domainCommand) {
+                        throw new ZaoWuError({
+                            code: 'UNKNOWN_DOMAIN_ACTION',
+                            message: `Unknown command: zw ${domain.name} ${action}.`,
+                            why: `ZaoWu has the \`${domain.name}\` domain, but it does not have an action named \`${action}\`.`,
+                            fix: `Run \`zw ${domain.name} --help\` to see commands for this domain.`,
+                        });
+                    }
+                    return createHelpResult(formatActionHelp(domain, action), json, {
+                        domain: domain.name,
+                        action,
+                    });
+                }
+                return createHelpResult(formatDomainHelp(domain), json, { domain });
+            }
+        }
+        assertNoMissingOptionValues(parsed.missingValues);
+        assertSupportedOptions(parsed, commandArgs);
+        assertValidOptionValues(parsed, commandArgs);
+        if (command === 'doctor') {
+            const doctor = await buildDoctorResult(options);
+            return createResult(0, json ? JSON.stringify(doctor) : formatDoctorHuman(doctor));
+        }
+        if (command === 'init') {
+            return await handleInit(args, options, json);
+        }
+        if (domain) {
+            const action = commandArgs[1];
+            if (!action) {
+                return createHelpResult(formatDomainHelp(domain), json, { domain });
+            }
+            const domainCommand = findDomainCommand(domain, action);
+            if (!domainCommand) {
+                throw new ZaoWuError({
+                    code: 'UNKNOWN_DOMAIN_ACTION',
+                    message: `Unknown command: zw ${domain.name} ${action}.`,
+                    why: `ZaoWu has the \`${domain.name}\` domain, but it does not have an action named \`${action}\`.`,
+                    fix: `Run \`zw ${domain.name} --help\` to see commands for this domain.`,
+                });
+            }
+            if (domainCommand.status === 'planned') {
+                throw new ZaoWuError({
+                    code: 'COMMAND_NOT_IMPLEMENTED',
+                    message: `Command not implemented yet: zw ${domain.name} ${domainCommand.name}.`,
+                    why: `The \`${domain.name}\` domain is scaffolded, but \`${domainCommand.name}\` ` +
+                        'is still planned and has no implementation yet.',
+                    fix: 'Create or update the related experience spec under `docs/experience/`, ' +
+                        `then implement it inside the \`packages/${domain.name}\` package.`,
+                });
+            }
+            const handler = getDomainActionHandler(domain.name, domainCommand.name);
+            if (handler) {
+                return await handler(commandArgs.slice(2), {
+                    commandRunner,
+                    cwd,
+                    dryRun: hasFlag(parsed, '--dry-run'),
+                    expectedPlanFingerprint: getValue(parsed, '--plan-fingerprint'),
+                    json,
+                    parsed,
+                    yes: hasFlag(parsed, '--yes') && !hasFlag(parsed, '--dry-run'),
+                    onChunk: options.onChunk,
+                });
+            }
+            throw new ZaoWuError({
+                code: 'COMMAND_HANDLER_MISSING',
+                message: `Command handler missing: zw ${domain.name} ${domainCommand.name}.`,
+                why: `The \`${domain.name}\` domain marks \`${domainCommand.name}\` as available, ` +
+                    'but the CLI has no handler wired for it.',
+                fix: 'Wire the command handler through `packages/cli` without moving domain logic into CLI.',
+            });
+        }
+        throw new ZaoWuError({
+            code: 'UNKNOWN_COMMAND',
+            message: `Unknown command: ${command}.`,
+            why: `ZaoWu does not have a command named \`zw ${command}\`.`,
+            fix: 'Run `zw --help` to see available commands.',
+        });
+    }
+    catch (error) {
+        return handleError(error, json);
+    }
+};
+export const runCli = async (args) => {
+    const result = await executeCli(args, {
+        onChunk: (chunk) => {
+            process.stdout.write(chunk);
+        },
+    });
+    if (result.stdout) {
+        process.stdout.write(`${result.stdout}\n`);
+    }
+    if (result.stderr) {
+        process.stderr.write(`${result.stderr}\n`);
+    }
+    return result.exitCode;
+};
+//# sourceMappingURL=run.js.map