@xyit/wellspring 0.0.0-stage → 1.0.0

package/dist/commands/doctor.js

@@ -0,0 +1,77 @@
+/*
+ * doctor：环境与配置诊断。
+ */
+import { existsSync } from "node:fs";
+import { apiKeyStatusSync, credentialsFile } from "../config/credentials.js";
+import { describePaths, platform } from "../platform/index.js";
+import { SandboxManager } from "../sandbox/manager.js";
+import { success } from "./shared.js";
+export async function runDoctorCommand(ctx) {
+    const checks = [];
+    const major = Number(process.versions.node.split(".")[0]);
+    checks.push({ name: "node", ok: major >= 24, detail: process.versions.node });
+    checks.push({ name: "platform", ok: true, detail: platform });
+    checks.push({
+        name: "paths",
+        ok: true,
+        detail: describePaths(ctx.paths).replaceAll("\n", " | "),
+    });
+    checks.push({
+        name: "config",
+        ok: ctx.configCode === null,
+        detail: ctx.configCode ?? ctx.settingsFile,
+    });
+    const keyStatus = apiKeyStatusSync(credentialsFile(ctx.paths.configDir));
+    const keySource = keyStatus.source === "env"
+        ? "OPENAI_API_KEY"
+        : keyStatus.source === "credentials"
+            ? keyStatus.file
+            : null;
+    checks.push({
+        name: "openai-key",
+        ok: keyStatus.configured,
+        detail: keySource === null
+            ? "未配置（wellspring key set 或 OPENAI_API_KEY）"
+            : `${keySource} ${keyStatus.masked ?? ""}`.trim(),
+    });
+    checks.push({
+        name: "openai",
+        ok: ctx.openai !== null,
+        detail: ctx.openai === null
+            ? "客户端未就绪"
+            : `${ctx.activeProvider ?? "openai"} / ${ctx.activeModel ?? ctx.settings.openai.model}`,
+    });
+    checks.push({
+        name: "proxy",
+        ok: true,
+        detail: ctx.settings.network.proxy?.url ?? "直连",
+    });
+    checks.push({
+        name: "log-file",
+        ok: existsSync(ctx.paths.logDir),
+        detail: ctx.paths.logDir,
+    });
+    const sandboxProbe = await new SandboxManager({
+        settings: ctx.settings.sandbox,
+        paths: ctx.paths,
+    }).probe();
+    const sandboxOk = ctx.settings.sandbox.mode !== "strict" || sandboxProbe.available;
+    checks.push({
+        name: "sandbox",
+        ok: sandboxOk,
+        detail: `${ctx.settings.sandbox.mode}/${sandboxProbe.backend}/${ctx.settings.sandbox.access}${sandboxProbe.available ? "" : `：${sandboxProbe.reason ?? "不可用"}`}`,
+    });
+    const plugins = await ctx.loadPlugins();
+    const disabled = plugins.filter((plugin) => plugin.status === "disabled").length;
+    checks.push({
+        name: "plugins",
+        ok: plugins.every((plugin) => plugin.status !== "failed"),
+        detail: `${plugins.length} 个${disabled > 0 ? `（禁用 ${disabled}）` : ""}`,
+    });
+    for (const check of checks) {
+        const tag = check.ok ? "[ OK  ]" : "[FAIL ]";
+        ctx.elog.print(`${tag} ${check.name.padEnd(10)} ${check.detail}`);
+    }
+    return success({ checks });
+}
+//# sourceMappingURL=doctor.js.map

package/dist/commands/doctor.js.map

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

package/dist/commands/exec-approval.d.ts

@@ -0,0 +1,3 @@
+import type { ExecApprovalRequest } from "./agent-turn.js";
+export declare function isExecApprovalYes(answer: string): boolean;
+export declare function promptExecApproval(_request: ExecApprovalRequest): Promise<boolean>;

package/dist/commands/exec-approval.js

@@ -0,0 +1,80 @@
+// execute_code 交互审批
+import { emitKeypressEvents } from "node:readline";
+// 是否批准
+export function isExecApprovalYes(answer) {
+    const text = answer.trim().toLowerCase();
+    return text === "y" || text === "yes";
+}
+// 选项渲染
+function renderChoice(selected) {
+    const options = ["[允许]", "[拒绝]"];
+    const color = process.stdout.isTTY === true &&
+        process.env["NO_COLOR"] === undefined &&
+        process.env["TERM"] !== "dumb";
+    const rendered = options
+        .map((option, index) => {
+        if (index !== selected) {
+            return option;
+        }
+        return color ? `\x1b[7m${option}\x1b[0m` : `>${option}`;
+    })
+        .join(" ");
+    process.stdout.write(`\r\x1b[2K是否允许？${rendered}  ←/→ 切换 · Enter 确认`);
+}
+// 终端逐次审批
+export async function promptExecApproval(_request) {
+    if (process.stdin.isTTY !== true || process.stdout.isTTY !== true) {
+        return false;
+    }
+    const stdin = process.stdin;
+    const wasRaw = stdin.isRaw === true;
+    stdin.setRawMode(true);
+    stdin.resume();
+    emitKeypressEvents(stdin);
+    let selected = 1;
+    renderChoice(selected);
+    return await new Promise((resolve) => {
+        const finish = (value) => {
+            stdin.off("keypress", onKeypress);
+            if (!wasRaw) {
+                stdin.setRawMode(false);
+            }
+            stdin.pause();
+            process.stdout.write("\n");
+            resolve(value);
+        };
+        const onKeypress = (_text, key) => {
+            switch (key.name) {
+                case "left":
+                case "right":
+                case "tab":
+                    selected = selected === 0 ? 1 : 0;
+                    renderChoice(selected);
+                    return;
+                case "return":
+                case "enter":
+                    finish(selected === 0);
+                    return;
+                case "escape":
+                    finish(false);
+                    return;
+                case "y":
+                    selected = 0;
+                    renderChoice(selected);
+                    finish(true);
+                    return;
+                case "n":
+                    selected = 1;
+                    renderChoice(selected);
+                    finish(false);
+                    return;
+                default:
+                    if (key.ctrl === true && key.name === "c") {
+                        finish(false);
+                    }
+            }
+        };
+        stdin.on("keypress", onKeypress);
+    });
+}
+//# sourceMappingURL=exec-approval.js.map

package/dist/commands/exec-approval.js.map

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

package/dist/commands/help.d.ts

@@ -0,0 +1,2 @@
+import { type CommandContext, type CommandOutcome } from "./shared.js";
+export declare function runHelpCommand(ctx: CommandContext, argv: readonly string[]): Promise<CommandOutcome>;

package/dist/commands/help.js

@@ -0,0 +1,35 @@
+/*
+ * help：内置命令 + 已注册插件命令。
+ */
+import { Result } from "../api/result/result.js";
+import { USAGE_CODES } from "../input/codes.js";
+import { BUILTIN_COMMANDS } from "../input/commands.js";
+import { formatCommandHelp, formatGlobalHelp } from "../input/help.js";
+import { failure, success } from "./shared.js";
+export async function runHelpCommand(ctx, argv) {
+    await ctx.loadPlugins();
+    const pluginCommands = ctx.registry.list().map((record) => ({
+        name: record.command.name,
+        summary: record.command.summary,
+        usage: record.command.usage ?? `wellspring ${record.command.name}`,
+        plugin: record.pluginName,
+    }));
+    const builtins = BUILTIN_COMMANDS.map((spec) => ({
+        name: spec.name,
+        summary: spec.summary,
+        usage: spec.usage,
+    }));
+    const target = argv[0];
+    if (target === undefined) {
+        ctx.elog.print(formatGlobalHelp(pluginCommands));
+        return success({ builtins, plugins: pluginCommands });
+    }
+    const plugin = pluginCommands.find((command) => command.name === target);
+    const text = formatCommandHelp(target, plugin);
+    if (text === null) {
+        return failure(`${USAGE_CODES.unknownCommand}:${target}`);
+    }
+    ctx.elog.print(text);
+    return success({ command: target });
+}
+//# sourceMappingURL=help.js.map

package/dist/commands/help.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"help.js","sourceRoot":"","sources":["../../src/commands/help.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAA;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAC/C,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AACvD,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAA0B,MAAM,kBAAkB,CAAA;AAC9F,OAAO,EAAE,OAAO,EAAE,OAAO,EAA4C,MAAM,aAAa,CAAA;AAExF,MAAM,CAAC,KAAK,UAAU,cAAc,CAChC,GAAmB,EACnB,IAAuB;IAEvB,MAAM,GAAG,CAAC,WAAW,EAAE,CAAA;IACvB,MAAM,cAAc,GAAwB,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QAC7E,IAAI,EAAE,MAAM,CAAC,OAAO,CAAC,IAAI;QACzB,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,OAAO;QAC/B,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC,KAAK,IAAI,cAAc,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE;QAClE,MAAM,EAAE,MAAM,CAAC,UAAU;KAC5B,CAAC,CAAC,CAAA;IAEH,MAAM,QAAQ,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QAC7C,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,KAAK,EAAE,IAAI,CAAC,KAAK;KACpB,CAAC,CAAC,CAAA;IACH,MAAM,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC,CAAA;IACtB,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACvB,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,gBAAgB,CAAC,cAAc,CAAC,CAAC,CAAA;QAChD,OAAO,OAAO,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,cAAc,EAAE,CAAC,CAAA;IACzD,CAAC;IAED,MAAM,MAAM,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,KAAK,MAAM,CAAC,CAAA;IACxE,MAAM,IAAI,GAAG,iBAAiB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC9C,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;QAChB,OAAO,OAAO,CAAC,GAAG,WAAW,CAAC,cAAc,IAAI,MAAM,EAAE,CAAC,CAAA;IAC7D,CAAC;IACD,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;IACpB,OAAO,OAAO,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAA;AACvC,CAAC"}

package/dist/commands/key.d.ts

@@ -0,0 +1,2 @@
+import { type CommandContext, type CommandOutcome } from "./shared.js";
+export declare function runKeyCommand(ctx: CommandContext, argv: readonly string[]): Promise<CommandOutcome>;

package/dist/commands/key.js

@@ -0,0 +1,226 @@
+/*
+ * key 命令：查看 / 设置 / 清除 / 测试模型供应商的 API Key。
+ *
+ * 默认操作当前生效供应商；--provider 可指定其他供应商。
+ * 明文 key 只写入 <configDir>/credentials.json（0600），输出一律用掩码；
+ * 无参数时交互式输入或从 stdin 读取，避免进 shell 历史。
+ */
+import { Result } from "../api/result/result.js";
+import { CONFIG_CODES } from "../config/codes.js";
+import { clearProviderApiKey, credentialsFile, normalizeApiKey, providerKeyStatusSync, resolveProviderApiKeySync, saveProviderApiKey, } from "../config/credentials.js";
+import { activeModelProvider, findModelProvider, providerOpenAISettings, } from "../config/providers.js";
+import { USAGE_CODES } from "../input/codes.js";
+import { parseCommandArgs } from "../input/parse-options.js";
+import { OpenAIClient } from "../network/openai.js";
+import { createProxyFetch } from "../network/proxy.js";
+import { failure, success } from "./shared.js";
+const MAX_STDIN_CHARS = 8192;
+function sourceLabel(status) {
+    if (status.source === "env") {
+        return `环境变量 ${status.envVar ?? ""}`.trim();
+    }
+    if (status.source === "credentials") {
+        return `本地凭据 ${status.file}`;
+    }
+    return "未配置";
+}
+function printStatus(ctx, provider, status) {
+    ctx.elog.print(`供应商: ${provider.name}（${provider.id}）`);
+    ctx.elog.print(`来源: ${sourceLabel(status)}`);
+    if (status.masked !== null) {
+        ctx.elog.print(`Key: ${status.masked}`);
+    }
+    if (status.source === "env") {
+        ctx.elog.print(`提示: 环境变量 ${status.envVar ?? ""} 优先生效，本地保存的 key 会被忽略`);
+    }
+}
+/** key 默认操作当前生效供应商 */
+function targetProvider(ctx, providerId) {
+    if (providerId === undefined || providerId.trim() === "") {
+        return activeModelProvider(ctx.settings);
+    }
+    const found = findModelProvider(ctx.settings, providerId.trim());
+    if (found === null) {
+        throw new Error(`models.provider-not-found:${providerId}`);
+    }
+    return found;
+}
+/** 管道 / 重定向：从 stdin 读 key，适合脚本与 CI */
+async function readKeyFromStdin() {
+    if (process.stdin.isTTY === true) {
+        return null;
+    }
+    process.stdin.setEncoding("utf8");
+    let text = "";
+    for await (const chunk of process.stdin) {
+        text += String(chunk);
+        if (text.length > MAX_STDIN_CHARS) {
+            break;
+        }
+    }
+    return text.trim();
+}
+/** 交互式隐藏输入：只回显星号，避免明文留在终端回滚与 shell 历史 */
+function promptHiddenApiKey(prompt) {
+    const stdin = process.stdin;
+    if (stdin.isTTY !== true) {
+        return Promise.resolve(null);
+    }
+    const wasRaw = stdin.isRaw === true;
+    process.stderr.write(prompt);
+    stdin.setRawMode(true);
+    stdin.resume();
+    stdin.setEncoding("utf8");
+    return new Promise((resolvePromise) => {
+        let text = "";
+        let settled = false;
+        const finish = (value) => {
+            if (settled) {
+                return;
+            }
+            settled = true;
+            stdin.off("data", onData);
+            if (wasRaw !== true) {
+                stdin.setRawMode(false);
+            }
+            stdin.pause();
+            process.stderr.write("\n");
+            resolvePromise(value);
+        };
+        const onData = (chunk) => {
+            for (const char of chunk) {
+                if (char === "\r" || char === "\n") {
+                    finish(text.trim() === "" ? null : text.trim());
+                    return;
+                }
+                if (char === "\u0003" || char === "\u0004") {
+                    finish(null);
+                    return;
+                }
+                if (char === "\u007f" || char === "\b") {
+                    if (text.length > 0) {
+                        text = text.slice(0, -1);
+                        process.stderr.write("\b \b");
+                    }
+                    continue;
+                }
+                text += char;
+                process.stderr.write("*");
+            }
+        };
+        stdin.on("data", onData);
+    });
+}
+function keyStatusOf(ctx, provider) {
+    return providerKeyStatusSync({ id: provider.id, apiKeyEnv: provider.apiKeyEnv }, credentialsFile(ctx.paths.configDir));
+}
+async function runTest(ctx, provider, candidate) {
+    const file = credentialsFile(ctx.paths.configDir);
+    let apiKey;
+    if (candidate !== undefined) {
+        const normalized = normalizeApiKey(candidate);
+        if (normalized === null) {
+            return failure(CONFIG_CODES.invalidApiKey);
+        }
+        apiKey = normalized;
+    }
+    else {
+        const resolved = resolveProviderApiKeySync({ id: provider.id, apiKeyEnv: provider.apiKeyEnv }, file);
+        if (resolved === null) {
+            return failure("openai.missing-api-key");
+        }
+        apiKey = resolved.apiKey;
+    }
+    let fetch;
+    try {
+        fetch = createProxyFetch(ctx.settings.network.proxy);
+    }
+    catch {
+        fetch = undefined;
+    }
+    const created = OpenAIClient.create({
+        settings: providerOpenAISettings(ctx.settings, provider),
+        apiKey,
+        credentialsFile: file,
+        logger: ctx.logger.child({ module: "openai" }),
+        fetch,
+    });
+    const client = created.getData();
+    if (!created.isSuccess() || client === null) {
+        return failure(created.getCode() ?? "openai.request-failed");
+    }
+    const tested = await client.testConnection();
+    const data = tested.getData();
+    if (!tested.isSuccess() || data === null) {
+        return failure(tested.getCode() ?? "openai.request-failed");
+    }
+    const model = provider.defaultModel ?? provider.models[0] ?? ctx.settings.openai.model;
+    ctx.elog.print(`连接正常: ${provider.name} 可见模型 ${data.models} 个，缺省模型 ${model}`);
+    return success({ models: data.models, model, provider: provider.id });
+}
+export async function runKeyCommand(ctx, argv) {
+    const [subcommand = "status", ...rest] = argv;
+    const parsed = parseCommandArgs(rest, { provider: { type: "string" } });
+    if (!parsed.isSuccess()) {
+        return { result: Result.error(parsed.getCode() ?? USAGE_CODES.invalidValue) };
+    }
+    const line = parsed.getData();
+    if (line === null) {
+        return failure(USAGE_CODES.invalidValue);
+    }
+    const rawProviderOption = line.values["provider"];
+    let provider;
+    try {
+        provider = targetProvider(ctx, typeof rawProviderOption === "string" ? rawProviderOption : undefined);
+    }
+    catch (error) {
+        return failure(error instanceof Error ? error.message : "models.provider-not-found");
+    }
+    switch (subcommand) {
+        case "status": {
+            const status = keyStatusOf(ctx, provider);
+            printStatus(ctx, provider, status);
+            return success(status);
+        }
+        case "path": {
+            const file = credentialsFile(ctx.paths.configDir);
+            ctx.elog.print(file);
+            return success({ path: file });
+        }
+        case "set": {
+            const raw = line.positionals[0] ??
+                (await readKeyFromStdin()) ??
+                (await promptHiddenApiKey("粘贴 API Key（输入不回显，回车确认）: "));
+            if (raw === null || raw === undefined || raw === "") {
+                return failure(`${USAGE_CODES.missingValue}:key`);
+            }
+            const saved = await saveProviderApiKey(provider.id, raw, credentialsFile(ctx.paths.configDir));
+            if (!saved.isSuccess()) {
+                return failure(saved.getCode() ?? CONFIG_CODES.credentialsWriteFailed);
+            }
+            const status = keyStatusOf(ctx, provider);
+            ctx.elog.print(`已保存 ${provider.name}: ${status.masked ?? ""} -> ${status.file}`);
+            if (status.source === "env") {
+                ctx.elog.print(`注意: 环境变量 ${status.envVar ?? ""} 优先，实际请求仍用环境变量里的 key`);
+            }
+            return success(status);
+        }
+        case "clear": {
+            const cleared = await clearProviderApiKey(provider.id, credentialsFile(ctx.paths.configDir));
+            if (!cleared.isSuccess()) {
+                return failure(cleared.getCode() ?? CONFIG_CODES.credentialsWriteFailed);
+            }
+            const status = keyStatusOf(ctx, provider);
+            ctx.elog.print(status.envOverride
+                ? `本地凭据已清除；环境变量 ${status.envVar ?? ""} 仍然生效`
+                : "本地凭据已清除");
+            return success(status);
+        }
+        case "test": {
+            return await runTest(ctx, provider, line.positionals[0]);
+        }
+        default:
+            return failure(`${USAGE_CODES.unknownSubcommand}:${subcommand}`);
+    }
+}
+//# sourceMappingURL=key.js.map

package/dist/commands/key.js.map

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

package/dist/commands/plugin.d.ts

@@ -0,0 +1,2 @@
+import { type CommandContext, type CommandOutcome } from "./shared.js";
+export declare function runPluginCommand(ctx: CommandContext, argv: readonly string[]): Promise<CommandOutcome>;

package/dist/commands/plugin.js

@@ -0,0 +1,188 @@
+/*
+ * plugin 命令：list / install / link / remove。
+ */
+import { readFile, readdir } from "node:fs/promises";
+import { basename, join } from "node:path";
+import { Result } from "../api/result/result.js";
+import { USAGE_CODES } from "../input/codes.js";
+import { booleanValue, parseCommandArgs } from "../input/parse-options.js";
+import { statIfExists } from "../platform/file.js";
+import { installPlugin } from "../plugin/install.js";
+import { linkPlugin, removePlugin } from "../plugin/loader.js";
+import { PLUGIN_NAME, pluginsRoot } from "../plugin/paths.js";
+import { scaffoldPlugin } from "../plugin/scaffold.js";
+import { readPluginState, setPluginEnabled } from "../plugin/state.js";
+import { failure, success } from "./shared.js";
+/** 只扫插件目录的文件，不启动插件进程（plugin list / enable / disable 用） */
+async function scanPluginDirs(paths) {
+    const root = pluginsRoot(paths);
+    const disabled = await readPluginState(paths);
+    let names;
+    try {
+        names = (await readdir(root)).sort();
+    }
+    catch {
+        return [];
+    }
+    const plugins = [];
+    for (const dirName of names) {
+        if (!PLUGIN_NAME.test(dirName) || dirName.startsWith("."))
+            continue;
+        const dir = join(root, dirName);
+        const info = await statIfExists(dir);
+        if (info === null || !info.isDirectory())
+            continue;
+        let name = dirName;
+        let version = "0.0.0";
+        try {
+            const pkg = JSON.parse(await readFile(join(dir, "package.json"), "utf8"));
+            if (typeof pkg.name === "string" && pkg.name !== "")
+                name = pkg.name;
+            if (typeof pkg.version === "string" && pkg.version !== "")
+                version = pkg.version;
+        }
+        catch {
+            /* 没有 package.json 时用目录名 */
+        }
+        let deps = [];
+        try {
+            const source = await readFile(join(dir, "index.ts"), "utf8");
+            const match = /deps\s*:\s*\[([^\]]*)\]/.exec(source);
+            if (match !== null) {
+                deps = [...(match[1] ?? "").matchAll(/["']([^"']+)["']/g)].map((item) => item[1] ?? "");
+            }
+        }
+        catch {
+            /* 读不到入口时按没有依赖处理 */
+        }
+        plugins.push({
+            dirName,
+            name,
+            version,
+            enabled: !disabled.has(dirName),
+            deps: deps.filter((dep) => dep !== ""),
+        });
+    }
+    return plugins;
+}
+/** 依赖目标插件的其它插件目录名 */
+function dependentsOf(plugins, dirName, pluginName) {
+    return plugins
+        .filter((plugin) => plugin.dirName !== dirName &&
+        (plugin.deps.includes(dirName) || plugin.deps.includes(pluginName)))
+        .map((plugin) => plugin.dirName);
+}
+export async function runPluginCommand(ctx, argv) {
+    const [subcommand, ...rest] = argv;
+    const parsed = parseCommandArgs(rest, {
+        force: { type: "boolean" },
+        ignore: { type: "boolean" },
+        dir: { type: "string" },
+    });
+    if (!parsed.isSuccess()) {
+        return { result: Result.error(parsed.getCode() ?? USAGE_CODES.invalidValue) };
+    }
+    const line = parsed.getData();
+    if (line === null) {
+        return failure(USAGE_CODES.invalidValue);
+    }
+    const force = booleanValue(line.values, "force");
+    const ignore = booleanValue(line.values, "ignore");
+    try {
+        switch (subcommand) {
+            case "list": {
+                const plugins = await scanPluginDirs(ctx.paths);
+                for (const plugin of plugins) {
+                    const deps = plugin.deps.length === 0 ? "-" : plugin.deps.join(",");
+                    const status = plugin.enabled ? "enabled" : "disabled";
+                    ctx.elog.print(`${plugin.dirName}  ${plugin.name}@${plugin.version}  ${status}  deps=${deps}`);
+                }
+                return success(plugins);
+            }
+            case "new": {
+                const name = line.positionals[0];
+                if (name === undefined) {
+                    return failure(`${USAGE_CODES.missingValue}:name`);
+                }
+                const created = await scaffoldPlugin({
+                    name,
+                    parentDir: typeof line.values["dir"] === "string" ? line.values["dir"] : undefined,
+                    force,
+                });
+                ctx.elog.info(`已创建插件 ${name}：${created.dir}`);
+                ctx.elog.print("下一步：");
+                ctx.elog.print(`  wellspring plugin link ${created.dir}`);
+                ctx.elog.print(`  wellspring plugin list`);
+                ctx.elog.print(`  wellspring ${created.commandName}`);
+                ctx.elog.print("类型检查：先把 Wellspring 链接进插件（见插件 README）");
+                return success(created);
+            }
+            case "enable":
+            case "disable": {
+                const name = line.positionals[0];
+                if (name === undefined) {
+                    return failure(`${USAGE_CODES.missingValue}:name`);
+                }
+                if (!PLUGIN_NAME.test(name)) {
+                    return failure(`${USAGE_CODES.invalidValue}:name`);
+                }
+                const plugins = await scanPluginDirs(ctx.paths);
+                const match = plugins.find((plugin) => plugin.dirName === name) ??
+                    plugins.find((plugin) => plugin.name === name);
+                const dirName = match === undefined ? name : match.dirName;
+                const dir = join(pluginsRoot(ctx.paths), dirName);
+                if ((await statIfExists(dir)) === null) {
+                    return failure(`plugin.not-found:${name}`);
+                }
+                const enabled = subcommand === "enable";
+                await setPluginEnabled(dirName, enabled, ctx.paths);
+                ctx.elog.info(`${enabled ? "已启用" : "已禁用"}插件 ${dirName}（下次运行生效）`);
+                return success({ id: dirName, enabled });
+            }
+            case "install": {
+                const source = line.positionals[0];
+                if (source === undefined) {
+                    return failure(`${USAGE_CODES.missingValue}:path`);
+                }
+                const installed = await installPlugin(source, ctx.paths, { force });
+                ctx.elog.info(`已安装插件 ${installed.id}`);
+                return success(installed);
+            }
+            case "link": {
+                const source = line.positionals[0];
+                if (source === undefined) {
+                    return failure(`${USAGE_CODES.missingValue}:path`);
+                }
+                const name = await linkPlugin(source, ctx.paths);
+                ctx.elog.info(`已链接插件 ${name}`);
+                return success({ id: name });
+            }
+            case "remove": {
+                const name = line.positionals[0];
+                if (name === undefined) {
+                    return failure(`${USAGE_CODES.missingValue}:name`);
+                }
+                const plugins = await scanPluginDirs(ctx.paths);
+                const target = plugins.find((plugin) => plugin.dirName === name) ??
+                    plugins.find((plugin) => plugin.name === name);
+                const dirName = target === undefined ? name : target.dirName;
+                const dependents = dependentsOf(plugins, dirName, target?.name ?? dirName);
+                if (dependents.length > 0 && !ignore) {
+                    ctx.elog.error(`插件 ${dirName} 被这些插件依赖：${dependents.join(", ")}；` +
+                        "确认要强制卸载请加 --ignore");
+                    return failure(`plugin.has-dependents:${dependents.join(",")}`);
+                }
+                await removePlugin(dirName, ctx.paths);
+                ctx.elog.info(`已删除插件 ${dirName}${ignore && dependents.length > 0 ? "（忽略依赖）" : ""}`);
+                return success({ id: dirName });
+            }
+            default:
+                return failure(`${USAGE_CODES.unknownSubcommand}:plugin ${subcommand ?? ""}`);
+        }
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return failure(`plugin.install-failed:${message}`);
+    }
+}
+//# sourceMappingURL=plugin.js.map