@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
@@ -7,6 +7,7 @@ import { DebouncedStateWriter, DEFAULT_DEBOUNCE_MS, writeJsonFileAtomic } from '
7
7
  import { getRunningRunStatePath, getTerminalRunStatePath } from './run-state-paths.mjs';
8
8
  import { buildListStatePayload, resolveStringRefs } from './lean-state.mjs';
9
9
  import { capCommandActivityMeta, getFullOutput } from './command-output-cap.mjs';
10
+ import { buildRunTitle } from './run-title.mjs';
10
11
 
11
12
  // apra-fleet-eft.6.5: the SAME template serves both the live view and the
12
13
  // process-free History view -- `opts.history` (true) feeds a FROZEN state
@@ -51,6 +52,8 @@ const HTML_TEMPLATE = (dashboardExtensions, opts = {}) => {
51
52
  body { background: var(--bg); color: var(--text); font-family: sans-serif; height: 100vh; height: 100dvh; overflow: hidden; display: flex; flex-direction: column; }
52
53
  .header { flex-shrink: 0; display: flex; justify-content: space-between; align-items: center; padding: 12px 24px; background: var(--bg-glass); border-bottom: 1px solid var(--border); }
53
54
  .header h1 { font-size: 16px; font-weight: 600; margin: 0; }
55
+ .header-title { display: flex; flex-direction: column; gap: 4px; }
56
+ .run-title { font-size: 12px; color: var(--text-muted); background: var(--bg-glass); padding: 2px 8px; border-radius: 4px; width: fit-content; }
54
57
  .header-actions { display: flex; gap: 12px; align-items: center; }
55
58
 
56
59
  .stats-banner { display: flex; gap: 16px; font-size: 12px; color: var(--text-muted); background: rgba(0,0,0,0.3); padding: 4px 12px; border-radius: 12px; border: 1px solid rgba(255,255,255,0.05); }
@@ -59,9 +62,15 @@ const HTML_TEMPLATE = (dashboardExtensions, opts = {}) => {
59
62
 
60
63
  .btn { padding: 4px 12px; font-size: 12px; border-radius: 4px; border: none; cursor: pointer; font-weight: 600; transition: opacity 0.2s; }
61
64
  .btn:hover { opacity: 0.8; }
65
+ .btn:disabled { opacity: 0.4; cursor: default; }
66
+ .btn:disabled:hover { opacity: 0.4; }
62
67
  .btn-save { background: var(--accent); color: #fff; }
63
68
  .btn-stop { background: var(--danger); color: #fff; }
69
+ .btn-pause { background: var(--warning); color: #000; }
64
70
  .btn-secondary { background: rgba(255,255,255,0.1); color: var(--text); }
71
+ /* (apra-fleet-p2to.2.1) 'paused since <ts>' badge + reason card,
72
+ generic to every workflow run -- no per-workflow-type styling. */
73
+ .pause-banner { background: rgba(245, 158, 11, 0.12); border-color: rgba(245, 158, 11, 0.4); color: var(--warning); }
65
74
 
66
75
  /* min-height: 0 on every rung of the flex chain: a flex item's default
67
76
  min-height is content-sized, which lets a tall Activity list push the
@@ -168,11 +177,32 @@ const HTML_TEMPLATE = (dashboardExtensions, opts = {}) => {
168
177
  the only way to shrink total height. Flex here still wins on
169
178
  specificity but no longer conflicts with .panel's own flex layout. */
170
179
  .tab-content.active { display: flex; min-height: 0; }
180
+
181
+ /* apra-fleet-4yr.1: in-page replacements for window.confirm()/alert()
182
+ on the Stop path -- native OS dialogs clash with the dark-glass UI.
183
+ Modal reuses .btn-stop's danger color for its Stop action; toast is
184
+ non-blocking and auto-dismisses. */
185
+ .modal-overlay { display: none; position: fixed; inset: 0; background: rgba(0,0,0,0.6); align-items: center; justify-content: center; z-index: 1000; }
186
+ .modal-overlay.open { display: flex; }
187
+ .modal-box { background: var(--bg); border: 1px solid var(--border); border-radius: 6px; padding: 20px; max-width: 360px; width: 90%; box-shadow: 0 8px 24px rgba(0,0,0,0.5); }
188
+ .modal-box p { color: var(--text); font-size: 13px; margin-bottom: 16px; line-height: 1.4; }
189
+ .modal-actions { display: flex; justify-content: flex-end; gap: 8px; }
190
+ .toast { position: fixed; bottom: 24px; right: 24px; background: var(--bg-glass); border: 1px solid var(--border); color: var(--text); padding: 10px 16px; border-radius: 6px; font-size: 12px; box-shadow: 0 4px 12px rgba(0,0,0,0.4); opacity: 0; transform: translateY(8px); transition: opacity 0.2s, transform 0.2s; pointer-events: none; z-index: 1001; }
191
+ .toast.show { opacity: 1; transform: translateY(0); }
171
192
  </style>
172
193
  </head>
173
194
  <body data-view="${isHistory ? 'history' : 'live'}">
174
195
  <div class="header">
175
- <h1><span id="workflow-name">Loading...</span></h1>
196
+ <div class="header-title">
197
+ <h1><span id="workflow-name">Loading...</span></h1>
198
+ <!-- apra-fleet-dm5.1: short human "run title" sentence (workflow-
199
+ specific fields such as members/issue-ids/goal, when the running
200
+ workflow publishes them), rendered by renderState() below via
201
+ buildRunTitle(state). Falls back to the plain workflow name
202
+ (still non-empty, never blank) whenever the relevant fields
203
+ aren't populated. -->
204
+ <div id="run-title" class="run-title"></div>
205
+ </div>
176
206
  <div class="header-actions">
177
207
  <!-- apra-fleet-eft.37.3: generic, workflow-agnostic display of
178
208
  state.result's top-level SCALAR fields -- populated (or hidden,
@@ -181,12 +211,28 @@ const HTML_TEMPLATE = (dashboardExtensions, opts = {}) => {
181
211
  (e.g. auto-sprint's verdict badge/PR link) is layered on by a
182
212
  dashboard extension's own js, not here. -->
183
213
  <div class="stats-banner" id="result-strip" style="display: none;"></div>
214
+ <!-- (apra-fleet-p2to.2.1) 'paused since <ts>' badge + reason card --
215
+ shown only while state.pause.status === 'paused' (renderState()
216
+ below); hidden for the process-free History view exactly like
217
+ Save/Stop, since a finished run can never be paused. -->
218
+ ${isHistory ? '' : '<div class="stats-banner pause-banner" id="pause-banner" style="display: none;"></div>'}
184
219
  <div class="stats-banner" id="stats-banner"></div>
185
220
  <div id="status-indicator" style="font-size: 12px; font-weight: 600; min-width: 70px; text-align: center;"></div>
186
221
  ${isHistory ? '' : '<button class="btn btn-save" onclick="saveState()">Save</button>'}
222
+ ${isHistory ? '' : '<button class="btn btn-pause" id="btn-pause" onclick="pauseWorkflow()">Pause</button>'}
187
223
  ${isHistory ? '' : '<button class="btn btn-stop" onclick="stopWorkflow()">Stop</button>'}
188
224
  </div>
189
225
  </div>
226
+ ${isHistory ? '' : `<div class="modal-overlay" id="stop-modal-overlay">
227
+ <div class="modal-box">
228
+ <p>Are you sure you want to forcibly stop the workflow?</p>
229
+ <div class="modal-actions">
230
+ <button class="btn btn-secondary" onclick="closeStopModal()">Cancel</button>
231
+ <button class="btn btn-stop" onclick="confirmStopWorkflow()">Stop</button>
232
+ </div>
233
+ </div>
234
+ </div>
235
+ <div class="toast" id="stop-toast">Stop signal sent.</div>`}
190
236
  <div class="main-content">
191
237
  <div class="content-area">
192
238
  <div class="tab-bar" id="tab-bar">
@@ -202,7 +248,10 @@ const HTML_TEMPLATE = (dashboardExtensions, opts = {}) => {
202
248
  </div>
203
249
  ${dashboardExtensions.map(ext => `
204
250
  <div id="tab-${ext.id}" class="tab-content panel">
205
- <div class="panel-header">${ext.title}</div>
251
+ <div class="panel-header" id="panel-header-${ext.id}" style="display: flex; justify-content: space-between; align-items: center; gap: 12px;">
252
+ <span>${ext.title}</span>
253
+ <div id="panel-header-${ext.id}-extra" style="flex: 1; min-width: 0; max-width: 320px; text-transform: none; letter-spacing: normal;"></div>
254
+ </div>
206
255
  <div id="extension-${ext.id}" style="flex: 1; min-height: 0; padding: 12px; overflow-y: auto;"></div>
207
256
  </div>
208
257
  `).join('\\n')}
@@ -218,30 +267,56 @@ const HTML_TEMPLATE = (dashboardExtensions, opts = {}) => {
218
267
  document.getElementById('tab-' + id).classList.add('active');
219
268
  }
220
269
 
270
+ // apra-fleet-4wr.1: the ONE shared h/m/s duration formatter -- every
271
+ // duration display in this viewer (live elapsed, closed/frozen phase and
272
+ // activity durations, the stats-banner Uptime) goes through this, so a
273
+ // closed row and a live row of the same elapsed value render identically
274
+ // instead of one showing raw/decimal seconds and the other h/m/s.
275
+ // ms == null (missing -- not yet known) is the ONLY case that renders
276
+ // the '-' placeholder; a genuine zero or sub-second duration renders
277
+ // '0s', never '-'.
221
278
  function formatTime(ms) {
222
- if (!ms) return '-';
223
- return (ms / 1000).toFixed(1) + 's';
224
- }
225
-
226
- function formatUptime(ms) {
227
- if (!ms || ms < 0) return '0s';
279
+ if (ms === null || ms === undefined) return '-';
280
+ // apra-fleet-x8r.6: a frozen phase carrying an end timestamp but no/
281
+ // invalid start timestamp (or any other NaN-producing input) must fall
282
+ // back to the same '-' placeholder as the missing-value case above,
283
+ // never the literal string 'NaNs'.
284
+ if (!Number.isFinite(ms)) return '-';
285
+ if (ms < 0) return '0s';
228
286
  let secs = Math.floor(ms / 1000);
229
287
  let mins = Math.floor(secs / 60);
230
288
  let hrs = Math.floor(mins / 60);
231
289
  secs = secs % 60;
232
290
  mins = mins % 60;
233
-
291
+
234
292
  let out = [];
235
293
  if (hrs > 0) out.push(hrs + 'hr');
236
294
  if (mins > 0) out.push(mins + 'm');
237
295
  out.push(secs + 's');
238
296
  return out.join(' ');
239
297
  }
298
+
299
+ // Live (still-running) elapsed durations, ticked forward on every
300
+ // render/poll from Date.now() - startTime -- delegates to formatTime()
301
+ // for the actual h/m/s formatting (the shared formatter above), only
302
+ // differing in that a falsy/negative/missing ms (nothing meaningful to
303
+ // show yet) renders '0s' rather than formatTime's own '-' missing-value
304
+ // case, since a live row always has SOME elapsed value once it starts.
305
+ function formatUptime(ms) {
306
+ if (!ms || ms < 0) return '0s';
307
+ return formatTime(ms);
308
+ }
240
309
 
241
310
  // Shared with dashboard extensions -- see src/viewer/html-utils.mjs for
242
311
  // why this is embedded via escapeHtml.toString() instead of duplicated.
243
312
  ${escapeHtml.toString()}
244
313
 
314
+ // apra-fleet-dm5.1: buildRunTitle() references escapeHtml by bare name
315
+ // (not an import) -- embedded here, right after escapeHtml itself, so
316
+ // that identifier resolves in this plain <script> tag exactly as it
317
+ // does in run-title.mjs's real ES-module scope.
318
+ ${buildRunTitle.toString()}
319
+
245
320
  // apra-fleet-eft.27.1: GET /state's lean list-state payload dedupes
246
321
  // repeated strings into a shared \`_strings\` table (see
247
322
  // src/viewer/lean-state.mjs) -- this is that module's resolveStringRefs()
@@ -262,13 +337,52 @@ const HTML_TEMPLATE = (dashboardExtensions, opts = {}) => {
262
337
  a.click();
263
338
  }
264
339
 
265
- async function stopWorkflow() {
266
- if (confirm('Are you sure you want to forcibly stop the workflow?')) {
267
- await fetch('/stop', { method: 'POST' });
268
- alert('Stop signal sent.');
269
- }
340
+ // apra-fleet-4yr.1: in-page modal replaces window.confirm() for the
341
+ // Stop confirmation step (the safety check itself stays -- only the
342
+ // native dialog is replaced), and a non-blocking toast replaces
343
+ // window.alert() once /stop resolves.
344
+ function stopWorkflow() {
345
+ const overlay = document.getElementById('stop-modal-overlay');
346
+ if (overlay) overlay.classList.add('open');
347
+ }
348
+
349
+ function closeStopModal() {
350
+ const overlay = document.getElementById('stop-modal-overlay');
351
+ if (overlay) overlay.classList.remove('open');
352
+ }
353
+
354
+ function showStopToast() {
355
+ const toast = document.getElementById('stop-toast');
356
+ if (!toast) return;
357
+ toast.classList.add('show');
358
+ setTimeout(() => toast.classList.remove('show'), 3000);
359
+ }
360
+
361
+ async function confirmStopWorkflow() {
362
+ closeStopModal();
363
+ await fetch('/stop', { method: 'POST' });
364
+ showStopToast();
365
+ }
366
+
367
+ document.addEventListener('keydown', (ev) => {
368
+ if (ev.key === 'Escape') closeStopModal();
369
+ });
370
+
371
+ // (apra-fleet-p2to.2.1) Pause/Resume -- unlike stopWorkflow() these never
372
+ // set button state directly: POST /pause and /resume only forward the
373
+ // request to the engine (which may defer the actual pause), and the
374
+ // button's label/enabled-state + the 'paused since' badge are entirely
375
+ // driven by renderState()'s reading of state.pause on the next poll/SSE
376
+ // tick, below. That keeps the button truthful about what the engine has
377
+ // ACTUALLY done rather than what the browser merely asked for.
378
+ async function pauseWorkflow() {
379
+ await fetch('/pause', { method: 'POST' });
380
+ }
381
+ async function resumeWorkflow() {
382
+ await fetch('/resume', { method: 'POST' });
270
383
  }
271
384
 
385
+
272
386
  let allExpanded = true;
273
387
  function toggleAllGlobal() {
274
388
  allExpanded = !allExpanded;
@@ -680,12 +794,63 @@ const HTML_TEMPLATE = (dashboardExtensions, opts = {}) => {
680
794
 
681
795
  document.getElementById('workflow-name').textContent = state.workflowName;
682
796
 
797
+ // apra-fleet-dm5.1: buildRunTitle() returns an ALREADY-ESCAPED HTML
798
+ // fragment (every user-supplied piece -- member names, bead ids,
799
+ // goal -- individually run through escapeHtml before being embedded
800
+ // into the sentence), safe to assign directly here.
801
+ const runTitleEl = document.getElementById('run-title');
802
+ if (runTitleEl) runTitleEl.innerHTML = buildRunTitle(state);
803
+
683
804
  const ind = document.getElementById('status-indicator');
684
805
  if (state.status === 'running') { ind.innerHTML = '<div class="status-live-indicator"><div class="led"></div> LIVE</div>'; }
685
806
  else if (state.status === 'success') { ind.innerHTML = '<span style="color:var(--success)">DONE</span>'; }
686
807
  else if (state.status === 'cancelled') { ind.innerHTML = '<span style="color:var(--warning)">CANCELLED</span>'; }
687
808
  else { ind.innerHTML = '<span style="color:var(--danger)">FAILED</span>'; }
688
809
 
810
+ // (apra-fleet-p2to.2.1) Pause/Resume button state machine: Pause ->
811
+ // Pausing -> Paused -> Resume, driven entirely by state.pause.status
812
+ // (itself set only by the engine's own 'pause:requested'/'paused'/
813
+ // 'resumed' events -- see the workflow.on() wiring in
814
+ // createDashboardViewer()). Absent for the History view, which never
815
+ // renders the button at all.
816
+ const pauseBtn = document.getElementById('btn-pause');
817
+ if (pauseBtn) {
818
+ const pause = state.pause || { status: 'none' };
819
+ if (pause.status === 'paused') {
820
+ pauseBtn.textContent = 'Resume';
821
+ pauseBtn.onclick = resumeWorkflow;
822
+ pauseBtn.disabled = false;
823
+ } else if (pause.status === 'pausing') {
824
+ pauseBtn.textContent = 'Pausing...';
825
+ pauseBtn.onclick = null;
826
+ pauseBtn.disabled = true;
827
+ } else {
828
+ pauseBtn.textContent = 'Pause';
829
+ pauseBtn.onclick = pauseWorkflow;
830
+ // Nothing to pause once the run isn't live anymore.
831
+ pauseBtn.disabled = (state.status !== 'running');
832
+ }
833
+ }
834
+
835
+ // 'paused since <ts>' badge + reason card -- shown only while the
836
+ // pause has actually engaged (status === 'paused'), never during the
837
+ // deferred 'pausing' window, since nothing has happened yet from the
838
+ // dashboard's point of view.
839
+ const pauseBanner = document.getElementById('pause-banner');
840
+ if (pauseBanner) {
841
+ const pause = state.pause || { status: 'none' };
842
+ if (pause.status === 'paused') {
843
+ const sinceStr = pause.since ? new Date(pause.since).toLocaleTimeString([], { hour12: false }) : '-';
844
+ const reasonHtml = pause.reason ? \`<span>Reason: <strong>\${escapeHtml(pause.reason)}</strong></span>\` : '';
845
+ const phaseHtml = pause.phase ? \`<span>Phase: <strong>\${escapeHtml(pause.phase)}</strong></span>\` : '';
846
+ pauseBanner.innerHTML = \`<span>Paused since <strong>\${sinceStr}</strong></span>\${phaseHtml}\${reasonHtml}\`;
847
+ pauseBanner.style.display = 'flex';
848
+ } else {
849
+ pauseBanner.innerHTML = '';
850
+ pauseBanner.style.display = 'none';
851
+ }
852
+ }
853
+
689
854
  const dur = state.status === 'running' ? Date.now() - state.stats.startTime : state.stats.durationMs;
690
855
  const unknownCostSuffix = state.stats.unknownCostCount > 0 ? \` <span style="color:var(--warning)">(+\${state.stats.unknownCostCount} unknown)</span>\` : '';
691
856
  document.getElementById('stats-banner').innerHTML =
@@ -808,6 +973,23 @@ function findActivityById(state, id) {
808
973
  // for).
809
974
  export { HTML_TEMPLATE };
810
975
 
976
+ /**
977
+ * Creates a live dashboard viewer HTTP server for a workflow run.
978
+ * @param {import('../workflow/index.mjs').FleetWorkflow} workflow
979
+ * @param {Object} opts - Options object
980
+ * @param {number} [opts.port=8080] - HTTP server port
981
+ * @param {string} [opts.runId] - Stable per-run identifier (generated if not provided)
982
+ * @param {string} [opts.name] - Workflow display name
983
+ * @param {string} [opts.debouncedStatePath] - Path to write state JSON (uses default if not provided)
984
+ * @param {*} [opts.launchArgs] - Opaque, free-form per-workflow metadata (NOT argv).
985
+ * `launchArgs` is passed through unchanged into state.args and is never inspected
986
+ * or interpreted by core -- consumers must feature-detect the fields they need
987
+ * rather than assuming a type. Examples: argv array from test callers
988
+ * (['--track', 'eft-service'], ['--foo', 'bar']), or a structured object from
989
+ * fleet-sprint (e.g., { members, targetIssues, goal }). Defaults to null if omitted.
990
+ * @param {Array} [opts.dashboardExtensions] - Dashboard widget extensions
991
+ * @param {Object} [opts.env] - Environment variables (defaults to process.env)
992
+ */
811
993
  export function createDashboardViewer(workflow, opts = {}) {
812
994
  const port = (typeof opts.port === 'number') ? opts.port : 8080;
813
995
  const dashboardExtensions = opts.dashboardExtensions || [];
@@ -852,6 +1034,12 @@ export function createDashboardViewer(workflow, opts = {}) {
852
1034
  // a mid-run read of the file shows in-progress state, not just
853
1035
  // the terminal shape.
854
1036
  runId,
1037
+ // apra-fleet-x8r.10: launchArgs is opaque, free-form, per-workflow
1038
+ // metadata (NOT argv). Core never inspects or interprets it; consumers
1039
+ // must feature-detect the fields they need rather than assuming a type.
1040
+ // Examples: argv array from test callers (['--track', 'eft-service'],
1041
+ // ['--foo', 'bar']), or a structured object from fleet-sprint
1042
+ // ({ members, targetIssues, goal }).
855
1043
  args: opts.launchArgs ?? null,
856
1044
  // apra-fleet-eft.37.3: `result` is the workflow script's own return
857
1045
  // value, stored WHOLESALE and OPAQUELY -- core never inspects or
@@ -876,6 +1064,21 @@ export function createDashboardViewer(workflow, opts = {}) {
876
1064
  startTime: Date.now(),
877
1065
  durationMs: 0
878
1066
  },
1067
+ // (apra-fleet-p2to.2.1) Generic pause lifecycle, driven entirely by
1068
+ // the engine's 'pause:requested'/'paused'/'resumed' events wired up
1069
+ // below -- never mutated directly by any route handler. `status` is
1070
+ // one of 'none' (not paused/requested), 'pausing' (requested, still
1071
+ // draining in-flight work / waiting on the script's pause guard) or
1072
+ // 'paused' (engaged: new agent()/command() dispatches are blocked at
1073
+ // the gate). `reason` is carried from the requestPause() call that
1074
+ // started this cycle (the 'paused' event itself carries no reason,
1075
+ // see FleetWorkflow._maybeEngagePause -- so it is preserved here
1076
+ // rather than re-read from that event); `since` is stamped locally
1077
+ // when 'paused' actually fires (the engine event carries no
1078
+ // timestamp). `phase`/`group` mirror wherever the run was when the
1079
+ // pause was requested, for the dashboard's reason card. Generic to
1080
+ // any workflow -- no fleet-sprint-specific fields.
1081
+ pause: { status: 'none', reason: null, since: null, phase: null, group: null },
879
1082
  tree: [],
880
1083
  extensions: {}
881
1084
  };
@@ -1121,6 +1324,45 @@ export function createDashboardViewer(workflow, opts = {}) {
1121
1324
  broadcast({ type: 'state', payload: stateData });
1122
1325
  });
1123
1326
 
1327
+ // (apra-fleet-p2to.2.1) Generic pause lifecycle wiring, mirroring how
1328
+ // 'end' below derives dashboard state entirely from engine events --
1329
+ // the /pause and /resume routes (below) only forward the request to
1330
+ // FleetWorkflow.requestPause()/requestResume() (src/workflow/index.mjs);
1331
+ // every actual state.pause transition happens here, driven by the
1332
+ // engine's own 'pause:requested'/'paused'/'resumed' events, so the
1333
+ // dashboard reflects when a deferred pause has ACTUALLY engaged, not
1334
+ // merely when it was requested.
1335
+ workflow.on('pause:requested', (payload) => {
1336
+ state.pause = {
1337
+ status: 'pausing',
1338
+ reason: payload.reason ?? null,
1339
+ since: null,
1340
+ phase: payload.phase ?? null,
1341
+ group: payload.group ?? null
1342
+ };
1343
+ broadcast({ type: 'update' });
1344
+ });
1345
+
1346
+ workflow.on('paused', (payload) => {
1347
+ // The 'paused' event itself carries no reason (see
1348
+ // FleetWorkflow._maybeEngagePause) -- preserve whatever
1349
+ // 'pause:requested' set, and only stamp `since` now, at the moment
1350
+ // the pause actually engaged.
1351
+ state.pause = {
1352
+ status: 'paused',
1353
+ reason: state.pause.reason,
1354
+ since: nowIso(),
1355
+ phase: payload.phase ?? state.pause.phase,
1356
+ group: payload.group ?? state.pause.group
1357
+ };
1358
+ broadcast({ type: 'update' });
1359
+ });
1360
+
1361
+ workflow.on('resumed', () => {
1362
+ state.pause = { status: 'none', reason: null, since: null, phase: null, group: null };
1363
+ broadcast({ type: 'update' });
1364
+ });
1365
+
1124
1366
  workflow.on('end', (res) => {
1125
1367
  // apra-fleet-eft.53.1: the run's final phase never gets a 'phase'
1126
1368
  // event to close it out -- stamp its phaseEndedAt here so no phase
@@ -1286,6 +1528,44 @@ export function createDashboardViewer(workflow, opts = {}) {
1286
1528
  debouncedWriter.flushSync();
1287
1529
  res.writeHead(200);
1288
1530
  res.end();
1531
+ } else if (req.url === '/pause' && req.method === 'POST') {
1532
+ // (apra-fleet-p2to.2.1) Cooperative pause -- same shape as /stop
1533
+ // above, but forwards to FleetWorkflow.requestPause() instead of
1534
+ // requestStop(). That call only fires 'pause:requested'
1535
+ // immediately; the pause itself is DEFERRED until the run drains
1536
+ // to zero in-flight activities and any script-registered pause
1537
+ // guard permits it (see requestPause()'s doc, src/workflow/
1538
+ // index.mjs) -- the workflow event listeners above are what
1539
+ // actually flip state.pause once 'paused' fires, exactly like
1540
+ // /stop leaves the terminal state.status transition to the
1541
+ // workflow's own 'end' handler rather than setting it here.
1542
+ console.log('[Viewer] Pause requested via dashboard /pause endpoint.');
1543
+ if (typeof workflow.requestPause === 'function') {
1544
+ workflow.requestPause('Pause requested via dashboard /pause endpoint');
1545
+ }
1546
+ debouncedWriter.flushSync();
1547
+ res.writeHead(200);
1548
+ res.end();
1549
+ } else if (req.url === '/resume' && req.method === 'POST') {
1550
+ // (apra-fleet-p2to.2.1) Cooperative resume -- mirrors /pause
1551
+ // above, forwarding to FleetWorkflow.requestResume(). A no-op on
1552
+ // the engine side if the run is neither paused nor pause-
1553
+ // requested; the 'resumed' event listener above clears
1554
+ // state.pause once it fires.
1555
+ console.log('[Viewer] Resume requested via dashboard /resume endpoint.');
1556
+ if (typeof workflow.requestResume === 'function') {
1557
+ // (apra-fleet-p2to.1.3) requestResume() is now async -- it
1558
+ // awaits a pre-resume barrier (member re-reserve/resync) before
1559
+ // it completes. Don't block the HTTP response on that barrier,
1560
+ // but do catch a barrier rejection so it surfaces as a log line
1561
+ // rather than an unhandled promise rejection; the run stays
1562
+ // paused on failure, exactly as the engine leaves it.
1563
+ Promise.resolve(workflow.requestResume('Resume requested via dashboard /resume endpoint'))
1564
+ .catch((err) => console.error('[Viewer] resume barrier failed (run stays paused):', err && err.message ? err.message : err));
1565
+ }
1566
+ debouncedWriter.flushSync();
1567
+ res.writeHead(200);
1568
+ res.end();
1289
1569
  } else if (req.url === '/save_logs' && req.method === 'POST') {
1290
1570
  // Manual/scriptable trigger for the same server-side save that
1291
1571
  // 'end' and SIGINT/SIGTERM already perform (persistState() above)
@@ -0,0 +1,60 @@
1
+ import { escapeHtml } from './html-utils.mjs';
2
+
3
+ /**
4
+ * apra-fleet-dm5.1: builds a short, human-readable "run title" sentence for
5
+ * the workflow viewer's header -- e.g.
6
+ * "win-dev1 working apra-fleet-x8r, apra-fleet-dm5 (P1/P2/P3)" for a
7
+ * fleet-sprint run -- instead of the bare workflow name the header showed
8
+ * before this.
9
+ *
10
+ * Reads `state.args` (apra-fleet-eft.2.2's `launchArgs`-derived field,
11
+ * currently populated only where a caller opts in -- apra-fleet-dm5.2 wires
12
+ * fleet-sprint's own runner.js to actually publish it). Deliberately reads
13
+ * only three plain, additive fields off it -- `members` (string[]),
14
+ * `targetIssues` (string[], the sprint's issue-root ids), `goal` (string,
15
+ * e.g. 'P1/P2') -- so this stays workflow-agnostic: any OTHER workflow's
16
+ * `args` shape (or no `args` at all) simply doesn't have these three fields
17
+ * and falls through to the plain workflow-name fallback below, never
18
+ * throwing and never rendering 'undefined'/an empty parenthetical/a
19
+ * dangling separator.
20
+ *
21
+ * Returns an ALREADY HTML-ESCAPED string (every user-supplied piece --
22
+ * member names, bead ids, the goal string -- is run through the shared
23
+ * `escapeHtml()` before being embedded into the sentence), safe to assign
24
+ * directly to an element's `innerHTML` in the browser-side render code
25
+ * below. This function's OWN source text is also embedded verbatim (via
26
+ * `.toString()`) into that same client-side `<script>`, same pattern as
27
+ * `renderBeadsHtml`/`escapeHtml` elsewhere in this codebase, so the exact
28
+ * code under test here is the exact code that renders in the browser.
29
+ *
30
+ * @param {{ workflowName?: string, args?: { members?: string[], targetIssues?: string[], goal?: string } } | null | undefined} state
31
+ * @returns {string}
32
+ */
33
+ export function buildRunTitle(state) {
34
+ const s = (state && typeof state === 'object') ? state : {};
35
+ const fallback = escapeHtml(
36
+ (typeof s.workflowName === 'string' && s.workflowName.length > 0) ? s.workflowName : 'Apra Fleet Workflow'
37
+ );
38
+
39
+ const args = (s.args && typeof s.args === 'object') ? s.args : null;
40
+ if (!args) return fallback;
41
+
42
+ const members = Array.isArray(args.members)
43
+ ? args.members.filter((m) => typeof m === 'string' && m.length > 0)
44
+ : [];
45
+ const targetIssues = Array.isArray(args.targetIssues)
46
+ ? args.targetIssues.filter((i) => typeof i === 'string' && i.length > 0)
47
+ : [];
48
+ const goal = (typeof args.goal === 'string' && args.goal.length > 0) ? args.goal : '';
49
+
50
+ // Every field is required to build the full sentence -- a partial set
51
+ // (e.g. members known but no goal yet) degrades cleanly to the plain
52
+ // workflow name rather than rendering a sentence with a missing clause.
53
+ if (members.length === 0 || targetIssues.length === 0 || goal.length === 0) return fallback;
54
+
55
+ const membersText = escapeHtml(members.join(', '));
56
+ const issuesText = escapeHtml(targetIssues.join(', '));
57
+ const goalText = escapeHtml(goal);
58
+
59
+ return `${membersText} working ${issuesText} (${goalText})`;
60
+ }