devinfra-bridge 0.1.0-alpha.3 → 0.1.0-alpha.4

package/README.md

@@ -186,6 +186,26 @@ node scripts/smoke-artifact.mjs   # 等价于 npm run smoke:artifact，先 build
 
 正常启动后 stdout 输出一行就绪 JSON。固定监听 `127.0.0.1:18765`；端口占用则退出。用 SIGINT/SIGTERM 停止，最多 10 秒排空 HTTP 请求，随后清理资源。
 
+## 周期模型同步
+
+daemon ready 后 30 秒调用 CLI；每轮结束后等待 10 分钟，单轮超时 120 秒。固定执行 `sync --yes --non-interactive`，不带 `--force`。模型判断和配置修改全部由 CLI 当前 sync 实现负责。
+
+每轮读取 `<state_root>/auto-sync.json`，CLI 接入/同步和软件更新维护该文件：
+
+```json
+{
+  "enabled": true,
+  "cli_entry": "/absolute/path/to/cli/dist/main.js",
+  "claude_config_dir": "/Users/example/.claude"
+}
+```
+
+`enabled=false` 关闭周期同步。文件不存在、`cli_entry` 缺失或目标文件不存在时，直接调用 PATH 中的 `devinfra-bridge-cli` 兜底。有效入口使用 daemon 自身 Node 启动；状态目录固定传入 `DEVINFRA_BRIDGE_STATE_ROOT`，CC 目录使用登记值。配置无效时记录错误，不执行该轮；下一轮重新读取，无需重启。CLI 缺失或执行失败不影响 Query 代理。
+
+`daemon.log` 记录 `auto_sync_started`、`auto_sync_finished`、`auto_sync_failed`、`auto_sync_fallback`，包含耗时、退出码和固定错误码，不保存 CLI stdout/stderr。超时或 daemon 退出时结束同步子进程及其派生进程。目录变化写入后，新开的 CC/Codex 会话使用新列表。
+
+CLI 必须支持 `sync --yes --non-interactive`；旧 CLI 会返回参数错误，日志为 `CLI_SYNC_FAILED`。`--yes` 仅自动确认当前 sync 修改；`--non-interactive` 禁止交互登录。普通手动 sync 继续要求确认。
+
 ## 首版行为
 
 - 转发 `POST /v1/messages`（可带 `?beta=true`）和 `POST /v1/responses`（无 query 参数）；共用同一转发实现，原始 body 与 JSON/SSE 字节不转换。不解析请求 JSON、不验证 UTF-8 或 model，模型及参数是否合法交给 Gateway。保留请求大小、未压缩编码、超时和并发限制。

package/dist/daemon/auto-sync.d.ts

@@ -0,0 +1,20 @@
+import type { Logger } from "../util/logger.js";
+export declare const AUTO_SYNC_STARTUP_MS = 30000;
+export declare const AUTO_SYNC_INTERVAL_MS = 600000;
+export declare const AUTO_SYNC_TIMEOUT_MS = 120000;
+interface RunOptions {
+    signal: AbortSignal;
+    timeoutMs?: number;
+    killGraceMs?: number;
+    env?: NodeJS.ProcessEnv;
+}
+export declare function runAutoSync(stateRoot: string, logger: Logger, options: RunOptions): Promise<void>;
+interface SchedulerOptions {
+    startupMs?: number;
+    intervalMs?: number;
+    run?: (signal: AbortSignal) => Promise<void>;
+}
+export declare function startAutoSync(stateRoot: string, logger: Logger, options?: SchedulerOptions): {
+    close(): Promise<void>;
+};
+export {};

package/dist/index.js

@@ -400,6 +400,7 @@ function createLogger(stateRoot, maxBytes = 5 * 1024 * 1024) {
           agent: record.agent,
           duration_ms: record.duration_ms,
           status: record.status,
+          exit_code: record.exit_code,
           code: record.code
         })}
 `;
@@ -961,12 +962,157 @@ async function prepareStateRoot(path) {
 }
 
 // src/version.ts
-var VERSION = true ? "0.1.0-alpha.3" : "0.1.0-dev";
+var VERSION = true ? "0.1.0-alpha.4" : "0.1.0-dev";
+
+// src/daemon/auto-sync.ts
+import { spawn as spawn2 } from "node:child_process";
+import { lstat as lstat2, readFile as readFile2, stat as stat2 } from "node:fs/promises";
+import { isAbsolute as isAbsolute2, join as join3 } from "node:path";
+var AUTO_SYNC_STARTUP_MS = 3e4;
+var AUTO_SYNC_INTERVAL_MS = 6e5;
+var AUTO_SYNC_TIMEOUT_MS = 12e4;
+var SYNC_ARGS = ["sync", "--yes", "--non-interactive"];
+async function registration(stateRoot) {
+  const path = join3(stateRoot, "auto-sync.json");
+  try {
+    const info = await lstat2(path);
+    if (!info.isFile() || info.isSymbolicLink() || info.size > 16 * 1024 || process.platform !== "win32" && (info.uid !== process.getuid?.() || (info.mode & 18) !== 0)) {
+      throw new Error("Invalid auto-sync registration");
+    }
+    const value = JSON.parse(await readFile2(path, "utf8"));
+    if (!value || typeof value !== "object" || Array.isArray(value))
+      throw new Error("Invalid registration");
+    const config = value;
+    if (config.enabled !== void 0 && typeof config.enabled !== "boolean")
+      throw new Error("Invalid enabled");
+    if (config.claude_config_dir !== void 0 && (typeof config.claude_config_dir !== "string" || !isAbsolute2(config.claude_config_dir) || config.claude_config_dir.includes("\0")))
+      throw new Error("Invalid directory");
+    return config;
+  } catch (error) {
+    if (error.code === "ENOENT") return {};
+    throw error;
+  }
+}
+function terminate(child, force) {
+  if (!child.pid) return;
+  if (process.platform === "win32") {
+    const killer = spawn2("taskkill", ["/pid", String(child.pid), "/t", "/f"], {
+      shell: false,
+      windowsHide: true,
+      stdio: "ignore"
+    });
+    killer.on("error", () => child.kill("SIGKILL"));
+    return;
+  }
+  try {
+    process.kill(-child.pid, force ? "SIGKILL" : "SIGTERM");
+  } catch {
+  }
+}
+async function runAutoSync(stateRoot, logger, options) {
+  const started = Date.now();
+  let config;
+  try {
+    config = await registration(stateRoot);
+  } catch {
+    logger.write({ event: "auto_sync_failed", code: "AUTO_SYNC_CONFIG_INVALID" });
+    return;
+  }
+  if (config.enabled === false || options.signal.aborted) return;
+  let useEntry = false;
+  if (typeof config.cli_entry === "string" && isAbsolute2(config.cli_entry) && !config.cli_entry.includes("\0")) {
+    useEntry = await stat2(config.cli_entry).then(
+      (info) => info.isFile(),
+      () => false
+    );
+  }
+  if (options.signal.aborted) return;
+  if (!useEntry) logger.write({ event: "auto_sync_fallback", code: "CLI_ENTRY_UNAVAILABLE" });
+  const env = {
+    ...options.env ?? process.env,
+    DEVINFRA_BRIDGE_STATE_ROOT: stateRoot
+  };
+  if (config.claude_config_dir) env.CLAUDE_CONFIG_DIR = config.claude_config_dir;
+  const command = useEntry ? process.execPath : "devinfra-bridge-cli";
+  const args = useEntry ? [config.cli_entry, ...SYNC_ARGS] : SYNC_ARGS;
+  logger.write({ event: "auto_sync_started" });
+  await new Promise((resolve) => {
+    const child = spawn2(command, args, {
+      shell: false,
+      windowsHide: true,
+      detached: process.platform !== "win32",
+      stdio: ["ignore", "pipe", "pipe"],
+      env
+    });
+    child.stdout.resume();
+    child.stderr.resume();
+    let reason;
+    let killTimer;
+    const stop = (code) => {
+      if (reason) return;
+      reason = code;
+      terminate(child, false);
+      killTimer = setTimeout(() => terminate(child, true), options.killGraceMs ?? 1e3);
+    };
+    const onAbort = () => stop("AUTO_SYNC_CANCELLED");
+    options.signal.addEventListener("abort", onAbort, { once: true });
+    const timer = setTimeout(
+      () => stop("AUTO_SYNC_TIMEOUT"),
+      options.timeoutMs ?? AUTO_SYNC_TIMEOUT_MS
+    );
+    child.on("error", () => {
+      reason ??= "CLI_UNAVAILABLE";
+    });
+    child.once("close", (exitCode) => {
+      clearTimeout(timer);
+      if (reason && killTimer) terminate(child, true);
+      clearTimeout(killTimer);
+      options.signal.removeEventListener("abort", onAbort);
+      logger.write({
+        event: reason || exitCode !== 0 ? "auto_sync_failed" : "auto_sync_finished",
+        code: reason ?? (exitCode === 0 ? "AUTO_SYNC_SUCCEEDED" : "CLI_SYNC_FAILED"),
+        duration_ms: Date.now() - started,
+        exit_code: exitCode ?? void 0
+      });
+      resolve();
+    });
+    if (options.signal.aborted) onAbort();
+  });
+}
+function startAutoSync(stateRoot, logger, options = {}) {
+  const controller = new AbortController();
+  let timer;
+  let running = Promise.resolve();
+  const schedule = (delay) => {
+    timer = setTimeout(() => {
+      if (controller.signal.aborted) return;
+      running = (async () => {
+        try {
+          if (options.run) await options.run(controller.signal);
+          else await runAutoSync(stateRoot, logger, { signal: controller.signal });
+        } catch {
+          logger.write({ event: "auto_sync_failed", code: "AUTO_SYNC_FAILED" });
+        } finally {
+          if (!controller.signal.aborted) schedule(options.intervalMs ?? AUTO_SYNC_INTERVAL_MS);
+        }
+      })();
+    }, delay);
+    timer.unref();
+  };
+  schedule(options.startupMs ?? AUTO_SYNC_STARTUP_MS);
+  return {
+    close() {
+      clearTimeout(timer);
+      controller.abort();
+      return running;
+    }
+  };
+}
 
 // src/daemon/single-instance.ts
 import { randomUUID as randomUUID2 } from "node:crypto";
-import { readFile as readFile2, rename, unlink, writeFile } from "node:fs/promises";
-import { join as join3 } from "node:path";
+import { readFile as readFile3, rename, unlink, writeFile } from "node:fs/promises";
+import { join as join4 } from "node:path";
 async function bindSingleInstance(server, port = PORT) {
   await new Promise((resolve, reject) => {
     const onError = () => reject(new Error(`Cannot bind ${HOST}:${port}; port is occupied or unavailable.`));
@@ -979,8 +1125,8 @@ async function bindSingleInstance(server, port = PORT) {
   return server.address().port;
 }
 async function writeInstance(stateRoot, id, version, port = PORT) {
-  const path = join3(stateRoot, "instance.json");
-  const temp = join3(stateRoot, `.instance-${randomUUID2()}.tmp`);
+  const path = join4(stateRoot, "instance.json");
+  const temp = join4(stateRoot, `.instance-${randomUUID2()}.tmp`);
   try {
     await writeFile(
       temp,
@@ -995,7 +1141,7 @@ async function writeInstance(stateRoot, id, version, port = PORT) {
   }
   return async () => {
     try {
-      if (JSON.parse(await readFile2(path, "utf8")).instance_id === id) await unlink(path);
+      if (JSON.parse(await readFile3(path, "utf8")).instance_id === id) await unlink(path);
     } catch {
     }
   };
@@ -1028,6 +1174,7 @@ async function startDaemon(config, { port: requestedPort = PORT } = {}) {
     await provider.close();
     throw error;
   }
+  const autoSync = startAutoSync(stateRoot, logger);
   let closing;
   const onSignal = () => {
     void close().catch(() => logger.write({ event: "shutdown_error" }));
@@ -1035,6 +1182,7 @@ async function startDaemon(config, { port: requestedPort = PORT } = {}) {
   const close = ({ drainMs = 1e4 } = {}) => {
     if (closing) return closing;
     context.closing = true;
+    const syncStopped = autoSync.close();
     process.off("SIGINT", onSignal);
     process.off("SIGTERM", onSignal);
     closing = (async () => {
@@ -1054,6 +1202,7 @@ async function startDaemon(config, { port: requestedPort = PORT } = {}) {
         for (const controller of context.active) controller.abort();
         context.httpsAgent.destroy();
         await provider.close();
+        await syncStopped;
         await cleanup?.();
         logger.write({ event: "stopped" });
       }

package/dist/main.js

@@ -399,6 +399,7 @@ function createLogger(stateRoot, maxBytes = 5 * 1024 * 1024) {
           agent: record.agent,
           duration_ms: record.duration_ms,
           status: record.status,
+          exit_code: record.exit_code,
           code: record.code
         })}
 `;
@@ -960,12 +961,157 @@ async function prepareStateRoot(path) {
 }
 
 // src/version.ts
-var VERSION = true ? "0.1.0-alpha.3" : "0.1.0-dev";
+var VERSION = true ? "0.1.0-alpha.4" : "0.1.0-dev";
+
+// src/daemon/auto-sync.ts
+import { spawn as spawn2 } from "node:child_process";
+import { lstat as lstat2, readFile as readFile2, stat as stat2 } from "node:fs/promises";
+import { isAbsolute as isAbsolute2, join as join3 } from "node:path";
+var AUTO_SYNC_STARTUP_MS = 3e4;
+var AUTO_SYNC_INTERVAL_MS = 6e5;
+var AUTO_SYNC_TIMEOUT_MS = 12e4;
+var SYNC_ARGS = ["sync", "--yes", "--non-interactive"];
+async function registration(stateRoot) {
+  const path = join3(stateRoot, "auto-sync.json");
+  try {
+    const info = await lstat2(path);
+    if (!info.isFile() || info.isSymbolicLink() || info.size > 16 * 1024 || process.platform !== "win32" && (info.uid !== process.getuid?.() || (info.mode & 18) !== 0)) {
+      throw new Error("Invalid auto-sync registration");
+    }
+    const value = JSON.parse(await readFile2(path, "utf8"));
+    if (!value || typeof value !== "object" || Array.isArray(value))
+      throw new Error("Invalid registration");
+    const config = value;
+    if (config.enabled !== void 0 && typeof config.enabled !== "boolean")
+      throw new Error("Invalid enabled");
+    if (config.claude_config_dir !== void 0 && (typeof config.claude_config_dir !== "string" || !isAbsolute2(config.claude_config_dir) || config.claude_config_dir.includes("\0")))
+      throw new Error("Invalid directory");
+    return config;
+  } catch (error) {
+    if (error.code === "ENOENT") return {};
+    throw error;
+  }
+}
+function terminate(child, force) {
+  if (!child.pid) return;
+  if (process.platform === "win32") {
+    const killer = spawn2("taskkill", ["/pid", String(child.pid), "/t", "/f"], {
+      shell: false,
+      windowsHide: true,
+      stdio: "ignore"
+    });
+    killer.on("error", () => child.kill("SIGKILL"));
+    return;
+  }
+  try {
+    process.kill(-child.pid, force ? "SIGKILL" : "SIGTERM");
+  } catch {
+  }
+}
+async function runAutoSync(stateRoot, logger, options) {
+  const started = Date.now();
+  let config;
+  try {
+    config = await registration(stateRoot);
+  } catch {
+    logger.write({ event: "auto_sync_failed", code: "AUTO_SYNC_CONFIG_INVALID" });
+    return;
+  }
+  if (config.enabled === false || options.signal.aborted) return;
+  let useEntry = false;
+  if (typeof config.cli_entry === "string" && isAbsolute2(config.cli_entry) && !config.cli_entry.includes("\0")) {
+    useEntry = await stat2(config.cli_entry).then(
+      (info) => info.isFile(),
+      () => false
+    );
+  }
+  if (options.signal.aborted) return;
+  if (!useEntry) logger.write({ event: "auto_sync_fallback", code: "CLI_ENTRY_UNAVAILABLE" });
+  const env = {
+    ...options.env ?? process.env,
+    DEVINFRA_BRIDGE_STATE_ROOT: stateRoot
+  };
+  if (config.claude_config_dir) env.CLAUDE_CONFIG_DIR = config.claude_config_dir;
+  const command = useEntry ? process.execPath : "devinfra-bridge-cli";
+  const args = useEntry ? [config.cli_entry, ...SYNC_ARGS] : SYNC_ARGS;
+  logger.write({ event: "auto_sync_started" });
+  await new Promise((resolve) => {
+    const child = spawn2(command, args, {
+      shell: false,
+      windowsHide: true,
+      detached: process.platform !== "win32",
+      stdio: ["ignore", "pipe", "pipe"],
+      env
+    });
+    child.stdout.resume();
+    child.stderr.resume();
+    let reason;
+    let killTimer;
+    const stop = (code) => {
+      if (reason) return;
+      reason = code;
+      terminate(child, false);
+      killTimer = setTimeout(() => terminate(child, true), options.killGraceMs ?? 1e3);
+    };
+    const onAbort = () => stop("AUTO_SYNC_CANCELLED");
+    options.signal.addEventListener("abort", onAbort, { once: true });
+    const timer = setTimeout(
+      () => stop("AUTO_SYNC_TIMEOUT"),
+      options.timeoutMs ?? AUTO_SYNC_TIMEOUT_MS
+    );
+    child.on("error", () => {
+      reason ??= "CLI_UNAVAILABLE";
+    });
+    child.once("close", (exitCode) => {
+      clearTimeout(timer);
+      if (reason && killTimer) terminate(child, true);
+      clearTimeout(killTimer);
+      options.signal.removeEventListener("abort", onAbort);
+      logger.write({
+        event: reason || exitCode !== 0 ? "auto_sync_failed" : "auto_sync_finished",
+        code: reason ?? (exitCode === 0 ? "AUTO_SYNC_SUCCEEDED" : "CLI_SYNC_FAILED"),
+        duration_ms: Date.now() - started,
+        exit_code: exitCode ?? void 0
+      });
+      resolve();
+    });
+    if (options.signal.aborted) onAbort();
+  });
+}
+function startAutoSync(stateRoot, logger, options = {}) {
+  const controller = new AbortController();
+  let timer;
+  let running = Promise.resolve();
+  const schedule = (delay) => {
+    timer = setTimeout(() => {
+      if (controller.signal.aborted) return;
+      running = (async () => {
+        try {
+          if (options.run) await options.run(controller.signal);
+          else await runAutoSync(stateRoot, logger, { signal: controller.signal });
+        } catch {
+          logger.write({ event: "auto_sync_failed", code: "AUTO_SYNC_FAILED" });
+        } finally {
+          if (!controller.signal.aborted) schedule(options.intervalMs ?? AUTO_SYNC_INTERVAL_MS);
+        }
+      })();
+    }, delay);
+    timer.unref();
+  };
+  schedule(options.startupMs ?? AUTO_SYNC_STARTUP_MS);
+  return {
+    close() {
+      clearTimeout(timer);
+      controller.abort();
+      return running;
+    }
+  };
+}
 
 // src/daemon/single-instance.ts
 import { randomUUID as randomUUID2 } from "node:crypto";
-import { readFile as readFile2, rename, unlink, writeFile } from "node:fs/promises";
-import { join as join3 } from "node:path";
+import { readFile as readFile3, rename, unlink, writeFile } from "node:fs/promises";
+import { join as join4 } from "node:path";
 async function bindSingleInstance(server, port = PORT) {
   await new Promise((resolve, reject) => {
     const onError = () => reject(new Error(`Cannot bind ${HOST}:${port}; port is occupied or unavailable.`));
@@ -978,8 +1124,8 @@ async function bindSingleInstance(server, port = PORT) {
   return server.address().port;
 }
 async function writeInstance(stateRoot, id, version, port = PORT) {
-  const path = join3(stateRoot, "instance.json");
-  const temp = join3(stateRoot, `.instance-${randomUUID2()}.tmp`);
+  const path = join4(stateRoot, "instance.json");
+  const temp = join4(stateRoot, `.instance-${randomUUID2()}.tmp`);
   try {
     await writeFile(
       temp,
@@ -994,7 +1140,7 @@ async function writeInstance(stateRoot, id, version, port = PORT) {
   }
   return async () => {
     try {
-      if (JSON.parse(await readFile2(path, "utf8")).instance_id === id) await unlink(path);
+      if (JSON.parse(await readFile3(path, "utf8")).instance_id === id) await unlink(path);
     } catch {
     }
   };
@@ -1027,6 +1173,7 @@ async function startDaemon(config, { port: requestedPort = PORT } = {}) {
     await provider.close();
     throw error;
   }
+  const autoSync = startAutoSync(stateRoot, logger);
   let closing;
   const onSignal = () => {
     void close().catch(() => logger.write({ event: "shutdown_error" }));
@@ -1034,6 +1181,7 @@ async function startDaemon(config, { port: requestedPort = PORT } = {}) {
   const close = ({ drainMs = 1e4 } = {}) => {
     if (closing) return closing;
     context.closing = true;
+    const syncStopped = autoSync.close();
     process.off("SIGINT", onSignal);
     process.off("SIGTERM", onSignal);
     closing = (async () => {
@@ -1053,6 +1201,7 @@ async function startDaemon(config, { port: requestedPort = PORT } = {}) {
         for (const controller of context.active) controller.abort();
         context.httpsAgent.destroy();
         await provider.close();
+        await syncStopped;
         await cleanup?.();
         logger.write({ event: "stopped" });
       }

package/dist/util/logger.d.ts

@@ -1,7 +1,7 @@
 import type { AgentIdentity } from "../agents/identity.js";
 import type { ModelProtocol } from "../agents/types.js";
 export interface LogRecord {
-    event: "request" | "ready" | "stopped" | "shutdown_error" | "jwt_refresh_started" | "jwt_refresh_succeeded" | "jwt_refresh_failed" | "query_retry";
+    event: "request" | "ready" | "stopped" | "shutdown_error" | "jwt_refresh_started" | "jwt_refresh_succeeded" | "jwt_refresh_failed" | "query_retry" | "auto_sync_started" | "auto_sync_finished" | "auto_sync_failed" | "auto_sync_fallback";
     request_id?: string;
     gateway_logid?: string;
     gateway_request_id?: string;
@@ -11,6 +11,7 @@ export interface LogRecord {
     agent?: AgentIdentity;
     duration_ms?: number;
     status?: number;
+    exit_code?: number;
     code?: string;
 }
 export interface Logger {

package/docs/development.md

@@ -133,3 +133,9 @@ npm run publish:dry                 # 全量验证、列出包内容，不上传
 alpha/beta/rc 版本对应同名 dist-tag，其他预发布版本使用 next，正式版本使用 latest。本期先发布 alpha 包给 CLI 项目联调，真实 CC + Gateway 未验收完成前不作为正式稳定版。
 
 程序化调用 `startDaemon(config, { port: 0 })` 可使用临时端口；返回值 `handle.port` 和 `instance.json` 记录实际监听端口。该选项用于测试隔离，配置文件与 `serve --config` 命令仍固定使用 `127.0.0.1:18765`。artifact smoke 用仅依赖 Node 内置模块的子进程启动解包后的 daemon API，另行验证打包 CLI 的版本。
+
+## 周期调用 CLI
+
+`src/daemon/auto-sync.ts` 每轮读取 `state_root/auto-sync.json`。ready 后 30 秒首次运行，结束后等待 600 秒，单轮最多 120 秒。有效绝对 `cli_entry` 由 `process.execPath` 启动，否则使用 PATH 命令 `devinfra-bridge-cli`；固定参数 `sync --yes --non-interactive`。不复制模型目录查询或客户端配置逻辑。
+
+CLI 原子维护 enabled、cli_entry、claude_config_dir。关闭开关时不调用；文件缺失时走命令兜底，损坏配置时记录错误。状态目录通过 DEVINFRA_BRIDGE_STATE_ROOT 传入，继承认证和网络环境。每轮最多一个子进程，超时/退出按进程树取消；日志只记录固定错误码、耗时、退出码。macOS/Linux 使用独立进程组取消，Windows 使用 taskkill /T /F；实际 CLI 平台验收仍按 CLI 项目范围。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "devinfra-bridge",
-  "version": "0.1.0-alpha.3",
+  "version": "0.1.0-alpha.4",
   "description": "Local Messages and Responses proxy daemon for devinfra llm gateway",
   "type": "module",
   "engines": {