@actiondock/cli 2.0.12 → 2.2.1

package/dist/commands/config/delete.js

@@ -0,0 +1,52 @@
+import { loadProjectConfig, resolvePackageRoot, } from "@actiondock/core";
+import { ArgumentError } from "../../errors.js";
+import { writeStdout } from "../../renderer.js";
+import { getEffectiveOptions, withTarget } from "../../utils/index.js";
+/**
+ * 注册 config delete 子命令：删除配置项。
+ *
+ * @param configCmd config 命令实例
+ * @param context 命令行上下文
+ */
+export function registerConfigDeleteCommand(configCmd, context) {
+    configCmd
+        .command("delete <key>")
+        .alias("rm")
+        .description("Delete configuration entry")
+        .option("-P, --package <id>", "Target package ID or path")
+        .option("-g, --global", "Delete from global configuration")
+        .option("-p, --profile <name>", "Delete on a remote target")
+        .option("-s, --server <url>", "Remote server URL")
+        .option("-t, --token <token>", "Auth token for remote server")
+        .option("--data-dir <path>", "Custom database storage directory")
+        .action(async (key, rawOptions, cmd) => {
+        const options = getEffectiveOptions(rawOptions, cmd);
+        if (!key) {
+            throw new ArgumentError("Configuration key is required");
+        }
+        const root = resolvePackageRoot(options.package);
+        await withTarget(options, context, async (target, resolved) => {
+            if (resolved.type === "remote") {
+                await target.deleteConfig(options.package || "", key);
+                writeStdout(`[OK] Configuration '${key}' deleted from remote server`, context);
+                return;
+            }
+            if (options.global) {
+                await target.deleteConfig("global", key);
+                writeStdout(`[OK] Global configuration '${key}' deleted`, context);
+                return;
+            }
+            if (!root) {
+                if (options.package) {
+                    throw new ArgumentError(`Package '${options.package}' not found in linked packages or path`);
+                }
+                await target.deleteConfig("global", key);
+                writeStdout(`[OK] Global configuration '${key}' deleted`, context);
+                return;
+            }
+            const projConfig = loadProjectConfig(root);
+            await target.deleteConfig(projConfig.id, key);
+            writeStdout(`[OK] Configuration '${key}' deleted for package '${projConfig.id}'`, context);
+        });
+    });
+}

package/dist/commands/config/env.d.ts

@@ -0,0 +1,9 @@
+import type { Command } from "commander";
+import type { CliContext } from "../../types.js";
+/**
+ * 注册 config env 子命令：诊断环境变量对声明配置的满足率。
+ *
+ * @param configCmd config 命令实例
+ * @param context 命令行上下文
+ */
+export declare function registerConfigEnvCommand(configCmd: Command, context?: CliContext): void;

package/dist/commands/config/env.js

@@ -0,0 +1,85 @@
+import { fetchRemoteConfigEnv, isSecretConfigKey, loadProjectConfig, resolveEnvValue, resolvePackageRoot, resolveTarget, } from "@actiondock/core";
+import { ArgumentError } from "../../errors.js";
+import { renderConfigEnv, renderResult } from "../../renderer.js";
+import { getEffectiveOptions } from "../../utils/index.js";
+/**
+ * 注册 config env 子命令：诊断环境变量对声明配置的满足率。
+ *
+ * @param configCmd config 命令实例
+ * @param context 命令行上下文
+ */
+export function registerConfigEnvCommand(configCmd, context) {
+    configCmd
+        .command("env [identifier]")
+        .description("Diagnose environment variable satisfaction for declared configuration")
+        .option("-P, --package <id>", "Target package ID or path")
+        .option("-p, --profile <name>", "Query on a remote target")
+        .option("-s, --server <url>", "Remote server URL")
+        .option("-t, --token <token>", "Auth token for remote server")
+        .option("--json", "Output as JSON")
+        .option("--envelope", "Wrap JSON output in standard envelope")
+        .action(async (identifier, rawOptions, cmd) => {
+        const options = getEffectiveOptions(rawOptions, cmd);
+        const targetPkg = identifier || options.package;
+        // 远端服务分支直接查询远端配置环境诊断接口
+        const target = resolveTarget({
+            profile: options.profile,
+            server: options.server,
+            token: options.token,
+        }, context?.customHome);
+        if (target.type === "remote") {
+            const res = await fetchRemoteConfigEnv(target.serverUrl, target.token, targetPkg);
+            renderResult(res, {
+                json: options.json,
+                envelope: options.envelope,
+                humanFormatter: () => renderConfigEnv(res.envChecks || [], res.packageId),
+                context,
+            });
+            const allSatisfied = (res.envChecks || []).every((c) => !c.required || c.satisfied);
+            if (!allSatisfied) {
+                process.exitCode = 1;
+            }
+            return;
+        }
+        // 本地项目分支
+        const root = resolvePackageRoot(targetPkg);
+        if (!root) {
+            if (targetPkg) {
+                throw new ArgumentError(`Package '${targetPkg}' not found in linked packages or path`);
+            }
+            throw new ArgumentError("Not in an ActionDock project.\nUsage: ad config env [package-id] or cd into a project directory.");
+        }
+        const projConfig = loadProjectConfig(root);
+        const declared = projConfig.config || {};
+        const envChecks = [];
+        for (const [key, itemDef] of Object.entries(declared)) {
+            const resolved = resolveEnvValue(key, itemDef, projConfig.id);
+            const hasDefault = itemDef.default !== undefined;
+            const satisfied = resolved !== undefined || hasDefault;
+            envChecks.push({
+                key,
+                required: Boolean(itemDef.required),
+                satisfied,
+                matchedEnv: resolved ? resolved.matchedKey : null,
+                hasDefault,
+                secret: isSecretConfigKey(key, itemDef),
+            });
+        }
+        const allSatisfied = envChecks.every((c) => !c.required || c.satisfied);
+        const payload = {
+            packageId: projConfig.id,
+            projectRoot: root,
+            ok: allSatisfied,
+            envChecks,
+        };
+        renderResult(payload, {
+            json: options.json,
+            envelope: options.envelope,
+            humanFormatter: () => renderConfigEnv(envChecks, projConfig.id),
+            context,
+        });
+        if (!allSatisfied) {
+            process.exitCode = 1;
+        }
+    });
+}

package/dist/commands/config/get.d.ts

@@ -0,0 +1,9 @@
+import type { Command } from "commander";
+import type { CliContext } from "../../types.js";
+/**
+ * 注册 config get 子命令：查询指定配置键的生效值。
+ *
+ * @param configCmd config 命令实例
+ * @param context 命令行上下文
+ */
+export declare function registerConfigGetCommand(configCmd: Command, context?: CliContext): void;

package/dist/commands/config/get.js

@@ -0,0 +1,120 @@
+import { fetchRemoteConfig, isSecretConfigKey, loadProjectConfig, maskSecretValue, resolveEnvValue, resolvePackageRoot, resolveTarget, } from "@actiondock/core";
+import { ArgumentError } from "../../errors.js";
+import { renderResult } from "../../renderer.js";
+import { getEffectiveOptions, withTarget } from "../../utils/index.js";
+/**
+ * 解析远端目标拓扑信息（仅信息解析，不创建 Target 实例）。
+ */
+function resolveRemoteTargetInfo(options, context) {
+    return resolveTarget({
+        profile: options.profile,
+        server: options.server,
+        token: options.token,
+    }, context?.customHome);
+}
+/**
+ * 注册 config get 子命令：查询指定配置键的生效值。
+ *
+ * @param configCmd config 命令实例
+ * @param context 命令行上下文
+ */
+export function registerConfigGetCommand(configCmd, context) {
+    configCmd
+        .command("get <key>")
+        .description("Get configuration value for key")
+        .option("-P, --package <id>", "Target package ID or path")
+        .option("-g, --global", "Get from global configuration")
+        .option("-p, --profile <name>", "Query config on a remote target")
+        .option("-s, --server <url>", "Remote server URL")
+        .option("-t, --token <token>", "Auth token for remote server")
+        .option("--reveal, --show-secrets", "Reveal plain text values for secrets")
+        .option("--data-dir <path>", "Custom database storage directory")
+        .option("--json", "Output as JSON")
+        .option("--envelope", "Wrap JSON output in standard envelope")
+        .action(async (key, rawOptions, cmd) => {
+        const options = getEffectiveOptions(rawOptions, cmd);
+        if (!key) {
+            throw new ArgumentError("Configuration key is required");
+        }
+        const reveal = Boolean(options.reveal || options.showSecrets);
+        // 远端服务分支不经过 Target 门面，直接查询远端配置接口
+        const target = resolveRemoteTargetInfo(options, context);
+        if (target.type === "remote") {
+            const res = await fetchRemoteConfig(target.serverUrl, target.token, options.package);
+            const val = res.values?.[key];
+            const isSecret = isSecretConfigKey(key, res.declared?.[key]);
+            const displayValue = !reveal && isSecret && val !== undefined ? maskSecretValue(val) : val;
+            const payload = {
+                key,
+                value: displayValue,
+                source: "remote",
+                secret: isSecret,
+            };
+            renderResult(payload, {
+                json: options.json,
+                envelope: options.envelope,
+                humanFormatter: () => (displayValue !== undefined ? String(displayValue) : ""),
+                context,
+            });
+            return;
+        }
+        // 本地分支
+        const root = resolvePackageRoot(options.package);
+        await withTarget(options, context, async (localTarget) => {
+            if (options.global || !root) {
+                if (!options.global && options.package && !root) {
+                    throw new ArgumentError(`Package '${options.package}' not found in linked packages or path`);
+                }
+                const confView = await localTarget.getConfig("global", key);
+                const val = confView?.value;
+                const isSecret = confView?.secret ?? isSecretConfigKey(key);
+                const displayValue = !reveal && isSecret && val !== undefined ? maskSecretValue(val) : val;
+                const payload = {
+                    key,
+                    value: displayValue,
+                    source: "global",
+                    secret: isSecret,
+                };
+                renderResult(payload, {
+                    json: options.json,
+                    envelope: options.envelope,
+                    humanFormatter: () => (displayValue !== undefined ? String(displayValue) : ""),
+                    context,
+                });
+                return;
+            }
+            const projConfig = loadProjectConfig(root);
+            const declaredItem = projConfig.config?.[key];
+            const confView = await localTarget.getConfig(projConfig.id, key);
+            let resolvedVal = confView?.value;
+            let source = confView?.source === "package" ? "project" : (confView?.source || "default");
+            const envResolved = resolveEnvValue(key, declaredItem, projConfig.id);
+            if (confView && confView.configured) {
+                resolvedVal = confView.value;
+                source = confView.source === "package" ? "project" : confView.source;
+            }
+            else if (envResolved !== undefined) {
+                resolvedVal = envResolved.value;
+                source = "env";
+            }
+            else {
+                resolvedVal = declaredItem?.default;
+                source = "default";
+            }
+            const isSecret = confView?.secret ?? isSecretConfigKey(key, declaredItem);
+            const displayValue = !reveal && isSecret && resolvedVal !== undefined ? maskSecretValue(resolvedVal) : resolvedVal;
+            const payload = {
+                key,
+                value: displayValue,
+                source,
+                secret: isSecret,
+            };
+            renderResult(payload, {
+                json: options.json,
+                envelope: options.envelope,
+                humanFormatter: () => (displayValue !== undefined ? String(displayValue) : ""),
+                context,
+            });
+        });
+    });
+}

package/dist/commands/config/index.d.ts

@@ -0,0 +1,9 @@
+import { Command } from "commander";
+import type { CliContext } from "../../types.js";
+/**
+ * 注册 config 配置管理命令（get、set、list、delete、env、schema）。
+ *
+ * @param program Commander 实例
+ * @param context 命令行上下文
+ */
+export declare function registerConfigCommands(program: Command, context?: CliContext): void;

package/dist/commands/config/index.js

@@ -0,0 +1,23 @@
+import { registerConfigSchemaCommand } from "./schema.js";
+import { registerConfigListCommand } from "./list.js";
+import { registerConfigGetCommand } from "./get.js";
+import { registerConfigSetCommand } from "./set.js";
+import { registerConfigDeleteCommand } from "./delete.js";
+import { registerConfigEnvCommand } from "./env.js";
+/**
+ * 注册 config 配置管理命令（get、set、list、delete、env、schema）。
+ *
+ * @param program Commander 实例
+ * @param context 命令行上下文
+ */
+export function registerConfigCommands(program, context) {
+    const configCmd = program
+        .command("config")
+        .description("Manage runtime configuration store (Global & Project-level)");
+    registerConfigSchemaCommand(configCmd, context);
+    registerConfigListCommand(configCmd, context);
+    registerConfigGetCommand(configCmd, context);
+    registerConfigSetCommand(configCmd, context);
+    registerConfigDeleteCommand(configCmd, context);
+    registerConfigEnvCommand(configCmd, context);
+}

package/dist/commands/config/list.d.ts

@@ -0,0 +1,9 @@
+import type { Command } from "commander";
+import type { CliContext } from "../../types.js";
+/**
+ * 注册 config list 子命令：列出全局与项目配置项。
+ *
+ * @param configCmd config 命令实例
+ * @param context 命令行上下文
+ */
+export declare function registerConfigListCommand(configCmd: Command, context?: CliContext): void;

package/dist/commands/config/list.js

@@ -0,0 +1,137 @@
+import { fetchRemoteConfig, filterWithFallbackInfo, findProjectRoot, isSecretConfigKey, loadProjectConfig, maskSecretValue, resolveEnvValue, resolvePackageRoot, resolveTarget, } from "@actiondock/core";
+import { ArgumentError } from "../../errors.js";
+import { renderConfigList, renderResult } from "../../renderer.js";
+import { getEffectiveOptions, resolveIntent, withTarget } from "../../utils/index.js";
+/**
+ * 构造单条配置项的展示视图（含掩码决策，reveal 为假且为敏感键时打码）。
+ * 掩码决策收敛于命令层，renderer 仅负责值的字符串格式化。
+ */
+function toDisplayEntry(key, rawValue, source, isSecret, reveal, description) {
+    const displayValue = !reveal && isSecret && rawValue !== undefined ? maskSecretValue(rawValue) : rawValue;
+    return {
+        key,
+        value: displayValue,
+        source,
+        secret: isSecret,
+        ...(description !== undefined ? { description } : {}),
+    };
+}
+/**
+ * 注册 config list 子命令：列出全局与项目配置项。
+ *
+ * @param configCmd config 命令实例
+ * @param context 命令行上下文
+ */
+export function registerConfigListCommand(configCmd, context) {
+    configCmd
+        .command("list [patterns...]")
+        .description("List configuration entries (Global & Project)")
+        .option("-P, --package <id>", "Target package ID or path")
+        .option("-g, --global", "Show only global configurations")
+        .option("-p, --profile <name>", "Query config on a remote target")
+        .option("-s, --server <url>", "Remote server URL")
+        .option("-t, --token <token>", "Auth token for remote server")
+        .option("-i, --intent <pattern>", "Regex or fuzzy intent filter; falls back to full list when no match")
+        .option("--reveal, --show-secrets", "Reveal plain text values for secrets")
+        .option("--no-fallback", "Disable fallback to full list when no items match intent")
+        .option("--data-dir <path>", "Custom database storage directory")
+        .option("--json", "Output as JSON")
+        .option("--envelope", "Wrap JSON output in standard envelope")
+        .action(async (patterns = [], rawOptions, cmd) => {
+        const options = getEffectiveOptions(rawOptions, cmd);
+        const effectiveIntent = resolveIntent(options.intent, patterns);
+        const shouldFallback = options.fallback !== false;
+        const reveal = Boolean(options.reveal || options.showSecrets);
+        // 远端服务分支不经过 Target 门面，直接查询远端配置接口
+        const remoteTargetInfo = resolveTarget({ profile: options.profile, server: options.server, token: options.token }, context?.customHome);
+        if (remoteTargetInfo.type === "remote") {
+            const res = await fetchRemoteConfig(remoteTargetInfo.serverUrl, remoteTargetInfo.token, options.package);
+            const entries = Object.entries(res.values || {}).map(([k, v]) => toDisplayEntry(k, v, "remote", isSecretConfigKey(k, res.declared?.[k]), reveal, res.declared?.[k]?.description || ""));
+            renderResult(entries, {
+                json: options.json,
+                envelope: options.envelope,
+                humanFormatter: () => renderConfigList(entries, `Remote Server ${remoteTargetInfo.serverUrl}${remoteTargetInfo.profileName ? ` (Profile: ${remoteTargetInfo.profileName})` : ""}`, false, effectiveIntent),
+                context,
+            });
+            return;
+        }
+        // 本地分支（通过 Target 门面统一访问）
+        await withTarget(options, context, async (localTarget) => {
+            const root = options.package ? resolvePackageRoot(options.package) : findProjectRoot();
+            if (options.global) {
+                const all = await localTarget.listConfig("global");
+                const entries = all.map((item) => toDisplayEntry(item.key, item.value, "global", item.secret || isSecretConfigKey(item.key), reveal));
+                const filterRes = filterWithFallbackInfo(entries, effectiveIntent, [(c) => c.key, (c) => c.value], shouldFallback);
+                renderResult(filterRes.items, {
+                    json: options.json,
+                    envelope: options.envelope,
+                    humanFormatter: () => renderConfigList(filterRes.items, "Global Scope", filterRes.isFallback, effectiveIntent),
+                    context,
+                });
+                return;
+            }
+            if (!root) {
+                if (options.package) {
+                    throw new ArgumentError(`Package '${options.package}' not found in linked packages or path`);
+                }
+                const all = await localTarget.listConfig("global");
+                const entries = all.map((item) => toDisplayEntry(item.key, item.value, "global", item.secret || isSecretConfigKey(item.key), reveal));
+                const filterRes = filterWithFallbackInfo(entries, effectiveIntent, [(c) => c.key, (c) => c.value], shouldFallback);
+                renderResult(filterRes.items, {
+                    json: options.json,
+                    envelope: options.envelope,
+                    humanFormatter: () => renderConfigList(filterRes.items, "Global Scope (No project found)", filterRes.isFallback, effectiveIntent),
+                    context,
+                });
+                return;
+            }
+            const projConfig = loadProjectConfig(root);
+            const declared = projConfig.config || {};
+            const globalConfigList = await localTarget.listConfig("global");
+            const projectConfigList = await localTarget.listConfig(projConfig.id);
+            const projectConfigMap = new Map(projectConfigList.map((c) => [c.key, c]));
+            const globalConfigMap = new Map(globalConfigList.map((c) => [c.key, c]));
+            const allKeys = new Set([
+                ...Object.keys(declared),
+                ...projectConfigList.map((c) => c.key),
+                ...globalConfigList.map((c) => c.key),
+            ]);
+            // 配置合并优先级：项目包级 > 全局持久化 > 环境变量 > 声明默认值。
+            // core 的 RuntimeConfig.describe 已是五层链事实源，但 Target 门面仅按作用域暴露
+            // listConfig(scope)，不提供跨作用域合并视图；此处保持命令层合并逻辑，
+            // 与 app.getConfig 的 describe 委托链行为语义一致（overrides 层仅存在于 run 链路）。
+            const merged = Array.from(allKeys).map((k) => {
+                let rawValue;
+                let source = "default";
+                const envResolved = resolveEnvValue(k, declared[k], projConfig.id);
+                const projItem = projectConfigMap.get(k);
+                const globItem = globalConfigMap.get(k);
+                if (projItem && projItem.configured && projItem.source === "package") {
+                    rawValue = projItem.value;
+                    source = "project";
+                }
+                else if (globItem && globItem.configured) {
+                    rawValue = globItem.value;
+                    source = "global";
+                }
+                else if (envResolved !== undefined) {
+                    rawValue = envResolved.value;
+                    source = "env";
+                }
+                else {
+                    rawValue = declared[k]?.default;
+                    source = "default";
+                }
+                const isSecret = isSecretConfigKey(k, declared[k]);
+                return toDisplayEntry(k, rawValue, source, isSecret, reveal, declared[k]?.description || "");
+            });
+            const filterRes = filterWithFallbackInfo(merged, effectiveIntent, [(c) => c.key, (c) => c.value, (c) => c.description, (c) => c.source], shouldFallback);
+            renderResult(filterRes.items, {
+                json: options.json,
+                envelope: options.envelope,
+                humanFormatter: () => renderConfigList(filterRes.items, `${projConfig.name} (${projConfig.id})`, filterRes.isFallback, effectiveIntent),
+                context,
+            });
+        });
+    });
+}

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

@@ -0,0 +1,9 @@
+import type { Command } from "commander";
+import type { CliContext } from "../../types.js";
+/**
+ * 注册 config schema 子命令：检查声明配置的解析状态。
+ *
+ * @param configCmd config 命令实例
+ * @param context 命令行上下文
+ */
+export declare function registerConfigSchemaCommand(configCmd: Command, context?: CliContext): void;

package/dist/commands/config/schema.js

@@ -0,0 +1,121 @@
+import { createActionDockTarget, isSecretConfigKey, loadProjectConfig, resolveEnvValue, resolvePackageRoot, } from "@actiondock/core";
+import { ArgumentError, ExecutionError } from "../../errors.js";
+import { renderConfigSchema, renderResult, writeStdout } from "../../renderer.js";
+import { getEffectiveOptions } from "../../utils/index.js";
+/**
+ * 注册 config schema 子命令：检查声明配置的解析状态。
+ *
+ * @param configCmd config 命令实例
+ * @param context 命令行上下文
+ */
+export function registerConfigSchemaCommand(configCmd, context) {
+    configCmd
+        .command("schema [identifier]")
+        .alias("check")
+        .description("Inspect declared configuration requirements and check resolution status")
+        .option("-P, --package <id>", "Target package ID or path")
+        .option("--data-dir <path>", "Custom database storage directory")
+        .option("--json", "Output as JSON")
+        .option("--envelope", "Wrap JSON output in standard envelope")
+        .action(async (identifier, rawOptions, cmd) => {
+        try {
+            const options = getEffectiveOptions(rawOptions, cmd);
+            const targetPkg = identifier || options.package;
+            const root = resolvePackageRoot(targetPkg);
+            if (!root) {
+                if (targetPkg) {
+                    throw new ArgumentError(`Package '${targetPkg}' not found in linked packages or path`);
+                }
+                throw new ArgumentError("Not in an ActionDock project.\nUsage: ad config schema [package-id] or cd into a project directory.");
+            }
+            const projConfig = loadProjectConfig(root);
+            const declared = projConfig.config || {};
+            const declaredKeys = Object.keys(declared);
+            const target = await createActionDockTarget({
+                type: "local",
+                projectRoot: root,
+                customHome: context?.customHome,
+                dataDir: options.dataDir || context?.dataDir,
+            });
+            let globalConfig = [];
+            let projectConfig = [];
+            try {
+                globalConfig = await target.listConfig("global");
+                projectConfig = await target.listConfig(projConfig.id);
+            }
+            finally {
+                await target.close();
+            }
+            const projectConfigMap = new Map(projectConfig.map((c) => [c.key, c]));
+            const globalConfigMap = new Map(globalConfig.map((c) => [c.key, c]));
+            const items = declaredKeys.map((key) => {
+                const itemDef = declared[key];
+                const isSecret = isSecretConfigKey(key, itemDef);
+                let resolvedValue;
+                let source = "missing";
+                let status = "MISSING";
+                const envResolved = resolveEnvValue(key, itemDef, projConfig.id);
+                const projItem = projectConfigMap.get(key);
+                const globItem = globalConfigMap.get(key);
+                if (projItem && projItem.configured && projItem.source === "package") {
+                    resolvedValue = projItem.value;
+                    source = "project";
+                    status = "SET";
+                }
+                else if (globItem && globItem.configured) {
+                    resolvedValue = globItem.value;
+                    source = "global";
+                    status = "SET";
+                }
+                else if (envResolved !== undefined) {
+                    resolvedValue = envResolved.value;
+                    source = "env";
+                    status = "SET";
+                }
+                else if (itemDef.default !== undefined) {
+                    resolvedValue = itemDef.default;
+                    source = "default";
+                    status = "DEFAULT";
+                }
+                return {
+                    key,
+                    required: Boolean(itemDef.required),
+                    secret: isSecret,
+                    status,
+                    source,
+                    description: itemDef.description || "",
+                    defaultValue: itemDef.default,
+                    hasValue: resolvedValue !== undefined,
+                };
+            });
+            const missingRequired = items.filter((i) => i.required && i.status === "MISSING");
+            const ok = missingRequired.length === 0;
+            const result = {
+                packageId: projConfig.id,
+                projectRoot: root,
+                ok,
+                missingCount: missingRequired.length,
+                configs: items,
+            };
+            if (options.json || options.envelope) {
+                renderResult(result, {
+                    json: options.json,
+                    envelope: options.envelope,
+                    context,
+                });
+            }
+            else {
+                writeStdout(renderConfigSchema(items, projConfig.id, root) + "\n", context);
+            }
+            if (!ok) {
+                process.exitCode = 1;
+            }
+        }
+        catch (err) {
+            if (err instanceof ArgumentError || err instanceof ExecutionError) {
+                throw err;
+            }
+            throw new ExecutionError(err.message);
+        }
+    });
+}

package/dist/commands/config/set.d.ts

@@ -0,0 +1,9 @@
+import type { Command } from "commander";
+import type { CliContext } from "../../types.js";
+/**
+ * 注册 config set 子命令：写入配置值（支持标准输入与安全提示）。
+ *
+ * @param configCmd config 命令实例
+ * @param context 命令行上下文
+ */
+export declare function registerConfigSetCommand(configCmd: Command, context?: CliContext): void;