@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,353 @@
1
+ // =============================================================================
2
+ // ENGINE CI GATE.
3
+ //
4
+ // STATUS: DORMANT. Nothing in the sprint runtime calls this module: CI never
5
+ // blocks or reaches doer/reviewer loops, no sprint arg configures a gate, and
6
+ // no prompt carries a CI result. The module (and its unit tests) are kept as a
7
+ // building block for a future design where CI is owned by a dedicated phase.
8
+ //
9
+ // WHAT IT DOES. Triggers (or locates) a workflow run on a branch head with the
10
+ // caller's VCS credential, awaits it with a bounded timeout and records run
11
+ // id/url/head sha/per-job conclusion.
12
+ //
13
+ // NEVER A SILENT SKIP. Every way the gate can fail to produce a real verdict
14
+ // -- the trigger refused for a missing permission, a provider with no CI
15
+ // support, an unreadable remote, a credential that cannot be provisioned, a
16
+ // run that never finishes -- is logged loudly and recorded as a NON-pass
17
+ // outcome (FAILED-TO-RUN or TIMEOUT). Only a completed run whose conclusion
18
+ // the provider calls success is ever PASS.
19
+ //
20
+ // PROVIDER-AGNOSTIC. Every REST literal lives in the provider's `ciGate`
21
+ // descriptor (vcs-providers/github.mjs); this module only sequences the five
22
+ // actions (branch-head, find-runs, dispatch, get-run, list-jobs) and reads the
23
+ // answers through the provider's parse hooks. The HTTP layer is an injected
24
+ // `transport(built) -> { status, body, bodyText }`, so the gate is unit-
25
+ // testable with no network (see test/ci-gate*.test.mjs). In production the
26
+ // transport is the server-side vcs_credential_exec handoff, the same one
27
+ // Publish PR uses -- the orchestrator never sees a plaintext token.
28
+ //
29
+ // GENERIC ENGINE. No target repo's workflow names, OS matrix or job names
30
+ // appear here; they arrive as config and as provider responses.
31
+ //
32
+ // ASCII only.
33
+ // =============================================================================
34
+
35
+ import { capabilities as vcsCapabilities, resolveVcsProviderForHost } from './vcs-module.mjs';
36
+ import { supportsCiGate } from './vcs-providers/index.mjs';
37
+ import {
38
+ parseOwnerRepoFromRemoteUrl, vcsCredentialLabelForProvider, provisionPrCapableAuthForMember,
39
+ } from './vcs-auth.mjs';
40
+ import { resolveMemberTarget } from './member-target.mjs';
41
+ import { resultText } from './mcp-result.mjs';
42
+
43
+ /** Gate outcomes. Only PASS is a pass; everything else is a recorded non-pass. */
44
+ export const CI_GATE_OUTCOME = Object.freeze({
45
+ PASS: 'PASS',
46
+ FAIL: 'FAIL',
47
+ FAILED_TO_RUN: 'FAILED-TO-RUN',
48
+ TIMEOUT: 'TIMEOUT',
49
+ });
50
+
51
+ /** The single log line an unconfigured gate emits (once per sprint). */
52
+ export const CI_GATE_NOT_CONFIGURED_LOG =
53
+ '[CI Gate] CI gate not configured -- the engine does not trigger or check CI.';
54
+
55
+ const DEFAULT_POLL_INTERVAL_MS = 30_000;
56
+ const LOG_PREFIX = '[CI Gate]';
57
+
58
+ /** Split a curl stdout carrying the "-w '\n%{http_code}'" trailer. */
59
+ export function parseCurlStatusOutput(output) {
60
+ const text = String(output || '');
61
+ const lines = text.split('\n');
62
+ const statusLine = lines.length ? lines[lines.length - 1].trim() : '';
63
+ const status = /^\d{3}$/.test(statusLine) ? parseInt(statusLine, 10) : null;
64
+ const bodyText = (status !== null ? lines.slice(0, -1) : lines).join('\n').trim();
65
+ let body = null;
66
+ if (bodyText) {
67
+ try { body = JSON.parse(bodyText); } catch { body = null; }
68
+ }
69
+ return { status, body, bodyText };
70
+ }
71
+
72
+ function isOk(res) {
73
+ return !!res && typeof res.status === 'number' && res.status >= 200 && res.status <= 299;
74
+ }
75
+
76
+ function responseText(res) {
77
+ if (!res) return '(no response)';
78
+ const msg = res.body && typeof res.body.message === 'string' ? res.body.message : '';
79
+ return `HTTP ${res.status ?? '(unknown)'}${msg ? `: ${msg}` : (res.bodyText ? `: ${String(res.bodyText).slice(0, 300)}` : '')}`;
80
+ }
81
+
82
+ /**
83
+ * Run the CI gate once against the current head of `branch`.
84
+ *
85
+ * @param {{
86
+ * ciGate: { workflow: string, timeoutS: number },
87
+ * provider: object|null|undefined, // the resolved VCS provider descriptor
88
+ * providerLabel?: string, // name to report when provider is absent
89
+ * repo: string, // provider repo coordinates (owner/name)
90
+ * branch: string,
91
+ * transport: (built: object) => Promise<{ status: number|null, body: any, bodyText?: string }>,
92
+ * credential?: string, // human description of the credential in use
93
+ * os?: string, shell?: string,
94
+ * log?: Function,
95
+ * sleep?: (ms: number) => Promise<void>,
96
+ * now?: () => number,
97
+ * pollIntervalMs?: number,
98
+ * previous?: object|null, // the last recorded result, reused for an unchanged head
99
+ * }} opts
100
+ * @returns {Promise<object>} the gate record (see CI_GATE_OUTCOME)
101
+ */
102
+ export async function runCiGate({
103
+ ciGate, provider, providerLabel, repo, branch, transport, credential = '(unspecified credential)',
104
+ os, shell, log = () => {}, sleep = (ms) => new Promise((r) => setTimeout(r, ms)), now = () => Date.now(),
105
+ pollIntervalMs = DEFAULT_POLL_INTERVAL_MS, previous = null,
106
+ }) {
107
+ const providerName = (provider && provider.name) || providerLabel || '(unknown provider)';
108
+ const record = {
109
+ outcome: null,
110
+ workflow: ciGate.workflow,
111
+ provider: providerName,
112
+ repo: repo || null,
113
+ branch,
114
+ headSha: null,
115
+ runId: null,
116
+ runUrl: null,
117
+ conclusion: null,
118
+ jobs: [],
119
+ reason: null,
120
+ };
121
+ const finish = (outcome, reason) => {
122
+ record.outcome = outcome;
123
+ record.reason = reason || null;
124
+ if (outcome === CI_GATE_OUTCOME.PASS) {
125
+ log(`${LOG_PREFIX} PASS: workflow '${record.workflow}' run ${record.runId} (${record.runUrl || 'no url'}) on ${record.branch}@${record.headSha}; jobs: ${formatJobs(record.jobs)}.`);
126
+ } else {
127
+ log(`${LOG_PREFIX} ERROR: ${outcome} for workflow '${record.workflow}' on ${record.branch}${record.headSha ? `@${record.headSha}` : ''}${record.runId ? ` (run ${record.runId}, ${record.runUrl || 'no url'})` : ''}: ${record.reason}`);
128
+ }
129
+ return record;
130
+ };
131
+
132
+ if (!supportsCiGate(provider)) {
133
+ return finish(CI_GATE_OUTCOME.FAILED_TO_RUN,
134
+ `VCS provider '${providerName}' has no CI-trigger support, but a ci_gate is configured. Remove ci_gate for this target or use a provider that supports it -- the gate is NOT treated as passed.`);
135
+ }
136
+ if (!repo) {
137
+ return finish(CI_GATE_OUTCOME.FAILED_TO_RUN, 'could not derive the repository from the sprint origin remote.');
138
+ }
139
+ const ci = provider.ciGate;
140
+ const deadline = now() + ciGate.timeoutS * 1000;
141
+ const call = async (action, params) => {
142
+ const built = ci.build(action, { repo, workflow: ciGate.workflow, branch, token: '{{vcs_token_inline}}', os, shell, ...params });
143
+ return transport(built);
144
+ };
145
+ const permissionReason = (what, res) => (
146
+ `${what} was refused (${responseText(res)}). Missing permission: ${ci.requiredPermission}. `
147
+ + `Credential in use: ${credential}. Grant that permission to this credential; CI is NOT verified for this head.`
148
+ );
149
+ // Sleep one poll interval (never past the deadline). false = deadline
150
+ // already reached, so the caller records TIMEOUT instead of polling.
151
+ const waitOrTimeout = async () => {
152
+ const remaining = deadline - now();
153
+ if (remaining <= 0) return false;
154
+ await sleep(Math.min(pollIntervalMs, remaining));
155
+ return true;
156
+ };
157
+
158
+ try {
159
+ // 1. Resolve the branch head sha on the remote (what CI actually runs).
160
+ const headRes = await call('branch-head', {});
161
+ if (!isOk(headRes)) {
162
+ return finish(CI_GATE_OUTCOME.FAILED_TO_RUN, ci.isPermissionRefusal(headRes && headRes.status, responseText(headRes))
163
+ ? permissionReason(`Reading branch '${branch}'`, headRes)
164
+ : `could not read the head of branch '${branch}' (${responseText(headRes)}).`);
165
+ }
166
+ const sha = ci.parseBranchHead(headRes.body);
167
+ if (!sha) return finish(CI_GATE_OUTCOME.FAILED_TO_RUN, `the provider returned no head sha for branch '${branch}'.`);
168
+ record.headSha = sha;
169
+
170
+ // An unchanged head already has a terminal verdict -- do not re-run CI.
171
+ if (previous && previous.headSha === sha && previous.workflow === ciGate.workflow
172
+ && (previous.outcome === CI_GATE_OUTCOME.PASS || previous.outcome === CI_GATE_OUTCOME.FAIL)) {
173
+ log(`${LOG_PREFIX} head ${sha} unchanged since run ${previous.runId}; reusing its ${previous.outcome} result.`);
174
+ return { ...previous };
175
+ }
176
+
177
+ // 2. Locate a run already triggered for this sha, else trigger one.
178
+ const findRun = async () => {
179
+ const res = await call('find-runs', { sha });
180
+ if (!isOk(res)) return { error: res };
181
+ return { run: ci.parseFindRuns(res.body, sha) };
182
+ };
183
+ let found = await findRun();
184
+ if (found.error) {
185
+ return finish(CI_GATE_OUTCOME.FAILED_TO_RUN, ci.isPermissionRefusal(found.error.status, responseText(found.error))
186
+ ? permissionReason(`Listing runs of workflow '${ciGate.workflow}'`, found.error)
187
+ : `could not list runs of workflow '${ciGate.workflow}' (${responseText(found.error)}).`);
188
+ }
189
+ if (!found.run) {
190
+ log(`${LOG_PREFIX} no '${ciGate.workflow}' run found for ${branch}@${sha}; triggering one.`);
191
+ const dispatchRes = await call('dispatch', {});
192
+ if (!isOk(dispatchRes)) {
193
+ return finish(CI_GATE_OUTCOME.FAILED_TO_RUN, ci.isPermissionRefusal(dispatchRes && dispatchRes.status, responseText(dispatchRes))
194
+ ? permissionReason(`Triggering workflow '${ciGate.workflow}' on '${branch}'`, dispatchRes)
195
+ : `triggering workflow '${ciGate.workflow}' on '${branch}' failed (${responseText(dispatchRes)}).`);
196
+ }
197
+ // The dispatch API returns no run id: poll until the run appears.
198
+ while (!found.run) {
199
+ if (!(await waitOrTimeout())) {
200
+ return finish(CI_GATE_OUTCOME.TIMEOUT,
201
+ `the triggered run for ${sha} did not appear within ${ciGate.timeoutS}s.`);
202
+ }
203
+ found = await findRun();
204
+ if (found.error) {
205
+ return finish(CI_GATE_OUTCOME.FAILED_TO_RUN, `could not list runs of workflow '${ciGate.workflow}' (${responseText(found.error)}).`);
206
+ }
207
+ }
208
+ }
209
+ let run = found.run;
210
+ record.runId = run.id;
211
+ record.runUrl = run.url;
212
+ log(`${LOG_PREFIX} awaiting '${ciGate.workflow}' run ${run.id} (${run.url || 'no url'}) on ${branch}@${sha} (timeout ${ciGate.timeoutS}s).`);
213
+
214
+ // 3. Poll the run to completion, bounded by the timeout.
215
+ while (!ci.isRunComplete(run)) {
216
+ if (!(await waitOrTimeout())) {
217
+ return finish(CI_GATE_OUTCOME.TIMEOUT,
218
+ `run did not complete within ${ciGate.timeoutS}s (last status: ${run.status || 'unknown'}); see ${run.url || 'the run page'}.`);
219
+ }
220
+ const runRes = await call('get-run', { runId: run.id });
221
+ if (!isOk(runRes)) {
222
+ return finish(CI_GATE_OUTCOME.FAILED_TO_RUN, `could not read run ${run.id} (${responseText(runRes)}).`);
223
+ }
224
+ run = ci.parseRun(runRes.body) || run;
225
+ if (run.url) record.runUrl = run.url;
226
+ }
227
+ record.conclusion = run.conclusion;
228
+
229
+ // 4. Per-job conclusions.
230
+ const jobsRes = await call('list-jobs', { runId: run.id });
231
+ if (isOk(jobsRes)) {
232
+ record.jobs = ci.parseJobs(jobsRes.body);
233
+ } else {
234
+ log(`${LOG_PREFIX} could not list jobs of run ${run.id} (${responseText(jobsRes)}); recording the run conclusion only.`);
235
+ }
236
+ return ci.isRunSuccess(run)
237
+ ? finish(CI_GATE_OUTCOME.PASS, null)
238
+ : finish(CI_GATE_OUTCOME.FAIL, `run concluded '${run.conclusion}'; jobs: ${formatJobs(record.jobs)}.`);
239
+ } catch (err) {
240
+ return finish(CI_GATE_OUTCOME.FAILED_TO_RUN, `CI gate error: ${err && err.message ? err.message : err} (credential in use: ${credential}).`);
241
+ }
242
+ }
243
+
244
+ function formatJobs(jobs) {
245
+ if (!Array.isArray(jobs) || jobs.length === 0) return '(no job detail)';
246
+ return jobs.map((j) => `${j.name}=${j.conclusion}`).join(', ');
247
+ }
248
+
249
+ /**
250
+ * Sprint-scoped CI gate. Logs CI_GATE_NOT_CONFIGURED_LOG exactly once when
251
+ * `ciGate` is absent and then never touches a provider. When configured,
252
+ * `check()` resolves the run context (provider, repo, credential transport)
253
+ * and runs the gate, reusing the previous terminal result for an unchanged
254
+ * head, and records every result in `results`.
255
+ *
256
+ * @param {{
257
+ * ciGate: { workflow: string, timeoutS: number }|undefined,
258
+ * branch: string,
259
+ * log?: Function,
260
+ * resolveContext: () => Promise<object>, // -> { provider, providerLabel, repo, transport, credential, os, shell } | { error }
261
+ * gateOptions?: object, // test seam: sleep/now/pollIntervalMs
262
+ * }} opts
263
+ */
264
+ export function createCiGate({ ciGate, branch, log = () => {}, resolveContext, gateOptions = {} }) {
265
+ const results = [];
266
+ if (!ciGate) {
267
+ log(CI_GATE_NOT_CONFIGURED_LOG);
268
+ return { configured: false, results, async check() { return null; } };
269
+ }
270
+ log(`${LOG_PREFIX} configured: workflow '${ciGate.workflow}', timeout ${ciGate.timeoutS}s -- run before each reviewer dispatch on the ${branch} head.`);
271
+ return {
272
+ configured: true,
273
+ results,
274
+ async check({ label } = {}) {
275
+ const previous = results.length > 0 ? results[results.length - 1] : null;
276
+ let ctx;
277
+ try {
278
+ ctx = await resolveContext();
279
+ } catch (err) {
280
+ ctx = { error: err && err.message ? err.message : String(err) };
281
+ }
282
+ let result;
283
+ if (ctx && ctx.error) {
284
+ result = {
285
+ outcome: CI_GATE_OUTCOME.FAILED_TO_RUN, workflow: ciGate.workflow, provider: ctx.providerLabel || null,
286
+ repo: null, branch, headSha: null, runId: null, runUrl: null, conclusion: null, jobs: [],
287
+ reason: ctx.error,
288
+ };
289
+ log(`${LOG_PREFIX} ERROR: ${CI_GATE_OUTCOME.FAILED_TO_RUN} for workflow '${ciGate.workflow}' on ${branch}: ${ctx.error}`);
290
+ } else {
291
+ result = await runCiGate({ ciGate, branch, log, previous, ...ctx, ...gateOptions });
292
+ }
293
+ result.label = label || null;
294
+ results.push(result);
295
+ return result;
296
+ },
297
+ };
298
+ }
299
+
300
+ /**
301
+ * Production context resolver: origin remote -> provider + repo; just-in-time
302
+ * push+pr credential on the orchestrator (the level that carries the CI
303
+ * trigger permission); a vcs_credential_exec transport. Every failure becomes
304
+ * `{ error }` so the gate records FAILED-TO-RUN loudly instead of throwing.
305
+ *
306
+ * @param {{ fleetApi: object|null, command: Function, backlogMember: string, gitMember: string, log?: Function }} opts
307
+ * @returns {() => Promise<object>}
308
+ */
309
+ export function createCiGateContextResolver({ fleetApi, command, backlogMember, gitMember, log = () => {} }) {
310
+ return async function resolveCiGateContext() {
311
+ const originRes = await command('git remote get-url origin', {
312
+ member_name: gitMember, silent: true, failSoft: true, label: 'CI gate: resolve origin remote URL',
313
+ });
314
+ const originUrl = originRes && originRes.ok ? String(originRes.output || '').trim() : '';
315
+ if (!originUrl) {
316
+ return { error: `could not read the origin remote on member '${gitMember}' (${(originRes && originRes.error) || 'empty'}).` };
317
+ }
318
+ const caps = vcsCapabilities(originUrl);
319
+ const provider = caps.host ? resolveVcsProviderForHost(caps.host) : null;
320
+ const providerLabel = provider ? provider.name : `none (origin '${originUrl}' has no hosting provider)`;
321
+ if (!supportsCiGate(provider)) {
322
+ // runCiGate reports the unsupported provider loudly by name.
323
+ return { provider, providerLabel, repo: null, transport: async () => ({ status: null, body: null }) };
324
+ }
325
+ if (!fleetApi || typeof fleetApi.vcsCredentialExec !== 'function') {
326
+ return { providerLabel, error: `no fleet MCP client with vcs_credential_exec is available to run the CI gate for provider '${provider.name}'.` };
327
+ }
328
+ const label = vcsCredentialLabelForProvider(provider.name);
329
+ const credential = `the '${label}' push+pr VCS credential on member '${backlogMember}'`;
330
+ let repo;
331
+ try {
332
+ ({ repo } = await provisionPrCapableAuthForMember({
333
+ fleetApi, command, member: backlogMember, log, logPrefix: LOG_PREFIX, remoteUrlOverride: originUrl,
334
+ }));
335
+ } catch (err) {
336
+ return { providerLabel, error: `could not provision ${credential}: ${err && err.message ? err.message : err}` };
337
+ }
338
+ repo = repo || parseOwnerRepoFromRemoteUrl(originUrl);
339
+ const { os, shell } = await resolveMemberTarget({ fleetApi, member: backlogMember, log });
340
+ const transport = async (built) => {
341
+ const execRes = await fleetApi.vcsCredentialExec({ member_name: backlogMember, label, command: built.command });
342
+ const handoff = (execRes && execRes.structuredContent) || {};
343
+ if (!handoff.ok && handoff.reason !== 'dispatch_failed') {
344
+ throw new Error(`vcs_credential_exec could not use ${credential} (reason: ${handoff.reason || '(none)'}): ${resultText(execRes) || '(no detail)'}`);
345
+ }
346
+ if (!handoff.ok || (typeof handoff.exitCode === 'number' && handoff.exitCode !== 0)) {
347
+ throw new Error(`CI request failed to run (${built.logSafeCommand}): ${handoff.stderr || resultText(execRes) || '(no detail)'}`);
348
+ }
349
+ return parseCurlStatusOutput(handoff.stdout);
350
+ };
351
+ return { provider, providerLabel, repo, transport, credential, os, shell };
352
+ };
353
+ }
@@ -172,6 +172,26 @@ export async function dispatchConflictResolutionAgent({ agent, member, branch, u
172
172
  member_name: member,
173
173
  label: `Tier 2 conflict resolution [${unmergedPaths.join(', ')}]`,
174
174
  model,
175
+ // EXPLICITLY a fresh session. The runbook above is entirely
176
+ // self-contained (it names the member, the branch and every
177
+ // conflicted path), and the member's stored last session is whatever
178
+ // role dispatch happened to run there -- resuming it would drop a git
179
+ // conflict-resolution instruction into an unrelated conversation.
180
+ // Never rely on an omitted `resume`: execute_prompt defaults it to
181
+ // true, i.e. best-effort reattachment to exactly that stale session.
182
+ resume: false,
183
+ // STRICT on a refused tool call (fail_on_permission_denial, as every
184
+ // role dispatch passes). The runbook is a series of git commands: a
185
+ // Claude reply that completes after the member CLI refused one of them
186
+ // would otherwise be a warning, and a runbook that silently skipped a
187
+ // refused git command must not be read as a resolved conflict. A
188
+ // permission_denied outcome surfaces as a thrown dispatch error, which
189
+ // the caller (member-sync.mjs) already catches, logs and does NOT
190
+ // retry; it then re-verifies the real git state (porcelain + re-push)
191
+ // and, if still unresolved, restores a clean tree and fails with the
192
+ // typed GitDivergedError -- a clear ladder failure, never an uncaught
193
+ // error and never a claim taken on the agent's word.
194
+ fail_on_permission_denial: true,
175
195
  timeout_s: 1800,
176
196
  max_total_s: 1800,
177
197
  });
@@ -281,9 +281,12 @@ export function majorVersionFromId(id) {
281
281
  export function assertVersionPin(role, schema, expectedMajor) {
282
282
  const actualMajor = majorVersionFromId(schema && schema.$id);
283
283
  if (actualMajor !== expectedMajor) {
284
+ // GENERIC-BOUNDARY-EXCEPTION: developer-facing Error about this product's own vendored schema --
285
+ // thrown at module load and read by an apra-fleet developer, never dispatched to a sprint
286
+ // agent; it must name the package whose vendored schema drifted (docs/generic-engine-boundary.md).
284
287
  throw new Error(
285
288
  `[contracts] Version-pin mismatch for role "${role}": this module was written against ` +
286
- `schema $id major version ${expectedMajor}, but the vendored schema's $id is ` +
289
+ `schema $id major version ${expectedMajor}, but the vendored schema's $id is ` + // shell-guard-allow: "$id" here and on the next line is the JSON Schema $id property name (schema.$id), not a shell variable expansion -- this text is a thrown JS Error, never dispatched as a command string.
287
290
  `${JSON.stringify(schema && schema.$id)}. A packages/apra-fleet-se/apra-pm package update changed this ` +
288
291
  `role's contract -- update contracts.mjs (and re-verify every call site that consumes ` +
289
292
  `this schema) before accepting the new vendored version.`,
@@ -423,6 +426,47 @@ const FALLBACK_planReviewerVerdict = {
423
426
  properties: {
424
427
  verdict: { type: 'string', enum: ['APPROVED', 'CHANGES_NEEDED'] },
425
428
  notes: { type: 'string' },
429
+ // apra-fleet-3swo.7.8: optional, deliberately NOT in `required` below
430
+ // -- mirrors packages/apra-fleet-se/apra-pm/agents/schemas/plan-reviewer-output.json.
431
+ // Machine-readable per-bead findings, so a CHANGES_NEEDED verdict can
432
+ // be routed to the beads it concerns WITHOUT scanning free-text notes
433
+ // for literal bead ids (the job extractContestedBeadIds does today in
434
+ // fleet-sprint/newtask-text.mjs; retiring that scraper is a separate
435
+ // task). An EMPTY array is meaningful -- it is the explicit
436
+ // "plan-wide objection, no individual bead named" signal, which is the
437
+ // same thing the prose scan expressed by matching no id. An ABSENT
438
+ // field is schema-valid and means "this verdict predates the findings
439
+ // contract", so the consumer may still fall back to notes for one
440
+ // release; keeping it out of `required` is what makes that fallback
441
+ // window possible.
442
+ findings: {
443
+ type: 'array',
444
+ items: {
445
+ type: 'object',
446
+ properties: {
447
+ id: { type: 'string' },
448
+ kind: {
449
+ type: 'string',
450
+ enum: [
451
+ 'coverage',
452
+ 'missing_test_task',
453
+ 'acceptance_criteria',
454
+ 'task_size',
455
+ 'dependency_wiring',
456
+ 'scope_creep',
457
+ 'duplicate_work',
458
+ 'feasibility',
459
+ 'ready_work',
460
+ 'model_metadata',
461
+ 'lane_cohesion',
462
+ 'other',
463
+ ],
464
+ },
465
+ detail: { type: 'string', minLength: 1 },
466
+ },
467
+ required: ['id', 'kind', 'detail'],
468
+ },
469
+ },
426
470
  taskAssignments: { type: 'array', items: taskAssignmentSchema },
427
471
  },
428
472
  required: ['verdict', 'notes', 'taskAssignments'],
@@ -446,6 +490,11 @@ const FALLBACK_reviewerVerdict = {
446
490
  // schema-valid and semantically a no-op, preserving pre-eft.67
447
491
  // behavior exactly.
448
492
  replanIds: { type: 'array', items: { type: 'string' } },
493
+ // Optional, NOT required: true when the build or test suite fails on
494
+ // the branch under review. Lets the orchestrator file an in-goal fix
495
+ // task when no reopen/newTask survives (ensureRedBranchFixTask in
496
+ // beads-transitions.mjs). Mirrors reviewer-output.json.
497
+ buildFailing: { type: 'boolean' },
449
498
  newTasks: {
450
499
  type: 'array',
451
500
  items: {
@@ -575,16 +624,43 @@ const FALLBACK_regressionReport = {
575
624
  type: 'object',
576
625
  properties: {
577
626
  passed: { type: 'boolean' },
627
+ sections: {
628
+ type: 'array',
629
+ items: {
630
+ type: 'object',
631
+ properties: {
632
+ name: { type: 'string' },
633
+ passed: { type: 'boolean' },
634
+ detail: { type: 'string' },
635
+ },
636
+ required: ['name', 'passed'],
637
+ },
638
+ },
639
+ // Deprecated two-part fields: still accepted, never required.
578
640
  suitePassed: { type: 'boolean' },
579
641
  smokePassed: { type: 'boolean' },
580
642
  bugsFiled: { type: 'array', items: { type: 'string' } },
581
643
  summary: { type: 'string' },
644
+ // Optional verdict fields, copied verbatim from a machine-written
645
+ // verdict file when the target playbook names one.
646
+ verdict: { type: 'string', enum: ['PASS', 'FAIL', 'INCONCLUSIVE'] },
647
+ testedSha: { type: 'string', pattern: '^[0-9a-f]{40}$' },
648
+ evidence: {
649
+ type: 'object',
650
+ additionalProperties: true,
651
+ properties: {
652
+ verdictRef: { type: 'string' },
653
+ runUrl: { type: 'string' },
654
+ newFailures: { type: 'array', items: { type: 'string' } },
655
+ inventoryMissing: { type: 'array', items: { type: 'string' } },
656
+ },
657
+ },
582
658
  smokeEvidence: {
583
659
  type: 'object',
584
660
  additionalProperties: true,
585
661
  },
586
662
  },
587
- required: ['passed', 'suitePassed', 'smokePassed', 'bugsFiled', 'summary'],
663
+ required: ['passed', 'bugsFiled', 'summary'],
588
664
  };
589
665
 
590
666
  // Fallback for role "ci-watcher". Canonical source:
@@ -684,6 +760,33 @@ export const finalVerdict = {
684
760
  required: ['id', 'reason'],
685
761
  },
686
762
  },
763
+ // The Final Review's DISCARD judgement, mirroring reviewer-output.json's
764
+ // kb_discards: same {id, reason} shape as kb_promotions, executed by the
765
+ // same kbWork.apply path. Optional: discarding nothing is the common answer.
766
+ // The reason minLength is the engine's evidence bar (kb.mjs
767
+ // KB_MIN_PROMOTE_REASON, enforced in vetKbWork); kept as a literal so
768
+ // this schema module stays dependency-free, pinned equal by
769
+ // test/kb-review-judgements.test.mjs.
770
+ kb_discards: {
771
+ type: 'array',
772
+ description: 'Promotion candidates the final review showed to be WRONG and is discarding (the entry drops out of every later read). Same evidence bar as kb_promotions. An id may not appear in both kb_promotions and kb_discards -- the engine refuses both. The engine makes the discard calls.',
773
+ items: {
774
+ type: 'object',
775
+ properties: {
776
+ id: {
777
+ type: 'string',
778
+ description: "The entry id, copied verbatim from the 'KNOWLEDGE BANK -- promotion candidates' block in your dispatch prompt. Never invent one.",
779
+ minLength: 1,
780
+ },
781
+ reason: {
782
+ type: 'string',
783
+ description: 'The evidence that the entry is wrong -- what you actually checked that contradicts its claim.',
784
+ minLength: 20,
785
+ },
786
+ },
787
+ required: ['id', 'reason'],
788
+ },
789
+ },
687
790
  },
688
791
  required: ['verdict', 'notes'],
689
792
  };
@@ -928,19 +1031,22 @@ function longestBacktickRun(content) {
928
1031
  }
929
1032
 
930
1033
  /**
931
- * The pattern src/tools/execute-prompt.ts matches to reject a dispatch
932
- * outright. Duplicated here as a literal rather than imported: this module
933
- * deliberately has no dependency on the fleet server sources.
1034
+ * The pattern src/services/secret-token.ts (SECRET_TOKEN_RE) matches to
1035
+ * reject a dispatch outright / redact untrusted content. Mirrored here as a
1036
+ * literal rather than imported: this module deliberately has no dependency
1037
+ * on the fleet server sources. Accepts both the canonical {{secret.NAME}}
1038
+ * spelling and the deprecated {{secure.NAME}} one.
934
1039
  */
935
- const SECURE_TOKEN_RE_G = /\{\{secure\.([a-zA-Z0-9_-]{1,64})\}\}/g;
1040
+ const SECRET_TOKEN_RE_G = /\{\{(secret|secure)\.([a-zA-Z0-9_-]{1,64})\}\}/g;
936
1041
 
937
- const SECURE_REDACTION_NOTE = 'NOTE: secure-token braces were redacted from the block above '
938
- + '(secure.NAME is shown without its surrounding double braces). Write the braced form when '
1042
+ const SECRET_REDACTION_NOTE = 'NOTE: secret-token braces were redacted from the block above '
1043
+ + '(secret.NAME is shown without its surrounding double braces). Write the braced form when '
939
1044
  + 'you actually use the token in an execute_command call.';
940
1045
 
941
1046
  /**
942
- * Strips the surrounding double braces from any secure-token reference in
943
- * untrusted content, keeping the token NAME so the text still reads.
1047
+ * Strips the surrounding double braces from any secret-token reference
1048
+ * (either {{secret.NAME}} or the deprecated {{secure.NAME}}) in untrusted
1049
+ * content, keeping the "secret.NAME"/"secure.NAME" text so it still reads.
944
1050
  *
945
1051
  * Why this must happen before the content reaches a prompt: execute_prompt
946
1052
  * rejects the ENTIRE dispatch -- no LLM call, an error string returned in
@@ -953,17 +1059,17 @@ const SECURE_REDACTION_NOTE = 'NOTE: secure-token braces were redacted from the
953
1059
  * @param {string} content
954
1060
  * @returns {{text: string, redacted: boolean}}
955
1061
  */
956
- function redactSecureTokens(content) {
1062
+ function redactSecretTokens(content) {
957
1063
  let text = content;
958
1064
  let redacted = false;
959
1065
  // Run to a fixed point rather than a single pass: replacing the inner
960
- // token in `{{{{secure.A}}}}` leaves `{{secure.A}}`, so the surrounding
1066
+ // token in `{{{{secret.A}}}}` leaves `{{secret.A}}`, so the surrounding
961
1067
  // braces close over the redacted name and rebuild exactly the pattern
962
1068
  // being removed. Untrusted content is attacker-influenced free-text, so
963
1069
  // one pass is not enough. Guaranteed to terminate -- every replacement
964
1070
  // removes four brace characters, so `text` strictly shrinks.
965
1071
  for (;;) {
966
- const next = text.replace(SECURE_TOKEN_RE_G, (_match, name) => `secure.${name}`);
1072
+ const next = text.replace(SECRET_TOKEN_RE_G, (_match, kind, name) => `${kind}.${name}`);
967
1073
  if (next === text) break;
968
1074
  text = next;
969
1075
  redacted = true;
@@ -996,7 +1102,7 @@ export function wrapUntrustedBlock(sourceLabel, content) {
996
1102
  if (typeof content !== 'string') {
997
1103
  throw new TypeError('[contracts] wrapUntrustedBlock requires content to be a string');
998
1104
  }
999
- const { text: safeContent, redacted } = redactSecureTokens(content);
1105
+ const { text: safeContent, redacted } = redactSecretTokens(content);
1000
1106
  const fenceLength = Math.max(MIN_FENCE_LENGTH, longestBacktickRun(safeContent) + 1);
1001
1107
  const fence = '`'.repeat(fenceLength);
1002
1108
  return [
@@ -1005,7 +1111,7 @@ export function wrapUntrustedBlock(sourceLabel, content) {
1005
1111
  `${fence}${UNTRUSTED_BLOCK_FENCE_LABEL}`,
1006
1112
  safeContent,
1007
1113
  fence,
1008
- ...(redacted ? [SECURE_REDACTION_NOTE] : []),
1114
+ ...(redacted ? [SECRET_REDACTION_NOTE] : []),
1009
1115
  ].join('\n');
1010
1116
  }
1011
1117