c0de-agent 1.12.0 → 1.13.0

package/dist/server/server.d.ts

@@ -6,6 +6,9 @@ import { buildRegistryFromConfig, syncRegistryFromConfig } from './registry-conf
 import type { ServerContext } from './types.js';
 type StartServerOptions = {
     port?: number;
+    /** 绑定地址（默认 127.0.0.1，仅本机可达）。显式配置非回环地址（0.0.0.0/局域网 IP）
+     *  时服务对网络可达，安全仅靠 token + allowedOrigins 保证——serve 命令会打印醒目警告。 */
+    host?: string;
     cwd?: string;
     /** 注入已有 DB（测试用）。 */
     db?: DB;
@@ -31,6 +34,9 @@ type BootstrappedServer = {
     ctx: ServerContext;
     close(): Promise<void>;
 };
+/** serve 默认端口：避开 node 生态常用端口（3000/4000/5173/8000/8080…），
+ * 降低与其他本地服务撞端口的概率。显式 --port 始终优先。 */
+export declare const DEFAULT_SERVE_PORT = 7310;
 /** 解析 PGLite 持久化数据目录：优先 C0DE_DB_DIR，否则全局数据根下 pglite 子目录。
  *
  * 历史上数据库放在 <cwd>/.c0de/pglite（项目级），但项目 DB schema 通过 projectId
@@ -71,10 +77,15 @@ declare function buildServerContext(db: DB, opts?: StartServerOptions): Promise<
 declare function acquireDevDbLock(dataDir: string): void;
 /** Release the dev DB lock (best-effort, stale-detection covers missed calls). */
 declare function releaseDevDbLock(dataDir: string): void;
+/** 读取运行中 serve 的端口（CLI 锁冲突引导用）。文件缺失/损坏 → null。 */
+declare function readServeInfo(dataDir: string): {
+    pid: number;
+    port: number;
+} | null;
 /** dev 专用：创建 + migrate PGLite，跨热重载复用（单写者，只建一次）。 */
 declare function createDevDb(cwd: string): Promise<DB>;
 /** 初始化 DB + 配置 + 注册表，返回 ServerContext + 清理函数（dev 与独立后端共用）。 */
 declare function bootstrapServerContext(opts?: StartServerOptions): Promise<BootstrappedServer>;
 declare function startServer(opts?: StartServerOptions): Promise<RunningServer>;
 export type { BootstrappedServer, RunningServer, StartServerOptions };
-export { acquireDevDbLock, bootstrapServerContext, buildRegistryFromConfig, buildServerContext, createDevDb, releaseDevDbLock, resolveAuthToken, resolveDbDir, startServer, syncRegistryFromConfig, };
+export { acquireDevDbLock, bootstrapServerContext, buildRegistryFromConfig, buildServerContext, createDevDb, readServeInfo, releaseDevDbLock, resolveAuthToken, resolveDbDir, startServer, syncRegistryFromConfig, };

package/dist/server/server.js

@@ -7,12 +7,16 @@ import { dirname, join } from 'node:path';
 import { serve } from '@hono/node-server';
 import { WebSocketServer } from 'ws';
 import { BUILTIN_AGENTS, createAgentRegistry } from '../core/agents/index.js';
-import { loadConfig } from '../core/config.js';
+import { loadConfig, loadConfigScopes } from '../core/config.js';
 import { createAndPopulateRegistry } from '../core/workflows/index.js';
 import { createDB, migrateDB } from '../db/index.js';
+import { purgeDeletedKanbanBoards } from '../kanban/index.js';
 import { initPlugins } from '../plugins/index.js';
+import { getByDirectory } from '../project/index.js';
+import { projectTrustCurrent } from '../project/trust.js';
 import { markDeadBackgroundJobs } from '../session/jobs.js';
 import { purgeDeletedSessions, purgeEmptySessions, purgeTemporarySessions, TRASH_PURGE_GRACE_MS, TRASH_RETENTION_MS, } from '../session/session.js';
+import { backfillUsageEventsOnce } from '../session/usage.js';
 import { createDefaultRegistry, createDefaultURLRegistry } from '../tools/index.js';
 import { checkForUpdate, confirmHandoff, createHandoffServer, createUpdateScheduler, requestHandoff, restoreSessions, } from '../update/index.js';
 import { createAgentManager } from './agent-manager.js';
@@ -22,6 +26,9 @@ import { isAllowedOrigin } from './middleware/cors.js';
 import { createPermissionStore } from './permission/store.js';
 import { buildRegistryFromConfig, syncRegistryFromConfig } from './registry-config.js';
 import { PTYManager } from './terminal/pty-manager.js';
+/** serve 默认端口：避开 node 生态常用端口（3000/4000/5173/8000/8080…），
+ * 降低与其他本地服务撞端口的概率。显式 --port 始终优先。 */
+export const DEFAULT_SERVE_PORT = 7310;
 /** 全局数据根目录：XDG_DATA_HOME 优先，否则 ~/.local/share/c0de。
  * 与 opencode (~/.local/share/opencode/)、oh-my-pi (~/.omp/agent/) 同约定——
  * 数据库等运行时数据放全局，项目 .c0de/ 只留配置和扩展。 */
@@ -149,23 +156,51 @@ function migrateLegacyPglite(cwd, targetDir) {
  */
 async function buildServerContext(db, opts = {}) {
     const cwd = opts.cwd ?? process.cwd();
+    // P1：快照携带的终端元信息——新实例原位重建 shell（同 id）。提前解析出来，
+    // ptyManager 创建后立即恢复；旧快照无 terminals 字段时为空。
+    let restoredTerminals = [];
     if (opts.restoreFrom) {
         const snapshot = JSON.parse(readFileSync(opts.restoreFrom, 'utf8'));
         await restoreSessions(db, snapshot);
+        restoredTerminals = Array.isArray(snapshot.terminals)
+            ? snapshot.terminals.filter((t) => !!t &&
+                typeof t.id === 'string' &&
+                typeof t.shell === 'string' &&
+                typeof t.cwd === 'string')
+            : [];
     }
     const config = await loadConfig(cwd);
     const toolRegistry = createDefaultRegistry(config);
     const llmRegistry = buildRegistryFromConfig(config);
     const urlRegistry = createDefaultURLRegistry();
+    // P0-2：项目插件只在项目被显式信任后加载（fail-closed）——克隆仓库自带的
+    // .c0de/plugins 不会在首次 serve 时静默执行；c0de trust / Web 信任后重启生效。
+    // 未注册项目（首次 serve、尚无项目记录）视为未信任。
+    // P0（代码面）：已信任但指纹漂移（git pull 改了插件代码/MCP 参数/风险键）→
+    // 同样不加载——与聊天门禁同口径，杜绝「先重启、后门禁」窗口里执行漂移代码。
+    let projectTrusted = false;
+    try {
+        const p = await getByDirectory(db, cwd);
+        if (p?.trustedAt != null) {
+            projectTrusted = projectTrustCurrent(loadConfigScopes(cwd).project, p.trustedAt, p.riskFingerprint, cwd);
+        }
+    }
+    catch {
+        // 信任状态查询失败 → 保持未信任（宁可少加载插件）
+    }
     const { pluginRegistry, hookRunner } = await initPlugins({
         cwd,
         config,
         toolRegistry,
         llmRegistry,
+        projectTrusted,
     });
     // 工作流注册表：三级发现（builtin → global → project），eager 初始化。
     // 此前是惰性 getter 只注册 builtin，导致项目级 .c0de/workflows/*.js 永远不可见。
-    const workflowRegistry = await createAndPopulateRegistry(cwd);
+    // P0 信任边界：项目级工作流与 .c0de/plugins 同为仓库自带任意代码执行面，
+    // 仅在 serve 目录项目当前可信任（projectTrusted）时 dynamic import——与上方
+    // 插件加载同口径，杜绝「克隆即执行」。
+    const workflowRegistry = await createAndPopulateRegistry(cwd, { projectTrusted });
     const dataDir = resolveDbDir();
     // 先解析/生成 bootstrap token（落盘），再创建 authManager 读取——
     // 首启时文件由 resolveAuthToken 生成，顺序颠倒会导致 bootstrap 读到空值。
@@ -179,6 +214,34 @@ async function buildServerContext(db, opts = {}) {
             ? { firstDeviceTtlMs: config.security.firstDeviceTtlMs }
             : {}),
     });
+    const ptyManager = new PTYManager();
+    // P1：热更新恢复——按快照元信息原位重建终端 shell（同 id，前端布局无感重连）。
+    // 进程内状态（运行中的 dev server 等）无法续命，但用户在熟悉的布局里得到新 shell，
+    // 且 cwd/title/shell 保持一致。恢复失败（极端环境）不阻塞启动。
+    for (const t of restoredTerminals) {
+        try {
+            ptyManager.create({
+                id: t.id,
+                shell: t.shell,
+                cwd: t.cwd,
+                title: t.title || undefined,
+                ...(t.projectId ? { projectId: t.projectId } : {}),
+            });
+            // P3-7：用户勾选的「更新后自动重启」——重建 shell 后把前台命令写入 stdin 重跑
+            // （如 `npm run dev`）。写入由 PTY 缓冲，shell 初始化完成后即执行；失败不阻塞启动。
+            if (typeof t.command === 'string' && t.command.length > 0) {
+                try {
+                    ptyManager.write(t.id, `${t.command}\n`);
+                }
+                catch (err) {
+                    console.warn(`[server] 终端命令重跑失败（${t.id}）：${err instanceof Error ? err.message : String(err)}`);
+                }
+            }
+        }
+        catch (err) {
+            console.warn(`[server] 终端恢复失败（${t.id}）：${err instanceof Error ? err.message : String(err)}`);
+        }
+    }
     const ctx = {
         db,
         config,
@@ -188,10 +251,21 @@ async function buildServerContext(db, opts = {}) {
         hookRunner,
         pluginRegistry,
         agentManager: createAgentManager(),
-        permissionStore: createPermissionStore(),
+        // P3：权限双层超时可配置（config.permission.timeoutMs/expireGraceMs）；
+        // 缺省回退 store 内置默认（5 分钟 + 25 分钟）。
+        permissionStore: createPermissionStore({
+            ...(config.permission.timeoutMs !== undefined && config.permission.timeoutMs > 0
+                ? { timeoutMs: config.permission.timeoutMs }
+                : {}),
+            ...(config.permission.expireGraceMs !== undefined && config.permission.expireGraceMs > 0
+                ? { expireGraceMs: config.permission.expireGraceMs }
+                : {}),
+        }),
         permissionMode: config.permission.defaultMode,
         sessionPermissionModes: new Map(),
         sessionAlwaysAllow: new Map(),
+        workflowBusyBySession: new Map(),
+        workflowBusyByScope: new Map(),
         authToken: resolvedToken,
         authManager: config.security.authEnabled === false ? undefined : authManager,
         // Agent 注册表：内置 4 个默认 agent；项目/用户自定义 agent 可在启动后补充加载。
@@ -209,7 +283,7 @@ async function buildServerContext(db, opts = {}) {
             initialDelayMs: config.update.initialDelayMs,
         }),
         cwd,
-        ptyManager: new PTYManager(),
+        ptyManager,
     };
     // handoff server 不在此创建：它需要持有主 HTTP server 引用以触发完整关停，
     // 由 startServer 在 serve() 之后创建（dev 模式走 vite，不创建）。
@@ -285,6 +359,49 @@ function releaseDevDbLock(dataDir) {
         /* best-effort */
     }
 }
+const SERVE_INFO_FILE = 'serve-info.json';
+/** serve 运行信息落盘（port + pid）：CLI 在锁冲突（serve 占用持久库）时读取，
+ *  引导用户直接打开 Web 界面继续对话，而不是给出无从下手的报错。不落 token。 */
+function writeServeInfo(dataDir, port) {
+    try {
+        if (!existsSync(dataDir))
+            mkdirSync(dataDir, { recursive: true });
+        writeFileSync(join(dataDir, SERVE_INFO_FILE), JSON.stringify({ pid: process.pid, port, startedAt: Date.now() }), 'utf8');
+    }
+    catch {
+        /* best-effort：仅影响 CLI 引导文案，不影响服务本身 */
+    }
+}
+/** 关闭时清除本进程写入的 serve 信息（pid 匹配才删，防止误删热更新新实例的信息）。 */
+function removeServeInfo(dataDir) {
+    try {
+        const path = join(dataDir, SERVE_INFO_FILE);
+        if (!existsSync(path))
+            return;
+        const parsed = JSON.parse(readFileSync(path, 'utf-8'));
+        if (parsed.pid === process.pid)
+            unlinkSync(path);
+    }
+    catch {
+        /* best-effort */
+    }
+}
+/** 读取运行中 serve 的端口（CLI 锁冲突引导用）。文件缺失/损坏 → null。 */
+function readServeInfo(dataDir) {
+    try {
+        const path = join(dataDir, SERVE_INFO_FILE);
+        if (!existsSync(path))
+            return null;
+        const parsed = JSON.parse(readFileSync(path, 'utf-8'));
+        if (typeof parsed.pid === 'number' && typeof parsed.port === 'number') {
+            return { pid: parsed.pid, port: parsed.port };
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
 /** dev 专用：创建 + migrate PGLite，跨热重载复用（单写者，只建一次）。 */
 async function createDevDb(cwd) {
     const dataDir = resolveDbDir();
@@ -329,6 +446,17 @@ async function bootstrapServerContext(opts = {}) {
         db = await createDevDb(cwd);
     }
     const { ctx, dispose } = await buildServerContext(db, opts);
+    // P2 成本账本 backfill：升级后首次启动把遗留 segments 补齐进 usage_events
+    // （幂等，callId 唯一约束去重；app_meta 标记保证只执行一次——导入会话的
+    // segments 已剥离 call id，不产生账本行）。fire-and-forget。
+    void backfillUsageEventsOnce(db)
+        .then((added) => {
+        if (added > 0)
+            console.log(`[server] 成本账本补齐：新增 ${added} 条历史调用记录`);
+    })
+        .catch((err) => {
+        console.warn(`[server] 成本账本补齐失败：${err instanceof Error ? err.message : String(err)}`);
+    });
     // P2-4 + A3：回收站两阶段清理——启动时清一次 + 每 24h 清一次。
     // 阶段一标记到期条目进入宽限期（UI 可见可恢复），阶段二物理清除宽限期满的条目。
     // fire-and-forget：清理失败不阻塞服务启动；结果落日志可查。
@@ -343,6 +471,18 @@ async function bootstrapServerContext(opts = {}) {
             }
         })
             .catch(() => { });
+        // P2-5：回收站看板两阶段清理（与会话回收站同策略：到期先标记宽限，期满再物理清除，
+        // 杜绝「到期即静默清空」）。
+        void purgeDeletedKanbanBoards(db, TRASH_RETENTION_MS, TRASH_PURGE_GRACE_MS)
+            .then(({ marked, deleted }) => {
+            if (marked > 0) {
+                console.log(`[server] 回收站清理：${marked} 个看板已到期，进入 ${TRASH_PURGE_GRACE_MS / (24 * 60 * 60 * 1000)} 天宽限期（期间可恢复）`);
+            }
+            if (deleted > 0) {
+                console.log(`[server] 回收站清理：已物理清除 ${deleted} 个超过宽限期的看板`);
+            }
+        })
+            .catch(() => { });
     };
     runTrashPurge();
     const purgeTimer = setInterval(() => {
@@ -476,7 +616,10 @@ function attachTerminalUpgrade(ctx, wss, server) {
     });
 }
 async function startServer(opts = {}) {
-    const port = opts.port ?? 3000;
+    const port = opts.port ?? DEFAULT_SERVE_PORT;
+    // 默认仅绑定回环地址（安全默认：本地工具不应默认暴露局域网/公网）。
+    // 需要容器/远程访问时显式 --host 0.0.0.0（serve 命令会打印非回环警告）。
+    const host = opts.host ?? '127.0.0.1';
     // spec §18.3：新实例从 --handoff-port 拿到旧实例端口，请求优雅退出后绑端口。
     // 握手 token：updater spawn 时经 C0DE_AUTH_TOKEN 环境变量传入，否则读 auth-token 文件。
     if (opts.handoffPort && !opts.skipHandoff) {
@@ -508,8 +651,10 @@ async function startServer(opts = {}) {
         // config.update.enabled 时启动后台调度器。
         if (ctx.config.update.enabled)
             ctx.updateScheduler.start();
-        const server = serve({ fetch: app.fetch, port });
+        const server = serve({ fetch: app.fetch, port, hostname: host });
         ctx.port = port;
+        ctx.host = host;
+        writeServeInfo(resolveDbDir(), port);
         // WebSocket：终端双向流。Hono v2 无原生 WS，用 ws 包直接挂载到 HTTP server。
         const wss = new WebSocketServer({ noServer: true });
         attachTerminalUpgrade(ctx, wss, server);
@@ -520,6 +665,7 @@ async function startServer(opts = {}) {
             closed = true;
             wss.close();
             server.close();
+            removeServeInfo(resolveDbDir());
             await closeCtx();
         };
         const close = async () => {
@@ -536,7 +682,40 @@ async function startServer(opts = {}) {
         // config.update.enabled=false 或 skipHandoff 时跳过。
         if (ctx.config.update.enabled && !opts.skipHandoff) {
             const createHandoff = opts.createHandoffFn ?? createHandoffServer;
-            handoffServer = await createHandoff(closeMain, {
+            // P0 修复：确认窗口必须在「收到 POST /handoff（交接开始）」时才启动，
+            // 而非 bringUp 时无条件启动——否则任何运行超过 HANDOFF_CONFIRM_WINDOW_MS
+            // 的普通实例都会在窗口超时后误判「新实例未确认」，重新 bringUp 时第二
+            // listen 触发 EADDRINUSE（unhandled 'error'）崩溃。窗口从交接实际发生起算。
+            const armConfirmWindow = () => {
+                clearConfirmTimer();
+                confirmTimer = setTimeout(() => {
+                    void (async () => {
+                        if (reviving)
+                            return;
+                        reviving = true;
+                        try {
+                            await bringUp();
+                            console.warn('[handoff] 新实例未确认接管，旧实例已复活并重新接管端口');
+                        }
+                        catch (err) {
+                            if (err.code === 'EADDRINUSE') {
+                                // 新实例已绑定端口（确认请求丢失）→ 它已接管，旧实例正常退出。
+                                console.warn('[handoff] 端口已被新实例接管，旧实例退出');
+                                process.exit(0);
+                            }
+                            console.error('[handoff] 旧实例复活失败，退出：', err);
+                            process.exit(1);
+                        }
+                        finally {
+                            reviving = false;
+                        }
+                    })();
+                }, HANDOFF_CONFIRM_WINDOW_MS);
+            };
+            handoffServer = await createHandoff(async () => {
+                await closeMain();
+                armConfirmWindow();
+            }, {
                 // P2-16：token 轮换后新旧实例 bootstrap 可能不同，用 verifyHandoff 接受
                 // 当前/历史 bootstrap 与设备 token；无 authManager 回退字符串比较。
                 ...(ctx.authManager
@@ -550,30 +729,6 @@ async function startServer(opts = {}) {
                 },
             });
             ctx.handoff = { port: handoffServer.port, server: handoffServer };
-            // 确认窗口：新实例启动失败时旧实例复活（保留进程句柄，定时器不可 unref）。
-            confirmTimer = setTimeout(() => {
-                void (async () => {
-                    if (reviving)
-                        return;
-                    reviving = true;
-                    try {
-                        await bringUp();
-                        console.warn('[handoff] 新实例未确认接管，旧实例已复活并重新接管端口');
-                    }
-                    catch (err) {
-                        if (err.code === 'EADDRINUSE') {
-                            // 新实例已绑定端口（确认请求丢失）→ 它已接管，旧实例正常退出。
-                            console.warn('[handoff] 端口已被新实例接管，旧实例退出');
-                            process.exit(0);
-                        }
-                        console.error('[handoff] 旧实例复活失败，退出：', err);
-                        process.exit(1);
-                    }
-                    finally {
-                        reviving = false;
-                    }
-                })();
-            }, HANDOFF_CONFIRM_WINDOW_MS);
         }
         // 两阶段交接第二阶段：新实例绑定成功后确认旧实例可退出。
         // 旧实例（无 handoffPort）跳过；确认失败静默（窗口超时兜底）。
@@ -591,9 +746,15 @@ async function startServer(opts = {}) {
         close: async () => {
             await currentClose?.();
         },
-        ...(currentAuthToken ? { authToken: currentAuthToken } : {}),
+        // P：仅「首设备待注册」时回传 bootstrap 供 serve 命令拼 ?token= 注册 URL。
+        // 已有已注册设备时 auth-token 文件里是注册后被轮换的旧值——带进 URL 会让新浏览器
+        // 误点「注册链接」却得到 BOOTSTRAP_CONSUMED 引导配对（横幅文案误导）。此时不携带，
+        // serve 打印无 token 的 URL，新浏览器自然走配对流程。
+        ...(currentAuthToken && !hasRegisteredDevices(resolveDbDir())
+            ? { authToken: currentAuthToken }
+            : {}),
     };
 }
 // P1-1：buildRegistryFromConfig/syncRegistryFromConfig 实现移入 registry-config.ts，
 // 此处 re-export 保留 server.ts 历史导出兼容（测试/CLI 引用）。
-export { acquireDevDbLock, bootstrapServerContext, buildRegistryFromConfig, buildServerContext, createDevDb, releaseDevDbLock, resolveAuthToken, resolveDbDir, startServer, syncRegistryFromConfig, };
+export { acquireDevDbLock, bootstrapServerContext, buildRegistryFromConfig, buildServerContext, createDevDb, readServeInfo, releaseDevDbLock, resolveAuthToken, resolveDbDir, startServer, syncRegistryFromConfig, };

package/dist/server/terminal/pty-manager.d.ts

@@ -21,6 +21,8 @@ export interface CreatePTYOptions {
     shell?: string;
     /** 所属项目 id。 */
     projectId?: string;
+    /** 指定 PTY id（热更新快照恢复时沿用原 id，前端布局无感重连）。 */
+    id?: string;
 }
 /**
  * 检测当前平台默认 shell。
@@ -32,6 +34,16 @@ export interface CreatePTYOptions {
  * /etc/passwd（getpwuid），是用户真实登录 shell 的可靠来源。
  */
 export declare function detectShell(): string;
+/** 把 argv 拼回可安全经 shell 重放的命令行（导出便于单测安全转义）。 */
+export declare function argvToCommand(argv: string[]): string;
+/**
+ * 尽力捕获 shell 当前前台命令（Linux 专有，最佳努力）——热更新后可选自动重跑。
+ * 读取 /proc/<shellPid>/task/<shellPid>/children：
+ *   - 恰好 1 个直接子进程 → 返回其 cmdline（如 `npm run dev`）。
+ *   - 0 个 / 多个（后台任务、管道、子 shell）→ 返回 null（不猜，回退默认不重跑）。
+ * 非 Linux 平台或任何读取异常 → null（能力不可用，优雅降级）。
+ */
+export declare function captureForegroundCommand(shellPid: number): string | null;
 /**
  * PTY 生命周期管理器。
  *

package/dist/server/terminal/pty-manager.js

@@ -1,6 +1,6 @@
 // src/server/terminal/pty-manager.ts
 import { randomUUID } from 'node:crypto';
-import { mkdirSync, rmSync, unlinkSync, writeFileSync } from 'node:fs';
+import { mkdirSync, readFileSync, rmSync, unlinkSync, writeFileSync } from 'node:fs';
 import { tmpdir, userInfo } from 'node:os';
 import { basename, join } from 'node:path';
 import { spawn } from 'node-pty';
@@ -86,6 +86,10 @@ export function detectShell() {
 }
 const DEFAULT_COLS = 80;
 const DEFAULT_ROWS = 24;
+/** P3-13：cols/rows 上限钳制——路由层只查 Number.isFinite，负值/超大值直接进
+ *  spawn 可能打爆 node-pty 缓冲区或 UI 布局。 */
+const MAX_COLS = 1000;
+const MAX_ROWS = 500;
 const MAX_TITLE_LEN = 100;
 /** scrollback 环形缓冲最大字节数（约 50KB）。 */
 const SCROLLBACK_MAX = 50_000;
@@ -93,6 +97,41 @@ function truncateTitle(title) {
     const clean = title.replace(/[\r\n]/g, ' ').trim();
     return clean.length > MAX_TITLE_LEN ? `${clean.slice(0, MAX_TITLE_LEN)}…` : clean;
 }
+/** POSIX 单引号转义：仅安全字符（字母数字与常见路径/别名符号）原样，否则单引号包裹。 */
+function shellQuote(arg) {
+    if (/^[A-Za-z0-9_./:,+@%=-]+$/.test(arg))
+        return arg;
+    return `'${arg.replace(/'/g, `'\\''`)}'`;
+}
+/** 把 argv 拼回可安全经 shell 重放的命令行（导出便于单测安全转义）。 */
+export function argvToCommand(argv) {
+    return argv.map(shellQuote).join(' ');
+}
+/**
+ * 尽力捕获 shell 当前前台命令（Linux 专有，最佳努力）——热更新后可选自动重跑。
+ * 读取 /proc/<shellPid>/task/<shellPid>/children：
+ *   - 恰好 1 个直接子进程 → 返回其 cmdline（如 `npm run dev`）。
+ *   - 0 个 / 多个（后台任务、管道、子 shell）→ 返回 null（不猜，回退默认不重跑）。
+ * 非 Linux 平台或任何读取异常 → null（能力不可用，优雅降级）。
+ */
+export function captureForegroundCommand(shellPid) {
+    if (process.platform !== 'linux')
+        return null;
+    try {
+        const childrenRaw = readFileSync(`/proc/${shellPid}/task/${shellPid}/children`, 'utf8');
+        const children = childrenRaw.trim().split(/\s+/).filter(Boolean).map(Number);
+        if (children.length !== 1)
+            return null;
+        const cmdline = readFileSync(`/proc/${children[0]}/cmdline`, 'utf8');
+        const argv = cmdline.split('\0').filter((s) => s.length > 0);
+        if (argv.length === 0)
+            return null;
+        return argvToCommand(argv);
+    }
+    catch {
+        return null;
+    }
+}
 /**
  * PTY 生命周期管理器。
  *
@@ -104,9 +143,15 @@ export class PTYManager {
     entries = new Map();
     /** 创建新 PTY 会话。 */
     create(opts) {
-        const id = `pty_${randomUUID()}`;
-        const cols = opts.cols ?? DEFAULT_COLS;
-        const rows = opts.rows ?? DEFAULT_ROWS;
+        const id = opts.id ?? `pty_${randomUUID()}`;
+        // 指定 id 已存在（重复 restore 快照）→ 返回既有条目，避免泄漏/覆盖进程。
+        const existing = this.entries.get(id);
+        if (existing)
+            return existing.info;
+        // P3-13：钳制到 [1, MAX]——负值/超大值不进入 spawn。
+        const clampDim = (v, dflt, max) => Math.min(max, Math.max(1, Number.isFinite(v) ? v : dflt));
+        const cols = clampDim(opts.cols, DEFAULT_COLS, MAX_COLS);
+        const rows = clampDim(opts.rows, DEFAULT_ROWS, MAX_ROWS);
         const shell = opts.shell ?? detectShell();
         const integration = setupShellIntegration(shell);
         const pty = spawn(shell, integration.spawnArgs, {
@@ -158,6 +203,14 @@ export class PTYManager {
                     ws.close(1000, 'pty exited');
                 }
             }
+            // P3-12 修复：自然退出同样清理 shell 注入脚本/目录（bash --init-file、
+            // zsh ZDOTDIR 临时文件）——此前仅 kill() 清理，自然退出残留 /tmp。
+            try {
+                entry.integrationCleanup?.();
+            }
+            catch {
+                // 清理失败不影响退出流程
+            }
             this.entries.delete(id);
         });
         this.entries.set(id, entry);
@@ -175,9 +228,12 @@ export class PTYManager {
         const entry = this.entries.get(id);
         if (!entry)
             throw new Error(`PTY not found: ${id}`);
-        entry.pty.resize(Math.max(1, cols), Math.max(1, rows));
-        entry.info.cols = cols;
-        entry.info.rows = rows;
+        // P3-13：与 create 同口径钳制
+        const c = Math.min(MAX_COLS, Math.max(1, cols));
+        const r = Math.min(MAX_ROWS, Math.max(1, rows));
+        entry.pty.resize(c, r);
+        entry.info.cols = c;
+        entry.info.rows = r;
     }
     /** 更新 PTY 标题。 */
     setTitle(id, title) {

package/dist/server/types.d.ts

@@ -46,6 +46,8 @@ type ServerContext = {
     authManager?: AuthManager;
     /** 主 HTTP 服务实际绑定端口（startServer 绑定后回填；热更新 spawn 新实例复用）。 */
     port?: number;
+    /** 主 HTTP 服务绑定地址（startServer 回填；热更新 spawn 新实例须复用同一地址）。 */
+    host?: string;
     /** P1-1：项目级 LLM 注册表缓存 Map<projectId, Registry>——按项目合并配置
      *  （global + 项目 .c0de/config.json 的 providers）构建，会话聊天按所属项目
      *  解析路由。项目配置 PATCH 后失效重建。 */
@@ -54,6 +56,13 @@ type ServerContext = {
     agentRegistry: AgentRegistry;
     /** 工作流注册表（spec: dynamic-workflow-design）。注入 /workflow slash 命令和 workflowz steering。 */
     workflowRegistry?: import('../core/workflows/registry.js').WorkflowRegistry;
+    /** 工作流运行占用：发起会话 id → 工作流会话 id（/workflow run 通道）。
+     *  发起会话在其工作流运行期间视为占用——主 run 与再次 /workflow run 均 409；
+     *  abort/pause/resume 控制端点据此路由到实际的工作流 run。 */
+    workflowBusyBySession: Map<string, string>;
+    /** 工作流运行占用：执行作用域键 → 工作流会话 id。键为 `project:<projectId>`
+     *  或 `dir:<cwd>`（REST 无 projectId 时）。同一项目/目录不允许并发工作流执行。 */
+    workflowBusyByScope: Map<string, string>;
     /** 后台版本检查调度器（spec §18.1）；/api/update 读取其缓存结果。 */
     updateScheduler: UpdateScheduler;
     /** Handoff HTTP 端点（spec §18.3）；热更新时新实例 POST /handoff 触发优雅退出。 undefined 表示未启用。 */

package/dist/session/branch.d.ts

@@ -14,7 +14,8 @@ declare function forkSession(handle: DB, sessionId: string, messageIndex: number
 declare function getBranches(handle: DB, sessionId: string): Promise<Session[]>;
 /** Build a full session tree from root sessions down.
  * 每层按 metadata.lastOpenedAt 降序（fallback updatedAt、createdAt）。
- * 排除软删除会话与 CLI 来源会话（Web 树仅展示 web 会话）。
+ * 排除软删除会话与临时 CLI 会话（print/workflow）；持久化 CLI 会话（--continue 续接）
+ * 与 Web 会话同树可见（CLI/Web 同库不同视图 → 同库同视图）。
  */
 declare function getTree(handle: DB): Promise<SessionTreeNode[]>;
 export { BranchPointOutOfRangeError, forkSession, getBranches, getTree };