@zaowu-labs/cli 1.0.2 → 1.0.6

package/dist/handlers/plugin-handlers.js

@@ -1,7 +1,7 @@
 import { readFile } from 'node:fs/promises';
 import path from 'node:path';
 import { installPlugin, listPlugins, removePlugin, validatePluginSource } from '@zaowu-labs/plugin';
-import { assertOperationPlanFingerprint, createContentOperationSubjects, createOperationPlan, formatConfirmCommand, formatOperationPlan, getValue, hashOperationContent, requireTarget, result, withOperationPlan, } from '../handler-utils.js';
+import { assertOperationPlanFingerprint, createContentOperationSubjects, createOperationPlan, formatConfirmCommand, formatLabeledList, formatOperationPlan, getValue, hashOperationContent, requireTarget, result, withOperationPlan, } from '../handler-utils.js';
 const getTargetFileSubjects = async (filePath) => {
     try {
         const content = await readFile(filePath, 'utf8');
@@ -33,10 +33,11 @@ export const handlePluginList = async (_args, context) => {
 export const handlePluginInstall = async (args, context) => {
     const id = requireTarget(args, 'zw plugin install');
     const source = getValue(context.parsed, '--source');
-    const preview = await installPlugin(id, {
-        cwd: context.cwd,
-        source,
-    });
+    // One options object for both the preview and the confirmed call: the
+    // fingerprint the user confirms is computed from the preview, so the two
+    // calls must be structurally unable to drift apart.
+    const installOptions = { cwd: context.cwd, source };
+    const preview = await installPlugin(id, installOptions);
     const pluginPath = path.join(preview.pluginDir, `${preview.plugin.id}.json`);
     const previewManifestContent = `${JSON.stringify(preview.plugin, null, 2)}\n`;
     const targetFileSubjects = await getTargetFileSubjects(pluginPath);
@@ -55,11 +56,7 @@ export const handlePluginInstall = async (args, context) => {
     });
     assertOperationPlanFingerprint(context, operationPlan);
     const installed = context.yes
-        ? await installPlugin(id, {
-            cwd: context.cwd,
-            source,
-            yes: true,
-        })
+        ? await installPlugin(id, { ...installOptions, yes: true })
         : preview;
     const confirmCommand = formatConfirmCommand([
         'zw',
@@ -88,9 +85,8 @@ export const handlePluginInstall = async (args, context) => {
 };
 export const handlePluginRemove = async (args, context) => {
     const id = requireTarget(args, 'zw plugin remove');
-    const preview = await removePlugin(id, {
-        cwd: context.cwd,
-    });
+    const removeOptions = { cwd: context.cwd };
+    const preview = await removePlugin(id, removeOptions);
     const pluginPath = path.join(preview.pluginDir, `${preview.plugin.id}.json`);
     const targetFileSubjects = await getTargetFileSubjects(pluginPath);
     const operationPlan = createOperationPlan({
@@ -102,12 +98,7 @@ export const handlePluginRemove = async (args, context) => {
         notes: ['Plugin removal deletes a local manifest only when --yes is provided.'],
     });
     assertOperationPlanFingerprint(context, operationPlan);
-    const removed = context.yes
-        ? await removePlugin(id, {
-            cwd: context.cwd,
-            yes: true,
-        })
-        : preview;
+    const removed = context.yes ? await removePlugin(id, { ...removeOptions, yes: true }) : preview;
     const human = [
         'ZaoWu Plugin Remove',
         '',
@@ -121,7 +112,15 @@ export const handlePluginRemove = async (args, context) => {
             : [
                 '',
                 'To execute this plugin removal plan, run:',
-                `  zw plugin remove ${id} --yes --plan-fingerprint ${operationPlan.fingerprint}`,
+                `  ${formatConfirmCommand([
+                    'zw',
+                    'plugin',
+                    'remove',
+                    id,
+                    '--yes',
+                    '--plan-fingerprint',
+                    operationPlan.fingerprint,
+                ])}`,
             ]),
     ].join('\n');
     return result(context, withOperationPlan(removed, operationPlan), human);
@@ -136,13 +135,9 @@ export const handlePluginValidate = async (args, context) => {
         `Target: ${validation.target}`,
         `Manifest: ${validation.manifestPath ?? 'none'}`,
         '',
-        validation.errors.length > 0
-            ? ['Errors:', ...validation.errors.map((error) => `- ${error}`)].join('\n')
-            : 'Errors: none',
+        formatLabeledList('Errors', validation.errors),
         '',
-        validation.warnings.length > 0
-            ? ['Warnings:', ...validation.warnings.map((warning) => `- ${warning}`)].join('\n')
-            : 'Warnings: none',
+        formatLabeledList('Warnings', validation.warnings),
     ].join('\n');
     return result(context, validation, human);
 };

package/dist/handlers/plugin-handlers.js.map

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

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

@@ -1 +1 @@
-{"version":3,"file":"help-text.d.ts","sourceRoot":"","sources":["../src/help-text.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAqb9D,CAAC"}
+{"version":3,"file":"help-text.d.ts","sourceRoot":"","sources":["../src/help-text.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAsb9D,CAAC"}

package/dist/help-text.js

@@ -10,7 +10,7 @@ Description:
 
 Options:
   --file <path>      Include a readable text file as input
-  --provider <id>    Provider id, defaults to echo
+  --provider <id>    Override project/global preferences; defaults to Echo demo
   --model <name>     Provider model hint
   --dry-run          Force preview mode
   --yes              Confirm a network provider request
@@ -56,7 +56,8 @@ Usage:
   zw auto run <workflow.json|workflow.yml|workflow.yaml> [--yes] [options]
 
 Description:
-  Preview a workflow by default. Confirmed runs execute supported message steps only.
+  Preview a workflow by default. Confirmed runs support messages and bounded file creation.
+  Shell steps remain blocked.
 
 Options:
   --dry-run          Force preview mode

package/dist/help-text.js.map

@@ -1 +1 @@
-{"version":3,"file":"help-text.js","sourceRoot":"","sources":["../src/help-text.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,WAAW,GAA2C;IACjE,EAAE,EAAE;QACF,GAAG,EAAE;;;;;;;;;;;;;;;;kDAgByC;QAC9C,SAAS,EAAE;;;;;;;;;;kDAUmC;KAC/C;IACD,IAAI,EAAE;QACJ,QAAQ,EAAE;;;;;;;;;kDASoC;QAC9C,IAAI,EAAE;;;;;;;;;kDASwC;QAC9C,GAAG,EAAE;;;;;;;;;;;;;kDAayC;KAC/C;IACD,MAAM,EAAE;QACN,IAAI,EAAE;;;;;;;;;kDASwC;QAC9C,IAAI,EAAE;;;;;;;;;kDASwC;QAC9C,QAAQ,EAAE;;;;;;;;;kDASoC;QAC9C,GAAG,EAAE;;;;;;;;;kDASyC;QAC9C,GAAG,EAAE;;;;;;;;;;;;;;kDAcyC;QAC9C,OAAO,EAAE;;;;;;;;;;;;;kDAaqC;KAC/C;IACD,IAAI,EAAE;QACJ,OAAO,EAAE;;;;;;;;;;kDAUqC;QAC9C,OAAO,EAAE;;;;;;;;;;kDAUqC;QAC9C,KAAK,EAAE;;;;;;;;;;;;;;;kDAeuC;QAC9C,MAAM,EAAE;;;;;;;;;;kDAUsC;QAC9C,MAAM,EAAE;;;;;;;;;;;kDAWsC;QAC9C,MAAM,EAAE;;;;;;;;;kDASsC;KAC/C;IACD,GAAG,EAAE;QACH,MAAM,EAAE;;;;;;;;;kDASsC;QAC9C,MAAM,EAAE;;;;;;;;;;;;;;;;;;kDAkBsC;QAC9C,MAAM,EAAE;;;;;;;;;;;;;;;;kDAgBsC;QAC9C,IAAI,EAAE;;;;;;;;;;;;;;kDAcwC;KAC/C;IACD,GAAG,EAAE;QACH,OAAO,EAAE;;;;;;;;;kDASqC;QAC9C,OAAO,EAAE;;;;;;;;;kDASqC;QAC9C,OAAO,EAAE;;;;;;;;;;;;;;;kDAeqC;QAC9C,OAAO,EAAE;;;;;;;;;kDASqC;QAC9C,MAAM,EAAE;;;;;;;;;kDASsC;KAC/C;IACD,MAAM,EAAE;QACN,IAAI,EAAE;;;;;;;;;kDASwC;QAC9C,OAAO,EAAE;;;;;;;;;;;;;;kDAcqC;QAC9C,MAAM,EAAE;;;;;;;;;;;;;kDAasC;QAC9C,QAAQ,EAAE;;;;;;;;;kDASoC;KAC/C;IACD,KAAK,EAAE;QACL,IAAI,EAAE;;;;;;;;;kDASwC;QAC9C,IAAI,EAAE;;;;;;;;;;;kDAWwC;KAC/C;IACD,GAAG,EAAE;QACH,OAAO,EAAE;;;;;;;;;;;;;kDAaqC;QAC9C,KAAK,EAAE;;;;;;;;;;;;;kDAauC;KAC/C;CACF,CAAC"}
+{"version":3,"file":"help-text.js","sourceRoot":"","sources":["../src/help-text.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,WAAW,GAA2C;IACjE,EAAE,EAAE;QACF,GAAG,EAAE;;;;;;;;;;;;;;;;kDAgByC;QAC9C,SAAS,EAAE;;;;;;;;;;kDAUmC;KAC/C;IACD,IAAI,EAAE;QACJ,QAAQ,EAAE;;;;;;;;;kDASoC;QAC9C,IAAI,EAAE;;;;;;;;;kDASwC;QAC9C,GAAG,EAAE;;;;;;;;;;;;;;kDAcyC;KAC/C;IACD,MAAM,EAAE;QACN,IAAI,EAAE;;;;;;;;;kDASwC;QAC9C,IAAI,EAAE;;;;;;;;;kDASwC;QAC9C,QAAQ,EAAE;;;;;;;;;kDASoC;QAC9C,GAAG,EAAE;;;;;;;;;kDASyC;QAC9C,GAAG,EAAE;;;;;;;;;;;;;;kDAcyC;QAC9C,OAAO,EAAE;;;;;;;;;;;;;kDAaqC;KAC/C;IACD,IAAI,EAAE;QACJ,OAAO,EAAE;;;;;;;;;;kDAUqC;QAC9C,OAAO,EAAE;;;;;;;;;;kDAUqC;QAC9C,KAAK,EAAE;;;;;;;;;;;;;;;kDAeuC;QAC9C,MAAM,EAAE;;;;;;;;;;kDAUsC;QAC9C,MAAM,EAAE;;;;;;;;;;;kDAWsC;QAC9C,MAAM,EAAE;;;;;;;;;kDASsC;KAC/C;IACD,GAAG,EAAE;QACH,MAAM,EAAE;;;;;;;;;kDASsC;QAC9C,MAAM,EAAE;;;;;;;;;;;;;;;;;;kDAkBsC;QAC9C,MAAM,EAAE;;;;;;;;;;;;;;;;kDAgBsC;QAC9C,IAAI,EAAE;;;;;;;;;;;;;;kDAcwC;KAC/C;IACD,GAAG,EAAE;QACH,OAAO,EAAE;;;;;;;;;kDASqC;QAC9C,OAAO,EAAE;;;;;;;;;kDASqC;QAC9C,OAAO,EAAE;;;;;;;;;;;;;;;kDAeqC;QAC9C,OAAO,EAAE;;;;;;;;;kDASqC;QAC9C,MAAM,EAAE;;;;;;;;;kDASsC;KAC/C;IACD,MAAM,EAAE;QACN,IAAI,EAAE;;;;;;;;;kDASwC;QAC9C,OAAO,EAAE;;;;;;;;;;;;;;kDAcqC;QAC9C,MAAM,EAAE;;;;;;;;;;;;;kDAasC;QAC9C,QAAQ,EAAE;;;;;;;;;kDASoC;KAC/C;IACD,KAAK,EAAE;QACL,IAAI,EAAE;;;;;;;;;kDASwC;QAC9C,IAAI,EAAE;;;;;;;;;;;kDAWwC;KAC/C;IACD,GAAG,EAAE;QACH,OAAO,EAAE;;;;;;;;;;;;;kDAaqC;QAC9C,KAAK,EAAE;;;;;;;;;;;;;kDAauC;KAC/C;CACF,CAAC"}

package/dist/input-validation.d.ts

@@ -0,0 +1,6 @@
+import type { ParsedArgs } from './args.js';
+/** Maximum target count; null means free-form text. Minimums stay domain-owned. */
+export declare const COMMAND_TARGET_LIMITS: Readonly<Record<string, number | null>>;
+export declare const assertBooleanFlags: (parsed: ParsedArgs) => void;
+export declare const assertTargetCount: (commandArgs: readonly string[]) => void;
+//# sourceMappingURL=input-validation.d.ts.map

package/dist/input-validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"input-validation.d.ts","sourceRoot":"","sources":["../src/input-validation.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAE5C,mFAAmF;AACnF,eAAO,MAAM,qBAAqB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,CAqCzE,CAAC;AAEF,eAAO,MAAM,kBAAkB,GAAI,QAAQ,UAAU,KAAG,IAUvD,CAAC;AAEF,eAAO,MAAM,iBAAiB,GAAI,aAAa,SAAS,MAAM,EAAE,KAAG,IAelE,CAAC"}

package/dist/input-validation.js

@@ -0,0 +1,68 @@
+import { ZaoWuError } from '@zaowu-labs/core';
+/** Maximum target count; null means free-form text. Minimums stay domain-owned. */
+export const COMMAND_TARGET_LIMITS = {
+    init: 0,
+    doctor: 0,
+    'ai:ask': null,
+    'ai:providers': 0,
+    'auto:plan': 1,
+    'auto:run': 1,
+    'auto:validate': 1,
+    'config:get': 1,
+    'config:migrate': 0,
+    'config:path': 0,
+    'config:set': 2,
+    'config:show': 0,
+    'config:validate': 0,
+    'data:analyze': 1,
+    'data:clean': 1,
+    'data:inspect': 1,
+    'data:sample': 1,
+    'data:schema': 1,
+    'data:sheets': 1,
+    'dev:commit': 0,
+    'dev:review': 0,
+    'dev:status': 0,
+    'dev:sync': 0,
+    'doc:convert': 1,
+    'doc:extract': 1,
+    'doc:outline': 1,
+    'doc:search': 2,
+    'doc:summary': 1,
+    'plugin:install': 1,
+    'plugin:list': 0,
+    'plugin:remove': 1,
+    'plugin:validate': 1,
+    'teach:plan': null,
+    'teach:quiz': null,
+    'web:fetch': 1,
+    'web:inspect': 1,
+};
+export const assertBooleanFlags = (parsed) => {
+    const option = parsed.assignedBooleans[0];
+    if (!option)
+        return;
+    throw new ZaoWuError({
+        code: 'OPTION_VALUE_INVALID',
+        message: 'Boolean flags do not accept a value.',
+        why: `The option ${option} is a flag; an assigned value cannot enable or disable it.`,
+        fix: `Use ${option} without =value to enable it, or omit the flag. Use --dry-run to preview a sensitive action.`,
+    });
+};
+export const assertTargetCount = (commandArgs) => {
+    const [command, action] = commandArgs;
+    const isRoot = command === 'init' || command === 'doctor';
+    const key = isRoot ? command : `${command}:${action}`;
+    const maximum = COMMAND_TARGET_LIMITS[key];
+    const count = commandArgs.length - (isRoot ? 1 : 2);
+    if (maximum === undefined || maximum === null || count <= maximum)
+        return;
+    const label = isRoot ? `zw ${command}` : `zw ${command} ${action}`;
+    throw new ZaoWuError({
+        code: 'ARGUMENT_UNEXPECTED',
+        message: 'Unexpected positional argument.',
+        why: `\`${label}\` accepts at most ${maximum} target argument(s), but received ${count}.`,
+        fix: `Run \`${label} --help\` to check the expected targets and options. Quote text that belongs to one target.`,
+    });
+};
+//# sourceMappingURL=input-validation.js.map

package/dist/input-validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"input-validation.js","sourceRoot":"","sources":["../src/input-validation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAG9C,mFAAmF;AACnF,MAAM,CAAC,MAAM,qBAAqB,GAA4C;IAC5E,IAAI,EAAE,CAAC;IACP,MAAM,EAAE,CAAC;IACT,QAAQ,EAAE,IAAI;IACd,cAAc,EAAE,CAAC;IACjB,WAAW,EAAE,CAAC;IACd,UAAU,EAAE,CAAC;IACb,eAAe,EAAE,CAAC;IAClB,YAAY,EAAE,CAAC;IACf,gBAAgB,EAAE,CAAC;IACnB,aAAa,EAAE,CAAC;IAChB,YAAY,EAAE,CAAC;IACf,aAAa,EAAE,CAAC;IAChB,iBAAiB,EAAE,CAAC;IACpB,cAAc,EAAE,CAAC;IACjB,YAAY,EAAE,CAAC;IACf,cAAc,EAAE,CAAC;IACjB,aAAa,EAAE,CAAC;IAChB,aAAa,EAAE,CAAC;IAChB,aAAa,EAAE,CAAC;IAChB,YAAY,EAAE,CAAC;IACf,YAAY,EAAE,CAAC;IACf,YAAY,EAAE,CAAC;IACf,UAAU,EAAE,CAAC;IACb,aAAa,EAAE,CAAC;IAChB,aAAa,EAAE,CAAC;IAChB,aAAa,EAAE,CAAC;IAChB,YAAY,EAAE,CAAC;IACf,aAAa,EAAE,CAAC;IAChB,gBAAgB,EAAE,CAAC;IACnB,aAAa,EAAE,CAAC;IAChB,eAAe,EAAE,CAAC;IAClB,iBAAiB,EAAE,CAAC;IACpB,YAAY,EAAE,IAAI;IAClB,YAAY,EAAE,IAAI;IAClB,WAAW,EAAE,CAAC;IACd,aAAa,EAAE,CAAC;CACjB,CAAC;AAEF,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,MAAkB,EAAQ,EAAE;IAC7D,MAAM,MAAM,GAAG,MAAM,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC;IAC1C,IAAI,CAAC,MAAM;QAAE,OAAO;IAEpB,MAAM,IAAI,UAAU,CAAC;QACnB,IAAI,EAAE,sBAAsB;QAC5B,OAAO,EAAE,sCAAsC;QAC/C,GAAG,EAAE,cAAc,MAAM,4DAA4D;QACrF,GAAG,EAAE,OAAO,MAAM,8FAA8F;KACjH,CAAC,CAAC;AACL,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,WAA8B,EAAQ,EAAE;IACxE,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,GAAG,WAAW,CAAC;IACtC,MAAM,MAAM,GAAG,OAAO,KAAK,MAAM,IAAI,OAAO,KAAK,QAAQ,CAAC;IAC1D,MAAM,GAAG,GAAG,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,IAAI,MAAM,EAAE,CAAC;IACtD,MAAM,OAAO,GAAG,qBAAqB,CAAC,GAAG,CAAC,CAAC;IAC3C,MAAM,KAAK,GAAG,WAAW,CAAC,MAAM,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACpD,IAAI,OAAO,KAAK,SAAS,IAAI,OAAO,KAAK,IAAI,IAAI,KAAK,IAAI,OAAO;QAAE,OAAO;IAE1E,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,MAAM,OAAO,EAAE,CAAC,CAAC,CAAC,MAAM,OAAO,IAAI,MAAM,EAAE,CAAC;IACnE,MAAM,IAAI,UAAU,CAAC;QACnB,IAAI,EAAE,qBAAqB;QAC3B,OAAO,EAAE,iCAAiC;QAC1C,GAAG,EAAE,KAAK,KAAK,sBAAsB,OAAO,qCAAqC,KAAK,GAAG;QACzF,GAAG,EAAE,SAAS,KAAK,6FAA6F;KACjH,CAAC,CAAC;AACL,CAAC,CAAC"}

package/dist/option-registry.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Single source of truth for CLI options.
+ *
+ * Every option is declared exactly once as either value-taking or boolean.
+ * `args.ts` derives its parser behavior from VALUE_OPTIONS, and
+ * `option-validation.ts` builds per-command allowlists from COMMAND_OPTIONS,
+ * so a new option cannot end up value-taking in one layer and boolean in the
+ * other. A contract test asserts the registry stays internally consistent.
+ */
+/** Options that must be followed by a value (`--option value` or `--option=value`). */
+export declare const VALUE_OPTIONS: readonly ["--count", "--file", "--format", "--model", "--output", "--plan-fingerprint", "--provider", "--rows", "--sheet", "--source"];
+/** Options that are plain flags and never consume a following value. */
+export declare const BOOLEAN_OPTIONS: readonly ["--ai", "--discard-local", "--dry-run", "--global", "--help", "--json", "--staged", "--version", "--worktree", "--yes"];
+export declare const COMMON_OPTIONS: readonly ["--help", "--json", "--version"];
+export declare const COMMAND_OPTIONS: Readonly<Record<string, readonly string[]>>;
+//# sourceMappingURL=option-registry.d.ts.map

package/dist/option-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"option-registry.d.ts","sourceRoot":"","sources":["../src/option-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,uFAAuF;AACvF,eAAO,MAAM,aAAa,wIAWhB,CAAC;AAEX,wEAAwE;AACxE,eAAO,MAAM,eAAe,mIAWlB,CAAC;AAEX,eAAO,MAAM,cAAc,4CAA6C,CAAC;AAGzE,eAAO,MAAM,eAAe,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,CA6CvE,CAAC"}

package/dist/option-registry.js

@@ -0,0 +1,84 @@
+/**
+ * Single source of truth for CLI options.
+ *
+ * Every option is declared exactly once as either value-taking or boolean.
+ * `args.ts` derives its parser behavior from VALUE_OPTIONS, and
+ * `option-validation.ts` builds per-command allowlists from COMMAND_OPTIONS,
+ * so a new option cannot end up value-taking in one layer and boolean in the
+ * other. A contract test asserts the registry stays internally consistent.
+ */
+/** Options that must be followed by a value (`--option value` or `--option=value`). */
+export const VALUE_OPTIONS = [
+    '--count',
+    '--file',
+    '--format',
+    '--model',
+    '--output',
+    '--plan-fingerprint',
+    '--provider',
+    '--rows',
+    '--sheet',
+    '--source',
+];
+/** Options that are plain flags and never consume a following value. */
+export const BOOLEAN_OPTIONS = [
+    '--ai',
+    '--discard-local',
+    '--dry-run',
+    '--global',
+    '--help',
+    '--json',
+    '--staged',
+    '--version',
+    '--worktree',
+    '--yes',
+];
+export const COMMON_OPTIONS = ['--help', '--json', '--version'];
+const CONFIRMATION_OPTIONS = ['--dry-run', '--plan-fingerprint', '--yes'];
+export const COMMAND_OPTIONS = {
+    init: [...COMMON_OPTIONS, ...CONFIRMATION_OPTIONS],
+    doctor: COMMON_OPTIONS,
+    'ai:ask': [...COMMON_OPTIONS, ...CONFIRMATION_OPTIONS, '--file', '--model', '--provider'],
+    'ai:providers': [...COMMON_OPTIONS, '--provider'],
+    'auto:plan': COMMON_OPTIONS,
+    'auto:run': [...COMMON_OPTIONS, ...CONFIRMATION_OPTIONS],
+    'auto:validate': COMMON_OPTIONS,
+    'config:get': COMMON_OPTIONS,
+    'config:migrate': [...COMMON_OPTIONS, ...CONFIRMATION_OPTIONS],
+    'config:path': COMMON_OPTIONS,
+    'config:set': [...COMMON_OPTIONS, ...CONFIRMATION_OPTIONS, '--global'],
+    'config:show': COMMON_OPTIONS,
+    'config:validate': COMMON_OPTIONS,
+    'data:analyze': [...COMMON_OPTIONS, '--sheet'],
+    'data:clean': [...COMMON_OPTIONS, ...CONFIRMATION_OPTIONS, '--output', '--sheet'],
+    'data:inspect': [...COMMON_OPTIONS, '--sheet'],
+    'data:sample': [...COMMON_OPTIONS, '--rows', '--sheet'],
+    'data:schema': [...COMMON_OPTIONS, '--sheet'],
+    'data:sheets': COMMON_OPTIONS,
+    'dev:commit': [...COMMON_OPTIONS, ...CONFIRMATION_OPTIONS, '--ai', '--model', '--provider'],
+    'dev:review': [
+        ...COMMON_OPTIONS,
+        ...CONFIRMATION_OPTIONS,
+        '--ai',
+        '--model',
+        '--provider',
+        '--staged',
+        '--worktree',
+    ],
+    'dev:status': COMMON_OPTIONS,
+    'dev:sync': [...COMMON_OPTIONS, ...CONFIRMATION_OPTIONS, '--discard-local'],
+    'doc:convert': [...COMMON_OPTIONS, ...CONFIRMATION_OPTIONS, '--format', '--output'],
+    'doc:extract': COMMON_OPTIONS,
+    'doc:outline': COMMON_OPTIONS,
+    'doc:search': COMMON_OPTIONS,
+    'doc:summary': COMMON_OPTIONS,
+    'plugin:install': [...COMMON_OPTIONS, ...CONFIRMATION_OPTIONS, '--source'],
+    'plugin:list': COMMON_OPTIONS,
+    'plugin:remove': [...COMMON_OPTIONS, ...CONFIRMATION_OPTIONS],
+    'plugin:validate': COMMON_OPTIONS,
+    'teach:plan': COMMON_OPTIONS,
+    'teach:quiz': [...COMMON_OPTIONS, '--count', '--format'],
+    'web:fetch': [...COMMON_OPTIONS, ...CONFIRMATION_OPTIONS],
+    'web:inspect': [...COMMON_OPTIONS, ...CONFIRMATION_OPTIONS],
+};
+//# sourceMappingURL=option-registry.js.map

package/dist/option-registry.js.map

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

package/dist/option-validation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"option-validation.d.ts","sourceRoot":"","sources":["../src/option-validation.ts"],"names":[],"mappings":"AACA,OAAO,EAAY,SAAS,EAAE,KAAK,UAAU,EAAE,MAAM,WAAW,CAAC;AAoDjE,eAAO,MAAM,sBAAsB,GACjC,QAAQ,UAAU,EAClB,aAAa,SAAS,MAAM,EAAE,KAC7B,IA0BF,CAAC;AAEF,eAAO,MAAM,2BAA2B,GAAI,SAAS,SAAS,MAAM,EAAE,KAAG,IAaxE,CAAC;AAsBF,eAAO,MAAM,uBAAuB,GAClC,QAAQ,UAAU,CAAC,OAAO,SAAS,CAAC,EACpC,aAAa,SAAS,MAAM,EAAE,KAC7B,IA2CF,CAAC"}
+{"version":3,"file":"option-validation.d.ts","sourceRoot":"","sources":["../src/option-validation.ts"],"names":[],"mappings":"AACA,OAAO,EAAY,SAAS,EAAE,KAAK,UAAU,EAAE,MAAM,WAAW,CAAC;AAGjE,eAAO,MAAM,sBAAsB,GACjC,QAAQ,UAAU,EAClB,aAAa,SAAS,MAAM,EAAE,KAC7B,IAsBF,CAAC;AAEF,eAAO,MAAM,2BAA2B,GAAI,SAAS,SAAS,MAAM,EAAE,KAAG,IAaxE,CAAC;AAsBF,eAAO,MAAM,uBAAuB,GAClC,QAAQ,UAAU,CAAC,OAAO,SAAS,CAAC,EACpC,aAAa,SAAS,MAAM,EAAE,KAC7B,IA2CF,CAAC"}

package/dist/option-validation.js

@@ -1,66 +1,16 @@
 import { ZaoWuError } from '@zaowu-labs/core';
 import { getValue } from './args.js';
-const COMMON_OPTIONS = ['--help', '--json', '--version'];
-const CONFIRMATION_OPTIONS = ['--dry-run', '--plan-fingerprint', '--yes'];
-const COMMAND_OPTIONS = {
-    init: [...COMMON_OPTIONS, ...CONFIRMATION_OPTIONS],
-    doctor: COMMON_OPTIONS,
-    'ai:ask': [...COMMON_OPTIONS, ...CONFIRMATION_OPTIONS, '--file', '--model', '--provider'],
-    'ai:providers': [...COMMON_OPTIONS, '--provider'],
-    'auto:plan': COMMON_OPTIONS,
-    'auto:run': [...COMMON_OPTIONS, ...CONFIRMATION_OPTIONS],
-    'auto:validate': COMMON_OPTIONS,
-    'config:get': COMMON_OPTIONS,
-    'config:migrate': [...COMMON_OPTIONS, ...CONFIRMATION_OPTIONS],
-    'config:path': COMMON_OPTIONS,
-    'config:set': [...COMMON_OPTIONS, ...CONFIRMATION_OPTIONS, '--global'],
-    'config:show': COMMON_OPTIONS,
-    'config:validate': COMMON_OPTIONS,
-    'data:analyze': [...COMMON_OPTIONS, '--sheet'],
-    'data:clean': [...COMMON_OPTIONS, ...CONFIRMATION_OPTIONS, '--output', '--sheet'],
-    'data:inspect': [...COMMON_OPTIONS, '--sheet'],
-    'data:sample': [...COMMON_OPTIONS, '--rows', '--sheet'],
-    'data:schema': [...COMMON_OPTIONS, '--sheet'],
-    'data:sheets': COMMON_OPTIONS,
-    'dev:commit': [...COMMON_OPTIONS, ...CONFIRMATION_OPTIONS, '--ai', '--model', '--provider'],
-    'dev:review': [
-        ...COMMON_OPTIONS,
-        ...CONFIRMATION_OPTIONS,
-        '--ai',
-        '--model',
-        '--provider',
-        '--staged',
-        '--worktree',
-    ],
-    'dev:status': COMMON_OPTIONS,
-    'dev:sync': [...COMMON_OPTIONS, ...CONFIRMATION_OPTIONS, '--discard-local'],
-    'doc:convert': [...COMMON_OPTIONS, ...CONFIRMATION_OPTIONS, '--format', '--output'],
-    'doc:extract': COMMON_OPTIONS,
-    'doc:outline': COMMON_OPTIONS,
-    'doc:search': COMMON_OPTIONS,
-    'doc:summary': COMMON_OPTIONS,
-    'plugin:install': [...COMMON_OPTIONS, ...CONFIRMATION_OPTIONS, '--source'],
-    'plugin:list': COMMON_OPTIONS,
-    'plugin:remove': [...COMMON_OPTIONS, ...CONFIRMATION_OPTIONS],
-    'plugin:validate': COMMON_OPTIONS,
-    'teach:plan': COMMON_OPTIONS,
-    'teach:quiz': [...COMMON_OPTIONS, '--count', '--format'],
-    'web:fetch': [...COMMON_OPTIONS, ...CONFIRMATION_OPTIONS],
-    'web:inspect': [...COMMON_OPTIONS, ...CONFIRMATION_OPTIONS],
-};
+import { COMMAND_OPTIONS, COMMON_OPTIONS } from './option-registry.js';
 export const assertSupportedOptions = (parsed, commandArgs) => {
     const [command, action] = commandArgs;
-    if (!command) {
-        return;
-    }
     const commandKey = action ? `${command}:${action}` : command;
-    const allowed = new Set(COMMAND_OPTIONS[commandKey] ?? COMMON_OPTIONS);
+    const allowed = new Set((commandKey && COMMAND_OPTIONS[commandKey]) || COMMON_OPTIONS);
     const unsupported = [...parsed.options].filter((option) => !allowed.has(option));
     if (unsupported.length === 0) {
         return;
     }
     const optionList = unsupported.join(', ');
-    const commandName = action ? `zw ${command} ${action}` : `zw ${command}`;
+    const commandName = action ? `zw ${command} ${action}` : command ? `zw ${command}` : 'zw';
     throw new ZaoWuError({
         code: 'OPTION_UNSUPPORTED',
         message: 'Option is not supported by this command.',

package/dist/option-validation.js.map

@@ -1 +1 @@
-{"version":3,"file":"option-validation.js","sourceRoot":"","sources":["../src/option-validation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,QAAQ,EAA8B,MAAM,WAAW,CAAC;AAEjE,MAAM,cAAc,GAAG,CAAC,QAAQ,EAAE,QAAQ,EAAE,WAAW,CAAU,CAAC;AAClE,MAAM,oBAAoB,GAAG,CAAC,WAAW,EAAE,oBAAoB,EAAE,OAAO,CAAU,CAAC;AAEnF,MAAM,eAAe,GAAgD;IACnE,IAAI,EAAE,CAAC,GAAG,cAAc,EAAE,GAAG,oBAAoB,CAAC;IAClD,MAAM,EAAE,cAAc;IACtB,QAAQ,EAAE,CAAC,GAAG,cAAc,EAAE,GAAG,oBAAoB,EAAE,QAAQ,EAAE,SAAS,EAAE,YAAY,CAAC;IACzF,cAAc,EAAE,CAAC,GAAG,cAAc,EAAE,YAAY,CAAC;IACjD,WAAW,EAAE,cAAc;IAC3B,UAAU,EAAE,CAAC,GAAG,cAAc,EAAE,GAAG,oBAAoB,CAAC;IACxD,eAAe,EAAE,cAAc;IAC/B,YAAY,EAAE,cAAc;IAC5B,gBAAgB,EAAE,CAAC,GAAG,cAAc,EAAE,GAAG,oBAAoB,CAAC;IAC9D,aAAa,EAAE,cAAc;IAC7B,YAAY,EAAE,CAAC,GAAG,cAAc,EAAE,GAAG,oBAAoB,EAAE,UAAU,CAAC;IACtE,aAAa,EAAE,cAAc;IAC7B,iBAAiB,EAAE,cAAc;IACjC,cAAc,EAAE,CAAC,GAAG,cAAc,EAAE,SAAS,CAAC;IAC9C,YAAY,EAAE,CAAC,GAAG,cAAc,EAAE,GAAG,oBAAoB,EAAE,UAAU,EAAE,SAAS,CAAC;IACjF,cAAc,EAAE,CAAC,GAAG,cAAc,EAAE,SAAS,CAAC;IAC9C,aAAa,EAAE,CAAC,GAAG,cAAc,EAAE,QAAQ,EAAE,SAAS,CAAC;IACvD,aAAa,EAAE,CAAC,GAAG,cAAc,EAAE,SAAS,CAAC;IAC7C,aAAa,EAAE,cAAc;IAC7B,YAAY,EAAE,CAAC,GAAG,cAAc,EAAE,GAAG,oBAAoB,EAAE,MAAM,EAAE,SAAS,EAAE,YAAY,CAAC;IAC3F,YAAY,EAAE;QACZ,GAAG,cAAc;QACjB,GAAG,oBAAoB;QACvB,MAAM;QACN,SAAS;QACT,YAAY;QACZ,UAAU;QACV,YAAY;KACb;IACD,YAAY,EAAE,cAAc;IAC5B,UAAU,EAAE,CAAC,GAAG,cAAc,EAAE,GAAG,oBAAoB,EAAE,iBAAiB,CAAC;IAC3E,aAAa,EAAE,CAAC,GAAG,cAAc,EAAE,GAAG,oBAAoB,EAAE,UAAU,EAAE,UAAU,CAAC;IACnF,aAAa,EAAE,cAAc;IAC7B,aAAa,EAAE,cAAc;IAC7B,YAAY,EAAE,cAAc;IAC5B,aAAa,EAAE,cAAc;IAC7B,gBAAgB,EAAE,CAAC,GAAG,cAAc,EAAE,GAAG,oBAAoB,EAAE,UAAU,CAAC;IAC1E,aAAa,EAAE,cAAc;IAC7B,eAAe,EAAE,CAAC,GAAG,cAAc,EAAE,GAAG,oBAAoB,CAAC;IAC7D,iBAAiB,EAAE,cAAc;IACjC,YAAY,EAAE,cAAc;IAC5B,YAAY,EAAE,CAAC,GAAG,cAAc,EAAE,SAAS,EAAE,UAAU,CAAC;IACxD,WAAW,EAAE,CAAC,GAAG,cAAc,EAAE,GAAG,oBAAoB,CAAC;IACzD,aAAa,EAAE,CAAC,GAAG,cAAc,EAAE,GAAG,oBAAoB,CAAC;CAC5D,CAAC;AAEF,MAAM,CAAC,MAAM,sBAAsB,GAAG,CACpC,MAAkB,EAClB,WAA8B,EACxB,EAAE;IACR,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,GAAG,WAAW,CAAC;IAEtC,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO;IACT,CAAC;IAED,MAAM,UAAU,GAAG,MAAM,CAAC,CAAC,CAAC,GAAG,OAAO,IAAI,MAAM,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;IAC7D,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,eAAe,CAAC,UAAU,CAAC,IAAI,cAAc,CAAC,CAAC;IACvE,MAAM,WAAW,GAAG,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;IAEjF,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC7B,OAAO;IACT,CAAC;IAED,MAAM,UAAU,GAAG,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1C,MAAM,WAAW,GAAG,MAAM,CAAC,CAAC,CAAC,MAAM,OAAO,IAAI,MAAM,EAAE,CAAC,CAAC,CAAC,MAAM,OAAO,EAAE,CAAC;IAEzE,MAAM,IAAI,UAAU,CAAC;QACnB,IAAI,EAAE,oBAAoB;QAC1B,OAAO,EAAE,0CAA0C;QACnD,GAAG,EACD,aAAa,WAAW,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,IAAI,UAAU,GAAG;YACjE,yBAAyB,WAAW,KAAK;QAC3C,GAAG,EAAE,SAAS,WAAW,yCAAyC;KACnE,CAAC,CAAC;AACL,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,OAA0B,EAAQ,EAAE;IAC9E,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO;IACT,CAAC;IAED,MAAM,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAEtC,MAAM,IAAI,UAAU,CAAC;QACnB,IAAI,EAAE,uBAAuB;QAC7B,OAAO,EAAE,2BAA2B;QACpC,GAAG,EAAE,aAAa,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,IAAI,UAAU,+BAA+B;QAC9F,GAAG,EAAE,kCAAkC,OAAO,CAAC,CAAC,CAAC,iCAAiC;KACnF,CAAC,CAAC;AACL,CAAC,CAAC;AAEF,MAAM,iBAAiB,GAAG,CACxB,MAAc,EACd,KAAyB,EACzB,OAAmC,EACnC,QAAgB,EACV,EAAE;IACR,IAAI,KAAK,KAAK,SAAS,IAAI,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1C,OAAO;IACT,CAAC;IAED,MAAM,IAAI,UAAU,CAAC;QACnB,IAAI,EAAE,sBAAsB;QAC5B,OAAO,EAAE,0BAA0B;QACnC,GAAG,EAAE,cAAc,MAAM,eAAe,KAAK,oBAAoB,QAAQ,GAAG;QAC5E,GAAG,EAAE,OAAO,MAAM,SAAS,QAAQ,yBAAyB;KAC7D,CAAC,CAAC;AACL,CAAC,CAAC;AAEF,MAAM,qBAAqB,GAAG,CAAC,KAAa,EAAW,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAEnF,MAAM,CAAC,MAAM,uBAAuB,GAAG,CACrC,MAAoC,EACpC,WAA8B,EACxB,EAAE;IACR,iBAAiB,CACf,oBAAoB,EACpB,QAAQ,CAAC,MAAM,EAAE,oBAAoB,CAAC,EACtC,CAAC,KAAK,EAAE,EAAE,CAAC,iBAAiB,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,EAC/C,wCAAwC,CACzC,CAAC;IAEF,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAC5C,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,WAAW,CAAC;IAErC,IAAI,MAAM,KAAK,MAAM,IAAI,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC7C,iBAAiB,CACf,QAAQ,EACR,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,EAC1B,qBAAqB,EACrB,oBAAoB,CACrB,CAAC;IACJ,CAAC;IAED,IAAI,MAAM,KAAK,KAAK,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QAC7C,iBAAiB,CACf,UAAU,EACV,MAAM,EACN,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,KAAK,UAAU,IAAI,KAAK,KAAK,MAAM,EACnD,sBAAsB,CACvB,CAAC;IACJ,CAAC;IAED,IAAI,MAAM,KAAK,OAAO,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;QAC5C,iBAAiB,CACf,SAAS,EACT,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC,EAC3B,CAAC,KAAK,EAAE,EAAE,CAAC,qBAAqB,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,EAC9D,iCAAiC,CAClC,CAAC;QACF,iBAAiB,CACf,UAAU,EACV,MAAM,EACN,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,KAAK,MAAM,IAAI,KAAK,KAAK,YAAY,EACrD,wBAAwB,CACzB,CAAC;IACJ,CAAC;AACH,CAAC,CAAC"}
+{"version":3,"file":"option-validation.js","sourceRoot":"","sources":["../src/option-validation.ts"],"names":[],"mappings":"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"}

package/dist/root-doctor.d.ts

@@ -8,6 +8,7 @@ interface DoctorCheck {
     version?: string;
     details?: string;
     fix?: string;
+    required?: boolean;
 }
 export interface DoctorResult {
     schemaVersion: 1;

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

@@ -1 +1 @@
-{"version":3,"file":"root-doctor.d.ts","sourceRoot":"","sources":["../src/root-doctor.ts"],"names":[],"mappings":"AAGA,OAAO,EAAqC,KAAK,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAGzF,OAAO,KAAK,EAAE,mBAAmB,EAAiB,MAAM,YAAY,CAAC;AAErE,KAAK,WAAW,GAAG,IAAI,GAAG,SAAS,GAAG,SAAS,CAAC;AAChD,KAAK,aAAa,GAAG,IAAI,GAAG,SAAS,CAAC;AAEtC,UAAU,WAAW;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,WAAW,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,YAAY;IAC3B,aAAa,EAAE,CAAC,CAAC;IACjB,MAAM,EAAE,aAAa,CAAC;IACtB,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,aAAa,EAAE,aAAa,CAAC;CAC9B;AA4ND,eAAO,MAAM,iBAAiB,GAC5B,UAAS,mBAAwB,KAChC,OAAO,CAAC,YAAY,CAoDtB,CAAC;AAEF,eAAO,MAAM,iBAAiB,GAAI,QAAQ,YAAY,KAAG,MAwBxD,CAAC"}
+{"version":3,"file":"root-doctor.d.ts","sourceRoot":"","sources":["../src/root-doctor.ts"],"names":[],"mappings":"AAQA,OAAO,EAAqC,KAAK,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAGzF,OAAO,KAAK,EAAE,mBAAmB,EAAiB,MAAM,YAAY,CAAC;AAErE,KAAK,WAAW,GAAG,IAAI,GAAG,SAAS,GAAG,SAAS,CAAC;AAChD,KAAK,aAAa,GAAG,IAAI,GAAG,SAAS,CAAC;AAEtC,UAAU,WAAW;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,WAAW,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,YAAY;IAC3B,aAAa,EAAE,CAAC,CAAC;IACjB,MAAM,EAAE,aAAa,CAAC;IACtB,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,aAAa,EAAE,aAAa,CAAC;CAC9B;AA0OD,eAAO,MAAM,iBAAiB,GAC5B,UAAS,mBAAwB,KAChC,OAAO,CAAC,YAAY,CAkEtB,CAAC;AAEF,eAAO,MAAM,iBAAiB,GAAI,QAAQ,YAAY,KAAG,MAwBxD,CAAC"}

package/dist/root-doctor.js

@@ -1,16 +1,27 @@
 import path from 'node:path';
 import { validateAIProviderConfig } from '@zaowu-labs/ai';
-import { findConfigFile, loadResolvedConfig } from '@zaowu-labs/config';
+import { findConfigFile, loadOptionalResolvedConfig, loadResolvedConfig, } from '@zaowu-labs/config';
 import { createOperationPlan, isZaoWuError } from '@zaowu-labs/core';
-import { COMMAND_CONTRACTS } from './command-contracts.js';
+import { ADDITIONAL_ROOT_SURFACES, 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 diagnosticOptions = (command) => ({
+    timeout: 5_000,
+    ...(command === 'corepack' || command === 'pnpm'
+        ? {
+            env: {
+                COREPACK_ENABLE_NETWORK: '0',
+                COREPACK_ENABLE_DOWNLOAD_PROMPT: '0',
+                COREPACK_ENABLE_AUTO_PIN: '0',
+            },
+        }
+        : {}),
+});
 const satisfiesMinimumVersion = (version, minimum) => {
     const parse = (value) => value
         .replace(/^v/, '')
@@ -41,7 +52,7 @@ const satisfiesPnpmVersion = (version) => Boolean(version &&
     getMajorVersion(version) < MAXIMUM_PNPM_MAJOR);
 const checkCommand = (name, command, args, fix, commandRunner, details) => {
     try {
-        const output = commandRunner(command, args);
+        const output = commandRunner(command, args, diagnosticOptions(command));
         return {
             name,
             status: 'ok',
@@ -59,7 +70,7 @@ const checkCommand = (name, command, args, fix, commandRunner, details) => {
 };
 const checkPnpmCommand = (command, args, commandRunner, details) => {
     try {
-        const output = commandRunner(command, args);
+        const output = commandRunner(command, args, diagnosticOptions(command));
         const version = extractVersion(output);
         const isSupported = satisfiesPnpmVersion(version);
         return {
@@ -130,7 +141,7 @@ const getConfigCheck = async (cwd) => {
         };
     }
 };
-const checkAIProvider = (resolvedConfig, checkedInvalidConfig) => {
+const checkAIProvider = async (resolvedConfig, checkedInvalidConfig, cwd) => {
     if (!resolvedConfig && checkedInvalidConfig) {
         return {
             name: 'AI provider',
@@ -140,7 +151,8 @@ const checkAIProvider = (resolvedConfig, checkedInvalidConfig) => {
         };
     }
     try {
-        const validation = validateAIProviderConfig(resolvedConfig?.config.ai.provider);
+        const effectiveConfig = resolvedConfig ?? (await loadOptionalResolvedConfig(cwd));
+        const validation = validateAIProviderConfig(effectiveConfig?.config.ai.provider);
         const provider = validation.provider;
         const location = provider.network ? 'network' : 'local';
         const configStatus = provider.configured ? 'configured' : 'missing config';
@@ -165,7 +177,7 @@ const checkAIProvider = (resolvedConfig, checkedInvalidConfig) => {
 const checkCommandMatrix = () => ({
     name: 'Command matrix',
     status: 'ok',
-    details: `${COMMAND_CONTRACTS.length + ADDITIONAL_ROOT_SURFACES_IN_CAPABILITY_MATRIX} command surface(s) tracked`,
+    details: `${COMMAND_CONTRACTS.length + ADDITIONAL_ROOT_SURFACES.length} command surface(s) tracked`,
 });
 export const buildDoctorResult = async (options = {}) => {
     const cwd = options.cwd ?? process.cwd();
@@ -181,17 +193,26 @@ export const buildDoctorResult = async (options = {}) => {
             : `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 pnpm = checkPnpm(commandRunner);
+    checks.push({
+        ...pnpm,
+        required: false,
+        details: [pnpm.details, 'optional for CLI use; required for repository development']
+            .filter(Boolean)
+            .join('; '),
+    });
     const config = await getConfigCheck(cwd);
     checks.push(config.check);
-    checks.push(checkAIProvider(config.resolvedConfig, config.checkedInvalidConfig ?? false));
+    checks.push(await checkAIProvider(config.resolvedConfig, config.checkedInvalidConfig ?? false, cwd));
     checks.push(checkCommandMatrix());
     const nextSteps = checks
-        .filter((check) => check.status !== 'ok' && check.fix)
+        .filter((check) => check.required !== false && check.status !== 'ok' && check.fix)
         .map((check) => check.fix);
     return {
         schemaVersion: 1,
-        status: checks.some((check) => check.status !== 'ok') ? 'warning' : 'ok',
+        status: checks.some((check) => check.required !== false && check.status !== 'ok')
+            ? 'warning'
+            : 'ok',
         checks,
         nextSteps,
         operationPlan: createOperationPlan({
@@ -203,7 +224,10 @@ export const buildDoctorResult = async (options = {}) => {
                 'command contract registry',
             ],
             executes: ['git --version', 'pnpm --version', 'corepack pnpm --version'],
-            notes: ['Doctor runs fixed local diagnostics and does not write files.'],
+            notes: [
+                'Doctor runs fixed local diagnostics and does not write files.',
+                'Each diagnostic has a five-second timeout; Corepack network access, download prompts, and auto-pinning are disabled.',
+            ],
         }),
     };
 };