@sleep2agi/commhub-server 0.9.0-preview.13 → 0.9.0-preview.130

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.
Files changed (317) hide show
  1. package/README.md +130 -10
  2. package/bin/commhub.ts +99 -11
  3. package/package.json +7 -7
  4. package/src/ack-create-request-transport.test.ts +182 -0
  5. package/src/ack-create-request.test.ts +50 -7
  6. package/src/admin-delete-network-http.test.ts +228 -0
  7. package/src/admin-networks-http.test.ts +88 -0
  8. package/src/adoption-candidates-http.test.ts +137 -0
  9. package/src/adoption-candidates.ts +158 -0
  10. package/src/agent-access-batch.test.ts +210 -0
  11. package/src/agent-access.ts +487 -0
  12. package/src/agent-acl-groups-http.test.ts +247 -0
  13. package/src/agent-acl-http.test.ts +659 -0
  14. package/src/agent-acl-slice3-http.test.ts +267 -0
  15. package/src/agent-groups-perf.test.ts +223 -0
  16. package/src/agent-notice.ts +48 -0
  17. package/src/agent-team-whoami-http.test.ts +98 -0
  18. package/src/agent-teams-http.test.ts +323 -0
  19. package/src/agent-teams.ts +244 -0
  20. package/src/alias-filter.test.ts +72 -0
  21. package/src/alias-filter.ts +42 -0
  22. package/src/api-host-supervisors-can-create-nodes.test.ts +350 -0
  23. package/src/api-host-supervisors-fallback.test.ts +271 -0
  24. package/src/api-host-supervisors-runtime-readiness.test.ts +195 -0
  25. package/src/api-nodes-shape.test.ts +26 -10
  26. package/src/auth-password-change-cli-tokens-http.test.ts +294 -0
  27. package/src/auth-sessions-http.test.ts +250 -0
  28. package/src/auth-validate.test.ts +5 -1
  29. package/src/auth-weak-password-login.test.ts +176 -0
  30. package/src/auth.ts +598 -49
  31. package/src/avatar-validate.test.ts +163 -0
  32. package/src/avatar-validate.ts +103 -0
  33. package/src/binding-generation-http.test.ts +121 -0
  34. package/src/blocked-exit-on-reply.test.ts +122 -0
  35. package/src/boot-side-effect.test.ts +124 -0
  36. package/src/clone-node.test.ts +248 -0
  37. package/src/clone-node.ts +289 -0
  38. package/src/codex-config-flags.ts +77 -0
  39. package/src/codex-fork-contract.ts +23 -0
  40. package/src/codex-fork-migration.test.ts +38 -0
  41. package/src/commhub-bin-args.test.ts +85 -0
  42. package/src/config-apply-sec1.test.ts +107 -0
  43. package/src/config-apply-validate.test.ts +134 -1
  44. package/src/config-apply-validate.ts +111 -5
  45. package/src/create-node-blocked-gate.test.ts +356 -0
  46. package/src/create-node-network-id.test.ts +79 -0
  47. package/src/create-node-tool-schema.test.ts +48 -0
  48. package/src/create-node-unicode-name.test.ts +120 -0
  49. package/src/create-node-validate.test.ts +193 -7
  50. package/src/create-node-validate.ts +227 -15
  51. package/src/create-node-workdir.test.ts +289 -0
  52. package/src/create-node.ts +77 -23
  53. package/src/daemon-provider-snapshots.test.ts +421 -0
  54. package/src/daemon-provider-snapshots.ts +327 -0
  55. package/src/daemon-token-owner-http.test.ts +236 -0
  56. package/src/dashboard-slash-routing-http.test.ts +107 -0
  57. package/src/db-adapter-guard.test.ts +148 -0
  58. package/src/db-adapter-translate.test.ts +128 -0
  59. package/src/db-adapter.ts +323 -87
  60. package/src/db-timestamp.test.ts +38 -0
  61. package/src/db-timestamp.ts +15 -0
  62. package/src/db.ts +930 -35
  63. package/src/delivered-without-push.test.ts +140 -0
  64. package/src/department-groups-http.test.ts +209 -0
  65. package/src/department-groups-sync-http.test.ts +328 -0
  66. package/src/department-groups.ts +434 -0
  67. package/src/department-heads-http.test.ts +330 -0
  68. package/src/department-heads.ts +226 -0
  69. package/src/departments-http.test.ts +185 -0
  70. package/src/departments.ts +260 -0
  71. package/src/desktop-message-seam.test.ts +150 -0
  72. package/src/desktop-message.test.ts +368 -0
  73. package/src/dm-file-scope-http.test.ts +178 -0
  74. package/src/ext-token-shared.test.ts +60 -0
  75. package/src/ext-validation-regression.test.ts +131 -0
  76. package/src/external-schedule-edits-http.test.ts +321 -0
  77. package/src/external-schedule-edits-timestamps.test.ts +64 -0
  78. package/src/external-schedule-edits.ts +327 -0
  79. package/src/file-download-authz-dev-open.test.ts +135 -0
  80. package/src/file-download-authz.test.ts +404 -0
  81. package/src/file-download-date-bucket.test.ts +436 -0
  82. package/src/file-network-scope-dev-open.test.ts +97 -0
  83. package/src/file-network-scope.test.ts +732 -0
  84. package/src/group-membership-events-http.test.ts +264 -0
  85. package/src/group-messages-http.test.ts +482 -0
  86. package/src/group-messages.ts +297 -0
  87. package/src/health-redaction.test.ts +642 -0
  88. package/src/http-gzip.test.ts +94 -0
  89. package/src/http-gzip.ts +112 -0
  90. package/src/hub-provider-config.test.ts +139 -0
  91. package/src/hub-provider-config.ts +105 -0
  92. package/src/hub-timestamp.test.ts +38 -0
  93. package/src/hub-timestamp.ts +27 -0
  94. package/src/human-dm.ts +215 -0
  95. package/src/inbox-caller.ts +49 -0
  96. package/src/inbox-count-sse.test.ts +310 -0
  97. package/src/inbox-count.ts +29 -0
  98. package/src/index.ts +15 -2362
  99. package/src/lifecycle-guard.ts +1 -1
  100. package/src/mcp-context-cost-http.test.ts +123 -0
  101. package/src/mcp-projects-events-http.test.ts +162 -0
  102. package/src/mcp-route-label-http.test.ts +120 -0
  103. package/src/mcp-write-network-resolution.test.ts +432 -0
  104. package/src/member-audit-network-id-http.test.ts +93 -0
  105. package/src/member-presence-http.test.ts +210 -0
  106. package/src/messages-ack-by-agent-http.test.ts +142 -0
  107. package/src/migrate-sqlite-to-pg.test.ts +47 -0
  108. package/src/migrate-sqlite-to-pg.ts +263 -0
  109. package/src/model-auth-notify-http.test.ts +181 -0
  110. package/src/model-auth-notify.ts +116 -0
  111. package/src/network-name-http.test.ts +75 -0
  112. package/src/network-scope.ts +276 -0
  113. package/src/network-token-membership-http.test.ts +139 -0
  114. package/src/node-alias-control.ts +12 -0
  115. package/src/node-attrs-validate.ts +88 -0
  116. package/src/node-attrs.test.ts +217 -0
  117. package/src/node-caller-identity-http.test.ts +781 -0
  118. package/src/node-create-request-status-http.test.ts +105 -0
  119. package/src/node-daemon-bindings.test.ts +132 -0
  120. package/src/node-daemon-bindings.ts +130 -0
  121. package/src/node-files-transport.test.ts +344 -0
  122. package/src/node-health-codex-login.test.ts +120 -0
  123. package/src/node-health-dispatch-http.test.ts +279 -0
  124. package/src/node-health-guard.ts +105 -0
  125. package/src/node-health-passthrough.test.ts +115 -0
  126. package/src/node-health-store.ts +101 -0
  127. package/src/node-id-alias.test.ts +190 -0
  128. package/src/node-identity-conflict-http.test.ts +269 -0
  129. package/src/node-identity-conflict.ts +142 -0
  130. package/src/node-identity-mismatch.test.ts +74 -0
  131. package/src/node-lifecycle-controllable.test.ts +64 -0
  132. package/src/node-lifecycle-controllable.ts +53 -0
  133. package/src/node-lifecycle-read-http.test.ts +245 -0
  134. package/src/node-lifecycle-read.ts +121 -0
  135. package/src/node-logs-transport.test.ts +263 -0
  136. package/src/node-permissions-http.test.ts +276 -0
  137. package/src/node-permissions.ts +285 -0
  138. package/src/node-request-retention.test.ts +281 -0
  139. package/src/node-request-retention.ts +120 -0
  140. package/src/node-skills-transport.test.ts +209 -0
  141. package/src/node-token-ownership.ts +51 -0
  142. package/src/node-token-privilege-http.test.ts +158 -0
  143. package/src/observer-avatar-http.test.ts +431 -0
  144. package/src/observer-push.test.ts +252 -0
  145. package/src/opencode-v2-catalog.test.ts +268 -0
  146. package/src/opencode-v2-catalog.ts +352 -0
  147. package/src/package-version-consistency.test.ts +25 -0
  148. package/src/peer-reply-atomic.test.ts +455 -0
  149. package/src/peer-reply-capability.test.ts +70 -0
  150. package/src/pg-worker.ts +87 -0
  151. package/src/project-dir-warn-clear-http.test.ts +132 -0
  152. package/src/project-viewer-can-http.test.ts +114 -0
  153. package/src/push.ts +429 -10
  154. package/src/redact-tokens.test.ts +65 -0
  155. package/src/redact-tokens.ts +40 -0
  156. package/src/rename.ts +22 -2
  157. package/src/reply-target-derivation.test.ts +96 -0
  158. package/src/report-status-handover-capabilities-http.test.ts +124 -0
  159. package/src/report-status-host-schema.test.ts +235 -0
  160. package/src/report-status-resume-id-handover.test.ts +150 -0
  161. package/src/require-explicit-test-db.ts +9 -0
  162. package/src/requirement-due-reminders-http.test.ts +620 -0
  163. package/src/requirement-due-reminders.ts +416 -0
  164. package/src/requirement-events-http.test.ts +268 -0
  165. package/src/requirement-events.test.ts +45 -0
  166. package/src/requirement-events.ts +144 -0
  167. package/src/requirement-notify.ts +165 -0
  168. package/src/requirement-participant-notify-http.test.ts +309 -0
  169. package/src/requirement-tag-ops-http.test.ts +266 -0
  170. package/src/requirement-tags.ts +89 -0
  171. package/src/requirements-abandoned-http.test.ts +236 -0
  172. package/src/requirements-comment-http.test.ts +167 -0
  173. package/src/requirements-completed-at-migration.test.ts +70 -0
  174. package/src/requirements-errors-mcp-http.test.ts +164 -0
  175. package/src/requirements-errors.ts +143 -0
  176. package/src/requirements-etag-http.test.ts +91 -0
  177. package/src/requirements-http.test.ts +709 -0
  178. package/src/requirements-last-event-http.test.ts +349 -0
  179. package/src/requirements-list-mcp-slim-http.test.ts +155 -0
  180. package/src/requirements-list-slim-http.test.ts +319 -0
  181. package/src/requirements-mcp.test.ts +163 -0
  182. package/src/requirements-migrate.ts +259 -0
  183. package/src/requirements-owner-strict-mcp-http.test.ts +145 -0
  184. package/src/requirements-people-http.test.ts +114 -0
  185. package/src/requirements-people-mcp-http.test.ts +225 -0
  186. package/src/requirements-people.ts +127 -0
  187. package/src/requirements-priority-lowest.test.ts +114 -0
  188. package/src/requirements-search-http.test.ts +182 -0
  189. package/src/requirements-search.test.ts +32 -0
  190. package/src/requirements-search.ts +145 -0
  191. package/src/requirements-seq-http.test.ts +193 -0
  192. package/src/requirements-seq-migration.test.ts +63 -0
  193. package/src/requirements-start-date.test.ts +125 -0
  194. package/src/requirements-stats-http.test.ts +288 -0
  195. package/src/requirements-stats.ts +167 -0
  196. package/src/requirements-status-participants-http.test.ts +222 -0
  197. package/src/requirements-upgrade-e2e.test.ts +126 -0
  198. package/src/requirements-upgrade-migration.test.ts +98 -0
  199. package/src/requirements.ts +1806 -0
  200. package/src/resolve-port.test.ts +57 -0
  201. package/src/resolve-port.ts +44 -0
  202. package/src/response-charset.test.ts +130 -0
  203. package/src/rest-explicit-columns-http.test.ts +222 -0
  204. package/src/rest-identity.test.ts +129 -0
  205. package/src/rest-identity.ts +125 -0
  206. package/src/rest-projections.ts +68 -0
  207. package/src/rest-write-network-resolution.test.ts +133 -0
  208. package/src/restricted-files.ts +76 -0
  209. package/src/retention.ts +15 -3
  210. package/src/route-callers-http.test.ts +120 -0
  211. package/src/route-timing.test.ts +211 -0
  212. package/src/route-timing.ts +258 -0
  213. package/src/rules-file-duplicate-alias.test.ts +234 -0
  214. package/src/rules-file-session-target.test.ts +207 -0
  215. package/src/rules-file-transport.test.ts +237 -0
  216. package/src/runtime-label.test.ts +22 -0
  217. package/src/runtime-label.ts +21 -0
  218. package/src/runtime-readiness.ts +90 -0
  219. package/src/schedule-agent-mcp-http.test.ts +381 -0
  220. package/src/schedule-agent.ts +192 -0
  221. package/src/scheduled-doorbell-nodeless-session.test.ts +134 -0
  222. package/src/scheduled-failures-http.test.ts +233 -0
  223. package/src/scheduled-failures.ts +179 -0
  224. package/src/scheduled-offline.test.ts +131 -0
  225. package/src/scheduled-offline.ts +66 -0
  226. package/src/scheduled-reply-unread-http.test.ts +212 -0
  227. package/src/scheduled-run-terminal.test.ts +268 -0
  228. package/src/scheduled-skip-blocking-task.test.ts +120 -0
  229. package/src/scheduled-stuck-http.test.ts +238 -0
  230. package/src/scheduled-stuck.ts +153 -0
  231. package/src/scheduled-tasks-http.test.ts +638 -0
  232. package/src/scheduled-tasks.ts +766 -0
  233. package/src/scoped-secrets.ts +124 -0
  234. package/src/send-dedup-request-id.test.ts +229 -0
  235. package/src/send-reply-agent-warning.test.ts +202 -0
  236. package/src/send-reply-alias-optional.test.ts +131 -0
  237. package/src/send-reply-attachments.test.ts +458 -0
  238. package/src/send_dedup.test.ts +54 -0
  239. package/src/send_dedup.ts +52 -6
  240. package/src/serve-error.test.ts +38 -0
  241. package/src/serve-error.ts +27 -0
  242. package/src/server.ts +5257 -0
  243. package/src/session-task-on-dispatch.ts +14 -0
  244. package/src/session-token-ownership-http.test.ts +122 -0
  245. package/src/shared/codex-inventory.ts +41 -0
  246. package/src/shared/daemon-provider-login.ts +31 -0
  247. package/src/shared/daemon-provider-snapshot.ts +52 -0
  248. package/src/shared/external-schedule-contract.ts +60 -0
  249. package/src/shared/node-name.test.ts +62 -0
  250. package/src/shared/node-name.ts +161 -0
  251. package/src/shared/provider-application.ts +29 -0
  252. package/src/shared/provider-collection.ts +14 -0
  253. package/src/shared/provider-initialization.ts +8 -0
  254. package/src/shared/reserved-env-drift.test.ts +10 -0
  255. package/src/shared/scoped-secret-contract.ts +5 -0
  256. package/src/shared/task-content-limit-drift.test.ts +28 -0
  257. package/src/shared/task-content-limit.ts +25 -0
  258. package/src/side-thread-command-transport.test.ts +312 -0
  259. package/src/side-thread-command-transport.ts +318 -0
  260. package/src/side-thread-http-integration.test.ts +233 -0
  261. package/src/side-thread-http.ts +504 -0
  262. package/src/side-thread-production.test.ts +72 -0
  263. package/src/side-thread-production.ts +118 -0
  264. package/src/side-thread.test.ts +1067 -0
  265. package/src/side-thread.ts +2499 -0
  266. package/src/skillhub-http.test.ts +108 -0
  267. package/src/sqlite-close-checkpoint.test.ts +78 -0
  268. package/src/start-node.test.ts +264 -0
  269. package/src/status-alias-filter-http.test.ts +106 -0
  270. package/src/status-alias-resolver-http.test.ts +163 -0
  271. package/src/status-alias-resolver.ts +19 -0
  272. package/src/status-node-id-filter-http.test.ts +161 -0
  273. package/src/status-read-cache-http.test.ts +229 -0
  274. package/src/status-read-cache.ts +122 -0
  275. package/src/stop-delete-node.test.ts +509 -1
  276. package/src/task-access-http.test.ts +402 -0
  277. package/src/task-access.ts +420 -0
  278. package/src/task-auth-origin-http.test.ts +91 -0
  279. package/src/task-auth-origin.test.ts +24 -0
  280. package/src/task-auth-origin.ts +7 -0
  281. package/src/task-consumption.test.ts +482 -0
  282. package/src/task-diagnostic-http.test.ts +149 -0
  283. package/src/task-diagnostic.test.ts +115 -0
  284. package/src/task-diagnostic.ts +118 -0
  285. package/src/task-expiry-notice-http.test.ts +287 -0
  286. package/src/task-expiry-notice.ts +315 -0
  287. package/src/task-idempotency-mcp.test.ts +142 -0
  288. package/src/task-idempotency.test.ts +60 -0
  289. package/src/task-idempotency.ts +75 -0
  290. package/src/task-late-replies.ts +54 -0
  291. package/src/task-late-reply-http.test.ts +152 -0
  292. package/src/task-lifecycle-watcher.test.ts +204 -0
  293. package/src/task-lifecycle-watcher.ts +49 -0
  294. package/src/task-network-resolution-http.test.ts +141 -0
  295. package/src/task-orphan-http.test.ts +287 -0
  296. package/src/task-orphan.ts +119 -0
  297. package/src/task-queue-ahead-http.test.ts +309 -0
  298. package/src/task-queue-ahead-scale.test.ts +236 -0
  299. package/src/task-queue-ahead.ts +186 -0
  300. package/src/task-rejection-log-http.test.ts +160 -0
  301. package/src/task-rejection-log.ts +49 -0
  302. package/src/task-stale-open-http.test.ts +290 -0
  303. package/src/task-stale-open.ts +103 -0
  304. package/src/tasks-pagination-http.test.ts +141 -0
  305. package/src/tool-audience-http.test.ts +220 -0
  306. package/src/tool-audience.ts +118 -0
  307. package/src/tools-list-json-schema.test.ts +67 -0
  308. package/src/tools.ts +3927 -323
  309. package/src/upload-early-reject-guard.test.ts +155 -0
  310. package/src/uploads-http.test.ts +97 -15
  311. package/src/uploads.ts +103 -6
  312. package/src/user-avatar-http.test.ts +74 -0
  313. package/src/user-avatar-migration.test.ts +25 -0
  314. package/src/user-inbox-by-agent-http.test.ts +161 -0
  315. package/src/user-inbox-netid-notnull.test.ts +122 -0
  316. package/src/user-inbox-read-http.test.ts +223 -0
  317. package/src/user-inbox-schema.test.ts +54 -0
@@ -0,0 +1,264 @@
1
+ // RFC-042 §9.3 补口(看板 #457):入群 / 退群实时事件 group_membership_changed。
2
+ // HTTP 集成测试(真实 Bun.serve,私有端口,临时库;PostgreSQL 由 test2123 梯子用 COMMHUB_TEST_PG_URL 跑同一个文件)。
3
+ // 钉住:手动拉人 / 移人、调进 / 调出部门、换负责人、移出网络 → 被加 / 被移的人和提交后的当前群成员各收到一条;
4
+ // 不相干的人收不到;事件只在提交之后推 —— 整个事务回滚一条不推,内层 savepoint 回滚只丢内层那几笔。
5
+
6
+ import { describe, expect, test, beforeAll, afterAll } from "bun:test";
7
+ import { mkdtempSync, rmSync } from "fs";
8
+ import { join } from "path";
9
+ import { tmpdir } from "os";
10
+ import { register } from "./auth.js";
11
+ import { db } from "./db.js";
12
+ import { groupTx, syncDepartmentGroups, isGroupMember } from "./department-groups.js";
13
+
14
+ const DIR = mkdtempSync(join(tmpdir(), "anet-group-membership-ev-"));
15
+ let BASE = "";
16
+ let hub: any = null;
17
+ const PW = "GroupMembershipEvPassw0rd!x";
18
+ let NET = "";
19
+ const U: Record<string, { token: string; id: string; username: string }> = {};
20
+ const DEPT: Record<string, string> = {};
21
+ const GRP: Record<string, string> = {};
22
+ const S: Record<string, { events: any[]; close: () => void }> = {};
23
+
24
+ async function send(token: string, method: string, path: string, body?: unknown) {
25
+ const res = await fetch(`${BASE}${path}`, { method, headers: { ...(token ? { Authorization: `Bearer ${token}` } : {}), "Content-Type": "application/json" }, body: body === undefined ? undefined : JSON.stringify(body) });
26
+ const text = await res.text();
27
+ let json: any = null;
28
+ try { json = JSON.parse(text); } catch {}
29
+ return { status: res.status, body: json };
30
+ }
31
+ const CG = (suffix = "") => `/api/networks/${NET}/chat-groups${suffix}`;
32
+ const place = async (who: string, dept: string | null) =>
33
+ expect((await send(U.owner.token, "PUT", `/api/networks/${NET}/members/${U[who].id}/department`, { department_id: dept })).status).toBe(200);
34
+
35
+ async function subscribe(who: string) {
36
+ const ctrl = new AbortController();
37
+ const res = await fetch(`${BASE}/events/users/me?network_id=${NET}`, { headers: { Authorization: `Bearer ${U[who].token}` }, signal: ctrl.signal });
38
+ expect(res.status).toBe(200);
39
+ const events: any[] = [];
40
+ const reader = res.body!.getReader();
41
+ const dec = new TextDecoder();
42
+ let buf = "";
43
+ void (async () => {
44
+ try {
45
+ for (;;) {
46
+ const { done, value } = await reader.read();
47
+ if (done) break;
48
+ buf += dec.decode(value);
49
+ let i: number;
50
+ while ((i = buf.indexOf("\n\n")) >= 0) {
51
+ const frame = buf.slice(0, i); buf = buf.slice(i + 2);
52
+ for (const line of frame.split("\n")) if (line.startsWith("data: ")) { try { events.push(JSON.parse(line.slice(6))); } catch {} }
53
+ }
54
+ }
55
+ } catch {}
56
+ })();
57
+ await until(() => events.some((e) => e.type === "connected"));
58
+ return { events, close: () => ctrl.abort() };
59
+ }
60
+ const until = async (cond: () => boolean, tries = 150) => { for (let k = 0; k < tries && !cond(); k++) await new Promise((r) => setTimeout(r, 20)); };
61
+ const sleep = (ms: number) => new Promise((r) => setTimeout(r, ms));
62
+
63
+ /** 只看成员事件;清空所有订阅者已收到的,便于每个用例从零数。 */
64
+ const mev = (who: string) => S[who].events.filter((e) => e.type === "group_membership_changed");
65
+ // 先等上一个用例里没被等的收件人(比如 hank)的事件落地,再清空 —— 否则它会串到下一个用例里。
66
+ const reset = async () => { await sleep(150); for (const k of Object.keys(S)) S[k].events.length = 0; };
67
+ const match = (who: string, group: string, member: string, change: string, source: string) =>
68
+ mev(who).filter((e) => e.group_id === GRP[group] && e.member_user_id === U[member].id && e.change === change && e.source === source);
69
+
70
+ beforeAll(async () => {
71
+ process.env.COMMHUB_DB ||= join(DIR, "hub.db");
72
+ process.env.COMMHUB_UPLOADS_DIR = join(DIR, "uploads");
73
+ process.env.HOST = "127.0.0.1";
74
+ const stamp = Date.now();
75
+ const a = register(`gme_owner_${stamp}`, PW, undefined, "Owner");
76
+ expect(a.ok).toBe(true);
77
+ U.owner = { token: a.token!, id: a.user!.user_id, username: a.user!.username };
78
+ NET = a.network_id!;
79
+ db.run("UPDATE users SET role = 'admin' WHERE user_id = ?1", [U.owner.id]);
80
+ const mod: any = await import("./server.js");
81
+ hub = mod.bootServer({ port: 0, hostname: "127.0.0.1" });
82
+ BASE = `http://127.0.0.1:${hub.port}`;
83
+ const add = async (username: string, role: string) => {
84
+ expect((await send(U.owner.token, "POST", "/api/admin/users", { username, password: PW, network_id: NET, role })).status).toBe(200);
85
+ const login = await send("", "POST", "/api/auth/login", { username, password: PW });
86
+ expect(login.status).toBe(200);
87
+ return { token: login.body.token as string, id: login.body.user.user_id as string, username };
88
+ };
89
+ U.alice = await add(`gme_alice_${stamp}`, "member"); // 研发部(旁观的当前成员)
90
+ U.carol = await add(`gme_carol_${stamp}`, "member"); // 研发部,之后被调去市场部
91
+ U.dave = await add(`gme_dave_${stamp}`, "member"); // 市场部,被手动拉进 / 移出研发部群
92
+ U.erin = await add(`gme_erin_${stamp}`, "member"); // 未分配,之后调进研发部
93
+ U.frank = await add(`gme_frank_${stamp}`, "member"); // 未分配:回滚用例的对象
94
+ U.gina = await add(`gme_gina_${stamp}`, "member"); // 未分配:不相干的人 / 负责人用例
95
+ U.hank = await add(`gme_hank_${stamp}`, "member"); // 研发部,之后被移出网络
96
+
97
+ const mk = async (name: string, extra: Record<string, unknown> = {}) => {
98
+ const r = await send(U.owner.token, "POST", `/api/networks/${NET}/departments`, { name, ...extra });
99
+ expect(r.status).toBe(201);
100
+ return r.body.department.id as string;
101
+ };
102
+ DEPT.rd = await mk("研发部");
103
+ DEPT.market = await mk("市场部");
104
+ for (const w of ["alice", "carol", "hank"]) await place(w, DEPT.rd);
105
+ await place("dave", DEPT.market);
106
+ for (const key of ["rd", "market"]) {
107
+ const r = await send(U.owner.token, "POST", `/api/networks/${NET}/departments/${DEPT[key]}/group`, {});
108
+ expect(r.status).toBe(201);
109
+ GRP[key] = r.body.group.id;
110
+ }
111
+ for (const w of ["owner", "alice", "carol", "dave", "erin", "frank", "gina", "hank"]) S[w] = await subscribe(w);
112
+ }, 30_000);
113
+
114
+ afterAll(() => {
115
+ for (const s of Object.values(S)) try { s.close(); } catch {}
116
+ try { hub?.stop?.(true); } catch {}
117
+ try { rmSync(DIR, { recursive: true, force: true }); } catch {}
118
+ });
119
+
120
+ describe("manual add / remove", () => {
121
+ test("manual add: the added user and current members get one `added` event; outsiders get nothing", async () => {
122
+ await reset();
123
+ const r = await send(U.owner.token, "POST", CG(`/${GRP.rd}/members`), { user_id: U.dave.id });
124
+ expect(r.status).toBe(201);
125
+ await until(() => ["dave", "alice", "carol"].every((w) => match(w, "rd", "dave", "added", "manual").length > 0));
126
+ expect(match("dave", "rd", "dave", "added", "manual")).toHaveLength(1);
127
+ expect(match("alice", "rd", "dave", "added", "manual")).toHaveLength(1);
128
+ expect(match("carol", "rd", "dave", "added", "manual")).toHaveLength(1);
129
+ const ev = match("dave", "rd", "dave", "added", "manual")[0];
130
+ expect(ev).toMatchObject({ type: "group_membership_changed", network_id: NET, group_id: GRP.rd, member_user_id: U.dave.id, change: "added", source: "manual", scope: "user" });
131
+ expect(ev.user_id).toBe(U.dave.id); // 信封 user_id = 收件人
132
+ expect(match("alice", "rd", "dave", "added", "manual")[0].user_id).toBe(U.alice.id);
133
+ expect(new Date(ev.at).toISOString()).toBe(ev.at);
134
+ await sleep(100);
135
+ expect(mev("gina")).toHaveLength(0);
136
+ expect(mev("erin")).toHaveLength(0);
137
+ });
138
+
139
+ test("manual remove: the removed user and the remaining members get one `removed` event", async () => {
140
+ await reset();
141
+ const r = await send(U.owner.token, "DELETE", CG(`/${GRP.rd}/members/${U.dave.id}`));
142
+ expect(r.status).toBe(200);
143
+ await until(() => ["dave", "alice"].every((w) => match(w, "rd", "dave", "removed", "manual").length > 0));
144
+ expect(match("dave", "rd", "dave", "removed", "manual")).toHaveLength(1);
145
+ expect(match("alice", "rd", "dave", "removed", "manual")).toHaveLength(1);
146
+ await sleep(100);
147
+ expect(mev("gina")).toHaveLength(0);
148
+ });
149
+
150
+ test("a refused write (409 already_group_member) emits nothing", async () => {
151
+ await reset();
152
+ expect((await send(U.owner.token, "POST", CG(`/${GRP.rd}/members`), { user_id: U.alice.id })).status).toBe(409);
153
+ await sleep(150);
154
+ for (const w of Object.keys(S)) expect(mev(w)).toHaveLength(0);
155
+ });
156
+ });
157
+
158
+ describe("department sync", () => {
159
+ test("move-in: erin into 研发部 → `added`/department to erin and the 研发部 group's members", async () => {
160
+ await reset();
161
+ await place("erin", DEPT.rd);
162
+ await until(() => ["erin", "alice"].every((w) => match(w, "rd", "erin", "added", "department").length > 0));
163
+ expect(match("erin", "rd", "erin", "added", "department")).toHaveLength(1);
164
+ expect(match("alice", "rd", "erin", "added", "department")).toHaveLength(1);
165
+ await sleep(100);
166
+ expect(mev("dave")).toHaveLength(0); // 市场部群没变
167
+ expect(isGroupMember(GRP.rd, U.erin.id)).toBe(true);
168
+ });
169
+
170
+ test("move-out: carol 研发部 → 市场部 → removed from 研发部 group, added to 市场部 group", async () => {
171
+ await reset();
172
+ await place("carol", DEPT.market);
173
+ await until(() => ["carol", "alice"].every((w) => match(w, "rd", "carol", "removed", "department").length > 0) && ["carol", "dave"].every((w) => match(w, "market", "carol", "added", "department").length > 0));
174
+ expect(match("carol", "rd", "carol", "removed", "department")).toHaveLength(1);
175
+ expect(match("alice", "rd", "carol", "removed", "department")).toHaveLength(1);
176
+ expect(match("carol", "market", "carol", "added", "department")).toHaveLength(1);
177
+ expect(match("dave", "market", "carol", "added", "department")).toHaveLength(1);
178
+ // alice 不在市场部群:不该收到市场部群的变化
179
+ await sleep(100);
180
+ expect(mev("alice").filter((e) => e.group_id === GRP.market)).toHaveLength(0);
181
+ });
182
+
183
+ test("head change: gina made 研发部 leader joins the group; unsetting removes her", async () => {
184
+ await reset();
185
+ expect((await send(U.owner.token, "PATCH", `/api/networks/${NET}/departments/${DEPT.rd}`, { leader_user_id: U.gina.id })).status).toBe(200);
186
+ await until(() => ["gina", "alice"].every((w) => match(w, "rd", "gina", "added", "department").length > 0));
187
+ expect(match("gina", "rd", "gina", "added", "department")).toHaveLength(1);
188
+ expect(match("alice", "rd", "gina", "added", "department")).toHaveLength(1);
189
+ // 部门写会踢掉负责人的用户流(RFC-040,权限变了要重连重新鉴权)—— App 会重连;这里同样重订阅一次。
190
+ S.gina.close();
191
+ S.gina = await subscribe("gina");
192
+ await reset();
193
+ expect((await send(U.owner.token, "PATCH", `/api/networks/${NET}/departments/${DEPT.rd}`, { leader_user_id: null })).status).toBe(200);
194
+ await until(() => ["gina", "alice"].every((w) => match(w, "rd", "gina", "removed", "department").length > 0));
195
+ expect(match("gina", "rd", "gina", "removed", "department")).toHaveLength(1);
196
+ expect(match("alice", "rd", "gina", "removed", "department")).toHaveLength(1);
197
+ });
198
+
199
+ test("rename-only PATCH (no roster change) emits nothing", async () => {
200
+ await reset();
201
+ expect((await send(U.owner.token, "PATCH", `/api/networks/${NET}/departments/${DEPT.rd}`, { name: "研发中心" })).status).toBe(200);
202
+ await sleep(150);
203
+ for (const w of Object.keys(S)) expect(mev(w)).toHaveLength(0);
204
+ });
205
+ });
206
+
207
+ describe("post-commit only", () => {
208
+ test("a rolled-back write emits nothing and changes nothing", async () => {
209
+ await reset();
210
+ expect(() => groupTx(() => {
211
+ db.run("UPDATE network_members SET department_id = ?3 WHERE network_id = ?1 AND user_id = ?2", [NET, U.frank.id, DEPT.rd]);
212
+ syncDepartmentGroups(NET);
213
+ expect(isGroupMember(GRP.rd, U.frank.id)).toBe(true); // 事务里确实对过账
214
+ throw new Error("boom");
215
+ })).toThrow("boom");
216
+ expect(isGroupMember(GRP.rd, U.frank.id)).toBe(false);
217
+ await sleep(200);
218
+ for (const w of Object.keys(S)) expect(mev(w)).toHaveLength(0);
219
+ // 下一次提交的写也不会把回滚掉的那笔捎带出去
220
+ await place("erin", DEPT.rd); // 无变化的调人(erin 已在研发部)
221
+ await sleep(150);
222
+ for (const w of Object.keys(S)) expect(mev(w).filter((e) => e.member_user_id === U.frank.id)).toHaveLength(0);
223
+ });
224
+
225
+ test("an inner savepoint rollback drops only its own changes; the outer commit still emits", async () => {
226
+ await reset();
227
+ groupTx(() => {
228
+ db.run("UPDATE network_members SET department_id = ?3 WHERE network_id = ?1 AND user_id = ?2", [NET, U.gina.id, DEPT.rd]);
229
+ syncDepartmentGroups(NET);
230
+ try {
231
+ groupTx(() => {
232
+ db.run("UPDATE network_members SET department_id = ?3 WHERE network_id = ?1 AND user_id = ?2", [NET, U.frank.id, DEPT.rd]);
233
+ syncDepartmentGroups(NET);
234
+ throw new Error("inner");
235
+ });
236
+ } catch {}
237
+ // 事务还没提交:这时一条都不该推出去
238
+ expect(mev("alice")).toHaveLength(0);
239
+ });
240
+ expect(isGroupMember(GRP.rd, U.gina.id)).toBe(true);
241
+ expect(isGroupMember(GRP.rd, U.frank.id)).toBe(false);
242
+ await until(() => match("alice", "rd", "gina", "added", "department").length > 0);
243
+ expect(match("alice", "rd", "gina", "added", "department")).toHaveLength(1);
244
+ await sleep(100);
245
+ for (const w of Object.keys(S)) expect(mev(w).filter((e) => e.member_user_id === U.frank.id)).toHaveLength(0);
246
+ });
247
+ });
248
+
249
+ describe("network member removal", () => {
250
+ test("removing hank from the network → remaining 研发部 members get `removed`/network_removal", async () => {
251
+ // 调部门 / 换负责人会踢掉当事人的用户流(RFC-040,App 会重连):erin、gina 先重订阅。
252
+ for (const w of ["erin", "gina"]) { S[w].close(); S[w] = await subscribe(w); }
253
+ await reset();
254
+ const r = await send(U.owner.token, "DELETE", `/api/networks/${NET}/members/${U.hank.id}`);
255
+ expect(r.status).toBe(200);
256
+ await until(() => ["alice", "erin", "gina"].every((w) => match(w, "rd", "hank", "removed", "network_removal").length > 0));
257
+ expect(match("alice", "rd", "hank", "removed", "network_removal")).toHaveLength(1);
258
+ expect(match("erin", "rd", "hank", "removed", "network_removal")).toHaveLength(1);
259
+ expect(match("gina", "rd", "hank", "removed", "network_removal")).toHaveLength(1);
260
+ // 不能再有一条 department 来源的重复移出(移出网络已经删了所有行,对账没东西可删)
261
+ expect(match("alice", "rd", "hank", "removed", "department")).toHaveLength(0);
262
+ expect(isGroupMember(GRP.rd, U.hank.id)).toBe(false);
263
+ });
264
+ });