@sleep2agi/commhub-server 0.9.0-preview.233 → 0.9.0-preview.235

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@sleep2agi/commhub-server",
3
- "version": "0.9.0-preview.233",
3
+ "version": "0.9.0-preview.235",
4
4
  "description": "CommHub Server — AI Agent communication hub with MCP protocol, multi-network isolation, user auth, and MCP tools (17 collaboration-core + node/provider ops tools; authoritative list: docs-site/docs/api/mcp-tools.md).",
5
5
  "type": "module",
6
6
  "main": "src/index.ts",
@@ -1,3 +1,16 @@
1
+ // 2026-10-31 —— **本地直跑会看到 4 条红,那不是回归**(与 hub-provider-config.test.ts 同一类)。
2
+ //
3
+ // 实测(本机,逐文件跑,独立 DB):
4
+ // PASS 13 / FAIL 4
5
+ // 失败点的期望都是 status:"succeeded",实际收到 "failed"
6
+ // (reconcileProviderSnapshots 写回前会对 `daemon_provider_writes` 做一次
7
+ // validateWrite 的逐字段确认;本地没有那套容器网络/编译产物时这一步必失败)
8
+ //
9
+ // 反证(**这一步才是关键**,否则「环境问题」只是一句免罪声明):
10
+ // 把本次改动 `git stash -u` 后在同一个 HEAD 上重跑 ⇒ PASS 13 / FAIL 4,同一个 4 条。
11
+ // ⇒ 它在我改之前就红,且红的集合完全相同。
12
+ //
13
+ // 判定这个文件是否健康,看 `hub-provider-core.yml` 的容器测试,不看本地 bun test。
1
14
  import "./require-explicit-test-db";
2
15
  import { afterAll, beforeEach, expect, test } from "bun:test";
3
16
  import { readFileSync, mkdtempSync, mkdirSync, writeFileSync, rmSync, chmodSync } from "node:fs";
@@ -1187,6 +1187,25 @@ describe("#473 anonymous /health — watchdog contract intact, no topology leak"
1187
1187
  expect(Math.abs(derived - body.uptime)).toBeLessThanOrEqual(5);
1188
1188
  });
1189
1189
 
1190
+ // 2026-10-31 —— **响应头也不能泄露指纹**(外部复核:「匿名 /health 响应头里不得出现
1191
+ // git / commit / build(sha|id) 类头;这两条不需要会话就能读 ⇒ 它们回答『我站在哪一层』,
1192
+ // 不是『我有没有登录』」)。
1193
+ // 为什么需要它:body 有白名单,**头没有**。将来有人把 build id 塞进 `X-Build-Id`,
1194
+ // body 侧断言全绿,而匿名读者已经拿到了指纹。
1195
+ test("anonymous /health exposes no fingerprint-bearing response header", async () => {
1196
+ const res = await fetch(`${BASE}/health`);
1197
+ expect(res.status).toBe(200);
1198
+ const names = [...res.headers.keys()].map((k) => k.toLowerCase());
1199
+ const forbidden = names.filter((n) => /git|commit|build[-_]?(sha|id)?/.test(n));
1200
+ if (forbidden.length) {
1201
+ throw new Error(`匿名 /health 出现了指纹类响应头:${forbidden.join(", ")}\n` +
1202
+ " ⇒ body 白名单不覆盖响应头;要么删掉这个头,要么它只在鉴权分支发。");
1203
+ }
1204
+ // 镜像:同一个端点在**鉴权**分支下可以有 X-* 头,但也不能有指纹 —— 迄今也没有;
1205
+ // 这条留作记录:若哪天加了,必须先在白名单测试里显式放行。
1206
+ expect(forbidden).toEqual([]);
1207
+ });
1208
+
1190
1209
  test("no dead entries: every allow-listed key is actually served to anonymous callers", async () => {
1191
1210
  const { PUBLIC_HEALTH_KEYS } = await import("./server.js");
1192
1211
  const plain = await (await fetch(`${BASE}/health`)).json() as any;
@@ -312,7 +312,12 @@ describe("GET /api/providers", () => {
312
312
  expect("hint" in b.body).toBe(false);
313
313
 
314
314
  // ③ 已生效:selection 原样带回,并给出 revision
315
- q("dpa_probe_2", "completed", JSON.stringify({ expected_revision: 7, provider_id: "main", model: "m1" }), null);
315
+ // 2026-10-31 —— 这条 fixture 原来写 `"completed"`,而**生产端从不写这个值**
316
+ // (daemon 成功时写的是 `succeeded`,见 daemon-provider-snapshots.ts:322)。
317
+ // 于是这条断言只在「兜底分支」上成立:它证明的不是「applied 状态能读到」,
318
+ // 而是「任何没枚举到的值都会被读成 applied」——一条把缺陷当契约保护起来的断言。
319
+ // ⇒ fixture 改用生产者真的会写的值;兜底方向另立一条断言(见下面的 unknown 用例)。
320
+ q("dpa_probe_2", "succeeded", JSON.stringify({ expected_revision: 7, provider_id: "main", model: "m1" }), null);
316
321
  const c = await read();
317
322
  expect(c.body.state).toBe("applied");
318
323
  expect(c.body.selection).toMatchObject({ provider_id: "main", model: "m1" });
@@ -324,6 +329,17 @@ describe("GET /api/providers", () => {
324
329
  const d = await read();
325
330
  expect(d.body.state).toBe("failed");
326
331
  expect(d.body.error).toBe("daemon_rejected_selection");
332
+
333
+ // ⑤ 未知状态:**兜底不许是最乐观的那一档**
334
+ // 原实现是 `… ? "failed" : "applied"` ⇒ 任何没被枚举到的 status 都折叠成「已生效」。
335
+ // daemon 侧只要新增一个状态(取消 / 回滚 / 拼错),界面就会读到「切好了」—— 唯一会主动撒谎的折叠方向。
336
+ // 现在闭集显式映射,不认识的值报 unknown 且把原值带出去(不猜、不美化)。
337
+ q("dpa_probe_4", "cancelled_by_operator", null, null);
338
+ const e = await read();
339
+ expect(e.body.state).toBe("unknown");
340
+ expect(e.body.state).not.toBe("applied");
341
+ expect(e.body.observed_status).toBe("cancelled_by_operator");
342
+ expect(String(e.body.hint)).toContain("不等于已生效");
327
343
  } finally {
328
344
  db.run(`DELETE FROM daemon_provider_snapshots WHERE daemon_node_id = ?1`, [nodeId]);
329
345
  db.run(`DELETE FROM node_daemon_bindings WHERE request_id = 'bind_ps'`);
@@ -429,9 +445,23 @@ describe("GET /api/providers", () => {
429
445
  expect(defs.length).toBe(1);
430
446
  const readers = files.flatMap(({ f, src }) =>
431
447
  src.split("\n").map((line, i) => ({ line, f, i }))
432
- .filter(({ line }) => line.includes(name) && !line.includes(`export const ${name}`)));
448
+ .filter(({ line }) => line.includes(name) && !line.includes(`export const ${name}`))
449
+ // 2026-10-31 —— **注释不是读点**:`// 状态码来自穷尽表(PROVIDER_WRITE_STATUS…)`
450
+ // 会满足「读到过」而实际上没有任何代码用它。这正是本仓实测到的形态。
451
+ .filter(({ line }) => {
452
+ const t = line.trim();
453
+ return !t.startsWith("//") && !t.startsWith("*") && !t.startsWith("/*");
454
+ }));
433
455
  // 「读」= 出现但不是定义行(索引 / 展开 / 断言都算)
434
456
  expect(readers.length).toBeGreaterThan(0);
457
+ // 2026-10-31 —— **计数 = 1 还不够,位置也要在集合内**(外部复核:
458
+ // 「只断言计数 1 ⇒ 留下的是『1 个读点,它自己另搞一套』—— 完全满足计数 1,
459
+ // 而语义已经不是你想的那个。」)
460
+ // ⇒ 读点必须落在**路由文件**里(server.ts),否则等于表有了、用法另有其处。
461
+ // 位置:读点必须落在**实现或路由**里(不是只落在注释里)
462
+ const readerFiles = new Set(readers.map((r) => String(r.f).split("/").pop()));
463
+ expect(readerFiles.size).toBeGreaterThan(0);
464
+ expect([...readerFiles].some((f) => f === "server.ts" || f === "hub-provider-config.ts" || f === "requirements.ts")).toBe(true);
435
465
  }
436
466
  });
437
467
 
package/src/server.ts CHANGED
@@ -3947,10 +3947,19 @@ return Bun.serve({
3947
3947
  ORDER BY created_at DESC LIMIT 1`,
3948
3948
  node.network_id, node.node_id);
3949
3949
  // 三态而不是「有/没有」:从未切换过 / 正在切 / 切失败,界面要给的下一步完全不同。
3950
- const state = !row ? "never_switched"
3951
- : row.status === "pending" ? "pending"
3952
- : row.status === "failed" || row.status === "expired" ? "failed"
3953
- : "applied";
3950
+ //
3951
+ // 2026-10-31 —— **兜底不许是最乐观的那一档**:
3952
+ // 原来写的是 `… ? "failed" : "applied"`,即任何**没被枚举到**的 status 都会折叠成「已生效」。
3953
+ // 而 daemon 侧新增一个状态(取消 / 回滚 / 拼错的 succeeded_)时,界面会读到「切好了」——
3954
+ // 这是所有折叠方向里唯一会**主动撒谎**的方向。
3955
+ // ⇒ 改成闭集显式映射;不在表里的 status 报 unknown 并把原值带出去(不猜、不美化)。
3956
+ const SELECTION_STATE_BY_STATUS: Record<string, "pending" | "applied" | "failed"> = {
3957
+ pending: "pending",
3958
+ succeeded: "applied", // daemon 侧成功的实际取值(不是 "applied")
3959
+ failed: "failed",
3960
+ expired: "failed", // 过期=没生效;对使用者与失败同一档
3961
+ };
3962
+ const state = !row ? "never_switched" : (SELECTION_STATE_BY_STATUS[row.status] ?? "unknown");
3954
3963
  let selection: unknown = null;
3955
3964
  if (row?.snapshot_json) { try { selection = JSON.parse(row.snapshot_json); } catch { selection = null; } }
3956
3965
  return withCors(req, Response.json({
@@ -3964,6 +3973,12 @@ return Bun.serve({
3964
3973
  ...(state === "never_switched"
3965
3974
  ? { hint: "这个节点还没有被切换过 provider;显示的是它的本地默认配置(不是 Hub 的读数)" }
3966
3975
  : {}),
3976
+ ...(state === "unknown"
3977
+ ? {
3978
+ observed_status: row?.status ?? null,
3979
+ hint: "Hub 读到一个它不认识的切换状态;**这不等于已生效**,也不等于失败 —— 去 daemon 侧看这次请求的实际结果",
3980
+ }
3981
+ : {}),
3967
3982
  }));
3968
3983
  }
3969
3984
  // 2026-10-31 —— **写侧:切这个节点的 provider / 模型**(#3146 的第一个动作面)。