@downcity/city 1.1.4 → 1.1.5

package/bin/cli/shared/IndexSupport.js

@@ -0,0 +1,123 @@
+/**
+ * CLI 入口共享工具。
+ *
+ * 关键点（中文）
+ * - 统一承载 `Index.ts`、console 命令、agent 命令共用的参数解析与上下文注入逻辑。
+ * - 保持共享工具纯函数化，避免命令装配文件继续膨胀。
+ */
+import { readFileSync, existsSync } from "fs";
+import { basename, join, resolve } from "path";
+import { emitCliHeader, emitCliBlock, resetCliSectionFlow } from "./CliReporter.js";
+import { CliError } from "./CliError.js";
+/**
+ * 在关键运行命令执行前打印当前 city 版本。
+ *
+ * 说明（中文）
+ * - 仅用于 runtime 相关命令，避免影响 `config --json` 等结构化输出。
+ * - 全局 catch CliError，统一渲染错误输出。
+ */
+export function createVersionBanner(version, action) {
+    return async (...args) => {
+        // 关键点（中文）：`--json` 场景禁止在 stdout 混入 banner，避免破坏机器可解析输出。
+        const hasJsonMode = args.some((arg) => {
+            if (!arg || typeof arg !== "object")
+                return false;
+            if (!Object.prototype.hasOwnProperty.call(arg, "json"))
+                return false;
+            return arg.json === true;
+        });
+        if (!hasJsonMode) {
+            resetCliSectionFlow();
+            emitCliHeader(version);
+        }
+        try {
+            await action(...args);
+        }
+        catch (error) {
+            if (error instanceof CliError) {
+                if (hasJsonMode) {
+                    console.log(JSON.stringify({
+                        success: false,
+                        error: error.message,
+                        ...(error.note ? { detail: error.note } : {}),
+                        ...(error.fix ? { fix: error.fix } : {}),
+                    }, null, 2));
+                }
+                else {
+                    emitCliBlock({
+                        tone: "error",
+                        title: error.message,
+                        note: error.note,
+                        facts: error.fix ? [{ label: "fix", value: error.fix }] : undefined,
+                    });
+                }
+                process.exitCode = error.exitCode;
+                return;
+            }
+            // 非 CliError 继续向上抛，让 Node.js 默认处理。
+            throw error;
+        }
+    };
+}
+/**
+ * 解析端口参数。
+ */
+export function parsePort(value) {
+    const num = Number.parseInt(value, 10);
+    if (!Number.isFinite(num) ||
+        Number.isNaN(num) ||
+        !Number.isInteger(num) ||
+        num <= 0 ||
+        num > 65535) {
+        throw new Error(`Invalid port: ${value}`);
+    }
+    return num;
+}
+/**
+ * 解析布尔参数。
+ */
+export function parseBoolean(value) {
+    if (value === undefined)
+        return true;
+    const normalized = String(value).trim().toLowerCase();
+    if (["true", "1", "yes", "y", "on"].includes(normalized))
+        return true;
+    if (["false", "0", "no", "n", "off"].includes(normalized))
+        return false;
+    throw new Error(`Invalid boolean: ${value}`);
+}
+/**
+ * 异步睡眠工具。
+ */
+export const sleep = async (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+/**
+ * 从项目根目录推断 agent 名称。
+ */
+export function resolveAgentName(projectRoot) {
+    const fallback = basename(projectRoot);
+    const shipJsonPath = join(projectRoot, "downcity.json");
+    if (!existsSync(shipJsonPath))
+        return fallback;
+    try {
+        const raw = readFileSync(shipJsonPath, "utf-8");
+        const parsed = JSON.parse(raw);
+        if (typeof parsed.name === "string" && parsed.name.trim()) {
+            return parsed.name.trim();
+        }
+    }
+    catch {
+        // ignore parse errors and fallback to dirname
+    }
+    return fallback;
+}
+/**
+ * 注入当前 agent 执行上下文。
+ */
+export function injectAgentContext(pathInput = ".") {
+    const projectRoot = resolve(String(pathInput || "."));
+    const agentName = resolveAgentName(projectRoot);
+    process.env.DC_AGENT_PATH = projectRoot;
+    process.env.DC_AGENT_NAME = agentName;
+    return { projectRoot, agentName };
+}
+//# sourceMappingURL=IndexSupport.js.map

package/bin/cli/shared/IndexSupport.js.map

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

package/bin/cli/shared/Plugins.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Plugins.d.ts","sourceRoot":"","sources":["../../../src/cli/shared/Plugins.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAmfzC;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAqD7D"}

package/bin/cli/shared/Plugins.js

@@ -0,0 +1,472 @@
+/**
+ * `city plugin` 命令组。
+ *
+ * 关键点（中文）
+ * - `city plugin` 提供 console 侧静态 plugin catalog 入口。
+ * - `list/status` 不依赖 agent，只展示内建 plugin 定义与 city 配置事实。
+ * - `action` 仍保留为高级入口，真正执行时依赖具体 agent 项目。
+ */
+import fs from "node:fs";
+import prompts from "prompts";
+import { buildStaticPluginAvailability, findBuiltinPlugin, findStaticPluginView, listStaticPluginViews, runLocalPluginAction, setCityPluginEnabled, } from "@downcity/agent";
+import { printResult } from "../../utils/cli/CliOutput.js";
+import { getDowncityJsonPath } from "../../config/Paths.js";
+import { emitCliBlock } from "./CliReporter.js";
+import { parseBoolean } from "./IndexSupport.js";
+import { resolveProjectRoot } from "../service/ServiceCommandSupport.js";
+async function resolvePluginProjectRoot(options) {
+    return { projectRoot: resolveProjectRoot(options.path) };
+}
+function validatePluginProjectRoot(projectRoot) {
+    const downcityJsonPath = getDowncityJsonPath(projectRoot);
+    return fs.existsSync(downcityJsonPath)
+        ? null
+        : `Invalid plugin project path: ${projectRoot}. Missing: downcity.json`;
+}
+function parseCommandPayload(raw) {
+    if (typeof raw !== "string")
+        return undefined;
+    const text = raw.trim();
+    if (!text)
+        return undefined;
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        return text;
+    }
+}
+function buildSafeStaticPluginAvailability(pluginName) {
+    try {
+        const availability = buildStaticPluginAvailability({
+            pluginName,
+        });
+        const normalizedReasons = availability.reasons.map((reason) => {
+            const text = String(reason || "");
+            if (text.includes("readonly")
+                || text.includes("Static availability inspection failed")) {
+                return "Static catalog view only. Console plugin availability could not be resolved in the current environment.";
+            }
+            return text;
+        });
+        return {
+            ...availability,
+            reasons: normalizedReasons,
+        };
+    }
+    catch (error) {
+        const message = String(error || "");
+        return {
+            enabled: false,
+            available: false,
+            reasons: [
+                message.includes("readonly")
+                    ? "Static catalog view only. Console plugin config is not writable in the current environment."
+                    : "Static catalog view only. Console plugin availability could not be resolved.",
+            ],
+        };
+    }
+}
+function stripAnsi(input) {
+    return String(input || "").replace(/\u001b\[[0-9;]*m/g, "");
+}
+function truncateCell(input, width) {
+    const text = String(input || "");
+    if (stripAnsi(text).length <= width)
+        return text;
+    return `${text.slice(0, Math.max(0, width - 1))}…`;
+}
+function renderPluginCatalogTable(rows) {
+    if (rows.length === 0) {
+        emitCliBlock({
+            tone: "info",
+            title: "Plugin catalog",
+            summary: "0 plugins",
+        });
+        return;
+    }
+    const headers = ["plugin", "enabled", "available", "actions", "title"];
+    const dataRows = rows.map((row) => [
+        row.name,
+        row.enabled ? "on" : "off",
+        row.available ? "yes" : "no",
+        String(row.actionCount),
+        row.title,
+    ]);
+    const widths = headers.map((header, index) => Math.max(header.length, ...dataRows.map((row) => stripAnsi(String(row[index] || "")).length)));
+    widths[4] = Math.min(Math.max(widths[4], 16), 40);
+    const renderRow = (values) => values
+        .map((value, index) => truncateCell(value, widths[index]).padEnd(widths[index], " "))
+        .join("  ");
+    console.log(renderRow([...headers]));
+    console.log(widths.map((width) => "-".repeat(width)).join("  "));
+    for (const row of dataRows) {
+        console.log(renderRow(row));
+    }
+}
+async function promptPluginName(message) {
+    const plugins = listStaticPluginViews();
+    const response = (await prompts({
+        type: "select",
+        name: "pluginName",
+        message,
+        choices: plugins.map((plugin) => ({
+            title: plugin.name,
+            description: plugin.title || plugin.description || "",
+            value: plugin.name,
+        })),
+        initial: 0,
+    }));
+    const pluginName = String(response.pluginName || "").trim();
+    return pluginName || null;
+}
+async function promptPluginManagerAction(params) {
+    const plugin = findStaticPluginView(params.pluginName);
+    const availability = buildSafeStaticPluginAvailability(params.pluginName);
+    const response = (await prompts({
+        type: "select",
+        name: "action",
+        message: `管理 plugin · ${params.pluginName}`,
+        choices: [
+            {
+                title: "查看状态",
+                description: plugin?.title || params.pluginName,
+                value: "status",
+            },
+            {
+                title: "全局启用",
+                description: availability.enabled ? "当前已启用" : "写入 city 级 lifecycle 配置",
+                value: "enable",
+            },
+            {
+                title: "全局关闭",
+                description: params.pluginName === "auth"
+                    ? "auth plugin 不允许全局关闭"
+                    : "写入 city 级 lifecycle 配置",
+                value: "disable",
+            },
+            {
+                title: "返回",
+                description: "重新选择 plugin",
+                value: "back",
+            },
+        ],
+        initial: 0,
+    }));
+    const action = response.action;
+    return action || null;
+}
+async function resolveInteractivePluginName(params) {
+    const explicit = String(params.pluginName || "").trim();
+    if (explicit)
+        return explicit;
+    if (!process.stdin.isTTY || !process.stdout.isTTY) {
+        emitCliBlock({
+            tone: "error",
+            title: "Plugin name is required",
+            note: "Use `city plugin status <pluginName>` or run this command in an interactive terminal.",
+        });
+        return null;
+    }
+    const selected = await promptPluginName(params.message);
+    if (!selected) {
+        emitCliBlock({
+            tone: "info",
+            title: "Plugin selection cancelled",
+        });
+        return null;
+    }
+    return selected;
+}
+async function runPluginListCommand(options) {
+    const plugins = listStaticPluginViews().map((plugin) => ({
+        ...plugin,
+        availability: buildSafeStaticPluginAvailability(plugin.name),
+    }));
+    if (options.json !== true) {
+        renderPluginCatalogTable(plugins.map((plugin) => ({
+            name: plugin.name,
+            title: plugin.title,
+            enabled: plugin.availability.enabled,
+            available: plugin.availability.available,
+            actionCount: plugin.actions.length,
+        })));
+        return;
+    }
+    printResult({
+        asJson: true,
+        success: true,
+        title: "plugins listed",
+        payload: {
+            plugins,
+        },
+    });
+}
+async function runPluginAvailabilityCommand(params) {
+    const pluginName = await resolveInteractivePluginName({
+        pluginName: params.pluginName,
+        message: "选择要查看的 plugin",
+    });
+    if (!pluginName) {
+        return;
+    }
+    const plugin = findStaticPluginView(pluginName);
+    if (!plugin) {
+        printResult({
+            asJson: params.options.json === true,
+            success: false,
+            title: "plugin status failed",
+            payload: {
+                error: `Unknown plugin: ${pluginName}`,
+            },
+        });
+        return;
+    }
+    const availability = buildSafeStaticPluginAvailability(pluginName);
+    if (params.options.json !== true) {
+        emitCliBlock({
+            tone: availability.available ? "success" : availability.enabled ? "warning" : "info",
+            title: `Plugin ${pluginName}`,
+            summary: availability.available ? "available" : availability.enabled ? "static only" : "disabled",
+            facts: [
+                {
+                    label: "title",
+                    value: plugin.title || pluginName,
+                },
+                {
+                    label: "actions",
+                    value: plugin.actions.join(", ") || "none",
+                },
+                {
+                    label: "system",
+                    value: plugin.hasSystem ? "yes" : "no",
+                },
+                ...(availability.reasons.length > 0
+                    ? [
+                        {
+                            label: "note",
+                            value: availability.reasons.join("; "),
+                        },
+                    ]
+                    : []),
+            ],
+        });
+        return;
+    }
+    printResult({
+        asJson: true,
+        success: true,
+        title: "plugin status ok",
+        payload: {
+            pluginName,
+            plugin,
+            availability,
+        },
+    });
+}
+function printPluginLifecycleResult(params) {
+    emitCliBlock({
+        tone: "success",
+        title: `Plugin ${params.pluginName}`,
+        summary: params.enabled ? "enabled" : "disabled",
+        facts: [
+            {
+                label: "scope",
+                value: "city",
+            },
+            {
+                label: "mode",
+                value: "global lifecycle",
+            },
+        ],
+    });
+}
+async function runPluginLifecycleCommand(params) {
+    const plugin = findBuiltinPlugin(params.pluginName);
+    if (!plugin) {
+        printResult({
+            asJson: params.asJson === true,
+            success: false,
+            title: "plugin lifecycle failed",
+            payload: {
+                error: `Unknown plugin: ${params.pluginName}`,
+            },
+        });
+        return;
+    }
+    if (plugin.name === "auth" && params.enabled === false) {
+        printResult({
+            asJson: params.asJson === true,
+            success: false,
+            title: "plugin lifecycle failed",
+            payload: {
+                pluginName: plugin.name,
+                error: `Plugin "${plugin.name}" cannot be disabled globally`,
+            },
+        });
+        return;
+    }
+    setCityPluginEnabled(plugin.name, params.enabled);
+    if (params.asJson === true) {
+        printResult({
+            asJson: true,
+            success: true,
+            title: "plugin lifecycle updated",
+            payload: {
+                pluginName: plugin.name,
+                enabled: params.enabled,
+                scope: "city",
+            },
+        });
+        return;
+    }
+    printPluginLifecycleResult({
+        pluginName: plugin.name,
+        enabled: params.enabled,
+    });
+}
+async function runInteractivePluginManager() {
+    if (!process.stdin.isTTY || !process.stdout.isTTY) {
+        return;
+    }
+    while (true) {
+        const pluginName = await promptPluginName("选择要管理的 plugin");
+        if (!pluginName) {
+            emitCliBlock({
+                tone: "info",
+                title: "Plugin manager closed",
+            });
+            return;
+        }
+        while (true) {
+            const action = await promptPluginManagerAction({
+                pluginName,
+            });
+            if (!action) {
+                emitCliBlock({
+                    tone: "info",
+                    title: "Plugin manager closed",
+                });
+                return;
+            }
+            if (action === "back") {
+                break;
+            }
+            if (action === "status") {
+                await runPluginAvailabilityCommand({
+                    pluginName,
+                    options: {
+                        json: false,
+                    },
+                });
+                continue;
+            }
+            if (action === "enable") {
+                await runPluginLifecycleCommand({
+                    pluginName,
+                    enabled: true,
+                });
+                continue;
+            }
+            if (action === "disable") {
+                await runPluginLifecycleCommand({
+                    pluginName,
+                    enabled: false,
+                });
+            }
+        }
+    }
+}
+async function runPluginActionCommand(params) {
+    const resolved = await resolvePluginProjectRoot(params.options);
+    if (!resolved.projectRoot) {
+        printResult({
+            asJson: params.options.json,
+            success: false,
+            title: "plugin action failed",
+            payload: {
+                error: resolved.error || "Failed to resolve agent project path",
+            },
+        });
+        return;
+    }
+    const pluginPathError = validatePluginProjectRoot(resolved.projectRoot);
+    if (pluginPathError) {
+        printResult({
+            asJson: params.options.json,
+            success: false,
+            title: "plugin action failed",
+            payload: {
+                error: pluginPathError || `Invalid plugin project path: ${resolved.projectRoot}. Missing: downcity.json`,
+            },
+        });
+        return;
+    }
+    const payload = parseCommandPayload(params.payload);
+    const local = await runLocalPluginAction({
+        projectRoot: resolved.projectRoot,
+        pluginName: params.pluginName,
+        actionName: params.actionName,
+        ...(payload !== undefined ? { payload } : {}),
+    });
+    printResult({
+        asJson: params.options.json,
+        success: Boolean(local.success),
+        title: local.success ? "plugin action ok" : "plugin action failed",
+        payload: {
+            pluginName: params.pluginName,
+            actionName: params.actionName,
+            ...(local.data !== undefined ? { data: local.data } : {}),
+            ...(local.message ? { message: local.message } : {}),
+            ...(local.error ? { error: local.error } : {}),
+        },
+    });
+}
+/**
+ * 注册 `city plugin` 命令组。
+ */
+export function registerPluginsCommand(program) {
+    const plugin = program
+        .command("plugin")
+        .description("管理 plugin（无参数时启动交互式管理器）")
+        .helpOption("--help", "display help for command");
+    plugin.action(async () => {
+        if (!process.stdin.isTTY || !process.stdout.isTTY) {
+            plugin.outputHelp();
+            return;
+        }
+        await runInteractivePluginManager();
+    });
+    plugin
+        .command("list")
+        .description("列出全部已注册 plugin 的静态信息")
+        .option("--json [enabled]", "以 JSON 输出", parseBoolean)
+        .action(async (opts) => {
+        await runPluginListCommand(opts);
+    });
+    plugin
+        .command("status [pluginName]")
+        .description("查看单个 plugin 的静态信息")
+        .option("--json [enabled]", "以 JSON 输出", parseBoolean)
+        .action(async (pluginName, opts) => {
+        await runPluginAvailabilityCommand({
+            pluginName,
+            options: opts,
+        });
+    });
+    plugin
+        .command("action <pluginName> <actionName>")
+        .description("运行 plugin action（在当前本地项目内直接执行）")
+        .option("--payload <json>", "Action payload（JSON 或普通字符串）")
+        .option("--path <path>", "agent 项目路径（默认当前目录）", ".")
+        .option("--json [enabled]", "以 JSON 输出", parseBoolean, true)
+        .action(async (pluginName, actionName, opts) => {
+        await runPluginActionCommand({
+            pluginName,
+            actionName,
+            payload: opts.payload,
+            options: opts,
+        });
+    });
+}
+//# sourceMappingURL=Plugins.js.map

package/bin/cli/shared/Plugins.js.map

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

package/bin/cli/shared/PortHints.d.ts

@@ -0,0 +1,35 @@
+/**
+ * CLI 端口提示文案。
+ *
+ * 关键点（中文）
+ * - 统一管理用户可见的端口职责说明，避免不同命令里文案漂移。
+ * - 这里只输出“用户该怎么理解端口”，不参与任何监听或分配逻辑。
+ */
+export declare const DEFAULT_RUNTIME_API_PORT = 5314;
+export declare const DEFAULT_CONTROL_PLANE_UI_PORT = 5315;
+/**
+ * 生成 city runtime 启动提示。
+ */
+export declare function buildRuntimePortFacts(): Array<{
+    label: string;
+    value: string;
+}>;
+/**
+ * 生成 control plane 启动提示。
+ */
+export declare function buildControlPlanePortFacts(url: string, options?: {
+    publicUrl?: string | null;
+}): Array<{
+    label: string;
+    value: string;
+}>;
+/**
+ * 生成 control plane 启动提示。
+ */
+export declare function buildControlPlanePortFactsWithOptions(url: string, options?: {
+    publicUrl?: string | null;
+}): Array<{
+    label: string;
+    value: string;
+}>;
+//# sourceMappingURL=PortHints.d.ts.map

package/bin/cli/shared/PortHints.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PortHints.d.ts","sourceRoot":"","sources":["../../../src/cli/shared/PortHints.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,eAAO,MAAM,wBAAwB,OAAO,CAAC;AAC7C,eAAO,MAAM,6BAA6B,OAAO,CAAC;AAElD;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,KAAK,CAAC;IAC7C,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf,CAAC,CAWD;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CACxC,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE;IACR,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B,GACA,KAAK,CAAC;IACP,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf,CAAC,CAED;AAED;;GAEG;AACH,wBAAgB,qCAAqC,CACnD,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE;IACR,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B,GACA,KAAK,CAAC;IACP,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf,CAAC,CAuBD"}