@downcity/city 1.1.4 → 1.1.5

package/bin/cli/agent/Status.js

@@ -0,0 +1,103 @@
+/**
+ * 查询后台 Agent 进程（daemon）状态。
+ *
+ * 对应命令：
+ * - `city agent status [path]`
+ */
+import path from "path";
+import fs from "fs-extra";
+import { diagnoseDaemonStaleReasons, isProcessAlive, readDaemonMeta, readDaemonPid, } from "../../process/daemon/Manager.js";
+import { getProfileMdPath, getDowncityJsonPath } from "../../config/Paths.js";
+import { emitCliBlock } from "../shared/CliReporter.js";
+/**
+ * daemon 状态查询入口。
+ *
+ * 状态规则（中文）
+ * - 运行中：输出 pid / log / startedAt
+ * - 已初始化但未运行：输出 not running
+ * - 未初始化：提示执行 `city agent create`
+ */
+export async function statusCommand(cwd = ".") {
+    const projectRoot = path.resolve(cwd);
+    const missingInitFiles = [];
+    if (!fs.existsSync(getProfileMdPath(projectRoot))) {
+        missingInitFiles.push("PROFILE.md");
+    }
+    if (!fs.existsSync(getDowncityJsonPath(projectRoot))) {
+        missingInitFiles.push("downcity.json");
+    }
+    const pid = await readDaemonPid(projectRoot);
+    if (pid && isProcessAlive(pid)) {
+        const meta = await readDaemonMeta(projectRoot);
+        emitCliBlock({
+            tone: "success",
+            title: "Agent status",
+            summary: "running",
+            facts: [
+                ["project", projectRoot],
+                ...(meta?.startedAt ? [["started at", meta.startedAt]] : []),
+                ...(missingInitFiles.length > 0
+                    ? [["warning", `missing init files: ${missingInitFiles.join(", ")}`]]
+                    : []),
+            ].map(([label, value]) => ({ label, value })),
+        });
+        return;
+    }
+    if (pid) {
+        const reasons = await diagnoseDaemonStaleReasons(projectRoot, pid);
+        emitCliBlock({
+            tone: "warning",
+            title: "Agent status",
+            summary: "stale",
+            facts: [
+                {
+                    label: "project",
+                    value: projectRoot,
+                },
+                {
+                    label: "reason",
+                    value: reasons.map((item) => item.message).join("; "),
+                },
+                {
+                    label: "fix",
+                    value: `city agent doctor ${projectRoot} --fix`,
+                },
+            ],
+        });
+        return;
+    }
+    if (missingInitFiles.length > 0) {
+        emitCliBlock({
+            tone: "error",
+            title: "Agent status",
+            summary: "not initialized",
+            facts: [
+                {
+                    label: "project",
+                    value: projectRoot,
+                },
+                {
+                    label: "missing",
+                    value: missingInitFiles.join(", "),
+                },
+                {
+                    label: "fix",
+                    value: 'run "city agent create" first',
+                },
+            ],
+        });
+        return;
+    }
+    emitCliBlock({
+        tone: "info",
+        title: "Agent status",
+        summary: "stopped",
+        facts: [
+            {
+                label: "project",
+                value: projectRoot,
+            },
+        ],
+    });
+}
+//# sourceMappingURL=Status.js.map

package/bin/cli/agent/Status.js.map

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

package/bin/cli/agent/Stop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Stop.d.ts","sourceRoot":"","sources":["../../../src/cli/agent/Stop.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAOH;;;;;;;GAOG;AACH,wBAAsB,WAAW,CAAC,GAAG,GAAE,MAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAsBlE"}

package/bin/cli/agent/Stop.js

@@ -0,0 +1,44 @@
+/**
+ * `city agent stop`：停止后台常驻的 Agent 进程（daemon）。
+ *
+ * 关键点（中文）
+ * - 这是单个 agent 的生命周期命令，只停止目标项目的 daemon。
+ * - 底层 stop 会同步清理 pid/meta，并把 city registry 中对应 agent 标记为 stopped。
+ * - 若目标 agent 未运行，命令保持幂等，只输出 not running。
+ */
+import path from "path";
+import { stopDaemonProcess } from "../../process/daemon/Manager.js";
+import { emitCliBlock } from "../shared/CliReporter.js";
+import { resolveAgentName } from "../shared/IndexSupport.js";
+/**
+ * stop 命令执行流程。
+ *
+ * 关键点（中文）
+ * 1) 将输入路径解析为绝对项目路径
+ * 2) 调用 daemon manager 停止进程组
+ * 3) 用人类可读 block 输出 stopped / not running
+ */
+export async function stopCommand(cwd = ".") {
+    const projectRoot = path.resolve(cwd);
+    const result = await stopDaemonProcess({ projectRoot });
+    emitCliBlock({
+        tone: result.stopped ? "success" : "info",
+        title: result.stopped ? "Agent daemon stopped" : "Agent daemon not running",
+        summary: resolveAgentName(projectRoot),
+        facts: [
+            {
+                label: "Project",
+                value: projectRoot,
+            },
+            ...(result.pid
+                ? [
+                    {
+                        label: "PID",
+                        value: String(result.pid),
+                    },
+                ]
+                : []),
+        ],
+    });
+}
+//# sourceMappingURL=Stop.js.map

package/bin/cli/agent/Stop.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Stop.js","sourceRoot":"","sources":["../../../src/cli/agent/Stop.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAE7D;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,MAAc,GAAG;IACjD,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACtC,MAAM,MAAM,GAAG,MAAM,iBAAiB,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC;IACxD,YAAY,CAAC;QACX,IAAI,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM;QACzC,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC,0BAA0B;QAC3E,OAAO,EAAE,gBAAgB,CAAC,WAAW,CAAC;QACtC,KAAK,EAAE;YACL;gBACE,KAAK,EAAE,SAAS;gBAChB,KAAK,EAAE,WAAW;aACnB;YACD,GAAG,CAAC,MAAM,CAAC,GAAG;gBACZ,CAAC,CAAC;oBACE;wBACE,KAAK,EAAE,KAAK;wBACZ,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC;qBAC1B;iBACF;gBACH,CAAC,CAAC,EAAE,CAAC;SACR;KACF,CAAC,CAAC;AACL,CAAC"}

package/bin/cli/control-plane/ControlPlaneAuthBootstrap.d.ts

@@ -0,0 +1,25 @@
+/**
+ * control plane 启动阶段的本机 token 初始化辅助。
+ *
+ * 关键点（中文）
+ * - `city start` 首次启动时，如果还没有本机 CLI access token，这里负责初始化首个 token。
+ * - 新模型不再要求用户名密码登录，也不再做交互式密码提示。
+ * - 一旦本机 token 已存在，本模块直接跳过，不会重复打断启动流程。
+ * - 启动流程不再写入任何本机默认 token 状态，只显示一次明文 token。
+ */
+import { AuthService } from "../../http/auth/AuthService.js";
+/**
+ * control plane 启动期统一账户初始化参数。
+ */
+export interface EnsureControlPlaneAuthBootstrapOptions {
+    /**
+     * 可选注入外部 AuthService，便于测试。
+     */
+    authService?: AuthService;
+    readPassword?: () => Promise<string>;
+}
+/**
+ * 确保平台级至少存在一个本机 access token。
+ */
+export declare function ensureControlPlaneAuthBootstrap(options?: EnsureControlPlaneAuthBootstrapOptions): Promise<void>;
+//# sourceMappingURL=ControlPlaneAuthBootstrap.d.ts.map

package/bin/cli/control-plane/ControlPlaneAuthBootstrap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ControlPlaneAuthBootstrap.d.ts","sourceRoot":"","sources":["../../../src/cli/control-plane/ControlPlaneAuthBootstrap.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAKzD;;GAEG;AACH,MAAM,WAAW,sCAAsC;IACrD;;OAEG;IACH,WAAW,CAAC,EAAE,WAAW,CAAC;IAE1B,YAAY,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;CACtC;AAED;;GAEG;AACH,wBAAsB,+BAA+B,CACnD,OAAO,GAAE,sCAA2C,GACnD,OAAO,CAAC,IAAI,CAAC,CAuCf"}

package/bin/cli/control-plane/ControlPlaneAuthBootstrap.js

@@ -0,0 +1,56 @@
+/**
+ * control plane 启动阶段的本机 token 初始化辅助。
+ *
+ * 关键点（中文）
+ * - `city start` 首次启动时，如果还没有本机 CLI access token，这里负责初始化首个 token。
+ * - 新模型不再要求用户名密码登录，也不再做交互式密码提示。
+ * - 一旦本机 token 已存在，本模块直接跳过，不会重复打断启动流程。
+ * - 启动流程不再写入任何本机默认 token 状态，只显示一次明文 token。
+ */
+import { AuthService } from "../../http/auth/AuthService.js";
+import { emitCliBlock } from "../shared/CliReporter.js";
+const DEFAULT_CONTROL_PLANE_BOOTSTRAP_TOKEN_NAME = "control-plane-bootstrap";
+/**
+ * 确保平台级至少存在一个本机 access token。
+ */
+export async function ensureControlPlaneAuthBootstrap(options = {}) {
+    const authService = options.authService || new AuthService();
+    const ownsAuthService = !options.authService;
+    try {
+        if (authService.hasLocalCliAccess()) {
+            return;
+        }
+        const payload = authService.ensureLocalCliAccess({
+            tokenName: DEFAULT_CONTROL_PLANE_BOOTSTRAP_TOKEN_NAME,
+        });
+        emitCliBlock({
+            tone: "success",
+            title: "Control plane token initialized",
+            summary: payload.user.username,
+            facts: [
+                {
+                    label: "Subject",
+                    value: payload.user.username,
+                },
+                {
+                    label: "Name",
+                    value: payload.token.name,
+                },
+                {
+                    label: "Token",
+                    value: payload.token.token,
+                },
+                {
+                    label: "Next",
+                    value: "把上面的 Bearer Token 粘贴到控制面 UI / Extension",
+                },
+            ],
+            note: "明文 token 只会在本次初始化时显示一次。",
+        });
+    }
+    finally {
+        if (ownsAuthService)
+            authService.close();
+    }
+}
+//# sourceMappingURL=ControlPlaneAuthBootstrap.js.map

package/bin/cli/control-plane/ControlPlaneAuthBootstrap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ControlPlaneAuthBootstrap.js","sourceRoot":"","sources":["../../../src/cli/control-plane/ControlPlaneAuthBootstrap.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAExD,MAAM,0CAA0C,GAAG,yBAAyB,CAAC;AAc7E;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,+BAA+B,CACnD,UAAkD,EAAE;IAEpD,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,IAAI,WAAW,EAAE,CAAC;IAC7D,MAAM,eAAe,GAAG,CAAC,OAAO,CAAC,WAAW,CAAC;IAC7C,IAAI,CAAC;QACH,IAAI,WAAW,CAAC,iBAAiB,EAAE,EAAE,CAAC;YACpC,OAAO;QACT,CAAC;QAED,MAAM,OAAO,GAAG,WAAW,CAAC,oBAAoB,CAAC;YAC/C,SAAS,EAAE,0CAA0C;SACtD,CAAC,CAAC;QAEH,YAAY,CAAC;YACX,IAAI,EAAE,SAAS;YACf,KAAK,EAAE,iCAAiC;YACxC,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,QAAQ;YAC9B,KAAK,EAAE;gBACL;oBACE,KAAK,EAAE,SAAS;oBAChB,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,QAAQ;iBAC7B;gBACD;oBACE,KAAK,EAAE,MAAM;oBACb,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,IAAI;iBAC1B;gBACD;oBACE,KAAK,EAAE,OAAO;oBACd,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,KAAK;iBAC3B;gBACD;oBACE,KAAK,EAAE,MAAM;oBACb,KAAK,EAAE,yCAAyC;iBACjD;aACF;YACD,IAAI,EAAE,yBAAyB;SAChC,CAAC,CAAC;IACL,CAAC;YAAS,CAAC;QACT,IAAI,eAAe;YAAE,WAAW,CAAC,KAAK,EAAE,CAAC;IAC3C,CAAC;AACH,CAAC"}

package/bin/cli/control-plane/ControlPlaneCommand.d.ts

@@ -0,0 +1,29 @@
+/**
+ * CLI city/control-plane 命令装配。
+ *
+ * 关键点（中文）
+ * - 这里的 `console` 更接近 city gateway / control plane 的运维入口，而不是单 agent API。
+ * - 统一管理 top-level city 生命周期命令与 control plane 模块命令。
+ * - 本文件只保留命令树装配；runtime 与状态细节已拆到辅助模块。
+ */
+import { Command } from "commander";
+import { prepareForegroundAgent, ensureRegisteredAgentProjectRoot } from "./ControlPlaneProcess.js";
+/**
+ * top-level city/control-plane 命令注册参数。
+ */
+export interface ControlPlaneCommandRegistrationContext {
+    /** 当前 CLI 版本号。 */
+    version: string;
+    /** 当前 CLI 入口文件绝对路径。 */
+    cliPath: string;
+}
+/**
+ * 注册 top-level city 生命周期命令与 `console` 模块命令。
+ *
+ * 语义说明（中文）
+ * - `city ...` / `city console ...` 管的是平台控制面进程。
+ * - 单 agent 控制能力统一留在 `@downcity/agent` 暴露的 runtime / HTTP control API。
+ */
+export declare function registerControlPlaneCommands(program: Command, context: ControlPlaneCommandRegistrationContext): void;
+export { ensureRegisteredAgentProjectRoot, prepareForegroundAgent, };
+//# sourceMappingURL=ControlPlaneCommand.d.ts.map

package/bin/cli/control-plane/ControlPlaneCommand.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ControlPlaneCommand.d.ts","sourceRoot":"","sources":["../../../src/cli/control-plane/ControlPlaneCommand.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,OAAO,EAAU,MAAM,WAAW,CAAC;AAkB5C,OAAO,EACL,sBAAsB,EACtB,gCAAgC,EAKjC,MAAM,0BAA0B,CAAC;AAElC;;GAEG;AACH,MAAM,WAAW,sCAAsC;IACrD,kBAAkB;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,uBAAuB;IACvB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;GAMG;AACH,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,sCAAsC,GAC9C,IAAI,CA0JN;AAED,OAAO,EACL,gCAAgC,EAChC,sBAAsB,GACvB,CAAC"}

package/bin/cli/control-plane/ControlPlaneCommand.js

@@ -0,0 +1,152 @@
+/**
+ * CLI city/control-plane 命令装配。
+ *
+ * 关键点（中文）
+ * - 这里的 `console` 更接近 city gateway / control plane 的运维入口，而不是单 agent API。
+ * - 统一管理 top-level city 生命周期命令与 control plane 模块命令。
+ * - 本文件只保留命令树装配；runtime 与状态细节已拆到辅助模块。
+ */
+import { Option } from "commander";
+import { getControlPlaneRuntimeStatus, restartControlPlaneCommand, runControlPlaneRuntimeCommand, startControlPlaneCommand, stopControlPlaneCommand, } from "./ControlPlaneRuntime.js";
+import { registerConfigCommand } from "../shared/Config.js";
+import { registerModelCommand } from "../model/Model.js";
+import { controlPlaneInitCommand } from "./ControlPlaneInit.js";
+import { parseBoolean, parsePort, createVersionBanner } from "../shared/IndexSupport.js";
+import { CliError } from "../shared/CliError.js";
+import { updateCommand } from "../shared/Update.js";
+import { controlPlaneStatusCommand, printControlPlaneStatusPanel, } from "./ControlPlaneStatus.js";
+import { prepareForegroundAgent, ensureRegisteredAgentProjectRoot, restartCityRuntimeCommand, runCityRuntimeCommand, startCityRuntimeCommand, stopCityRuntimeCommand, } from "./ControlPlaneProcess.js";
+/**
+ * 注册 top-level city 生命周期命令与 `console` 模块命令。
+ *
+ * 语义说明（中文）
+ * - `city ...` / `city console ...` 管的是平台控制面进程。
+ * - 单 agent 控制能力统一留在 `@downcity/agent` 暴露的 runtime / HTTP control API。
+ */
+export function registerControlPlaneCommands(program, context) {
+    program
+        .command("init")
+        .description("初始化 city 全局配置（模型/插件等，写入 ~/.downcity/downcity.db）")
+        .helpOption("--help", "display help for command")
+        .action(createVersionBanner(context.version, async () => {
+        await controlPlaneInitCommand();
+    }));
+    program
+        .command("start")
+        .description("启动 city runtime；使用 -a/--all、--console 或 -p/--public 可同时启动 Console")
+        .option("-a, --all", "同时启动 Console")
+        .option("--console", "同时启动 Console")
+        .option("-p, --public [enabled]", "以公网模式启动 Console（绑定 0.0.0.0）", parseBoolean)
+        .option("-h, --host <host>", "Console 主机；传入后默认同时启动 Console")
+        .helpOption("--help", "display help for command")
+        .action(createVersionBanner(context.version, async (_options, command) => {
+        const options = command.opts();
+        const shouldStartConsole = options?.all === true ||
+            options?.console === true ||
+            options?.public === true ||
+            Boolean(String(options?.host || "").trim());
+        await startCityRuntimeCommand(context.cliPath);
+        if (shouldStartConsole) {
+            await startControlPlaneCommand({
+                options: {
+                    public: options?.public,
+                    host: options?.host,
+                },
+                cliPath: context.cliPath,
+            });
+        }
+    }));
+    program
+        .command("stop")
+        .description("停止 CITY（先停 Console，再停 city 后台与受管 agent）")
+        .helpOption("--help", "display help for command")
+        .action(createVersionBanner(context.version, async () => {
+        await stopCityRuntimeCommand();
+    }));
+    program
+        .command("restart")
+        .description("重启 CITY（重启 city 后台并恢复已运行 agent，再拉起 Console）")
+        .helpOption("--help", "display help for command")
+        .action(createVersionBanner(context.version, async () => {
+        await restartCityRuntimeCommand(context.cliPath);
+        await startControlPlaneCommand({
+            cliPath: context.cliPath,
+        });
+    }));
+    program
+        .command("status")
+        .description("查看 city 后台、Console 与已托管 agent 运行状态")
+        .helpOption("--help", "display help for command")
+        .action(createVersionBanner(context.version, async () => {
+        await controlPlaneStatusCommand();
+    }));
+    program
+        .command("update")
+        .description("更新全局 downcity CLI 到最新版本")
+        .option("--manager <manager>", "指定包管理器（npm|pnpm|auto）", "auto")
+        .helpOption("--help", "display help for command")
+        .action(createVersionBanner(context.version, async (_options, command) => {
+        const options = command.opts();
+        const manager = String(options.manager || "auto").trim().toLowerCase();
+        if (manager !== "auto" && manager !== "npm" && manager !== "pnpm") {
+            throw new CliError({
+                title: `Invalid manager: ${manager}`,
+                fix: "Use npm|pnpm|auto.",
+            });
+        }
+        await updateCommand({
+            manager: manager,
+        });
+    }));
+    program
+        .command("run", { hidden: true })
+        .description("city 内部运行时（不直接使用）")
+        .action(runCityRuntimeCommand);
+    const consoleCommand = program
+        .command("console [action]")
+        .description("管理控制面模块（命令名保留为 console；start/stop/restart/status，默认 start）")
+        .option("-p, --public [enabled]", "以公网模式启动控制面（绑定 0.0.0.0）", parseBoolean)
+        .option("-h, --host <host>", "控制面主机（默认 127.0.0.1）")
+        .addOption(new Option("--port <port>").argParser(parsePort).hideHelp())
+        .helpOption("--help", "display help for command");
+    consoleCommand
+        .action(createVersionBanner(context.version, async (action, _options, command) => {
+        const options = command.opts();
+        const resolvedAction = String(action || "start").trim().toLowerCase();
+        if (resolvedAction === "start") {
+            await startControlPlaneCommand({
+                options,
+                cliPath: context.cliPath,
+            });
+            return;
+        }
+        if (resolvedAction === "run") {
+            await runControlPlaneRuntimeCommand(options);
+            return;
+        }
+        if (resolvedAction === "stop") {
+            await stopControlPlaneCommand();
+            return;
+        }
+        if (resolvedAction === "restart") {
+            await restartControlPlaneCommand({
+                options,
+                cliPath: context.cliPath,
+            });
+            return;
+        }
+        if (resolvedAction === "status") {
+            const status = await getControlPlaneRuntimeStatus();
+            printControlPlaneStatusPanel(status);
+            return;
+        }
+        throw new CliError({
+            title: `Unknown action: ${resolvedAction}`,
+            fix: "Use start|stop|restart|status.",
+        });
+    }));
+    registerConfigCommand(program);
+    registerModelCommand(program);
+}
+export { ensureRegisteredAgentProjectRoot, prepareForegroundAgent, };
+//# sourceMappingURL=ControlPlaneCommand.js.map

package/bin/cli/control-plane/ControlPlaneCommand.js.map

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

package/bin/cli/control-plane/ControlPlaneInit.d.ts

@@ -0,0 +1,17 @@
+/**
+ * `city init`：初始化平台级默认配置（`~/.downcity/`）。
+ *
+ * 生成内容
+ * - `~/.downcity/downcity.db`：平台级全局配置存储（敏感字段加密）
+ * - `~/.downcity/schema/downcity.schema.json`：给项目 downcity.json 的 schema（可选）
+ *
+ * 关键点（中文）
+ * - city 运行时是强依赖：`city start` + `city agent start` 都会使用这里的默认配置。
+ * - 平台级配置不再使用 `~/.downcity/downcity.json` 和 `~/.downcity/.env`。
+ * - agent 项目内 `downcity.json/.env` 仍保持项目级配置职责。
+ */
+/**
+ * 平台初始化入口。
+ */
+export declare function controlPlaneInitCommand(): Promise<void>;
+//# sourceMappingURL=ControlPlaneInit.d.ts.map

package/bin/cli/control-plane/ControlPlaneInit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ControlPlaneInit.d.ts","sourceRoot":"","sources":["../../../src/cli/control-plane/ControlPlaneInit.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAYH;;GAEG;AACH,wBAAsB,uBAAuB,IAAI,OAAO,CAAC,IAAI,CAAC,CAwD7D"}

package/bin/cli/control-plane/ControlPlaneInit.js

@@ -0,0 +1,76 @@
+/**
+ * `city init`：初始化平台级默认配置（`~/.downcity/`）。
+ *
+ * 生成内容
+ * - `~/.downcity/downcity.db`：平台级全局配置存储（敏感字段加密）
+ * - `~/.downcity/schema/downcity.schema.json`：给项目 downcity.json 的 schema（可选）
+ *
+ * 关键点（中文）
+ * - city 运行时是强依赖：`city start` + `city agent start` 都会使用这里的默认配置。
+ * - 平台级配置不再使用 `~/.downcity/downcity.json` 和 `~/.downcity/.env`。
+ * - agent 项目内 `downcity.json/.env` 仍保持项目级配置职责。
+ */
+import path from "node:path";
+import fs from "fs-extra";
+import { DOWNCITY_JSON_SCHEMA } from "../../config/DowncitySchema.js";
+import { saveJson } from "../../utils/storage.js";
+import { getPlatformRootDirPath, } from "../../process/registry/CityPaths.js";
+import { PlatformStore } from "@downcity/agent";
+import { emitCliBlock, emitCliList } from "../shared/CliReporter.js";
+/**
+ * 平台初始化入口。
+ */
+export async function controlPlaneInitCommand() {
+    const operationRoot = getPlatformRootDirPath();
+    const schemaDir = path.join(operationRoot, "schema");
+    const schemaPath = path.join(schemaDir, "downcity.schema.json");
+    await fs.ensureDir(operationRoot);
+    // 写入 schema（给编辑器使用）
+    await fs.ensureDir(schemaDir);
+    await saveJson(schemaPath, DOWNCITY_JSON_SCHEMA);
+    const modelStore = new PlatformStore();
+    let existingModelsCount = 0;
+    try {
+        existingModelsCount = modelStore.listModels().length;
+        emitCliBlock({
+            tone: "success",
+            title: "Platform base initialized",
+            facts: [
+                {
+                    label: "Root",
+                    value: operationRoot,
+                },
+                {
+                    label: "Schema",
+                    value: schemaPath,
+                },
+                {
+                    label: "Existing models",
+                    value: String(existingModelsCount),
+                },
+            ],
+            note: existingModelsCount > 0
+                ? "检测到已有模型池。`city init` 不会修改模型配置。"
+                : "当前还没有模型池。你可以稍后执行 `city model create` 配置模型。",
+        });
+    }
+    finally {
+        modelStore.close();
+    }
+    emitCliBlock({
+        tone: "success",
+        title: "Platform initialized",
+        summary: "base-only",
+        note: "基础设施已初始化。下一步可执行 `city model create` 配置模型。",
+    });
+    emitCliList({
+        tone: "accent",
+        title: "Created",
+        items: [
+            { title: "encrypted platform settings" },
+            { title: "downcity schema" },
+        ],
+    });
+    // 关键点（中文）：skills 仅使用 `~/.agents/skills`，不做 built-in / claude 自动同步。
+}
+//# sourceMappingURL=ControlPlaneInit.js.map

package/bin/cli/control-plane/ControlPlaneInit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ControlPlaneInit.js","sourceRoot":"","sources":["../../../src/cli/control-plane/ControlPlaneInit.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,MAAM,UAAU,CAAC;AAC1B,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAClE,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EACL,sBAAsB,GACvB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAErE;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB;IAC3C,MAAM,aAAa,GAAG,sBAAsB,EAAE,CAAC;IAC/C,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,QAAQ,CAAC,CAAC;IACrD,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,sBAAsB,CAAC,CAAC;IAEhE,MAAM,EAAE,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC;IAElC,oBAAoB;IACpB,MAAM,EAAE,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;IAC9B,MAAM,QAAQ,CAAC,UAAU,EAAE,oBAAoB,CAAC,CAAC;IAEjD,MAAM,UAAU,GAAG,IAAI,aAAa,EAAE,CAAC;IACvC,IAAI,mBAAmB,GAAG,CAAC,CAAC;IAC5B,IAAI,CAAC;QACH,mBAAmB,GAAG,UAAU,CAAC,UAAU,EAAE,CAAC,MAAM,CAAC;QACrD,YAAY,CAAC;YACX,IAAI,EAAE,SAAS;YACf,KAAK,EAAE,2BAA2B;YAClC,KAAK,EAAE;gBACL;oBACE,KAAK,EAAE,MAAM;oBACb,KAAK,EAAE,aAAa;iBACrB;gBACD;oBACE,KAAK,EAAE,QAAQ;oBACf,KAAK,EAAE,UAAU;iBAClB;gBACD;oBACE,KAAK,EAAE,iBAAiB;oBACxB,KAAK,EAAE,MAAM,CAAC,mBAAmB,CAAC;iBACnC;aACF;YACD,IAAI,EACF,mBAAmB,GAAG,CAAC;gBACrB,CAAC,CAAC,gCAAgC;gBAClC,CAAC,CAAC,4CAA4C;SACnD,CAAC,CAAC;IACL,CAAC;YAAS,CAAC;QACT,UAAU,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;IACD,YAAY,CAAC;QACX,IAAI,EAAE,SAAS;QACf,KAAK,EAAE,sBAAsB;QAC7B,OAAO,EAAE,WAAW;QACpB,IAAI,EAAE,2CAA2C;KAClD,CAAC,CAAC;IACH,WAAW,CAAC;QACV,IAAI,EAAE,QAAQ;QACd,KAAK,EAAE,SAAS;QAChB,KAAK,EAAE;YACL,EAAE,KAAK,EAAE,6BAA6B,EAAE;YACxC,EAAE,KAAK,EAAE,iBAAiB,EAAE;SAC7B;KACF,CAAC,CAAC;IAEH,mEAAmE;AACrE,CAAC"}

package/bin/cli/control-plane/ControlPlaneProcess.d.ts

@@ -0,0 +1,61 @@
+/**
+ * ControlPlaneProcess：city gateway / control plane 命令的 runtime/进程控制辅助。
+ *
+ * 关键点（中文）
+ * - 聚合 control plane 与受管 agent 的后台进程控制逻辑。
+ * - 让 `ControlPlaneCommand` 只保留命令树装配，不再混杂大量进程细节。
+ */
+import type { ManagedAgentProcessView } from "@downcity/agent";
+import type { StartOptions } from "@downcity/agent";
+/**
+ * 启动 city runtime 后台进程。
+ */
+export declare function startCityRuntimeCommand(cliPath: string): Promise<void>;
+/**
+ * 解析 control plane 维护的“正在运行” managed agent 列表。
+ */
+export declare function resolveRunningManagedAgents(params?: {
+    /**
+     * 是否在扫描过程中回写 registry。
+     *
+     * 关键点（中文）
+     * - `status` 等纯观测命令应关闭该开关，避免只读操作因为目录不可写而失败。
+     * - stop/restart 等运维命令仍保留默认同步行为，确保 registry 最终状态收敛。
+     */
+    syncRegistry?: boolean;
+}): Promise<ManagedAgentProcessView[]>;
+/**
+ * 停止 city runtime 后台进程（先停 Console，再停受管 agent，最后停 city runtime）。
+ */
+export declare function stopCityRuntimeCommand(params?: {
+    timeoutMs?: number;
+}): Promise<void>;
+/**
+ * 重启后恢复此前仍在运行的 agent daemon。
+ */
+export declare function restartManagedAgents(cliPath: string): Promise<void>;
+/**
+ * 重启 control plane 主进程。
+ */
+export declare function restartCityRuntimeCommand(cliPath: string): Promise<void>;
+/**
+ * 执行 city runtime 常驻进程。
+ */
+export declare function runCityRuntimeCommand(): Promise<void>;
+/**
+ * 注册 `agent doctor` 对 managed agent registry 的依赖校验。
+ */
+export declare function ensureRegisteredAgentProjectRoot(cwd: string): Promise<string>;
+/**
+ * 为前台 agent 运行补齐上下文与模型绑定。
+ */
+export declare function prepareForegroundAgent(cwd: string, options: StartOptions & {
+    foreground?: boolean;
+}): Promise<{
+    projectRoot: string;
+    options: StartOptions & {
+        foreground?: boolean;
+    };
+    shouldForeground: boolean;
+}>;
+//# sourceMappingURL=ControlPlaneProcess.d.ts.map

package/bin/cli/control-plane/ControlPlaneProcess.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ControlPlaneProcess.d.ts","sourceRoot":"","sources":["../../../src/cli/control-plane/ControlPlaneProcess.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAmBH,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAgB/D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAcpD;;GAEG;AACH,wBAAsB,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAyE5E;AAED;;GAEG;AACH,wBAAsB,2BAA2B,CAAC,MAAM,CAAC,EAAE;IACzD;;;;;;OAMG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB,GAAG,OAAO,CAAC,uBAAuB,EAAE,CAAC,CA2BrC;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAAC,MAAM,CAAC,EAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAyI3F;AAqBD;;GAEG;AACH,wBAAsB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA8CzE;AAED;;GAEG;AACH,wBAAsB,yBAAyB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE9E;AAED;;GAEG;AACH,wBAAsB,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC,CAsB3D;AAuBD;;GAEG;AACH,wBAAsB,gCAAgC,CACpD,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,MAAM,CAAC,CAEjB;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAC1C,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,YAAY,GAAG;IAAE,UAAU,CAAC,EAAE,OAAO,CAAA;CAAE,GAC/C,OAAO,CAAC;IACT,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,YAAY,GAAG;QAAE,UAAU,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IACjD,gBAAgB,EAAE,OAAO,CAAC;CAC3B,CAAC,CAoCD"}