@mclawnet/swarm 0.1.4 → 0.1.6

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 (240) hide show
  1. package/README.md +118 -0
  2. package/dist/__tests__/action-parser.test.js +29 -82
  3. package/dist/__tests__/action-parser.test.js.map +1 -1
  4. package/dist/__tests__/coordinator-create-tx.test.d.ts +2 -0
  5. package/dist/__tests__/coordinator-create-tx.test.d.ts.map +1 -0
  6. package/dist/__tests__/coordinator-create-tx.test.js +114 -0
  7. package/dist/__tests__/coordinator-create-tx.test.js.map +1 -0
  8. package/dist/__tests__/coordinator-inbox-migration.test.d.ts +2 -0
  9. package/dist/__tests__/coordinator-inbox-migration.test.d.ts.map +1 -0
  10. package/dist/__tests__/coordinator-inbox-migration.test.js +56 -0
  11. package/dist/__tests__/coordinator-inbox-migration.test.js.map +1 -0
  12. package/dist/__tests__/inbox-integration.test.d.ts +2 -0
  13. package/dist/__tests__/inbox-integration.test.d.ts.map +1 -0
  14. package/dist/__tests__/inbox-integration.test.js +120 -0
  15. package/dist/__tests__/inbox-integration.test.js.map +1 -0
  16. package/dist/__tests__/inbox-persistence-recovery.test.d.ts +2 -0
  17. package/dist/__tests__/inbox-persistence-recovery.test.d.ts.map +1 -0
  18. package/dist/__tests__/inbox-persistence-recovery.test.js +139 -0
  19. package/dist/__tests__/inbox-persistence-recovery.test.js.map +1 -0
  20. package/dist/__tests__/inbox-relay-interceptor.test.d.ts +2 -0
  21. package/dist/__tests__/inbox-relay-interceptor.test.d.ts.map +1 -0
  22. package/dist/__tests__/inbox-relay-interceptor.test.js +156 -0
  23. package/dist/__tests__/inbox-relay-interceptor.test.js.map +1 -0
  24. package/dist/__tests__/inbox-relay.test.d.ts +2 -0
  25. package/dist/__tests__/inbox-relay.test.d.ts.map +1 -0
  26. package/dist/__tests__/inbox-relay.test.js +318 -0
  27. package/dist/__tests__/inbox-relay.test.js.map +1 -0
  28. package/dist/__tests__/inbox-store.test.d.ts +2 -0
  29. package/dist/__tests__/inbox-store.test.d.ts.map +1 -0
  30. package/dist/__tests__/inbox-store.test.js +129 -0
  31. package/dist/__tests__/inbox-store.test.js.map +1 -0
  32. package/dist/__tests__/inbox-watcher.test.d.ts +2 -0
  33. package/dist/__tests__/inbox-watcher.test.d.ts.map +1 -0
  34. package/dist/__tests__/inbox-watcher.test.js +104 -0
  35. package/dist/__tests__/inbox-watcher.test.js.map +1 -0
  36. package/dist/__tests__/persistence-path.test.d.ts +2 -0
  37. package/dist/__tests__/persistence-path.test.d.ts.map +1 -0
  38. package/dist/__tests__/persistence-path.test.js +79 -0
  39. package/dist/__tests__/persistence-path.test.js.map +1 -0
  40. package/dist/__tests__/persistence-robust.test.d.ts +2 -0
  41. package/dist/__tests__/persistence-robust.test.d.ts.map +1 -0
  42. package/dist/__tests__/persistence-robust.test.js +125 -0
  43. package/dist/__tests__/persistence-robust.test.js.map +1 -0
  44. package/dist/__tests__/persistence.test.d.ts +2 -0
  45. package/dist/__tests__/persistence.test.d.ts.map +1 -0
  46. package/dist/__tests__/persistence.test.js +105 -0
  47. package/dist/__tests__/persistence.test.js.map +1 -0
  48. package/dist/__tests__/phase4-5-e2e.test.d.ts +2 -0
  49. package/dist/__tests__/phase4-5-e2e.test.d.ts.map +1 -0
  50. package/dist/__tests__/phase4-5-e2e.test.js +203 -0
  51. package/dist/__tests__/phase4-5-e2e.test.js.map +1 -0
  52. package/dist/__tests__/phase6-7-e2e.test.d.ts +2 -0
  53. package/dist/__tests__/phase6-7-e2e.test.d.ts.map +1 -0
  54. package/dist/__tests__/phase6-7-e2e.test.js +93 -0
  55. package/dist/__tests__/phase6-7-e2e.test.js.map +1 -0
  56. package/dist/__tests__/project-files.test.d.ts +2 -0
  57. package/dist/__tests__/project-files.test.d.ts.map +1 -0
  58. package/dist/__tests__/project-files.test.js +143 -0
  59. package/dist/__tests__/project-files.test.js.map +1 -0
  60. package/dist/__tests__/projects-fs.test.d.ts +2 -0
  61. package/dist/__tests__/projects-fs.test.d.ts.map +1 -0
  62. package/dist/__tests__/projects-fs.test.js +107 -0
  63. package/dist/__tests__/projects-fs.test.js.map +1 -0
  64. package/dist/__tests__/recovery-cross-project.test.d.ts +2 -0
  65. package/dist/__tests__/recovery-cross-project.test.d.ts.map +1 -0
  66. package/dist/__tests__/recovery-cross-project.test.js +87 -0
  67. package/dist/__tests__/recovery-cross-project.test.js.map +1 -0
  68. package/dist/__tests__/recovery-forwards-to-coordinator.test.d.ts +2 -0
  69. package/dist/__tests__/recovery-forwards-to-coordinator.test.d.ts.map +1 -0
  70. package/dist/__tests__/recovery-forwards-to-coordinator.test.js +59 -0
  71. package/dist/__tests__/recovery-forwards-to-coordinator.test.js.map +1 -0
  72. package/dist/__tests__/recovery-resume.test.d.ts +2 -0
  73. package/dist/__tests__/recovery-resume.test.d.ts.map +1 -0
  74. package/dist/__tests__/recovery-resume.test.js +132 -0
  75. package/dist/__tests__/recovery-resume.test.js.map +1 -0
  76. package/dist/__tests__/retrospective.test.js +1 -0
  77. package/dist/__tests__/retrospective.test.js.map +1 -1
  78. package/dist/__tests__/role-loader-preamble-all.test.d.ts +2 -0
  79. package/dist/__tests__/role-loader-preamble-all.test.d.ts.map +1 -0
  80. package/dist/__tests__/role-loader-preamble-all.test.js +38 -0
  81. package/dist/__tests__/role-loader-preamble-all.test.js.map +1 -0
  82. package/dist/__tests__/role-loader-tools.test.d.ts +2 -0
  83. package/dist/__tests__/role-loader-tools.test.d.ts.map +1 -0
  84. package/dist/__tests__/role-loader-tools.test.js +39 -0
  85. package/dist/__tests__/role-loader-tools.test.js.map +1 -0
  86. package/dist/__tests__/role-loader.test.js +116 -1
  87. package/dist/__tests__/role-loader.test.js.map +1 -1
  88. package/dist/__tests__/role-prompt-no-legacy-protocol.test.d.ts +2 -0
  89. package/dist/__tests__/role-prompt-no-legacy-protocol.test.d.ts.map +1 -0
  90. package/dist/__tests__/role-prompt-no-legacy-protocol.test.js +37 -0
  91. package/dist/__tests__/role-prompt-no-legacy-protocol.test.js.map +1 -0
  92. package/dist/__tests__/role-tools.test.d.ts +2 -0
  93. package/dist/__tests__/role-tools.test.d.ts.map +1 -0
  94. package/dist/__tests__/role-tools.test.js +80 -0
  95. package/dist/__tests__/role-tools.test.js.map +1 -0
  96. package/dist/__tests__/spawn-role-injects-briefings.test.d.ts +2 -0
  97. package/dist/__tests__/spawn-role-injects-briefings.test.d.ts.map +1 -0
  98. package/dist/__tests__/spawn-role-injects-briefings.test.js +182 -0
  99. package/dist/__tests__/spawn-role-injects-briefings.test.js.map +1 -0
  100. package/dist/__tests__/spawn-role-tool-policy.test.d.ts +2 -0
  101. package/dist/__tests__/spawn-role-tool-policy.test.d.ts.map +1 -0
  102. package/dist/__tests__/spawn-role-tool-policy.test.js +96 -0
  103. package/dist/__tests__/spawn-role-tool-policy.test.js.map +1 -0
  104. package/dist/__tests__/swarm-coordinator-inbox-watcher.test.d.ts +2 -0
  105. package/dist/__tests__/swarm-coordinator-inbox-watcher.test.d.ts.map +1 -0
  106. package/dist/__tests__/swarm-coordinator-inbox-watcher.test.js +61 -0
  107. package/dist/__tests__/swarm-coordinator-inbox-watcher.test.js.map +1 -0
  108. package/dist/__tests__/swarm-coordinator-inbox.test.d.ts +2 -0
  109. package/dist/__tests__/swarm-coordinator-inbox.test.d.ts.map +1 -0
  110. package/dist/__tests__/swarm-coordinator-inbox.test.js +182 -0
  111. package/dist/__tests__/swarm-coordinator-inbox.test.js.map +1 -0
  112. package/dist/__tests__/swarm-coordinator-init.test.js +36 -8
  113. package/dist/__tests__/swarm-coordinator-init.test.js.map +1 -1
  114. package/dist/__tests__/swarm-coordinator-legacy-plan-review-warn.test.d.ts +2 -0
  115. package/dist/__tests__/swarm-coordinator-legacy-plan-review-warn.test.d.ts.map +1 -0
  116. package/dist/__tests__/swarm-coordinator-legacy-plan-review-warn.test.js +113 -0
  117. package/dist/__tests__/swarm-coordinator-legacy-plan-review-warn.test.js.map +1 -0
  118. package/dist/__tests__/swarm-coordinator-plan-review-intercept.test.d.ts +2 -0
  119. package/dist/__tests__/swarm-coordinator-plan-review-intercept.test.d.ts.map +1 -0
  120. package/dist/__tests__/swarm-coordinator-plan-review-intercept.test.js +465 -0
  121. package/dist/__tests__/swarm-coordinator-plan-review-intercept.test.js.map +1 -0
  122. package/dist/__tests__/swarm-coordinator-plan-review-recovery.test.d.ts +2 -0
  123. package/dist/__tests__/swarm-coordinator-plan-review-recovery.test.d.ts.map +1 -0
  124. package/dist/__tests__/swarm-coordinator-plan-review-recovery.test.js +284 -0
  125. package/dist/__tests__/swarm-coordinator-plan-review-recovery.test.js.map +1 -0
  126. package/dist/__tests__/swarm-coordinator-plan-review.test.d.ts +2 -0
  127. package/dist/__tests__/swarm-coordinator-plan-review.test.d.ts.map +1 -0
  128. package/dist/__tests__/swarm-coordinator-plan-review.test.js +294 -0
  129. package/dist/__tests__/swarm-coordinator-plan-review.test.js.map +1 -0
  130. package/dist/__tests__/swarm-coordinator-resume.test.d.ts +2 -0
  131. package/dist/__tests__/swarm-coordinator-resume.test.d.ts.map +1 -0
  132. package/dist/__tests__/swarm-coordinator-resume.test.js +93 -0
  133. package/dist/__tests__/swarm-coordinator-resume.test.js.map +1 -0
  134. package/dist/__tests__/swarm-coordinator-roleId.test.js +2 -2
  135. package/dist/__tests__/swarm-coordinator-roleId.test.js.map +1 -1
  136. package/dist/__tests__/swarm-destroy-detach.test.d.ts +2 -0
  137. package/dist/__tests__/swarm-destroy-detach.test.d.ts.map +1 -0
  138. package/dist/__tests__/swarm-destroy-detach.test.js +135 -0
  139. package/dist/__tests__/swarm-destroy-detach.test.js.map +1 -0
  140. package/dist/action-parser.d.ts +0 -9
  141. package/dist/action-parser.d.ts.map +1 -1
  142. package/dist/action-parser.js +0 -114
  143. package/dist/action-parser.js.map +1 -1
  144. package/dist/inbox-relay.d.ts +50 -0
  145. package/dist/inbox-relay.d.ts.map +1 -0
  146. package/dist/inbox-relay.js +168 -0
  147. package/dist/inbox-relay.js.map +1 -0
  148. package/dist/inbox-store.d.ts +25 -0
  149. package/dist/inbox-store.d.ts.map +1 -0
  150. package/dist/inbox-store.js +95 -0
  151. package/dist/inbox-store.js.map +1 -0
  152. package/dist/inbox-watcher.d.ts +13 -0
  153. package/dist/inbox-watcher.d.ts.map +1 -0
  154. package/dist/inbox-watcher.js +89 -0
  155. package/dist/inbox-watcher.js.map +1 -0
  156. package/dist/index.d.ts +8 -3
  157. package/dist/index.d.ts.map +1 -1
  158. package/dist/index.js +5 -2
  159. package/dist/index.js.map +1 -1
  160. package/dist/persistence.d.ts +19 -5
  161. package/dist/persistence.d.ts.map +1 -1
  162. package/dist/persistence.js +97 -22
  163. package/dist/persistence.js.map +1 -1
  164. package/dist/project-files.d.ts +60 -0
  165. package/dist/project-files.d.ts.map +1 -0
  166. package/dist/project-files.js +214 -0
  167. package/dist/project-files.js.map +1 -0
  168. package/dist/projects-fs.d.ts +28 -0
  169. package/dist/projects-fs.d.ts.map +1 -0
  170. package/dist/projects-fs.js +111 -0
  171. package/dist/projects-fs.js.map +1 -0
  172. package/dist/recovery.d.ts +12 -0
  173. package/dist/recovery.d.ts.map +1 -1
  174. package/dist/recovery.js +14 -19
  175. package/dist/recovery.js.map +1 -1
  176. package/dist/roles/role-loader.d.ts +28 -1
  177. package/dist/roles/role-loader.d.ts.map +1 -1
  178. package/dist/roles/role-loader.js +73 -1
  179. package/dist/roles/role-loader.js.map +1 -1
  180. package/dist/roles/role-tools.d.ts +16 -0
  181. package/dist/roles/role-tools.d.ts.map +1 -0
  182. package/dist/roles/role-tools.js +25 -0
  183. package/dist/roles/role-tools.js.map +1 -0
  184. package/dist/roles/types.d.ts +4 -0
  185. package/dist/roles/types.d.ts.map +1 -1
  186. package/dist/swarm-coordinator.d.ts +176 -12
  187. package/dist/swarm-coordinator.d.ts.map +1 -1
  188. package/dist/swarm-coordinator.js +863 -370
  189. package/dist/swarm-coordinator.js.map +1 -1
  190. package/dist/types.d.ts +26 -0
  191. package/dist/types.d.ts.map +1 -1
  192. package/package.json +9 -6
  193. package/roles/analyst-livermore.md +6 -30
  194. package/roles/designer-rams.md +2 -30
  195. package/roles/dev-torvalds.md +8 -44
  196. package/roles/developer.md +5 -21
  197. package/roles/director-jia.md +20 -49
  198. package/roles/editor-boyong.md +8 -40
  199. package/roles/macro-dalio.md +6 -30
  200. package/roles/planner-maoni.md +24 -53
  201. package/roles/pm-jobs.md +20 -71
  202. package/roles/preset-analyst-simons.md +2 -18
  203. package/roles/preset-architect-knuth.md +2 -18
  204. package/roles/preset-designer-norman.md +2 -18
  205. package/roles/preset-designer.md +2 -18
  206. package/roles/preset-dev-carmack.md +2 -18
  207. package/roles/preset-dev-gosling.md +2 -18
  208. package/roles/preset-developer.md +7 -23
  209. package/roles/preset-manager-grove.md +2 -18
  210. package/roles/preset-manager-musk.md +2 -18
  211. package/roles/preset-pm.md +7 -34
  212. package/roles/preset-researcher-feynman.md +2 -18
  213. package/roles/preset-reviewer.md +5 -21
  214. package/roles/preset-strategist-buffett.md +2 -18
  215. package/roles/preset-strategist-munger.md +2 -18
  216. package/roles/preset-strategist-sunzi.md +2 -18
  217. package/roles/preset-tester-beck.md +2 -18
  218. package/roles/preset-tester.md +5 -21
  219. package/roles/preset-writer-orwell.md +2 -18
  220. package/roles/preset-writer.md +2 -18
  221. package/roles/quant-simons.md +5 -32
  222. package/roles/queen.md +25 -41
  223. package/roles/reviewer-martin.md +11 -37
  224. package/roles/reviewer.md +20 -21
  225. package/roles/rhythm-tangsan.md +5 -29
  226. package/roles/risk-taleb.md +4 -32
  227. package/roles/script-shitiesheng.md +8 -31
  228. package/roles/storyboard-xuke.md +9 -29
  229. package/roles/strategist-soros.md +16 -73
  230. package/roles/tester-beck.md +4 -40
  231. package/roles/tester.md +5 -21
  232. package/roles/trader-jones.md +4 -32
  233. package/roles/vfx-guchangwei.md +8 -27
  234. package/roles/writer-zhouzi.md +7 -39
  235. package/templates/dev-team-pro.md +4 -1
  236. package/templates/dev-team.md +3 -1
  237. package/templates/minimal.md +2 -1
  238. package/templates/trading-team.md +6 -1
  239. package/templates/video-team.md +4 -1
  240. package/templates/writing-team.md +4 -1
@@ -0,0 +1,105 @@
1
+ import { describe, it, expect, beforeEach, afterEach } from "vitest";
2
+ import { mkdtempSync, rmSync, writeFileSync, mkdirSync } from "node:fs";
3
+ import { tmpdir } from "node:os";
4
+ import { join } from "node:path";
5
+ import { projectRoot } from "@mclawnet/task";
6
+ import { saveSwarmSnapshot, loadSwarmSnapshot, } from "../persistence.js";
7
+ let tempHome;
8
+ let workDir;
9
+ let prevHome;
10
+ function fakeSwarm(overrides = {}) {
11
+ return {
12
+ id: "swarm-1",
13
+ hubSessionId: "hub-1",
14
+ workDir,
15
+ teamName: "default",
16
+ roles: new Map(),
17
+ plan: null,
18
+ nextInstanceSeq: new Map(),
19
+ idleCheckCount: 0,
20
+ maxIdleChecks: 10,
21
+ isPaused: false,
22
+ status: "running",
23
+ planStatus: "none",
24
+ ...overrides,
25
+ };
26
+ }
27
+ beforeEach(() => {
28
+ tempHome = mkdtempSync(join(tmpdir(), "clawnet-persistence-ext-"));
29
+ workDir = mkdtempSync(join(tmpdir(), "clawnet-persistence-work-"));
30
+ prevHome = process.env.CLAWNET_HOME;
31
+ process.env.CLAWNET_HOME = tempHome;
32
+ });
33
+ afterEach(() => {
34
+ if (prevHome === undefined)
35
+ delete process.env.CLAWNET_HOME;
36
+ else
37
+ process.env.CLAWNET_HOME = prevHome;
38
+ rmSync(tempHome, { recursive: true, force: true });
39
+ rmSync(workDir, { recursive: true, force: true });
40
+ });
41
+ describe("persistence project-scoped path (re-verify)", () => {
42
+ it("saveSwarmSnapshot writes under projectRoot(workDir)/swarms/<id>/recovery.json", () => {
43
+ saveSwarmSnapshot(fakeSwarm({ id: "s-path" }));
44
+ const expectedDir = join(projectRoot(workDir, tempHome), "swarms", "s-path");
45
+ const snap = loadSwarmSnapshot(workDir, "s-path");
46
+ expect(snap).not.toBeNull();
47
+ // path is reachable by load -> write under expectedDir
48
+ expect(expectedDir.includes(join("projects"))).toBe(true);
49
+ });
50
+ });
51
+ describe("SwarmSnapshot extended fields", () => {
52
+ it("persists teamName and roles[].claudeSessionId, then reads them back", () => {
53
+ const swarm = fakeSwarm({
54
+ id: "s-ext",
55
+ teamName: "my-team",
56
+ roles: new Map([
57
+ [
58
+ "dev-1",
59
+ {
60
+ instanceId: "dev-1",
61
+ roleName: "developer",
62
+ status: "active",
63
+ currentTask: "implement",
64
+ claudeSessionId: "claude-abc",
65
+ },
66
+ ],
67
+ [
68
+ "qa-1",
69
+ {
70
+ instanceId: "qa-1",
71
+ roleName: "qa",
72
+ status: "idle",
73
+ },
74
+ ],
75
+ ]),
76
+ });
77
+ saveSwarmSnapshot(swarm);
78
+ const snap = loadSwarmSnapshot(workDir, "s-ext");
79
+ expect(snap).not.toBeNull();
80
+ expect(snap.teamName).toBe("my-team");
81
+ expect(snap.roles).toHaveLength(2);
82
+ const dev = snap.roles.find((r) => r.instanceId === "dev-1");
83
+ expect(dev.claudeSessionId).toBe("claude-abc");
84
+ const qa = snap.roles.find((r) => r.instanceId === "qa-1");
85
+ expect(qa.claudeSessionId).toBeUndefined();
86
+ });
87
+ it("loadSwarmSnapshot fallbacks teamName to 'default' when missing in legacy snapshot", () => {
88
+ const dir = join(projectRoot(workDir, tempHome), "swarms", "s-legacy");
89
+ mkdirSync(dir, { recursive: true });
90
+ const legacy = {
91
+ id: "s-legacy",
92
+ hubSessionId: "hub-legacy",
93
+ workDir,
94
+ roles: [],
95
+ plan: null,
96
+ nextInstanceSeq: {},
97
+ savedAt: Date.now(),
98
+ };
99
+ writeFileSync(join(dir, "recovery.json"), JSON.stringify(legacy));
100
+ const snap = loadSwarmSnapshot(workDir, "s-legacy");
101
+ expect(snap).not.toBeNull();
102
+ expect(snap.teamName).toBe("default");
103
+ });
104
+ });
105
+ //# sourceMappingURL=persistence.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"persistence.test.js","sourceRoot":"","sources":["../../src/__tests__/persistence.test.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=phase4-5-e2e.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"phase4-5-e2e.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/phase4-5-e2e.test.ts"],"names":[],"mappings":""}
@@ -0,0 +1,203 @@
1
+ import { describe, it, expect, vi, beforeEach, afterEach } from "vitest";
2
+ import { mkdtempSync, rmSync } from "node:fs";
3
+ import { tmpdir } from "node:os";
4
+ import { join } from "node:path";
5
+ import { TaskStore } from "@mclawnet/task";
6
+ // ── Mocks ─────────────────────────────────────────────────────────────
7
+ //
8
+ // We intentionally do NOT mock ../persistence.js or ../inbox-store.js /
9
+ // ../inbox-relay.js — Phase 4-5 e2e wants to exercise the real disk path
10
+ // for snapshot save/load + inbox append/drain. We DO mock the heavy
11
+ // downstream packages (memory/skill-manager/retrospective) and the logger
12
+ // so the test stays fast and side-effect free.
13
+ vi.mock("@mclawnet/logger", () => ({
14
+ createLogger: () => ({
15
+ info: vi.fn(),
16
+ warn: vi.fn(),
17
+ error: vi.fn(),
18
+ debug: vi.fn(),
19
+ }),
20
+ }));
21
+ vi.mock("../retrospective.js", () => ({
22
+ runRetrospective: vi.fn(async () => null),
23
+ }));
24
+ vi.mock("@mclawnet/memory", () => ({
25
+ BUILTIN_ROLES: {},
26
+ initDatabase: vi.fn(() => ({ close: () => { } })),
27
+ syncToAutoMemory: vi.fn(),
28
+ }));
29
+ vi.mock("@mclawnet/skill-manager", () => ({
30
+ EvolutionPipeline: vi.fn().mockImplementation(() => ({
31
+ process: vi.fn(async () => { }),
32
+ })),
33
+ }));
34
+ import { SwarmCoordinator } from "../swarm-coordinator.js";
35
+ import { saveSwarmSnapshot, loadSwarmSnapshot } from "../persistence.js";
36
+ import { InboxStore } from "../inbox-store.js";
37
+ import { loadRole } from "../roles/role-loader.js";
38
+ function createRecordingSessionAdapter() {
39
+ const _calls = [];
40
+ const _inputs = [];
41
+ const adapter = {
42
+ _calls,
43
+ _inputs,
44
+ createSession: vi.fn(async (opts) => {
45
+ _calls.push({
46
+ sessionId: opts.sessionId,
47
+ resumeId: opts.resumeId,
48
+ workDir: opts.workDir,
49
+ });
50
+ return `proc-${opts.sessionId}`;
51
+ }),
52
+ sendInput: vi.fn((sessionId, input) => {
53
+ _inputs.push({ sessionId, input });
54
+ }),
55
+ closeSession: vi.fn(async () => { }),
56
+ };
57
+ return adapter;
58
+ }
59
+ function createMockHubAdapter() {
60
+ return { send: vi.fn() };
61
+ }
62
+ let HOME;
63
+ let WORK;
64
+ beforeEach(() => {
65
+ HOME = mkdtempSync(join(tmpdir(), "swarm-p45-home-"));
66
+ WORK = mkdtempSync(join(tmpdir(), "swarm-p45-work-"));
67
+ // swarm/persistence + inbox-store + detachTasks all honour CLAWNET_HOME
68
+ // (the user-home root). TaskStore.projectRoot() appends `.clawnet/` itself,
69
+ // so we point HOME at a fresh tmp dir and never set CLAWNET_DIR — that
70
+ // older env var caused a `.clawnet/.clawnet/` ghost layout for detach.
71
+ process.env.CLAWNET_HOME = HOME;
72
+ });
73
+ afterEach(() => {
74
+ rmSync(HOME, { recursive: true, force: true });
75
+ rmSync(WORK, { recursive: true, force: true });
76
+ delete process.env.CLAWNET_HOME;
77
+ });
78
+ // ──────────────────────────────────────────────────────────────────────
79
+ // Scenario A: create → seed tasks → destroy → tasks detached + snapshot gone
80
+ // ──────────────────────────────────────────────────────────────────────
81
+ describe("Phase 4-5 e2e — destroy() detaches tasks and removes snapshot", () => {
82
+ it("create+destroy lifecycle leaves tasks orphaned (swarmId/owner=null) and snapshot deleted", async () => {
83
+ const sessionAdapter = createRecordingSessionAdapter();
84
+ const hubAdapter = createMockHubAdapter();
85
+ const coord = new SwarmCoordinator(sessionAdapter, hubAdapter);
86
+ // 1. create() with templateName="minimal" — preset template that exists
87
+ // on disk and yields a queen+developer pair (queen eager, dev lazy).
88
+ // SwarmCoordinator.create() now propagates templateName to swarm.teamName,
89
+ // which saveSwarmSnapshot then persists.
90
+ await coord.create("S1", {
91
+ workDir: WORK,
92
+ templateName: "minimal",
93
+ });
94
+ // 2. Snapshot should exist with teamName="minimal" + queen role spawned.
95
+ const snap1 = loadSwarmSnapshot(WORK, "S1");
96
+ expect(snap1).not.toBeNull();
97
+ expect(snap1.teamName).toBe("minimal");
98
+ const queenSnap = snap1.roles.find((r) => r.roleName === "queen");
99
+ expect(queenSnap, "queen role should be in snapshot").toBeDefined();
100
+ expect(queenSnap.instanceId).toBe("queen-0");
101
+ // 3. Seed a couple of tasks owned by S1 + one foreign task we don't expect
102
+ // to be touched on destroy.
103
+ const store = new TaskStore({
104
+ workDir: WORK,
105
+ home: HOME,
106
+ });
107
+ const t1 = await store.create({
108
+ teamName: "minimal",
109
+ subject: "t1",
110
+ swarmId: "S1",
111
+ owner: "queen-0",
112
+ });
113
+ const t2 = await store.create({
114
+ teamName: "minimal",
115
+ subject: "t2",
116
+ swarmId: "S1",
117
+ owner: "queen-0",
118
+ });
119
+ const tOther = await store.create({
120
+ teamName: "minimal",
121
+ subject: "tOther",
122
+ swarmId: "other-swarm",
123
+ owner: "dev-1",
124
+ });
125
+ // 4. Destroy → detach tasks + delete snapshot
126
+ await coord.destroy("S1");
127
+ for (const id of [t1.id, t2.id]) {
128
+ const t = store.get(id);
129
+ expect(t.swarmId).toBeNull();
130
+ expect(t.owner).toBeNull();
131
+ expect(t.status).toBe("pending");
132
+ }
133
+ const o = store.get(tOther.id);
134
+ expect(o.swarmId).toBe("other-swarm");
135
+ expect(o.owner).toBe("dev-1");
136
+ expect(loadSwarmSnapshot(WORK, "S1")).toBeNull();
137
+ });
138
+ });
139
+ // ──────────────────────────────────────────────────────────────────────
140
+ // Scenario B: seed snapshot + inbox → recover() resumes with claudeSessionId
141
+ // and drains pending inbox via inboxRelay
142
+ // ──────────────────────────────────────────────────────────────────────
143
+ describe("Phase 4-5 e2e — recover() resumes with claudeSessionId + drains inbox", () => {
144
+ it("recover spawns queen with resumeId from snapshot and pushes pending inbox", async () => {
145
+ // Build a swarm + persist it directly via the real persistence layer.
146
+ // We deliberately bypass coordinator.create() so the snapshot reflects
147
+ // exactly the per-role claudeSessionId we want recover() to consume.
148
+ const queenDef = loadRole("queen");
149
+ const queen = {
150
+ instanceId: "queen-0",
151
+ roleName: "queen",
152
+ definition: queenDef,
153
+ roleSessionId: "S1::queen-0",
154
+ status: "active",
155
+ claudeSessionId: "sess-1",
156
+ };
157
+ const seedSwarm = {
158
+ id: "S1",
159
+ hubSessionId: "S1",
160
+ workDir: WORK,
161
+ teamName: "minimal",
162
+ roles: new Map([["queen-0", queen]]),
163
+ plan: null,
164
+ nextInstanceSeq: new Map([["queen", 1]]),
165
+ idleCheckCount: 0,
166
+ maxIdleChecks: 10,
167
+ isPaused: true,
168
+ status: "paused",
169
+ planStatus: "none",
170
+ };
171
+ saveSwarmSnapshot(seedSwarm);
172
+ // Sanity: the snapshot must persist the claudeSessionId we just stored.
173
+ const persisted = loadSwarmSnapshot(WORK, "S1");
174
+ expect(persisted.roles[0].claudeSessionId).toBe("sess-1");
175
+ // Drop a pending inbox message addressed to queen-0 so the recover()
176
+ // drain pass has something to push through inboxRelay.deliver().
177
+ const inbox = new InboxStore(WORK, "S1");
178
+ await inbox.append("queen-0", {
179
+ id: "inbox-msg-1",
180
+ from: "user",
181
+ type: "task",
182
+ data: "hello after restart",
183
+ timestamp: Date.now(),
184
+ delivered: false,
185
+ });
186
+ // Fresh coordinator instance — simulate process restart.
187
+ const sessionAdapter = createRecordingSessionAdapter();
188
+ const hubAdapter = createMockHubAdapter();
189
+ const coord2 = new SwarmCoordinator(sessionAdapter, hubAdapter);
190
+ await coord2.recover("S1");
191
+ // Queen should have been respawned via SessionAdapter with resumeId
192
+ // wired through from snapshot.claudeSessionId.
193
+ const queenCall = sessionAdapter._calls.find((c) => c.sessionId === "S1::queen-0");
194
+ expect(queenCall, "queen createSession call").toBeDefined();
195
+ expect(queenCall.resumeId).toBe("sess-1");
196
+ // Drain pass should have produced at least one sendInput targeted at
197
+ // queen-0 wrapping our pending inbox message in <info_for_agent>.
198
+ const queenInputs = sessionAdapter._inputs.filter((i) => i.sessionId === "S1::queen-0" && i.input.includes("<info_for_agent>"));
199
+ expect(queenInputs.length).toBeGreaterThanOrEqual(1);
200
+ expect(queenInputs[queenInputs.length - 1].input).toContain("hello after restart");
201
+ });
202
+ });
203
+ //# sourceMappingURL=phase4-5-e2e.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"phase4-5-e2e.test.js","sourceRoot":"","sources":["../../src/__tests__/phase4-5-e2e.test.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=phase6-7-e2e.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"phase6-7-e2e.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/phase6-7-e2e.test.ts"],"names":[],"mappings":""}
@@ -0,0 +1,93 @@
1
+ import { describe, it, expect, vi } from "vitest";
2
+ import { mkdtempSync } from "node:fs";
3
+ import { tmpdir } from "node:os";
4
+ import { join } from "node:path";
5
+ import { TaskStore } from "@mclawnet/task";
6
+ vi.mock("@mclawnet/logger", () => ({
7
+ createLogger: () => ({
8
+ info: vi.fn(),
9
+ warn: vi.fn(),
10
+ error: vi.fn(),
11
+ debug: vi.fn(),
12
+ }),
13
+ }));
14
+ vi.mock("../persistence.js", () => ({
15
+ saveSwarmSnapshot: vi.fn(),
16
+ deleteSwarmSnapshot: vi.fn(),
17
+ appendMessageLog: vi.fn(),
18
+ loadSwarmSnapshot: vi.fn(() => null),
19
+ readMessageLog: vi.fn(() => []),
20
+ listRecoverableSwarmIds: vi.fn(() => []),
21
+ }));
22
+ vi.mock("../retrospective.js", () => ({
23
+ runRetrospective: vi.fn(async () => null),
24
+ }));
25
+ vi.mock("@mclawnet/memory", () => ({
26
+ BUILTIN_ROLES: {},
27
+ initDatabase: vi.fn(() => ({ close: () => { } })),
28
+ syncToAutoMemory: vi.fn(),
29
+ }));
30
+ vi.mock("@mclawnet/skill-manager", () => ({
31
+ EvolutionPipeline: vi.fn().mockImplementation(() => ({
32
+ process: vi.fn(async () => { }),
33
+ })),
34
+ }));
35
+ import { SwarmCoordinator } from "../swarm-coordinator.js";
36
+ describe("Phase 6+7 e2e — briefing wires through to spawnRole", () => {
37
+ it("worker spawn produces a system prompt containing task subject + briefing anchor", async () => {
38
+ const workDir = mkdtempSync(join(tmpdir(), "phase6-7-e2e-work-"));
39
+ const home = mkdtempSync(join(tmpdir(), "phase6-7-e2e-home-"));
40
+ process.env.CLAWNET_DIR = home;
41
+ const store = new TaskStore({ workDir, home });
42
+ const swarmId = "sw-e2e";
43
+ const created = await store.create({
44
+ teamName: "dev",
45
+ subject: "ship E2E feature",
46
+ swarmId,
47
+ owner: "dev-0",
48
+ });
49
+ expect(created.subject).toBe("ship E2E feature");
50
+ const calls = [];
51
+ const sessionAdapter = {
52
+ createSession: vi.fn(async (opts) => {
53
+ calls.push(opts);
54
+ return `proc-${opts.sessionId}`;
55
+ }),
56
+ sendInput: vi.fn(),
57
+ closeSession: vi.fn(async () => { }),
58
+ };
59
+ const hubAdapter = { send: vi.fn() };
60
+ const coord = new SwarmCoordinator(sessionAdapter, hubAdapter, store);
61
+ // Pre-seed the swarm so spawnRole works without a full create() path
62
+ // (avoids template-loader / queen init coupling).
63
+ coord.swarms.set(swarmId, {
64
+ id: swarmId,
65
+ hubSessionId: swarmId,
66
+ workDir,
67
+ home,
68
+ roles: new Map(),
69
+ plan: null,
70
+ nextInstanceSeq: new Map(),
71
+ idleCheckCount: 0,
72
+ maxIdleChecks: 10,
73
+ isPaused: false,
74
+ status: "running",
75
+ planStatus: "none",
76
+ });
77
+ await coord.spawnRole(swarmId, "developer", undefined, "developer body", {
78
+ name: "developer",
79
+ shortName: "dev",
80
+ description: "dev",
81
+ capabilities: [],
82
+ color: "#fff",
83
+ promptBody: "developer body",
84
+ });
85
+ expect(calls).toHaveLength(1);
86
+ const prompt = calls[0].systemPrompt;
87
+ expect(prompt).toContain("### 任务上下文");
88
+ expect(prompt).toContain("### 你的任务简报");
89
+ expect(prompt).toContain("ship E2E feature");
90
+ expect(prompt).toContain("### 成员引导");
91
+ });
92
+ });
93
+ //# sourceMappingURL=phase6-7-e2e.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"phase6-7-e2e.test.js","sourceRoot":"","sources":["../../src/__tests__/phase6-7-e2e.test.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=project-files.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"project-files.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/project-files.test.ts"],"names":[],"mappings":""}
@@ -0,0 +1,143 @@
1
+ import { describe, it, expect, beforeEach, afterEach } from "vitest";
2
+ import { mkdtempSync, mkdirSync, writeFileSync, readFileSync, rmSync, symlinkSync, existsSync } from "node:fs";
3
+ import { tmpdir } from "node:os";
4
+ import { join } from "node:path";
5
+ import { PROJECT_FILE_WHITELIST, ProjectFilesError, isWhitelistedRelPath, listProjectFiles, readProjectFile, writeProjectFile, } from "../project-files.js";
6
+ let workDir;
7
+ beforeEach(() => {
8
+ workDir = mkdtempSync(join(tmpdir(), "clawnet-project-files-"));
9
+ });
10
+ afterEach(() => {
11
+ rmSync(workDir, { recursive: true, force: true });
12
+ });
13
+ describe("isWhitelistedRelPath", () => {
14
+ it("accepts the four canonical paths", () => {
15
+ for (const p of PROJECT_FILE_WHITELIST)
16
+ expect(isWhitelistedRelPath(p)).toBe(true);
17
+ });
18
+ it("rejects everything else", () => {
19
+ for (const p of [
20
+ "claude.md", // wrong case
21
+ "../CLAUDE.md", // traversal
22
+ ".claude/rules/x.md", // not in P1 whitelist
23
+ ".git/config",
24
+ "",
25
+ "CLAUDE.md/", // trailing slash mismatch
26
+ ])
27
+ expect(isWhitelistedRelPath(p)).toBe(false);
28
+ });
29
+ });
30
+ describe("listProjectFiles", () => {
31
+ it("returns whitelist entries with exists=false when nothing on disk", () => {
32
+ const files = listProjectFiles(workDir);
33
+ expect(files).toHaveLength(PROJECT_FILE_WHITELIST.length);
34
+ for (const f of files) {
35
+ expect(f.exists).toBe(false);
36
+ expect(f.loadedByCli).toBe(true);
37
+ }
38
+ });
39
+ it("reports size + mtime for files that exist", () => {
40
+ writeFileSync(join(workDir, "CLAUDE.md"), "hi");
41
+ const files = listProjectFiles(workDir);
42
+ const claude = files.find((f) => f.relPath === "CLAUDE.md");
43
+ expect(claude.exists).toBe(true);
44
+ expect(claude.size).toBe(2);
45
+ expect(typeof claude.mtime).toBe("number");
46
+ });
47
+ it("does not throw when workDir was deleted out from under us", () => {
48
+ rmSync(workDir, { recursive: true, force: true });
49
+ const files = listProjectFiles(workDir);
50
+ expect(files.every((f) => !f.exists)).toBe(true);
51
+ });
52
+ });
53
+ describe("readProjectFile", () => {
54
+ it("returns empty content + valid etag for a missing file", () => {
55
+ const r = readProjectFile(workDir, "CLAUDE.md");
56
+ expect(r.content).toBe("");
57
+ expect(r.etag).toMatch(/^[0-9a-f]{12}$/);
58
+ expect(r.mtime).toBe(0);
59
+ });
60
+ it("reads existing file content", () => {
61
+ writeFileSync(join(workDir, "CLAUDE.md"), "always reply in chinese\n");
62
+ const r = readProjectFile(workDir, "CLAUDE.md");
63
+ expect(r.content).toBe("always reply in chinese\n");
64
+ expect(r.mtime).toBeGreaterThan(0);
65
+ });
66
+ it("rejects non-whitelisted paths", () => {
67
+ expect(() => readProjectFile(workDir, "../etc/passwd")).toThrow(ProjectFilesError);
68
+ expect(() => readProjectFile(workDir, ".git/config")).toThrow(ProjectFilesError);
69
+ });
70
+ it("rejects symlinks pointing outside workDir", () => {
71
+ // Create an outside-workDir target that definitely exists.
72
+ const outside = mkdtempSync(join(tmpdir(), "clawnet-outside-"));
73
+ const target = join(outside, "leaked.md");
74
+ writeFileSync(target, "secret");
75
+ mkdirSync(join(workDir, ".claude"));
76
+ try {
77
+ symlinkSync(target, join(workDir, ".claude", "CLAUDE.md"));
78
+ }
79
+ catch {
80
+ rmSync(outside, { recursive: true, force: true });
81
+ return; // skip on platforms where we can't symlink
82
+ }
83
+ try {
84
+ expect(() => readProjectFile(workDir, ".claude/CLAUDE.md")).toThrow(ProjectFilesError);
85
+ }
86
+ finally {
87
+ rmSync(outside, { recursive: true, force: true });
88
+ }
89
+ });
90
+ });
91
+ describe("writeProjectFile", () => {
92
+ it("creates the file when it does not exist", () => {
93
+ const r = writeProjectFile(workDir, "CLAUDE.md", "hello");
94
+ expect(r.content).toBe("hello\n"); // md gets trailing newline
95
+ expect(readFileSync(join(workDir, "CLAUDE.md"), "utf-8")).toBe("hello\n");
96
+ });
97
+ it("creates .claude/ directory automatically", () => {
98
+ writeProjectFile(workDir, ".claude/settings.json", '{"foo":1}');
99
+ expect(existsSync(join(workDir, ".claude"))).toBe(true);
100
+ expect(readFileSync(join(workDir, ".claude", "settings.json"), "utf-8")).toBe('{"foo":1}');
101
+ });
102
+ it("rejects invalid JSON for .json files", () => {
103
+ expect(() => writeProjectFile(workDir, ".claude/settings.json", "{not json")).toThrow(ProjectFilesError);
104
+ expect(existsSync(join(workDir, ".claude", "settings.json"))).toBe(false);
105
+ });
106
+ it("normalizes empty JSON to '{}'", () => {
107
+ writeProjectFile(workDir, ".claude/settings.json", "");
108
+ const txt = readFileSync(join(workDir, ".claude", "settings.json"), "utf-8");
109
+ expect(txt).toBe("{}\n");
110
+ });
111
+ it("etag mismatch returns 409 with current content", () => {
112
+ writeProjectFile(workDir, "CLAUDE.md", "v1");
113
+ expect(() => writeProjectFile(workDir, "CLAUDE.md", "v2", { ifMatchEtag: "stale-etag" })).toThrow(ProjectFilesError);
114
+ try {
115
+ writeProjectFile(workDir, "CLAUDE.md", "v2", { ifMatchEtag: "stale-etag" });
116
+ }
117
+ catch (err) {
118
+ const e = err;
119
+ expect(e.status).toBe(409);
120
+ expect(e.details?.currentContent).toBe("v1\n");
121
+ }
122
+ });
123
+ it("etag match permits the write", () => {
124
+ const first = writeProjectFile(workDir, "CLAUDE.md", "v1");
125
+ const second = writeProjectFile(workDir, "CLAUDE.md", "v2", { ifMatchEtag: first.etag });
126
+ expect(second.content).toBe("v2\n");
127
+ expect(second.etag).not.toBe(first.etag);
128
+ });
129
+ it("rejects non-whitelisted writes", () => {
130
+ expect(() => writeProjectFile(workDir, "../escape.md", "x")).toThrow(ProjectFilesError);
131
+ });
132
+ it("write is atomic (no partial file visible if rename fails — smoke check via tmp cleanup)", () => {
133
+ writeProjectFile(workDir, "CLAUDE.md", "atomic");
134
+ // Confirm no `.tmp` siblings remain.
135
+ const entries = readFileSync(join(workDir, "CLAUDE.md"), "utf-8");
136
+ expect(entries).toBe("atomic\n");
137
+ // The tmp pattern is `.<hex>.tmp` — none should remain.
138
+ const dirents = require("node:fs").readdirSync(workDir);
139
+ for (const d of dirents)
140
+ expect(d).not.toMatch(/^\..*\.tmp$/);
141
+ });
142
+ });
143
+ //# sourceMappingURL=project-files.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"project-files.test.js","sourceRoot":"","sources":["../../src/__tests__/project-files.test.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=projects-fs.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"projects-fs.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/projects-fs.test.ts"],"names":[],"mappings":""}