@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,613 @@
1
+ import path from 'path';
2
+ import { fileURLToPath } from 'url';
3
+
4
+ // =============================================================================
5
+ // SHARED GUARDED-MODULE LIST -- the single place a newly extracted fleet-sprint
6
+ // module is registered for mechanical guard coverage.
7
+ //
8
+ // WHY THIS EXISTS: every mechanical guard in this directory
9
+ // (dispatch-safety-guard.mjs, dolt-literal-guard.mjs, full-db-fetch-guard.mjs,
10
+ // shell-command-guard.mjs, unbracketed-push-guard.mjs) was originally pointed
11
+ // at ONE hard-coded file -- runner.js -- by each of its own tests. runner.js
12
+ // is being decomposed into smaller modules; under the old wiring, the moment
13
+ // a guarded construct moved out of runner.js into a newly extracted module,
14
+ // EVERY guard silently stopped covering it while continuing to report a green
15
+ // baseline. That is the exact failure mode this list prevents: extract a
16
+ // module, add ONE line here, and all five guards pick it up at once.
17
+ //
18
+ // REGISTERING A NEWLY EXTRACTED MODULE: add its filename to GUARDED_MODULES
19
+ // below. Do not add a second list anywhere else, and do not re-point an
20
+ // individual guard at its own private array of paths -- a guard that does not
21
+ // consume this list is a guard whose coverage silently rots.
22
+ //
23
+ // STANDING RULE (from apra-fleet-3swo.8): registering a newly extracted module
24
+ // is part of the extraction bead itself, not a follow-up bead. guarded-modules.mjs
25
+ // and the guard test files that consume it (dispatch-safety-guard.test.mjs,
26
+ // dolt-literal-guard.test.mjs, full-db-fetch-tripwire.test.mjs,
27
+ // guarded-modules-coverage.test.mjs, pause-guard-push-holes.test.mjs) are a
28
+ // single mutex resource; any future bead that adds a line here MUST belong to
29
+ // the same streak as, or run after, whatever else is editing them.
30
+ //
31
+ // NESTED ENTRIES ARE LEGAL (first used by apra-fleet-3swo.6.2's phases/*
32
+ // modules): guardedModulePath() path.joins a 'dir/file.mjs' entry, so it
33
+ // resolves and scans exactly like a flat one. What differs is REPORTING --
34
+ // every guard labels a scanned file by path.basename() -- so a baseline that
35
+ // compares a guard's `files` output must use guardedModuleBasenames(), never
36
+ // GUARDED_MODULES verbatim. Note the COMPLETENESS check in
37
+ // guarded-modules-coverage.test.mjs deliberately compares FULL RELATIVE PATHS
38
+ // instead, so a nested module can never ride on an unrelated entry that
39
+ // merely shares its bare filename.
40
+ //
41
+ // WHAT DOES *NOT* BELONG HERE: the per-shell command builders --
42
+ // se-posix.mjs, se-windows.mjs, se-windows-gitbash.mjs, se-os-commands.mjs and
43
+ // dolt-settle.mjs. They deliberately emit `$HOME`, `$env:USERPROFILE`,
44
+ // `$env:TEMP` and `$( )` because they ARE the OS-branched command surface the
45
+ // shell-command invariant tells everyone else to route through; scanning them
46
+ // would report their entire reason for existing as violations. Likewise
47
+ // dolt-sync.mjs, which legitimately builds the `bd dolt pull`/`bd dolt push`
48
+ // command strings (see DOLT_LITERAL_EXEMPT below and dolt-literal-guard.mjs's
49
+ // own header).
50
+ // =============================================================================
51
+
52
+ const __dirname = path.dirname(fileURLToPath(import.meta.url));
53
+
54
+ /**
55
+ * Filenames (relative to this directory) of every fleet-sprint module the
56
+ * mechanical guards must scan. Add a newly extracted module here -- this is
57
+ * the single registration point.
58
+ */
59
+ export const GUARDED_MODULES = [
60
+ 'runner.js',
61
+ 'vcs-auth.mjs',
62
+ 'mcp-result.mjs',
63
+ 'member-target.mjs',
64
+ 'member-call.mjs',
65
+ 'abort.mjs',
66
+ 'branch-ensure.mjs',
67
+ 'prompts.mjs',
68
+ 'worklists.mjs',
69
+ 'sprint-args.mjs',
70
+ 'backlog-role.mjs',
71
+ 'git-sync.mjs',
72
+ 'coordination.mjs',
73
+ 'kb.mjs',
74
+ // Per-repository kb_maintainer selection. Issues no fleet call itself
75
+ // (every member access is injected by runner.js), registered so a future
76
+ // direct call added here is scanned from the start.
77
+ 'kb-maintainer.mjs',
78
+ // KB hint building and KNOWLEDGE BANK injection gating: pure / injected
79
+ // (the diff-file listing is a runner.js-supplied callback), no direct command().
80
+ 'kb-hints.mjs',
81
+ 'kb-injection.mjs',
82
+ // Pure lower-quality banner derivation; no command() site.
83
+ 'lower-quality.mjs',
84
+ 'beads-scope.mjs',
85
+ 'beads-transitions.mjs',
86
+ 'role-policies.mjs',
87
+ 'inline-ladder-guard.mjs',
88
+ // apra-fleet-3swo.5.3: the dispatchRole engine. It hosts the ONE real
89
+ // agent() dispatch every migrated role ladder now runs through, so it
90
+ // must be scanned by dispatch-safety-guard (member_name at the call
91
+ // site) exactly like the runner.js ladders it replaces.
92
+ 'dispatch-role.mjs',
93
+ // apra-fleet-3swo.6.1: the per-sprint resolved state (the sprint-scoped
94
+ // fleet client every settle-shell resolution shares, plus the relocated
95
+ // per-member VCS provider resolver). It builds no member-bound command
96
+ // string today, but it is the module every future phase module asks for
97
+ // the member's resolved shell -- exactly the input the shell-command
98
+ // invariant is about -- so it is registered from the start rather than
99
+ // retrofitted later.
100
+ 'sprint-state.mjs',
101
+ // apra-fleet-3swo.6.2: the first two phase modules sliced out of
102
+ // runSprintCycle. These are the first NESTED entries in this list --
103
+ // guardedModulePath() path.joins them, so they resolve and scan
104
+ // correctly, but every guard labels a scanned file by path.basename(),
105
+ // so they are always REPORTED as 'ensure-sprint-branch.mjs' and
106
+ // 'plan.mjs'. Any baseline assertion must therefore compare against
107
+ // guardedModuleBasenames() rather than GUARDED_MODULES verbatim (see
108
+ // that function's doc comment below).
109
+ //
110
+ // ensure-sprint-branch.mjs took EIGHT member_name-bearing command() call
111
+ // sites out of runner.js (now TEN -- see the POST-EXTRACTION FIX note in
112
+ // that file's header for the two diagnostic-only tip-SHA probes added by
113
+ // apra-fleet-3swo's fleet-mac regression investigation) and plan.mjs took
114
+ // THREE, which is exactly why both are registered as part of the
115
+ // extraction rather than afterwards: guarded dispatch sites would
116
+ // otherwise leave runner.js's scanned surface and land in files no guard
117
+ // reads, with every guard still green.
118
+ 'phases/ensure-sprint-branch.mjs',
119
+ 'phases/plan.mjs',
120
+ // apra-fleet-3swo.6.7: the next two phase modules sliced out of
121
+ // runSprintCycle, both from INSIDE its Develop/Review round loop. Same
122
+ // nested-entry reporting caveat as the pair above (they are always
123
+ // REPORTED as 'replan.mjs' and 'develop.mjs'), so the same rule applies:
124
+ // compare a guard's `files` output against guardedModuleBasenames().
125
+ //
126
+ // Neither took a command() call site out of runner.js -- replan.mjs's only
127
+ // repo-side effect is a shared gitSync bracket, and develop.mjs reaches bd
128
+ // exclusively through runner-exported helpers it is handed -- but each
129
+ // took TWO dispatchRole() call sites (the scoped planner + scoped
130
+ // plan-reviewer, and the streak-assignment + doer ladders). Those are
131
+ // exactly what dispatch-safety-guard and the phase 3 dispatch census read,
132
+ // so registering them as part of the extraction is what keeps the census
133
+ // whole instead of quietly shrinking runner.js's scanned surface.
134
+ 'phases/replan.mjs',
135
+ 'phases/develop.mjs',
136
+ // apra-fleet-3swo.6.5: the per-round Review and the per-cycle Deploy
137
+ // phases. Same nested-entry reporting caveat as the four above (they are
138
+ // always REPORTED as 'review.mjs' and 'deploy.mjs'), so the same rule
139
+ // applies: compare a guard's `files` output against
140
+ // guardedModuleBasenames().
141
+ //
142
+ // review.mjs took ONE member_name-bearing command() call site out of
143
+ // runner.js (the `bd show <ids> --json` acceptance-criteria read) and NO
144
+ // dispatchRole site -- the reviewer ladder runs through runner.js's
145
+ // dispatchReview() helper, which the Review and Re-Review phases share
146
+ // (runner.js:2494 and :2762; Final Review does not receive it -- see the
147
+ // apra-fleet-3swo.65 correction below), so it stayed there. deploy.mjs
148
+ // took no command() site but ONE
149
+ // dispatchRole site (the deployer ladder). Registering both as part of the
150
+ // extraction is what keeps the guarded command census and the phase 3
151
+ // dispatch census whole instead of quietly shrinking runner.js's scanned
152
+ // surface.
153
+ 'phases/review.mjs',
154
+ 'phases/deploy.mjs',
155
+ // apra-fleet-3swo.6.8: the per-cycle Integ Test and the Re-Review that
156
+ // Cycle Evaluation dispatches when the goal-priority count reads 0 but no
157
+ // review ran this cycle. Same nested-entry reporting caveat as the six
158
+ // above (they are always REPORTED as 'integ-test.mjs' and
159
+ // 're-review.mjs'), so the same rule applies: compare a guard's `files`
160
+ // output against guardedModuleBasenames().
161
+ //
162
+ // integ-test.mjs took TWO member_name-bearing command() call sites out of
163
+ // runner.js -- the verify-fail bounce cap's `bd show <bugId> --json` parent
164
+ // lookup and its `bd update <parentId> --status=deferred --append-notes`
165
+ // deferral -- plus ONE dispatchRole site (the integ-test-runner ladder).
166
+ // re-review.mjs took NEITHER: its reopen/newTask writes go through
167
+ // applyGuardedReopens (beads-transitions.mjs) and
168
+ // createChildBeadWithAllocatedId/computeChildFloor, whose command() sites
169
+ // live in the modules that own them, and the reviewer ladder runs through
170
+ // runner.js's shared dispatchReview() helper, which the Review phase
171
+ // (runner.js:2494) also calls -- NOT Final Review, which passes no
172
+ // dispatchReview at all (runner.js:2834; see apra-fleet-3swo.65). A grep
173
+ // for `dispatchReview` across phases/ overcounts: the identifier also
174
+ // appears inside a shared boilerplate comment ("No duplicate log() dump
175
+ // -- see dispatchReview() for why") that SEVEN files carry verbatim --
176
+ // phases/harvest.mjs, phases/plan.mjs, phases/develop.mjs,
177
+ // phases/integ-test.mjs, phases/final-review.mjs, phases/deploy.mjs and
178
+ // phases/regression-test.mjs -- none of which actually receive the
179
+ // helper. Registering both as part of the extraction is what keeps the
180
+ // guarded command census and the phase 3 dispatch census whole instead of
181
+ // quietly shrinking runner.js's scanned surface.
182
+ 'phases/integ-test.mjs',
183
+ 'phases/re-review.mjs',
184
+ // apra-fleet-3swo.6.6: the sprint's closing Final Review and the
185
+ // once-per-sprint Regression Test. Same nested-entry reporting caveat as
186
+ // the eight above (they are always REPORTED as 'final-review.mjs' and
187
+ // 'regression-test.mjs'), so the same rule applies: compare a guard's
188
+ // `files` output against guardedModuleBasenames().
189
+ //
190
+ // NEITHER took a member_name-bearing command() call site out of runner.js
191
+ // -- final-review.mjs reads beads through the injected bdListScoped and
192
+ // writes them through applyGuardedReopens (beads-transitions.mjs) and
193
+ // computeChildFloor/createChildBeadWithAllocatedId, whose command() sites
194
+ // live in the modules that own them, and regression-test.mjs issues no
195
+ // bd/git command at all (its carry-over beads are filed by the DISPATCHED
196
+ // runner inside its own repo). Each took exactly ONE dispatchRole() site
197
+ // (the final-review and regression-test-runner ladders), which is what
198
+ // dispatch-safety-guard and the phase 3 dispatch census read.
199
+ // final-review.mjs additionally owns a real gitSync bracket at each end,
200
+ // including the findings D-push that apra-fleet-3swo.4.1 brought inside a
201
+ // bracket -- registering it here is what keeps unbracketed-push-guard
202
+ // covering that push instead of silently losing it.
203
+ 'phases/final-review.mjs',
204
+ 'phases/regression-test.mjs',
205
+ // apra-fleet-3swo.6.9: the LAST two phase modules -- Harvest and Publish
206
+ // PR -- which complete the runSprintCycle slice. Same nested-entry
207
+ // reporting caveat as the ten above (they are always REPORTED as
208
+ // 'harvest.mjs' and 'publish-pr.mjs'), so the same rule applies: compare a
209
+ // guard's `files` output against guardedModuleBasenames().
210
+ //
211
+ // harvest.mjs took NO member_name-bearing command() call site out of
212
+ // runner.js -- the docs/sprint-analysis commits are made by the
213
+ // DISPATCHED harvester inside its own repo and published by the 'harvester'
214
+ // policy row's pushCode/pushBeads bracket -- but it took ONE dispatchRole()
215
+ // site (the harvester ladder), which is what dispatch-safety-guard and the
216
+ // phase 3 dispatch census read.
217
+ //
218
+ // publish-pr.mjs is the opposite shape and the more urgent of the two to
219
+ // register: it took TWO member_name-bearing command() call sites out of
220
+ // runner.js (the `git remote get-url origin` capability probe on the
221
+ // git-capable publish member, and the per-target-issue `bd close` on the
222
+ // orchestrator for a remote that can never open a PR) and NO dispatchRole
223
+ // site, AND it owns the sprint branch's own push --
224
+ // gitSync.pushGitAfter(), the bracketed entry point apra-fleet-3swo.4.1
225
+ // put that push behind. Registering it here is what keeps
226
+ // unbracketed-push-guard covering that push instead of silently losing the
227
+ // one site the guard exists for.
228
+ 'phases/harvest.mjs',
229
+ 'phases/publish-pr.mjs',
230
+ // apra-fleet-3swo.6.3: the git-topology layer sliced out of runner.js --
231
+ // the pre-sprint multi-member topology precondition (checkMemberTopology),
232
+ // the ONE git-failure classifier (classifyGitFailure) and the fail-closed
233
+ // provider lookup that feeds it, the retrying git-command primitive every
234
+ // sync bracket issues its commands through (runGitStep), and the
235
+ // exit-code-based soft-git result adapter (commandResultToSoftGit).
236
+ //
237
+ // It took exactly ONE member_name-bearing command() call site out of
238
+ // runner.js -- runGitStep's single `command(cmd, { member_name: member,
239
+ // silent: true, failSoft: true, label })` dispatch, which EVERY bracketed
240
+ // git command in this package funnels through (syncMemberBefore/After/
241
+ // AfterOrdered here, detectAndAbortRebaseConflict in conflict-ladder.mjs,
242
+ // and abort.mjs's three finalize-path git calls). That makes it the single
243
+ // highest-traffic guarded dispatch site in fleet-sprint, so registering it
244
+ // with the extraction is what keeps dispatch-safety-guard covering it
245
+ // instead of silently losing it the moment it left runner.js.
246
+ 'git-topology.mjs',
247
+ // apra-fleet-rsd9.1.1: launch-time member alignment (alignMembersToBase,
248
+ // prepareLaunchTopology). It issues every git command through an injected
249
+ // per-member runGit(cmd, member) -- fetches go through git-topology.mjs's
250
+ // runGitStep -- so it adds no command() call site of its own, but it
251
+ // builds member-bound command strings, which is exactly what the
252
+ // shell-command and dolt-literal guards must keep scanning.
253
+ 'member-align.mjs',
254
+ // apra-fleet-3swo.6.10: the per-member git sync BRACKETS that sit on top of
255
+ // git-topology.mjs -- syncMemberBefore (G-pull), syncMemberAfter (G-push
256
+ // plus its bounded pull-rebase retry and Tier 2 conflict dispatch),
257
+ // syncMemberAfterOrdered (the ordered G-push-then-D-push post-dispatch
258
+ // step) and resyncReacquiredMember (the resume path's re-reconciliation).
259
+ //
260
+ // It took exactly ONE member_name-bearing command() call site out of
261
+ // runner.js -- syncMemberAfter's `command('git status --porcelain', {
262
+ // member_name: member, ... })` clean-state read, the mechanical re-check
263
+ // that decides whether a Tier 2 conflict-resolution dispatch really
264
+ // resolved anything. The other three brackets issue every git command
265
+ // through git-topology.mjs's runGitStep, and resyncReacquiredMember runs
266
+ // entirely on injected runners, so none of them adds a site here.
267
+ //
268
+ // Registering it with the extraction is load-bearing TWICE over, and the
269
+ // second reason is the subtle one: unbracketed-push-guard.mjs resolves its
270
+ // sanctioned-wrapper ranges (syncMemberAfterOrdered, verifyDoerStreakClosed)
271
+ // BY NAME WITHIN EACH SCANNED FILE. syncMemberAfterOrdered's bare
272
+ // syncMemberAfter() and DoltSync.syncAfter() calls are sanctioned only
273
+ // because the wrapper declaring them travelled here with them -- so this
274
+ // file must be scanned for that sanction to mean anything, and a future
275
+ // bare primitive added here outside that wrapper must still go red.
276
+ 'member-sync.mjs',
277
+ // apra-fleet-3swo.6.12: the member-provisioning helpers sliced out of
278
+ // runner.js -- createMemberSessionGuard (the pre-resume stop_prompt
279
+ // guard), createUnattendedAutoProvisioner, createDeployPermissionsProvisioner
280
+ // and stageCommandBodyMemberSide.
281
+ //
282
+ // It took exactly TWO member_name-bearing command() call sites out of
283
+ // runner.js: createDeployPermissionsProvisioner's `node -e ...` read of
284
+ // deploy.md's Permissions section, and stageCommandBodyMemberSide's
285
+ // `node -e ...` member-side temp-file write. Both are shell-agnostic
286
+ // (base64-encoded argv, no `$`-expansion/backticks/template literals),
287
+ // which is exactly the invariant shell-command-guard.mjs enforces here.
288
+ // A THIRD site was added since: createPermissionConfigPreflight's
289
+ // per-OS/shell file-exists probe (SeOsCommands.fileExistsProbe, a
290
+ // validated literal path, no member environment reads).
291
+ // resolveSettleShell stayed in runner.js (module-private composition-root
292
+ // wiring anchored there by test/sprint-state.test.mjs) and is not part of
293
+ // this module's surface.
294
+ 'member-provisioning.mjs',
295
+ // apra-fleet-3swo.6.13: the child-bead allocation and batched-claim
296
+ // command surface sliced out of runner.js -- computeChildFloor,
297
+ // createChildBeadWithAllocatedId, verifyDoerStreakClosed and
298
+ // claimBeadsBatched.
299
+ //
300
+ // It took exactly FIVE member_name-bearing command() call sites out of
301
+ // runner.js: computeChildFloor's `bd list --parent` read, createChild-
302
+ // BeadWithAllocatedId's TWO sites (`bd create --body-file` and the
303
+ // explicit-id path's `bd update --parent` link), verifyDoerStreakClosed's
304
+ // `bd show <ids> --json` post-D-pull read, and claimBeadsBatched's `bd
305
+ // update ... --claim --json` batch. Registering it with the extraction is
306
+ // load-bearing TWICE over, same as git-topology.mjs/member-sync.mjs
307
+ // above: verifyDoerStreakClosed is also one of unbracketed-push-guard.mjs's
308
+ // two SANCTIONED_WRAPPER_FUNCTIONS (its DoltSync.syncBefore() call is only
309
+ // sanctioned because that function's OWN declaration -- and therefore its
310
+ // body range -- is found by scanning this file), so this module must be
311
+ // scanned for that sanction to mean anything.
312
+ 'beads-children.mjs',
313
+ // apra-fleet-3swo.6.14: the PR-body/cost-report text surface
314
+ // (sprint-report.mjs: sanitizePrText, buildAnalysisText, buildCostAnalysis,
315
+ // computeBranchSlug) and the verdict/newTask text surface
316
+ // (newtask-text.mjs: extractContestedBeadIds, SAFE_TEXT_RE,
317
+ // normalizeTierToken, trackRejectedNewTaskForResurfacing,
318
+ // clearResubmittedNewTask, reconcilePendingRejectedNewTasks,
319
+ // buildRejectedNewTaskResurfaceLines), both sliced out of runner.js.
320
+ //
321
+ // Neither took a member_name-bearing command() or agent() call site out of
322
+ // runner.js -- every one of these eleven symbols is pure text
323
+ // formatting/validation with no bd/git/dispatch surface of its own -- so
324
+ // both get a ZERO baseline in dispatch-safety-guard.test.mjs. The zero is
325
+ // not a formality: it is what turns a future raw command()/agent() landing
326
+ // in either file into a red test instead of a silently unguarded site.
327
+ 'sprint-report.mjs',
328
+ // The sprint PR title/body builder (markdown, run-history block) shared by
329
+ // the Publish PR phase and the [ABORTED] PR path. Pure text: no command(),
330
+ // no agent(), no push -- registered so a future dispatch landing here is
331
+ // caught rather than silently unguarded.
332
+ 'pr-body.mjs',
333
+ 'newtask-text.mjs',
334
+ // apra-fleet-fsxg: the parent-NOTES staleness signal. Its pure core is text
335
+ // formatting, but collectParentNotesStalenessNotes carries TWO member_name-
336
+ // bearing command() call sites (`bd list --parent <id> --json` and `bd
337
+ // history <id> --json`), so it must be scanned by dispatch-safety-guard
338
+ // exactly like any other guarded command surface -- see its own explicit
339
+ // baseline (EXPECTED_PARENT_NOTES_STALENESS_COMMAND_COUNT) in
340
+ // dispatch-safety-guard.test.mjs.
341
+ 'parent-notes-staleness.mjs',
342
+ // apra-fleet-3swo.6.15: the round-resume session registry
343
+ // (round-session.mjs: DEFAULT_CONTEXT_CEILING, createRoundSessionRegistry)
344
+ // and the dispatch-outcome classification surface (dispatch-failure.mjs:
345
+ // isTerminalSprintFailure, isNoMutationDispatchFailure,
346
+ // withDispatchWatchdog), both sliced out of runner.js.
347
+ //
348
+ // Neither took a member_name-bearing command() or agent() call site out of
349
+ // runner.js -- round-session.mjs is a pure in-memory session map with no
350
+ // bd/git/dispatch surface, and dispatch-failure.mjs only CLASSIFIES an
351
+ // already-thrown error or races an already-in-flight dispatch PROMISE
352
+ // (dispatch-role.mjs owns the one real agent() call site that promise
353
+ // comes from) -- so both get a ZERO baseline in
354
+ // dispatch-safety-guard.test.mjs. The zero is not a formality: it is what
355
+ // turns a future raw command()/agent() landing in either file into a red
356
+ // test instead of a silently unguarded site.
357
+ 'round-session.mjs',
358
+ 'dispatch-failure.mjs',
359
+ // apra-fleet-3swo.6.16: the fatal-diagnostics guard
360
+ // (installFatalDiagnosticsGuard) and the terminal-state Dolt-conflict
361
+ // classification helpers (findDoltDivergedCause, resolveTerminalReason,
362
+ // captureDoltConflictDump), sliced out of runner.js.
363
+ //
364
+ // None of the four owns a member_name-bearing command() or dispatchRole()
365
+ // call site out of runner.js -- installFatalDiagnosticsGuard only wires
366
+ // process-level event listeners, and the other three purely classify an
367
+ // already-thrown error's `.cause` chain -- so this module gets a ZERO
368
+ // baseline in dispatch-safety-guard.test.mjs, same as sprint-report.mjs/
369
+ // newtask-text.mjs/round-session.mjs/dispatch-failure.mjs above. The zero
370
+ // is not a formality: it is what turns a future raw command()/agent()
371
+ // landing in this file into a red test instead of a silently unguarded
372
+ // site.
373
+ 'fatal-diagnostics.mjs',
374
+ // apra-fleet-3swo.25: the remaining fleet-sprint modules that scan clean
375
+ // (zero violations) across all five guards. Registered together so the
376
+ // completeness test (guarded-modules-coverage.test.mjs) has nothing left
377
+ // unaccounted for besides GUARD_REGISTRATION_EXEMPT below.
378
+ 'conflict-ladder.mjs',
379
+ 'contracts.mjs',
380
+ 'dispatch-safety-guard.mjs',
381
+ 'errors.mjs',
382
+ 'full-db-fetch-guard.mjs',
383
+ 'shell-command-guard.mjs',
384
+ 'sprint-lock.mjs',
385
+ 'sprint-progress.mjs',
386
+ // apra-fleet-hzeb.4.2: the usage-limit pause/resume/re-probe controller.
387
+ // It carries ONE real agent() re-probe dispatch, which names its member
388
+ // explicitly, so it scans clean under dispatch-safety-guard and is
389
+ // registered here (not exempted) to keep that live dispatch site guarded.
390
+ 'usage-limit-controller.mjs',
391
+ 'unbracketed-push-guard.mjs',
392
+ // apra-fleet-btj9.7: the explicit-id-create guard checker. Registered
393
+ // normally (not exempted) like unbracketed-push-guard.mjs above -- it
394
+ // issues no command()/agent() call of its own (its 'bd create' mentions
395
+ // are all prose inside comments/messages, never a dispatched call), so it
396
+ // scans clean under itself and every other guard rather than needing a
397
+ // GUARD_REGISTRATION_EXEMPT carve-out.
398
+ 'explicit-id-create-guard.mjs',
399
+ // The beads identity contract (pure parse/compare helpers, no command()
400
+ // or agent() site -- zero baseline) and the precondition that runs its
401
+ // three read-only probes: beads-identity-check.mjs carries TWO
402
+ // member_name-bearing command() call sites (the probe loop and the
403
+ // member beads set-up runner; its beads pull goes through DoltSync),
404
+ // which is exactly what dispatch-safety-guard must keep scanning.
405
+ 'beads-identity.mjs',
406
+ 'beads-identity-check.mjs',
407
+ // The sprint-start token-usage memory sweep: TWO member_name-bearing
408
+ // command() sites (the memory list and the per-key forget), no agent(),
409
+ // and its push goes through an injected bracketed callback.
410
+ 'beads-memory-hygiene.mjs',
411
+ // The engine CI gate: ONE member_name-bearing command() site (the
412
+ // origin-remote read on the git-capable member), no agent(), no push.
413
+ 'ci-gate.mjs',
414
+ 'vcs-module.mjs',
415
+ 'viewer-extensions.mjs',
416
+ // Per-dispatch kb_* and code_* accounting: reads session_stats through the
417
+ // injected memberCall around each dispatch. No command() or agent() site.
418
+ 'dispatch-accounting.mjs',
419
+ // The per-member sprint-init probe: kb_*/code_* calls through the injected
420
+ // memberCall, member_detail on the orchestrator session, and ONE
421
+ // member-bound command channel (fleetApi.executeCommand, command strings
422
+ // built by getSeCommands().wrapForMember) for the remote start-if-down.
423
+ 'member-init-probe.mjs',
424
+ // In-run orphaned-claim bookkeeping (pure): no command() or agent() site;
425
+ // runner.js owns the fresh read, the session stop and the write.
426
+ 'orphan-reclaim.mjs',
427
+ // Verify-block deadlock diagnosis (pure): no command() or agent() site;
428
+ // runner.js owns the runbook probes, the stop and the mid-run exit.
429
+ 'verify-block.mjs',
430
+ 'vcs-providers/azure-devops.mjs',
431
+ 'vcs-providers/bitbucket.mjs',
432
+ 'vcs-providers/dolt.mjs',
433
+ 'vcs-providers/generic-git.mjs',
434
+ 'vcs-providers/github.mjs',
435
+ 'vcs-providers/index.mjs',
436
+ 'vcs-providers/shell-helpers.mjs',
437
+ ];
438
+
439
+ /**
440
+ * Modules the dolt-literal guard must NEVER scan, by basename. dolt-sync.mjs
441
+ * is the single permitted dolt command surface: it builds the literal
442
+ * `bd dolt pull` / `bd dolt push` strings on purpose (apra-fleet-417.2.1/
443
+ * 417.2.2), so pointing the dolt-literal guard at it would flag the sync
444
+ * module for being the sync module. Documented verbatim in
445
+ * dolt-literal-guard.mjs's header; enforced here so the exemption survives
446
+ * anyone adding dolt-sync.mjs to GUARDED_MODULES (or passing it explicitly).
447
+ */
448
+ export const DOLT_LITERAL_EXEMPT = ['dolt-sync.mjs'];
449
+
450
+ /**
451
+ * Modules the unbracketed-push guard (unbracketed-push-guard.mjs) must NEVER
452
+ * scan, by basename. git-sync.mjs is the single module allowed to call the
453
+ * raw doltPushAfter()/syncMemberAfter()/DoltSync.syncBefore()/
454
+ * DoltSync.syncAfter() primitives directly: that IS the bracketed-entry-point
455
+ * implementation the guard exists to protect (apra-fleet-3swo.4.1/.4.2), so
456
+ * pointing the guard at git-sync.mjs itself would flag the module for being
457
+ * the module. Mirrors DOLT_LITERAL_EXEMPT's precedent for dolt-sync.mjs
458
+ * above.
459
+ */
460
+ export const UNBRACKETED_PUSH_EXEMPT = ['git-sync.mjs'];
461
+
462
+ /**
463
+ * Modules the explicit-id create guard (explicit-id-create-guard.mjs) must
464
+ * NEVER scan, by basename. beads-children.mjs is the single module allowed to
465
+ * issue a `bd create` command AT ALL (the guard flags any `bd create` site,
466
+ * not just ones carrying a literal `--id` flag -- see that file's header for
467
+ * why): it is the only place the probe-and-refuse seam (assertChildIdFree(),
468
+ * called from createChildBeadWithAllocatedId, apra-fleet-btj9.7) sits
469
+ * immediately before that create, so pointing the guard at beads-children.mjs
470
+ * itself would flag the module for being the module. Mirrors
471
+ * DOLT_LITERAL_EXEMPT's precedent for dolt-sync.mjs above.
472
+ */
473
+ export const EXPLICIT_ID_CREATE_EXEMPT = ['beads-children.mjs'];
474
+
475
+ /**
476
+ * apra-fleet-3swo.25: modules deliberately excluded from GUARDED_MODULES
477
+ * ENTIRELY -- never registered, never scanned by any of the five guards --
478
+ * keyed by filename (relative to this directory, same convention as
479
+ * GUARDED_MODULES) with a non-empty written reason as the value.
480
+ *
481
+ * This is a DIFFERENT kind of exemption than DOLT_LITERAL_EXEMPT/
482
+ * UNBRACKETED_PUSH_EXEMPT above: those two keep a module registered and
483
+ * scanned by the other four guards, filtering it out of ONE guard only. An
484
+ * entry here is not registered at all, because scanning it with ANY guard
485
+ * would report the module's entire reason for existing (or the guard's own
486
+ * detection logic) as a violation of itself.
487
+ * guarded-modules-coverage.test.mjs asserts every *.mjs/*.js file found by a
488
+ * RECURSIVE walk of this directory is present in either GUARDED_MODULES or
489
+ * this map -- so a module can no longer silently fall through both lists.
490
+ */
491
+ export const GUARD_REGISTRATION_EXEMPT = {
492
+ // The five shell builders -- reasons reused verbatim from this file's own
493
+ // "WHAT DOES NOT BELONG HERE" header above (do not re-derive them).
494
+ 'se-posix.mjs':
495
+ 'deliberately emits `$HOME`, `$env:USERPROFILE`, `$env:TEMP` and `$( )` because it IS the ' +
496
+ 'OS-branched command surface the shell-command invariant tells everyone else to route ' +
497
+ 'through; scanning it would report its entire reason for existing as violations.',
498
+ 'se-windows.mjs':
499
+ 'deliberately emits `$HOME`, `$env:USERPROFILE`, `$env:TEMP` and `$( )` because it IS the ' +
500
+ 'OS-branched command surface the shell-command invariant tells everyone else to route ' +
501
+ 'through; scanning it would report its entire reason for existing as violations.',
502
+ 'se-windows-gitbash.mjs':
503
+ 'deliberately emits `$HOME`, `$env:USERPROFILE`, `$env:TEMP` and `$( )` because it IS the ' +
504
+ 'OS-branched command surface the shell-command invariant tells everyone else to route ' +
505
+ 'through; scanning it would report its entire reason for existing as violations.',
506
+ 'se-os-commands.mjs':
507
+ 'deliberately emits `$HOME`, `$env:USERPROFILE`, `$env:TEMP` and `$( )` because it IS the ' +
508
+ 'OS-branched command surface the shell-command invariant tells everyone else to route ' +
509
+ 'through; scanning it would report its entire reason for existing as violations.',
510
+ 'dolt-settle.mjs':
511
+ 'deliberately emits `$HOME`, `$env:USERPROFILE`, `$env:TEMP` and `$( )` because it IS the ' +
512
+ 'OS-branched command surface the shell-command invariant tells everyone else to route ' +
513
+ 'through; scanning it would report its entire reason for existing as violations.',
514
+ // dolt-sync.mjs -- reason reused verbatim from the same header (do not
515
+ // re-derive it).
516
+ 'dolt-sync.mjs':
517
+ 'legitimately builds the `bd dolt pull`/`bd dolt push` command strings (see ' +
518
+ 'DOLT_LITERAL_EXEMPT above and dolt-literal-guard.mjs\'s own header).',
519
+
520
+ // apra-fleet-3swo.25: dolt-literal-guard.mjs -- confirmed guard-detection
521
+ // false positive. dolt-literal-guard.mjs has no per-line suppression
522
+ // mechanism (unlike shell-command-guard.mjs's shell-guard-allow
523
+ // directive, used instead for the other siblings this bead registers --
524
+ // see contracts.mjs, vcs-module.mjs and vcs-providers/{index,shell-
525
+ // helpers}.mjs, all now registered above with per-line allow comments),
526
+ // so this one file is exempted here rather than registered.
527
+ 'dolt-literal-guard.mjs':
528
+ 'dolt-literal-guard\'s own violation-message text builds the literal phrase \'bd dolt pull\'/' +
529
+ '\'bd dolt push\' to describe what it detects, which the guard then flags as a ' +
530
+ 'self-referential violation of its own implementation, and the guard has no per-line ' +
531
+ 'suppression mechanism (unlike shell-command-guard.mjs) to carve out just that one line.',
532
+ // guarded-modules.mjs itself: this map's own reason strings (and the
533
+ // shell-builder header above) necessarily QUOTE the shell-syntax
534
+ // substrings ($HOME, $(, ~/, 'bd dolt pull'/'bd dolt push', etc.) they
535
+ // describe, in real JS string literals -- which the dolt-literal and
536
+ // shell-command guards' naive text-matching then flags as this file
537
+ // issuing/emitting those constructs itself. Same self-referential class
538
+ // of false positive as dolt-literal-guard.mjs and shell-command-guard.mjs
539
+ // above (confirmed by scanning this file with GUARD_REGISTRATION_EXEMPT
540
+ // populated), not a real dispatched command or shell expansion.
541
+ 'guarded-modules.mjs':
542
+ 'this map\'s own reason strings (and the header above) necessarily quote the shell-syntax ' +
543
+ 'and dolt-command substrings they describe, in real JS string literals, which the ' +
544
+ 'dolt-literal and shell-command guards then flag as this file issuing/emitting those ' +
545
+ 'constructs itself -- the same self-referential false positive as dolt-literal-guard.mjs ' +
546
+ 'and shell-command-guard.mjs above.',
547
+ };
548
+
549
+ /** Absolute path to a fleet-sprint module by filename. */
550
+ export function guardedModulePath(fileName) {
551
+ return path.join(__dirname, fileName);
552
+ }
553
+
554
+ /**
555
+ * Absolute paths of every registered guarded module, plus any `extraPaths`
556
+ * the caller appends (tests pass a throwaway fixture module this way, proving
557
+ * the list is what the guards actually read rather than a hard-coded name).
558
+ */
559
+ export function guardedModulePaths(extraPaths = []) {
560
+ if (!Array.isArray(extraPaths)) {
561
+ throw new TypeError('guardedModulePaths(extraPaths): extraPaths must be an array of file paths');
562
+ }
563
+ return [...GUARDED_MODULES.map(guardedModulePath), ...extraPaths];
564
+ }
565
+
566
+ /**
567
+ * Basenames of every registered guarded module, plus any `extraPaths`'
568
+ * basenames appended -- same `extraPaths` contract as guardedModulePaths().
569
+ *
570
+ * apra-fleet-3swo.14: every guard's aggregate entry point (checkModules(),
571
+ * checkDoltLiteralModules(), checkFullDbFetchModules(), checkShellCommandPaths())
572
+ * labels each scanned file by `path.basename(p)`, both in its `files` return
573
+ * value and in every violation string it emits -- so a nested GUARDED_MODULES
574
+ * entry (e.g. 'phases/plan.mjs', legal per guardedModulePath()'s path.join)
575
+ * resolves and scans correctly but is always reported as just 'plan.mjs'.
576
+ * Comparing a guard's `files` output against GUARDED_MODULES verbatim only
577
+ * holds while every entry is a bare filename with no directory component.
578
+ * Baseline tests must compare against THIS function's output instead of
579
+ * GUARDED_MODULES directly.
580
+ */
581
+ export function guardedModuleBasenames(extraPaths = []) {
582
+ return guardedModulePaths(extraPaths).map((p) => path.basename(p));
583
+ }
584
+
585
+ /**
586
+ * The guarded-module list as the dolt-literal guard must see it: the shared
587
+ * list with DOLT_LITERAL_EXEMPT basenames filtered out. Takes the same
588
+ * `extraPaths` as guardedModulePaths so the exemption applies to caller-
589
+ * supplied paths too -- a fixture literally named dolt-sync.mjs is exempt,
590
+ * while byte-identical content under any other name is not.
591
+ */
592
+ export function doltLiteralModulePaths(extraPaths = []) {
593
+ return guardedModulePaths(extraPaths).filter((p) => !DOLT_LITERAL_EXEMPT.includes(path.basename(p)));
594
+ }
595
+
596
+ /**
597
+ * The guarded-module list as the unbracketed-push guard must see it: the
598
+ * shared list with UNBRACKETED_PUSH_EXEMPT basenames filtered out. Same
599
+ * `extraPaths` contract as guardedModulePaths/doltLiteralModulePaths.
600
+ */
601
+ export function unbracketedPushModulePaths(extraPaths = []) {
602
+ return guardedModulePaths(extraPaths).filter((p) => !UNBRACKETED_PUSH_EXEMPT.includes(path.basename(p)));
603
+ }
604
+
605
+ /**
606
+ * The guarded-module list as the explicit-id create guard must see it: the
607
+ * shared list with EXPLICIT_ID_CREATE_EXEMPT basenames filtered out. Same
608
+ * `extraPaths` contract as guardedModulePaths/doltLiteralModulePaths/
609
+ * unbracketedPushModulePaths.
610
+ */
611
+ export function explicitIdCreateModulePaths(extraPaths = []) {
612
+ return guardedModulePaths(extraPaths).filter((p) => !EXPLICIT_ID_CREATE_EXEMPT.includes(path.basename(p)));
613
+ }