cabletidy 0.4.0-rc.1 → 0.4.0-rc.3

package/README.md

@@ -16,17 +16,32 @@ CableTidy 的核心不是“提供一个统一 OpenAI API”，而是把复杂
 
 本地管理台的“审计记录”按会话组织。会话列表显示输入摘要、请求数量、最高风险与检查状态；打开会话后，通过请求概览、按顺序排列的轨迹和右侧详情回看过程。页面固定为“仅记录”模式。仅审计经过代理的 Agent Responses / Messages 请求以及流式与普通响应；CableTidy 自身的配置提交、配置启停、客户端配置应用和恢复不在审计范围内。检测结果不触发通知、阻断或人工授权，也不会额外调用模型。
 
-- 风险分为敏感数据与凭据、破坏性操作、权限与安全配置变更、外部代码执行、疑似指令操纵；详情分别显示严重程度、置信度、判断依据和检查完整性。
-- 支持“仅看有风险”及时间、配置、最高严重程度、分类、证据阶段等筛选。命中任一请求即可找到其会话，打开后保留全部已留存上下文；会话数、请求数和风险发现数分开统计。轨迹可上下连续滚动，接近底部时按需追加请求；支持已加载摘要搜索、风险筛选；概览默认按请求数量分配宽度，选中“耗时占比”按耗时分配，再次点击恢复默认，请求顺序始终不变；每条请求同时展示客户端模型与上游模型，支持按两种模型名搜索；详情分为概览、风险和原始内容。页面手动刷新，读取本身不增加审计记录。
+- 风险分为敏感数据与凭据、破坏性操作、权限与安全配置变更、外部代码执行、疑似指令操纵；详情分别显示严重程度、置信度、判断依据和检查完整性。敏感数据除凭据外还标识服务器地址：覆盖 IPv4、IPv6 及整数、十六进制、八进制和百分号编码写法，公网地址泄露后可被直接访问，严重程度高于内网地址；点分版本号、MAC 地址、时间戳和 `std::collections` 这类路径不计为地址。凭据判定按格式前缀、长度和熵分层，自然语言词与 `ssh://git@host` 这类公开写法不再误报。
+- 支持“仅看有风险”及时间、配置、最高严重程度、分类、证据阶段等筛选。命中任一请求即可找到其会话，打开后保留全部已留存上下文；会话数、请求数和风险发现数分开统计。轨迹可上下连续滚动，接近底部时按需追加请求；支持已加载摘要搜索、风险筛选；概览默认按请求数量分配宽度，选中“耗时占比”按耗时分配，再次点击恢复默认，请求顺序始终不变；每条请求同时展示客户端模型与上游模型，支持按两种模型名搜索；详情依次分为概览、风险、请求内容、响应内容和原始内容五个页签。页面手动刷新，读取本身不增加审计记录。
 - 根据客户端提供的会话标识归组，并按配置入口与协议隔离。支持 Codex 常见会话头、显式 `metadata.session_id` 和 Claude Code 的会话元数据；这些标识属于客户端报告。没有标识的 Agent 请求与历史 Agent 记录单独展示，不根据时间、相同内容或用户账号猜测会话。
 - 区分本轮工具调用提议、历史调用、客户端报告的工具结果和文本内容。工具的真实执行状态为未知；未命中规则也不表示已证明安全。
+- Codex 请求概览按顺序解析系统提示词、开发者指令、全部用户输入、历史模型消息、工具调用及结果、推理与历史引用；统计内容组成，每项完整展示、默认展开，支持分页和标题行右侧的原文定位，可用工具定义单独折叠。已有保留正文也可生成概览，缺失和非文本内容明确标示。结构调研与展示边界见 [Codex 请求内容概览](docs/codex-request-overview.md)。
+- Claude Code 请求概览按 Messages 内容块解析系统提示词、用户与历史模型内容、思考、工具调用及结果；每项完整展示，`user` 消息内的工具结果单独计数，支持跨页关联、错误与缓存标记、多模态类型和标题行右侧的精确原文定位。结构调研与展示边界见 [Claude Code 请求内容概览](docs/claude-request-overview.md)。
+- “响应内容”页签完整展示本轮模型文本、推理 / 思考、工具调用与服务端结果；支持分类计数、独立分页、完整结构和原文定位。Codex 合并 Responses 增量并去重最终输出，Claude Code 分开拼接文本、思考、签名和工具 JSON；缺失与中断明确提示。会话风险跳转到请求内容或响应内容中的对应位置，自动加载所需分页；请求内容、响应内容和原始内容中的风险位置在普通浏览时也保持高亮。调研及边界见 [Codex 响应内容概览](docs/codex-response-overview.md) 和 [Claude Code 响应内容概览](docs/claude-response-overview.md)。
 - 审计存入数据目录中的 `audit.sqlite3`，默认保留 30 天，容量预算 128 MiB，接近容量时可能提前清理较旧记录。页面显示实际保留范围、写入状态和记录缺口。
 - 保留网关观察到的请求与响应正文，包括对话、模型输出、工具参数和客户端报告的工具结果；凭据、认证头、Cookie、私钥等保留原文并记录检测位置，详情页自动高亮敏感内容。点击风险可定位对应内容并查看上下文；流式命中保存检测当时的独立快照。普通对话、命令和路径保持可读。
 - 正文不再设单条固定长度上限，网关也不再按 8 MiB 拒绝请求。采用有界内存、临时加密暂存、原文分段落盘和正文按页加载；后台完整扫描保留的可检测内容，不再只检查前 1 MiB。共享内存、临时空间或审计存储预算不足时明确显示进度、失败和缺口；旧记录没有正文时不作补造。
 
 检查使用本地规则和有界缓冲。未知工具、动态脚本、未覆盖的推理内容、图片、加密内容以及超限情况会显示覆盖不足。数据库不可用或队列满时代理继续运行，页面显示审计退化状态；正常退出会排空已接收的写入，强制退出可能丢失未提交记录。它是本地可追溯日志，不提供零丢失或防篡改保证。
 
-分类调研、规则清单、固定预算和 HTTP 查询接口见 [代理安全 V1 设计与实现](docs/agent-security-v1.md)。基础安全审计自 `0.3.0` 提供；会话轨迹、敏感原文保留与高亮纳入 `0.4.0-rc.1`，发布与验收状态见 [候选版发布说明](docs/releases/0.4.0-rc.1.md)。
+分类调研、规则清单、固定预算和 HTTP 查询接口见 [代理安全 V1 设计与实现](docs/agent-security-v1.md)。基础安全审计自 `0.3.0` 提供；会话轨迹、敏感原文保留与高亮纳入 `0.4.0-rc.1`，发布与验收状态见 [候选版发布说明](docs/releases/0.4.0-rc.3.md)。
+
+## 配置套装导出与导入
+
+在管理台的“配置套装”列表点击“导出配置”，勾选需要的套装后下载 JSON 文件。文件包含所选套装的客户端绑定、模型映射与可选参数、路由、上游地址和认证方式；共用的路由与上游只保存一次。
+
+“包含认证凭据”复选框默认不勾选：导出不含 API Key、上游密钥、密钥引用或密钥配置状态，上游 URL 中的用户名、密码、查询参数和片段也会移除；如地址需要查询参数，请在导入后重新填写。勾选后导出所选套装的已保存密钥，并保留完整上游 URL，文件包含明文凭据，请妥善保管。无论是否勾选，均不包含客户端文件、应用与恢复记录、审计日志、管理台端口和其他机器设置；仅导出受支持的配置字段，未知扩展字段不携带。默认不含凭据时，若已保存的密钥出现在名称、模型设置或 URL 路径中，导出会拒绝并提示先移除该凭据。
+
+点击“导入配置”选择文件，先预览待导入的配置，再点击“确认导入”。遇到同名配置时，每套配置须选择“更新已有配置”或“创建新配置”。更新会保留配置名称和本地入口，替换套装设置；创建新配置会添加 ` (import 2)` 等后缀。路由和上游 ID 冲突会自动调整。当文件包含认证凭据时，预览显示“使用导入配置中的认证凭据”复选框，默认勾选：文件中的密钥和 URL 认证信息会使用到导入配置，更新时优先使用文件密钥。取消勾选会忽略文件密钥并移除文件 URL 中的认证信息。未使用文件密钥时，更新已有配置保留该配置原有密钥，无需重新填写；原配置尚未设置密钥时仍需填写。创建新配置不继承本机已有凭据。使用文件密钥会分配独立引用，不会覆盖其他套装共享的本机密钥。更新后不再使用的旧路由和上游会清理，仍被其他套装使用的共享连接和凭据会保留。导入后按需应用到客户端。导入不自动修改 Codex 或 Claude Code 的本地文件。
+
+导入复用配置提交的校验、修订冲突检查和备份流程，文件无效时不会部分写入；预览后若本机配置已变更，需要重新预览。带可选模型设置的 Codex 套装会按本机官方目录校验，纯透传套装不依赖该目录。
+
+本地管理接口：`POST /api/v1/config/export` 接收 `{ "bindingIds": ["配置ID"], "includeCredentials": false }` 并返回套装文件；`POST /api/v1/config/import` 接收 `{ "bundle": 文件内容, "preview": true }` 返回预览、`baseRevision` 和 `hasCredentials`，正式导入使用 `{ "bundle": 文件内容, "baseRevision": 预览修订号, "choices": { "同名的源配置ID": "update 或 create" }, "useImportedCredentials": true }`。预览中的每套配置提供 `sourceId` 和 `conflict`，所有同名配置都必须明确选择；`choices` 也可用于预览所选更新方案。含凭据的文件通过顶层 `upstreamSecrets` 保存所选上游 ID 与密钥的对应关系，不包含本机密钥引用。`includeCredentials` 默认 `false`，`useImportedCredentials` 默认 `true`。文件标识为 `cabletidy.configuration-suites`，文件版本为 `1`，内部配置版本为 `2`。
 
 ## 模型透传与可选设置
 
@@ -49,7 +64,7 @@ Codex 的可选模型设置目前只支持与本机官方 GPT 目录明确对应
 
 npm 安装方式推荐 Node.js 24，也支持 Node.js 22.13 及以上的 22.x 版本；完整版本约束见 `package.json`。原生程序可独立运行。发行包支持 Linux x64 / arm64、macOS x64 / arm64、Windows x64；源码构建需要稳定版 Rust 和系统 C 编译器 / 链接器。CI 执行源码测试与安装冒烟测试，跨平台结果以对应提交的 CI 为准。Windows 使用原生进程 API 查询进程身份；Codex 目录查询仍需要系统 Windows PowerShell，并允许 `Add-Type` 调用 Windows Job Object API。
 
-当前源码版本为 `0.4.0-rc.1`，新增配置删除、审计原文与敏感内容高亮、会话轨迹。候选版使用 npm `next`；默认 npm 安装命令仍选择 `latest` 指向的稳定版 `0.3.0`。候选版的发布状态、验收范围与升级步骤见 [0.4.0-rc.1 发布说明](docs/releases/0.4.0-rc.1.md)；GitHub Release 与 npm 分别发布。稳定版见 [0.3.0 发布说明](docs/releases/0.3.0.md)。
+当前源码版本为 `0.4.0-rc.3`，在上一候选版基础上新增完整响应展示、风险内容定位与持续高亮、配置套装导入导出及 `restart` / `update` 命令，并修复凭据误报、标识服务器地址。候选版使用 npm `next`；默认 npm 安装命令仍选择 `latest` 指向的稳定版 `0.3.0`。候选版的发布状态、验收范围与升级步骤见 [0.4.0-rc.3 发布说明](docs/releases/0.4.0-rc.3.md)；GitHub Release 与 npm 分别发布。稳定版见 [0.3.0 发布说明](docs/releases/0.3.0.md)。
 
 ### 从 npm 官方源安装
 
@@ -65,10 +80,10 @@ cabletidy start
 npm exec --yes --registry=https://registry.npmjs.org/ --package=cabletidy -- cabletidy start
 ```
 
-试用 `0.4.0` 候选版时，先按[候选版升级说明](docs/releases/0.4.0-rc.1.md)停止服务并备份数据，再安装指定版本：
+试用 `0.4.0` 候选版时，先按[候选版升级说明](docs/releases/0.4.0-rc.3.md)停止服务并备份数据，再安装指定版本：
 
 ```bash
-npm install -g cabletidy@0.4.0-rc.1 --registry=https://registry.npmjs.org/
+npm install -g cabletidy@0.4.0-rc.3 --registry=https://registry.npmjs.org/
 ```
 
 ### 从本地安装包使用
@@ -95,6 +110,8 @@ npm 启动器需要本机 Node.js；发行包自带对应平台的原生二进
 
 `cabletidy stop` 通过本地控制通道请求正常退出，等待已开始的请求、子进程和配置写入完成，再清理 `runtime.json` 并释放操作系统文件锁；不设置强制退出倒计时。主机改名不影响启停。Ctrl+C / SIGTERM 在发送前取消操作，发送过程中取消会提示请求可能已提交，收到接受确认后只取消客户端等待，daemon 继续退出；退出码分别为 130 / 143。`status` 区分运行中、退出排空中、持锁但控制通道无响应和未运行。未运行时 `stop` 成功返回提示，连接提前中断则报告未确认正常退出。
 
+`cabletidy restart` 先按 `stop` 的流程等待当前服务正常退出，再使用原配置启动，保留已保存的管理台地址、配置和密钥。未运行时直接启动；停止失败或等待被取消时不会启动新服务。安装版默认后台重启，源码版和直接运行原生程序保持前台；npm 启动器支持 `cabletidy restart --foreground`。
+
 `daemon.lock` 现在是持久的普通文件，退出后保留；它存在不代表服务正在运行，请勿删除或替换。异常退出后锁由操作系统释放，无需等待旧版的 10 秒心跳过期。数据目录应位于本地文件系统，不支持跨机器共享目录的锁协调。此功能不包含开机自启或崩溃自动重启。
 
 源码调试时的 `npm start` 和 `cargo run --bin cabletidy -- start` 仍在前台运行，便于查看日志和使用 Ctrl+C。安装后的 CLI 也可使用 `cabletidy start --foreground` 临时前台运行。
@@ -102,6 +119,7 @@ npm 启动器需要本机 Node.js；发行包自带对应平台的原生二进
 ```bash
 cabletidy --help
 cabletidy status
+cabletidy restart
 cabletidy stop
 ```
 
@@ -116,6 +134,8 @@ npm install -g cabletidy@latest --registry=https://registry.npmjs.org/
 cabletidy start
 ```
 
+已支持 `update` 的版本可以直接执行 `cabletidy update`（默认 `latest`，也可指定版本或 `next` 等标签；加 `--check` 只检查不安装，`--registry` 指定的源会保留在提示命令中）。它只更新当前包所在的全局 npm 前缀，因此在 nvm 等多 Node 环境中不会装到别处；运行状态只通过实例锁和 `runtime.json` 判断，配置文件损坏不影响更新。macOS 和 Linux 下 daemon 运行时可直接更新，完成后询问是否重启；重启使用 `stop` 后 `start`，回退到没有 `restart` 的版本（如 `0.3.0`）也可用。Windows 下运行中的可执行文件会被锁定，需要确认先停止 daemon，并等待原进程真正退出后再安装，更新后询问是否启动；无法确认运行状态时不更新。非交互终端中确认均视为否，可加 `--yes` 自动确认。
+
 如果新版提示 `ELOCKLEGACY`，说明数据目录中仍有旧版的 `daemon.lock` **目录**。请先从 `runtime.json` 查看 PID，并用系统进程工具核对；旧版 `stop` 不可用时，可手动执行 `kill <实际 PID>`（Windows 使用 `taskkill /PID <实际 PID>`），等待并确认旧进程退出后，再删除这个旧锁目录并启动新版。这里的 `<实际 PID>` 必须替换为核对后的数字；不要删除配置、密钥或新版的普通锁文件。新版不自动控制旧 daemon 或回收旧锁。
 
 从本地安装包升级时，将安装目标换成新版本 `.tgz`。卸载前先执行 `cabletidy stop`，再使用 `npm uninstall -g cabletidy`，不会删除 `~/.cabletidy` 或撤销已应用的客户端配置；彻底停用前应先把客户端切换到其他接入。

package/bin/cabletidy.mjs

@@ -1,18 +1,27 @@
 #!/usr/bin/env node
 import { existsSync } from "node:fs";
 import { launch, root, startBackground } from "./native.mjs";
+import { update } from "./update.mjs";
 
 try {
   const args = process.argv.slice(2);
   const command = args[0] || "status";
-  if (["start", "stop"].includes(command) && args.length > 1 && !(command === "start" && args.length === 2 && args[1] === "--foreground")) {
-    throw new Error("Usage: cabletidy start [--foreground] | stop");
+  const starts = ["start", "restart"].includes(command);
+  if ((starts || command === "stop") && args.length > 1 && !(starts && args.length === 2 && args[1] === "--foreground")) {
+    throw new Error("Usage: cabletidy start [--foreground] | restart [--foreground] | stop");
   }
-  if (command === "start" && args[1] !== "--foreground" && !existsSync(`${root}/Cargo.toml`)) {
-    const runtime = await startBackground();
-    console.log(`CableTidy started: ${runtime.web.url}\nLogs: ${runtime.logPath}`);
+  if (command === "update") {
+    process.exitCode = await update(args.slice(1));
+  } else if (starts && args[1] !== "--foreground" && !existsSync(`${root}/Cargo.toml`)) {
+    const code = command === "restart" ? await launch(["stop"]).closed : 0;
+    if (code !== 0) {
+      process.exitCode = code;
+    } else {
+      const runtime = await startBackground();
+      console.log(`CableTidy ${command === "restart" ? "restarted" : "started"}: ${runtime.web.url}\nLogs: ${runtime.logPath}`);
+    }
   } else {
-    process.exitCode = await launch(command === "start" ? ["start"] : args).closed;
+    process.exitCode = await launch(starts ? [command] : args).closed;
   }
 } catch (error) {
   console.error(error.message);

package/bin/update.mjs

@@ -0,0 +1,192 @@
+import { execFile, spawn } from "node:child_process";
+import { existsSync, readFileSync } from "node:fs";
+import path from "node:path";
+import readline from "node:readline/promises";
+import { promisify } from "node:util";
+import { executable, root } from "./native.mjs";
+
+const execFileAsync = promisify(execFile);
+const packageName = "cabletidy";
+const defaultRegistry = "https://registry.npmjs.org/";
+const usage = "Usage: cabletidy update [<version|tag>] [--check] [--yes] [--registry <url>]";
+
+export function parseArgs(args) {
+  let spec;
+  let check = false;
+  let yes = false;
+  let registry = defaultRegistry;
+  for (let index = 0; index < args.length; index++) {
+    const arg = args[index];
+    if (arg === "--check") check = true;
+    else if (arg === "--yes" || arg === "-y") yes = true;
+    else if (arg === "--registry" && index + 1 < args.length) registry = args[++index];
+    else if (arg.startsWith("--registry=")) registry = arg.slice("--registry=".length);
+    // Only versions and dist-tags; npm would also accept paths, URLs and git specs.
+    else if (spec === undefined && /^[0-9A-Za-z][0-9A-Za-z.+-]*$/.test(arg)) spec = arg;
+    else throw new Error(usage);
+  }
+  if (!/^https?:$/.test(URL.parse(registry)?.protocol ?? "")) throw new Error(`Invalid registry: ${registry}`);
+  return { spec: spec ?? "latest", explicit: spec !== undefined, check, yes, registry };
+}
+
+export function compareVersions(left, right) {
+  const parse = version => {
+    const [core, pre] = version.split("+")[0].split(/-(.*)/s);
+    return [core.split(".").map(Number), pre ? pre.split(".") : []];
+  };
+  const [leftCore, leftPre] = parse(left);
+  const [rightCore, rightPre] = parse(right);
+  for (let index = 0; index < 3; index++) {
+    if (leftCore[index] !== rightCore[index]) return Math.sign(leftCore[index] - rightCore[index]);
+  }
+  // A release sorts after its prereleases.
+  if (!leftPre.length || !rightPre.length) return Math.sign(rightPre.length - leftPre.length);
+  for (let index = 0; index < Math.min(leftPre.length, rightPre.length); index++) {
+    const [a, b] = [leftPre[index], rightPre[index]];
+    if (a === b) continue;
+    const [numericA, numericB] = [/^\d+$/.test(a), /^\d+$/.test(b)];
+    if (numericA && numericB) return Math.sign(Number(a) - Number(b));
+    if (numericA !== numericB) return numericA ? -1 : 1;
+    return a < b ? -1 : 1;
+  }
+  return Math.sign(leftPre.length - rightPre.length);
+}
+
+// The prefix that owns this package, or null when it is not a global npm install (local dependency, npx cache).
+// Updating that exact prefix keeps nvm and custom npm prefixes from installing somewhere else.
+export function globalPrefix(packageDir) {
+  const windows = process.platform === "win32";
+  const modules = path.dirname(packageDir);
+  if (path.basename(modules) !== "node_modules") return null;
+  const parent = path.dirname(modules);
+  if (!windows && path.basename(parent) !== "lib") return null;
+  const prefix = windows ? parent : path.dirname(parent);
+  const shim = windows ? path.join(prefix, `${packageName}.cmd`) : path.join(prefix, "bin", packageName);
+  return existsSync(shim) ? prefix : null;
+}
+
+// Prefer the npm bundled with the running node over whichever npm is first on PATH.
+function npm() {
+  const directory = path.dirname(process.execPath);
+  const cli = process.platform === "win32"
+    ? path.join(directory, "node_modules", "npm", "bin", "npm-cli.js")
+    : path.join(directory, "..", "lib", "node_modules", "npm", "bin", "npm-cli.js");
+  if (existsSync(cli)) return [process.execPath, [cli]];
+  if (process.platform === "win32") return null;
+  return ["npm", []];
+}
+
+function run(command, args) {
+  return new Promise((resolve, reject) => {
+    const child = spawn(command, args, { stdio: "inherit", windowsHide: true });
+    child.once("error", reject);
+    child.once("close", code => resolve(code ?? 1));
+  });
+}
+
+// Quote an argument for a command the user is told to run in their shell.
+export function shellArg(value, platform = process.platform) {
+  if (/^[\w@%+=:,./-]+$/.test(value)) return value;
+  return platform === "win32" ? `"${value}"` : `'${value.replaceAll("'", `'\\''`)}'`;
+}
+
+async function confirm(question, yes) {
+  if (yes) {
+    console.log(`${question} [y/N] y (--yes)`);
+    return true;
+  }
+  if (!process.stdin.isTTY) {
+    console.log(`${question} [y/N] (no terminal; assuming no, pass --yes to confirm)`);
+    return false;
+  }
+  const prompt = readline.createInterface({ input: process.stdin, output: process.stdout });
+  try {
+    return /^y(es)?$/i.test((await prompt.question(`${question} [y/N] `)).trim());
+  } finally {
+    prompt.close();
+  }
+}
+
+// Probes the instance lock and runtime.json without parsing config.json.
+async function instance(binary) {
+  try {
+    return JSON.parse((await execFileAsync(binary, ["__instance"], { windowsHide: true })).stdout);
+  } catch (error) {
+    return { error: (error.stderr || error.message).trim() };
+  }
+}
+
+export async function update(args) {
+  const options = parseArgs(args);
+  if (existsSync(path.join(root, "Cargo.toml"))) {
+    throw new Error("CableTidy is running from a source checkout; update it with git pull and npm run build.");
+  }
+  const current = JSON.parse(readFileSync(path.join(root, "package.json"), "utf8")).version;
+  const registry = `--registry=${options.registry}`;
+  const manual = `npm install -g ${packageName}@${options.spec} ${shellArg(registry)}`;
+  const [npmCommand, npmArgs] = npm() ?? [];
+  if (!npmCommand) throw new Error(`Cannot find the npm bundled with ${process.execPath}; update manually:\n  ${manual}`);
+
+  const { stdout } = await execFileAsync(npmCommand, [...npmArgs, "view", `${packageName}@${options.spec}`, "version", "--json", registry], { windowsHide: true });
+  const published = stdout.trim() ? JSON.parse(stdout) : null;
+  const target = Array.isArray(published) ? published.at(-1) : published;
+  if (!target) throw new Error(`No published ${packageName} version matches ${options.spec}`);
+  const order = compareVersions(target, current);
+  if (order === 0) {
+    console.log(`CableTidy ${current} is up to date`);
+    return 0;
+  }
+  if (order < 0 && !options.explicit) {
+    console.log(`CableTidy ${current} is newer than ${options.spec} (${target}); pass a version to change it`);
+    return 0;
+  }
+  if (options.check) {
+    const command = ["cabletidy update", options.explicit && options.spec, options.registry !== defaultRegistry && shellArg(registry)];
+    console.log(`CableTidy ${current} -> ${target} available; run: ${command.filter(Boolean).join(" ")}`);
+    return 0;
+  }
+
+  const prefix = globalPrefix(path.resolve(root));
+  if (!prefix) throw new Error(`CableTidy was not installed with npm install -g; update it the way it was installed, e.g.\n  ${manual}`);
+  const windows = process.platform === "win32";
+  const launcher = path.join(root, "bin", "cabletidy.mjs");
+  const state = await instance(executable());
+  if (state.error) {
+    // Windows cannot replace the package while the daemon may still be using its executable.
+    if (windows) throw new Error(`Cannot determine whether CableTidy is running: ${state.error}\nStop it manually, then run cabletidy update again.`);
+    console.warn(`Cannot determine whether CableTidy is running: ${state.error}`);
+  }
+  if (state.running && windows) {
+    if (!state.process) throw new Error("Cannot verify the running CableTidy process (it may be starting or shutting down); stop it manually, then run cabletidy update again.");
+    // Windows locks the running executable, so npm cannot replace the package until the daemon exits.
+    if (!await confirm("The running CableTidy daemon must be stopped before updating. Stop it now?", options.yes)) {
+      console.log("Update cancelled");
+      return 1;
+    }
+    const stopped = await run(process.execPath, [launcher, "stop"]);
+    if (stopped !== 0) return stopped;
+    // stop returns once shutdown completes; the process may still be closing other control connections.
+    const exited = await run(executable(), ["__instance", "--wait-exit", JSON.stringify(state.process)]);
+    if (exited !== 0) return exited;
+  }
+  console.log(`Updating CableTidy ${current} -> ${target} in ${prefix}`);
+  const installed = await run(npmCommand, [...npmArgs, "install", "-g", `--prefix=${prefix}`, registry, `${packageName}@${target}`]);
+  if (installed !== 0) {
+    console.error(`npm install failed${state.running && windows ? "; CableTidy is stopped, run cabletidy start to resume" : ""}`);
+    return installed;
+  }
+  // stop + start is supported by every version that has stop; restart is newer.
+  const switchCommand = windows ? "cabletidy start" : "cabletidy stop && cabletidy start";
+  if (state.error) console.log(`If CableTidy is running, run ${switchCommand} to use ${target}`);
+  if (!state.running) return 0;
+  if (!await confirm(windows ? "Start CableTidy again?" : `Restart CableTidy now? The daemon is still running ${current}.`, options.yes)) {
+    console.log(`Run ${switchCommand} when ready`);
+    return 0;
+  }
+  // Fresh processes load the newly installed launcher and executable.
+  if (!windows) {
+    const stopped = await run(process.execPath, [launcher, "stop"]);
+    if (stopped !== 0) return stopped;
+  }
+  return run(process.execPath, [launcher, "start"]);
+}

package/native/darwin-arm64/build.json

@@ -1,6 +1,6 @@
 {
-  "version": "0.4.0-rc.1",
+  "version": "0.4.0-rc.3",
   "platform": "darwin-arm64",
   "target": "aarch64-apple-darwin",
-  "sha256": "18bbf1e8b1543d9ba8376eeff7aa25e1048ff00ba5fd50162b26c1989ca49573"
+  "sha256": "6e03356848797f965731b7a1b31dc194c3c7c61c8fa0e610afdf83a1c74456c3"
 }

package/native/darwin-x64/build.json

@@ -1,6 +1,6 @@
 {
-  "version": "0.4.0-rc.1",
+  "version": "0.4.0-rc.3",
   "platform": "darwin-x64",
   "target": "x86_64-apple-darwin",
-  "sha256": "6a526501a56848dc7c401842d081e7b17166822570393615fee90b4660cd3b27"
+  "sha256": "dbf9b0992f28769956f5ad14746229c6e24545f37f4a88189fc900868f209cca"
 }

package/native/linux-arm64/build.json

@@ -1,6 +1,6 @@
 {
-  "version": "0.4.0-rc.1",
+  "version": "0.4.0-rc.3",
   "platform": "linux-arm64",
   "target": "aarch64-unknown-linux-musl",
-  "sha256": "e1e256fad37165164682675e10d729f461f44bf0fbb08e68a3a00547476f5ee1"
+  "sha256": "64479c16d3c391136dc88bc7331f11781bc8284d40d7ca9e735c1b06bbf52ee6"
 }

package/native/linux-x64/build.json

@@ -1,6 +1,6 @@
 {
-  "version": "0.4.0-rc.1",
+  "version": "0.4.0-rc.3",
   "platform": "linux-x64",
   "target": "x86_64-unknown-linux-musl",
-  "sha256": "c32a449ba7c7afe474cbc33f92c3f8beb74a7a7ffd533e75fa1f1afbb048a88a"
+  "sha256": "b011bc999695615547e43a594aaf8d39d9621e08c4359984ca0d862641e58ebd"
 }

package/native/win32-x64/build.json

@@ -1,6 +1,6 @@
 {
-  "version": "0.4.0-rc.1",
+  "version": "0.4.0-rc.3",
   "platform": "win32-x64",
   "target": "x86_64-pc-windows-msvc",
-  "sha256": "160af949144c22c1722a7e3dd4bd3a3ca38a277d53b3658dc2d66074b71e6678"
+  "sha256": "1194736d1258c7b944e69710cf2eb63efbb0c9ef7e8b621c1894c12e87324beb"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cabletidy",
-  "version": "0.4.0-rc.1",
+  "version": "0.4.0-rc.3",
   "description": "A local multi-target coding CLI gateway and provider manager.",
   "license": "MIT",
   "repository": {
@@ -34,6 +34,7 @@
     "dev:status": "node scripts/dev.mjs status",
     "test": "node scripts/test.mjs",
     "test:security:browser": "node scripts/build-native.mjs --debug --test && node scripts/security-browser.mjs",
+    "test:config:browser": "node scripts/build-native.mjs --debug --test && node scripts/config-transfer-browser.mjs",
     "test:package": "npm run build && node --test scripts/package-smoke.mjs",
     "test:claude": "node scripts/build-native.mjs --debug --test && node --test scripts/claude-smoke.mjs",
     "check:release": "node scripts/check-release.mjs",