@citadel-labs/citadel 0.1.0

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 (307) hide show
  1. package/README.md +145 -0
  2. package/dist/__tests__/append-bead.test.d.ts +2 -0
  3. package/dist/__tests__/append-bead.test.d.ts.map +1 -0
  4. package/dist/__tests__/append-bead.test.js +88 -0
  5. package/dist/__tests__/append-bead.test.js.map +1 -0
  6. package/dist/__tests__/blocked-outposts.test.d.ts +2 -0
  7. package/dist/__tests__/blocked-outposts.test.d.ts.map +1 -0
  8. package/dist/__tests__/blocked-outposts.test.js +142 -0
  9. package/dist/__tests__/blocked-outposts.test.js.map +1 -0
  10. package/dist/__tests__/bugfixes.test.d.ts +2 -0
  11. package/dist/__tests__/bugfixes.test.d.ts.map +1 -0
  12. package/dist/__tests__/bugfixes.test.js +503 -0
  13. package/dist/__tests__/bugfixes.test.js.map +1 -0
  14. package/dist/__tests__/citizen-tribute.test.d.ts +2 -0
  15. package/dist/__tests__/citizen-tribute.test.d.ts.map +1 -0
  16. package/dist/__tests__/citizen-tribute.test.js +106 -0
  17. package/dist/__tests__/citizen-tribute.test.js.map +1 -0
  18. package/dist/__tests__/cli-e2e/dispatch-note-resolve.test.d.ts +2 -0
  19. package/dist/__tests__/cli-e2e/dispatch-note-resolve.test.d.ts.map +1 -0
  20. package/dist/__tests__/cli-e2e/dispatch-note-resolve.test.js +65 -0
  21. package/dist/__tests__/cli-e2e/dispatch-note-resolve.test.js.map +1 -0
  22. package/dist/__tests__/cli-e2e/full-lifecycle.test.d.ts +2 -0
  23. package/dist/__tests__/cli-e2e/full-lifecycle.test.d.ts.map +1 -0
  24. package/dist/__tests__/cli-e2e/full-lifecycle.test.js +157 -0
  25. package/dist/__tests__/cli-e2e/full-lifecycle.test.js.map +1 -0
  26. package/dist/__tests__/cli-e2e/helpers.d.ts +28 -0
  27. package/dist/__tests__/cli-e2e/helpers.d.ts.map +1 -0
  28. package/dist/__tests__/cli-e2e/helpers.js +76 -0
  29. package/dist/__tests__/cli-e2e/helpers.js.map +1 -0
  30. package/dist/__tests__/cli-e2e/init-outpost-status.test.d.ts +2 -0
  31. package/dist/__tests__/cli-e2e/init-outpost-status.test.d.ts.map +1 -0
  32. package/dist/__tests__/cli-e2e/init-outpost-status.test.js +79 -0
  33. package/dist/__tests__/cli-e2e/init-outpost-status.test.js.map +1 -0
  34. package/dist/__tests__/cli-e2e/reset-stop-tribute-trace.test.d.ts +2 -0
  35. package/dist/__tests__/cli-e2e/reset-stop-tribute-trace.test.d.ts.map +1 -0
  36. package/dist/__tests__/cli-e2e/reset-stop-tribute-trace.test.js +158 -0
  37. package/dist/__tests__/cli-e2e/reset-stop-tribute-trace.test.js.map +1 -0
  38. package/dist/__tests__/courier.test.d.ts +2 -0
  39. package/dist/__tests__/courier.test.d.ts.map +1 -0
  40. package/dist/__tests__/courier.test.js +97 -0
  41. package/dist/__tests__/courier.test.js.map +1 -0
  42. package/dist/__tests__/e2e-smoke.test.d.ts +2 -0
  43. package/dist/__tests__/e2e-smoke.test.d.ts.map +1 -0
  44. package/dist/__tests__/e2e-smoke.test.js +137 -0
  45. package/dist/__tests__/e2e-smoke.test.js.map +1 -0
  46. package/dist/__tests__/fo-broadcast.test.d.ts +2 -0
  47. package/dist/__tests__/fo-broadcast.test.d.ts.map +1 -0
  48. package/dist/__tests__/fo-broadcast.test.js +134 -0
  49. package/dist/__tests__/fo-broadcast.test.js.map +1 -0
  50. package/dist/__tests__/fo-command-processor.test.d.ts +2 -0
  51. package/dist/__tests__/fo-command-processor.test.d.ts.map +1 -0
  52. package/dist/__tests__/fo-command-processor.test.js +86 -0
  53. package/dist/__tests__/fo-command-processor.test.js.map +1 -0
  54. package/dist/__tests__/fo-escalation.test.d.ts +2 -0
  55. package/dist/__tests__/fo-escalation.test.d.ts.map +1 -0
  56. package/dist/__tests__/fo-escalation.test.js +126 -0
  57. package/dist/__tests__/fo-escalation.test.js.map +1 -0
  58. package/dist/__tests__/fo-nudge-watcher.test.d.ts +2 -0
  59. package/dist/__tests__/fo-nudge-watcher.test.d.ts.map +1 -0
  60. package/dist/__tests__/fo-nudge-watcher.test.js +154 -0
  61. package/dist/__tests__/fo-nudge-watcher.test.js.map +1 -0
  62. package/dist/__tests__/fo-nudge-wiring.test.d.ts +2 -0
  63. package/dist/__tests__/fo-nudge-wiring.test.d.ts.map +1 -0
  64. package/dist/__tests__/fo-nudge-wiring.test.js +31 -0
  65. package/dist/__tests__/fo-nudge-wiring.test.js.map +1 -0
  66. package/dist/__tests__/fo-relay.test.d.ts +2 -0
  67. package/dist/__tests__/fo-relay.test.d.ts.map +1 -0
  68. package/dist/__tests__/fo-relay.test.js +90 -0
  69. package/dist/__tests__/fo-relay.test.js.map +1 -0
  70. package/dist/__tests__/fo-task-report.test.d.ts +2 -0
  71. package/dist/__tests__/fo-task-report.test.d.ts.map +1 -0
  72. package/dist/__tests__/fo-task-report.test.js +81 -0
  73. package/dist/__tests__/fo-task-report.test.js.map +1 -0
  74. package/dist/__tests__/fo-webhook.test.d.ts +2 -0
  75. package/dist/__tests__/fo-webhook.test.d.ts.map +1 -0
  76. package/dist/__tests__/fo-webhook.test.js +70 -0
  77. package/dist/__tests__/fo-webhook.test.js.map +1 -0
  78. package/dist/__tests__/integration.test.d.ts +2 -0
  79. package/dist/__tests__/integration.test.d.ts.map +1 -0
  80. package/dist/__tests__/integration.test.js +763 -0
  81. package/dist/__tests__/integration.test.js.map +1 -0
  82. package/dist/__tests__/multi-outpost-dep.test.d.ts +2 -0
  83. package/dist/__tests__/multi-outpost-dep.test.d.ts.map +1 -0
  84. package/dist/__tests__/multi-outpost-dep.test.js +173 -0
  85. package/dist/__tests__/multi-outpost-dep.test.js.map +1 -0
  86. package/dist/__tests__/nudge.test.d.ts +2 -0
  87. package/dist/__tests__/nudge.test.d.ts.map +1 -0
  88. package/dist/__tests__/nudge.test.js +103 -0
  89. package/dist/__tests__/nudge.test.js.map +1 -0
  90. package/dist/__tests__/outpost-registry.test.d.ts +2 -0
  91. package/dist/__tests__/outpost-registry.test.d.ts.map +1 -0
  92. package/dist/__tests__/outpost-registry.test.js +72 -0
  93. package/dist/__tests__/outpost-registry.test.js.map +1 -0
  94. package/dist/__tests__/process-registry.test.d.ts +2 -0
  95. package/dist/__tests__/process-registry.test.d.ts.map +1 -0
  96. package/dist/__tests__/process-registry.test.js +108 -0
  97. package/dist/__tests__/process-registry.test.js.map +1 -0
  98. package/dist/__tests__/session-log.test.d.ts +2 -0
  99. package/dist/__tests__/session-log.test.d.ts.map +1 -0
  100. package/dist/__tests__/session-log.test.js +60 -0
  101. package/dist/__tests__/session-log.test.js.map +1 -0
  102. package/dist/__tests__/spawn-citizen.test.d.ts +2 -0
  103. package/dist/__tests__/spawn-citizen.test.d.ts.map +1 -0
  104. package/dist/__tests__/spawn-citizen.test.js +48 -0
  105. package/dist/__tests__/spawn-citizen.test.js.map +1 -0
  106. package/dist/__tests__/timeout-watchdog.test.d.ts +2 -0
  107. package/dist/__tests__/timeout-watchdog.test.d.ts.map +1 -0
  108. package/dist/__tests__/timeout-watchdog.test.js +81 -0
  109. package/dist/__tests__/timeout-watchdog.test.js.map +1 -0
  110. package/dist/__tests__/worktree-manager.test.d.ts +2 -0
  111. package/dist/__tests__/worktree-manager.test.d.ts.map +1 -0
  112. package/dist/__tests__/worktree-manager.test.js +98 -0
  113. package/dist/__tests__/worktree-manager.test.js.map +1 -0
  114. package/dist/cli/aliases.d.ts +10 -0
  115. package/dist/cli/aliases.d.ts.map +1 -0
  116. package/dist/cli/aliases.js +56 -0
  117. package/dist/cli/aliases.js.map +1 -0
  118. package/dist/cli/command.d.ts +3 -0
  119. package/dist/cli/command.d.ts.map +1 -0
  120. package/dist/cli/command.js +63 -0
  121. package/dist/cli/command.js.map +1 -0
  122. package/dist/cli/index.d.ts +3 -0
  123. package/dist/cli/index.d.ts.map +1 -0
  124. package/dist/cli/index.js +29 -0
  125. package/dist/cli/index.js.map +1 -0
  126. package/dist/cli/init.d.ts +3 -0
  127. package/dist/cli/init.d.ts.map +1 -0
  128. package/dist/cli/init.js +57 -0
  129. package/dist/cli/init.js.map +1 -0
  130. package/dist/cli/outpost.d.ts +3 -0
  131. package/dist/cli/outpost.d.ts.map +1 -0
  132. package/dist/cli/outpost.js +65 -0
  133. package/dist/cli/outpost.js.map +1 -0
  134. package/dist/cli/reset.d.ts +3 -0
  135. package/dist/cli/reset.d.ts.map +1 -0
  136. package/dist/cli/reset.js +67 -0
  137. package/dist/cli/reset.js.map +1 -0
  138. package/dist/cli/session.d.ts +3 -0
  139. package/dist/cli/session.d.ts.map +1 -0
  140. package/dist/cli/session.js +112 -0
  141. package/dist/cli/session.js.map +1 -0
  142. package/dist/cli/start.d.ts +3 -0
  143. package/dist/cli/start.d.ts.map +1 -0
  144. package/dist/cli/start.js +105 -0
  145. package/dist/cli/start.js.map +1 -0
  146. package/dist/cli/status.d.ts +3 -0
  147. package/dist/cli/status.d.ts.map +1 -0
  148. package/dist/cli/status.js +128 -0
  149. package/dist/cli/status.js.map +1 -0
  150. package/dist/cli/tribute.d.ts +3 -0
  151. package/dist/cli/tribute.d.ts.map +1 -0
  152. package/dist/cli/tribute.js +160 -0
  153. package/dist/cli/tribute.js.map +1 -0
  154. package/dist/cli/worktree.d.ts +3 -0
  155. package/dist/cli/worktree.d.ts.map +1 -0
  156. package/dist/cli/worktree.js +64 -0
  157. package/dist/cli/worktree.js.map +1 -0
  158. package/dist/core/append-bead.d.ts +13 -0
  159. package/dist/core/append-bead.d.ts.map +1 -0
  160. package/dist/core/append-bead.js +68 -0
  161. package/dist/core/append-bead.js.map +1 -0
  162. package/dist/core/blocked-outposts.d.ts +15 -0
  163. package/dist/core/blocked-outposts.d.ts.map +1 -0
  164. package/dist/core/blocked-outposts.js +77 -0
  165. package/dist/core/blocked-outposts.js.map +1 -0
  166. package/dist/core/citizen-bootstrap.d.ts +17 -0
  167. package/dist/core/citizen-bootstrap.d.ts.map +1 -0
  168. package/dist/core/citizen-bootstrap.js +118 -0
  169. package/dist/core/citizen-bootstrap.js.map +1 -0
  170. package/dist/core/citizen-tribute.d.ts +17 -0
  171. package/dist/core/citizen-tribute.d.ts.map +1 -0
  172. package/dist/core/citizen-tribute.js +55 -0
  173. package/dist/core/citizen-tribute.js.map +1 -0
  174. package/dist/core/command-bead.d.ts +6 -0
  175. package/dist/core/command-bead.d.ts.map +1 -0
  176. package/dist/core/command-bead.js +20 -0
  177. package/dist/core/command-bead.js.map +1 -0
  178. package/dist/core/courier.d.ts +52 -0
  179. package/dist/core/courier.d.ts.map +1 -0
  180. package/dist/core/courier.js +167 -0
  181. package/dist/core/courier.js.map +1 -0
  182. package/dist/core/fo-broadcast.d.ts +15 -0
  183. package/dist/core/fo-broadcast.d.ts.map +1 -0
  184. package/dist/core/fo-broadcast.js +57 -0
  185. package/dist/core/fo-broadcast.js.map +1 -0
  186. package/dist/core/fo-command-processor.d.ts +7 -0
  187. package/dist/core/fo-command-processor.d.ts.map +1 -0
  188. package/dist/core/fo-command-processor.js +123 -0
  189. package/dist/core/fo-command-processor.js.map +1 -0
  190. package/dist/core/fo-dispatch.d.ts +24 -0
  191. package/dist/core/fo-dispatch.d.ts.map +1 -0
  192. package/dist/core/fo-dispatch.js +76 -0
  193. package/dist/core/fo-dispatch.js.map +1 -0
  194. package/dist/core/fo-escalation.d.ts +20 -0
  195. package/dist/core/fo-escalation.d.ts.map +1 -0
  196. package/dist/core/fo-escalation.js +83 -0
  197. package/dist/core/fo-escalation.js.map +1 -0
  198. package/dist/core/fo-handlers/ceiling-hit.d.ts +8 -0
  199. package/dist/core/fo-handlers/ceiling-hit.d.ts.map +1 -0
  200. package/dist/core/fo-handlers/ceiling-hit.js +10 -0
  201. package/dist/core/fo-handlers/ceiling-hit.js.map +1 -0
  202. package/dist/core/fo-handlers/slot-open.d.ts +13 -0
  203. package/dist/core/fo-handlers/slot-open.d.ts.map +1 -0
  204. package/dist/core/fo-handlers/slot-open.js +63 -0
  205. package/dist/core/fo-handlers/slot-open.js.map +1 -0
  206. package/dist/core/fo-nudge-watcher.d.ts +19 -0
  207. package/dist/core/fo-nudge-watcher.d.ts.map +1 -0
  208. package/dist/core/fo-nudge-watcher.js +71 -0
  209. package/dist/core/fo-nudge-watcher.js.map +1 -0
  210. package/dist/core/fo-nudge-wiring.d.ts +13 -0
  211. package/dist/core/fo-nudge-wiring.d.ts.map +1 -0
  212. package/dist/core/fo-nudge-wiring.js +120 -0
  213. package/dist/core/fo-nudge-wiring.js.map +1 -0
  214. package/dist/core/fo-relay.d.ts +7 -0
  215. package/dist/core/fo-relay.d.ts.map +1 -0
  216. package/dist/core/fo-relay.js +47 -0
  217. package/dist/core/fo-relay.js.map +1 -0
  218. package/dist/core/fo-retry-policy.d.ts +17 -0
  219. package/dist/core/fo-retry-policy.d.ts.map +1 -0
  220. package/dist/core/fo-retry-policy.js +89 -0
  221. package/dist/core/fo-retry-policy.js.map +1 -0
  222. package/dist/core/fo-state.d.ts +25 -0
  223. package/dist/core/fo-state.d.ts.map +1 -0
  224. package/dist/core/fo-state.js +99 -0
  225. package/dist/core/fo-state.js.map +1 -0
  226. package/dist/core/fo-task-report.d.ts +16 -0
  227. package/dist/core/fo-task-report.d.ts.map +1 -0
  228. package/dist/core/fo-task-report.js +63 -0
  229. package/dist/core/fo-task-report.js.map +1 -0
  230. package/dist/core/fo-webhook.d.ts +22 -0
  231. package/dist/core/fo-webhook.d.ts.map +1 -0
  232. package/dist/core/fo-webhook.js +43 -0
  233. package/dist/core/fo-webhook.js.map +1 -0
  234. package/dist/core/grand-archives.d.ts +14 -0
  235. package/dist/core/grand-archives.d.ts.map +1 -0
  236. package/dist/core/grand-archives.js +79 -0
  237. package/dist/core/grand-archives.js.map +1 -0
  238. package/dist/core/nudge.d.ts +6 -0
  239. package/dist/core/nudge.d.ts.map +1 -0
  240. package/dist/core/nudge.js +19 -0
  241. package/dist/core/nudge.js.map +1 -0
  242. package/dist/core/outpost-registry.d.ts +16 -0
  243. package/dist/core/outpost-registry.d.ts.map +1 -0
  244. package/dist/core/outpost-registry.js +27 -0
  245. package/dist/core/outpost-registry.js.map +1 -0
  246. package/dist/core/pre-spawn-check.d.ts +16 -0
  247. package/dist/core/pre-spawn-check.d.ts.map +1 -0
  248. package/dist/core/pre-spawn-check.js +50 -0
  249. package/dist/core/pre-spawn-check.js.map +1 -0
  250. package/dist/core/process-registry.d.ts +17 -0
  251. package/dist/core/process-registry.d.ts.map +1 -0
  252. package/dist/core/process-registry.js +71 -0
  253. package/dist/core/process-registry.js.map +1 -0
  254. package/dist/core/spawn-citizen.d.ts +23 -0
  255. package/dist/core/spawn-citizen.d.ts.map +1 -0
  256. package/dist/core/spawn-citizen.js +99 -0
  257. package/dist/core/spawn-citizen.js.map +1 -0
  258. package/dist/core/timeout-watchdog.d.ts +14 -0
  259. package/dist/core/timeout-watchdog.d.ts.map +1 -0
  260. package/dist/core/timeout-watchdog.js +68 -0
  261. package/dist/core/timeout-watchdog.js.map +1 -0
  262. package/dist/core/validate-tribute.d.ts +11 -0
  263. package/dist/core/validate-tribute.d.ts.map +1 -0
  264. package/dist/core/validate-tribute.js +44 -0
  265. package/dist/core/validate-tribute.js.map +1 -0
  266. package/dist/core/worktree-manager.d.ts +20 -0
  267. package/dist/core/worktree-manager.d.ts.map +1 -0
  268. package/dist/core/worktree-manager.js +123 -0
  269. package/dist/core/worktree-manager.js.map +1 -0
  270. package/dist/index.d.ts +30 -0
  271. package/dist/index.d.ts.map +1 -0
  272. package/dist/index.js +30 -0
  273. package/dist/index.js.map +1 -0
  274. package/dist/types/agent.d.ts +47 -0
  275. package/dist/types/agent.d.ts.map +1 -0
  276. package/dist/types/agent.js +4 -0
  277. package/dist/types/agent.js.map +1 -0
  278. package/dist/types/beads.d.ts +175 -0
  279. package/dist/types/beads.d.ts.map +1 -0
  280. package/dist/types/beads.js +4 -0
  281. package/dist/types/beads.js.map +1 -0
  282. package/dist/types/index.d.ts +4 -0
  283. package/dist/types/index.d.ts.map +1 -0
  284. package/dist/types/index.js +4 -0
  285. package/dist/types/index.js.map +1 -0
  286. package/dist/types/registry.d.ts +110 -0
  287. package/dist/types/registry.d.ts.map +1 -0
  288. package/dist/types/registry.js +3 -0
  289. package/dist/types/registry.js.map +1 -0
  290. package/docs/README.md +7 -0
  291. package/docs/architecture.md +106 -0
  292. package/docs/cli-reference.md +81 -0
  293. package/docs/configuration.md +143 -0
  294. package/docs/contributing.md +65 -0
  295. package/docs/getting-started.md +88 -0
  296. package/grand-archives/archetypes/architect/archetype.json +18 -0
  297. package/grand-archives/archetypes/qa-engineer/archetype.json +18 -0
  298. package/grand-archives/archetypes/software-engineer/archetype.json +18 -0
  299. package/grand-archives/archetypes/software-engineer/system-prompt.md +39 -0
  300. package/grand-archives/archetypes/software-engineer/toolset.json +15 -0
  301. package/grand-archives/first-officer/config.json +21 -0
  302. package/grand-archives/first-officer/system-prompt.md +47 -0
  303. package/grand-archives/first-officer/toolset.json +19 -0
  304. package/grand-archives/registry.json +8 -0
  305. package/grand-archives/shared/base-prompt-preamble.md +25 -0
  306. package/grand-archives/shared/base-tools.json +10 -0
  307. package/package.json +73 -0
@@ -0,0 +1,86 @@
1
+ import { describe, it, expect, beforeEach, afterEach } from 'vitest';
2
+ import fs from 'node:fs/promises';
3
+ import path from 'node:path';
4
+ import os from 'node:os';
5
+ import { processCommandBead } from '../core/fo-command-processor.js';
6
+ import { ProcessRegistry } from '../core/process-registry.js';
7
+ import { SCHEMA_VERSION } from '../types/index.js';
8
+ describe('fo-command-processor', () => {
9
+ let tmpDir;
10
+ let outpostDir;
11
+ let registry;
12
+ beforeEach(async () => {
13
+ tmpDir = await fs.mkdtemp(path.join(os.tmpdir(), 'fo-cmd-proc-'));
14
+ outpostDir = path.join(tmpDir, 'outpost');
15
+ await fs.mkdir(path.join(tmpDir, '.citadel', 'commands'), { recursive: true });
16
+ await fs.mkdir(path.join(outpostDir, '.beads', 'mail'), { recursive: true });
17
+ await fs.mkdir(path.join(outpostDir, '.beads', 'tribute'), { recursive: true });
18
+ await fs.writeFile(path.join(tmpDir, '.citadel', 'nudges.jsonl'), '', 'utf-8');
19
+ // Create outpost registry
20
+ await fs.writeFile(path.join(tmpDir, '.citadel', 'outposts.json'), JSON.stringify({
21
+ schema_version: '1.0',
22
+ outposts: [{
23
+ slug: 'test-outpost',
24
+ path: outpostDir,
25
+ status: 'ACTIVE',
26
+ registered_at: new Date().toISOString(),
27
+ default_archetype: 'software-engineer',
28
+ }],
29
+ }), 'utf-8');
30
+ // Create grand-archives registry
31
+ await fs.mkdir(path.join(tmpDir, 'grand-archives'), { recursive: true });
32
+ await fs.writeFile(path.join(tmpDir, 'grand-archives', 'registry.json'), JSON.stringify({
33
+ schema_version: '1.0',
34
+ archetypes: [{ key: 'software-engineer', description: 'SE', status: 'active' }],
35
+ }), 'utf-8');
36
+ registry = new ProcessRegistry();
37
+ });
38
+ afterEach(async () => {
39
+ await fs.rm(tmpDir, { recursive: true, force: true });
40
+ });
41
+ it('processes a dispatch command', async () => {
42
+ const bead = {
43
+ bead_id: 'cmd_test1',
44
+ bead_type: 'COMMAND',
45
+ schema_version: SCHEMA_VERSION,
46
+ created_at: new Date().toISOString(),
47
+ command: 'dispatch',
48
+ args: { outpost: 'test-outpost', task: 'Build feature X' },
49
+ processed: false,
50
+ };
51
+ await processCommandBead(tmpDir, bead, registry);
52
+ // Should have written a mail bead to the outpost
53
+ const mailDir = path.join(outpostDir, '.beads', 'mail');
54
+ const files = await fs.readdir(mailDir);
55
+ expect(files.length).toBeGreaterThan(0);
56
+ });
57
+ it('processes a note command', async () => {
58
+ const bead = {
59
+ bead_id: 'cmd_test2',
60
+ bead_type: 'COMMAND',
61
+ schema_version: SCHEMA_VERSION,
62
+ created_at: new Date().toISOString(),
63
+ command: 'note',
64
+ args: { outpost: 'test-outpost', body: 'Focus on performance' },
65
+ processed: false,
66
+ };
67
+ await processCommandBead(tmpDir, bead, registry);
68
+ const mailDir = path.join(outpostDir, '.beads', 'mail');
69
+ const files = await fs.readdir(mailDir);
70
+ const noteFiles = files.filter(f => f.includes('note'));
71
+ expect(noteFiles.length).toBeGreaterThan(0);
72
+ });
73
+ it('throws on unknown outpost in note command', async () => {
74
+ const bead = {
75
+ bead_id: 'cmd_test3',
76
+ bead_type: 'COMMAND',
77
+ schema_version: SCHEMA_VERSION,
78
+ created_at: new Date().toISOString(),
79
+ command: 'note',
80
+ args: { outpost: 'nonexistent', body: 'test' },
81
+ processed: false,
82
+ };
83
+ await expect(processCommandBead(tmpDir, bead, registry)).rejects.toThrow('not found');
84
+ });
85
+ });
86
+ //# sourceMappingURL=fo-command-processor.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"fo-command-processor.test.js","sourceRoot":"","sources":["../../src/__tests__/fo-command-processor.test.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=fo-escalation.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"fo-escalation.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/fo-escalation.test.ts"],"names":[],"mappings":""}
@@ -0,0 +1,126 @@
1
+ import { describe, it, expect, beforeEach, afterEach } from 'vitest';
2
+ import fs from 'node:fs/promises';
3
+ import path from 'node:path';
4
+ import os from 'node:os';
5
+ import { buildEscalationReport, resolveTask } from '../core/fo-escalation.js';
6
+ import { appendBead, mintBeadId } from '../core/append-bead.js';
7
+ import { SCHEMA_VERSION } from '../types/index.js';
8
+ describe('fo-escalation', () => {
9
+ let tmpDir;
10
+ let outpostDir;
11
+ beforeEach(async () => {
12
+ tmpDir = await fs.mkdtemp(path.join(os.tmpdir(), 'fo-esc-'));
13
+ outpostDir = path.join(tmpDir, 'outpost');
14
+ await fs.mkdir(path.join(tmpDir, '.citadel'), { recursive: true });
15
+ await fs.mkdir(path.join(outpostDir, '.beads', 'mail'), { recursive: true });
16
+ await fs.mkdir(path.join(outpostDir, '.beads', 'tribute'), { recursive: true });
17
+ await fs.writeFile(path.join(tmpDir, '.citadel', 'nudges.jsonl'), '', 'utf-8');
18
+ await fs.writeFile(path.join(tmpDir, '.citadel', 'outposts.json'), JSON.stringify({
19
+ schema_version: '1.0',
20
+ outposts: [{
21
+ slug: 'test-op',
22
+ path: outpostDir,
23
+ status: 'ACTIVE',
24
+ registered_at: new Date().toISOString(),
25
+ default_archetype: 'software-engineer',
26
+ }],
27
+ }), 'utf-8');
28
+ });
29
+ afterEach(async () => {
30
+ await fs.rm(tmpDir, { recursive: true, force: true });
31
+ });
32
+ async function seedTask(taskId) {
33
+ const mail = {
34
+ bead_id: mintBeadId('MAIL'),
35
+ bead_type: 'MAIL',
36
+ schema_version: SCHEMA_VERSION,
37
+ created_at: new Date().toISOString(),
38
+ task_id: taskId,
39
+ mail_type: 'TASK_ASSIGNMENT',
40
+ from: 'citadel',
41
+ to: 'test-op',
42
+ subject: 'Test task',
43
+ read: false,
44
+ retry_of: null,
45
+ spawn_hint: { archetype: 'software-engineer', citizen_id: 'citizen-1' },
46
+ payload: {
47
+ archetype: 'software-engineer',
48
+ citizen_id: 'citizen-1',
49
+ priority: 'MEDIUM',
50
+ title: 'Test',
51
+ description: 'Test task',
52
+ acceptance_criteria: ['pass tests'],
53
+ context_refs: [],
54
+ dependencies: [],
55
+ timeout_seconds: 1800,
56
+ },
57
+ };
58
+ await appendBead(path.join(outpostDir, '.beads', 'mail', `${taskId}.jsonl`), mail);
59
+ return mail;
60
+ }
61
+ async function seedTribute(taskId, status) {
62
+ const tribute = {
63
+ bead_id: mintBeadId('TRIBUTE'),
64
+ bead_type: 'TRIBUTE',
65
+ schema_version: SCHEMA_VERSION,
66
+ created_at: new Date().toISOString(),
67
+ citizen_id: 'citizen-1',
68
+ task_id: taskId,
69
+ originating_mail_ref: 'mail_test',
70
+ archetype: 'software-engineer',
71
+ outpost: 'test-op',
72
+ worktree: '/tmp/wt',
73
+ attempt: 1,
74
+ status,
75
+ summary: 'Test tribute',
76
+ artifacts: [],
77
+ acceptance_met: [status === 'SUCCESS'],
78
+ elapsed_seconds: 60,
79
+ };
80
+ await appendBead(path.join(outpostDir, '.beads', 'tribute', `${taskId}_tribute.jsonl`), tribute);
81
+ }
82
+ it('buildEscalationReport returns report for a known task', async () => {
83
+ await seedTask('task-esc1');
84
+ await seedTribute('task-esc1', 'FAILED');
85
+ const report = await buildEscalationReport(tmpDir, 'task-esc1');
86
+ expect(report.taskId).toBe('task-esc1');
87
+ expect(report.outpost).toBe('test-op');
88
+ expect(report.lastStatus).toBe('FAILED');
89
+ expect(report.recommendation).toContain('abandon');
90
+ });
91
+ it('buildEscalationReport with PARTIAL recommends retry', async () => {
92
+ await seedTask('task-esc2');
93
+ await seedTribute('task-esc2', 'PARTIAL');
94
+ const report = await buildEscalationReport(tmpDir, 'task-esc2');
95
+ expect(report.lastStatus).toBe('PARTIAL');
96
+ expect(report.recommendation).toContain('retry');
97
+ });
98
+ it('buildEscalationReport throws for unknown task', async () => {
99
+ await expect(buildEscalationReport(tmpDir, 'nonexistent')).rejects.toThrow('not found');
100
+ });
101
+ it('resolveTask retry writes a retry mail', async () => {
102
+ await seedTask('task-res1');
103
+ await resolveTask(tmpDir, 'task-res1', 'retry');
104
+ const mailDir = path.join(outpostDir, '.beads', 'mail');
105
+ const files = await fs.readdir(mailDir);
106
+ const retryFiles = files.filter(f => f.includes('resolve-retry'));
107
+ expect(retryFiles.length).toBe(1);
108
+ });
109
+ it('resolveTask rewrite writes a new mail with [REWRITE] subject', async () => {
110
+ await seedTask('task-res2');
111
+ await resolveTask(tmpDir, 'task-res2', 'rewrite', 'Use different approach');
112
+ const mailDir = path.join(outpostDir, '.beads', 'mail');
113
+ const files = await fs.readdir(mailDir);
114
+ const rewriteFiles = files.filter(f => f.includes('rewrite'));
115
+ expect(rewriteFiles.length).toBe(1);
116
+ });
117
+ it('resolveTask abandon logs without writing mail', async () => {
118
+ await seedTask('task-res3');
119
+ await resolveTask(tmpDir, 'task-res3', 'abandon', 'Not worth pursuing');
120
+ const mailDir = path.join(outpostDir, '.beads', 'mail');
121
+ const files = await fs.readdir(mailDir);
122
+ // Only the original TASK_ASSIGNMENT should exist
123
+ expect(files.length).toBe(1);
124
+ });
125
+ });
126
+ //# sourceMappingURL=fo-escalation.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"fo-escalation.test.js","sourceRoot":"","sources":["../../src/__tests__/fo-escalation.test.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=fo-nudge-watcher.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"fo-nudge-watcher.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/fo-nudge-watcher.test.ts"],"names":[],"mappings":""}
@@ -0,0 +1,154 @@
1
+ import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
2
+ import fs from 'node:fs/promises';
3
+ import path from 'node:path';
4
+ import os from 'node:os';
5
+ import { NudgeWatcher } from '../core/fo-nudge-watcher.js';
6
+ import { nudgeFirstOfficer } from '../core/nudge.js';
7
+ describe('NudgeWatcher', () => {
8
+ let tmpDir;
9
+ beforeEach(async () => {
10
+ tmpDir = await fs.mkdtemp(path.join(os.tmpdir(), 'nudge-watcher-'));
11
+ await fs.mkdir(path.join(tmpDir, '.citadel'), { recursive: true });
12
+ await fs.writeFile(path.join(tmpDir, '.citadel', 'nudges.jsonl'), '', 'utf-8');
13
+ });
14
+ afterEach(async () => {
15
+ await fs.rm(tmpDir, { recursive: true, force: true });
16
+ });
17
+ it('registers and invokes a handler for a signal type', async () => {
18
+ const watcher = new NudgeWatcher(tmpDir, 50);
19
+ const called = [];
20
+ watcher.on('COMMAND_RECEIVED', async (nudge) => {
21
+ called.push(nudge.signal_type);
22
+ });
23
+ // Write a nudge directly
24
+ await nudgeFirstOfficer(tmpDir, 'COMMAND_RECEIVED', {
25
+ command_bead_id: 'cmd_test1',
26
+ command: 'dispatch',
27
+ });
28
+ watcher.start();
29
+ await sleep(200);
30
+ watcher.stop();
31
+ expect(called).toContain('COMMAND_RECEIVED');
32
+ });
33
+ it('marks nudges as processed after handling', async () => {
34
+ const watcher = new NudgeWatcher(tmpDir, 50);
35
+ watcher.on('COMMAND_RECEIVED', async () => { });
36
+ await nudgeFirstOfficer(tmpDir, 'COMMAND_RECEIVED', {
37
+ command_bead_id: 'cmd_test2',
38
+ command: 'note',
39
+ });
40
+ watcher.start();
41
+ await sleep(200);
42
+ watcher.stop();
43
+ const content = await fs.readFile(path.join(tmpDir, '.citadel', 'nudges.jsonl'), 'utf-8');
44
+ const lines = content.trim().split('\n').filter(l => l.trim());
45
+ const nudges = lines.map(l => JSON.parse(l));
46
+ expect(nudges.every((n) => n.processed)).toBe(true);
47
+ });
48
+ it('processes nudges in arrival order', async () => {
49
+ const watcher = new NudgeWatcher(tmpDir, 50);
50
+ const order = [];
51
+ watcher.on('COMMAND_RECEIVED', async (nudge) => {
52
+ const payload = nudge.payload;
53
+ order.push(payload.command_bead_id);
54
+ });
55
+ // Write two nudges with different timestamps
56
+ await nudgeFirstOfficer(tmpDir, 'COMMAND_RECEIVED', {
57
+ command_bead_id: 'first',
58
+ command: 'dispatch',
59
+ });
60
+ await nudgeFirstOfficer(tmpDir, 'COMMAND_RECEIVED', {
61
+ command_bead_id: 'second',
62
+ command: 'note',
63
+ });
64
+ watcher.start();
65
+ await sleep(200);
66
+ watcher.stop();
67
+ expect(order).toEqual(['first', 'second']);
68
+ });
69
+ it('warns on unrecognized signal type and still marks processed', async () => {
70
+ const watcher = new NudgeWatcher(tmpDir, 50);
71
+ const warnSpy = vi.spyOn(console, 'warn').mockImplementation(() => { });
72
+ // Write a nudge with a recognized type but no handler registered
73
+ await nudgeFirstOfficer(tmpDir, 'CITIZEN_TIMEOUT', {
74
+ outpost: 'test',
75
+ citizen_id: 'c1',
76
+ task_id: 't1',
77
+ spawned_at: new Date().toISOString(),
78
+ worktree: '/tmp/wt',
79
+ });
80
+ watcher.start();
81
+ await sleep(200);
82
+ watcher.stop();
83
+ expect(warnSpy).toHaveBeenCalledWith(expect.stringContaining('unrecognized signal'));
84
+ warnSpy.mockRestore();
85
+ });
86
+ it('handles handler errors gracefully without stopping', async () => {
87
+ const watcher = new NudgeWatcher(tmpDir, 50);
88
+ const warnSpy = vi.spyOn(console, 'warn').mockImplementation(() => { });
89
+ const called = [];
90
+ watcher.on('COMMAND_RECEIVED', async () => {
91
+ throw new Error('handler boom');
92
+ });
93
+ watcher.on('NO_TASK_ASSIGNMENT', async (nudge) => {
94
+ called.push(nudge.signal_type);
95
+ });
96
+ await nudgeFirstOfficer(tmpDir, 'COMMAND_RECEIVED', {
97
+ command_bead_id: 'cmd_err',
98
+ command: 'dispatch',
99
+ });
100
+ await nudgeFirstOfficer(tmpDir, 'NO_TASK_ASSIGNMENT', {
101
+ outpost: 'test',
102
+ triggering_mail_bead_id: 'mail_1',
103
+ });
104
+ watcher.start();
105
+ await sleep(200);
106
+ watcher.stop();
107
+ expect(warnSpy).toHaveBeenCalledWith(expect.stringContaining('handler error'));
108
+ expect(called).toContain('NO_TASK_ASSIGNMENT');
109
+ warnSpy.mockRestore();
110
+ });
111
+ it('start is idempotent — multiple calls do not create duplicate intervals', async () => {
112
+ const watcher = new NudgeWatcher(tmpDir, 50);
113
+ watcher.start();
114
+ watcher.start(); // should not create a second interval
115
+ watcher.stop();
116
+ // No assertion needed — if duplicate intervals were created, the test would hang
117
+ });
118
+ it('stop clears interval and can be called multiple times safely', () => {
119
+ const watcher = new NudgeWatcher(tmpDir, 50);
120
+ watcher.start();
121
+ watcher.stop();
122
+ watcher.stop(); // should not throw
123
+ });
124
+ it('routes multiple signal types to their respective handlers', async () => {
125
+ const watcher = new NudgeWatcher(tmpDir, 50);
126
+ const handled = [];
127
+ watcher.on('COMMAND_RECEIVED', async (n) => { handled.push(n.signal_type); });
128
+ watcher.on('PARALLELISM_CEILING_HIT', async (n) => { handled.push(n.signal_type); });
129
+ watcher.on('NO_TASK_ASSIGNMENT', async (n) => { handled.push(n.signal_type); });
130
+ await nudgeFirstOfficer(tmpDir, 'COMMAND_RECEIVED', {
131
+ command_bead_id: 'cmd1',
132
+ command: 'dispatch',
133
+ });
134
+ await nudgeFirstOfficer(tmpDir, 'PARALLELISM_CEILING_HIT', {
135
+ outpost: 'test',
136
+ active_count: 3,
137
+ ceiling: 3,
138
+ });
139
+ await nudgeFirstOfficer(tmpDir, 'NO_TASK_ASSIGNMENT', {
140
+ outpost: 'test',
141
+ triggering_mail_bead_id: '',
142
+ });
143
+ watcher.start();
144
+ await sleep(200);
145
+ watcher.stop();
146
+ expect(handled).toContain('COMMAND_RECEIVED');
147
+ expect(handled).toContain('PARALLELISM_CEILING_HIT');
148
+ expect(handled).toContain('NO_TASK_ASSIGNMENT');
149
+ });
150
+ });
151
+ function sleep(ms) {
152
+ return new Promise(resolve => setTimeout(resolve, ms));
153
+ }
154
+ //# sourceMappingURL=fo-nudge-watcher.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"fo-nudge-watcher.test.js","sourceRoot":"","sources":["../../src/__tests__/fo-nudge-watcher.test.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=fo-nudge-wiring.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"fo-nudge-wiring.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/fo-nudge-wiring.test.ts"],"names":[],"mappings":""}
@@ -0,0 +1,31 @@
1
+ import { describe, it, expect } from 'vitest';
2
+ import { NudgeWatcher } from '../core/fo-nudge-watcher.js';
3
+ import { wireNudgeHandlers } from '../core/fo-nudge-wiring.js';
4
+ import { ProcessRegistry } from '../core/process-registry.js';
5
+ describe('fo-nudge-wiring', () => {
6
+ it('wireNudgeHandlers registers handlers for all 7 signal types', () => {
7
+ const watcher = new NudgeWatcher('/tmp/test', 1000);
8
+ const processRegistry = new ProcessRegistry();
9
+ wireNudgeHandlers(watcher, {
10
+ citadelRoot: '/tmp/test',
11
+ processRegistry,
12
+ });
13
+ // Access private handlers map via casting
14
+ const handlers = watcher.handlers;
15
+ const expectedSignals = [
16
+ 'TRIBUTE_WRITTEN',
17
+ 'MAIL_RECEIVED',
18
+ 'COMMAND_RECEIVED',
19
+ 'CITIZEN_EXIT_ERROR',
20
+ 'CITIZEN_TIMEOUT',
21
+ 'PARALLELISM_CEILING_HIT',
22
+ 'NO_TASK_ASSIGNMENT',
23
+ ];
24
+ for (const signal of expectedSignals) {
25
+ expect(handlers.has(signal), `handler for ${signal} should be registered`).toBe(true);
26
+ expect(typeof handlers.get(signal)).toBe('function');
27
+ }
28
+ expect(handlers.size).toBe(7);
29
+ });
30
+ });
31
+ //# sourceMappingURL=fo-nudge-wiring.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"fo-nudge-wiring.test.js","sourceRoot":"","sources":["../../src/__tests__/fo-nudge-wiring.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAG9D,QAAQ,CAAC,iBAAiB,EAAE,GAAG,EAAE;IAC/B,EAAE,CAAC,6DAA6D,EAAE,GAAG,EAAE;QACrE,MAAM,OAAO,GAAG,IAAI,YAAY,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;QACpD,MAAM,eAAe,GAAG,IAAI,eAAe,EAAE,CAAC;QAE9C,iBAAiB,CAAC,OAAO,EAAE;YACzB,WAAW,EAAE,WAAW;YACxB,eAAe;SAChB,CAAC,CAAC;QAEH,0CAA0C;QAC1C,MAAM,QAAQ,GAAI,OAAkE,CAAC,QAAQ,CAAC;QAE9F,MAAM,eAAe,GAAsB;YACzC,iBAAiB;YACjB,eAAe;YACf,kBAAkB;YAClB,oBAAoB;YACpB,iBAAiB;YACjB,yBAAyB;YACzB,oBAAoB;SACrB,CAAC;QAEF,KAAK,MAAM,MAAM,IAAI,eAAe,EAAE,CAAC;YACrC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,eAAe,MAAM,uBAAuB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACtF,MAAM,CAAC,OAAO,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACvD,CAAC;QAED,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAChC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=fo-relay.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"fo-relay.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/fo-relay.test.ts"],"names":[],"mappings":""}
@@ -0,0 +1,90 @@
1
+ import { describe, it, expect, beforeEach, afterEach } from 'vitest';
2
+ import path from 'node:path';
3
+ import fs from 'node:fs/promises';
4
+ import os from 'node:os';
5
+ import { handleRelayRequest } from '../core/fo-relay.js';
6
+ import { readBeads } from '../core/append-bead.js';
7
+ describe('handleRelayRequest', () => {
8
+ let tmpDir;
9
+ let alphaPath;
10
+ let betaPath;
11
+ beforeEach(async () => {
12
+ tmpDir = await fs.mkdtemp(path.join(os.tmpdir(), 'citadel-relay-'));
13
+ alphaPath = path.join(tmpDir, 'outposts', 'alpha');
14
+ betaPath = path.join(tmpDir, 'outposts', 'beta');
15
+ await fs.mkdir(path.join(tmpDir, '.citadel'), { recursive: true });
16
+ await fs.mkdir(path.join(alphaPath, '.beads', 'mail'), { recursive: true });
17
+ await fs.mkdir(path.join(betaPath, '.beads', 'mail'), { recursive: true });
18
+ const registry = {
19
+ schema_version: '1.0',
20
+ outposts: [
21
+ { slug: 'alpha', path: alphaPath, status: 'ACTIVE', registered_at: '2026-01-01T00:00:00Z', default_archetype: 'software-engineer' },
22
+ { slug: 'beta', path: betaPath, status: 'ACTIVE', registered_at: '2026-01-02T00:00:00Z', default_archetype: 'code-reviewer' },
23
+ ],
24
+ };
25
+ await fs.writeFile(path.join(tmpDir, '.citadel', 'outposts.json'), JSON.stringify(registry));
26
+ });
27
+ afterEach(async () => {
28
+ await fs.rm(tmpDir, { recursive: true, force: true });
29
+ });
30
+ const makeRelayRequest = () => ({
31
+ bead_id: 'bead-relay-1',
32
+ bead_type: 'MAIL',
33
+ schema_version: '9.0',
34
+ created_at: '2026-01-01T00:00:00Z',
35
+ task_id: 'task-origin',
36
+ mail_type: 'RELAY_REQUEST',
37
+ from: 'alpha',
38
+ to: 'citadel',
39
+ subject: 'Need code review',
40
+ read: false,
41
+ retry_of: null,
42
+ payload: {
43
+ intended_for: 'beta',
44
+ subject: 'Need code review',
45
+ body: 'Please review src/feature.ts',
46
+ context_refs: ['src/feature.ts'],
47
+ },
48
+ });
49
+ it('composes PEER_RELAY mail and writes to target outpost', async () => {
50
+ const relayReq = makeRelayRequest();
51
+ const result = await handleRelayRequest(tmpDir, relayReq);
52
+ expect(result.mail_type).toBe('PEER_RELAY');
53
+ expect(result.from).toBe('alpha');
54
+ expect(result.to).toBe('beta');
55
+ expect(result.task_id).toBe('task-origin');
56
+ expect(result.spawn_hint).toBeDefined();
57
+ expect(result.spawn_hint.archetype).toBe('code-reviewer');
58
+ const payload = result.payload;
59
+ expect(payload.origin_outpost).toBe('alpha');
60
+ expect(payload.origin_mail_ref).toBe('bead-relay-1');
61
+ expect(payload.subject).toBe('Need code review');
62
+ expect(payload.body).toBe('Please review src/feature.ts');
63
+ expect(payload.context_refs).toEqual(['src/feature.ts']);
64
+ // Verify file was written to beta's mail dir
65
+ const betaMailFiles = await fs.readdir(path.join(betaPath, '.beads', 'mail'));
66
+ const relayFiles = betaMailFiles.filter(f => f.startsWith('relay-'));
67
+ expect(relayFiles).toHaveLength(1);
68
+ const mails = await readBeads(path.join(betaPath, '.beads', 'mail', relayFiles[0]));
69
+ expect(mails).toHaveLength(1);
70
+ expect(mails[0].bead_id).toBe(result.bead_id);
71
+ });
72
+ it('throws when target outpost is not found', async () => {
73
+ const relayReq = makeRelayRequest();
74
+ relayReq.payload.intended_for = 'nonexistent';
75
+ await expect(handleRelayRequest(tmpDir, relayReq)).rejects.toThrow('Relay target outpost "nonexistent" not found or not ACTIVE');
76
+ });
77
+ it('throws when target outpost is INACTIVE', async () => {
78
+ // Rewrite registry with beta INACTIVE
79
+ const registry = {
80
+ schema_version: '1.0',
81
+ outposts: [
82
+ { slug: 'alpha', path: alphaPath, status: 'ACTIVE', registered_at: '2026-01-01T00:00:00Z' },
83
+ { slug: 'beta', path: betaPath, status: 'INACTIVE', registered_at: '2026-01-02T00:00:00Z' },
84
+ ],
85
+ };
86
+ await fs.writeFile(path.join(tmpDir, '.citadel', 'outposts.json'), JSON.stringify(registry));
87
+ await expect(handleRelayRequest(tmpDir, makeRelayRequest())).rejects.toThrow('not found or not ACTIVE');
88
+ });
89
+ });
90
+ //# sourceMappingURL=fo-relay.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"fo-relay.test.js","sourceRoot":"","sources":["../../src/__tests__/fo-relay.test.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=fo-task-report.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"fo-task-report.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/fo-task-report.test.ts"],"names":[],"mappings":""}