c0de-agent 1.13.0 → 1.14.0

package/dist/update/snapshot.js

@@ -1,3 +1,4 @@
+import { eq } from 'drizzle-orm';
 import { sessionEntries, sessions } from '../db/schema.js';
 const CURRENT_SNAPSHOT_VERSION = '0.1.0';
 function toDateMs(v) {
@@ -36,24 +37,6 @@ function toSerializedEntry(row) {
         createdAt: toDateMs(row.createdAt),
     };
 }
-/** 按 parentId 拓扑序排列 sessions，使父会话先于子会话插入（满足自引用 FK）。 */
-function orderSessionsByParent(list) {
-    const byId = new Map(list.map((s) => [s.id, s]));
-    const ordered = [];
-    const seen = new Set();
-    const visit = (s) => {
-        if (seen.has(s.id))
-            return;
-        const parent = s.parentId ? byId.get(s.parentId) : undefined;
-        if (parent && !seen.has(parent.id))
-            visit(parent);
-        seen.add(s.id);
-        ordered.push(s);
-    };
-    for (const s of list)
-        visit(s);
-    return ordered;
-}
 /** 从 DB 导出所有会话与条目为可序列化快照。terminals 为活跃终端元信息（可选）。 */
 async function serializeSessions(handle, config, terminals) {
     const [sRows, eRows] = await Promise.all([
@@ -69,15 +52,27 @@ async function serializeSessions(handle, config, terminals) {
         ...(terminals && terminals.length > 0 ? { terminals } : {}),
     };
 }
-/** 把快照导入 DB（保留原始 id 与时间戳；父会话先插入以满足 FK）。 */
+/**
+ * 把快照导入 DB（保留原始 id 与时间戳），两阶段插入：
+ *  1. 全部会话行以 parentId=NULL 插入——任何插入顺序都满足自引用 FK，
+ *     无需拓扑排序；
+ *  2. 回填各行的 parentId——此时全部行已存在，FK 恒可满足。
+ *
+ * 此前按拓扑序逐个插入（orderSessionsByParent 先父后子）：环防护只保证
+ * 「终止」——parentId 成环（a↔b 互指/自引用）时环上第一个被访问的节点先于
+ * 其父入序，插入它即撞自引用 FK 23503（其父行尚不存在），整个恢复抛错、
+ * serve 启动失败。两阶段插入对任意形状（环/自引用/正常森林）都成立，
+ * 环上节点父指针完整保留；悬空 parentId（快照外引用）在第二阶段撞 FK，
+ * 仍是「数据损坏显式失败」而非静默改写。
+ */
 async function restoreSessions(handle, snapshot) {
-    for (const s of orderSessionsByParent(snapshot.sessions)) {
+    for (const s of snapshot.sessions) {
         await handle.db
             .insert(sessions)
             .values({
             id: s.id,
             title: s.title,
-            parentId: s.parentId,
+            parentId: null,
             projectId: s.projectId,
             branchPoint: s.branchPoint,
             metadata: s.metadata,
@@ -91,6 +86,11 @@ async function restoreSessions(handle, snapshot) {
         })
             .onConflictDoNothing();
     }
+    for (const s of snapshot.sessions) {
+        if (s.parentId === null)
+            continue;
+        await handle.db.update(sessions).set({ parentId: s.parentId }).where(eq(sessions.id, s.id));
+    }
     for (const e of snapshot.entries) {
         await handle.db
             .insert(sessionEntries)
@@ -107,4 +107,4 @@ async function restoreSessions(handle, snapshot) {
             .onConflictDoNothing();
     }
 }
-export { orderSessionsByParent, restoreSessions, serializeSessions };
+export { restoreSessions, serializeSessions };

package/dist/update/updater.d.ts

@@ -77,6 +77,19 @@ type InstallMethod = {
 declare function detectInstallMethod(): InstallMethod;
 /** 手动安装提示命令（unknown 安装方式时返回给前端展示）。 */
 declare function manualInstallCommand(pkg: string): string;
+/** 当前执行程序文件的 stat 指纹（size+mtimeMs）。 */
+type FileStatFingerprint = {
+    size: number;
+    mtimeMs: number;
+};
+/**
+ * watch 当前执行程序文件（argv[1] 及其 realpath 所在目录）变更。
+ * 返回 Promise：文件内容变更（size/mtime 变化）后 resolve。
+ * 采用目录 fs.watch + 1s 轮询 stat 双保险（npm 原子替换文件时 watch 事件可能丢失）。
+ * baseline 由调用方在「变更发生前」采集（安装前），否则安装已改写文件导致永远等不到变化。
+ * 超时（timeoutMs）或可注入的 cancel 信号触发时 reject。
+ */
+declare function waitForProgramChange(timeoutMs: number, baseline: Map<string, FileStatFingerprint | null>, signal?: AbortSignal, pollMs?: number): Promise<void>;
 /**
  * 分阶段热更新的第二阶段（P0 修复：install 与 pause 解耦）。
  *
@@ -109,7 +122,8 @@ declare function performHotUpdate(snapshot: SessionSnapshot, opts?: HotUpdateOpt
  * 运行中的 serve 由 `/api/update/apply` 走 performHotUpdate 热更新路径。
  */
 declare function performInstall(opts?: HotUpdateOptions): Promise<InstallOnlyResult>;
-/** 清理快照临时目录（热更新完成或放弃后调用）。 */
+/** 清理快照：仅当路径位于 writeSnapshot 创建的自有临时目录时整目录删除；
+ *  否则（调用方指定的路径）只删除快照文件本身，绝不递归删除父目录。 */
 declare function cleanupSnapshot(snapshotPath: string): Promise<void>;
 export type { HotUpdateOptions, HotUpdateResult, InstallMethod, InstallOnlyResult, SpawnFn };
-export { cleanupSnapshot, detectInstallMethod, manualInstallCommand, performHandoff, performHotUpdate, performInstall, };
+export { cleanupSnapshot, detectInstallMethod, manualInstallCommand, performHandoff, performHotUpdate, performInstall, waitForProgramChange, };

package/dist/update/updater.js

@@ -3,8 +3,14 @@ import { realpathSync, statSync, watch } from 'node:fs';
 import { mkdtemp, rm, writeFile } from 'node:fs/promises';
 import { tmpdir } from 'node:os';
 import { basename, dirname, join } from 'node:path';
+import { clampTimerDelay } from '../shared/timer.js';
 const DEFAULT_PACKAGE = 'c0de-agent';
 const DEFAULT_MANUAL_WAIT_TIMEOUT_MS = 10 * 60 * 1000;
+/** writeSnapshot 经 mkdtemp 创建、归本模块所有的临时目录。
+ *  清理快照时只有这些目录允许整目录递归删除——调用方指定的 snapshotPath
+ *  只删文件本身，绝不删除其父目录（此前 rm(join(path,'..'), recursive) 对
+ *  任意调用方路径都会递归删除整个父目录，同目录下的无关文件一并蒸发）。 */
+const ownedSnapshotDirs = new Set();
 /**
  * 识别当前进程的安装方式：
  * - 入口脚本 realpath 含 node_modules/.pnpm → pnpm
@@ -40,11 +46,13 @@ function defaultInstall(pkg, method) {
         const args = method.kind === 'pnpm' ? ['add', '-g', pkg] : ['install', '-g', pkg];
         const child = spawn(cmd, args, { stdio: 'ignore' });
         child.on('error', reject);
-        child.on('exit', (code) => {
+        child.on('exit', (code, signal) => {
             if (code === 0)
                 resolve();
+            // 信号终止时 code 为 null（真实信号在 signal）——直接插值 code 会报
+            // 「exited with null」，用户无法区分「包管理器自杀」与「内部错误」。
             else
-                reject(new Error(`${cmd} ${args.join(' ')} exited with ${code}`));
+                reject(new Error(`${cmd} ${args.join(' ')} ${signal !== null ? `killed by signal ${signal}` : `exited with ${code}`}`));
         });
     });
 }
@@ -103,10 +111,17 @@ function waitForProgramChange(timeoutMs, baseline, signal, pollMs = 1000) {
         let timer = null;
         let interval = null;
         const watchers = [];
+        // 监听器必须在终结处显式摘除：{ once: true } 只在「真的触发 abort」时
+        // 自动摘除——变更检测/超时终结的调用（绝大多数）从不触发 abort，残留
+        // 监听器在长生命周期信号复用场景下累积（第 11 个即触发 Node 的
+        // MaxListenersExceededWarning），闭包也随信号长期滞留（同型：executor/
+        // bash/permission checker 均已改为终结清理口径）。
+        const onAbort = () => finish(() => reject(new Error('waiting aborted')));
         const finish = (fn) => {
             if (settled)
                 return;
             settled = true;
+            signal?.removeEventListener('abort', onAbort);
             if (timer)
                 clearTimeout(timer);
             if (interval)
@@ -129,7 +144,6 @@ function waitForProgramChange(timeoutMs, baseline, signal, pollMs = 1000) {
             }
             return false;
         };
-        const onAbort = () => finish(() => reject(new Error('waiting aborted')));
         signal?.addEventListener('abort', onAbort, { once: true });
         timer = setTimeout(() => finish(() => reject(new Error('等待程序文件变更超时'))), timeoutMs);
         interval = setInterval(() => {
@@ -190,7 +204,15 @@ function buildSpawnArgv(snapshotPath, opts) {
  * 独立成函数供 performHotUpdate（一体流程）与 performHandoff（分阶段流程）共用。
  */
 async function writeSnapshot(snapshot, opts) {
-    const snapshotPath = opts.snapshotPath ?? join(await mkdtemp(join(tmpdir(), 'c0de-update-')), 'snapshot.json');
+    if (opts.snapshotPath) {
+        await writeFile(opts.snapshotPath, JSON.stringify(snapshot), 'utf8');
+        return opts.snapshotPath;
+    }
+    // 仅 mkdtemp 创建的目录归本模块所有（可整目录清理）；调用方指定的路径
+    // 所有权在调用方，清理时只能删文件本身，绝不触碰其所在目录。
+    const dir = await mkdtemp(join(tmpdir(), 'c0de-update-'));
+    ownedSnapshotDirs.add(dir);
+    const snapshotPath = join(dir, 'snapshot.json');
     await writeFile(snapshotPath, JSON.stringify(snapshot), 'utf8');
     return snapshotPath;
 }
@@ -275,7 +297,9 @@ async function performHotUpdate(snapshot, opts = {}) {
             };
         }
         try {
-            await waitForProgramChange(opts.manualWaitTimeoutMs ?? DEFAULT_MANUAL_WAIT_TIMEOUT_MS, baseline);
+            // manualWaitTimeoutMs 是调用方（CLI/宿主）可传的公开选项：非法/超 32 位
+            // 上限的时长会被 Node 钳到 1ms——「等 10 分钟」变「立刻放弃等待」。
+            await waitForProgramChange(clampTimerDelay(opts.manualWaitTimeoutMs, DEFAULT_MANUAL_WAIT_TIMEOUT_MS, 1), baseline);
         }
         catch (error) {
             return {
@@ -316,8 +340,15 @@ async function performInstall(opts = {}) {
     }
     return { _tag: 'success', installMethod: method.kind };
 }
-/** 清理快照临时目录（热更新完成或放弃后调用）。 */
+/** 清理快照：仅当路径位于 writeSnapshot 创建的自有临时目录时整目录删除；
+ *  否则（调用方指定的路径）只删除快照文件本身，绝不递归删除父目录。 */
 async function cleanupSnapshot(snapshotPath) {
-    await rm(join(snapshotPath, '..'), { recursive: true, force: true }).catch(() => { });
+    const dir = dirname(snapshotPath);
+    if (ownedSnapshotDirs.has(dir)) {
+        ownedSnapshotDirs.delete(dir);
+        await rm(dir, { recursive: true, force: true }).catch(() => { });
+        return;
+    }
+    await rm(snapshotPath, { force: true }).catch(() => { });
 }
-export { cleanupSnapshot, detectInstallMethod, manualInstallCommand, performHandoff, performHotUpdate, performInstall, };
+export { cleanupSnapshot, detectInstallMethod, manualInstallCommand, performHandoff, performHotUpdate, performInstall, waitForProgramChange, };

package/dist/update/version.d.ts

@@ -18,7 +18,9 @@ type CheckOptions = {
  * src/dev 与 dist 两种布局下 `../../package.json` 都指向包根；读取失败回退常量。
  */
 declare function getCurrentVersion(): string;
-/** 语义化版本比较：a < b → -1，a == b → 0，a > b → 1。忽略前导 v 和 prerelease。 */
+/** 语义化版本比较：a < b → -1，a == b → 0，a > b → 1。
+ *  前导 v 与 build metadata 忽略；prerelease 低于同 core 的正式版。
+ *  无法解析的版本保守返回 0（不误报更新）。 */
 declare function compareSemver(a: string, b: string): number;
 /** 查询 npm registry 判断是否有新版本。网络/解析失败时返回 hasUpdate:false，绝不抛错。 */
 declare function checkForUpdate(opts?: CheckOptions): Promise<UpdateCheckResult>;

package/dist/update/version.js

@@ -17,23 +17,77 @@ function getCurrentVersion() {
     }
     return DEFAULT_VERSION;
 }
-/** 取 semver 的数值核心（去前导 v 与 prerelease）。 */
-function semverCore(v) {
-    return (v.replace(/^v/, '').split('-')[0] ?? '').split('.').map(Number);
+/** 解析 semver：core（X.Y.Z 数值数组）+ prerelease 标识符数组。
+ *  前导 v 与 build metadata（+ 后缀）剥离；core 非「三个十进制非负整数」返回 null。
+ *  此前只取 split('-')[0]：prerelease 被静默丢弃（beta 与正式版判相等、beta 间
+ *  不分先后），且 '1.2.3+build' 的 patch 位解析为 NaN——NaN 参与比较恒返回 0，
+ *  带 build metadata 的版本与任何版本判相等、永不提示更新。 */
+function parseSemver(v) {
+    const cleaned = v.trim().replace(/^v/, '');
+    const noBuild = cleaned.replace(/\+.*$/, '');
+    const dash = noBuild.indexOf('-');
+    const coreStr = dash === -1 ? noBuild : noBuild.slice(0, dash);
+    const coreParts = coreStr.split('.');
+    if (coreParts.length !== 3 || coreParts.some((p) => !/^\d+$/.test(p)))
+        return null;
+    return {
+        core: coreParts.map(Number),
+        prerelease: dash === -1 ? [] : noBuild.slice(dash + 1).split('.'),
+    };
 }
-/** 语义化版本比较：a < b → -1，a == b → 0，a > b → 1。忽略前导 v 和 prerelease。 */
+/**
+ * 比较 prerelease 标识符（semver §11 优先级规则）：
+ * 数字标识符按数值、非数字按字典序，数字恒小于非数字；更短前缀为更小。
+ */
+function comparePrerelease(a, b) {
+    for (let i = 0; i < Math.max(a.length, b.length); i++) {
+        const x = a[i];
+        const y = b[i];
+        if (x === undefined)
+            return -1;
+        if (y === undefined)
+            return 1;
+        const xNum = /^\d+$/.test(x) ? Number(x) : null;
+        const yNum = /^\d+$/.test(y) ? Number(y) : null;
+        if (xNum !== null && yNum !== null) {
+            if (xNum !== yNum)
+                return xNum < yNum ? -1 : 1;
+        }
+        else if (xNum !== null) {
+            return -1;
+        }
+        else if (yNum !== null) {
+            return 1;
+        }
+        else if (x !== y) {
+            return x < y ? -1 : 1;
+        }
+    }
+    return 0;
+}
+/** 语义化版本比较：a < b → -1，a == b → 0，a > b → 1。
+ *  前导 v 与 build metadata 忽略；prerelease 低于同 core 的正式版。
+ *  无法解析的版本保守返回 0（不误报更新）。 */
 function compareSemver(a, b) {
-    const pa = semverCore(a);
-    const pb = semverCore(b);
+    const pa = parseSemver(a);
+    const pb = parseSemver(b);
+    if (!pa || !pb)
+        return 0;
     for (let i = 0; i < 3; i++) {
-        const x = pa[i] ?? 0;
-        const y = pb[i] ?? 0;
+        const x = pa.core[i] ?? 0;
+        const y = pb.core[i] ?? 0;
         if (x < y)
             return -1;
         if (x > y)
             return 1;
     }
-    return 0;
+    if (pa.prerelease.length === 0 && pb.prerelease.length === 0)
+        return 0;
+    if (pa.prerelease.length === 0)
+        return 1;
+    if (pb.prerelease.length === 0)
+        return -1;
+    return comparePrerelease(pa.prerelease, pb.prerelease);
 }
 /** 查询 npm registry 判断是否有新版本。网络/解析失败时返回 hasUpdate:false，绝不抛错。 */
 async function checkForUpdate(opts = {}) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "c0de-agent",
-  "version": "1.13.0",
+  "version": "1.14.0",
   "description": "Open-source AI coding assistant with Browser-Server architecture",
   "type": "module",
   "bin": {

package/dist/server/registry-config.js

@@ -1,44 +0,0 @@
-// src/server/registry-config.ts
-// config.providers ↔ LLM registry 的构建/同步逻辑（P1-1 从 server.ts 拆出，
-// 供 chat 路由按项目配置构建注册表，避免 routes → server.ts 循环依赖）。
-import { decryptSecret } from '../core/secret.js';
-import { createRegistry, overrideToCapabilities, rebuildRegistry, registerProvider, } from '../llm/registry.js';
-/** 把 config.providers 注册到新建的 LLM registry（修复此前空 registry 的遗漏）。 */
-function buildRegistryFromConfig(config) {
-    const registry = createRegistry();
-    for (const p of config.providers) {
-        registerProviderFromConfig(registry, p);
-    }
-    return registry;
-}
-function registerProviderFromConfig(registry, p) {
-    // 兼容 config.json 中以 _tag 标识 provider 的格式（name 缺失时回退到 _tag）
-    const name = p.name || p._tag;
-    if (!name || !p.baseURL)
-        return;
-    // baseURL 已含 /v1 时用 /chat/completions，避免 /v1/v1 双重前缀
-    const path = p.baseURL.replace(/\/+$/, '').endsWith('/v1') ? '/chat/completions' : undefined;
-    registerProvider(registry, {
-        name,
-        baseURL: p.baseURL,
-        apiKey: p.apiKey ? decryptSecret(p.apiKey) : p.apiKey,
-        ...(path ? { path } : {}),
-        // 传递用户配置的 per-model capabilities（contextWindow 等），
-        // 否则 resolveRoute 回退到 DEFAULT_MODEL_CAPABILITIES，可能导致预算过小。
-        ...(p.models ? { models: overrideToCapabilities(p.models) } : {}),
-    });
-}
-/**
- * config 变更后原子地同步 registry：在隔离的 next registry 上重建全部路由，
- * 完成后一次性替换 registry 内部 table 引用。运行中的 resolveRoute 任何时刻
- * 看到的都是完整的旧表或完整的新表，不会读到「已清空但未注册完」的半状态，
- * 因此不会把本可用的 provider 误判为 NoRoute。ServerContext 立即生效，无需重启。
- */
-function syncRegistryFromConfig(registry, config) {
-    rebuildRegistry(registry, (next) => {
-        for (const p of config.providers) {
-            registerProviderFromConfig(next, p);
-        }
-    });
-}
-export { buildRegistryFromConfig, registerProviderFromConfig, syncRegistryFromConfig };