@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
@@ -1,7 +1,72 @@
1
1
  /**
2
- * Azure DevOps VCS provider — deploys PAT credentials via git credential helper.
2
+ * Azure DevOps VCS provider -- deploys PAT credentials via git credential helper.
3
3
  * Auth pattern: placeholder username + PAT as password (see PAT_USERNAME).
4
4
  */
5
5
  import type { VcsProviderService } from './types.js';
6
+ /**
7
+ * Every host Azure DevOps serves git over, ANCHORED (a substring test would
8
+ * let `dev.azure.com.evil.example` claim this provider):
9
+ * - dev.azure.com modern https remotes
10
+ * - ssh.dev.azure.com modern v3 ssh remotes
11
+ * - <org>.visualstudio.com legacy https remotes (org = first DNS label)
12
+ * - vs-ssh.visualstudio.com legacy v3 ssh remotes
13
+ * Kept in step with src/utils/vcs-provider-detect.ts's AZURE_DEVOPS_HOST_RE
14
+ * and the engine-side HOST_RE in
15
+ * packages/apra-fleet-se/fleet-sprint/vcs-providers/azure-devops.mjs.
16
+ */
17
+ export declare const AZURE_DEVOPS_HOST_RE: RegExp;
18
+ /** Both git transports an Azure DevOps remote can use. A PAT only ever
19
+ * applies to `https`; an `ssh` remote authenticates with the member's SSH
20
+ * key and the PAT is deployed for REST (pull-request) calls only. */
21
+ export type AzureDevOpsTransport = 'https' | 'ssh';
22
+ export interface AzureDevOpsRepoRef {
23
+ org: string;
24
+ project: string;
25
+ repo: string;
26
+ /** Lowercased hostname the remote points at. */
27
+ host: string;
28
+ transport: AzureDevOpsTransport;
29
+ /** True for the legacy `<org>.visualstudio.com` / `vs-ssh.visualstudio.com` hosts. */
30
+ legacy: boolean;
31
+ }
32
+ /**
33
+ * Parse an Azure DevOps git remote URL into its { org, project, repo }
34
+ * coordinates -- the identity every Azure DevOps REST call needs -- plus the
35
+ * host and transport it was reached on. The SERVER-side twin of the engine's
36
+ * parseRepoRef() (packages/apra-fleet-se/fleet-sprint/vcs-providers/
37
+ * azure-devops.mjs); the two are kept in step by hand because the engine is
38
+ * a separate package that cannot import from src/.
39
+ *
40
+ * Recognized shapes:
41
+ * https://[user@]dev.azure.com/ORG/PROJECT/_git/REPO[.git][/]
42
+ * https://[user@]dev.azure.com/ORG/_git/REPO (project == repo)
43
+ * https://[user@]ORG.visualstudio.com/[DefaultCollection/]PROJECT/_git/REPO
44
+ * https://[user@]ORG.visualstudio.com/[DefaultCollection/]_git/REPO (project == repo)
45
+ * git@ssh.dev.azure.com:v3/ORG/PROJECT/REPO
46
+ * ORG@vs-ssh.visualstudio.com:v3/ORG/PROJECT/REPO
47
+ * ssh://git@ssh.dev.azure.com[:22]/v3/ORG/PROJECT/REPO
48
+ *
49
+ * Percent-encoded project names (Azure DevOps allows spaces) are decoded in
50
+ * every returned field. NEVER throws; returns null for anything that is not
51
+ * one of the shapes above, including a lookalike host.
52
+ */
53
+ export declare function parseAzureDevOpsRemote(remoteUrl: unknown): AzureDevOpsRepoRef | null;
54
+ /**
55
+ * Extract the organization from an Azure DevOps org URL, accepting both
56
+ * hosts: "https://dev.azure.com/myorg" and the legacy
57
+ * "https://myorg.visualstudio.com[/...]". Falls back to the input verbatim
58
+ * (the historical behaviour) when neither shape matches.
59
+ */
60
+ export declare function extractAzureDevOpsOrg(orgUrl: string): string;
61
+ /**
62
+ * The host the git credential helper is bound to for a given credential
63
+ * scope URL. A scope on a legacy `<org>.visualstudio.com` host binds the PAT
64
+ * to THAT host: git looks credentials up by the remote's own hostname, so a
65
+ * helper registered for dev.azure.com is never consulted for a push to
66
+ * `https://myorg.visualstudio.com/...`. Every other scope (the default bare
67
+ * `https://dev.azure.com`, an org- or repo-scoped modern URL, a non-Azure or
68
+ * unparseable value) keeps the modern host.
69
+ */
70
+ export declare function credentialHostForScope(scopeUrl?: string): string;
6
71
  export declare const azureDevOpsProvider: VcsProviderService;
7
72
  //# sourceMappingURL=azure-devops.d.ts.map
@@ -1,8 +1,11 @@
1
1
  /**
2
- * Azure DevOps VCS provider — deploys PAT credentials via git credential helper.
2
+ * Azure DevOps VCS provider -- deploys PAT credentials via git credential helper.
3
3
  * Auth pattern: placeholder username + PAT as password (see PAT_USERNAME).
4
4
  */
5
5
  import { knownRepoRemoteUrl } from '../member-remote-url.js';
6
+ /** The modern Azure DevOps host. The git credential helper is bound to THIS
7
+ * host unless the credential's scope URL names a legacy host -- see
8
+ * credentialHostForScope(). */
6
9
  const HOST = 'dev.azure.com';
7
10
  // The username written into the git credential helper next to the PAT. It
8
11
  // MUST be non-empty: with `username=` (empty) git still sends an
@@ -16,26 +19,190 @@ const HOST = 'dev.azure.com';
16
19
  // is the customary placeholder. Mirrors src/services/vcs/github.ts's
17
20
  // `x-access-token` convention of a named constant, not an inline literal.
18
21
  const PAT_USERNAME = 'pat';
22
+ /**
23
+ * Every host Azure DevOps serves git over, ANCHORED (a substring test would
24
+ * let `dev.azure.com.evil.example` claim this provider):
25
+ * - dev.azure.com modern https remotes
26
+ * - ssh.dev.azure.com modern v3 ssh remotes
27
+ * - <org>.visualstudio.com legacy https remotes (org = first DNS label)
28
+ * - vs-ssh.visualstudio.com legacy v3 ssh remotes
29
+ * Kept in step with src/utils/vcs-provider-detect.ts's AZURE_DEVOPS_HOST_RE
30
+ * and the engine-side HOST_RE in
31
+ * packages/apra-fleet-se/fleet-sprint/vcs-providers/azure-devops.mjs.
32
+ */
33
+ export const AZURE_DEVOPS_HOST_RE = /^(?:dev\.azure\.com|ssh\.dev\.azure\.com|(?:[a-z0-9-]+\.)*visualstudio\.com)$/i;
34
+ /** Percent-decode one path segment; an invalid escape is left as-is because
35
+ * the parser must never throw. */
36
+ function decodeSegment(segment) {
37
+ try {
38
+ return decodeURIComponent(segment);
39
+ }
40
+ catch {
41
+ return segment;
42
+ }
43
+ }
44
+ /** Split a remote URL into { host, path, scheme } for BOTH shapes git
45
+ * speaks: a real scheme'd URL and the scp-like `user@host:path` shorthand
46
+ * `new URL()` cannot parse. */
47
+ function splitRemote(url) {
48
+ if (/^[a-z][a-z0-9+.-]*:\/\//i.test(url)) {
49
+ let parsed;
50
+ try {
51
+ parsed = new URL(url);
52
+ }
53
+ catch {
54
+ return null;
55
+ }
56
+ if (!parsed.hostname)
57
+ return null;
58
+ return { host: parsed.hostname.toLowerCase(), path: parsed.pathname, scheme: parsed.protocol.replace(/:$/, '').toLowerCase() };
59
+ }
60
+ const scp = /^(?:[^@\s/]+@)?([^:\s/]+):(.*)$/.exec(url);
61
+ if (!scp)
62
+ return null;
63
+ return { host: scp[1].toLowerCase(), path: `/${scp[2]}`, scheme: 'ssh' };
64
+ }
65
+ /**
66
+ * Parse an Azure DevOps git remote URL into its { org, project, repo }
67
+ * coordinates -- the identity every Azure DevOps REST call needs -- plus the
68
+ * host and transport it was reached on. The SERVER-side twin of the engine's
69
+ * parseRepoRef() (packages/apra-fleet-se/fleet-sprint/vcs-providers/
70
+ * azure-devops.mjs); the two are kept in step by hand because the engine is
71
+ * a separate package that cannot import from src/.
72
+ *
73
+ * Recognized shapes:
74
+ * https://[user@]dev.azure.com/ORG/PROJECT/_git/REPO[.git][/]
75
+ * https://[user@]dev.azure.com/ORG/_git/REPO (project == repo)
76
+ * https://[user@]ORG.visualstudio.com/[DefaultCollection/]PROJECT/_git/REPO
77
+ * https://[user@]ORG.visualstudio.com/[DefaultCollection/]_git/REPO (project == repo)
78
+ * git@ssh.dev.azure.com:v3/ORG/PROJECT/REPO
79
+ * ORG@vs-ssh.visualstudio.com:v3/ORG/PROJECT/REPO
80
+ * ssh://git@ssh.dev.azure.com[:22]/v3/ORG/PROJECT/REPO
81
+ *
82
+ * Percent-encoded project names (Azure DevOps allows spaces) are decoded in
83
+ * every returned field. NEVER throws; returns null for anything that is not
84
+ * one of the shapes above, including a lookalike host.
85
+ */
86
+ export function parseAzureDevOpsRemote(remoteUrl) {
87
+ if (typeof remoteUrl !== 'string')
88
+ return null;
89
+ const url = remoteUrl.trim();
90
+ if (!url)
91
+ return null;
92
+ const split = splitRemote(url);
93
+ if (!split || !AZURE_DEVOPS_HOST_RE.test(split.host))
94
+ return null;
95
+ const raw = split.path.split('/').filter((part) => part !== '');
96
+ if (raw.length === 0)
97
+ return null;
98
+ raw[raw.length - 1] = raw[raw.length - 1].replace(/\.git$/i, '');
99
+ const segments = raw.map(decodeSegment);
100
+ const legacy = /visualstudio\.com$/i.test(split.host);
101
+ const build = (org, project, repo, transport) => {
102
+ if (!org || !project || !repo)
103
+ return null;
104
+ return { org, project, repo, host: split.host, transport, legacy };
105
+ };
106
+ // v3 ssh form: exactly v3/ORG/PROJECT/REPO on either ssh host.
107
+ if (segments[0].toLowerCase() === 'v3') {
108
+ if (segments.length !== 4 || split.scheme !== 'ssh')
109
+ return null;
110
+ return build(segments[1], segments[2], segments[3], 'ssh');
111
+ }
112
+ if (split.scheme !== 'https' && split.scheme !== 'http')
113
+ return null;
114
+ // The ssh-only hosts never serve the https '_git' shape.
115
+ if (/^(?:ssh\.dev\.azure\.com|vs-ssh\.visualstudio\.com)$/i.test(split.host))
116
+ return null;
117
+ const marker = segments.indexOf('_git');
118
+ if (marker === -1 || marker !== segments.length - 2)
119
+ return null;
120
+ const repo = segments[segments.length - 1];
121
+ let prefix = segments.slice(0, marker);
122
+ if (legacy) {
123
+ // Legacy host: the org is the first hostname label, and an explicit
124
+ // collection segment (historically 'DefaultCollection') may precede the
125
+ // project.
126
+ const org = split.host.split('.')[0];
127
+ if (!org || org.toLowerCase() === 'visualstudio' || org.toLowerCase() === 'vs-ssh')
128
+ return null;
129
+ if (prefix.length > 0 && prefix[0].toLowerCase() === 'defaultcollection')
130
+ prefix = prefix.slice(1);
131
+ if (prefix.length > 1)
132
+ return null;
133
+ return build(org, prefix[0] || repo, repo, 'https');
134
+ }
135
+ if (prefix.length < 1 || prefix.length > 2)
136
+ return null;
137
+ return build(prefix[0], prefix[1] || repo, repo, 'https');
138
+ }
139
+ /**
140
+ * Extract the organization from an Azure DevOps org URL, accepting both
141
+ * hosts: "https://dev.azure.com/myorg" and the legacy
142
+ * "https://myorg.visualstudio.com[/...]". Falls back to the input verbatim
143
+ * (the historical behaviour) when neither shape matches.
144
+ */
145
+ export function extractAzureDevOpsOrg(orgUrl) {
146
+ const modern = orgUrl.match(/^(?:https?:\/\/)?(?:[^@/]+@)?dev\.azure\.com\/([^/?#]+)/i);
147
+ if (modern?.[1])
148
+ return modern[1];
149
+ const legacy = orgUrl.match(/^(?:https?:\/\/)?(?:[^@/]+@)?([a-z0-9-]+)\.visualstudio\.com(?:[/?#]|$)/i);
150
+ if (legacy?.[1] && legacy[1].toLowerCase() !== 'vs-ssh')
151
+ return legacy[1];
152
+ return orgUrl;
153
+ }
19
154
  function extractOrg(orgUrl) {
20
- // org_url is e.g. "https://dev.azure.com/myorg" — extract "myorg"
21
- const match = orgUrl.match(/dev\.azure\.com\/([^/]+)/);
22
- return match?.[1] ?? orgUrl;
155
+ return extractAzureDevOpsOrg(orgUrl);
156
+ }
157
+ /**
158
+ * The host the git credential helper is bound to for a given credential
159
+ * scope URL. A scope on a legacy `<org>.visualstudio.com` host binds the PAT
160
+ * to THAT host: git looks credentials up by the remote's own hostname, so a
161
+ * helper registered for dev.azure.com is never consulted for a push to
162
+ * `https://myorg.visualstudio.com/...`. Every other scope (the default bare
163
+ * `https://dev.azure.com`, an org- or repo-scoped modern URL, a non-Azure or
164
+ * unparseable value) keeps the modern host.
165
+ */
166
+ export function credentialHostForScope(scopeUrl) {
167
+ if (!scopeUrl)
168
+ return HOST;
169
+ let host;
170
+ try {
171
+ host = new URL(scopeUrl).hostname.toLowerCase();
172
+ }
173
+ catch {
174
+ return HOST;
175
+ }
176
+ if (host && AZURE_DEVOPS_HOST_RE.test(host) && /visualstudio\.com$/i.test(host)) {
177
+ const org = host.split('.')[0].toLowerCase();
178
+ if (org && org !== 'visualstudio' && org !== 'vs-ssh')
179
+ return host;
180
+ }
181
+ return HOST;
23
182
  }
24
183
  // apra-fleet-5co8.5.2 (review round 2): a candidate repo URL is only usable
25
- // when it is a well-formed Azure DevOps repo URL -- "https://dev.azure.com/
26
- // <org>/<project>/_git/<repo>" with each segment restricted to characters
27
- // that can never be interpreted as shell metacharacters. This single check
28
- // closes two review defects at once: (1) knownRepoRemoteUrl is host-agnostic
29
- // (see member-remote-url.ts), so without this a cross-host gitRepos entry
30
- // (e.g. a github.com URL) could be ls-remote'd and reported as an Azure
31
- // DevOps connectivity result -- a false success on the wrong host; (2) the
32
- // derived URL is interpolated into a command string executed on the member
33
- // (see below), so an unvalidated value is a command-injection vector. A bare
184
+ // when it is a well-formed Azure DevOps https repo URL -- modern
185
+ // "https://dev.azure.com/<org>/<project>/_git/<repo>" or legacy
186
+ // "https://<org>.visualstudio.com/[DefaultCollection/]<project>/_git/<repo>"
187
+ // -- with each segment restricted to characters that can never be
188
+ // interpreted as shell metacharacters (percent-escapes such as %20 in a
189
+ // project name are allowed; a bare '%' is not). This single check closes two
190
+ // review defects at once: (1) knownRepoRemoteUrl is host-agnostic (see
191
+ // member-remote-url.ts), so without this a cross-host gitRepos entry (e.g. a
192
+ // github.com URL) could be ls-remote'd and reported as an Azure DevOps
193
+ // connectivity result -- a false success on the wrong host; (2) the derived
194
+ // URL is interpolated into a command string executed on the member (see
195
+ // below), so an unvalidated value is a command-injection vector. A bare
34
196
  // org/project scope (the provision default, "https://dev.azure.com/<org>")
35
- // deliberately fails this check -- it is not a clonable repo.
36
- const AZURE_REPO_URL_RE = /^https:\/\/dev\.azure\.com\/[A-Za-z0-9._-]+\/[A-Za-z0-9._-]+\/_git\/[A-Za-z0-9._-]+$/;
197
+ // deliberately fails this check -- it is not a clonable repo. SSH remotes
198
+ // also fail it: `git ls-remote` over ssh would exercise the member's SSH key,
199
+ // not the PAT this provider just deployed.
200
+ const SAFE_URL_RE = /^https:\/\/(?:[A-Za-z0-9._-]|%[0-9A-Fa-f]{2})+(?:\/(?:[A-Za-z0-9._-]|%[0-9A-Fa-f]{2})+)+$/;
37
201
  function isValidAzureRepoUrl(url) {
38
- return AZURE_REPO_URL_RE.test(url);
202
+ if (!SAFE_URL_RE.test(url))
203
+ return false;
204
+ const ref = parseAzureDevOpsRemote(url);
205
+ return ref !== null && ref.transport === 'https';
39
206
  }
40
207
  export const azureDevOpsProvider = {
41
208
  // apra-fleet-5co8.3.2: moved VERBATIM out of the provider switch in
@@ -45,9 +212,10 @@ export const azureDevOpsProvider = {
45
212
  // The pat_expires_at check stays defence in depth behind the zod refine in
46
213
  // the tool schema: tool-registry casts the MCP payload with `as any`, so a
47
214
  // caller can bypass zod, and an unparseable expiry is worse than none at all
48
- // (NaN silences every checkVcsTokenExpiry comparison and makes
49
- // scheduleCredentialCleanup fall back to its 55-minute default, auto-revoking
50
- // the PAT that was just deployed).
215
+ // (NaN silences every checkVcsTokenExpiry comparison; scheduleCredentialCleanup
216
+ // treats an unparseable expiresAt the same as an absent one and skips
217
+ // scheduling entirely, so this rejection is about the silenced-warning
218
+ // half of the failure mode, not an auto-revoke risk).
51
219
  buildCredentials(input) {
52
220
  const azPat = input.pat ?? input.token;
53
221
  if (!input.org_url || !azPat)
@@ -69,7 +237,10 @@ export const azureDevOpsProvider = {
69
237
  },
70
238
  async deploy(_agent, cmds, exec, credentials, label, scopeUrl) {
71
239
  const creds = credentials;
72
- await exec(cmds.gitCredentialHelperWrite(HOST, PAT_USERNAME, creds.pat, label, scopeUrl));
240
+ // Bind the helper to the host git will actually ask for: the legacy
241
+ // host when the scope names one, dev.azure.com otherwise -- see
242
+ // credentialHostForScope().
243
+ await exec(cmds.gitCredentialHelperWrite(credentialHostForScope(scopeUrl), PAT_USERNAME, creds.pat, label, scopeUrl));
73
244
  return {
74
245
  success: true,
75
246
  message: 'Azure DevOps credentials deployed',
@@ -86,7 +257,7 @@ export const azureDevOpsProvider = {
86
257
  };
87
258
  },
88
259
  async revoke(_agent, cmds, exec, label, scopeUrl) {
89
- await exec(cmds.gitCredentialHelperRemove(HOST, label, scopeUrl));
260
+ await exec(cmds.gitCredentialHelperRemove(credentialHostForScope(scopeUrl), label, scopeUrl));
90
261
  return { success: true, message: 'Azure DevOps credentials revoked' };
91
262
  },
92
263
  // apra-fleet-5co8.5.2: replaces the unauthenticated curl-the-org-root stub
@@ -113,7 +113,7 @@ export interface VcsProviderService {
113
113
  * return a plain error string naming the fields it requires (apra-fleet-
114
114
  * 5co8.3.1). Pure/deterministic: validation and shaping only -- never
115
115
  * network, filesystem or credential-store access, all of which happen
116
- * before (secure-token resolution) or after (deploy) this call.
116
+ * before (secret-token resolution) or after (deploy) this call.
117
117
  *
118
118
  * OPTIONAL only while providers are migrated onto the seam one at a time;
119
119
  * the tool keeps its own switch for a provider that has not implemented it.
@@ -7,6 +7,7 @@ function git(folder, args) {
7
7
  encoding: 'utf-8',
8
8
  timeout: 5000,
9
9
  stdio: ['ignore', 'pipe', 'ignore'],
10
+ windowsHide: true,
10
11
  });
11
12
  const trimmed = out.trim();
12
13
  return trimmed.length > 0 ? trimmed : null;
@@ -13,7 +13,7 @@ Get the shape right before launching.
13
13
  | Field | Required | Type | Default | Notes |
14
14
  |-------|----------|------|---------|-------|
15
15
  | `issues` | **yes** | array of strings | -- | Beads issue IDs (sprint roots), e.g. `["BD-1","BD-2"]`. Must be non-empty; every entry a non-empty string. |
16
- | `branch` | **yes** | string | -- | Sprint branch name, e.g. `"feat/auth"`. Created from `origin/<base_branch>` if it does not exist. |
16
+ | `branch` | **yes** | string | -- | Sprint branch name, e.g. `"feat/auth"`. Created from `origin/<base_branch>` if it does not exist. Must differ from `base_branch`. |
17
17
  | `goal` | no | string | `"P1/P2"` | Exit when no open issues at or above this priority. Must be exactly `"P1"`, `"P1/P2"`, or `"P1/P2/P3"`. |
18
18
  | `max_cycles` | no | positive integer | `5` | Hard cycle ceiling. |
19
19
  | `base_branch` | no | string | `"main"` | PR target branch. |
@@ -70,7 +70,7 @@ explicit `branch`.
70
70
  1. **Issues exist and are open** -- `bd show <id>` for each root; a missing root hard-fails preflight.
71
71
  2. **Ready leaf work exists** -- at least some leaves under the roots are unblocked (`bd ready`); an all-blocked backlog deadlocks and aborts.
72
72
  3. **Branch name chosen** -- explicit `branch`, created if absent.
73
- 4. **`base_branch` is the intended PR target** (default `main`).
73
+ 4. **`base_branch` is the intended PR target** (default `main`) and must differ from `branch` -- an equal pair is rejected at launch.
74
74
  5. **Branching off latest main** -- the workflow fetches and cuts new branches from `origin/<base_branch>`; if fetch fails, launch fails. Make sure the remote is reachable.
75
75
 
76
76
  ## Common failures and the exact error you'll see
@@ -26,6 +26,9 @@ apra-fleet workflow fleet-sprint \
26
26
  [--viewer-port <port>] # default 8080
27
27
  [--budget <usd>] # default unlimited
28
28
  [--dispatch-timeout-s <s>] # default 9000
29
+ [--usage-limit-max-wait-s <s>] # usage-limit pause budget; default from role-policies
30
+ [--usage-limit-max-reprobes <n>]# usage-limit reprobe cap; default from role-policies
31
+ [--skip-regression] # skip the once-per-sprint regression pass
29
32
  [--sync] # synced-topology mode
30
33
  ```
31
34
 
@@ -42,6 +45,9 @@ on this list -- flags evolve and this skill can drift.
42
45
  is invisible to the scope filter no matter what you pass -- only true
43
46
  children are picked up. See the epics/manifest-bead guidance in
44
47
  `packages/apra-fleet-se/fleet-sprint/docs/README.md`.
48
+ - `--branch` must differ from `--base` (`main` vs `origin/main` or
49
+ `refs/heads/main` count as the same branch); an equal pair is rejected at
50
+ launch.
45
51
  - `--branch` is created from `--base` if it does not already exist. If it
46
52
  does exist (e.g. you are resuming), it is reused as-is.
47
53
  - **`--base` is resolved against the remote, not your local checkout.** A new
@@ -52,9 +58,20 @@ on this list -- flags evolve and this skill can drift.
52
58
  package.json script) fails in ways that look unrelated.
53
59
  - `--role-map` assigns specific members to specific roles, e.g.
54
60
  `--role-map '{"doer":["m1","m2"],"reviewer":["m3"]}'`. Accepts inline JSON
55
- or `@path/to/file.json`.
61
+ or `@path/to/file.json`. The `backlog` key names the member whose beads
62
+ clone the engine runs its own `bd`/`git` commands against. `orchestrator`
63
+ is its deprecated alias (works with a warning in 0.4.4, removed in v0.5) --
64
+ rename it to `backlog`. Without a `backlog` entry the engine picks a member
65
+ and logs `backlog: <member> (auto-selected: <reason>)`; check that line.
66
+ - `--skip-regression` skips the regression pass for this run. The skip is
67
+ logged and stated in the sprint analysis and the PR body.
56
68
  - `--goal` controls which bead priorities are in scope for the run.
57
69
  - `--budget` caps total spend in USD; the run aborts when it is exhausted.
70
+ - `--usage-limit-max-wait-s` / `--usage-limit-max-reprobes` bound how long a
71
+ dispatch that hit a provider usage/rate limit is paused (and re-probed on a
72
+ backoff ladder) before the run gives up with a typed abort. Both are
73
+ optional; omitted, the engine uses its own defaults. A resumed member
74
+ re-dispatches without consuming a retry attempt.
58
75
 
59
76
  ## Preconditions to check first
60
77
 
@@ -67,20 +84,45 @@ on this list -- flags evolve and this skill can drift.
67
84
  2. Every `--members` name is registered with the fleet (`list_members` /
68
85
  `mcp__apra-fleet__list_members`). An unregistered member aborts the
69
86
  sprint unless `--allow-missing-members` is passed.
70
- 3. Multi-member sprints require all members to share the same git topology
71
- unless `--sync` is passed. Stick to single-member unless that is
72
- verified -- see `fleet-sprint-diagram.md` in the package docs.
87
+ 3. Multi-member sprints align their members automatically: at launch every
88
+ member is fetched and checked out on the sprint branch (WIP preserved in a
89
+ named `fleet-sprint[<branch>]` stash, one `[Align]` line per member), so
90
+ do not align members by hand. The launch refuses, before moving any
91
+ member, only for an unreachable member, differing origin URLs, a base
92
+ missing on origin, a fetch auth failure or a diverged sprint branch --
93
+ fix what the message names and relaunch. See `fleet-sprint-diagram.md` in
94
+ the package docs.
73
95
  4. If a member's LLM session is stale or unauthenticated (dispatch fails
74
96
  with `empty_response`, or "member CLI likely died"), re-run
75
97
  `provision_llm_auth` for that member before retrying.
98
+ 5. Beads identity: before any `bd` mutation, the sprint probes every
99
+ member's `bd where`/`sync.remote`/git origin and prints a `Beads:`
100
+ banner plus one `beads ok: <member> ...` line per member. These abort
101
+ with `BeadsIdentityError` naming the member, cause and fix, before
102
+ anything is dispatched -- there is no bypass flag:
103
+ - MISMATCH: a field that resolved on both sides differs. Fix that
104
+ member's `workFolder` (wrong `.beads`) or its `sync.remote`.
105
+ - `bd` missing on a member (not installed or not on PATH). Fix: install
106
+ `bd` on that member or fix its PATH so `bd --version` works in its work
107
+ folder (re-running the member fleet install places it in the member's
108
+ fleet bin dir), then relaunch.
109
+ - BEADS_SETUP_FAILED: a member mapped to a beads-reading role had no beads
110
+ database (or no `sync.remote`), and setting it up from the expected
111
+ beads remote failed. Matching members are left untouched.
112
+ Any other probe failure (including no beads database on a member used
113
+ only for deployer/ci-watcher) is only a `[beads-identity] WARNING:` line (naming
114
+ the member, field, probe, error and the fix): that field is not compared
115
+ and the sprint proceeds -- read the warning and fix the member.
76
116
 
77
117
  ## Launching it
78
118
 
79
119
  Run this on your own orchestrating machine, not on a `--members` target --
80
120
  members are dispatch destinations, not where this command runs.
81
121
 
82
- Use the delivered `apra-fleet` binary (on PATH after `npm run build:binary`),
83
- and start it as a genuinely detached OS process. A harness-owned background
122
+ Use the installed `apra-fleet` binary. After `npm install -g` it is on
123
+ PATH; the standalone installer does not add it to PATH, so call it as
124
+ `~/.apra-fleet/bin/apra-fleet` (Windows: `$HOME\.apra-fleet\bin\apra-fleet.exe`).
125
+ Start it as a genuinely detached OS process. A harness-owned background
84
126
  task can be silently killed when its owning tool call's process group ends,
85
127
  which orphans the sprint mid-run.
86
128
 
@@ -59,7 +59,7 @@ order; a fourth phase runs once at sprint close.
59
59
  files bugs for failures). Skip the whole phase if either file is absent.
60
60
  - **Harvest** -- runs once after the cycle loop exits (goal met or cycle ceiling
61
61
  hit): poll CI via `ci-watcher`, run a final reviewer pass, then `harvester`
62
- extracts durable knowledge into `docs/` and `CHANGELOG`, and raise the PR.
62
+ extracts durable knowledge into `docs/` and README, and raise the PR.
63
63
 
64
64
  At the end of each cycle, check the **goal**: the sprint is done when no open
65
65
  beads issue in the sprint-root subtree sits at or above the goal priority (default
@@ -128,7 +128,7 @@ Dispatch these only when their condition holds:
128
128
  not configured / pending). [Fleet mode] PM may run `gh` CLI directly instead of
129
129
  dispatching (R13).
130
130
  - `harvester` -- in Harvest, at sprint close, to extract durable knowledge into
131
- `docs/` and update `CHANGELOG`.
131
+ `docs/` and update README.
132
132
 
133
133
  ## Tracks and parallelism
134
134
 
@@ -322,7 +322,7 @@ via `compose_permissions` using the same tag set before every dispatch. See
322
322
 
323
323
  When running via fleet, never pass raw secrets in `execute_prompt` prompts --
324
324
  reference the credential by name only (e.g. "authenticate using credential
325
- github_pat"). The member then uses `{{secure.github_pat}}` in its own
325
+ github_pat"). The member then uses `{{secret.github_pat}}` in its own
326
326
  `execute_command` calls. See `fleet-addendum.md` for the full reference.
327
327
 
328
328
  ## Provider awareness (fleet mode)
@@ -352,7 +352,7 @@ per cycle: Plan (planner writes beads tasks -> plan-reviewer loop) -> Develop
352
352
  (doer-review loop: bd ready -> claim -> close, to a clean APPROVED)
353
353
  -> Test (deploy + integ tests, if applicable)
354
354
  -> goal check -> next cycle | exit
355
- at close: Harvest (CI watch -> final review -> docs/CHANGELOG -> PR)
355
+ at close: Harvest (CI watch -> final review -> docs -> PR)
356
356
  ```
357
357
 
358
358
  For small, low-risk work (1-3 tasks, no phasing) use the lightweight path instead
@@ -116,9 +116,6 @@ At sprint close, after the harvester runs:
116
116
  startedAt, taskAssignments, logEntries)` and write the result back to
117
117
  `sprint-logs/calibration.json`. Commit it. This blends the actual token counts
118
118
  into the historical averages so future quotes improve.
119
- 4. **Update fleet token memory**: Parse the `tuple_averages` from the updated
120
- calibration object into a flat array: `const tokenEstimates = { averages: Object.values(updatedCalibration.historical?.tuple_averages || {}) }`. Then write it to the beads persistent memory:
121
- `bd remember '<json_string>' --key token-estimates-json`
122
119
 
123
120
  ## Sprint log
124
121
 
@@ -107,8 +107,8 @@ Use member_detail -> llmProvider to determine the target filename:
107
107
 
108
108
  Never pass raw secrets in execute_prompt prompts -- reference the credential by
109
109
  name only (e.g. "authenticate using credential github_pat"). The member then
110
- uses {{secure.github_pat}} in its own execute_command calls. The
111
- {{secure.NAME}} token is substituted at launch time -- reference it bare in
110
+ uses {{secret.github_pat}} in its own execute_command calls. The
111
+ {{secret.NAME}} token is substituted at launch time -- reference it bare in
112
112
  execute_command, not inside your own quotes (it is already single-quote-escaped
113
113
  by the fleet).
114
114
 
@@ -11,10 +11,12 @@ code_graph, code_impact, code_query, and code_context tools.
11
11
  the repo path.
12
12
  3. Run via `execute_command` (wrap in background Agent per fleet rules):
13
13
  ```
14
- npx gitnexus analyze --embeddings
14
+ npx gitnexus analyze --index-only --embeddings
15
15
  ```
16
16
  - `run_from`: project repo root
17
17
  - `timeout_s`: 300 (indexing large repos can take a minute)
18
+ - `--index-only` keeps the repo work tree clean: without it gitnexus
19
+ writes an AGENTS.md/CLAUDE.md block and skills folders into the repo.
18
20
  4. Report the result: nodes indexed, edges, flows (gitnexus prints this on
19
21
  completion). If gitnexus is not installed, it will be fetched automatically
20
22
  via npx.
@@ -42,7 +44,7 @@ code_graph, code_impact, code_query, and code_context tools.
42
44
 
43
45
  - **Automatically inside `/pm init`** -- runs as the final step of project initialization.
44
46
  The worktree must exist before indexing (gitnexus needs files on disk to analyze).
45
- - **Automatically at VERIFY checkpoints** -- checkpoints re-run npx gitnexus analyze to keep
47
+ - **Automatically at VERIFY checkpoints** -- checkpoints re-run npx gitnexus analyze --index-only to keep
46
48
  mid-sprint symbols visible to later phases (incremental via fileHashes in .gitnexus/meta.json,
47
49
  takes seconds).
48
50
  - After a large merge or rebase that changes many files
@@ -4,7 +4,8 @@ Reconcile a warm local KB against a merged bible after two or more branches
4
4
  land -- absorb the incoming knowledge, revive entries whose basis matches
5
5
  the merged worktree again, mechanically settle contradictions a file hash
6
6
  can decide, and dispatch a reconciler agent for the rest. Ends with the
7
- canonical bible re-exported so the merged branch's KB reflects merged truth.
7
+ canonical bible re-exported: confirmed entries whose cited files still match
8
+ their hash basis are added, so the merged branch's bible gains the merged truth.
8
9
 
9
10
  ## When to run
10
11
 
@@ -28,19 +29,26 @@ already-exposed `kb_promote` surface (which can walk any entry
28
29
  way -- a bible can never smuggle an active directive; activation stays
29
30
  CLI-only (`apra-fleet kb approve-directive`).
30
31
 
32
+ Run every step of this command from the operator's own session, not a fleet
33
+ member session: a member session without the engine's kb_maintainer grant is
34
+ refused an explicit `kb_import` path (`E-KB-MAINTAINER-REQUIRED`) and is not
35
+ served `kb_reconcile_prefilter`, `kb_resolve_contradiction` or `kb_export`.
36
+
31
37
  ## Steps
32
38
 
33
39
  ### Step 1: Import the merged bible
34
40
 
35
41
  ```
36
- kb_import({ repo: "<merged worktree path>" })
42
+ kb_import({ path: "<merged worktree path>/.fleet/kb-canonical.json" })
37
43
  ```
38
44
 
39
- or the CLI equivalent, `apra-fleet kb import --repo <path>`, for a human
40
- running this post-merge by hand. Omit `path` to resolve
41
- `<repo>/.fleet/kb-canonical.json` (the trusted channel); pass an explicit
42
- `path` only when importing a bible from somewhere else (caller-asserted
43
- trust, see above).
45
+ or the CLI equivalent, `apra-fleet kb import --path <file>`, for a human
46
+ running this post-merge by hand. `path` names the bible FILE only: kb tools
47
+ take no repo/scope argument and always write the calling session's own KB (a
48
+ member session uses its registered work folder; any other session the fleet
49
+ server's working folder). Omitting `path` resolves
50
+ `<own folder>/.fleet/kb-canonical.json` (the trusted channel); a bible from
51
+ anywhere else is caller-asserted trust (see above).
44
52
 
45
53
  Report: `{ imported, skipped, linked, flagged, sweep }`. `kb_import`
46
54
  already runs a freshness sweep internally at the end of its own run, scoped
@@ -92,11 +100,13 @@ Report: `{ pairs, resolved, left_for_agent, skipped_directive }`.
92
100
 
93
101
  If `left_for_agent` is non-empty, dispatch the `kb-reconciler` agent
94
102
  (`agents/kb-reconciler.md`, model tier cheap/standard)
95
- with that array. It reads the MERGED code via `code_context`/`code_impact`/
103
+ with that array, as a subagent of THIS session -- never on a fleet member: a
104
+ member session is not served `kb_resolve_contradiction` or `kb_export`, so the
105
+ agent would stop at its tool check. It reads the MERGED code via `code_context`/`code_impact`/
96
106
  `code_query` (never Glob/Grep) for each remaining pair, resolves what the
97
107
  code decides via `kb_resolve_contradiction`, falls back to a trust-tier
98
108
  tiebreak (`CONFIRMED > INFERRED > UNVERIFIED`) when the code is silent, and
99
- leaves genuinely undecidable pairs flagged for `/pm kb-review`. Active
109
+ leaves genuinely undecidable pairs flagged for `/pm kb-review`. Any `kb_query`/`kb_list` lookup of a pair's entries must pass an explicit `confidence: ["CONFIRMED", "INFERRED", "UNVERIFIED"]` list: the read tools default to CONFIRMED undisputed entries only, and a disputed or unpromoted side would otherwise be invisible (`kb_query({ flagged_only: true })` is exempt). Active
100
110
  user-directives are NEVER auto-retired. See `agents/kb-reconciler.md` for the
101
111
  full process and the single-write-path rule.
102
112
 
@@ -108,11 +118,16 @@ If `left_for_agent` is empty, skip straight to Step 5.
108
118
  kb_export()
109
119
  ```
110
120
 
111
- Writes every live `CONFIRMED` project entry -- which now includes every
112
- mechanical and agent-resolved winner -- to `.fleet/kb-canonical.json` and
113
- auto-commits it (pathspec-only, identity `pm-kb`, non-fatal on any git
114
- failure). This is existing `kb_export` machinery; no new commit step is
115
- needed here. Push is not automatic; it rides the normal sprint push cadence.
121
+ ADDS to `.fleet/kb-canonical.json` every live `CONFIRMED` project entry not
122
+ already in it whose cited files still match its recorded hash basis -- which
123
+ includes the mechanical and agent-resolved winners -- and auto-commits it
124
+ (pathspec-only, identity `pm-kb`, non-fatal on any git failure). This is
125
+ existing `kb_export` machinery; no new commit step is needed here. Push is
126
+ not automatic; it rides the normal sprint push cadence.
127
+
128
+ The export never removes or rewrites an entry already in the bible: a
129
+ superseded loser, or an entry later retired, stays there after re-export and
130
+ must be removed by hand.
116
131
 
117
132
  ## Report
118
133
 
@@ -21,6 +21,7 @@ Call `kb_query(flagged_only=true)`.
21
21
 
22
22
  - If the response says "No flagged contradictions found -- KB is clean.", report that to the user and stop.
23
23
  - Otherwise, collect all returned entries.
24
+ - `flagged_only` is exempt from the default CONFIRMED-only read filter, so it returns disputed entries of every tier. If you need to look up any other entry (for example a counterpart that is not in the flagged list), a plain `kb_query`/`kb_list` returns only CONFIRMED undisputed entries by default -- pass an explicit `confidence: ["CONFIRMED", "INFERRED", "UNVERIFIED"]` list to see the rest.
24
25
 
25
26
  ### Step 2: Group into contradiction pairs
26
27