@apralabs/apra-fleet 0.4.0 → 0.4.2

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 (548) hide show
  1. package/README.md +159 -13
  2. package/dist/agents/backlog-groomer.md +31 -19
  3. package/dist/agents/ci-watcher.md +16 -1
  4. package/dist/agents/deployer.md +37 -47
  5. package/dist/agents/doer.md +147 -114
  6. package/dist/agents/harvester.md +41 -34
  7. package/dist/agents/integ-test-runner.md +98 -114
  8. package/dist/agents/kb-reconciler.md +205 -0
  9. package/dist/agents/plan-reviewer.md +45 -44
  10. package/dist/agents/planner.md +121 -50
  11. package/dist/agents/regression-test-runner.md +84 -81
  12. package/dist/agents/reviewer.md +118 -44
  13. package/dist/agents/schemas/doer-output.json +63 -3
  14. package/dist/agents/schemas/harvester-output.json +59 -2
  15. package/dist/agents/schemas/integ-test-runner-output.json +3 -3
  16. package/dist/agents/schemas/kb-reconciler-output.json +87 -0
  17. package/dist/agents/schemas/planner-output.json +65 -0
  18. package/dist/agents/schemas/regression-test-runner-output.json +4 -17
  19. package/dist/agents/schemas/reviewer-output.json +105 -8
  20. package/dist/cli/auth.d.ts.map +1 -1
  21. package/dist/cli/auth.js +1 -2
  22. package/dist/cli/auth.js.map +1 -1
  23. package/dist/cli/config.d.ts +3 -3
  24. package/dist/cli/config.d.ts.map +1 -1
  25. package/dist/cli/config.js +4 -13
  26. package/dist/cli/config.js.map +1 -1
  27. package/dist/cli/install.d.ts +1 -0
  28. package/dist/cli/install.d.ts.map +1 -1
  29. package/dist/cli/install.js +141 -44
  30. package/dist/cli/install.js.map +1 -1
  31. package/dist/cli/join.js +1 -1
  32. package/dist/cli/join.js.map +1 -1
  33. package/dist/cli/kb-commit.d.ts +12 -0
  34. package/dist/cli/kb-commit.d.ts.map +1 -0
  35. package/dist/cli/kb-commit.js +53 -0
  36. package/dist/cli/kb-commit.js.map +1 -0
  37. package/dist/cli/kb-directives.d.ts +17 -0
  38. package/dist/cli/kb-directives.d.ts.map +1 -0
  39. package/dist/cli/kb-directives.js +146 -0
  40. package/dist/cli/kb-directives.js.map +1 -0
  41. package/dist/cli/kb-import.d.ts +13 -0
  42. package/dist/cli/kb-import.d.ts.map +1 -0
  43. package/dist/cli/kb-import.js +56 -0
  44. package/dist/cli/kb-import.js.map +1 -0
  45. package/dist/cli/register-member.js +1 -1
  46. package/dist/cli/start.d.ts.map +1 -1
  47. package/dist/cli/start.js +7 -0
  48. package/dist/cli/start.js.map +1 -1
  49. package/dist/cli/uninstall.d.ts.map +1 -1
  50. package/dist/cli/uninstall.js +16 -3
  51. package/dist/cli/uninstall.js.map +1 -1
  52. package/dist/cli/watch.d.ts +76 -4
  53. package/dist/cli/watch.d.ts.map +1 -1
  54. package/dist/cli/watch.js +150 -17
  55. package/dist/cli/watch.js.map +1 -1
  56. package/dist/commands/kb-server.d.ts +8 -0
  57. package/dist/commands/kb-server.d.ts.map +1 -0
  58. package/dist/commands/kb-server.js +221 -0
  59. package/dist/commands/kb-server.js.map +1 -0
  60. package/dist/index.js +77 -2
  61. package/dist/index.js.map +1 -1
  62. package/dist/os/git-bash-candidates.d.ts +35 -0
  63. package/dist/os/git-bash-candidates.d.ts.map +1 -0
  64. package/dist/os/git-bash-candidates.js +46 -0
  65. package/dist/os/git-bash-candidates.js.map +1 -0
  66. package/dist/os/index.d.ts +13 -4
  67. package/dist/os/index.d.ts.map +1 -1
  68. package/dist/os/index.js +17 -2
  69. package/dist/os/index.js.map +1 -1
  70. package/dist/os/linux.d.ts +1 -0
  71. package/dist/os/linux.d.ts.map +1 -1
  72. package/dist/os/linux.js +19 -2
  73. package/dist/os/linux.js.map +1 -1
  74. package/dist/os/os-commands.d.ts +12 -0
  75. package/dist/os/os-commands.d.ts.map +1 -1
  76. package/dist/os/os-commands.js.map +1 -1
  77. package/dist/os/windows-gitbash.d.ts +93 -0
  78. package/dist/os/windows-gitbash.d.ts.map +1 -0
  79. package/dist/os/windows-gitbash.js +244 -0
  80. package/dist/os/windows-gitbash.js.map +1 -0
  81. package/dist/os/windows.d.ts +35 -0
  82. package/dist/os/windows.d.ts.map +1 -1
  83. package/dist/os/windows.js +93 -35
  84. package/dist/os/windows.js.map +1 -1
  85. package/dist/providers/agy.d.ts +15 -3
  86. package/dist/providers/agy.d.ts.map +1 -1
  87. package/dist/providers/agy.js +145 -11
  88. package/dist/providers/agy.js.map +1 -1
  89. package/dist/providers/claude.d.ts +14 -3
  90. package/dist/providers/claude.d.ts.map +1 -1
  91. package/dist/providers/claude.js +69 -22
  92. package/dist/providers/claude.js.map +1 -1
  93. package/dist/providers/codex.d.ts +14 -3
  94. package/dist/providers/codex.d.ts.map +1 -1
  95. package/dist/providers/codex.js +34 -8
  96. package/dist/providers/codex.js.map +1 -1
  97. package/dist/providers/copilot.d.ts +14 -3
  98. package/dist/providers/copilot.d.ts.map +1 -1
  99. package/dist/providers/copilot.js +33 -8
  100. package/dist/providers/copilot.js.map +1 -1
  101. package/dist/providers/email/headers.d.ts +15 -0
  102. package/dist/providers/email/headers.d.ts.map +1 -0
  103. package/dist/providers/email/headers.js +42 -0
  104. package/dist/providers/email/headers.js.map +1 -0
  105. package/dist/providers/email/index.d.ts +18 -0
  106. package/dist/providers/email/index.d.ts.map +1 -0
  107. package/dist/providers/email/index.js +60 -0
  108. package/dist/providers/email/index.js.map +1 -0
  109. package/dist/providers/email/provider.d.ts +49 -0
  110. package/dist/providers/email/provider.d.ts.map +1 -0
  111. package/dist/providers/email/provider.js +2 -0
  112. package/dist/providers/email/provider.js.map +1 -0
  113. package/dist/providers/email/sendgrid.d.ts +12 -0
  114. package/dist/providers/email/sendgrid.d.ts.map +1 -0
  115. package/dist/providers/email/sendgrid.js +67 -0
  116. package/dist/providers/email/sendgrid.js.map +1 -0
  117. package/dist/providers/email/smtp.d.ts +65 -0
  118. package/dist/providers/email/smtp.d.ts.map +1 -0
  119. package/dist/providers/email/smtp.js +373 -0
  120. package/dist/providers/email/smtp.js.map +1 -0
  121. package/dist/providers/index.d.ts +0 -1
  122. package/dist/providers/index.d.ts.map +1 -1
  123. package/dist/providers/index.js +0 -3
  124. package/dist/providers/index.js.map +1 -1
  125. package/dist/providers/none.d.ts +14 -3
  126. package/dist/providers/none.d.ts.map +1 -1
  127. package/dist/providers/none.js +26 -2
  128. package/dist/providers/none.js.map +1 -1
  129. package/dist/providers/opencode.d.ts +14 -3
  130. package/dist/providers/opencode.d.ts.map +1 -1
  131. package/dist/providers/opencode.js +60 -6
  132. package/dist/providers/opencode.js.map +1 -1
  133. package/dist/providers/provider.d.ts +91 -5
  134. package/dist/providers/provider.d.ts.map +1 -1
  135. package/dist/providers/provider.js +45 -1
  136. package/dist/providers/provider.js.map +1 -1
  137. package/dist/services/agent-provisioner.d.ts.map +1 -1
  138. package/dist/services/agent-provisioner.js +5 -8
  139. package/dist/services/agent-provisioner.js.map +1 -1
  140. package/dist/services/cloud/activity.js +2 -2
  141. package/dist/services/cloud/activity.js.map +1 -1
  142. package/dist/services/cloud/lifecycle.d.ts.map +1 -1
  143. package/dist/services/cloud/lifecycle.js +3 -0
  144. package/dist/services/cloud/lifecycle.js.map +1 -1
  145. package/dist/services/cloud/task-wrapper.d.ts +18 -0
  146. package/dist/services/cloud/task-wrapper.d.ts.map +1 -1
  147. package/dist/services/cloud/task-wrapper.js +157 -0
  148. package/dist/services/cloud/task-wrapper.js.map +1 -1
  149. package/dist/services/context-admission.d.ts.map +1 -1
  150. package/dist/services/context-admission.js +9 -7
  151. package/dist/services/context-admission.js.map +1 -1
  152. package/dist/services/credential-cleanup.d.ts.map +1 -1
  153. package/dist/services/credential-cleanup.js +22 -3
  154. package/dist/services/credential-cleanup.js.map +1 -1
  155. package/dist/services/github-app.d.ts.map +1 -1
  156. package/dist/services/github-app.js +11 -2
  157. package/dist/services/github-app.js.map +1 -1
  158. package/dist/services/knowledge/audn.d.ts +37 -0
  159. package/dist/services/knowledge/audn.d.ts.map +1 -0
  160. package/dist/services/knowledge/audn.js +219 -0
  161. package/dist/services/knowledge/audn.js.map +1 -0
  162. package/dist/services/knowledge/file-hash.d.ts +11 -0
  163. package/dist/services/knowledge/file-hash.d.ts.map +1 -0
  164. package/dist/services/knowledge/file-hash.js +123 -0
  165. package/dist/services/knowledge/file-hash.js.map +1 -0
  166. package/dist/services/knowledge/http-provider.d.ts +46 -0
  167. package/dist/services/knowledge/http-provider.d.ts.map +1 -0
  168. package/dist/services/knowledge/http-provider.js +254 -0
  169. package/dist/services/knowledge/http-provider.js.map +1 -0
  170. package/dist/services/knowledge/kb-providers.d.ts +15 -0
  171. package/dist/services/knowledge/kb-providers.d.ts.map +1 -0
  172. package/dist/services/knowledge/kb-providers.js +92 -0
  173. package/dist/services/knowledge/kb-providers.js.map +1 -0
  174. package/dist/services/knowledge/kb-scope-input.d.ts +5 -0
  175. package/dist/services/knowledge/kb-scope-input.d.ts.map +1 -0
  176. package/dist/services/knowledge/kb-scope-input.js +11 -0
  177. package/dist/services/knowledge/kb-scope-input.js.map +1 -0
  178. package/dist/services/knowledge/kb-service.d.ts +3 -0
  179. package/dist/services/knowledge/kb-service.d.ts.map +1 -0
  180. package/dist/services/knowledge/kb-service.js +2 -0
  181. package/dist/services/knowledge/kb-service.js.map +1 -0
  182. package/dist/services/knowledge/path-validation.d.ts +2 -0
  183. package/dist/services/knowledge/path-validation.d.ts.map +1 -0
  184. package/dist/services/knowledge/path-validation.js +13 -0
  185. package/dist/services/knowledge/path-validation.js.map +1 -0
  186. package/dist/services/knowledge/pre-init.d.ts +14 -0
  187. package/dist/services/knowledge/pre-init.d.ts.map +1 -0
  188. package/dist/services/knowledge/pre-init.js +147 -0
  189. package/dist/services/knowledge/pre-init.js.map +1 -0
  190. package/dist/services/knowledge/project-slug.d.ts +2 -0
  191. package/dist/services/knowledge/project-slug.d.ts.map +1 -0
  192. package/dist/services/knowledge/project-slug.js +49 -0
  193. package/dist/services/knowledge/project-slug.js.map +1 -0
  194. package/dist/services/knowledge/sqlite-provider.d.ts +147 -0
  195. package/dist/services/knowledge/sqlite-provider.d.ts.map +1 -0
  196. package/dist/services/knowledge/sqlite-provider.js +1646 -0
  197. package/dist/services/knowledge/sqlite-provider.js.map +1 -0
  198. package/dist/services/knowledge/types.d.ts +163 -0
  199. package/dist/services/knowledge/types.d.ts.map +1 -0
  200. package/dist/services/knowledge/types.js +9 -0
  201. package/dist/services/knowledge/types.js.map +1 -0
  202. package/dist/services/member-home.d.ts +89 -0
  203. package/dist/services/member-home.d.ts.map +1 -0
  204. package/dist/services/member-home.js +259 -0
  205. package/dist/services/member-home.js.map +1 -0
  206. package/dist/services/member-remote-url.d.ts +34 -0
  207. package/dist/services/member-remote-url.d.ts.map +1 -0
  208. package/dist/services/member-remote-url.js +39 -0
  209. package/dist/services/member-remote-url.js.map +1 -0
  210. package/dist/services/model-pricing.d.ts.map +1 -1
  211. package/dist/services/model-pricing.js +0 -5
  212. package/dist/services/model-pricing.js.map +1 -1
  213. package/dist/services/orphan-recovery.d.ts +9 -3
  214. package/dist/services/orphan-recovery.d.ts.map +1 -1
  215. package/dist/services/orphan-recovery.js +22 -8
  216. package/dist/services/orphan-recovery.js.map +1 -1
  217. package/dist/services/preflight-check.d.ts +56 -0
  218. package/dist/services/preflight-check.d.ts.map +1 -0
  219. package/dist/services/preflight-check.js +277 -0
  220. package/dist/services/preflight-check.js.map +1 -0
  221. package/dist/services/shell-probe.d.ts +131 -0
  222. package/dist/services/shell-probe.d.ts.map +1 -0
  223. package/dist/services/shell-probe.js +210 -0
  224. package/dist/services/shell-probe.js.map +1 -0
  225. package/dist/services/singleton.d.ts +2 -0
  226. package/dist/services/singleton.d.ts.map +1 -1
  227. package/dist/services/singleton.js +1 -1
  228. package/dist/services/singleton.js.map +1 -1
  229. package/dist/services/ssh.js +2 -2
  230. package/dist/services/ssh.js.map +1 -1
  231. package/dist/services/stall/find-log-file.d.ts.map +1 -1
  232. package/dist/services/stall/find-log-file.js +22 -16
  233. package/dist/services/stall/find-log-file.js.map +1 -1
  234. package/dist/services/stall/log-path-resolver.d.ts +11 -8
  235. package/dist/services/stall/log-path-resolver.d.ts.map +1 -1
  236. package/dist/services/stall/log-path-resolver.js +17 -40
  237. package/dist/services/stall/log-path-resolver.js.map +1 -1
  238. package/dist/services/stall/read-log-tail.d.ts.map +1 -1
  239. package/dist/services/stall/read-log-tail.js +6 -5
  240. package/dist/services/stall/read-log-tail.js.map +1 -1
  241. package/dist/services/stall/stall-detector.d.ts +32 -0
  242. package/dist/services/stall/stall-detector.d.ts.map +1 -1
  243. package/dist/services/stall/stall-detector.js +149 -6
  244. package/dist/services/stall/stall-detector.js.map +1 -1
  245. package/dist/services/stall/stall-poller.d.ts +34 -0
  246. package/dist/services/stall/stall-poller.d.ts.map +1 -1
  247. package/dist/services/stall/stall-poller.js +160 -35
  248. package/dist/services/stall/stall-poller.js.map +1 -1
  249. package/dist/services/strategy.d.ts +9 -0
  250. package/dist/services/strategy.d.ts.map +1 -1
  251. package/dist/services/strategy.js +41 -7
  252. package/dist/services/strategy.js.map +1 -1
  253. package/dist/services/tool-registry.d.ts.map +1 -1
  254. package/dist/services/tool-registry.js +87 -1
  255. package/dist/services/tool-registry.js.map +1 -1
  256. package/dist/services/user-config.js +1 -1
  257. package/dist/services/user-config.js.map +1 -1
  258. package/dist/services/vcs/azure-devops.d.ts +1 -1
  259. package/dist/services/vcs/azure-devops.d.ts.map +1 -1
  260. package/dist/services/vcs/azure-devops.js +105 -10
  261. package/dist/services/vcs/azure-devops.js.map +1 -1
  262. package/dist/services/vcs/bitbucket.d.ts.map +1 -1
  263. package/dist/services/vcs/bitbucket.js +16 -0
  264. package/dist/services/vcs/bitbucket.js.map +1 -1
  265. package/dist/services/vcs/github.d.ts.map +1 -1
  266. package/dist/services/vcs/github.js +56 -1
  267. package/dist/services/vcs/github.js.map +1 -1
  268. package/dist/services/vcs/types.d.ts +123 -2
  269. package/dist/services/vcs/types.d.ts.map +1 -1
  270. package/dist/services/version-check.d.ts +22 -0
  271. package/dist/services/version-check.d.ts.map +1 -0
  272. package/dist/services/version-check.js +103 -0
  273. package/dist/services/version-check.js.map +1 -0
  274. package/dist/skills/fleet-sprint-cli/SKILL.md +15 -3
  275. package/dist/skills/pm/SKILL.md +0 -1
  276. package/dist/skills/pm/beads.md +6 -0
  277. package/dist/skills/pm/cost.md +0 -1
  278. package/dist/skills/pm/fleet-addendum.md +6 -1
  279. package/dist/skills/pm/index.md +56 -0
  280. package/dist/skills/pm/kb-reconcile.md +132 -0
  281. package/dist/skills/pm/kb-review.md +109 -0
  282. package/dist/tools/check-status.d.ts +47 -0
  283. package/dist/tools/check-status.d.ts.map +1 -1
  284. package/dist/tools/check-status.js +245 -3
  285. package/dist/tools/check-status.js.map +1 -1
  286. package/dist/tools/child-id-allocator.d.ts +2 -2
  287. package/dist/tools/cloud-control.js +2 -2
  288. package/dist/tools/cloud-control.js.map +1 -1
  289. package/dist/tools/code-intelligence-codebase-memory.d.ts +11 -0
  290. package/dist/tools/code-intelligence-codebase-memory.d.ts.map +1 -0
  291. package/dist/tools/code-intelligence-codebase-memory.js +270 -0
  292. package/dist/tools/code-intelligence-codebase-memory.js.map +1 -0
  293. package/dist/tools/code-intelligence-freshness.d.ts +2 -0
  294. package/dist/tools/code-intelligence-freshness.d.ts.map +1 -0
  295. package/dist/tools/code-intelligence-freshness.js +26 -0
  296. package/dist/tools/code-intelligence-freshness.js.map +1 -0
  297. package/dist/tools/code-intelligence-gitnexus.d.ts +14 -0
  298. package/dist/tools/code-intelligence-gitnexus.d.ts.map +1 -0
  299. package/dist/tools/code-intelligence-gitnexus.js +475 -0
  300. package/dist/tools/code-intelligence-gitnexus.js.map +1 -0
  301. package/dist/tools/code-intelligence-kb-enrich.d.ts +2 -0
  302. package/dist/tools/code-intelligence-kb-enrich.d.ts.map +1 -0
  303. package/dist/tools/code-intelligence-kb-enrich.js +65 -0
  304. package/dist/tools/code-intelligence-kb-enrich.js.map +1 -0
  305. package/dist/tools/code-intelligence-reindex.d.ts +7 -0
  306. package/dist/tools/code-intelligence-reindex.d.ts.map +1 -0
  307. package/dist/tools/code-intelligence-reindex.js +106 -0
  308. package/dist/tools/code-intelligence-reindex.js.map +1 -0
  309. package/dist/tools/code-intelligence-telemetry.d.ts +5 -0
  310. package/dist/tools/code-intelligence-telemetry.d.ts.map +1 -0
  311. package/dist/tools/code-intelligence-telemetry.js +52 -0
  312. package/dist/tools/code-intelligence-telemetry.js.map +1 -0
  313. package/dist/tools/code-intelligence-tests.d.ts +2 -0
  314. package/dist/tools/code-intelligence-tests.d.ts.map +1 -0
  315. package/dist/tools/code-intelligence-tests.js +24 -0
  316. package/dist/tools/code-intelligence-tests.js.map +1 -0
  317. package/dist/tools/code-intelligence.d.ts +114 -0
  318. package/dist/tools/code-intelligence.d.ts.map +1 -0
  319. package/dist/tools/code-intelligence.js +124 -0
  320. package/dist/tools/code-intelligence.js.map +1 -0
  321. package/dist/tools/compose-permissions.d.ts +26 -0
  322. package/dist/tools/compose-permissions.d.ts.map +1 -1
  323. package/dist/tools/compose-permissions.js +257 -33
  324. package/dist/tools/compose-permissions.js.map +1 -1
  325. package/dist/tools/execute-command.d.ts +2 -0
  326. package/dist/tools/execute-command.d.ts.map +1 -1
  327. package/dist/tools/execute-command.js +114 -28
  328. package/dist/tools/execute-command.js.map +1 -1
  329. package/dist/tools/execute-prompt.d.ts +13 -1
  330. package/dist/tools/execute-prompt.d.ts.map +1 -1
  331. package/dist/tools/execute-prompt.js +310 -61
  332. package/dist/tools/execute-prompt.js.map +1 -1
  333. package/dist/tools/kb-capture.d.ts +53 -0
  334. package/dist/tools/kb-capture.d.ts.map +1 -0
  335. package/dist/tools/kb-capture.js +130 -0
  336. package/dist/tools/kb-capture.js.map +1 -0
  337. package/dist/tools/kb-context.d.ts +17 -0
  338. package/dist/tools/kb-context.d.ts.map +1 -0
  339. package/dist/tools/kb-context.js +29 -0
  340. package/dist/tools/kb-context.js.map +1 -0
  341. package/dist/tools/kb-export.d.ts +19 -0
  342. package/dist/tools/kb-export.d.ts.map +1 -0
  343. package/dist/tools/kb-export.js +344 -0
  344. package/dist/tools/kb-export.js.map +1 -0
  345. package/dist/tools/kb-feedback.d.ts +23 -0
  346. package/dist/tools/kb-feedback.d.ts.map +1 -0
  347. package/dist/tools/kb-feedback.js +43 -0
  348. package/dist/tools/kb-feedback.js.map +1 -0
  349. package/dist/tools/kb-freshness-sweep.d.ts +14 -0
  350. package/dist/tools/kb-freshness-sweep.d.ts.map +1 -0
  351. package/dist/tools/kb-freshness-sweep.js +29 -0
  352. package/dist/tools/kb-freshness-sweep.js.map +1 -0
  353. package/dist/tools/kb-harvest.d.ts +20 -0
  354. package/dist/tools/kb-harvest.d.ts.map +1 -0
  355. package/dist/tools/kb-harvest.js +143 -0
  356. package/dist/tools/kb-harvest.js.map +1 -0
  357. package/dist/tools/kb-import.d.ts +44 -0
  358. package/dist/tools/kb-import.d.ts.map +1 -0
  359. package/dist/tools/kb-import.js +239 -0
  360. package/dist/tools/kb-import.js.map +1 -0
  361. package/dist/tools/kb-invalidate.d.ts +19 -0
  362. package/dist/tools/kb-invalidate.d.ts.map +1 -0
  363. package/dist/tools/kb-invalidate.js +34 -0
  364. package/dist/tools/kb-invalidate.js.map +1 -0
  365. package/dist/tools/kb-list.d.ts +32 -0
  366. package/dist/tools/kb-list.d.ts.map +1 -0
  367. package/dist/tools/kb-list.js +43 -0
  368. package/dist/tools/kb-list.js.map +1 -0
  369. package/dist/tools/kb-promote.d.ts +20 -0
  370. package/dist/tools/kb-promote.d.ts.map +1 -0
  371. package/dist/tools/kb-promote.js +20 -0
  372. package/dist/tools/kb-promote.js.map +1 -0
  373. package/dist/tools/kb-query.d.ts +35 -0
  374. package/dist/tools/kb-query.d.ts.map +1 -0
  375. package/dist/tools/kb-query.js +111 -0
  376. package/dist/tools/kb-query.js.map +1 -0
  377. package/dist/tools/kb-reconcile-prefilter.d.ts +14 -0
  378. package/dist/tools/kb-reconcile-prefilter.d.ts.map +1 -0
  379. package/dist/tools/kb-reconcile-prefilter.js +26 -0
  380. package/dist/tools/kb-reconcile-prefilter.js.map +1 -0
  381. package/dist/tools/kb-resolve-contradiction.d.ts +23 -0
  382. package/dist/tools/kb-resolve-contradiction.d.ts.map +1 -0
  383. package/dist/tools/kb-resolve-contradiction.js +37 -0
  384. package/dist/tools/kb-resolve-contradiction.js.map +1 -0
  385. package/dist/tools/kb-session-prime.d.ts +26 -0
  386. package/dist/tools/kb-session-prime.d.ts.map +1 -0
  387. package/dist/tools/kb-session-prime.js +392 -0
  388. package/dist/tools/kb-session-prime.js.map +1 -0
  389. package/dist/tools/kb-setup.d.ts +20 -0
  390. package/dist/tools/kb-setup.d.ts.map +1 -0
  391. package/dist/tools/kb-setup.js +49 -0
  392. package/dist/tools/kb-setup.js.map +1 -0
  393. package/dist/tools/kb-stats.d.ts +20 -0
  394. package/dist/tools/kb-stats.d.ts.map +1 -0
  395. package/dist/tools/kb-stats.js +115 -0
  396. package/dist/tools/kb-stats.js.map +1 -0
  397. package/dist/tools/list-members.d.ts.map +1 -1
  398. package/dist/tools/list-members.js +6 -2
  399. package/dist/tools/list-members.js.map +1 -1
  400. package/dist/tools/member-detail.d.ts.map +1 -1
  401. package/dist/tools/member-detail.js +13 -3
  402. package/dist/tools/member-detail.js.map +1 -1
  403. package/dist/tools/member-reservation.d.ts.map +1 -1
  404. package/dist/tools/member-reservation.js +13 -1
  405. package/dist/tools/member-reservation.js.map +1 -1
  406. package/dist/tools/monitor-task.d.ts.map +1 -1
  407. package/dist/tools/monitor-task.js +38 -5
  408. package/dist/tools/monitor-task.js.map +1 -1
  409. package/dist/tools/provision-auth.d.ts.map +1 -1
  410. package/dist/tools/provision-auth.js +15 -8
  411. package/dist/tools/provision-auth.js.map +1 -1
  412. package/dist/tools/provision-vcs-auth.d.ts +5 -2
  413. package/dist/tools/provision-vcs-auth.d.ts.map +1 -1
  414. package/dist/tools/provision-vcs-auth.js +58 -52
  415. package/dist/tools/provision-vcs-auth.js.map +1 -1
  416. package/dist/tools/register-member.d.ts +21 -12
  417. package/dist/tools/register-member.d.ts.map +1 -1
  418. package/dist/tools/register-member.js +70 -3
  419. package/dist/tools/register-member.js.map +1 -1
  420. package/dist/tools/remove-member.d.ts.map +1 -1
  421. package/dist/tools/remove-member.js +19 -5
  422. package/dist/tools/remove-member.js.map +1 -1
  423. package/dist/tools/report-status.d.ts.map +1 -1
  424. package/dist/tools/report-status.js +2 -1
  425. package/dist/tools/report-status.js.map +1 -1
  426. package/dist/tools/revoke-vcs-auth.js +2 -2
  427. package/dist/tools/revoke-vcs-auth.js.map +1 -1
  428. package/dist/tools/send-email.d.ts +69 -0
  429. package/dist/tools/send-email.d.ts.map +1 -0
  430. package/dist/tools/send-email.js +177 -0
  431. package/dist/tools/send-email.js.map +1 -0
  432. package/dist/tools/setup-ssh-key.d.ts.map +1 -1
  433. package/dist/tools/setup-ssh-key.js +4 -1
  434. package/dist/tools/setup-ssh-key.js.map +1 -1
  435. package/dist/tools/stop-prompt.js +2 -2
  436. package/dist/tools/stop-prompt.js.map +1 -1
  437. package/dist/tools/update-agent-cli.js +2 -2
  438. package/dist/tools/update-agent-cli.js.map +1 -1
  439. package/dist/tools/update-member.d.ts +21 -12
  440. package/dist/tools/update-member.d.ts.map +1 -1
  441. package/dist/tools/update-member.js +43 -2
  442. package/dist/tools/update-member.js.map +1 -1
  443. package/dist/types.d.ts +12 -1
  444. package/dist/types.d.ts.map +1 -1
  445. package/dist/utils/agent-helpers.d.ts +36 -0
  446. package/dist/utils/agent-helpers.d.ts.map +1 -1
  447. package/dist/utils/agent-helpers.js +39 -1
  448. package/dist/utils/agent-helpers.js.map +1 -1
  449. package/dist/utils/platform.d.ts +7 -0
  450. package/dist/utils/platform.d.ts.map +1 -1
  451. package/dist/utils/platform.js +11 -1
  452. package/dist/utils/platform.js.map +1 -1
  453. package/dist/utils/prompt-errors.js +1 -1
  454. package/dist/utils/prompt-errors.js.map +1 -1
  455. package/dist/utils/session-caller.d.ts +28 -0
  456. package/dist/utils/session-caller.d.ts.map +1 -0
  457. package/dist/utils/session-caller.js +24 -0
  458. package/dist/utils/session-caller.js.map +1 -0
  459. package/dist/utils/work-folder-validation.d.ts +39 -0
  460. package/dist/utils/work-folder-validation.d.ts.map +1 -0
  461. package/dist/utils/work-folder-validation.js +60 -0
  462. package/dist/utils/work-folder-validation.js.map +1 -0
  463. package/dist/utils/workspace-trust.d.ts.map +1 -1
  464. package/dist/utils/workspace-trust.js +5 -1
  465. package/dist/utils/workspace-trust.js.map +1 -1
  466. package/dist/workflows/auto-sprint.js +550 -23
  467. package/package.json +7 -4
  468. package/packages/apra-fleet-client/src/client/api.mjs +210 -7
  469. package/packages/apra-fleet-se/apra-pm/agents/backlog-groomer.md +31 -19
  470. package/packages/apra-fleet-se/apra-pm/agents/ci-watcher.md +16 -1
  471. package/packages/apra-fleet-se/apra-pm/agents/deployer.md +37 -47
  472. package/packages/apra-fleet-se/apra-pm/agents/doer.md +147 -114
  473. package/packages/apra-fleet-se/apra-pm/agents/harvester.md +41 -34
  474. package/packages/apra-fleet-se/apra-pm/agents/integ-test-runner.md +98 -114
  475. package/packages/apra-fleet-se/apra-pm/agents/kb-reconciler.md +205 -0
  476. package/packages/apra-fleet-se/apra-pm/agents/plan-reviewer.md +45 -44
  477. package/packages/apra-fleet-se/apra-pm/agents/planner.md +121 -50
  478. package/packages/apra-fleet-se/apra-pm/agents/regression-test-runner.md +84 -81
  479. package/packages/apra-fleet-se/apra-pm/agents/reviewer.md +118 -44
  480. package/packages/apra-fleet-se/apra-pm/agents/schemas/doer-output.json +63 -3
  481. package/packages/apra-fleet-se/apra-pm/agents/schemas/harvester-output.json +59 -2
  482. package/packages/apra-fleet-se/apra-pm/agents/schemas/integ-test-runner-output.json +3 -3
  483. package/packages/apra-fleet-se/apra-pm/agents/schemas/kb-reconciler-output.json +87 -0
  484. package/packages/apra-fleet-se/apra-pm/agents/schemas/planner-output.json +65 -0
  485. package/packages/apra-fleet-se/apra-pm/agents/schemas/regression-test-runner-output.json +4 -17
  486. package/packages/apra-fleet-se/apra-pm/agents/schemas/reviewer-output.json +105 -8
  487. package/packages/apra-fleet-se/apra-pm/skills/pm/SKILL.md +0 -1
  488. package/packages/apra-fleet-se/apra-pm/skills/pm/beads.md +6 -0
  489. package/packages/apra-fleet-se/apra-pm/skills/pm/cost.md +0 -1
  490. package/packages/apra-fleet-se/apra-pm/skills/pm/fleet-addendum.md +6 -1
  491. package/packages/apra-fleet-se/apra-pm/skills/pm/index.md +56 -0
  492. package/packages/apra-fleet-se/apra-pm/skills/pm/kb-reconcile.md +132 -0
  493. package/packages/apra-fleet-se/apra-pm/skills/pm/kb-review.md +109 -0
  494. package/packages/apra-fleet-se/bin/cli.mjs +139 -3
  495. package/packages/apra-fleet-se/bin/serve.mjs +49 -2
  496. package/packages/apra-fleet-se/fleet-sprint/contracts.mjs +182 -38
  497. package/packages/apra-fleet-se/fleet-sprint/docs/README.md +23 -8
  498. package/packages/apra-fleet-se/fleet-sprint/docs/dolt-manual-recovery-verified.md +258 -0
  499. package/packages/apra-fleet-se/fleet-sprint/docs/dolt-sync-redesign.md +1487 -0
  500. package/packages/apra-fleet-se/fleet-sprint/docs/escalate-to-llm-design.md +908 -0
  501. package/packages/apra-fleet-se/fleet-sprint/docs/shared-orchestrator-reservation-design.md +399 -0
  502. package/packages/apra-fleet-se/fleet-sprint/docs/stabilization-log.md +14 -4
  503. package/packages/apra-fleet-se/fleet-sprint/dolt-settle.mjs +1148 -0
  504. package/packages/apra-fleet-se/fleet-sprint/dolt-sync.mjs +229 -112
  505. package/packages/apra-fleet-se/fleet-sprint/errors.mjs +91 -6
  506. package/packages/apra-fleet-se/fleet-sprint/runner.js +2469 -238
  507. package/packages/apra-fleet-se/fleet-sprint/se-os-commands.mjs +134 -0
  508. package/packages/apra-fleet-se/fleet-sprint/se-posix.mjs +154 -0
  509. package/packages/apra-fleet-se/fleet-sprint/se-windows-gitbash.mjs +97 -0
  510. package/packages/apra-fleet-se/fleet-sprint/se-windows.mjs +143 -0
  511. package/packages/apra-fleet-se/fleet-sprint/skills/fleet-sprint-cli/SKILL.md +15 -3
  512. package/packages/apra-fleet-se/fleet-sprint/skills/fleet-supervisor/SKILL.md +350 -0
  513. package/packages/apra-fleet-se/fleet-sprint/sprint-progress.mjs +101 -0
  514. package/packages/apra-fleet-se/fleet-sprint/vcs-module.mjs +51 -0
  515. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/azure-devops.mjs +657 -12
  516. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/dolt.mjs +33 -4
  517. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/github.mjs +60 -30
  518. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/index.mjs +205 -2
  519. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/shell-helpers.mjs +164 -0
  520. package/packages/apra-fleet-se/fleet-sprint/viewer-extensions.mjs +141 -26
  521. package/packages/apra-fleet-se/package.json +1 -0
  522. package/packages/apra-fleet-workflow/src/viewer/index.mjs +294 -14
  523. package/packages/apra-fleet-workflow/src/viewer/run-title.mjs +60 -0
  524. package/packages/apra-fleet-workflow/src/workflow/index.mjs +443 -35
  525. package/skills/fleet/SKILL.md +20 -9
  526. package/skills/fleet/auth-azdevops.md +44 -5
  527. package/skills/fleet/auth-bitbucket.md +3 -3
  528. package/skills/fleet/auth-github.md +2 -2
  529. package/skills/fleet/beads-conflict-resolution.md +141 -0
  530. package/skills/fleet/beads.md +16 -12
  531. package/skills/fleet/knowledge-agent.md +66 -0
  532. package/skills/fleet/onboarding.md +4 -4
  533. package/skills/fleet/permissions.md +32 -8
  534. package/skills/fleet/profiles/base-dev.json +10 -1
  535. package/skills/fleet/profiles/base-reviewer.json +8 -1
  536. package/skills/fleet/profiles/tag-kb-reconciler.json +20 -0
  537. package/skills/fleet/skill-matrix.md +1 -1
  538. package/skills/fleet/troubleshooting.md +2 -1
  539. package/version.json +1 -1
  540. package/dist/providers/gemini.d.ts +0 -42
  541. package/dist/providers/gemini.d.ts.map +0 -1
  542. package/dist/providers/gemini.js +0 -202
  543. package/dist/providers/gemini.js.map +0 -1
  544. package/packages/apra-fleet-se/fleet-sprint/docs/coach-role-design.md +0 -151
  545. package/packages/apra-fleet-se/fleet-sprint/docs/dolt-tier2-runbook.md +0 -127
  546. package/packages/apra-fleet-se/fleet-sprint/dolt-recovery-path-b.mjs +0 -339
  547. package/packages/apra-fleet-se/fleet-sprint/dolt-recovery-tier2.mjs +0 -360
  548. package/packages/apra-fleet-se/fleet-sprint/dolt-recovery.mjs +0 -363
@@ -45,6 +45,7 @@ See sub-documents for detailed usage:
45
45
  - `skill-matrix.md` - skill installation matrix by project + VCS + role
46
46
  - `auth-github.md`, `auth-bitbucket.md`, `auth-azdevops.md` - VCS auth provisioning per provider
47
47
  - `beads.md` - Beads persistent task DB: commands, backlog ops, session recovery patterns
48
+ - `beads-conflict-resolution.md` - manual dolt SQL recovery when `bd dolt pull`/`push` reports a real merge conflict
48
49
 
49
50
  ## Beads - Persistent Task Tracking
50
51
 
@@ -60,7 +61,7 @@ The `{{secure.NAME}}` pattern lets you reference stored secrets in any command w
60
61
 
61
62
  **How it works:**
62
63
  1. Store a secret with `credential_store_set` - Fleet opens an OOB terminal prompt, so the value never appears in chat
63
- 2. Reference it as `{{secure.NAME}}` anywhere in a command string passed to `execute_command`, `register_member`, `update_member`, `provision_vcs_auth`, or `provision_auth`
64
+ 2. Reference it as `{{secure.NAME}}` anywhere in a command string passed to `execute_command`, `register_member`, `update_member`, `provision_vcs_auth`, `provision_llm_auth`, or `setup_git_app`
64
65
  3. Fleet resolves the token server-side before execution; LLM does not see the secret.
65
66
 
66
67
  **When to use:**
@@ -204,15 +205,25 @@ The `resume` parameter controls whether a prior session is continued:
204
205
 
205
206
  | Value | Behaviour |
206
207
  |-------|-----------|
207
- | `true` (default) | If a session ID is stored for this member, continues it. If none exists, starts fresh. |
208
+ | `true` (default) | Best-effort resume of the member's STORED LAST session. If a session ID is stored for this member, continues it; if none exists, starts fresh. |
208
209
  | `false` | Always starts a fresh session - ignores any stored session ID. |
210
+ | `"<session-id>"` (string) | EXPLICIT resume of exactly that session, preferred over the member's stored session. Terminal on an unknown/expired id: the call returns structured `{ isError: true, reason: "session_not_found" }`, makes NO LLM call, and does NOT fall back to a fresh session. |
209
211
 
210
- `resume` is boolean only. There is no way to target a specific session ID by value.
211
- The tool always resumes the most recently stored session for that member.
212
+ `resume` accepts a boolean OR a session-ID string, so a caller CAN target a specific
213
+ session by value. The `session_id` parameter is a shorthand for the string form
214
+ (`session_id: "X"` is equivalent to `resume: "X"`, and takes precedence over `resume`).
215
+
216
+ Prefer the string form whenever the prompt depends on one specific session's prior
217
+ context. `true` resolves to the member's single globally-stored last session, which is
218
+ shared across every role and has no task scoping - under `true`, a retry can silently
219
+ land in an unrelated role's session and answer with the wrong shape. The string form
220
+ trades that silent-wrong-context failure for a loud, pre-LLM `session_not_found` that the
221
+ caller can handle (typically: re-dispatch once with `resume: false`).
212
222
 
213
223
  **Automatic stale-session recovery:** If `resume=true` and the stored session has expired
214
224
  or the provider returns an error, `execute_prompt` retries once automatically with a fresh
215
- session. This recovery is transparent - no caller intervention required.
225
+ session. This recovery is transparent - no caller intervention required. It applies ONLY
226
+ to `resume: true`; an explicit session-ID string never falls back this way (see the table).
216
227
 
217
228
  **Provider support:**
218
229
 
@@ -220,9 +231,9 @@ session. This recovery is transparent - no caller intervention required.
220
231
  |----------|---------------|-------|
221
232
  | Claude | Full | `claude --resume <sessionId>` |
222
233
  | Antigravity (agy) | Full | `agy --conversation <sessionId>` |
234
+ | OpenCode | Full | `opencode run --session <sessionId>` (`--continue` when no id is stored) |
223
235
  | Codex | Partial | `resume` command supported |
224
236
  | Copilot | None | Always starts fresh regardless of `resume` value |
225
- | Gemini | Full | Native session support |
226
237
 
227
238
  Session IDs are parsed from `execute_prompt` output and stored server-side per member.
228
239
  The output footer contains: `session: <sessionId>` when the provider supports it.
@@ -243,9 +254,9 @@ Per-provider flag behaviour:
243
254
  |----------|--------------|-------------------|
244
255
  | Claude | `--permission-mode auto` | `--dangerously-skip-permissions` |
245
256
  | Antigravity (agy) | None (config-file only via `compose_permissions`) | `--dangerously-skip-permissions` |
257
+ | OpenCode | `--auto` | `--dangerously-skip-permissions` |
246
258
  | Codex | `--ask-for-approval auto-edit` | `--sandbox danger-full-access --ask-for-approval never` |
247
259
  | Copilot | Not supported - warns and runs interactively | Not supported |
248
- | Gemini | None (config-file only via `compose_permissions`) | `--yolo` |
249
260
 
250
261
  Auto-approval is delivered via config files written by `compose_permissions` - call it before every dispatch.
251
262
 
@@ -282,9 +293,9 @@ When you see this notice, surface it to the user verbatim before the rest of the
282
293
 
283
294
  | Concern | How to handle |
284
295
  |---------|---------------|
285
- | **Agent context file** | Use `member_detail` -> `llmProvider` to determine filename: CLAUDE.md (Claude), AGY.md (Antigravity), GEMINI.md (Gemini), AGENTS.md (Codex), COPILOT.md (Copilot) |
296
+ | **Agent context file** | Use `member_detail` -> `llmProvider` to determine filename: CLAUDE.md (Claude), AGY.md (Antigravity), AGENTS.md (Codex and OpenCode), COPILOT.md (Copilot) |
286
297
  | **Attribution config** | Claude-only (Step 2 in onboarding.md) - skip for all other providers |
287
- | **Timeouts** | Antigravity/Gemini members are slower -> use 2-3x timeout multiplier for `execute_prompt` dispatches to those members. Minimum `timeout_s: 900` for any non-trivial task. |
298
+ | **Timeouts** | Antigravity members are slower -> use 2-3x timeout multiplier for `execute_prompt` dispatches to those members. Minimum `timeout_s: 900` for any non-trivial task. |
288
299
 
289
300
  ## Fleet Logs
290
301
 
@@ -9,15 +9,41 @@ Personal Access Tokens (PATs) with configurable scopes and expiration. Auth: emp
9
9
  3. Set descriptive name (e.g., "fleet-{name}")
10
10
  4. Select required scopes (see below)
11
11
  5. Set expiration (recommend: 90 days)
12
- 6. Copy token — shown only once
12
+ 6. Copy token - shown only once
13
13
  7. Provide token and org URL when prompted
14
14
 
15
+ ### Expiry Capture (Optional)
16
+
17
+ When first registering a PAT, you can optionally capture its expiration date by passing `pat_expires_at` (ISO 8601, e.g. `2027-08-20T00:00:00Z`) to `provision_vcs_auth`. Azure DevOps exposes no API to read a PAT's expiry back, so this value must come from the operator -- the date chosen in the "Set expiration" step above. It is validated at the schema boundary and rejected if unparseable. The fleet stores this expiry date and checks it against two separate thresholds (see `src/utils/agent-helpers.ts`):
18
+
19
+ - **Minute-scale warning** (`EXPIRY_WARNING_MS`, 10 minutes): fires for any provider once the credential is within 10 minutes of expiry. This threshold was sized for GitHub App tokens (~1hr lifetime).
20
+ - **Day-scale warning** (`DAY_SCALE_WARNING_MS`, 7 days): fires only for providers listed in `DAY_SCALE_WARNING_PROVIDERS`, which currently includes `azure-devops`. Because Azure DevOps PATs run weeks to months (see "Set expiration" above), this gives a heads-up long before the minute-scale check would ever fire.
21
+
22
+ Either warning causes the fleet to request a fresh provisioning before the sprint dispatch rather than failing mid-sprint when the credential becomes invalid.
23
+
24
+ This step is optional; PATs function normally even without expiry tracking. However, recording expiry dates helps prevent surprise authentication failures and reduces retry cycles.
25
+
15
26
  ## Deploy
16
27
 
17
28
  ```
18
- provision_vcs_auth(member_id, provider: 'azure-devops', org_url: 'https://dev.azure.com/myorg', pat: '...')
29
+ provision_vcs_auth(member_id, provider: 'azure-devops', org_url: 'https://dev.azure.com/myorg', pat: '...', pat_expires_at: '2027-08-20T00:00:00Z')
30
+ ```
31
+
32
+ ## Secret-Name Convention
33
+
34
+ The Azure DevOps PAT is stored in the fleet's credential store under a configurable name. **Default:** `azdevops_pat`
35
+
36
+ The credential is entered via the out-of-band prompt during `provision_vcs_auth` and is stored as a secure placeholder. When used in `execute_command` calls, the fleet resolves the placeholder on the server side - the plaintext token never appears in logs, prompts, or LLM transcripts.
37
+
38
+ **Store or reference the default credential:**
39
+
40
+ ```
41
+ credential_store_set name=azdevops_pat
42
+ execute_command command="curl -sf -u :{{secure.azdevops_pat}} 'https://dev.azure.com/{org}/_apis/projects?api-version=7.1'"
19
43
  ```
20
44
 
45
+ **Per-sprint override:** To use a different credential name for a specific sprint (for example, when working with a different Azure DevOps organization or test repo), pass the `azdevops_pat_secret_name` argument to the sprint invocation (threaded through `packages/apra-fleet-se/fleet-sprint/runner.js`). It must name a credential already stored via `credential_store_set`; the runner validates it as a credential-store name at contract-validation time and uses it instead of the default `azdevops_pat` entry for provisioning, self-heal, and preflight checks on that sprint.
46
+
21
47
  ## Scopes
22
48
 
23
49
  | Role | PAT Scopes |
@@ -46,9 +72,21 @@ git ls-remote https://dev.azure.com/{org}/{project}/_git/{repo} HEAD
46
72
  | TF400813: Resource not available | Verify org URL matches `https://dev.azure.com/{org}` |
47
73
  | Clone prompts for password | Re-run `provision_vcs_auth` |
48
74
 
75
+ ## PAT Lifetime and Expiry
76
+
77
+ A fleet provisioning Azure DevOps credentials **cannot self-extend or auto-renew a PAT**. The Azure DevOps PAT lifecycle management API requires an Entra (Azure AD) OAuth token with admin consent, which the fleet does not hold. This is a fundamental design constraint: the fleet stores only the PAT itself, never the credentials needed to mint a fresh PAT or extend an existing one.
78
+
79
+ **Implications:**
80
+
81
+ - PATs must be renewed manually before expiry by re-running `provision_vcs_auth` and providing a fresh token.
82
+ - The optional expiry capture (see Setup section above) enables day-scale preflight warnings so the sprint can request a fresh provisioning before the credential becomes invalid.
83
+ - If a PAT expires mid-sprint, the sprint will fail with auth errors until `provision_vcs_auth` is re-run with a valid token.
84
+
85
+ To avoid disruption, set a calendar reminder to renew PATs well before their expiry date, or use the optional expiry-capture feature to let the fleet warn you in advance.
86
+
49
87
  ## Storing tokens for reuse
50
88
 
51
- After provisioning VCS auth, you can store the Azure DevOps PAT in the credential store for direct use in `execute_command` — for example, calling the Azure DevOps REST API or authenticating git operations manually.
89
+ After provisioning VCS auth, you can store the Azure DevOps PAT in the credential store (see Secret-Name Convention section above) for direct use in `execute_command` - for example, calling the Azure DevOps REST API or authenticating git operations manually.
52
90
 
53
91
  **Store an Azure DevOps PAT for reuse:**
54
92
 
@@ -63,10 +101,11 @@ execute_command command="curl -sf -u :{{secure.azdevops_pat}} 'https://dev.azur
63
101
  execute_command command="git remote set-url origin https://token:{{secure.azdevops_pat}}@dev.azure.com/{org}/{project}/_git/{repo}"
64
102
  ```
65
103
 
66
- The token is resolved server-side and redacted in output (`[REDACTED:azdevops_pat]`) — it never appears in the LLM conversation or command logs.
104
+ The token is resolved server-side and redacted in output (`[REDACTED:azdevops_pat]`) - it never appears in the LLM conversation or command logs.
67
105
 
68
106
  ## Notes
69
107
 
70
108
  - PAT expiration: default 30 days, max 1 year
71
- - Azure DevOps does not support app-based tokens — PATs are the standard
109
+ - Azure DevOps does not support app-based tokens - PATs are the standard
72
110
  - Org URL must be base URL without trailing path
111
+ - To learn what scopes are required for your role, see the Scopes table above
@@ -7,7 +7,7 @@ API tokens (app passwords) tied to a user account. Long-lived, no auto-expire.
7
7
  1. Go to `https://id.atlassian.com/manage-profile/security/api-tokens`
8
8
  (or Bitbucket: Settings > Personal Bitbucket settings > App passwords)
9
9
  2. Create app password with required scopes (see below)
10
- 3. Copy token — shown only once
10
+ 3. Copy token - shown only once
11
11
  4. Provide token, email, and workspace slug when prompted
12
12
 
13
13
  ## Deploy
@@ -38,7 +38,7 @@ git ls-remote https://bitbucket.org/{workspace}/{repo}.git HEAD
38
38
 
39
39
  ## Storing tokens for reuse
40
40
 
41
- After provisioning VCS auth, you can store the Bitbucket API token in the credential store for direct use in `execute_command` — for example, calling the Bitbucket REST API or authenticating git operations manually.
41
+ After provisioning VCS auth, you can store the Bitbucket API token in the credential store for direct use in `execute_command` - for example, calling the Bitbucket REST API or authenticating git operations manually.
42
42
 
43
43
  **Store a Bitbucket token for reuse:**
44
44
 
@@ -53,7 +53,7 @@ execute_command command="curl -sf -u me@example.com:{{secure.bitbucket_token}}
53
53
  execute_command command="git remote set-url origin https://me@example.com:{{secure.bitbucket_token}}@bitbucket.org/workspace/repo.git"
54
54
  ```
55
55
 
56
- The token is resolved server-side and redacted in output (`[REDACTED:bitbucket_token]`) — it never appears in the LLM conversation or command logs.
56
+ The token is resolved server-side and redacted in output (`[REDACTED:bitbucket_token]`) - it never appears in the LLM conversation or command logs.
57
57
 
58
58
  ## Troubleshooting
59
59
 
@@ -59,7 +59,7 @@ gh api /user
59
59
 
60
60
  ## Storing tokens for reuse
61
61
 
62
- After provisioning VCS auth, you can also store the token in the credential store so members can use it directly in `execute_command` calls — for example, when calling the GitHub REST API or authenticating git operations that bypass the configured remote URL.
62
+ After provisioning VCS auth, you can also store the token in the credential store so members can use it directly in `execute_command` calls - for example, when calling the GitHub REST API or authenticating git operations that bypass the configured remote URL.
63
63
 
64
64
  **Store a GitHub PAT for reuse:**
65
65
 
@@ -74,7 +74,7 @@ execute_command command="curl -H 'Authorization: Bearer {{secure.github_pat}}'
74
74
  execute_command command="git remote set-url origin https://token:{{secure.github_pat}}@github.com/Org/Repo.git"
75
75
  ```
76
76
 
77
- The token is resolved server-side and redacted in output (`[REDACTED:github_pat]`) — it never appears in the LLM conversation or command logs.
77
+ The token is resolved server-side and redacted in output (`[REDACTED:github_pat]`) - it never appears in the LLM conversation or command logs.
78
78
 
79
79
  ## Troubleshooting
80
80
 
@@ -0,0 +1,141 @@
1
+ # Beads Conflict Resolution -- Dolt SQL Playbook
2
+
3
+ `bd dolt pull` / `bd dolt push` can fail with a genuine, non-fast-forward divergence:
4
+
5
+ ```
6
+ Error: merge origin/main: merge conflicts in issues require operator resolution;
7
+ merge aborted and working set restored
8
+ ```
9
+
10
+ This is not corruption and the working set is untouched -- `bd` already aborted the
11
+ merge safely. Resolve it by driving the real `dolt` binary against the same data
12
+ directory over SQL, ephemerally, then pull/push again through `bd` as normal.
13
+
14
+ **Do not `bd init`, `bd init --from-jsonl`, or delete `.beads/` to "fix" this** --
15
+ that discards local issue state. See `beads.md`.
16
+
17
+ For the fully automated version of this same procedure (used by fleet-sprint
18
+ itself at every sync point), see `settleDoltConflicts()` in
19
+ `packages/apra-fleet-se/fleet-sprint/dolt-settle.mjs`, which applies a
20
+ deterministic per-field last-writer-wins rulebook instead of a human picking a
21
+ side. This playbook is the manual fallback -- use it when you need to see the
22
+ actual conflicting content before deciding, or when settle isn't wired for the
23
+ context you're in (e.g. resolving conflicts in the orchestrator's own local
24
+ checkout rather than against a registered fleet member).
25
+
26
+ ## 0. Find the real data directory -- never hardcode it
27
+
28
+ ```bash
29
+ bd dolt status
30
+ ```
31
+
32
+ Read the `Data:` line. **On a machine with multiple worktrees, `bd` resolves to
33
+ one shared `.beads` directory for the whole repo (typically the main checkout's),
34
+ not a per-worktree copy** -- always use the absolute path this command reports,
35
+ never a path you assume from cwd.
36
+
37
+ If it reports `embedded (in-process, no server)`, there's no live server to
38
+ route through -- start an ephemeral one (step 2). If it already reports a live
39
+ server (`host:port`), target that instead of starting a second one.
40
+
41
+ ## 1. Ensure the pinned `dolt` binary is present
42
+
43
+ ```powershell
44
+ & "$env:USERPROFILE\.apra-fleet\bin\dolt.exe" version # Windows
45
+ ```
46
+ ```bash
47
+ "$HOME/.apra-fleet/bin/dolt" version # POSIX
48
+ ```
49
+
50
+ Never install via a package manager (`winget`/`apt`/`brew`) -- it delivers an
51
+ unpinned version that drifts from the repo's pin and can be invisible to
52
+ already-running sessions' PATH. If missing, fetch the pinned release asset
53
+ (`DOLT_VERSION` in `src/cli/dolt-install.ts`) to that exact path.
54
+
55
+ ## 2. Start an ephemeral sql-server against that data dir
56
+
57
+ **Windows -- `Start-Process` does NOT actually detach** (dies with the SSH/job
58
+ session). Use WMI:
59
+
60
+ ```powershell
61
+ $result = Invoke-CimMethod -ClassName Win32_Process -MethodName Create -Arguments @{
62
+ CommandLine = 'cmd /c ""C:\Users\<you>\.apra-fleet\bin\dolt.exe" sql-server --host 127.0.0.1 --port 13401 --data-dir "<ABSOLUTE data dir from step 0>" > "%TEMP%\dolt-settle-local.log" 2>&1"'
63
+ CurrentDirectory = '<absolute path to your repo checkout>'
64
+ }
65
+ $result.ProcessId # record for teardown -- this is cmd.exe's PID, not dolt's (see step 5)
66
+ ```
67
+
68
+ Wrapping in `cmd /c ... > log 2>&1` is required to capture startup errors (a bad
69
+ `--data-dir` fails silently otherwise). Verify before proceeding:
70
+
71
+ ```powershell
72
+ Test-NetConnection -ComputerName 127.0.0.1 -Port 13401 # expect TcpTestSucceeded: True
73
+ Get-Content "$env:TEMP\dolt-settle-local.log" # expect "Server ready. Accepting connections."
74
+ ```
75
+
76
+ **POSIX:** `nohup dolt sql-server --host 127.0.0.1 --port 13401 --data-dir <dir> > /tmp/dolt-recovery.log 2>&1 & disown`
77
+
78
+ ## 3. Inspect the conflict before resolving -- do not guess a side
79
+
80
+ ```bash
81
+ dolt --no-tls --host=127.0.0.1 --port=13401 sql -q "
82
+ USE beads;
83
+ SET @@dolt_allow_commit_conflicts = 1;
84
+ CALL DOLT_MERGE('origin/main');
85
+ SELECT \`table\` FROM dolt_conflicts;"
86
+ ```
87
+
88
+ Two non-obvious flag landmines: `--no-tls` must come *before* `--host`/`--port`
89
+ (order-sensitive), and never pass `--user=root` or `--password` explicitly --
90
+ that switches the client into an interactive credential prompt that then fails
91
+ non-interactively. Omit both and it authenticates as root/empty-password
92
+ silently.
93
+
94
+ For each conflicted table, see which rows and which side is newer:
95
+
96
+ ```sql
97
+ SELECT base_id, our_id, their_id, our_updated_at, their_updated_at
98
+ FROM dolt_conflicts_issues; -- table name is `dolt_conflicts_<table>`
99
+ ```
100
+
101
+ ## 4. Resolve -- per-field last-writer-wins, not a blanket side
102
+
103
+ ```sql
104
+ CALL DOLT_CONFLICTS_RESOLVE('--ours', 'issues'); -- our_updated_at newer
105
+ -- or '--theirs' if their_updated_at is newer
106
+ CALL DOLT_COMMIT('-m', 'manual recovery: resolve <issue-id> conflict, <ours|theirs> newer');
107
+ SELECT COUNT(*) FROM dolt_conflicts; -- MUST be 0 before continuing
108
+ ```
109
+
110
+ A bare `--ours`/`--theirs` picks the whole row. Only safe when one side is
111
+ strictly newer (verify via `updated_at` from step 3) or you've confirmed the
112
+ older side's content is already fully contained in the newer side -- never
113
+ pick a side just to make the error go away.
114
+
115
+ ## 5. Teardown BEFORE republishing -- order matters
116
+
117
+ Embedded-mode `bd` needs Dolt's per-directory exclusive lock; republishing
118
+ while the ephemeral server still holds it fails or silently falls back
119
+ read-only.
120
+
121
+ ```powershell
122
+ Get-Process | Where-Object { $_.ProcessName -eq 'dolt' } | Stop-Process -Force
123
+ # the WMI-created PID from step 2 is cmd.exe, not dolt.exe -- find dolt.exe by name, not by that PID
124
+ Test-NetConnection -ComputerName 127.0.0.1 -Port 13401 # expect False
125
+ ```
126
+
127
+ Then, only after the port is confirmed closed:
128
+
129
+ ```bash
130
+ bd dolt pull # verify
131
+ bd dolt push # republish
132
+ ```
133
+
134
+ ## Full reference
135
+
136
+ `packages/apra-fleet-se/fleet-sprint/docs/dolt-manual-recovery-verified.md` --
137
+ the original live-verified spec this playbook condenses, including the
138
+ `settleDoltConflicts()` rulebook for tables other than `issues` (union for
139
+ `labels`, plain theirs for machine-local/append-only tables) and the
140
+ `dolt_mode` cleanup guarantee if a recovery ever routes `bd` itself through a
141
+ server.
@@ -1,8 +1,8 @@
1
- # Beads — Persistent Task DB for Fleet Users
1
+ # Beads - Persistent Task DB for Fleet Users
2
2
 
3
3
  Beads (`bd`) is a lightweight, dependency-aware task database installed automatically by `apra-fleet install`.
4
4
 
5
- **`bd` runs on the orchestrator via `Bash` — never expose `bd` commands to the user and never run `bd` via `execute_command` on a member.**
5
+ **`bd` runs on the orchestrator via `Bash` - never expose `bd` commands to the user and never run `bd` via `execute_command` on a member.**
6
6
 
7
7
  ---
8
8
 
@@ -24,11 +24,15 @@ bd list --assignee <member> # tasks for a specific member
24
24
  bd search "text" --status all --json # find existing issues by title (use for dedup)
25
25
  ```
26
26
 
27
- **Never run `bd init` on a repo that already has a `.beads/` directory** — it pulls from
27
+ **Never run `bd init` on a repo that already has a `.beads/` directory** - it pulls from
28
28
  remote and recreates the database, discarding local issue state. It is NOT idempotent.
29
29
  Only run it once, on a repo with no `.beads/` yet. For a fresh clone or recovering a
30
30
  missing/corrupt DB, prefer `bd bootstrap` (non-destructive) over `bd init`.
31
31
 
32
+ If `bd dolt pull`/`push` instead fails with a real merge conflict ("merge conflicts in
33
+ issues require operator resolution"), see `beads-conflict-resolution.md` - do not
34
+ `bd init` your way out of it.
35
+
32
36
  ---
33
37
 
34
38
  ## When to Use Beads
@@ -37,7 +41,7 @@ missing/corrupt DB, prefer `bd bootstrap` (non-destructive) over `bd init`.
37
41
  |----------|-----------|
38
42
  | Tracking work across multiple fleet sessions | `bd create` a task per work item; `bd update --assignee <member> --status in_progress` on dispatch |
39
43
  | Expressing dependencies between tasks | `bd dep add <blocked-id> <blocker-id>` |
40
- | Session restart — instant orientation | `bd ready` — shows all in-flight tasks without reading files |
44
+ | Session restart - instant orientation | `bd ready` - shows all in-flight tasks without reading files |
41
45
  | Linking a PR to a task | `bd note <id> "PR: <url>"` |
42
46
 
43
47
  ---
@@ -46,10 +50,10 @@ missing/corrupt DB, prefer `bd bootstrap` (non-destructive) over `bd init`.
46
50
 
47
51
  | Priority | Meaning |
48
52
  |----------|---------|
49
- | `0` | Critical — must fix now |
50
- | `1` | High — next up |
51
- | `2` | Medium — current sprint (default if `-p` omitted) |
52
- | `3` | Low — backlog / deferred |
53
+ | `0` | Critical - must fix now |
54
+ | `1` | High - next up |
55
+ | `2` | Medium - current sprint (default if `-p` omitted) |
56
+ | `3` | Low - backlog / deferred |
53
57
  | `4` | Trivial |
54
58
 
55
59
  ---
@@ -61,11 +65,11 @@ missing/corrupt DB, prefer `bd bootstrap` (non-destructive) over `bd init`.
61
65
  bd init
62
66
 
63
67
  # Create a top-level epic for your current effort
64
- bd create "feat: add SFTP transport" -p 1 # → epic-id
68
+ bd create "feat: add SFTP transport" -p 1 # -> epic-id
65
69
 
66
70
  # Break it into tasks
67
- bd create "T1: implement connection" -p 1 --parent <epic-id> # → t1-id
68
- bd create "T2: add retry logic" -p 2 --parent <epic-id> # → t2-id
71
+ bd create "T1: implement connection" -p 1 --parent <epic-id> # -> t1-id
72
+ bd create "T2: add retry logic" -p 2 --parent <epic-id> # -> t2-id
69
73
  bd dep add <t2-id> <t1-id> # T2 blocked until T1 is done
70
74
 
71
75
  # Dispatch a member to T1
@@ -75,7 +79,7 @@ bd update <t1-id> --assignee <member> --status in_progress
75
79
  bd close <t1-id>
76
80
  bd ready # confirms T2 is now unblocked
77
81
 
78
- # At completion — link PR
82
+ # At completion - link PR
79
83
  bd close <epic-id>
80
84
  bd note <epic-id> "PR: https://github.com/org/repo/pull/42"
81
85
  ```
@@ -0,0 +1,66 @@
1
+ # Knowledge Bank Agent
2
+
3
+ The Knowledge Bank (KB) workflow gives fleet members persistent, cross-session
4
+ codebase context. It runs in three phases per session.
5
+
6
+ ---
7
+
8
+ ## Phase 1 (Prime)
9
+
10
+ Run at the start of every session before touching any code.
11
+
12
+ ```
13
+ kb_session_prime
14
+ ```
15
+
16
+ - Reads the KB index for the current repo and returns stale or missing entries.
17
+ - Returns a list of recommended code intelligence calls to refresh stale context.
18
+ - After priming, dispatch all recommended calls using the fleet code intelligence
19
+ tools (code_graph, code_impact, code_query, code_context).
20
+
21
+ **If kb_session_prime is unavailable**, skip and proceed -- the KB is optional.
22
+
23
+ ---
24
+
25
+ ## Phase 2 (Capture)
26
+
27
+ Run after significant decisions or architectural choices during the session.
28
+
29
+ ```
30
+ kb_capture
31
+ ```
32
+
33
+ - Writes a new KB entry summarizing the current decision or finding.
34
+ - Run after: choosing an approach, discovering a non-obvious constraint, making
35
+ a design trade-off, or resolving a subtle bug.
36
+ - Do NOT run after routine code edits -- only when the WHY is non-obvious.
37
+
38
+ ---
39
+
40
+ ## Phase 3 (Harvest)
41
+
42
+ `kb_harvest` fires automatically (fire-and-forget) after `execute_prompt` completes,
43
+ passing the full session transcript -- the one thing a member cannot reliably supply
44
+ about its own session. You do not need to call it yourself; calling it without a
45
+ transcript is a no-op.
46
+
47
+ - Regex-extracts learnings from the transcript into durable KB entries.
48
+ - Low-trust: entries are always captured at confidence=UNVERIFIED with
49
+ author='harvest', source='harvest' -- distinct from entries you capture directly
50
+ via kb_capture in Phase 2.
51
+ - Ensures future sessions (and other members) benefit from work done this session
52
+ even when nothing was explicitly captured.
53
+
54
+ ---
55
+
56
+ ## Code Intelligence Tools
57
+
58
+ Use these fleet tools for cross-file tracing and symbol lookup. Never
59
+ plain-read files for structural questions -- use the tools instead.
60
+
61
+ | Tool | Purpose |
62
+ |------|---------|
63
+ | `code_graph` | Call graph for a symbol (callers + callees) |
64
+ | `code_impact` | Blast radius for a symbol (upstream affected) |
65
+ | `code_query` | Semantic search across codebase |
66
+ | `code_context` | Full symbol context (callers, callees, flows) |
@@ -14,7 +14,7 @@ Use `member_detail` to determine `llmProvider` and `os`. Run `execute_command` w
14
14
  - **Antigravity:** `agy --version 2>&1`
15
15
  - **Codex:** `codex --version`
16
16
  - **Copilot:** `copilot --version`
17
- - **Gemini:** `gemini --version`
17
+ - **OpenCode:** `opencode --version 2>&1`
18
18
 
19
19
  If the LLM CLI is not installed or the command fails, use `update_llm_cli` to install it before proceeding. Do not attempt any prompt dispatch until the CLI is confirmed.
20
20
 
@@ -26,7 +26,7 @@ Call `provision_llm_auth`. Skip for local members - they inherit auth from the P
26
26
 
27
27
  **Claude only.** Write `{"attribution":{"commit":"","pr":""}}` to `.claude/settings.json` in the member's work folder via `execute_command`. Merge if file already exists.
28
28
 
29
- Antigravity, Codex, Copilot, and Gemini do not support attribution config - skip this step for those providers.
29
+ Antigravity, Codex, Copilot, and OpenCode do not support attribution config - skip this step for those providers.
30
30
 
31
31
  ## Step 3: Detect VCS Provider
32
32
 
@@ -60,7 +60,7 @@ Add to the member's status file:
60
60
 
61
61
  ```
62
62
  ## Member Profile
63
- - LLM Provider: Claude (or agy, gemini, etc.)
63
+ - LLM Provider: Claude (or agy, codex, etc.)
64
64
  - VCS: Bitbucket (kumaakh/apra-lic-mgr)
65
65
  - Roles: development, code-review
66
66
  - Auth: Bitbucket API token (verified)
@@ -75,7 +75,7 @@ If the task you are about to dispatch requires an API key, token, or password (e
75
75
 
76
76
  **Steps:**
77
77
  1. Call `credential_store_set` with a descriptive name (e.g., `github_pat`, `npm_token`, `openai_key`) - Fleet opens an OOB terminal prompt for the value
78
- 2. Pass the `sec://NAME` handle in the task prompt - reference by name only (e.g. `"authenticate using credential github_pat"`). The secret value is only injected server-side when `{{secure.NAME}}` appears in an `execute_command` call - never in AI prompt text.
78
+ 2. Reference the credential by NAME only in the task prompt (e.g. `"authenticate using credential github_pat"`) - never paste the raw `sec://NAME` handle into a prompt or command; `execute_command` rejects any command containing one. The secret value is only injected server-side when `{{secure.NAME}}` appears in an `execute_command` call - never in AI prompt text.
79
79
  3. The member uses `{{secure.NAME}}` in `execute_command` - Fleet resolves the value server-side and redacts it from output before the LLM sees it
80
80
 
81
81
  **Example - dispatching a member that needs to push code to GitHub:**
@@ -41,7 +41,7 @@ Tags determine the primary mode and grant additional tool scopes:
41
41
  3. Load **custom tag profiles**: for each non-mode tag, load tag-<name>.json and merge its permissions for the primary mode
42
42
  4. Load **ledger grants**: merge any permissions previously granted in project_folder/permissions.json
43
43
 
44
- All merges are additive (Set-based) - order is independent, duplicates discarded. The final allow list is delivered to the member's provider (Claude, Gemini, etc.) in the provider's native config format.
44
+ All merges are additive (Set-based) - order is independent, duplicates discarded. The final allow list is delivered to the member's provider (Claude, Codex, etc.) in the provider's native config format.
45
45
 
46
46
  ### Example
47
47
 
@@ -67,7 +67,7 @@ When `execute_prompt` output contains a permission denial, call `compose_permiss
67
67
 
68
68
  > "Grant Bash(docker:*) to build-server, reason: integration tests, project folder ./my-project"
69
69
 
70
- The tool validates (blocks dangerous tools like sudo/env), expands co-occurrences (docker -> docker-compose), delivers the updated config, and appends to the project ledger for future use.
70
+ The tool validates (wildcard-matched denylist -- blocks sudo/env, `bash -c`, catch-alls and shell chaining; see [Never auto-granted](#never-auto-granted)), expands co-occurrences (docker -> docker-compose), delivers the updated config, and appends to the project ledger for future use.
71
71
 
72
72
  ## Role switch
73
73
 
@@ -75,7 +75,31 @@ When a member's primary mode changes (e.g., from doer to reviewer), re-run `comp
75
75
 
76
76
  ## Never auto-granted
77
77
 
78
- `sudo`, `su`, `env`, `printenv`, `nc`, `nmap` - the tool rejects these. Escalate to user.
78
+ `compose_permissions` hard-rejects a `grant` request - from ANY caller, with or
79
+ without a role - when it matches the `NEVER_AUTO_GRANT` denylist. Matching is
80
+ wildcard-based against a normalized form of the request (whitespace collapsed;
81
+ the `:` separating the command token from its argument pattern treated as a
82
+ space), so `Bash(sudo:*)`, `Bash(sudo *)` and `Bash(sudo apt-get install *)`
83
+ are all the same request and all rejected.
84
+
85
+ Three rules, any of which rejects:
86
+
87
+ 1. **Catch-all** - a payload that is nothing but wildcards, e.g. `Bash(*)`.
88
+ That is not "a wider grant", it is unrestricted execution.
89
+ 2. **Shell chaining** - the payload contains `|`, `;`, `&&`, a backtick, or
90
+ `$(`, any of which turns one approved command into an arbitrary chain
91
+ (`Bash(curl *|sh)`).
92
+ 3. **Denied command patterns** - `sudo`, `su`, `doas`, `bash -c` / `sh -c`,
93
+ `eval`, `env`, `printenv`, `nc`, `nmap`, `chmod 777`.
94
+
95
+ Escalate to the user for any of these. Note rule 3 is prefix-based, so an
96
+ unrelated command that merely starts with a denied token (`ncdu`, `envsubst`)
97
+ is also refused - over-blocking is the safe direction for a denylist, and an
98
+ operator can still add such a permission by hand.
99
+
100
+ A denylist can never be complete: `Bash(make *)`, `Bash(npm run *)`,
101
+ `Bash(node -e *)` all remain arbitrary execution in practice. The denylist is
102
+ the unconditional floor that applies to every caller.
79
103
 
80
104
  ## settings.json vs settings.local.json (Claude)
81
105
 
@@ -116,13 +140,13 @@ setting `projects[<work_folder>].hasTrustDialogAccepted = true` scoped **strictl
116
140
  that exact work folder (never a parent directory, never blanket) - delivered over the
117
141
  same channel `compose_permissions` already uses, so it works uniformly for local and
118
142
  remote (SSH) members. It logs distinctly whether it just seeded trust or found it
119
- already present. Other providers no-op: Gemini and OpenCode have their own trust gates
120
- but already bypass them per-dispatch (`--skip-trust`, `--dangerously-skip-permissions`);
143
+ already present. Other providers no-op: OpenCode has its own trust gate
144
+ but already bypasses it per-dispatch (`--dangerously-skip-permissions`);
121
145
  AGY has no per-project trust concept (machine-global config); Codex/Copilot have no
122
146
  known equivalent gate.
123
147
 
124
148
  If `execute_prompt` fails with a `workspace_not_trusted` structured error, the CLI's own
125
149
  stderr will contain a `"...this workspace has not been trusted"` message - seed trust
126
- via `ensureWorkspaceTrusted(workFolder)` (invoked automatically at
127
- register_member/update_member and on every `compose_permissions` call once
128
- apra-fleet-eft.40.2 wires it in), then retry.
150
+ via `ensureWorkspaceTrusted(workFolder)` -- invoked automatically at
151
+ `register_member`/`update_member`, on every `compose_permissions` call, and as a
152
+ one-shot self-heal inside `execute_prompt` itself -- then retry.
@@ -13,7 +13,16 @@
13
13
  "Bash(tee:*)", "Bash(xargs:*)", "Bash(sleep:*)",
14
14
  "Bash(kill:*)", "Bash(pkill:*)",
15
15
  "Bash(bash:*)", "Bash(sh:*)",
16
- "Bash(gh:*)", "Bash(jq:*)"
16
+ "Bash(gh:*)", "Bash(jq:*)",
17
+ "mcp__apra-fleet__kb_session_prime",
18
+ "mcp__apra-fleet__kb_query",
19
+ "mcp__apra-fleet__kb_stats",
20
+ "mcp__apra-fleet__kb_capture",
21
+ "mcp__apra-fleet__kb_feedback",
22
+ "mcp__apra-fleet__code_context",
23
+ "mcp__apra-fleet__code_graph",
24
+ "mcp__apra-fleet__code_impact",
25
+ "mcp__apra-fleet__code_query"
17
26
  ]
18
27
  }
19
28
  }
@@ -9,7 +9,14 @@
9
9
  "Bash(which:*)", "Bash(ls:*)", "Bash(cat:*)", "Bash(head:*)", "Bash(tail:*)",
10
10
  "Bash(find:*)", "Bash(wc:*)", "Bash(sort:*)", "Bash(diff:*)",
11
11
  "Bash(echo:*)", "Bash(grep:*)",
12
- "Bash(gh:*)", "Bash(jq:*)"
12
+ "Bash(gh:*)", "Bash(jq:*)",
13
+ "mcp__apra-fleet__kb_session_prime",
14
+ "mcp__apra-fleet__kb_query",
15
+ "mcp__apra-fleet__kb_feedback",
16
+ "mcp__apra-fleet__code_context",
17
+ "mcp__apra-fleet__code_graph",
18
+ "mcp__apra-fleet__code_impact",
19
+ "mcp__apra-fleet__code_query"
13
20
  ]
14
21
  }
15
22
  }
@@ -0,0 +1,20 @@
1
+ {
2
+ "dev": [
3
+ "mcp__apra-fleet__code_context",
4
+ "mcp__apra-fleet__code_impact",
5
+ "mcp__apra-fleet__code_query",
6
+ "mcp__apra-fleet__kb_resolve_contradiction",
7
+ "mcp__apra-fleet__kb_query",
8
+ "mcp__apra-fleet__kb_list",
9
+ "mcp__apra-fleet__kb_export"
10
+ ],
11
+ "reviewer": [
12
+ "mcp__apra-fleet__code_context",
13
+ "mcp__apra-fleet__code_impact",
14
+ "mcp__apra-fleet__code_query",
15
+ "mcp__apra-fleet__kb_resolve_contradiction",
16
+ "mcp__apra-fleet__kb_query",
17
+ "mcp__apra-fleet__kb_list",
18
+ "mcp__apra-fleet__kb_export"
19
+ ]
20
+ }