@apralabs/apra-fleet 0.4.2 → 0.4.4

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 (997) hide show
  1. package/README.md +103 -34
  2. package/dist/agents/backlog-groomer.md +87 -14
  3. package/dist/agents/ci-watcher.md +35 -9
  4. package/dist/agents/deployer.md +63 -11
  5. package/dist/agents/doer.md +99 -41
  6. package/dist/agents/harvester.md +47 -27
  7. package/dist/agents/integ-test-runner.md +38 -10
  8. package/dist/agents/kb-reconciler.md +37 -7
  9. package/dist/agents/plan-reviewer.md +145 -32
  10. package/dist/agents/planner.md +180 -69
  11. package/dist/agents/regression-test-runner.md +98 -64
  12. package/dist/agents/reviewer.md +117 -45
  13. package/dist/agents/schemas/backlog-groomer-output.json +1 -1
  14. package/dist/agents/schemas/doer-output.json +32 -0
  15. package/dist/agents/schemas/harvester-input.json +1 -5
  16. package/dist/agents/schemas/plan-reviewer-output.json +37 -0
  17. package/dist/agents/schemas/planner-output.json +1 -1
  18. package/dist/agents/schemas/regression-test-runner-output.json +41 -7
  19. package/dist/agents/schemas/reviewer-output.json +62 -3
  20. package/dist/cli/agent-transform.d.ts +90 -2
  21. package/dist/cli/agent-transform.js +310 -20
  22. package/dist/cli/auth.d.ts +1 -0
  23. package/dist/cli/auth.js +66 -17
  24. package/dist/cli/beads-install.d.ts +35 -0
  25. package/dist/cli/beads-install.js +125 -0
  26. package/dist/cli/beads-pin.d.ts +5 -0
  27. package/dist/cli/beads-pin.js +27 -0
  28. package/dist/cli/call.d.ts +27 -0
  29. package/dist/cli/call.js +177 -0
  30. package/dist/cli/config.d.ts +31 -6
  31. package/dist/cli/config.js +113 -36
  32. package/dist/cli/dolt-install.d.ts +18 -2
  33. package/dist/cli/dolt-install.js +46 -15
  34. package/dist/cli/fleet-se-guard.d.ts +51 -0
  35. package/dist/cli/fleet-se-guard.js +215 -0
  36. package/dist/cli/install-guard.d.ts +54 -0
  37. package/dist/cli/install-guard.js +132 -4
  38. package/dist/cli/install.d.ts +100 -11
  39. package/dist/cli/install.js +864 -139
  40. package/dist/cli/kb-commit.d.ts +2 -1
  41. package/dist/cli/kb-commit.js +1 -1
  42. package/dist/cli/kb-directives.js +2 -1
  43. package/dist/cli/kb-import.d.ts +2 -1
  44. package/dist/cli/kb-import.js +1 -1
  45. package/dist/cli/register-member.js +26 -5
  46. package/dist/cli/remove-member.d.ts +4 -0
  47. package/dist/cli/remove-member.js +63 -0
  48. package/dist/cli/secret.js +9 -0
  49. package/dist/cli/start.js +59 -4
  50. package/dist/cli/status.d.ts +3 -0
  51. package/dist/cli/status.js +45 -12
  52. package/dist/cli/stop.js +64 -9
  53. package/dist/cli/uninstall.js +101 -15
  54. package/dist/cli/update.js +33 -2
  55. package/dist/cli/watch.js +1 -1
  56. package/dist/cli/workflow.js +3 -2
  57. package/dist/commands/kb-server.d.ts +3 -0
  58. package/dist/commands/kb-server.js +52 -5
  59. package/dist/hub-service/http-server.d.ts +5 -1
  60. package/dist/hub-service/http-server.js +55 -5
  61. package/dist/index.js +158 -11
  62. package/dist/os/child-env-bound.d.ts +77 -0
  63. package/dist/os/child-env-bound.js +171 -0
  64. package/dist/os/linux.d.ts +13 -2
  65. package/dist/os/linux.js +75 -16
  66. package/dist/os/macos.d.ts +1 -1
  67. package/dist/os/macos.js +2 -11
  68. package/dist/os/os-commands.d.ts +78 -4
  69. package/dist/os/windows-gitbash.d.ts +6 -0
  70. package/dist/os/windows-gitbash.js +32 -3
  71. package/dist/os/windows-wrapper.d.ts +0 -4
  72. package/dist/os/windows-wrapper.js +2 -1
  73. package/dist/os/windows.d.ts +11 -2
  74. package/dist/os/windows.js +121 -32
  75. package/dist/paths.d.ts +21 -0
  76. package/dist/paths.js +35 -0
  77. package/dist/providers/agy.d.ts +120 -7
  78. package/dist/providers/agy.js +741 -86
  79. package/dist/providers/claude-permission-denial.d.ts +7 -0
  80. package/dist/providers/claude-permission-denial.js +137 -0
  81. package/dist/providers/claude.d.ts +132 -6
  82. package/dist/providers/claude.js +644 -48
  83. package/dist/providers/codex.d.ts +4 -2
  84. package/dist/providers/codex.js +23 -2
  85. package/dist/providers/copilot.d.ts +4 -2
  86. package/dist/providers/copilot.js +24 -2
  87. package/dist/providers/none.d.ts +4 -2
  88. package/dist/providers/none.js +17 -2
  89. package/dist/providers/opencode.d.ts +12 -2
  90. package/dist/providers/opencode.js +135 -54
  91. package/dist/providers/provider.d.ts +368 -35
  92. package/dist/providers/provider.js +219 -2
  93. package/dist/services/agent-provisioner.d.ts +29 -0
  94. package/dist/services/agent-provisioner.js +107 -0
  95. package/dist/services/agent-shadow.d.ts +96 -0
  96. package/dist/services/agent-shadow.js +479 -0
  97. package/dist/services/agy-project.d.ts +103 -0
  98. package/dist/services/agy-project.js +354 -0
  99. package/dist/services/auth-socket.d.ts +25 -0
  100. package/dist/services/auth-socket.js +72 -27
  101. package/dist/services/auth-web.js +2 -2
  102. package/dist/services/budget-awareness.d.ts +11 -11
  103. package/dist/services/budget-awareness.js +15 -3
  104. package/dist/services/claude-local-scope-mcp.d.ts +19 -0
  105. package/dist/services/claude-local-scope-mcp.js +91 -0
  106. package/dist/services/cloud/aws.js +2 -1
  107. package/dist/services/cloud/lifecycle.js +52 -6
  108. package/dist/services/cloud/task-wrapper.d.ts +0 -9
  109. package/dist/services/cloud/task-wrapper.js +15 -6
  110. package/dist/services/credential-cleanup.js +35 -17
  111. package/dist/services/event-loop-watchdog.d.ts +32 -0
  112. package/dist/services/event-loop-watchdog.js +140 -0
  113. package/dist/services/exit-drain.d.ts +44 -0
  114. package/dist/services/exit-drain.js +52 -0
  115. package/dist/services/github-app.js +32 -4
  116. package/dist/services/http-transport.d.ts +50 -1
  117. package/dist/services/http-transport.js +238 -25
  118. package/dist/services/in-flight-agents.d.ts +2 -0
  119. package/dist/services/in-flight-agents.js +4 -0
  120. package/dist/services/knowledge/bible-basis-filter.d.ts +53 -0
  121. package/dist/services/knowledge/bible-basis-filter.js +134 -0
  122. package/dist/services/knowledge/bible-blob-id.d.ts +44 -0
  123. package/dist/services/knowledge/bible-blob-id.js +113 -0
  124. package/dist/services/knowledge/bible-import.d.ts +65 -0
  125. package/dist/services/knowledge/bible-import.js +211 -0
  126. package/dist/services/knowledge/file-hash.d.ts +31 -0
  127. package/dist/services/knowledge/file-hash.js +153 -23
  128. package/dist/services/knowledge/http-provider.d.ts +4 -3
  129. package/dist/services/knowledge/http-provider.js +17 -5
  130. package/dist/services/knowledge/kb-config.d.ts +42 -0
  131. package/dist/services/knowledge/kb-config.js +54 -0
  132. package/dist/services/knowledge/kb-maintainer-grant.d.ts +15 -0
  133. package/dist/services/knowledge/kb-maintainer-grant.js +34 -0
  134. package/dist/services/knowledge/kb-providers.d.ts +11 -1
  135. package/dist/services/knowledge/kb-providers.js +199 -17
  136. package/dist/services/knowledge/kb-removed-scope-keys.d.ts +28 -0
  137. package/dist/services/knowledge/kb-removed-scope-keys.js +59 -0
  138. package/dist/services/knowledge/kb-scopes.d.ts +14 -0
  139. package/dist/services/knowledge/kb-scopes.js +47 -0
  140. package/dist/services/knowledge/kb-self.d.ts +91 -0
  141. package/dist/services/knowledge/kb-self.js +198 -0
  142. package/dist/services/knowledge/member-bible-view.d.ts +21 -0
  143. package/dist/services/knowledge/member-bible-view.js +194 -0
  144. package/dist/services/knowledge/pre-init.js +1 -0
  145. package/dist/services/knowledge/project-slug.js +2 -2
  146. package/dist/services/knowledge/require-sqlite-project.d.ts +32 -0
  147. package/dist/services/knowledge/require-sqlite-project.js +38 -0
  148. package/dist/services/knowledge/sqlite-provider.d.ts +64 -11
  149. package/dist/services/knowledge/sqlite-provider.js +303 -41
  150. package/dist/services/knowledge/types.d.ts +45 -2
  151. package/dist/services/member-access-secret.d.ts +70 -0
  152. package/dist/services/member-access-secret.js +195 -0
  153. package/dist/services/member-call-counts.d.ts +24 -0
  154. package/dist/services/member-call-counts.js +58 -0
  155. package/dist/services/member-config-io.d.ts +192 -0
  156. package/dist/services/member-config-io.js +443 -0
  157. package/dist/services/member-fleet-install.d.ts +710 -0
  158. package/dist/services/member-fleet-install.js +1895 -0
  159. package/dist/services/member-secret-env.d.ts +42 -0
  160. package/dist/services/member-secret-env.js +68 -0
  161. package/dist/services/member-tool-allowlist.d.ts +49 -0
  162. package/dist/services/member-tool-allowlist.js +111 -0
  163. package/dist/services/model-pricing.d.ts +19 -0
  164. package/dist/services/model-pricing.js +60 -10
  165. package/dist/services/port-holder.d.ts +86 -0
  166. package/dist/services/port-holder.js +351 -0
  167. package/dist/services/preflight-check.js +2 -0
  168. package/dist/services/registry.d.ts +13 -2
  169. package/dist/services/registry.js +27 -1
  170. package/dist/services/relay-strategy.d.ts +2 -0
  171. package/dist/services/relay-strategy.js +8 -0
  172. package/dist/services/secret-token.d.ts +38 -0
  173. package/dist/services/secret-token.js +51 -0
  174. package/dist/services/server-lifecycle.d.ts +26 -0
  175. package/dist/services/server-lifecycle.js +85 -0
  176. package/dist/services/service-manager/index.d.ts +7 -1
  177. package/dist/services/service-manager/index.js +17 -4
  178. package/dist/services/service-manager/linux.d.ts +1 -1
  179. package/dist/services/service-manager/linux.js +15 -7
  180. package/dist/services/service-manager/macos.d.ts +11 -1
  181. package/dist/services/service-manager/macos.js +45 -7
  182. package/dist/services/service-manager/service-path.d.ts +24 -0
  183. package/dist/services/service-manager/service-path.js +55 -0
  184. package/dist/services/service-manager/types.d.ts +39 -2
  185. package/dist/services/service-manager/types.js +29 -0
  186. package/dist/services/service-manager/windows.d.ts +194 -3
  187. package/dist/services/service-manager/windows.js +705 -30
  188. package/dist/services/service-notice.d.ts +14 -0
  189. package/dist/services/service-notice.js +62 -0
  190. package/dist/services/service-start-guard.d.ts +20 -0
  191. package/dist/services/service-start-guard.js +86 -0
  192. package/dist/services/session-cost.d.ts +24 -0
  193. package/dist/services/session-cost.js +105 -0
  194. package/dist/services/session-mcp-config.d.ts +83 -0
  195. package/dist/services/session-mcp-config.js +211 -0
  196. package/dist/services/sftp.d.ts +34 -0
  197. package/dist/services/sftp.js +304 -76
  198. package/dist/services/shell-probe.d.ts +0 -24
  199. package/dist/services/shell-probe.js +28 -3
  200. package/dist/services/singleton.d.ts +68 -2
  201. package/dist/services/singleton.js +168 -11
  202. package/dist/services/sprint-coordination.js +9 -3
  203. package/dist/services/ssh.d.ts +27 -0
  204. package/dist/services/ssh.js +287 -40
  205. package/dist/services/stall/find-log-file.js +12 -5
  206. package/dist/services/stall/index.d.ts +1 -1
  207. package/dist/services/stall/read-log-tail.d.ts +23 -0
  208. package/dist/services/stall/read-log-tail.js +53 -12
  209. package/dist/services/stall/stall-detector.d.ts +78 -5
  210. package/dist/services/stall/stall-detector.js +296 -39
  211. package/dist/services/stall/stall-poller.d.ts +16 -0
  212. package/dist/services/stall/stall-poller.js +50 -6
  213. package/dist/services/stopped-marker.d.ts +16 -0
  214. package/dist/services/stopped-marker.js +55 -0
  215. package/dist/services/strategy.d.ts +33 -1
  216. package/dist/services/strategy.js +165 -19
  217. package/dist/services/substitution-engine.js +2 -2
  218. package/dist/services/supervisor-service-cleanup.d.ts +52 -0
  219. package/dist/services/supervisor-service-cleanup.js +332 -0
  220. package/dist/services/tool-registry.d.ts +8 -1
  221. package/dist/services/tool-registry.js +164 -61
  222. package/dist/services/tool-scope.d.ts +58 -0
  223. package/dist/services/tool-scope.js +99 -0
  224. package/dist/services/vcs/azure-devops.d.ts +66 -1
  225. package/dist/services/vcs/azure-devops.js +192 -21
  226. package/dist/services/vcs/types.d.ts +1 -1
  227. package/dist/services/watch/project-resolver.js +1 -0
  228. package/dist/skills/auto-sprint-args/SKILL.md +2 -2
  229. package/dist/skills/fleet-sprint-cli/SKILL.md +48 -6
  230. package/dist/skills/pm/SKILL.md +4 -4
  231. package/dist/skills/pm/cost.md +0 -3
  232. package/dist/skills/pm/fleet-addendum.md +2 -2
  233. package/dist/skills/pm/index.md +4 -2
  234. package/dist/skills/pm/kb-reconcile.md +29 -14
  235. package/dist/skills/pm/kb-review.md +1 -0
  236. package/dist/skills/pm/sprint.md +5 -5
  237. package/dist/tools/check-status.d.ts +60 -9
  238. package/dist/tools/check-status.js +211 -52
  239. package/dist/tools/child-id-allocator.d.ts +2 -2
  240. package/dist/tools/child-id-allocator.js +1 -1
  241. package/dist/tools/code-index-heal.d.ts +8 -0
  242. package/dist/tools/code-index-heal.js +21 -0
  243. package/dist/tools/code-index-state.d.ts +45 -0
  244. package/dist/tools/code-index-state.js +115 -0
  245. package/dist/tools/code-intelligence-codebase-memory.js +6 -33
  246. package/dist/tools/code-intelligence-freshness.js +1 -1
  247. package/dist/tools/code-intelligence-gitnexus.d.ts +30 -0
  248. package/dist/tools/code-intelligence-gitnexus.js +333 -57
  249. package/dist/tools/code-intelligence-kb-enrich.js +7 -6
  250. package/dist/tools/code-intelligence-readiness.d.ts +99 -0
  251. package/dist/tools/code-intelligence-readiness.js +206 -0
  252. package/dist/tools/code-intelligence-reindex.d.ts +195 -0
  253. package/dist/tools/code-intelligence-reindex.js +530 -50
  254. package/dist/tools/code-intelligence-telemetry.d.ts +6 -1
  255. package/dist/tools/code-intelligence-telemetry.js +12 -3
  256. package/dist/tools/code-intelligence.d.ts +81 -31
  257. package/dist/tools/code-intelligence.js +156 -52
  258. package/dist/tools/compose-permissions.d.ts +63 -2
  259. package/dist/tools/compose-permissions.js +673 -72
  260. package/dist/tools/credential-store-set.js +1 -1
  261. package/dist/tools/execute-command.d.ts +11 -0
  262. package/dist/tools/execute-command.js +111 -32
  263. package/dist/tools/execute-prompt.d.ts +69 -12
  264. package/dist/tools/execute-prompt.js +1610 -895
  265. package/dist/tools/kb-bible-commit.d.ts +65 -0
  266. package/dist/tools/kb-bible-commit.js +239 -0
  267. package/dist/tools/kb-capture.d.ts +15 -11
  268. package/dist/tools/kb-capture.js +71 -16
  269. package/dist/tools/kb-context.d.ts +27 -7
  270. package/dist/tools/kb-context.js +60 -9
  271. package/dist/tools/kb-export.d.ts +98 -9
  272. package/dist/tools/kb-export.js +230 -92
  273. package/dist/tools/kb-feedback.d.ts +13 -9
  274. package/dist/tools/kb-feedback.js +16 -8
  275. package/dist/tools/kb-freshness-sweep.d.ts +11 -7
  276. package/dist/tools/kb-freshness-sweep.js +10 -8
  277. package/dist/tools/kb-harvest.d.ts +11 -7
  278. package/dist/tools/kb-harvest.js +7 -7
  279. package/dist/tools/kb-import.d.ts +26 -10
  280. package/dist/tools/kb-import.js +170 -159
  281. package/dist/tools/kb-invalidate.d.ts +17 -10
  282. package/dist/tools/kb-invalidate.js +41 -8
  283. package/dist/tools/kb-list.d.ts +14 -10
  284. package/dist/tools/kb-list.js +33 -11
  285. package/dist/tools/kb-promote.d.ts +11 -7
  286. package/dist/tools/kb-promote.js +14 -8
  287. package/dist/tools/kb-query.d.ts +21 -11
  288. package/dist/tools/kb-query.js +76 -13
  289. package/dist/tools/kb-reconcile-prefilter.d.ts +11 -7
  290. package/dist/tools/kb-reconcile-prefilter.js +13 -9
  291. package/dist/tools/kb-resolve-contradiction.d.ts +11 -7
  292. package/dist/tools/kb-resolve-contradiction.js +10 -8
  293. package/dist/tools/kb-session-prime.d.ts +14 -7
  294. package/dist/tools/kb-session-prime.js +44 -44
  295. package/dist/tools/kb-setup.d.ts +11 -4
  296. package/dist/tools/kb-setup.js +146 -27
  297. package/dist/tools/kb-stats.d.ts +11 -10
  298. package/dist/tools/kb-stats.js +84 -82
  299. package/dist/tools/list-members.d.ts +2 -2
  300. package/dist/tools/list-members.js +6 -2
  301. package/dist/tools/member-detail.d.ts +5 -2
  302. package/dist/tools/member-detail.js +105 -17
  303. package/dist/tools/member-reservation.d.ts +60 -3
  304. package/dist/tools/member-reservation.js +61 -20
  305. package/dist/tools/provision-auth.d.ts +118 -1
  306. package/dist/tools/provision-auth.js +402 -92
  307. package/dist/tools/provision-vcs-auth.d.ts +93 -3
  308. package/dist/tools/provision-vcs-auth.js +209 -49
  309. package/dist/tools/receive-files.js +3 -1
  310. package/dist/tools/register-member.d.ts +44 -15
  311. package/dist/tools/register-member.js +175 -70
  312. package/dist/tools/remove-member.js +118 -15
  313. package/dist/tools/send-email.d.ts +2 -2
  314. package/dist/tools/send-files.js +6 -4
  315. package/dist/tools/session-stats.d.ts +17 -0
  316. package/dist/tools/session-stats.js +27 -0
  317. package/dist/tools/setup-git-app.js +11 -7
  318. package/dist/tools/shutdown-server.d.ts +2 -0
  319. package/dist/tools/shutdown-server.js +28 -1
  320. package/dist/tools/update-agent-cli.d.ts +19 -0
  321. package/dist/tools/update-agent-cli.js +59 -2
  322. package/dist/tools/update-member.d.ts +23 -17
  323. package/dist/tools/update-member.js +181 -18
  324. package/dist/tools/vcs-credential-exec.d.ts +127 -0
  325. package/dist/tools/vcs-credential-exec.js +203 -0
  326. package/dist/types.d.ts +111 -1
  327. package/dist/utils/agent-helpers.js +2 -0
  328. package/dist/utils/auth-env.d.ts +15 -4
  329. package/dist/utils/auth-env.js +52 -23
  330. package/dist/utils/find-on-path.d.ts +37 -0
  331. package/dist/utils/find-on-path.js +85 -0
  332. package/dist/utils/log-helpers.d.ts +37 -0
  333. package/dist/utils/log-helpers.js +108 -22
  334. package/dist/utils/owner-only-fs.d.ts +56 -0
  335. package/dist/utils/owner-only-fs.js +98 -0
  336. package/dist/utils/process-utils.d.ts +28 -0
  337. package/dist/utils/process-utils.js +68 -0
  338. package/dist/utils/prompt-errors.js +11 -2
  339. package/dist/utils/session-caller.d.ts +4 -2
  340. package/dist/utils/session-caller.js +3 -2
  341. package/dist/utils/shell-escape.d.ts +58 -3
  342. package/dist/utils/shell-escape.js +91 -5
  343. package/dist/utils/ssh-error-messages.js +3 -0
  344. package/dist/utils/vcs-provider-detect.d.ts +65 -0
  345. package/dist/utils/vcs-provider-detect.js +109 -0
  346. package/dist/utils/workspace-trust.d.ts +26 -0
  347. package/dist/utils/workspace-trust.js +91 -1
  348. package/dist/workflows/auto-sprint.js +397 -56
  349. package/package.json +15 -10
  350. package/packages/apra-fleet-client/package.json +2 -2
  351. package/packages/apra-fleet-client/src/client/api.mjs +864 -31
  352. package/packages/apra-fleet-client/src/client/auto-start.mjs +434 -0
  353. package/packages/apra-fleet-client/src/client/client.mjs +9 -0
  354. package/packages/apra-fleet-client/src/client/errors.mjs +6 -2
  355. package/packages/apra-fleet-client/src/client/factory.mjs +23 -4
  356. package/packages/apra-fleet-client/src/client/reconnecting-transport.mjs +137 -0
  357. package/packages/apra-fleet-client/src/client/server-resolution.mjs +267 -30
  358. package/packages/apra-fleet-client/src/client/transport.mjs +37 -3
  359. package/packages/apra-fleet-se/apra-pm/agents/_shared/GRAPH-SEMANTICS.md +10 -2
  360. package/packages/apra-fleet-se/apra-pm/agents/backlog-groomer.md +87 -14
  361. package/packages/apra-fleet-se/apra-pm/agents/ci-watcher.md +35 -9
  362. package/packages/apra-fleet-se/apra-pm/agents/deployer.md +63 -11
  363. package/packages/apra-fleet-se/apra-pm/agents/doer.md +99 -41
  364. package/packages/apra-fleet-se/apra-pm/agents/harvester.md +47 -27
  365. package/packages/apra-fleet-se/apra-pm/agents/integ-test-runner.md +38 -10
  366. package/packages/apra-fleet-se/apra-pm/agents/kb-reconciler.md +37 -7
  367. package/packages/apra-fleet-se/apra-pm/agents/plan-reviewer.md +145 -32
  368. package/packages/apra-fleet-se/apra-pm/agents/planner.md +180 -69
  369. package/packages/apra-fleet-se/apra-pm/agents/regression-test-runner.md +98 -64
  370. package/packages/apra-fleet-se/apra-pm/agents/reviewer.md +117 -45
  371. package/packages/apra-fleet-se/apra-pm/agents/schemas/backlog-groomer-output.json +1 -1
  372. package/packages/apra-fleet-se/apra-pm/agents/schemas/doer-output.json +32 -0
  373. package/packages/apra-fleet-se/apra-pm/agents/schemas/harvester-input.json +1 -5
  374. package/packages/apra-fleet-se/apra-pm/agents/schemas/plan-reviewer-output.json +37 -0
  375. package/packages/apra-fleet-se/apra-pm/agents/schemas/planner-output.json +1 -1
  376. package/packages/apra-fleet-se/apra-pm/agents/schemas/regression-test-runner-output.json +41 -7
  377. package/packages/apra-fleet-se/apra-pm/agents/schemas/reviewer-output.json +62 -3
  378. package/packages/apra-fleet-se/apra-pm/skills/pm/SKILL.md +4 -4
  379. package/packages/apra-fleet-se/apra-pm/skills/pm/cost.md +0 -3
  380. package/packages/apra-fleet-se/apra-pm/skills/pm/fleet-addendum.md +2 -2
  381. package/packages/apra-fleet-se/apra-pm/skills/pm/index.md +4 -2
  382. package/packages/apra-fleet-se/apra-pm/skills/pm/kb-reconcile.md +29 -14
  383. package/packages/apra-fleet-se/apra-pm/skills/pm/kb-review.md +1 -0
  384. package/packages/apra-fleet-se/apra-pm/skills/pm/sprint.md +5 -5
  385. package/packages/apra-fleet-se/bin/cli.mjs +326 -48
  386. package/packages/apra-fleet-se/bin/serve.mjs +218 -11
  387. package/packages/apra-fleet-se/fleet-sprint/abort.mjs +517 -0
  388. package/packages/apra-fleet-se/fleet-sprint/backlog-role.mjs +93 -0
  389. package/packages/apra-fleet-se/fleet-sprint/beads-children.mjs +646 -0
  390. package/packages/apra-fleet-se/fleet-sprint/beads-identity-check.mjs +825 -0
  391. package/packages/apra-fleet-se/fleet-sprint/beads-identity.mjs +217 -0
  392. package/packages/apra-fleet-se/fleet-sprint/beads-memory-hygiene.mjs +201 -0
  393. package/packages/apra-fleet-se/fleet-sprint/beads-scope.mjs +745 -0
  394. package/packages/apra-fleet-se/fleet-sprint/beads-transitions.mjs +447 -0
  395. package/packages/apra-fleet-se/fleet-sprint/branch-ensure.mjs +96 -0
  396. package/packages/apra-fleet-se/fleet-sprint/ci-gate.mjs +353 -0
  397. package/packages/apra-fleet-se/fleet-sprint/conflict-ladder.mjs +20 -0
  398. package/packages/apra-fleet-se/fleet-sprint/contracts.mjs +121 -15
  399. package/packages/apra-fleet-se/fleet-sprint/coordination.mjs +539 -0
  400. package/packages/apra-fleet-se/fleet-sprint/dispatch-accounting.mjs +270 -0
  401. package/packages/apra-fleet-se/fleet-sprint/dispatch-failure.mjs +204 -0
  402. package/packages/apra-fleet-se/fleet-sprint/dispatch-role.mjs +1310 -0
  403. package/packages/apra-fleet-se/fleet-sprint/dispatch-safety-guard.mjs +216 -4
  404. package/packages/apra-fleet-se/fleet-sprint/docs/README.md +53 -15
  405. package/packages/apra-fleet-se/fleet-sprint/docs/dolt-sync-redesign.md +281 -0
  406. package/packages/apra-fleet-se/fleet-sprint/docs/escalate-to-llm-design.md +1 -1
  407. package/packages/apra-fleet-se/fleet-sprint/docs/fleet-sprint-diagram.md +3 -3
  408. package/packages/apra-fleet-se/fleet-sprint/docs/run-sprint-cycle-prelude-decision.md +215 -0
  409. package/packages/apra-fleet-se/fleet-sprint/dolt-literal-guard.mjs +56 -1
  410. package/packages/apra-fleet-se/fleet-sprint/dolt-sync.mjs +1327 -44
  411. package/packages/apra-fleet-se/fleet-sprint/errors.mjs +470 -4
  412. package/packages/apra-fleet-se/fleet-sprint/explicit-id-create-guard.mjs +501 -0
  413. package/packages/apra-fleet-se/fleet-sprint/fatal-diagnostics.mjs +134 -0
  414. package/packages/apra-fleet-se/fleet-sprint/full-db-fetch-guard.mjs +102 -0
  415. package/packages/apra-fleet-se/fleet-sprint/git-sync.mjs +747 -0
  416. package/packages/apra-fleet-se/fleet-sprint/git-topology.mjs +543 -0
  417. package/packages/apra-fleet-se/fleet-sprint/guarded-modules.mjs +613 -0
  418. package/packages/apra-fleet-se/fleet-sprint/inline-ladder-guard.mjs +216 -0
  419. package/packages/apra-fleet-se/fleet-sprint/kb-hints.mjs +181 -0
  420. package/packages/apra-fleet-se/fleet-sprint/kb-injection.mjs +64 -0
  421. package/packages/apra-fleet-se/fleet-sprint/kb-maintainer.mjs +298 -0
  422. package/packages/apra-fleet-se/fleet-sprint/kb.mjs +1684 -0
  423. package/packages/apra-fleet-se/fleet-sprint/lower-quality.mjs +39 -0
  424. package/packages/apra-fleet-se/fleet-sprint/mcp-result.mjs +75 -0
  425. package/packages/apra-fleet-se/fleet-sprint/member-align.mjs +391 -0
  426. package/packages/apra-fleet-se/fleet-sprint/member-call.mjs +374 -0
  427. package/packages/apra-fleet-se/fleet-sprint/member-init-probe.mjs +644 -0
  428. package/packages/apra-fleet-se/fleet-sprint/member-provisioning.mjs +699 -0
  429. package/packages/apra-fleet-se/fleet-sprint/member-sync.mjs +802 -0
  430. package/packages/apra-fleet-se/fleet-sprint/member-target.mjs +93 -0
  431. package/packages/apra-fleet-se/fleet-sprint/newtask-text.mjs +266 -0
  432. package/packages/apra-fleet-se/fleet-sprint/orphan-reclaim.mjs +153 -0
  433. package/packages/apra-fleet-se/fleet-sprint/parent-notes-staleness.mjs +201 -0
  434. package/packages/apra-fleet-se/fleet-sprint/phases/deploy.mjs +218 -0
  435. package/packages/apra-fleet-se/fleet-sprint/phases/develop.mjs +869 -0
  436. package/packages/apra-fleet-se/fleet-sprint/phases/ensure-sprint-branch.mjs +295 -0
  437. package/packages/apra-fleet-se/fleet-sprint/phases/final-review.mjs +466 -0
  438. package/packages/apra-fleet-se/fleet-sprint/phases/harvest.mjs +212 -0
  439. package/packages/apra-fleet-se/fleet-sprint/phases/integ-test.mjs +358 -0
  440. package/packages/apra-fleet-se/fleet-sprint/phases/plan.mjs +395 -0
  441. package/packages/apra-fleet-se/fleet-sprint/phases/publish-pr.mjs +345 -0
  442. package/packages/apra-fleet-se/fleet-sprint/phases/re-review.mjs +264 -0
  443. package/packages/apra-fleet-se/fleet-sprint/phases/regression-test.mjs +179 -0
  444. package/packages/apra-fleet-se/fleet-sprint/phases/replan.mjs +230 -0
  445. package/packages/apra-fleet-se/fleet-sprint/phases/review.mjs +365 -0
  446. package/packages/apra-fleet-se/fleet-sprint/pr-body.mjs +259 -0
  447. package/packages/apra-fleet-se/fleet-sprint/prompts.mjs +617 -0
  448. package/packages/apra-fleet-se/fleet-sprint/role-policies.mjs +1434 -0
  449. package/packages/apra-fleet-se/fleet-sprint/round-session.mjs +100 -0
  450. package/packages/apra-fleet-se/fleet-sprint/runner.js +2289 -9928
  451. package/packages/apra-fleet-se/fleet-sprint/se-os-commands.mjs +24 -0
  452. package/packages/apra-fleet-se/fleet-sprint/se-posix.mjs +147 -12
  453. package/packages/apra-fleet-se/fleet-sprint/se-windows.mjs +111 -0
  454. package/packages/apra-fleet-se/fleet-sprint/shell-command-guard.mjs +347 -0
  455. package/packages/apra-fleet-se/fleet-sprint/skills/fleet-sprint-cli/SKILL.md +48 -6
  456. package/packages/apra-fleet-se/fleet-sprint/skills/fleet-supervisor/SKILL.md +98 -25
  457. package/packages/apra-fleet-se/fleet-sprint/sprint-args.mjs +590 -0
  458. package/packages/apra-fleet-se/fleet-sprint/sprint-report.mjs +339 -0
  459. package/packages/apra-fleet-se/fleet-sprint/sprint-state.mjs +185 -0
  460. package/packages/apra-fleet-se/fleet-sprint/unbracketed-push-guard.mjs +234 -0
  461. package/packages/apra-fleet-se/fleet-sprint/usage-limit-controller.mjs +218 -0
  462. package/packages/apra-fleet-se/fleet-sprint/vcs-auth.mjs +1445 -0
  463. package/packages/apra-fleet-se/fleet-sprint/vcs-module.mjs +284 -23
  464. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/azure-devops.mjs +170 -21
  465. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/bitbucket.mjs +28 -0
  466. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/github.mjs +354 -0
  467. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/index.mjs +189 -16
  468. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/shell-helpers.mjs +9 -4
  469. package/packages/apra-fleet-se/fleet-sprint/verify-block.mjs +152 -0
  470. package/packages/apra-fleet-se/fleet-sprint/viewer-extensions.mjs +311 -22
  471. package/packages/apra-fleet-se/fleet-sprint/worklists.mjs +559 -0
  472. package/packages/apra-fleet-se/package.json +2 -2
  473. package/packages/apra-fleet-se/src/supervisor/api.mjs +919 -0
  474. package/packages/apra-fleet-se/src/supervisor/backlog-member.mjs +332 -0
  475. package/packages/apra-fleet-se/src/supervisor/backlog.mjs +982 -0
  476. package/packages/apra-fleet-se/src/supervisor/beads-identity.mjs +246 -0
  477. package/packages/apra-fleet-se/src/supervisor/beads-view.mjs +438 -0
  478. package/packages/apra-fleet-se/src/supervisor/child-port.mjs +36 -0
  479. package/packages/apra-fleet-se/src/supervisor/dashboard.mjs +1659 -0
  480. package/packages/apra-fleet-se/src/supervisor/dolt-mutex.mjs +350 -0
  481. package/packages/apra-fleet-se/src/supervisor/dolt-orphan-sweep.mjs +338 -0
  482. package/packages/apra-fleet-se/src/supervisor/fleet-members.mjs +279 -0
  483. package/packages/apra-fleet-se/src/supervisor/history-view.mjs +276 -0
  484. package/packages/apra-fleet-se/src/supervisor/history.mjs +328 -0
  485. package/packages/apra-fleet-se/src/supervisor/id-allocator.mjs +521 -0
  486. package/packages/apra-fleet-se/src/supervisor/launch-form.mjs +444 -0
  487. package/packages/apra-fleet-se/src/supervisor/ledger.mjs +629 -0
  488. package/packages/apra-fleet-se/src/supervisor/lib/exec-bd.mjs +303 -0
  489. package/packages/apra-fleet-se/src/supervisor/log-timestamp.mjs +51 -0
  490. package/packages/apra-fleet-se/src/supervisor/log-view.mjs +159 -0
  491. package/packages/apra-fleet-se/src/supervisor/proxy.mjs +474 -0
  492. package/packages/apra-fleet-se/src/supervisor/readopt.mjs +136 -0
  493. package/packages/apra-fleet-se/src/supervisor/reconcile.mjs +263 -0
  494. package/packages/apra-fleet-se/src/supervisor/rename-with-retry.mjs +87 -0
  495. package/packages/apra-fleet-se/src/supervisor/scope-overlap.mjs +327 -0
  496. package/packages/apra-fleet-se/src/supervisor/self-log.mjs +133 -0
  497. package/packages/apra-fleet-se/src/supervisor/server.mjs +399 -0
  498. package/packages/apra-fleet-se/src/supervisor/spawner.mjs +542 -0
  499. package/packages/apra-fleet-se/src/supervisor/sprint-identity.mjs +96 -0
  500. package/packages/apra-fleet-se/src/supervisor/watchdog.mjs +987 -0
  501. package/packages/apra-fleet-workflow/package.json +1 -1
  502. package/packages/apra-fleet-workflow/src/viewer/index.mjs +81 -15
  503. package/packages/apra-fleet-workflow/src/viewer/run-summary.mjs +127 -0
  504. package/packages/apra-fleet-workflow/src/workflow/index.mjs +118 -10
  505. package/packages/apra-fleet-workflow/src/workflow/pricing.mjs +75 -25
  506. package/skills/fleet/SKILL.md +8 -8
  507. package/skills/fleet/auth-azdevops.md +14 -3
  508. package/skills/fleet/auth-bitbucket.md +2 -2
  509. package/skills/fleet/auth-github.md +5 -4
  510. package/skills/fleet/onboarding.md +3 -3
  511. package/skills/fleet/permissions.md +14 -1
  512. package/skills/fleet/profiles/node.json +1 -1
  513. package/skills/fleet/profiles/tag-kb-reconciler.json +2 -6
  514. package/skills/fleet/troubleshooting.md +3 -3
  515. package/version.json +1 -1
  516. package/dist/cli/agent-transform.d.ts.map +0 -1
  517. package/dist/cli/agent-transform.js.map +0 -1
  518. package/dist/cli/auth.d.ts.map +0 -1
  519. package/dist/cli/auth.js.map +0 -1
  520. package/dist/cli/config.d.ts.map +0 -1
  521. package/dist/cli/config.js.map +0 -1
  522. package/dist/cli/dolt-install.d.ts.map +0 -1
  523. package/dist/cli/dolt-install.js.map +0 -1
  524. package/dist/cli/install-guard.d.ts.map +0 -1
  525. package/dist/cli/install-guard.js.map +0 -1
  526. package/dist/cli/install.d.ts.map +0 -1
  527. package/dist/cli/install.js.map +0 -1
  528. package/dist/cli/join.d.ts.map +0 -1
  529. package/dist/cli/join.js.map +0 -1
  530. package/dist/cli/kb-commit.d.ts.map +0 -1
  531. package/dist/cli/kb-commit.js.map +0 -1
  532. package/dist/cli/kb-directives.d.ts.map +0 -1
  533. package/dist/cli/kb-directives.js.map +0 -1
  534. package/dist/cli/kb-import.d.ts.map +0 -1
  535. package/dist/cli/kb-import.js.map +0 -1
  536. package/dist/cli/register-member.d.ts.map +0 -1
  537. package/dist/cli/register-member.js.map +0 -1
  538. package/dist/cli/restart.d.ts.map +0 -1
  539. package/dist/cli/restart.js.map +0 -1
  540. package/dist/cli/secret.d.ts.map +0 -1
  541. package/dist/cli/secret.js.map +0 -1
  542. package/dist/cli/spoke.d.ts.map +0 -1
  543. package/dist/cli/spoke.js.map +0 -1
  544. package/dist/cli/start.d.ts.map +0 -1
  545. package/dist/cli/start.js.map +0 -1
  546. package/dist/cli/status.d.ts.map +0 -1
  547. package/dist/cli/status.js.map +0 -1
  548. package/dist/cli/stop.d.ts.map +0 -1
  549. package/dist/cli/stop.js.map +0 -1
  550. package/dist/cli/uninstall.d.ts.map +0 -1
  551. package/dist/cli/uninstall.js.map +0 -1
  552. package/dist/cli/update.d.ts.map +0 -1
  553. package/dist/cli/update.js.map +0 -1
  554. package/dist/cli/watch.d.ts.map +0 -1
  555. package/dist/cli/watch.js.map +0 -1
  556. package/dist/cli/workflow-assets.d.ts.map +0 -1
  557. package/dist/cli/workflow-assets.js.map +0 -1
  558. package/dist/cli/workflow.d.ts.map +0 -1
  559. package/dist/cli/workflow.js.map +0 -1
  560. package/dist/commands/kb-server.d.ts.map +0 -1
  561. package/dist/commands/kb-server.js.map +0 -1
  562. package/dist/delivery-mode.d.ts.map +0 -1
  563. package/dist/delivery-mode.js.map +0 -1
  564. package/dist/hub-service/activity.d.ts.map +0 -1
  565. package/dist/hub-service/activity.js.map +0 -1
  566. package/dist/hub-service/audit-log.d.ts.map +0 -1
  567. package/dist/hub-service/audit-log.js.map +0 -1
  568. package/dist/hub-service/db/pool.d.ts.map +0 -1
  569. package/dist/hub-service/db/pool.js.map +0 -1
  570. package/dist/hub-service/enrollment.d.ts.map +0 -1
  571. package/dist/hub-service/enrollment.js.map +0 -1
  572. package/dist/hub-service/envelope-routes.d.ts.map +0 -1
  573. package/dist/hub-service/envelope-routes.js.map +0 -1
  574. package/dist/hub-service/handlers/installers.d.ts.map +0 -1
  575. package/dist/hub-service/handlers/installers.js.map +0 -1
  576. package/dist/hub-service/http-server.d.ts.map +0 -1
  577. package/dist/hub-service/http-server.js.map +0 -1
  578. package/dist/hub-service/hub-jwt.d.ts.map +0 -1
  579. package/dist/hub-service/hub-jwt.js.map +0 -1
  580. package/dist/hub-service/jwt-revocation.d.ts.map +0 -1
  581. package/dist/hub-service/jwt-revocation.js.map +0 -1
  582. package/dist/hub-service/machines.d.ts.map +0 -1
  583. package/dist/hub-service/machines.js.map +0 -1
  584. package/dist/hub-service/main.d.ts.map +0 -1
  585. package/dist/hub-service/main.js.map +0 -1
  586. package/dist/hub-service/member-tokens.d.ts.map +0 -1
  587. package/dist/hub-service/member-tokens.js.map +0 -1
  588. package/dist/hub-service/member-view.d.ts.map +0 -1
  589. package/dist/hub-service/member-view.js.map +0 -1
  590. package/dist/hub-service/members.d.ts.map +0 -1
  591. package/dist/hub-service/members.js.map +0 -1
  592. package/dist/hub-service/presence.d.ts.map +0 -1
  593. package/dist/hub-service/presence.js.map +0 -1
  594. package/dist/hub-service/project-view.d.ts.map +0 -1
  595. package/dist/hub-service/project-view.js.map +0 -1
  596. package/dist/hub-service/projects.d.ts.map +0 -1
  597. package/dist/hub-service/projects.js.map +0 -1
  598. package/dist/hub-service/relay-queue.d.ts.map +0 -1
  599. package/dist/hub-service/relay-queue.js.map +0 -1
  600. package/dist/hub-service/session-jwt.d.ts.map +0 -1
  601. package/dist/hub-service/session-jwt.js.map +0 -1
  602. package/dist/hub-service/usage.d.ts.map +0 -1
  603. package/dist/hub-service/usage.js.map +0 -1
  604. package/dist/hub-service/users.d.ts.map +0 -1
  605. package/dist/hub-service/users.js.map +0 -1
  606. package/dist/hub-service/workspaces.d.ts.map +0 -1
  607. package/dist/hub-service/workspaces.js.map +0 -1
  608. package/dist/index.d.ts.map +0 -1
  609. package/dist/index.js.map +0 -1
  610. package/dist/onboarding/text.d.ts.map +0 -1
  611. package/dist/onboarding/text.js.map +0 -1
  612. package/dist/os/git-bash-candidates.d.ts.map +0 -1
  613. package/dist/os/git-bash-candidates.js.map +0 -1
  614. package/dist/os/index.d.ts.map +0 -1
  615. package/dist/os/index.js.map +0 -1
  616. package/dist/os/linux.d.ts.map +0 -1
  617. package/dist/os/linux.js.map +0 -1
  618. package/dist/os/macos.d.ts.map +0 -1
  619. package/dist/os/macos.js.map +0 -1
  620. package/dist/os/os-commands.d.ts.map +0 -1
  621. package/dist/os/os-commands.js.map +0 -1
  622. package/dist/os/windows-gitbash.d.ts.map +0 -1
  623. package/dist/os/windows-gitbash.js.map +0 -1
  624. package/dist/os/windows-wrapper.d.ts.map +0 -1
  625. package/dist/os/windows-wrapper.js.map +0 -1
  626. package/dist/os/windows.d.ts.map +0 -1
  627. package/dist/os/windows.js.map +0 -1
  628. package/dist/paths.d.ts.map +0 -1
  629. package/dist/paths.js.map +0 -1
  630. package/dist/providers/agy.d.ts.map +0 -1
  631. package/dist/providers/agy.js.map +0 -1
  632. package/dist/providers/claude.d.ts.map +0 -1
  633. package/dist/providers/claude.js.map +0 -1
  634. package/dist/providers/codex.d.ts.map +0 -1
  635. package/dist/providers/codex.js.map +0 -1
  636. package/dist/providers/copilot.d.ts.map +0 -1
  637. package/dist/providers/copilot.js.map +0 -1
  638. package/dist/providers/email/headers.d.ts.map +0 -1
  639. package/dist/providers/email/headers.js.map +0 -1
  640. package/dist/providers/email/index.d.ts.map +0 -1
  641. package/dist/providers/email/index.js.map +0 -1
  642. package/dist/providers/email/provider.d.ts.map +0 -1
  643. package/dist/providers/email/provider.js.map +0 -1
  644. package/dist/providers/email/sendgrid.d.ts.map +0 -1
  645. package/dist/providers/email/sendgrid.js.map +0 -1
  646. package/dist/providers/email/smtp.d.ts.map +0 -1
  647. package/dist/providers/email/smtp.js.map +0 -1
  648. package/dist/providers/index.d.ts.map +0 -1
  649. package/dist/providers/index.js.map +0 -1
  650. package/dist/providers/none.d.ts.map +0 -1
  651. package/dist/providers/none.js.map +0 -1
  652. package/dist/providers/opencode.d.ts.map +0 -1
  653. package/dist/providers/opencode.js.map +0 -1
  654. package/dist/providers/provider.d.ts.map +0 -1
  655. package/dist/providers/provider.js.map +0 -1
  656. package/dist/services/agent-provisioner.d.ts.map +0 -1
  657. package/dist/services/agent-provisioner.js.map +0 -1
  658. package/dist/services/auth-socket.d.ts.map +0 -1
  659. package/dist/services/auth-socket.js.map +0 -1
  660. package/dist/services/auth-web.d.ts.map +0 -1
  661. package/dist/services/auth-web.js.map +0 -1
  662. package/dist/services/budget-awareness.d.ts.map +0 -1
  663. package/dist/services/budget-awareness.js.map +0 -1
  664. package/dist/services/cloud/activity.d.ts.map +0 -1
  665. package/dist/services/cloud/activity.js.map +0 -1
  666. package/dist/services/cloud/aws.d.ts.map +0 -1
  667. package/dist/services/cloud/aws.js.map +0 -1
  668. package/dist/services/cloud/cost.d.ts.map +0 -1
  669. package/dist/services/cloud/cost.js.map +0 -1
  670. package/dist/services/cloud/idle-manager.d.ts.map +0 -1
  671. package/dist/services/cloud/idle-manager.js.map +0 -1
  672. package/dist/services/cloud/lifecycle.d.ts.map +0 -1
  673. package/dist/services/cloud/lifecycle.js.map +0 -1
  674. package/dist/services/cloud/task-wrapper.d.ts.map +0 -1
  675. package/dist/services/cloud/task-wrapper.js.map +0 -1
  676. package/dist/services/cloud/types.d.ts.map +0 -1
  677. package/dist/services/cloud/types.js.map +0 -1
  678. package/dist/services/cloud-sync.d.ts.map +0 -1
  679. package/dist/services/cloud-sync.js.map +0 -1
  680. package/dist/services/context-admission.d.ts.map +0 -1
  681. package/dist/services/context-admission.js.map +0 -1
  682. package/dist/services/credential-cleanup.d.ts.map +0 -1
  683. package/dist/services/credential-cleanup.js.map +0 -1
  684. package/dist/services/credential-store.d.ts.map +0 -1
  685. package/dist/services/credential-store.js.map +0 -1
  686. package/dist/services/event-bus.d.ts.map +0 -1
  687. package/dist/services/event-bus.js.map +0 -1
  688. package/dist/services/file-chunker.d.ts.map +0 -1
  689. package/dist/services/file-chunker.js.map +0 -1
  690. package/dist/services/file-transfer-relay.d.ts.map +0 -1
  691. package/dist/services/file-transfer-relay.js.map +0 -1
  692. package/dist/services/file-transfer.d.ts.map +0 -1
  693. package/dist/services/file-transfer.js.map +0 -1
  694. package/dist/services/git-config.d.ts.map +0 -1
  695. package/dist/services/git-config.js.map +0 -1
  696. package/dist/services/github-app.d.ts.map +0 -1
  697. package/dist/services/github-app.js.map +0 -1
  698. package/dist/services/http-transport.d.ts.map +0 -1
  699. package/dist/services/http-transport.js.map +0 -1
  700. package/dist/services/hub-client.d.ts.map +0 -1
  701. package/dist/services/hub-client.js.map +0 -1
  702. package/dist/services/icons.d.ts.map +0 -1
  703. package/dist/services/icons.js.map +0 -1
  704. package/dist/services/jwt.d.ts.map +0 -1
  705. package/dist/services/jwt.js.map +0 -1
  706. package/dist/services/knowledge/audn.d.ts.map +0 -1
  707. package/dist/services/knowledge/audn.js.map +0 -1
  708. package/dist/services/knowledge/file-hash.d.ts.map +0 -1
  709. package/dist/services/knowledge/file-hash.js.map +0 -1
  710. package/dist/services/knowledge/http-provider.d.ts.map +0 -1
  711. package/dist/services/knowledge/http-provider.js.map +0 -1
  712. package/dist/services/knowledge/kb-providers.d.ts.map +0 -1
  713. package/dist/services/knowledge/kb-providers.js.map +0 -1
  714. package/dist/services/knowledge/kb-scope-input.d.ts +0 -5
  715. package/dist/services/knowledge/kb-scope-input.d.ts.map +0 -1
  716. package/dist/services/knowledge/kb-scope-input.js +0 -11
  717. package/dist/services/knowledge/kb-scope-input.js.map +0 -1
  718. package/dist/services/knowledge/kb-service.d.ts.map +0 -1
  719. package/dist/services/knowledge/kb-service.js.map +0 -1
  720. package/dist/services/knowledge/path-validation.d.ts.map +0 -1
  721. package/dist/services/knowledge/path-validation.js.map +0 -1
  722. package/dist/services/knowledge/pre-init.d.ts.map +0 -1
  723. package/dist/services/knowledge/pre-init.js.map +0 -1
  724. package/dist/services/knowledge/project-slug.d.ts.map +0 -1
  725. package/dist/services/knowledge/project-slug.js.map +0 -1
  726. package/dist/services/knowledge/sqlite-provider.d.ts.map +0 -1
  727. package/dist/services/knowledge/sqlite-provider.js.map +0 -1
  728. package/dist/services/knowledge/types.d.ts.map +0 -1
  729. package/dist/services/knowledge/types.js.map +0 -1
  730. package/dist/services/known-hosts.d.ts.map +0 -1
  731. package/dist/services/known-hosts.js.map +0 -1
  732. package/dist/services/known-sessions.d.ts.map +0 -1
  733. package/dist/services/known-sessions.js.map +0 -1
  734. package/dist/services/member-home.d.ts.map +0 -1
  735. package/dist/services/member-home.js.map +0 -1
  736. package/dist/services/member-remote-url.d.ts.map +0 -1
  737. package/dist/services/member-remote-url.js.map +0 -1
  738. package/dist/services/model-pricing.d.ts.map +0 -1
  739. package/dist/services/model-pricing.js.map +0 -1
  740. package/dist/services/onboarding.d.ts.map +0 -1
  741. package/dist/services/onboarding.js.map +0 -1
  742. package/dist/services/orphan-recovery.d.ts.map +0 -1
  743. package/dist/services/orphan-recovery.js.map +0 -1
  744. package/dist/services/pending-responses.d.ts.map +0 -1
  745. package/dist/services/pending-responses.js.map +0 -1
  746. package/dist/services/preflight-check.d.ts.map +0 -1
  747. package/dist/services/preflight-check.js.map +0 -1
  748. package/dist/services/registry.d.ts.map +0 -1
  749. package/dist/services/registry.js.map +0 -1
  750. package/dist/services/relay-context.d.ts.map +0 -1
  751. package/dist/services/relay-context.js.map +0 -1
  752. package/dist/services/relay-executor.d.ts.map +0 -1
  753. package/dist/services/relay-executor.js.map +0 -1
  754. package/dist/services/relay-request.d.ts.map +0 -1
  755. package/dist/services/relay-request.js.map +0 -1
  756. package/dist/services/relay-strategy.d.ts.map +0 -1
  757. package/dist/services/relay-strategy.js.map +0 -1
  758. package/dist/services/service-manager/index.d.ts.map +0 -1
  759. package/dist/services/service-manager/index.js.map +0 -1
  760. package/dist/services/service-manager/linux.d.ts.map +0 -1
  761. package/dist/services/service-manager/linux.js.map +0 -1
  762. package/dist/services/service-manager/macos.d.ts.map +0 -1
  763. package/dist/services/service-manager/macos.js.map +0 -1
  764. package/dist/services/service-manager/types.d.ts.map +0 -1
  765. package/dist/services/service-manager/types.js.map +0 -1
  766. package/dist/services/service-manager/windows.d.ts.map +0 -1
  767. package/dist/services/service-manager/windows.js.map +0 -1
  768. package/dist/services/session-registry.d.ts.map +0 -1
  769. package/dist/services/session-registry.js.map +0 -1
  770. package/dist/services/sftp.d.ts.map +0 -1
  771. package/dist/services/sftp.js.map +0 -1
  772. package/dist/services/shell-probe.d.ts.map +0 -1
  773. package/dist/services/shell-probe.js.map +0 -1
  774. package/dist/services/singleton.d.ts.map +0 -1
  775. package/dist/services/singleton.js.map +0 -1
  776. package/dist/services/sprint-coordination.d.ts.map +0 -1
  777. package/dist/services/sprint-coordination.js.map +0 -1
  778. package/dist/services/ssh.d.ts.map +0 -1
  779. package/dist/services/ssh.js.map +0 -1
  780. package/dist/services/stall/find-log-file.d.ts.map +0 -1
  781. package/dist/services/stall/find-log-file.js.map +0 -1
  782. package/dist/services/stall/index.d.ts.map +0 -1
  783. package/dist/services/stall/index.js.map +0 -1
  784. package/dist/services/stall/log-path-resolver.d.ts.map +0 -1
  785. package/dist/services/stall/log-path-resolver.js.map +0 -1
  786. package/dist/services/stall/read-log-tail.d.ts.map +0 -1
  787. package/dist/services/stall/read-log-tail.js.map +0 -1
  788. package/dist/services/stall/stall-detector.d.ts.map +0 -1
  789. package/dist/services/stall/stall-detector.js.map +0 -1
  790. package/dist/services/stall/stall-poller.d.ts.map +0 -1
  791. package/dist/services/stall/stall-poller.js.map +0 -1
  792. package/dist/services/stall/time-utils.d.ts.map +0 -1
  793. package/dist/services/stall/time-utils.js.map +0 -1
  794. package/dist/services/statusline.d.ts.map +0 -1
  795. package/dist/services/statusline.js.map +0 -1
  796. package/dist/services/strategy.d.ts.map +0 -1
  797. package/dist/services/strategy.js.map +0 -1
  798. package/dist/services/substitution-engine.d.ts.map +0 -1
  799. package/dist/services/substitution-engine.js.map +0 -1
  800. package/dist/services/task-cleanup.d.ts.map +0 -1
  801. package/dist/services/task-cleanup.js.map +0 -1
  802. package/dist/services/token-issuer.d.ts.map +0 -1
  803. package/dist/services/token-issuer.js.map +0 -1
  804. package/dist/services/tool-registry.d.ts.map +0 -1
  805. package/dist/services/tool-registry.js.map +0 -1
  806. package/dist/services/update-check.d.ts.map +0 -1
  807. package/dist/services/update-check.js.map +0 -1
  808. package/dist/services/user-config.d.ts.map +0 -1
  809. package/dist/services/user-config.js.map +0 -1
  810. package/dist/services/vcs/azure-devops.d.ts.map +0 -1
  811. package/dist/services/vcs/azure-devops.js.map +0 -1
  812. package/dist/services/vcs/bitbucket.d.ts.map +0 -1
  813. package/dist/services/vcs/bitbucket.js.map +0 -1
  814. package/dist/services/vcs/constants.d.ts.map +0 -1
  815. package/dist/services/vcs/constants.js.map +0 -1
  816. package/dist/services/vcs/github.d.ts.map +0 -1
  817. package/dist/services/vcs/github.js.map +0 -1
  818. package/dist/services/vcs/types.d.ts.map +0 -1
  819. package/dist/services/vcs/types.js.map +0 -1
  820. package/dist/services/version-check.d.ts.map +0 -1
  821. package/dist/services/version-check.js.map +0 -1
  822. package/dist/services/watch/fleet-log.d.ts.map +0 -1
  823. package/dist/services/watch/fleet-log.js.map +0 -1
  824. package/dist/services/watch/project-resolver.d.ts.map +0 -1
  825. package/dist/services/watch/project-resolver.js.map +0 -1
  826. package/dist/services/watch/transcript-formatter.d.ts.map +0 -1
  827. package/dist/services/watch/transcript-formatter.js.map +0 -1
  828. package/dist/smoke-test.d.ts.map +0 -1
  829. package/dist/smoke-test.js.map +0 -1
  830. package/dist/tools/check-status.d.ts.map +0 -1
  831. package/dist/tools/check-status.js.map +0 -1
  832. package/dist/tools/child-id-allocator.d.ts.map +0 -1
  833. package/dist/tools/child-id-allocator.js.map +0 -1
  834. package/dist/tools/cloud-control.d.ts.map +0 -1
  835. package/dist/tools/cloud-control.js.map +0 -1
  836. package/dist/tools/code-intelligence-codebase-memory.d.ts.map +0 -1
  837. package/dist/tools/code-intelligence-codebase-memory.js.map +0 -1
  838. package/dist/tools/code-intelligence-freshness.d.ts.map +0 -1
  839. package/dist/tools/code-intelligence-freshness.js.map +0 -1
  840. package/dist/tools/code-intelligence-gitnexus.d.ts.map +0 -1
  841. package/dist/tools/code-intelligence-gitnexus.js.map +0 -1
  842. package/dist/tools/code-intelligence-kb-enrich.d.ts.map +0 -1
  843. package/dist/tools/code-intelligence-kb-enrich.js.map +0 -1
  844. package/dist/tools/code-intelligence-reindex.d.ts.map +0 -1
  845. package/dist/tools/code-intelligence-reindex.js.map +0 -1
  846. package/dist/tools/code-intelligence-telemetry.d.ts.map +0 -1
  847. package/dist/tools/code-intelligence-telemetry.js.map +0 -1
  848. package/dist/tools/code-intelligence-tests.d.ts.map +0 -1
  849. package/dist/tools/code-intelligence-tests.js.map +0 -1
  850. package/dist/tools/code-intelligence.d.ts.map +0 -1
  851. package/dist/tools/code-intelligence.js.map +0 -1
  852. package/dist/tools/compose-permissions.d.ts.map +0 -1
  853. package/dist/tools/compose-permissions.js.map +0 -1
  854. package/dist/tools/credential-store-delete.d.ts.map +0 -1
  855. package/dist/tools/credential-store-delete.js.map +0 -1
  856. package/dist/tools/credential-store-list.d.ts.map +0 -1
  857. package/dist/tools/credential-store-list.js.map +0 -1
  858. package/dist/tools/credential-store-set.d.ts.map +0 -1
  859. package/dist/tools/credential-store-set.js.map +0 -1
  860. package/dist/tools/credential-store-update.d.ts.map +0 -1
  861. package/dist/tools/credential-store-update.js.map +0 -1
  862. package/dist/tools/dolt-push-mutex.d.ts.map +0 -1
  863. package/dist/tools/dolt-push-mutex.js.map +0 -1
  864. package/dist/tools/execute-command.d.ts.map +0 -1
  865. package/dist/tools/execute-command.js.map +0 -1
  866. package/dist/tools/execute-prompt.d.ts.map +0 -1
  867. package/dist/tools/execute-prompt.js.map +0 -1
  868. package/dist/tools/get-member-model-pricing.d.ts.map +0 -1
  869. package/dist/tools/get-member-model-pricing.js.map +0 -1
  870. package/dist/tools/kb-capture.d.ts.map +0 -1
  871. package/dist/tools/kb-capture.js.map +0 -1
  872. package/dist/tools/kb-context.d.ts.map +0 -1
  873. package/dist/tools/kb-context.js.map +0 -1
  874. package/dist/tools/kb-export.d.ts.map +0 -1
  875. package/dist/tools/kb-export.js.map +0 -1
  876. package/dist/tools/kb-feedback.d.ts.map +0 -1
  877. package/dist/tools/kb-feedback.js.map +0 -1
  878. package/dist/tools/kb-freshness-sweep.d.ts.map +0 -1
  879. package/dist/tools/kb-freshness-sweep.js.map +0 -1
  880. package/dist/tools/kb-harvest.d.ts.map +0 -1
  881. package/dist/tools/kb-harvest.js.map +0 -1
  882. package/dist/tools/kb-import.d.ts.map +0 -1
  883. package/dist/tools/kb-import.js.map +0 -1
  884. package/dist/tools/kb-invalidate.d.ts.map +0 -1
  885. package/dist/tools/kb-invalidate.js.map +0 -1
  886. package/dist/tools/kb-list.d.ts.map +0 -1
  887. package/dist/tools/kb-list.js.map +0 -1
  888. package/dist/tools/kb-promote.d.ts.map +0 -1
  889. package/dist/tools/kb-promote.js.map +0 -1
  890. package/dist/tools/kb-query.d.ts.map +0 -1
  891. package/dist/tools/kb-query.js.map +0 -1
  892. package/dist/tools/kb-reconcile-prefilter.d.ts.map +0 -1
  893. package/dist/tools/kb-reconcile-prefilter.js.map +0 -1
  894. package/dist/tools/kb-resolve-contradiction.d.ts.map +0 -1
  895. package/dist/tools/kb-resolve-contradiction.js.map +0 -1
  896. package/dist/tools/kb-session-prime.d.ts.map +0 -1
  897. package/dist/tools/kb-session-prime.js.map +0 -1
  898. package/dist/tools/kb-setup.d.ts.map +0 -1
  899. package/dist/tools/kb-setup.js.map +0 -1
  900. package/dist/tools/kb-stats.d.ts.map +0 -1
  901. package/dist/tools/kb-stats.js.map +0 -1
  902. package/dist/tools/list-members.d.ts.map +0 -1
  903. package/dist/tools/list-members.js.map +0 -1
  904. package/dist/tools/member-detail.d.ts.map +0 -1
  905. package/dist/tools/member-detail.js.map +0 -1
  906. package/dist/tools/member-reservation.d.ts.map +0 -1
  907. package/dist/tools/member-reservation.js.map +0 -1
  908. package/dist/tools/monitor-task.d.ts.map +0 -1
  909. package/dist/tools/monitor-task.js.map +0 -1
  910. package/dist/tools/provision-auth.d.ts.map +0 -1
  911. package/dist/tools/provision-auth.js.map +0 -1
  912. package/dist/tools/provision-vcs-auth.d.ts.map +0 -1
  913. package/dist/tools/provision-vcs-auth.js.map +0 -1
  914. package/dist/tools/receive-files.d.ts.map +0 -1
  915. package/dist/tools/receive-files.js.map +0 -1
  916. package/dist/tools/register-member.d.ts.map +0 -1
  917. package/dist/tools/register-member.js.map +0 -1
  918. package/dist/tools/remove-member.d.ts.map +0 -1
  919. package/dist/tools/remove-member.js.map +0 -1
  920. package/dist/tools/report-status.d.ts.map +0 -1
  921. package/dist/tools/report-status.js.map +0 -1
  922. package/dist/tools/respond-to-message.d.ts.map +0 -1
  923. package/dist/tools/respond-to-message.js.map +0 -1
  924. package/dist/tools/revoke-vcs-auth.d.ts.map +0 -1
  925. package/dist/tools/revoke-vcs-auth.js.map +0 -1
  926. package/dist/tools/send-email.d.ts.map +0 -1
  927. package/dist/tools/send-email.js.map +0 -1
  928. package/dist/tools/send-files.d.ts.map +0 -1
  929. package/dist/tools/send-files.js.map +0 -1
  930. package/dist/tools/send-message.d.ts.map +0 -1
  931. package/dist/tools/send-message.js.map +0 -1
  932. package/dist/tools/setup-git-app.d.ts.map +0 -1
  933. package/dist/tools/setup-git-app.js.map +0 -1
  934. package/dist/tools/setup-ssh-key.d.ts.map +0 -1
  935. package/dist/tools/setup-ssh-key.js.map +0 -1
  936. package/dist/tools/shutdown-server.d.ts.map +0 -1
  937. package/dist/tools/shutdown-server.js.map +0 -1
  938. package/dist/tools/stop-prompt.d.ts.map +0 -1
  939. package/dist/tools/stop-prompt.js.map +0 -1
  940. package/dist/tools/update-agent-cli.d.ts.map +0 -1
  941. package/dist/tools/update-agent-cli.js.map +0 -1
  942. package/dist/tools/update-member.d.ts.map +0 -1
  943. package/dist/tools/update-member.js.map +0 -1
  944. package/dist/tools/version.d.ts.map +0 -1
  945. package/dist/tools/version.js.map +0 -1
  946. package/dist/types.d.ts.map +0 -1
  947. package/dist/types.js.map +0 -1
  948. package/dist/utils/agent-helpers.d.ts.map +0 -1
  949. package/dist/utils/agent-helpers.js.map +0 -1
  950. package/dist/utils/ansi.d.ts.map +0 -1
  951. package/dist/utils/ansi.js.map +0 -1
  952. package/dist/utils/auth-env.d.ts.map +0 -1
  953. package/dist/utils/auth-env.js.map +0 -1
  954. package/dist/utils/collect-secret.d.ts.map +0 -1
  955. package/dist/utils/collect-secret.js.map +0 -1
  956. package/dist/utils/credential-validation.d.ts.map +0 -1
  957. package/dist/utils/credential-validation.js.map +0 -1
  958. package/dist/utils/crypto.d.ts.map +0 -1
  959. package/dist/utils/crypto.js.map +0 -1
  960. package/dist/utils/deep-merge.d.ts.map +0 -1
  961. package/dist/utils/deep-merge.js.map +0 -1
  962. package/dist/utils/file-permissions.d.ts.map +0 -1
  963. package/dist/utils/file-permissions.js.map +0 -1
  964. package/dist/utils/gpu-parser.d.ts.map +0 -1
  965. package/dist/utils/gpu-parser.js.map +0 -1
  966. package/dist/utils/log-helpers.d.ts.map +0 -1
  967. package/dist/utils/log-helpers.js.map +0 -1
  968. package/dist/utils/oob-timeout.d.ts.map +0 -1
  969. package/dist/utils/oob-timeout.js.map +0 -1
  970. package/dist/utils/opencode-model-validation.d.ts.map +0 -1
  971. package/dist/utils/opencode-model-validation.js.map +0 -1
  972. package/dist/utils/pid-helpers.d.ts.map +0 -1
  973. package/dist/utils/pid-helpers.js.map +0 -1
  974. package/dist/utils/platform.d.ts.map +0 -1
  975. package/dist/utils/platform.js.map +0 -1
  976. package/dist/utils/process-utils.d.ts.map +0 -1
  977. package/dist/utils/process-utils.js.map +0 -1
  978. package/dist/utils/prompt-errors.d.ts.map +0 -1
  979. package/dist/utils/prompt-errors.js.map +0 -1
  980. package/dist/utils/resolve-member.d.ts.map +0 -1
  981. package/dist/utils/resolve-member.js.map +0 -1
  982. package/dist/utils/secure-input.d.ts.map +0 -1
  983. package/dist/utils/secure-input.js.map +0 -1
  984. package/dist/utils/session-caller.d.ts.map +0 -1
  985. package/dist/utils/session-caller.js.map +0 -1
  986. package/dist/utils/shell-escape.d.ts.map +0 -1
  987. package/dist/utils/shell-escape.js.map +0 -1
  988. package/dist/utils/skill-matrix.d.ts.map +0 -1
  989. package/dist/utils/skill-matrix.js.map +0 -1
  990. package/dist/utils/ssh-error-messages.d.ts.map +0 -1
  991. package/dist/utils/ssh-error-messages.js.map +0 -1
  992. package/dist/utils/work-folder-validation.d.ts.map +0 -1
  993. package/dist/utils/work-folder-validation.js.map +0 -1
  994. package/dist/utils/workspace-trust.d.ts.map +0 -1
  995. package/dist/utils/workspace-trust.js.map +0 -1
  996. package/dist/version.d.ts.map +0 -1
  997. package/dist/version.js.map +0 -1
@@ -0,0 +1,501 @@
1
+ import fs from 'fs';
2
+ import path from 'path';
3
+ import {
4
+ findCallSites,
5
+ maskComments,
6
+ skipStringLiteral,
7
+ canStartRegex,
8
+ skipRegexLiteral,
9
+ } from './dispatch-safety-guard.mjs';
10
+ import { explicitIdCreateModulePaths, EXPLICIT_ID_CREATE_EXEMPT } from './guarded-modules.mjs';
11
+
12
+ // =============================================================================
13
+ // apra-fleet-btj9.7 -- explicit-id-create guard checker.
14
+ //
15
+ // Invariant under test: no scanned module may dispatch a bead-CREATION
16
+ // command (`bd create`, of ANY shape) unless it lives in beads-children.mjs
17
+ // -- the single module that pairs an explicit-id create with the
18
+ // probe-and-refuse seam (assertChildIdFree(), called from
19
+ // createChildBeadWithAllocatedId) that refuses an occupied id and keeps it
20
+ // out of the allocator's pool (apra-fleet-btj9). A second, unguarded
21
+ // bead-creation site anywhere else in this directory would bypass that
22
+ // id discipline, so this is a mechanical scan -- same shape as the
23
+ // sibling guards -- rather than a call-graph proof that assertChildIdFree()
24
+ // actually ran first.
25
+ //
26
+ // -----------------------------------------------------------------------
27
+ // THE RULE, AND THE TWO WIDENINGS THAT PRODUCED IT
28
+ // -----------------------------------------------------------------------
29
+ //
30
+ // WIDENING 1 -- PAST "carries a literal --id flag" (review round on
31
+ // apra-fleet-btj9.7): the first cut of this guard matched `bd create` only
32
+ // when an explicit `--id` flag literal appeared LATER in the same balanced
33
+ // call text. That misses the one real call site's own shape --
34
+ // beads-children.mjs's `bd create "${title}" --body-file
35
+ // "${descriptionFile}" -p "${priority}" ${parentageFlags} --silent`, where
36
+ // the id flag is assembled into `parentageFlags` (`--id ${grant.childId}`)
37
+ // and never appears as literal text inside the command() call itself. A
38
+ // second, unguarded module that copied exactly that shape would scan clean
39
+ // under the literal-`--id` regex. Rather than chase every way an id flag can
40
+ // be assembled through a variable (an open-ended, unwinnable text-matching
41
+ // problem), the rule flags a bead-creation command regardless of whether an
42
+ // id flag is literal, interpolated, or absent entirely.
43
+ //
44
+ // WIDENING 2 -- PAST "inside a call spelled literally command(" (this bead,
45
+ // apra-fleet-btj9.4): the call-site rule below reuses findCallSites(), whose
46
+ // regex recognizes only the identifiers `command(` / `agent(` when not
47
+ // preceded by a dot or word character. So the effective rule WAS: a bead
48
+ // creation is only seen when it is dispatched from a call spelled literally
49
+ // `command(`. A module that routed the same command through ANY other
50
+ // wrapper -- a local `runBd` helper, a destructured or renamed binding, or a
51
+ // method call such as `ctx.command(...)` which the lookbehind deliberately
52
+ // excludes -- reintroduced an unguarded bead-creation site that this guard
53
+ // reported clean. Measured directly against the real checker before the fix:
54
+ // a fixture dispatching `bd create "${title}" --id ${id} --silent` through
55
+ // both a `runBd(...)` wrapper and a `ctx.command(...)` method call produced
56
+ // ZERO violations.
57
+ //
58
+ // HOW WIDENING 2 IS DONE, AND WHY NOT THE OBVIOUS WAY. The tempting fix is
59
+ // "flag the `bd create` token anywhere in the module, forget the enclosing
60
+ // call expression". That was MEASURED and rejected: across the 58 modules in
61
+ // the scanned set it produces 14 false positives, every one of them prose --
62
+ // LLM-prompt text in prompts.mjs / regression-test.mjs / newtask-text.mjs
63
+ // that instructs an agent about `bd create`, and log/reason strings in
64
+ // abort.mjs / review.mjs / re-review.mjs / final-review.mjs /
65
+ // sprint-report.mjs that merely NAME the command. A guard that needs a
66
+ // hand-maintained prose-exemption list of that size rots faster than the
67
+ // hole it closes.
68
+ //
69
+ // The discriminator this guard uses instead needs no exemption list: a
70
+ // DISPATCH is a command literal -- a string/template literal whose content
71
+ // BEGINS with `bd create` and continues into an ARGUMENT (a quoted value, a
72
+ // `${...}` interpolation, a `-` flag, or nothing left in the literal, i.e.
73
+ // the string-concatenation shape). Prose that merely mentions the command
74
+ // either does not begin with it ("...not sent to bd create") or continues
75
+ // into English words ("bd create failed (${stage})"). That rule is
76
+ // deliberately blind to the enclosing call expression, so it covers a
77
+ // wrapper, a renamed binding, a method call, and a call assembled at runtime
78
+ // alike -- which is why this guard does NOT instead try to pin the set of
79
+ // recognized dispatch-primitive identifiers: there is nothing left to
80
+ // enumerate. Measured: 0 hits across the whole scanned set, and it does
81
+ // catch beads-children.mjs's own real create when that file is offered
82
+ // directly (see the exemption note below).
83
+ //
84
+ // THE TWO RULES ARE A UNION, NOT A REPLACEMENT. The call-site rule is kept
85
+ // so that widening 2 strictly ADDS coverage: a command() call text whose
86
+ // `bd create` is NOT at the start of a literal -- for example
87
+ // `command(`cd ${dir} && bd create ...`)` -- was already flagged and still
88
+ // is. Violations are deduplicated across the two rules: a reported
89
+ // `command(...)` site claims its whole multi-line span, so the command
90
+ // literal nested inside it (which that violation already quotes in full) is
91
+ // not reported a second time.
92
+ //
93
+ // RESIDUAL LIMITS (known, accepted, measured -- not silent):
94
+ // - A `bd create` that is neither inside a `command(`/`agent(` call nor at
95
+ // the start of its own literal is not seen. Concretely: a non-command
96
+ // wrapper handed `cd ${dir} && bd create ...`. Closing that would
97
+ // require the prose-exemption list rejected above.
98
+ // - A creation assembled from fragments that never spell `bd` and
99
+ // `create` adjacently in any one literal (`bd ${verb}`) is not seen.
100
+ // This is the same unwinnable text-matching frontier widening 1 already
101
+ // declined to chase.
102
+ // - This is a source-text scan over the registered module list, not a
103
+ // call-graph proof; a create reached through a module that is not
104
+ // registered in guarded-modules.mjs is out of scope by construction
105
+ // (that list is what guarded-modules-coverage.test.mjs pins).
106
+ // - The command-literal rule lexes JavaScript with a hand-written scanner
107
+ // (scanModuleLiterals() below), so its grammar coverage has a frontier:
108
+ // comments, regex literals (including character classes), strings, and
109
+ // templates with nested `${...}` interpolations are modeled; anything
110
+ // else that can open a literal is not. That frontier is deliberately NOT
111
+ // silent -- see the DESYNC BACKSTOP note on scanModuleLiterals(): a
112
+ // construct that provably desyncs the walk is reported as a loud
113
+ // `parse-desync` violation naming the file and line, so a module this
114
+ // guard cannot read fails it instead of passing it. Measured on the tree
115
+ // as it stands: zero desyncs across the 58 scanned modules.
116
+ // - NOT a limit, contrary to an earlier note on this bead: `bd` and
117
+ // `create` split across a newline inside a template literal ARE matched,
118
+ // because both rules join them with `\s+`, which matches a newline. This
119
+ // was re-probed directly against the checker.
120
+ //
121
+ // CALL-SITE EXTRACTION REUSES dispatch-safety-guard.mjs's findCallSites()
122
+ // (that file's own header names it "the reference implementation the sibling
123
+ // guards follow"), rather than a naive per-line quote-stopping scan: a real
124
+ // `bd create "<title>" --body-file "<path>" --id <id> --silent` command
125
+ // literal has an inner quoted title BETWEEN "bd create" and the id flag, so a
126
+ // scan that stops at the first quote after "bd create" (the technique
127
+ // dolt-literal-guard.mjs/full-db-fetch-guard.mjs use, safe for THEIR simpler
128
+ // command shapes) would silently miss it. findCallSites() already extracts
129
+ // the FULL balanced call text -- including embedded quotes -- for every
130
+ // `command(`/`agent(` site, and already skips full-line comments and
131
+ // same-line-string false positives, so this guard reuses it rather than
132
+ // re-deriving that logic.
133
+ //
134
+ // THE COMMAND-LITERAL RULE, BY CONTRAST, LEXES THE RAW SOURCE ITSELF
135
+ // (scanModuleLiterals() below) instead of walking a maskComments() copy. Its
136
+ // first cut did reuse maskComments()/skipStringLiteral(), on the same "do not
137
+ // re-derive it" reasoning -- and was measured SILENTLY BLIND over 867 lines
138
+ // of the real scanned set, because three ordinary constructs open a phantom
139
+ // string in a naive quote-walk: a regex body holding an apostrophe, a regex
140
+ // character class holding a quote, and a nested template inside a `${...}`
141
+ // interpolation (that last one desyncs maskComments() ITSELF, so it cannot
142
+ // be repaired downstream of it). The full account, naming the real modules
143
+ // that trigger each, is on scanModuleLiterals(). Comment spans are still
144
+ // never entered, so the many prose mentions of `bd create` in this
145
+ // directory's comments (including this header) are still never read as
146
+ // dispatches.
147
+ //
148
+ // EXEMPTION: beads-children.mjs itself (EXPLICIT_ID_CREATE_EXEMPT), the
149
+ // single permitted surface -- scanning it would flag the module for being
150
+ // the module, same precedent as DOLT_LITERAL_EXEMPT/dolt-sync.mjs and
151
+ // UNBRACKETED_PUSH_EXEMPT/git-sync.mjs. (`agent(` call sites are still
152
+ // ignored by the call-site rule: agent() never dispatches a bd command. The
153
+ // command-literal rule has no such carve-out and does not need one.)
154
+ //
155
+ // MODULE-LIST GENERALIZATION: this guard is not pointed at a single
156
+ // hard-coded file. checkExplicitIdCreateModules() below reads the SHARED
157
+ // guarded-module list (./guarded-modules.mjs), filtered through
158
+ // EXPLICIT_ID_CREATE_EXEMPT, and defines no list of its own.
159
+ // checkExplicitIdCreatePath() remains exported and behaves exactly as
160
+ // before for a single file (a fixture, or beads-children.mjs itself when a
161
+ // caller deliberately wants its own violations, none expected).
162
+ // =============================================================================
163
+
164
+ // Matches a bead-creation subcommand ANYWHERE in the balanced call text --
165
+ // deliberately not conditioned on an explicit id flag appearing later (see
166
+ // "WIDENING 1" above): the one real call site assembles its id flag into an
167
+ // interpolated variable that never appears as literal `--id` text inside the
168
+ // command() call, so requiring a literal id flag would miss the exact shape a
169
+ // copy-paste of that site produces. Written as `bd` + `\s+` + `create`
170
+ // (never a literal space between the two tokens) so this guard's own
171
+ // definition line can never match itself.
172
+ const EXPLICIT_ID_CREATE_RE = /bd\s+create\b/;
173
+
174
+ // Matches a string/template literal's CONTENT when that content begins with
175
+ // the bead-creation command itself and continues into an argument (see
176
+ // "HOW WIDENING 2 IS DONE" above). The argument-start character class is
177
+ // written with hex escapes -- \x22 " , \x27 ' , \x60 ` -- rather than the
178
+ // characters themselves. That is belt-and-braces rather than load-bearing
179
+ // now: both this guard's own lexer and maskComments() model regex literals,
180
+ // so a bare quote inside this regex would no longer corrupt the scan of this
181
+ // very file (which IS in the guarded set). The escapes are kept because they
182
+ // cost nothing and keep the line safe for any SIMPLER scanner that does not
183
+ // model regex literals.
184
+ const CREATE_DISPATCH_LITERAL_RE = /^\s*bd\s+create\s+(\x22|\x27|\x60|\$|-|$)/;
185
+
186
+ // A raw (unescaped) newline inside a `'`/`"` literal. Such a literal is
187
+ // INVALID JavaScript -- only a template literal may span lines -- so seeing
188
+ // one means the scan's own notion of "where string literals begin and end"
189
+ // has desynced from the real source, and every line it swallowed is invisible
190
+ // to the command-literal rule below. Matched as: a newline preceded by an
191
+ // EVEN number of backslashes (zero counts), so a legitimate line
192
+ // continuation (`\` immediately before the newline) is not mistaken for one.
193
+ const RAW_NEWLINE_IN_QUOTED_LITERAL_RE = /(?:^|[^\\])(?:\\\\)*\n/;
194
+
195
+ /**
196
+ * Walks `src` once and returns BOTH of the things the command-literal rule
197
+ * needs:
198
+ * - `literals`: every string/template literal as { line, content }, in
199
+ * source order, with comment spans never entered (so prose mentions of a
200
+ * command inside a comment are never extracted);
201
+ * - `desyncs`: every position where the walk could not trust its own
202
+ * literal boundaries (see the DESYNC note in the module header).
203
+ *
204
+ * WHY THIS IS A LOCAL LEXER AND NOT maskComments() + skipStringLiteral()
205
+ * (this bead's review round). The first cut of this rule extracted literals
206
+ * by walking a maskComments() copy and calling skipStringLiteral() at every
207
+ * quote. Measured against the real scanned set, that walk was SILENTLY BLIND:
208
+ * 867 lines across 8 of the 58 scanned modules sat inside a phantom `'`/`"`
209
+ * span, and injecting a real wrapper dispatch line by line showed 1085
210
+ * injection points -- ordinary statements in function bodies, in abort.mjs,
211
+ * member-sync.mjs, branch-ensure.mjs, newtask-text.mjs, contracts.mjs and
212
+ * five more -- that this rule reported CLEAN and now reports. (The same
213
+ * desync also had a false-POSITIVE direction, prose inside a phantom span
214
+ * being read as a dispatch; that half was already closed upstream when
215
+ * maskComments() learned about regex literals, and is pinned by
216
+ * dispatch-safety-guard.test.mjs.) Three distinct constructs open a
217
+ * "phantom string" that swallows source up to the next matching quote:
218
+ * 1. a REGEX whose body holds a quote -- branch-ensure.mjs's
219
+ * `/couldn't find remote ref/i`. maskComments() copies a regex through
220
+ * VERBATIM (it is real code, not a comment), so the apostrophe inside
221
+ * it is still there for a naive quote-walk to trip over. Handled here by
222
+ * skipping regex spans with the SAME canStartRegex()/skipRegexLiteral()
223
+ * heuristic maskComments() used when it decided to copy that span.
224
+ * 2. a CHARACTER CLASS holding a quote -- newtask-text.mjs's
225
+ * SAFE_TEXT_RE -- same cause, same fix.
226
+ * 3. a NESTED TEMPLATE inside a `${...}` interpolation --
227
+ * vcs-providers/shell-helpers.mjs's
228
+ * shQuote (a `.replace()` whose arguments are themselves backtick
229
+ * literals). skipStringLiteral() has no notion of interpolation, so it
230
+ * ends the OUTER template at the INNER template's opening backtick and
231
+ * every boundary after that is off by one literal. This one desyncs
232
+ * maskComments() itself, so no amount of care in a walk built on its
233
+ * output can recover -- which is why the walk below lexes the raw source
234
+ * directly instead.
235
+ * The call-site rule is unaffected by all three: it reads
236
+ * extractBalancedCall(), which skips regex spans and only needs paren depth.
237
+ *
238
+ * DESYNC BACKSTOP. Lexing JavaScript with a hand-written scanner will always
239
+ * have a frontier. So rather than trusting this one to be complete, it
240
+ * reports the two constructs that PROVE it has lost the thread -- a
241
+ * `'`/`"` literal carrying a raw newline, and an unterminated template --
242
+ * as `desyncs`, which findExplicitIdCreateViolations() turns into a loud
243
+ * violation. A guard that cannot parse a module must say so, not report it
244
+ * clean.
245
+ */
246
+ export function scanModuleLiterals(src) {
247
+ const lineStarts = [0];
248
+ for (let i = 0; i < src.length; i++) {
249
+ if (src[i] === '\n') lineStarts.push(i + 1);
250
+ }
251
+ const lineNumberForIndex = (idx) => {
252
+ let lo = 0;
253
+ let hi = lineStarts.length - 1;
254
+ while (lo < hi) {
255
+ const mid = (lo + hi + 1) >> 1;
256
+ if (lineStarts[mid] <= idx) lo = mid;
257
+ else hi = mid - 1;
258
+ }
259
+ return lo + 1; // 1-based
260
+ };
261
+
262
+ const ctx = {
263
+ literals: [],
264
+ desyncs: [],
265
+ // Code seen so far with comments blanked, ONLY so canStartRegex()'s
266
+ // preceding-token heuristic sees the same thing it would have seen
267
+ // inside maskComments(). Never scanned for content.
268
+ code: '',
269
+ lineNumberForIndex,
270
+ };
271
+
272
+ scanCodeSpan(src, 0, null, ctx);
273
+ return { literals: ctx.literals, desyncs: ctx.desyncs };
274
+ }
275
+
276
+ /**
277
+ * Scans a CODE region of `src` starting at `start`, recording every string /
278
+ * template literal it contains (including inside nested `${...}`
279
+ * interpolations) into `ctx`. When `stopAt` is `'}'` the scan is inside a
280
+ * `${...}` interpolation and returns the index just past the `}` that closes
281
+ * it, counting nested braces on the way; when `stopAt` is null it runs to end
282
+ * of file. Returns the index it stopped at.
283
+ */
284
+ function scanCodeSpan(src, start, stopAt, ctx) {
285
+ let depth = 0;
286
+ let i = start;
287
+ while (i < src.length) {
288
+ const ch = src[i];
289
+ if (ch === '/' && src[i + 1] === '/') {
290
+ while (i < src.length && src[i] !== '\n') { ctx.code += ' '; i++; }
291
+ continue;
292
+ }
293
+ if (ch === '/' && src[i + 1] === '*') {
294
+ const close = src.indexOf('*/', i + 2);
295
+ const stop = close < 0 ? src.length : close + 2;
296
+ for (; i < stop; i++) ctx.code += src[i] === '\n' ? '\n' : ' ';
297
+ continue;
298
+ }
299
+ if (ch === '/' && canStartRegex(ctx.code, ctx.code.length)) {
300
+ const close = skipRegexLiteral(src, i);
301
+ if (close !== -1) {
302
+ let flagEnd = close;
303
+ while (flagEnd + 1 < src.length && /[a-zA-Z]/.test(src[flagEnd + 1])) flagEnd++;
304
+ ctx.code += src.slice(i, flagEnd + 1);
305
+ i = flagEnd + 1;
306
+ continue;
307
+ }
308
+ // No closing `/` before end of line: not a regex after all, so
309
+ // fall through and treat it as an ordinary character.
310
+ }
311
+ if (ch === '"' || ch === "'") {
312
+ const close = skipStringLiteral(src, i, ch);
313
+ const content = src.slice(i + 1, close);
314
+ if (RAW_NEWLINE_IN_QUOTED_LITERAL_RE.test(content)) {
315
+ // Desync: do NOT consume the span. Consuming it is what makes
316
+ // the blindness silent -- report it loudly and carry on from
317
+ // the very next character so the rest of the module is still
318
+ // examined rather than swallowed.
319
+ ctx.desyncs.push({ line: ctx.lineNumberForIndex(i), detail: `a ${ch} string literal` });
320
+ ctx.code += ' ';
321
+ i++;
322
+ continue;
323
+ }
324
+ ctx.literals.push({ line: ctx.lineNumberForIndex(i), content });
325
+ ctx.code += src.slice(i, close + 1);
326
+ i = close + 1;
327
+ continue;
328
+ }
329
+ if (ch === '`') {
330
+ i = scanTemplateLiteral(src, i, ctx);
331
+ continue;
332
+ }
333
+ if (stopAt === '}') {
334
+ if (ch === '{') depth++;
335
+ else if (ch === '}') {
336
+ if (depth === 0) { ctx.code += ch; return i + 1; }
337
+ depth--;
338
+ }
339
+ }
340
+ ctx.code += ch;
341
+ i++;
342
+ }
343
+ return i;
344
+ }
345
+
346
+ /**
347
+ * Scans the template literal opening at `start`, recording it (and anything
348
+ * nested in its `${...}` interpolations) into `ctx`. Returns the index just
349
+ * past the closing backtick. The recorded `content` is the RAW text between
350
+ * the backticks, interpolations included, which is exactly what
351
+ * CREATE_DISPATCH_LITERAL_RE wants to see: a dispatch's command text with its
352
+ * `${...}` arguments still in place.
353
+ */
354
+ function scanTemplateLiteral(src, start, ctx) {
355
+ for (let i = start + 1; i < src.length; i++) {
356
+ const ch = src[i];
357
+ if (ch === '\\') { i++; continue; }
358
+ if (ch === '`') {
359
+ ctx.literals.push({ line: ctx.lineNumberForIndex(start), content: src.slice(start + 1, i) });
360
+ // Only a marker: ctx.code exists solely so canStartRegex() can see
361
+ // what token precedes a `/`, and "a literal just ended" is all it
362
+ // needs to know here.
363
+ ctx.code += '`';
364
+ return i + 1;
365
+ }
366
+ if (ch === '$' && src[i + 1] === '{') {
367
+ // Recurse through the interpolation so a literal nested inside it
368
+ // is seen, and so the OUTER template ends at the right backtick.
369
+ // The parens bracket the interpolation in ctx.code so that a `/`
370
+ // as its first token reads as a regex start, exactly as it would
371
+ // after a real `(`.
372
+ ctx.code += '(';
373
+ i = scanCodeSpan(src, i + 2, '}', ctx) - 1;
374
+ ctx.code += ')';
375
+ }
376
+ }
377
+ // Unterminated template literal: another unambiguous desync tell, since
378
+ // the rest of the file has just been swallowed by it.
379
+ ctx.desyncs.push({ line: ctx.lineNumberForIndex(start), detail: 'a template literal' });
380
+ return src.length;
381
+ }
382
+
383
+ /**
384
+ * Convenience wrapper over scanModuleLiterals() for callers that only want
385
+ * the literals. Kept as a named export because it is this guard's most
386
+ * reusable primitive.
387
+ */
388
+ export function findCommandLiterals(src) {
389
+ return scanModuleLiterals(src).literals;
390
+ }
391
+
392
+ /**
393
+ * Scans `src` for bead-creation dispatches, as the UNION of two rules (see
394
+ * the module header):
395
+ * 1. call-site rule -- a `command(...)` call whose full balanced call text
396
+ * carries `bd create` in any shape;
397
+ * 2. command-literal rule -- any string/template literal, ANYWHERE in the
398
+ * module and regardless of the enclosing call expression, whose content
399
+ * begins with `bd create` followed by an argument.
400
+ * Returns an array of { line, rule, command }, one entry per violating line,
401
+ * sorted by line.
402
+ */
403
+ export function findExplicitIdCreateViolations(src) {
404
+ const byLine = new Map();
405
+ // Lines already accounted for by a reported call site, so the same
406
+ // dispatch is not reported twice when both rules see it. A multi-line
407
+ // `command(...)` call is claimed across its WHOLE span, not just its
408
+ // opening line: the command literal inside it sits on a later line, and
409
+ // the call-site violation already quotes that literal in full.
410
+ const claimed = new Set();
411
+ for (const site of findCallSites(src)) {
412
+ if (site.fnName !== 'command') continue;
413
+ if (!EXPLICIT_ID_CREATE_RE.test(site.callText)) continue;
414
+ const span = (site.callText.match(/\n/g) || []).length;
415
+ for (let ln = site.line; ln <= site.line + span; ln++) claimed.add(ln);
416
+ if (byLine.has(site.line)) continue;
417
+ byLine.set(site.line, {
418
+ line: site.line,
419
+ rule: 'command-call-site',
420
+ command: site.callText.replace(/\s+/g, ' ').trim(),
421
+ });
422
+ }
423
+ const { literals, desyncs } = scanModuleLiterals(src);
424
+ for (const literal of literals) {
425
+ if (!CREATE_DISPATCH_LITERAL_RE.test(literal.content)) continue;
426
+ if (claimed.has(literal.line) || byLine.has(literal.line)) continue;
427
+ byLine.set(literal.line, {
428
+ line: literal.line,
429
+ rule: 'command-literal',
430
+ command: literal.content.replace(/\s+/g, ' ').trim(),
431
+ });
432
+ }
433
+ // Reported LAST and never deduplicated away: a desync is not a dispatch,
434
+ // it is this scan admitting it could not read the module. Silently
435
+ // returning "clean" for such a module is the exact failure mode this
436
+ // guard exists to prevent.
437
+ for (const desync of desyncs) {
438
+ if (byLine.has(desync.line)) continue;
439
+ byLine.set(desync.line, {
440
+ line: desync.line,
441
+ rule: 'parse-desync',
442
+ command: desync.detail,
443
+ });
444
+ }
445
+ return [...byLine.values()].sort((a, b) => a.line - b.line);
446
+ }
447
+
448
+ /**
449
+ * Reads and scans the source file at `filePath`, returning { violations },
450
+ * each entry a human-readable message naming the offending file:line and
451
+ * pointing at the single permitted surface.
452
+ */
453
+ export function checkExplicitIdCreatePath(filePath) {
454
+ const src = fs.readFileSync(filePath, 'utf8');
455
+ const fileLabel = path.basename(filePath);
456
+ const violations = findExplicitIdCreateViolations(src).map(({ line, rule, command }) =>
457
+ rule === 'parse-desync'
458
+ ? `${fileLabel}:${line} could not be scanned reliably: ${command} opens here and is never closed ` +
459
+ 'where the JavaScript grammar requires, which means this scan\'s literal boundaries have desynced ' +
460
+ 'from the real source and an unguarded bead-creation command could be hiding in the span it would ' +
461
+ 'otherwise have swallowed. This guard refuses to report a module it cannot parse as clean -- fix the ' +
462
+ 'construct that confuses the scan (see this module\'s DESYNC note), do not suppress this message.'
463
+ : `${fileLabel}:${line} issues a bead-creation command ("${command}", matched by the ${rule} rule) ` +
464
+ 'outside the single guarded probe-and-refuse seam -- route it through beads-children.mjs\'s ' +
465
+ 'assertChildIdFree() / createChildBeadWithAllocatedId, the only permitted bead-creation surface. ' +
466
+ 'Flagged regardless of whether an id flag is literal, interpolated, or absent, and regardless of ' +
467
+ 'the wrapper it is dispatched through (see this module\'s header).'
468
+ );
469
+ return { violations };
470
+ }
471
+
472
+ /**
473
+ * Aggregate entry point: scans every module in the SHARED guarded-module list
474
+ * (./guarded-modules.mjs), MINUS EXPLICIT_ID_CREATE_EXEMPT, and returns the
475
+ * union of their violations. Follows checkDoltLiteralModules()/
476
+ * checkUnbracketedPushModules() -- the reference implementations for a
477
+ * single-permitted-surface exemption -- so a create call that moves out of
478
+ * beads-children.mjs into a newly extracted module stays covered instead of
479
+ * silently falling out of scan scope.
480
+ *
481
+ * @param {string[]} [paths]
482
+ * @returns {{ violations: string[], files: string[], skipped: string[] }}
483
+ */
484
+ export function checkExplicitIdCreateModules(paths = explicitIdCreateModulePaths()) {
485
+ if (!Array.isArray(paths)) {
486
+ throw new TypeError('checkExplicitIdCreateModules(paths): paths must be an array of file paths');
487
+ }
488
+ const violations = [];
489
+ const files = [];
490
+ const skipped = [];
491
+ for (const p of paths) {
492
+ const file = path.basename(p);
493
+ if (EXPLICIT_ID_CREATE_EXEMPT.includes(file)) {
494
+ skipped.push(file);
495
+ continue;
496
+ }
497
+ files.push(file);
498
+ violations.push(...checkExplicitIdCreatePath(p).violations);
499
+ }
500
+ return { violations, files, skipped };
501
+ }
@@ -0,0 +1,134 @@
1
+ // Fatal-diagnostics guard and the terminal-state Dolt-conflict classification
2
+ // helpers, extracted out of runner.js (apra-fleet-3swo.6.16); runner.js
3
+ // re-exports every symbol it previously exported from this region, so
4
+ // existing importers of fleet-sprint/runner.js resolve unchanged.
5
+ import { DoltDivergedError } from './errors.mjs';
6
+
7
+ // ---------------------------------------------------------------------------
8
+ // Fatal-diagnostics guard
9
+ // ---------------------------------------------------------------------------
10
+ //
11
+ // main()'s try/catch around runSprintCycle() only ever sees errors that
12
+ // propagate up an AWAITED call chain: it can never see a promise that rejects
13
+ // with nothing awaiting it, or a synchronous throw that escapes every awaited
14
+ // frame. Without this guard such a failure ends the run with no usable signal.
15
+ // The guard makes it observable: an explicit [FATAL] line (cause + the last
16
+ // phase this run entered) through the run's own log(), plus a best-effort
17
+ // publishState('terminal', ...) so a watchdog, dashboard, or human sees a real
18
+ // lastError instead of state frozen mid-run with no explanation.
19
+ //
20
+ // It deliberately does not attempt to recover or continue -- by the time either
21
+ // process-level event fires the process's control flow is in an unspecified
22
+ // state.
23
+ /**
24
+ * @param {{ log?: (msg: string) => void, publishState?: (namespace: string, data: any) => void, phaseOf?: () => string|null }} deps
25
+ * @returns {() => void} uninstall() -- removes both listeners.
26
+ */
27
+ export function installFatalDiagnosticsGuard(deps = {}) {
28
+ const log = typeof deps.log === 'function' ? deps.log : () => {};
29
+ const publishState = typeof deps.publishState === 'function' ? deps.publishState : null;
30
+ const phaseOf = typeof deps.phaseOf === 'function' ? deps.phaseOf : () => null;
31
+
32
+ const handle = (kind) => (err) => {
33
+ const message = (err && err.message) || String(err);
34
+ const stack = (err && err.stack) || null;
35
+ const phase = phaseOf();
36
+ log(`[FATAL] ${kind} (last known phase: ${phase ?? 'unknown'}): ${message}${stack ? `\n${stack}` : ''}`);
37
+ if (publishState) {
38
+ try {
39
+ publishState('terminal', {
40
+ verdict: 'ABORTED',
41
+ failed: true,
42
+ terminalReason: kind,
43
+ lastError: { message, stack, phase, kind, at: new Date().toISOString() },
44
+ });
45
+ } catch (publishErr) {
46
+ // Diagnostics reporting itself must never crash harder than the
47
+ // failure it is trying to record -- log and move on.
48
+ log(`[FATAL] ${kind}: failed to persist terminal error state: ${(publishErr && publishErr.message) || publishErr}`);
49
+ }
50
+ }
51
+ };
52
+
53
+ const onUnhandledRejection = handle('unhandledRejection');
54
+ const onUncaughtException = handle('uncaughtException');
55
+ process.on('unhandledRejection', onUnhandledRejection);
56
+ process.on('uncaughtException', onUncaughtException);
57
+
58
+ return function uninstall() {
59
+ process.off('unhandledRejection', onUnhandledRejection);
60
+ process.off('uncaughtException', onUncaughtException);
61
+ };
62
+ }
63
+
64
+ // ---------------------------------------------------------------------------
65
+ // Classify an unmergeable Dolt conflict as its own terminal state
66
+ // (BEADS_SYNC_CONFLICT), not the generic wrapper/UNKNOWN bucket -- and
67
+ // best-effort carry forward the raw conflict diagnostics an operator would
68
+ // otherwise have to re-derive by hand.
69
+ // ---------------------------------------------------------------------------
70
+
71
+ /**
72
+ * Walks a thrown error's `.cause` chain (bounded, so a pathological circular
73
+ * cause can never loop forever) looking for a DoltDivergedError -- either
74
+ * the error itself, or wrapped one level down inside a PostDispatchSyncError
75
+ * (withGitSync's post-dispatch D-push bracket wraps a diverged sync failure
76
+ * this way; see PostDispatchSyncError's own doc comment in errors.mjs). A
77
+ * plain `bd dolt pull` divergence (preflightBeadsHealthGate / doltPullBefore,
78
+ * before any dispatch ever ran) throws DoltDivergedError directly, with no
79
+ * wrapper -- also matched here.
80
+ * @param {unknown} err
81
+ * @returns {import('./errors.mjs').DoltDivergedError|null}
82
+ */
83
+ export function findDoltDivergedCause(err) {
84
+ let cur = err;
85
+ for (let depth = 0; cur && depth < 5; depth += 1) {
86
+ if (cur instanceof DoltDivergedError) return cur;
87
+ cur = cur.cause;
88
+ }
89
+ return null;
90
+ }
91
+
92
+ /**
93
+ * The terminal-state `terminalReason` main()'s typed-abort catch persists. A
94
+ * genuinely unmergeable Dolt conflict -- surfaced either directly (a
95
+ * pre-dispatch `bd dolt pull` divergence) or wrapped inside a
96
+ * PostDispatchSyncError (a D-push divergence discovered AFTER a dispatch
97
+ * already completed) -- is reported as the distinct 'BEADS_SYNC_CONFLICT', so
98
+ * the supervisor/dashboard shows "beads sync conflict, needs operator
99
+ * resolution" instead of collapsing it into the same generic bucket as every
100
+ * other termination reason. Every other error keeps the
101
+ * `err.code || err.name || 'UNKNOWN_ABORT'` behavior.
102
+ * @param {unknown} err
103
+ * @returns {string}
104
+ */
105
+ export function resolveTerminalReason(err) {
106
+ if (findDoltDivergedCause(err)) return 'BEADS_SYNC_CONFLICT';
107
+ return (err && (err.code || err.name)) || 'UNKNOWN_ABORT';
108
+ }
109
+
110
+ /**
111
+ * Best-effort diagnostics for a BEADS_SYNC_CONFLICT terminal state -- the raw
112
+ * `bd dolt pull`/`bd dolt push` stderr
113
+ * (DoltDivergedError.doltOutput) that proved the divergence, captured at the
114
+ * moment `runDoltStep()` observed the failure (i.e. BEFORE any later `bd`
115
+ * invocation's own safe-abort/cleanup could discard whatever state it was
116
+ * describing) and carried on the error object ever since. This is pure
117
+ * plumbing of already-captured data through to the terminal state -- no new
118
+ * `bd`/SQL command is issued here -- so a human resolving the conflict later
119
+ * starts with the actual rejection text in hand instead of having to
120
+ * reproduce it by re-running `bd dolt pull`/`dolt merge --no-commit`
121
+ * themselves. Returns `null` (never throws) when `err` carries no
122
+ * DoltDivergedError cause.
123
+ * @param {unknown} err
124
+ * @returns {{ member: string|null, operation: string|null, doltOutput: string|null }|null}
125
+ */
126
+ export function captureDoltConflictDump(err) {
127
+ const diverged = findDoltDivergedCause(err);
128
+ if (!diverged) return null;
129
+ return {
130
+ member: diverged.member ?? null,
131
+ operation: diverged.operation ?? null,
132
+ doltOutput: diverged.doltOutput ?? null,
133
+ };
134
+ }