@apralabs/apra-fleet 0.3.6 → 0.4.1

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 (826) hide show
  1. package/README.md +378 -252
  2. package/dist/agents/backlog-groomer.md +303 -0
  3. package/dist/agents/ci-watcher.md +13 -1
  4. package/dist/agents/deployer.md +66 -13
  5. package/dist/agents/doer.md +67 -8
  6. package/dist/agents/harvester.md +22 -3
  7. package/dist/agents/integ-test-runner.md +166 -60
  8. package/dist/agents/kb-reconciler.md +216 -0
  9. package/dist/agents/plan-reviewer.md +88 -18
  10. package/dist/agents/planner.md +182 -19
  11. package/dist/agents/regression-test-runner.md +234 -0
  12. package/dist/agents/reviewer.md +125 -9
  13. package/dist/agents/schemas/backlog-groomer-input.json +35 -0
  14. package/dist/agents/schemas/backlog-groomer-output.json +164 -0
  15. package/dist/agents/schemas/doer-output.json +63 -3
  16. package/dist/agents/schemas/harvester-output.json +59 -2
  17. package/dist/agents/schemas/integ-test-runner-output.json +34 -0
  18. package/dist/agents/schemas/kb-reconciler-output.json +87 -0
  19. package/dist/agents/schemas/planner-output.json +65 -0
  20. package/dist/agents/schemas/regression-test-runner-input.json +15 -0
  21. package/dist/agents/schemas/regression-test-runner-output.json +50 -0
  22. package/dist/agents/schemas/reviewer-output.json +108 -7
  23. package/dist/cli/agent-transform.d.ts +1 -0
  24. package/dist/cli/agent-transform.d.ts.map +1 -1
  25. package/dist/cli/agent-transform.js +77 -0
  26. package/dist/cli/agent-transform.js.map +1 -1
  27. package/dist/cli/auth.d.ts +3 -0
  28. package/dist/cli/auth.d.ts.map +1 -1
  29. package/dist/cli/auth.js +181 -5
  30. package/dist/cli/auth.js.map +1 -1
  31. package/dist/cli/config.d.ts +5 -1
  32. package/dist/cli/config.d.ts.map +1 -1
  33. package/dist/cli/config.js +7 -1
  34. package/dist/cli/config.js.map +1 -1
  35. package/dist/cli/dolt-install.d.ts +91 -0
  36. package/dist/cli/dolt-install.d.ts.map +1 -0
  37. package/dist/cli/dolt-install.js +334 -0
  38. package/dist/cli/dolt-install.js.map +1 -0
  39. package/dist/cli/install-guard.d.ts +29 -0
  40. package/dist/cli/install-guard.d.ts.map +1 -0
  41. package/dist/cli/install-guard.js +153 -0
  42. package/dist/cli/install-guard.js.map +1 -0
  43. package/dist/cli/install.d.ts +45 -3
  44. package/dist/cli/install.d.ts.map +1 -1
  45. package/dist/cli/install.js +736 -109
  46. package/dist/cli/install.js.map +1 -1
  47. package/dist/cli/join.d.ts +12 -0
  48. package/dist/cli/join.d.ts.map +1 -0
  49. package/dist/cli/join.js +87 -0
  50. package/dist/cli/join.js.map +1 -0
  51. package/dist/cli/kb-commit.d.ts +12 -0
  52. package/dist/cli/kb-commit.d.ts.map +1 -0
  53. package/dist/cli/kb-commit.js +53 -0
  54. package/dist/cli/kb-commit.js.map +1 -0
  55. package/dist/cli/kb-directives.d.ts +17 -0
  56. package/dist/cli/kb-directives.d.ts.map +1 -0
  57. package/dist/cli/kb-directives.js +146 -0
  58. package/dist/cli/kb-directives.js.map +1 -0
  59. package/dist/cli/kb-import.d.ts +13 -0
  60. package/dist/cli/kb-import.d.ts.map +1 -0
  61. package/dist/cli/kb-import.js +56 -0
  62. package/dist/cli/kb-import.js.map +1 -0
  63. package/dist/cli/register-member.d.ts +2 -0
  64. package/dist/cli/register-member.d.ts.map +1 -0
  65. package/dist/cli/register-member.js +193 -0
  66. package/dist/cli/register-member.js.map +1 -0
  67. package/dist/cli/restart.d.ts +2 -0
  68. package/dist/cli/restart.d.ts.map +1 -0
  69. package/dist/cli/restart.js +7 -0
  70. package/dist/cli/restart.js.map +1 -0
  71. package/dist/cli/spoke.d.ts +35 -0
  72. package/dist/cli/spoke.d.ts.map +1 -0
  73. package/dist/cli/spoke.js +212 -0
  74. package/dist/cli/spoke.js.map +1 -0
  75. package/dist/cli/start.d.ts +2 -0
  76. package/dist/cli/start.d.ts.map +1 -0
  77. package/dist/cli/start.js +92 -0
  78. package/dist/cli/start.js.map +1 -0
  79. package/dist/cli/status.d.ts +2 -0
  80. package/dist/cli/status.d.ts.map +1 -0
  81. package/dist/cli/status.js +83 -0
  82. package/dist/cli/status.js.map +1 -0
  83. package/dist/cli/stop.d.ts +2 -0
  84. package/dist/cli/stop.d.ts.map +1 -0
  85. package/dist/cli/stop.js +51 -0
  86. package/dist/cli/stop.js.map +1 -0
  87. package/dist/cli/uninstall.d.ts.map +1 -1
  88. package/dist/cli/uninstall.js +120 -9
  89. package/dist/cli/uninstall.js.map +1 -1
  90. package/dist/cli/update.d.ts.map +1 -1
  91. package/dist/cli/update.js +10 -1
  92. package/dist/cli/update.js.map +1 -1
  93. package/dist/cli/watch.d.ts +53 -4
  94. package/dist/cli/watch.d.ts.map +1 -1
  95. package/dist/cli/watch.js +118 -17
  96. package/dist/cli/watch.js.map +1 -1
  97. package/dist/cli/workflow-assets.d.ts +37 -0
  98. package/dist/cli/workflow-assets.d.ts.map +1 -0
  99. package/dist/cli/workflow-assets.js +144 -0
  100. package/dist/cli/workflow-assets.js.map +1 -0
  101. package/dist/cli/workflow.d.ts +75 -0
  102. package/dist/cli/workflow.d.ts.map +1 -0
  103. package/dist/cli/workflow.js +397 -0
  104. package/dist/cli/workflow.js.map +1 -0
  105. package/dist/commands/kb-server.d.ts +8 -0
  106. package/dist/commands/kb-server.d.ts.map +1 -0
  107. package/dist/commands/kb-server.js +221 -0
  108. package/dist/commands/kb-server.js.map +1 -0
  109. package/dist/hub-service/activity.d.ts +30 -0
  110. package/dist/hub-service/activity.d.ts.map +1 -0
  111. package/dist/hub-service/activity.js +20 -0
  112. package/dist/hub-service/activity.js.map +1 -0
  113. package/dist/hub-service/audit-log.d.ts +19 -0
  114. package/dist/hub-service/audit-log.d.ts.map +1 -0
  115. package/dist/hub-service/audit-log.js +13 -0
  116. package/dist/hub-service/audit-log.js.map +1 -0
  117. package/dist/hub-service/db/pool.d.ts +19 -0
  118. package/dist/hub-service/db/pool.d.ts.map +1 -0
  119. package/dist/hub-service/db/pool.js +53 -0
  120. package/dist/hub-service/db/pool.js.map +1 -0
  121. package/dist/hub-service/enrollment.d.ts +29 -0
  122. package/dist/hub-service/enrollment.d.ts.map +1 -0
  123. package/dist/hub-service/enrollment.js +48 -0
  124. package/dist/hub-service/enrollment.js.map +1 -0
  125. package/dist/hub-service/envelope-routes.d.ts +46 -0
  126. package/dist/hub-service/envelope-routes.d.ts.map +1 -0
  127. package/dist/hub-service/envelope-routes.js +94 -0
  128. package/dist/hub-service/envelope-routes.js.map +1 -0
  129. package/dist/hub-service/handlers/installers.d.ts +14 -0
  130. package/dist/hub-service/handlers/installers.d.ts.map +1 -0
  131. package/dist/hub-service/handlers/installers.js +8 -0
  132. package/dist/hub-service/handlers/installers.js.map +1 -0
  133. package/dist/hub-service/http-server.d.ts +31 -0
  134. package/dist/hub-service/http-server.d.ts.map +1 -0
  135. package/dist/hub-service/http-server.js +711 -0
  136. package/dist/hub-service/http-server.js.map +1 -0
  137. package/dist/hub-service/hub-jwt.d.ts +30 -0
  138. package/dist/hub-service/hub-jwt.d.ts.map +1 -0
  139. package/dist/hub-service/hub-jwt.js +105 -0
  140. package/dist/hub-service/hub-jwt.js.map +1 -0
  141. package/dist/hub-service/jwt-revocation.d.ts +20 -0
  142. package/dist/hub-service/jwt-revocation.d.ts.map +1 -0
  143. package/dist/hub-service/jwt-revocation.js +18 -0
  144. package/dist/hub-service/jwt-revocation.js.map +1 -0
  145. package/dist/hub-service/machines.d.ts +16 -0
  146. package/dist/hub-service/machines.d.ts.map +1 -0
  147. package/dist/hub-service/machines.js +14 -0
  148. package/dist/hub-service/machines.js.map +1 -0
  149. package/dist/hub-service/main.d.ts +3 -0
  150. package/dist/hub-service/main.d.ts.map +1 -0
  151. package/dist/hub-service/main.js +64 -0
  152. package/dist/hub-service/main.js.map +1 -0
  153. package/dist/hub-service/member-tokens.d.ts +11 -0
  154. package/dist/hub-service/member-tokens.d.ts.map +1 -0
  155. package/dist/hub-service/member-tokens.js +49 -0
  156. package/dist/hub-service/member-tokens.js.map +1 -0
  157. package/dist/hub-service/member-view.d.ts +20 -0
  158. package/dist/hub-service/member-view.d.ts.map +1 -0
  159. package/dist/hub-service/member-view.js +76 -0
  160. package/dist/hub-service/member-view.js.map +1 -0
  161. package/dist/hub-service/members.d.ts +44 -0
  162. package/dist/hub-service/members.d.ts.map +1 -0
  163. package/dist/hub-service/members.js +25 -0
  164. package/dist/hub-service/members.js.map +1 -0
  165. package/dist/hub-service/presence.d.ts +40 -0
  166. package/dist/hub-service/presence.d.ts.map +1 -0
  167. package/dist/hub-service/presence.js +44 -0
  168. package/dist/hub-service/presence.js.map +1 -0
  169. package/dist/hub-service/project-view.d.ts +12 -0
  170. package/dist/hub-service/project-view.d.ts.map +1 -0
  171. package/dist/hub-service/project-view.js +34 -0
  172. package/dist/hub-service/project-view.js.map +1 -0
  173. package/dist/hub-service/projects.d.ts +48 -0
  174. package/dist/hub-service/projects.d.ts.map +1 -0
  175. package/dist/hub-service/projects.js +80 -0
  176. package/dist/hub-service/projects.js.map +1 -0
  177. package/dist/hub-service/relay-queue.d.ts +115 -0
  178. package/dist/hub-service/relay-queue.d.ts.map +1 -0
  179. package/dist/hub-service/relay-queue.js +148 -0
  180. package/dist/hub-service/relay-queue.js.map +1 -0
  181. package/dist/hub-service/session-jwt.d.ts +10 -0
  182. package/dist/hub-service/session-jwt.d.ts.map +1 -0
  183. package/dist/hub-service/session-jwt.js +69 -0
  184. package/dist/hub-service/session-jwt.js.map +1 -0
  185. package/dist/hub-service/usage.d.ts +40 -0
  186. package/dist/hub-service/usage.d.ts.map +1 -0
  187. package/dist/hub-service/usage.js +25 -0
  188. package/dist/hub-service/usage.js.map +1 -0
  189. package/dist/hub-service/users.d.ts +56 -0
  190. package/dist/hub-service/users.d.ts.map +1 -0
  191. package/dist/hub-service/users.js +72 -0
  192. package/dist/hub-service/users.js.map +1 -0
  193. package/dist/hub-service/workspaces.d.ts +20 -0
  194. package/dist/hub-service/workspaces.d.ts.map +1 -0
  195. package/dist/hub-service/workspaces.js +10 -0
  196. package/dist/hub-service/workspaces.js.map +1 -0
  197. package/dist/index.js +254 -132
  198. package/dist/index.js.map +1 -1
  199. package/dist/os/linux.d.ts +14 -0
  200. package/dist/os/linux.d.ts.map +1 -1
  201. package/dist/os/linux.js +80 -4
  202. package/dist/os/linux.js.map +1 -1
  203. package/dist/os/os-commands.d.ts +15 -0
  204. package/dist/os/os-commands.d.ts.map +1 -1
  205. package/dist/os/windows.d.ts +36 -0
  206. package/dist/os/windows.d.ts.map +1 -1
  207. package/dist/os/windows.js +74 -18
  208. package/dist/os/windows.js.map +1 -1
  209. package/dist/paths.d.ts +23 -0
  210. package/dist/paths.d.ts.map +1 -1
  211. package/dist/paths.js +29 -0
  212. package/dist/paths.js.map +1 -1
  213. package/dist/providers/agy.d.ts +20 -2
  214. package/dist/providers/agy.d.ts.map +1 -1
  215. package/dist/providers/agy.js +259 -21
  216. package/dist/providers/agy.js.map +1 -1
  217. package/dist/providers/claude.d.ts +16 -2
  218. package/dist/providers/claude.d.ts.map +1 -1
  219. package/dist/providers/claude.js +283 -16
  220. package/dist/providers/claude.js.map +1 -1
  221. package/dist/providers/codex.d.ts +13 -2
  222. package/dist/providers/codex.d.ts.map +1 -1
  223. package/dist/providers/codex.js +36 -6
  224. package/dist/providers/codex.js.map +1 -1
  225. package/dist/providers/copilot.d.ts +13 -2
  226. package/dist/providers/copilot.d.ts.map +1 -1
  227. package/dist/providers/copilot.js +34 -7
  228. package/dist/providers/copilot.js.map +1 -1
  229. package/dist/providers/email/headers.d.ts +15 -0
  230. package/dist/providers/email/headers.d.ts.map +1 -0
  231. package/dist/providers/email/headers.js +42 -0
  232. package/dist/providers/email/headers.js.map +1 -0
  233. package/dist/providers/email/index.d.ts +18 -0
  234. package/dist/providers/email/index.d.ts.map +1 -0
  235. package/dist/providers/email/index.js +60 -0
  236. package/dist/providers/email/index.js.map +1 -0
  237. package/dist/providers/email/provider.d.ts +49 -0
  238. package/dist/providers/email/provider.d.ts.map +1 -0
  239. package/dist/providers/email/provider.js +2 -0
  240. package/dist/providers/email/provider.js.map +1 -0
  241. package/dist/providers/email/sendgrid.d.ts +12 -0
  242. package/dist/providers/email/sendgrid.d.ts.map +1 -0
  243. package/dist/providers/email/sendgrid.js +67 -0
  244. package/dist/providers/email/sendgrid.js.map +1 -0
  245. package/dist/providers/email/smtp.d.ts +65 -0
  246. package/dist/providers/email/smtp.d.ts.map +1 -0
  247. package/dist/providers/email/smtp.js +373 -0
  248. package/dist/providers/email/smtp.js.map +1 -0
  249. package/dist/providers/gemini.d.ts +13 -2
  250. package/dist/providers/gemini.d.ts.map +1 -1
  251. package/dist/providers/gemini.js +49 -5
  252. package/dist/providers/gemini.js.map +1 -1
  253. package/dist/providers/index.d.ts +1 -0
  254. package/dist/providers/index.d.ts.map +1 -1
  255. package/dist/providers/index.js +3 -0
  256. package/dist/providers/index.js.map +1 -1
  257. package/dist/providers/none.d.ts +61 -0
  258. package/dist/providers/none.d.ts.map +1 -0
  259. package/dist/providers/none.js +124 -0
  260. package/dist/providers/none.js.map +1 -0
  261. package/dist/providers/opencode.d.ts +14 -2
  262. package/dist/providers/opencode.d.ts.map +1 -1
  263. package/dist/providers/opencode.js +104 -4
  264. package/dist/providers/opencode.js.map +1 -1
  265. package/dist/providers/provider.d.ts +156 -1
  266. package/dist/providers/provider.d.ts.map +1 -1
  267. package/dist/providers/provider.js +54 -0
  268. package/dist/providers/provider.js.map +1 -1
  269. package/dist/services/agent-provisioner.d.ts +3 -3
  270. package/dist/services/agent-provisioner.d.ts.map +1 -1
  271. package/dist/services/agent-provisioner.js +11 -7
  272. package/dist/services/agent-provisioner.js.map +1 -1
  273. package/dist/services/auth-socket.d.ts.map +1 -1
  274. package/dist/services/auth-socket.js +2 -0
  275. package/dist/services/auth-socket.js.map +1 -1
  276. package/dist/services/budget-awareness.d.ts +130 -0
  277. package/dist/services/budget-awareness.d.ts.map +1 -0
  278. package/dist/services/budget-awareness.js +129 -0
  279. package/dist/services/budget-awareness.js.map +1 -0
  280. package/dist/services/cloud/lifecycle.d.ts.map +1 -1
  281. package/dist/services/cloud/lifecycle.js +3 -0
  282. package/dist/services/cloud/lifecycle.js.map +1 -1
  283. package/dist/services/cloud/task-wrapper.d.ts +18 -0
  284. package/dist/services/cloud/task-wrapper.d.ts.map +1 -1
  285. package/dist/services/cloud/task-wrapper.js +157 -0
  286. package/dist/services/cloud/task-wrapper.js.map +1 -1
  287. package/dist/services/cloud-sync.d.ts +35 -0
  288. package/dist/services/cloud-sync.d.ts.map +1 -0
  289. package/dist/services/cloud-sync.js +90 -0
  290. package/dist/services/cloud-sync.js.map +1 -0
  291. package/dist/services/context-admission.d.ts +82 -0
  292. package/dist/services/context-admission.d.ts.map +1 -0
  293. package/dist/services/context-admission.js +136 -0
  294. package/dist/services/context-admission.js.map +1 -0
  295. package/dist/services/event-bus.d.ts +27 -0
  296. package/dist/services/event-bus.d.ts.map +1 -0
  297. package/dist/services/event-bus.js +20 -0
  298. package/dist/services/event-bus.js.map +1 -0
  299. package/dist/services/file-chunker.d.ts +38 -0
  300. package/dist/services/file-chunker.d.ts.map +1 -0
  301. package/dist/services/file-chunker.js +63 -0
  302. package/dist/services/file-chunker.js.map +1 -0
  303. package/dist/services/file-transfer-relay.d.ts +55 -0
  304. package/dist/services/file-transfer-relay.d.ts.map +1 -0
  305. package/dist/services/file-transfer-relay.js +115 -0
  306. package/dist/services/file-transfer-relay.js.map +1 -0
  307. package/dist/services/github-app.d.ts.map +1 -1
  308. package/dist/services/github-app.js +12 -2
  309. package/dist/services/github-app.js.map +1 -1
  310. package/dist/services/http-transport.d.ts +25 -0
  311. package/dist/services/http-transport.d.ts.map +1 -0
  312. package/dist/services/http-transport.js +371 -0
  313. package/dist/services/http-transport.js.map +1 -0
  314. package/dist/services/hub-client.d.ts +69 -0
  315. package/dist/services/hub-client.d.ts.map +1 -0
  316. package/dist/services/hub-client.js +217 -0
  317. package/dist/services/hub-client.js.map +1 -0
  318. package/dist/services/jwt.d.ts +17 -0
  319. package/dist/services/jwt.d.ts.map +1 -0
  320. package/dist/services/jwt.js +70 -0
  321. package/dist/services/jwt.js.map +1 -0
  322. package/dist/services/knowledge/audn.d.ts +37 -0
  323. package/dist/services/knowledge/audn.d.ts.map +1 -0
  324. package/dist/services/knowledge/audn.js +219 -0
  325. package/dist/services/knowledge/audn.js.map +1 -0
  326. package/dist/services/knowledge/file-hash.d.ts +11 -0
  327. package/dist/services/knowledge/file-hash.d.ts.map +1 -0
  328. package/dist/services/knowledge/file-hash.js +123 -0
  329. package/dist/services/knowledge/file-hash.js.map +1 -0
  330. package/dist/services/knowledge/http-provider.d.ts +46 -0
  331. package/dist/services/knowledge/http-provider.d.ts.map +1 -0
  332. package/dist/services/knowledge/http-provider.js +254 -0
  333. package/dist/services/knowledge/http-provider.js.map +1 -0
  334. package/dist/services/knowledge/kb-providers.d.ts +15 -0
  335. package/dist/services/knowledge/kb-providers.d.ts.map +1 -0
  336. package/dist/services/knowledge/kb-providers.js +92 -0
  337. package/dist/services/knowledge/kb-providers.js.map +1 -0
  338. package/dist/services/knowledge/kb-scope-input.d.ts +5 -0
  339. package/dist/services/knowledge/kb-scope-input.d.ts.map +1 -0
  340. package/dist/services/knowledge/kb-scope-input.js +11 -0
  341. package/dist/services/knowledge/kb-scope-input.js.map +1 -0
  342. package/dist/services/knowledge/kb-service.d.ts +3 -0
  343. package/dist/services/knowledge/kb-service.d.ts.map +1 -0
  344. package/dist/services/knowledge/kb-service.js +2 -0
  345. package/dist/services/knowledge/kb-service.js.map +1 -0
  346. package/dist/services/knowledge/path-validation.d.ts +2 -0
  347. package/dist/services/knowledge/path-validation.d.ts.map +1 -0
  348. package/dist/services/knowledge/path-validation.js +13 -0
  349. package/dist/services/knowledge/path-validation.js.map +1 -0
  350. package/dist/services/knowledge/pre-init.d.ts +14 -0
  351. package/dist/services/knowledge/pre-init.d.ts.map +1 -0
  352. package/dist/services/knowledge/pre-init.js +147 -0
  353. package/dist/services/knowledge/pre-init.js.map +1 -0
  354. package/dist/services/knowledge/project-slug.d.ts +2 -0
  355. package/dist/services/knowledge/project-slug.d.ts.map +1 -0
  356. package/dist/services/knowledge/project-slug.js +49 -0
  357. package/dist/services/knowledge/project-slug.js.map +1 -0
  358. package/dist/services/knowledge/sqlite-provider.d.ts +147 -0
  359. package/dist/services/knowledge/sqlite-provider.d.ts.map +1 -0
  360. package/dist/services/knowledge/sqlite-provider.js +1646 -0
  361. package/dist/services/knowledge/sqlite-provider.js.map +1 -0
  362. package/dist/services/knowledge/types.d.ts +163 -0
  363. package/dist/services/knowledge/types.d.ts.map +1 -0
  364. package/dist/services/knowledge/types.js +9 -0
  365. package/dist/services/knowledge/types.js.map +1 -0
  366. package/dist/services/known-sessions.d.ts +8 -0
  367. package/dist/services/known-sessions.d.ts.map +1 -0
  368. package/dist/services/known-sessions.js +40 -0
  369. package/dist/services/known-sessions.js.map +1 -0
  370. package/dist/services/member-home.d.ts +89 -0
  371. package/dist/services/member-home.d.ts.map +1 -0
  372. package/dist/services/member-home.js +256 -0
  373. package/dist/services/member-home.js.map +1 -0
  374. package/dist/services/member-remote-url.d.ts +34 -0
  375. package/dist/services/member-remote-url.d.ts.map +1 -0
  376. package/dist/services/member-remote-url.js +39 -0
  377. package/dist/services/member-remote-url.js.map +1 -0
  378. package/dist/services/model-pricing.d.ts +36 -0
  379. package/dist/services/model-pricing.d.ts.map +1 -0
  380. package/dist/services/model-pricing.js +108 -0
  381. package/dist/services/model-pricing.js.map +1 -0
  382. package/dist/services/orphan-recovery.d.ts +59 -0
  383. package/dist/services/orphan-recovery.d.ts.map +1 -0
  384. package/dist/services/orphan-recovery.js +122 -0
  385. package/dist/services/orphan-recovery.js.map +1 -0
  386. package/dist/services/pending-responses.d.ts +23 -0
  387. package/dist/services/pending-responses.d.ts.map +1 -0
  388. package/dist/services/pending-responses.js +52 -0
  389. package/dist/services/pending-responses.js.map +1 -0
  390. package/dist/services/preflight-check.d.ts +56 -0
  391. package/dist/services/preflight-check.d.ts.map +1 -0
  392. package/dist/services/preflight-check.js +277 -0
  393. package/dist/services/preflight-check.js.map +1 -0
  394. package/dist/services/registry.d.ts +4 -1
  395. package/dist/services/registry.d.ts.map +1 -1
  396. package/dist/services/registry.js +3 -0
  397. package/dist/services/registry.js.map +1 -1
  398. package/dist/services/relay-context.d.ts +23 -0
  399. package/dist/services/relay-context.d.ts.map +1 -0
  400. package/dist/services/relay-context.js +8 -0
  401. package/dist/services/relay-context.js.map +1 -0
  402. package/dist/services/relay-executor.d.ts +68 -0
  403. package/dist/services/relay-executor.d.ts.map +1 -0
  404. package/dist/services/relay-executor.js +70 -0
  405. package/dist/services/relay-executor.js.map +1 -0
  406. package/dist/services/relay-request.d.ts +65 -0
  407. package/dist/services/relay-request.d.ts.map +1 -0
  408. package/dist/services/relay-request.js +129 -0
  409. package/dist/services/relay-request.js.map +1 -0
  410. package/dist/services/relay-strategy.d.ts +19 -0
  411. package/dist/services/relay-strategy.d.ts.map +1 -0
  412. package/dist/services/relay-strategy.js +111 -0
  413. package/dist/services/relay-strategy.js.map +1 -0
  414. package/dist/services/service-manager/index.d.ts +5 -0
  415. package/dist/services/service-manager/index.d.ts.map +1 -0
  416. package/dist/services/service-manager/index.js +66 -0
  417. package/dist/services/service-manager/index.js.map +1 -0
  418. package/dist/services/service-manager/linux.d.ts +10 -0
  419. package/dist/services/service-manager/linux.d.ts.map +1 -0
  420. package/dist/services/service-manager/linux.js +97 -0
  421. package/dist/services/service-manager/linux.js.map +1 -0
  422. package/dist/services/service-manager/macos.d.ts +10 -0
  423. package/dist/services/service-manager/macos.d.ts.map +1 -0
  424. package/dist/services/service-manager/macos.js +94 -0
  425. package/dist/services/service-manager/macos.js.map +1 -0
  426. package/dist/services/service-manager/types.d.ts +18 -0
  427. package/dist/services/service-manager/types.d.ts.map +1 -0
  428. package/dist/services/service-manager/types.js +5 -0
  429. package/dist/services/service-manager/types.js.map +1 -0
  430. package/dist/services/service-manager/windows.d.ts +10 -0
  431. package/dist/services/service-manager/windows.d.ts.map +1 -0
  432. package/dist/services/service-manager/windows.js +73 -0
  433. package/dist/services/service-manager/windows.js.map +1 -0
  434. package/dist/services/session-registry.d.ts +70 -0
  435. package/dist/services/session-registry.d.ts.map +1 -0
  436. package/dist/services/session-registry.js +91 -0
  437. package/dist/services/session-registry.js.map +1 -0
  438. package/dist/services/singleton.d.ts +15 -0
  439. package/dist/services/singleton.d.ts.map +1 -0
  440. package/dist/services/singleton.js +98 -0
  441. package/dist/services/singleton.js.map +1 -0
  442. package/dist/services/sprint-coordination.d.ts +168 -0
  443. package/dist/services/sprint-coordination.d.ts.map +1 -0
  444. package/dist/services/sprint-coordination.js +564 -0
  445. package/dist/services/sprint-coordination.js.map +1 -0
  446. package/dist/services/ssh.d.ts.map +1 -1
  447. package/dist/services/ssh.js +70 -3
  448. package/dist/services/ssh.js.map +1 -1
  449. package/dist/services/stall/log-path-resolver.d.ts +11 -8
  450. package/dist/services/stall/log-path-resolver.d.ts.map +1 -1
  451. package/dist/services/stall/log-path-resolver.js +17 -33
  452. package/dist/services/stall/log-path-resolver.js.map +1 -1
  453. package/dist/services/stall/stall-detector.d.ts +32 -0
  454. package/dist/services/stall/stall-detector.d.ts.map +1 -1
  455. package/dist/services/stall/stall-detector.js +187 -12
  456. package/dist/services/stall/stall-detector.js.map +1 -1
  457. package/dist/services/stall/stall-poller.d.ts +50 -0
  458. package/dist/services/stall/stall-poller.d.ts.map +1 -1
  459. package/dist/services/stall/stall-poller.js +268 -18
  460. package/dist/services/stall/stall-poller.js.map +1 -1
  461. package/dist/services/strategy.d.ts.map +1 -1
  462. package/dist/services/strategy.js +57 -7
  463. package/dist/services/strategy.js.map +1 -1
  464. package/dist/services/substitution-engine.d.ts +20 -0
  465. package/dist/services/substitution-engine.d.ts.map +1 -0
  466. package/dist/services/substitution-engine.js +92 -0
  467. package/dist/services/substitution-engine.js.map +1 -0
  468. package/dist/services/task-cleanup.d.ts.map +1 -1
  469. package/dist/services/task-cleanup.js +1 -9
  470. package/dist/services/task-cleanup.js.map +1 -1
  471. package/dist/services/token-issuer.d.ts +47 -0
  472. package/dist/services/token-issuer.d.ts.map +1 -0
  473. package/dist/services/token-issuer.js +63 -0
  474. package/dist/services/token-issuer.js.map +1 -0
  475. package/dist/services/tool-registry.d.ts +3 -0
  476. package/dist/services/tool-registry.d.ts.map +1 -0
  477. package/dist/services/tool-registry.js +225 -0
  478. package/dist/services/tool-registry.js.map +1 -0
  479. package/dist/services/user-config.d.ts +14 -0
  480. package/dist/services/user-config.d.ts.map +1 -1
  481. package/dist/services/user-config.js +55 -0
  482. package/dist/services/user-config.js.map +1 -1
  483. package/dist/services/vcs/github.d.ts.map +1 -1
  484. package/dist/services/vcs/github.js +32 -1
  485. package/dist/services/vcs/github.js.map +1 -1
  486. package/dist/services/vcs/types.d.ts +44 -0
  487. package/dist/services/vcs/types.d.ts.map +1 -1
  488. package/dist/services/version-check.d.ts +22 -0
  489. package/dist/services/version-check.d.ts.map +1 -0
  490. package/dist/services/version-check.js +103 -0
  491. package/dist/services/version-check.js.map +1 -0
  492. package/dist/skills/fleet-sprint-cli/SKILL.md +114 -0
  493. package/dist/skills/pm/beads.md +6 -0
  494. package/dist/skills/pm/cost.md +3 -0
  495. package/dist/skills/pm/doer-reviewer-loop.md +3 -0
  496. package/dist/skills/pm/fleet-addendum.md +6 -0
  497. package/dist/skills/pm/index.md +56 -0
  498. package/dist/skills/pm/kb-reconcile.md +132 -0
  499. package/dist/skills/pm/kb-review.md +109 -0
  500. package/dist/tools/check-status.d.ts +47 -0
  501. package/dist/tools/check-status.d.ts.map +1 -1
  502. package/dist/tools/check-status.js +250 -2
  503. package/dist/tools/check-status.js.map +1 -1
  504. package/dist/tools/child-id-allocator.d.ts +45 -0
  505. package/dist/tools/child-id-allocator.d.ts.map +1 -0
  506. package/dist/tools/child-id-allocator.js +62 -0
  507. package/dist/tools/child-id-allocator.js.map +1 -0
  508. package/dist/tools/cloud-control.d.ts +2 -2
  509. package/dist/tools/code-intelligence-codebase-memory.d.ts +11 -0
  510. package/dist/tools/code-intelligence-codebase-memory.d.ts.map +1 -0
  511. package/dist/tools/code-intelligence-codebase-memory.js +270 -0
  512. package/dist/tools/code-intelligence-codebase-memory.js.map +1 -0
  513. package/dist/tools/code-intelligence-freshness.d.ts +2 -0
  514. package/dist/tools/code-intelligence-freshness.d.ts.map +1 -0
  515. package/dist/tools/code-intelligence-freshness.js +26 -0
  516. package/dist/tools/code-intelligence-freshness.js.map +1 -0
  517. package/dist/tools/code-intelligence-gitnexus.d.ts +14 -0
  518. package/dist/tools/code-intelligence-gitnexus.d.ts.map +1 -0
  519. package/dist/tools/code-intelligence-gitnexus.js +475 -0
  520. package/dist/tools/code-intelligence-gitnexus.js.map +1 -0
  521. package/dist/tools/code-intelligence-kb-enrich.d.ts +2 -0
  522. package/dist/tools/code-intelligence-kb-enrich.d.ts.map +1 -0
  523. package/dist/tools/code-intelligence-kb-enrich.js +65 -0
  524. package/dist/tools/code-intelligence-kb-enrich.js.map +1 -0
  525. package/dist/tools/code-intelligence-reindex.d.ts +7 -0
  526. package/dist/tools/code-intelligence-reindex.d.ts.map +1 -0
  527. package/dist/tools/code-intelligence-reindex.js +106 -0
  528. package/dist/tools/code-intelligence-reindex.js.map +1 -0
  529. package/dist/tools/code-intelligence-telemetry.d.ts +5 -0
  530. package/dist/tools/code-intelligence-telemetry.d.ts.map +1 -0
  531. package/dist/tools/code-intelligence-telemetry.js +52 -0
  532. package/dist/tools/code-intelligence-telemetry.js.map +1 -0
  533. package/dist/tools/code-intelligence-tests.d.ts +2 -0
  534. package/dist/tools/code-intelligence-tests.d.ts.map +1 -0
  535. package/dist/tools/code-intelligence-tests.js +24 -0
  536. package/dist/tools/code-intelligence-tests.js.map +1 -0
  537. package/dist/tools/code-intelligence.d.ts +114 -0
  538. package/dist/tools/code-intelligence.d.ts.map +1 -0
  539. package/dist/tools/code-intelligence.js +124 -0
  540. package/dist/tools/code-intelligence.js.map +1 -0
  541. package/dist/tools/compose-permissions.d.ts +38 -4
  542. package/dist/tools/compose-permissions.d.ts.map +1 -1
  543. package/dist/tools/compose-permissions.js +295 -33
  544. package/dist/tools/compose-permissions.js.map +1 -1
  545. package/dist/tools/dolt-push-mutex.d.ts +44 -0
  546. package/dist/tools/dolt-push-mutex.d.ts.map +1 -0
  547. package/dist/tools/dolt-push-mutex.js +83 -0
  548. package/dist/tools/dolt-push-mutex.js.map +1 -0
  549. package/dist/tools/execute-command.d.ts +13 -1
  550. package/dist/tools/execute-command.d.ts.map +1 -1
  551. package/dist/tools/execute-command.js +108 -21
  552. package/dist/tools/execute-command.js.map +1 -1
  553. package/dist/tools/execute-prompt.d.ts +84 -12
  554. package/dist/tools/execute-prompt.d.ts.map +1 -1
  555. package/dist/tools/execute-prompt.js +1191 -88
  556. package/dist/tools/execute-prompt.js.map +1 -1
  557. package/dist/tools/get-member-model-pricing.d.ts +21 -0
  558. package/dist/tools/get-member-model-pricing.d.ts.map +1 -0
  559. package/dist/tools/get-member-model-pricing.js +29 -0
  560. package/dist/tools/get-member-model-pricing.js.map +1 -0
  561. package/dist/tools/kb-capture.d.ts +53 -0
  562. package/dist/tools/kb-capture.d.ts.map +1 -0
  563. package/dist/tools/kb-capture.js +130 -0
  564. package/dist/tools/kb-capture.js.map +1 -0
  565. package/dist/tools/kb-context.d.ts +17 -0
  566. package/dist/tools/kb-context.d.ts.map +1 -0
  567. package/dist/tools/kb-context.js +29 -0
  568. package/dist/tools/kb-context.js.map +1 -0
  569. package/dist/tools/kb-export.d.ts +19 -0
  570. package/dist/tools/kb-export.d.ts.map +1 -0
  571. package/dist/tools/kb-export.js +344 -0
  572. package/dist/tools/kb-export.js.map +1 -0
  573. package/dist/tools/kb-feedback.d.ts +23 -0
  574. package/dist/tools/kb-feedback.d.ts.map +1 -0
  575. package/dist/tools/kb-feedback.js +43 -0
  576. package/dist/tools/kb-feedback.js.map +1 -0
  577. package/dist/tools/kb-freshness-sweep.d.ts +14 -0
  578. package/dist/tools/kb-freshness-sweep.d.ts.map +1 -0
  579. package/dist/tools/kb-freshness-sweep.js +29 -0
  580. package/dist/tools/kb-freshness-sweep.js.map +1 -0
  581. package/dist/tools/kb-harvest.d.ts +20 -0
  582. package/dist/tools/kb-harvest.d.ts.map +1 -0
  583. package/dist/tools/kb-harvest.js +143 -0
  584. package/dist/tools/kb-harvest.js.map +1 -0
  585. package/dist/tools/kb-import.d.ts +44 -0
  586. package/dist/tools/kb-import.d.ts.map +1 -0
  587. package/dist/tools/kb-import.js +239 -0
  588. package/dist/tools/kb-import.js.map +1 -0
  589. package/dist/tools/kb-invalidate.d.ts +19 -0
  590. package/dist/tools/kb-invalidate.d.ts.map +1 -0
  591. package/dist/tools/kb-invalidate.js +34 -0
  592. package/dist/tools/kb-invalidate.js.map +1 -0
  593. package/dist/tools/kb-list.d.ts +32 -0
  594. package/dist/tools/kb-list.d.ts.map +1 -0
  595. package/dist/tools/kb-list.js +43 -0
  596. package/dist/tools/kb-list.js.map +1 -0
  597. package/dist/tools/kb-promote.d.ts +20 -0
  598. package/dist/tools/kb-promote.d.ts.map +1 -0
  599. package/dist/tools/kb-promote.js +20 -0
  600. package/dist/tools/kb-promote.js.map +1 -0
  601. package/dist/tools/kb-query.d.ts +35 -0
  602. package/dist/tools/kb-query.d.ts.map +1 -0
  603. package/dist/tools/kb-query.js +111 -0
  604. package/dist/tools/kb-query.js.map +1 -0
  605. package/dist/tools/kb-reconcile-prefilter.d.ts +14 -0
  606. package/dist/tools/kb-reconcile-prefilter.d.ts.map +1 -0
  607. package/dist/tools/kb-reconcile-prefilter.js +26 -0
  608. package/dist/tools/kb-reconcile-prefilter.js.map +1 -0
  609. package/dist/tools/kb-resolve-contradiction.d.ts +23 -0
  610. package/dist/tools/kb-resolve-contradiction.d.ts.map +1 -0
  611. package/dist/tools/kb-resolve-contradiction.js +37 -0
  612. package/dist/tools/kb-resolve-contradiction.js.map +1 -0
  613. package/dist/tools/kb-session-prime.d.ts +26 -0
  614. package/dist/tools/kb-session-prime.d.ts.map +1 -0
  615. package/dist/tools/kb-session-prime.js +392 -0
  616. package/dist/tools/kb-session-prime.js.map +1 -0
  617. package/dist/tools/kb-setup.d.ts +20 -0
  618. package/dist/tools/kb-setup.d.ts.map +1 -0
  619. package/dist/tools/kb-setup.js +49 -0
  620. package/dist/tools/kb-setup.js.map +1 -0
  621. package/dist/tools/kb-stats.d.ts +20 -0
  622. package/dist/tools/kb-stats.d.ts.map +1 -0
  623. package/dist/tools/kb-stats.js +115 -0
  624. package/dist/tools/kb-stats.js.map +1 -0
  625. package/dist/tools/list-members.d.ts.map +1 -1
  626. package/dist/tools/list-members.js +39 -7
  627. package/dist/tools/list-members.js.map +1 -1
  628. package/dist/tools/member-detail.d.ts +1 -1
  629. package/dist/tools/member-detail.d.ts.map +1 -1
  630. package/dist/tools/member-detail.js +16 -2
  631. package/dist/tools/member-detail.js.map +1 -1
  632. package/dist/tools/member-reservation.d.ts +29 -0
  633. package/dist/tools/member-reservation.d.ts.map +1 -0
  634. package/dist/tools/member-reservation.js +71 -0
  635. package/dist/tools/member-reservation.js.map +1 -0
  636. package/dist/tools/monitor-task.d.ts.map +1 -1
  637. package/dist/tools/monitor-task.js +21 -3
  638. package/dist/tools/monitor-task.js.map +1 -1
  639. package/dist/tools/provision-auth.d.ts.map +1 -1
  640. package/dist/tools/provision-auth.js +10 -3
  641. package/dist/tools/provision-auth.js.map +1 -1
  642. package/dist/tools/provision-vcs-auth.d.ts +7 -7
  643. package/dist/tools/provision-vcs-auth.js +1 -1
  644. package/dist/tools/provision-vcs-auth.js.map +1 -1
  645. package/dist/tools/register-member.d.ts +20 -5
  646. package/dist/tools/register-member.d.ts.map +1 -1
  647. package/dist/tools/register-member.js +174 -6
  648. package/dist/tools/register-member.js.map +1 -1
  649. package/dist/tools/remove-member.d.ts +1 -1
  650. package/dist/tools/remove-member.d.ts.map +1 -1
  651. package/dist/tools/remove-member.js +17 -3
  652. package/dist/tools/remove-member.js.map +1 -1
  653. package/dist/tools/report-status.d.ts +33 -0
  654. package/dist/tools/report-status.d.ts.map +1 -0
  655. package/dist/tools/report-status.js +45 -0
  656. package/dist/tools/report-status.js.map +1 -0
  657. package/dist/tools/respond-to-message.d.ts +21 -0
  658. package/dist/tools/respond-to-message.d.ts.map +1 -0
  659. package/dist/tools/respond-to-message.js +23 -0
  660. package/dist/tools/respond-to-message.js.map +1 -0
  661. package/dist/tools/send-email.d.ts +69 -0
  662. package/dist/tools/send-email.d.ts.map +1 -0
  663. package/dist/tools/send-email.js +177 -0
  664. package/dist/tools/send-email.js.map +1 -0
  665. package/dist/tools/send-files.d.ts +3 -0
  666. package/dist/tools/send-files.d.ts.map +1 -1
  667. package/dist/tools/send-files.js +88 -8
  668. package/dist/tools/send-files.js.map +1 -1
  669. package/dist/tools/send-message.d.ts +27 -0
  670. package/dist/tools/send-message.d.ts.map +1 -0
  671. package/dist/tools/send-message.js +46 -0
  672. package/dist/tools/send-message.js.map +1 -0
  673. package/dist/tools/setup-ssh-key.d.ts.map +1 -1
  674. package/dist/tools/setup-ssh-key.js +2 -0
  675. package/dist/tools/setup-ssh-key.js.map +1 -1
  676. package/dist/tools/shutdown-server.d.ts +2 -0
  677. package/dist/tools/shutdown-server.d.ts.map +1 -1
  678. package/dist/tools/shutdown-server.js +19 -0
  679. package/dist/tools/shutdown-server.js.map +1 -1
  680. package/dist/tools/update-member.d.ts +11 -8
  681. package/dist/tools/update-member.d.ts.map +1 -1
  682. package/dist/tools/update-member.js +36 -2
  683. package/dist/tools/update-member.js.map +1 -1
  684. package/dist/types.d.ts +16 -3
  685. package/dist/types.d.ts.map +1 -1
  686. package/dist/utils/agent-helpers.d.ts +2 -1
  687. package/dist/utils/agent-helpers.d.ts.map +1 -1
  688. package/dist/utils/agent-helpers.js +7 -2
  689. package/dist/utils/agent-helpers.js.map +1 -1
  690. package/dist/utils/pid-helpers.d.ts +15 -0
  691. package/dist/utils/pid-helpers.d.ts.map +1 -1
  692. package/dist/utils/pid-helpers.js +23 -0
  693. package/dist/utils/pid-helpers.js.map +1 -1
  694. package/dist/utils/process-utils.d.ts +3 -0
  695. package/dist/utils/process-utils.d.ts.map +1 -0
  696. package/dist/utils/process-utils.js +42 -0
  697. package/dist/utils/process-utils.js.map +1 -0
  698. package/dist/utils/prompt-errors.d.ts +2 -1
  699. package/dist/utils/prompt-errors.d.ts.map +1 -1
  700. package/dist/utils/prompt-errors.js +13 -3
  701. package/dist/utils/prompt-errors.js.map +1 -1
  702. package/dist/utils/session-caller.d.ts +28 -0
  703. package/dist/utils/session-caller.d.ts.map +1 -0
  704. package/dist/utils/session-caller.js +24 -0
  705. package/dist/utils/session-caller.js.map +1 -0
  706. package/dist/utils/work-folder-validation.d.ts +39 -0
  707. package/dist/utils/work-folder-validation.d.ts.map +1 -0
  708. package/dist/utils/work-folder-validation.js +60 -0
  709. package/dist/utils/work-folder-validation.js.map +1 -0
  710. package/dist/utils/workspace-trust.d.ts +24 -0
  711. package/dist/utils/workspace-trust.d.ts.map +1 -0
  712. package/dist/utils/workspace-trust.js +35 -0
  713. package/dist/utils/workspace-trust.js.map +1 -0
  714. package/dist/workflows/auto-sprint.js +994 -91
  715. package/package.json +40 -9
  716. package/packages/apra-fleet-client/package.json +26 -0
  717. package/packages/apra-fleet-client/src/client/api.mjs +510 -0
  718. package/packages/apra-fleet-client/src/client/client.mjs +146 -0
  719. package/packages/apra-fleet-client/src/client/errors.mjs +71 -0
  720. package/packages/apra-fleet-client/src/client/factory.mjs +65 -0
  721. package/packages/apra-fleet-client/src/client/server-resolution.mjs +265 -0
  722. package/packages/apra-fleet-client/src/client/transport.mjs +327 -0
  723. package/packages/apra-fleet-se/apra-pm/agents/backlog-groomer.md +303 -0
  724. package/packages/apra-fleet-se/apra-pm/agents/ci-watcher.md +101 -0
  725. package/packages/apra-fleet-se/apra-pm/agents/deployer.md +151 -0
  726. package/packages/apra-fleet-se/apra-pm/agents/doer.md +259 -0
  727. package/packages/apra-fleet-se/apra-pm/agents/harvester.md +188 -0
  728. package/packages/apra-fleet-se/apra-pm/agents/integ-test-runner.md +332 -0
  729. package/packages/apra-fleet-se/apra-pm/agents/kb-reconciler.md +216 -0
  730. package/packages/apra-fleet-se/apra-pm/agents/plan-reviewer.md +201 -0
  731. package/packages/apra-fleet-se/apra-pm/agents/planner.md +322 -0
  732. package/packages/apra-fleet-se/apra-pm/agents/regression-test-runner.md +234 -0
  733. package/packages/apra-fleet-se/apra-pm/agents/reviewer.md +275 -0
  734. package/packages/apra-fleet-se/apra-pm/agents/schemas/backlog-groomer-input.json +35 -0
  735. package/packages/apra-fleet-se/apra-pm/agents/schemas/backlog-groomer-output.json +164 -0
  736. package/packages/apra-fleet-se/apra-pm/agents/schemas/ci-watcher-input.json +26 -0
  737. package/packages/apra-fleet-se/apra-pm/agents/schemas/ci-watcher-output.json +18 -0
  738. package/packages/apra-fleet-se/apra-pm/agents/schemas/deployer-input.json +19 -0
  739. package/packages/apra-fleet-se/apra-pm/agents/schemas/deployer-output.json +17 -0
  740. package/packages/apra-fleet-se/apra-pm/agents/schemas/doer-input.json +25 -0
  741. package/packages/apra-fleet-se/apra-pm/agents/schemas/doer-output.json +82 -0
  742. package/packages/apra-fleet-se/apra-pm/agents/schemas/harvester-input.json +31 -0
  743. package/packages/apra-fleet-se/apra-pm/agents/schemas/harvester-output.json +75 -0
  744. package/packages/apra-fleet-se/apra-pm/agents/schemas/integ-test-runner-input.json +20 -0
  745. package/packages/apra-fleet-se/apra-pm/agents/schemas/integ-test-runner-output.json +61 -0
  746. package/packages/apra-fleet-se/apra-pm/agents/schemas/kb-reconciler-output.json +87 -0
  747. package/packages/apra-fleet-se/apra-pm/agents/schemas/plan-reviewer-input.json +15 -0
  748. package/packages/apra-fleet-se/apra-pm/agents/schemas/plan-reviewer-output.json +30 -0
  749. package/packages/apra-fleet-se/apra-pm/agents/schemas/planner-output.json +65 -0
  750. package/packages/apra-fleet-se/apra-pm/agents/schemas/regression-test-runner-input.json +15 -0
  751. package/packages/apra-fleet-se/apra-pm/agents/schemas/regression-test-runner-output.json +50 -0
  752. package/packages/apra-fleet-se/apra-pm/agents/schemas/reviewer-input.json +25 -0
  753. package/packages/apra-fleet-se/apra-pm/agents/schemas/reviewer-output.json +135 -0
  754. package/packages/apra-fleet-se/apra-pm/skills/pm/SKILL.md +402 -0
  755. package/packages/apra-fleet-se/apra-pm/skills/pm/beads.md +148 -0
  756. package/packages/apra-fleet-se/apra-pm/skills/pm/cost.md +157 -0
  757. package/packages/apra-fleet-se/apra-pm/skills/pm/doer-reviewer-loop.md +300 -0
  758. package/packages/apra-fleet-se/apra-pm/skills/pm/fleet-addendum.md +127 -0
  759. package/packages/apra-fleet-se/apra-pm/skills/pm/index.md +56 -0
  760. package/packages/apra-fleet-se/apra-pm/skills/pm/kb-reconcile.md +132 -0
  761. package/packages/apra-fleet-se/apra-pm/skills/pm/kb-review.md +109 -0
  762. package/packages/apra-fleet-se/apra-pm/skills/pm/simple-sprint.md +65 -0
  763. package/packages/apra-fleet-se/apra-pm/skills/pm/sprint.md +327 -0
  764. package/packages/apra-fleet-se/apra-pm/skills/pm/worktrees.md +92 -0
  765. package/packages/apra-fleet-se/apra-pm/version.json +3 -0
  766. package/packages/apra-fleet-se/bin/cli.mjs +864 -0
  767. package/packages/apra-fleet-se/bin/serve.mjs +395 -0
  768. package/packages/apra-fleet-se/fleet-sprint/conflict-ladder.mjs +178 -0
  769. package/packages/apra-fleet-se/fleet-sprint/contracts.mjs +940 -0
  770. package/packages/apra-fleet-se/fleet-sprint/dispatch-safety-guard.mjs +177 -0
  771. package/packages/apra-fleet-se/fleet-sprint/docs/README.md +191 -0
  772. package/packages/apra-fleet-se/fleet-sprint/docs/coach-role-design.md +23 -0
  773. package/packages/apra-fleet-se/fleet-sprint/docs/dolt-manual-recovery-verified.md +256 -0
  774. package/packages/apra-fleet-se/fleet-sprint/docs/dolt-sync-redesign.md +1482 -0
  775. package/packages/apra-fleet-se/fleet-sprint/docs/escalate-to-llm-design.md +908 -0
  776. package/packages/apra-fleet-se/fleet-sprint/docs/fleet-sprint-diagram.md +94 -0
  777. package/packages/apra-fleet-se/fleet-sprint/docs/shared-orchestrator-reservation-design.md +399 -0
  778. package/packages/apra-fleet-se/fleet-sprint/docs/stabilization-log.md +1125 -0
  779. package/packages/apra-fleet-se/fleet-sprint/dolt-literal-guard.mjs +72 -0
  780. package/packages/apra-fleet-se/fleet-sprint/dolt-settle.mjs +972 -0
  781. package/packages/apra-fleet-se/fleet-sprint/dolt-sync.mjs +1310 -0
  782. package/packages/apra-fleet-se/fleet-sprint/errors.mjs +616 -0
  783. package/packages/apra-fleet-se/fleet-sprint/full-db-fetch-guard.mjs +118 -0
  784. package/packages/apra-fleet-se/fleet-sprint/runner.js +10747 -0
  785. package/packages/apra-fleet-se/fleet-sprint/skills/fleet-sprint-cli/SKILL.md +114 -0
  786. package/packages/apra-fleet-se/fleet-sprint/skills/fleet-supervisor/SKILL.md +350 -0
  787. package/packages/apra-fleet-se/fleet-sprint/sprint-lock.mjs +140 -0
  788. package/packages/apra-fleet-se/fleet-sprint/sprint-progress.mjs +101 -0
  789. package/packages/apra-fleet-se/fleet-sprint/vcs-module.mjs +435 -0
  790. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/azure-devops.mjs +68 -0
  791. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/bitbucket.mjs +53 -0
  792. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/dolt.mjs +146 -0
  793. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/generic-git.mjs +176 -0
  794. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/github.mjs +235 -0
  795. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/index.mjs +218 -0
  796. package/packages/apra-fleet-se/fleet-sprint/viewer-extensions.mjs +942 -0
  797. package/packages/apra-fleet-se/package.json +29 -0
  798. package/packages/apra-fleet-se/workflow.json +1 -0
  799. package/packages/apra-fleet-workflow/package.json +30 -0
  800. package/packages/apra-fleet-workflow/src/viewer/command-output-cap.mjs +112 -0
  801. package/packages/apra-fleet-workflow/src/viewer/debounced-writer.mjs +153 -0
  802. package/packages/apra-fleet-workflow/src/viewer/html-utils.mjs +31 -0
  803. package/packages/apra-fleet-workflow/src/viewer/index.mjs +1439 -0
  804. package/packages/apra-fleet-workflow/src/viewer/lean-state.mjs +237 -0
  805. package/packages/apra-fleet-workflow/src/viewer/run-state-paths.mjs +130 -0
  806. package/packages/apra-fleet-workflow/src/viewer/run-title.mjs +60 -0
  807. package/packages/apra-fleet-workflow/src/viewer/sprint-state-paths.mjs +29 -0
  808. package/packages/apra-fleet-workflow/src/workflow/engine.mjs +200 -0
  809. package/packages/apra-fleet-workflow/src/workflow/errors.mjs +146 -0
  810. package/packages/apra-fleet-workflow/src/workflow/index.mjs +1727 -0
  811. package/packages/apra-fleet-workflow/src/workflow/journal.mjs +291 -0
  812. package/packages/apra-fleet-workflow/src/workflow/pricing.mjs +99 -0
  813. package/packages/apra-fleet-workflow/src/workflow/vetting.mjs +111 -0
  814. package/scripts/agy-transcript-reader.js +1 -0
  815. package/scripts/fleet-statusline.sh +17 -13
  816. package/skills/fleet/SKILL.md +37 -2
  817. package/skills/fleet/beads.md +14 -7
  818. package/skills/fleet/knowledge-agent.md +66 -0
  819. package/skills/fleet/permissions.md +76 -2
  820. package/skills/fleet/profiles/base-dev.json +11 -1
  821. package/skills/fleet/profiles/base-reviewer.json +9 -1
  822. package/skills/fleet/profiles/node.json +2 -2
  823. package/skills/fleet/profiles/tag-kb-reconciler.json +20 -0
  824. package/version.json +1 -1
  825. package/scripts/agy-settings-merge.js +0 -27
  826. /package/{dist → packages/apra-fleet-se/apra-pm}/agents/_shared/GRAPH-SEMANTICS.md +0 -0
@@ -0,0 +1,56 @@
1
+ # Project Index
2
+
3
+ Index the project repo for code intelligence so fleet members can use
4
+ code_graph, code_impact, code_query, and code_context tools.
5
+
6
+ ## Flow
7
+
8
+ 1. Read `<project>/status.md` to find the repo path and an available member.
9
+ 2. Pick any online member whose work_folder is the project repo. If no member
10
+ is pointed at the repo, use any local online member and set `run_from` to
11
+ the repo path.
12
+ 3. Run via `execute_command` (wrap in background Agent per fleet rules):
13
+ ```
14
+ npx gitnexus analyze --embeddings
15
+ ```
16
+ - `run_from`: project repo root
17
+ - `timeout_s`: 300 (indexing large repos can take a minute)
18
+ 4. Report the result: nodes indexed, edges, flows (gitnexus prints this on
19
+ completion). If gitnexus is not installed, it will be fetched automatically
20
+ via npx.
21
+ 5. Non-fatal: if the command fails (e.g. no package.json, unsupported language),
22
+ log the error and tell the user -- do not block the sprint.
23
+
24
+ ## The `--embeddings` flag
25
+
26
+ - Enables semantic embedding generation using a LOCAL ONNX CPU model
27
+ (`Snowflake/snowflake-arctic-embed-xs`, 384-dim) bundled with gitnexus --
28
+ no API key, no external service, no config needed.
29
+ - One-time cost: the first `--embeddings` run on a machine downloads the
30
+ model (~87 MB) from HuggingFace and caches it at `~/.cache/huggingface`;
31
+ every run after that is offline.
32
+ - Embeddings are OFF by default and PRESERVED across a plain `analyze`
33
+ (only `--drop-embeddings` removes them), so passing `--embeddings` here is
34
+ additive and safe to run repeatedly.
35
+ - win32 caveat: on Windows, LadybugDB's VECTOR index is unavailable, so
36
+ semantic search falls back to an exact scan (capped at 10000 chunks) --
37
+ this still works, it is just brute-force rather than an ANN index. Not a
38
+ blocker; see `docs/code-intelligence-embeddings.md` for the full
39
+ investigation.
40
+
41
+ ## When to run
42
+
43
+ - **Automatically inside `/pm init`** -- runs as the final step of project initialization.
44
+ The worktree must exist before indexing (gitnexus needs files on disk to analyze).
45
+ - **Automatically at VERIFY checkpoints** -- checkpoints re-run npx gitnexus analyze to keep
46
+ mid-sprint symbols visible to later phases (incremental via fileHashes in .gitnexus/meta.json,
47
+ takes seconds).
48
+ - After a large merge or rebase that changes many files
49
+ - When `kb_session_prime` returns many stale entries
50
+ - Any time the user asks to re-index (run `/pm index` explicitly)
51
+
52
+ ## Notes
53
+
54
+ - Indexing is per-repo and persists on disk -- subsequent runs are incremental.
55
+ - The index is used by the gitnexus provider behind code_graph/impact/query/context.
56
+ - Fleet members never call gitnexus directly -- they use the fleet tools.
@@ -0,0 +1,132 @@
1
+ # /pm kb-reconcile
2
+
3
+ Reconcile a warm local KB against a merged bible after two or more branches
4
+ land -- absorb the incoming knowledge, revive entries whose basis matches
5
+ the merged worktree again, mechanically settle contradictions a file hash
6
+ can decide, and dispatch a reconciler agent for the rest. Ends with the
7
+ canonical bible re-exported so the merged branch's KB reflects merged truth.
8
+
9
+ ## When to run
10
+
11
+ - After merging branches (including this sprint's own PR merging into its
12
+ base) -- as a standalone command, or as the post-merge hook inside
13
+ `/pm cleanup` (see SKILL.md's completion flow).
14
+ - Any time a local KB needs to catch up with a `.fleet/kb-canonical.json`
15
+ bible produced elsewhere (a teammate's branch, a different worktree) --
16
+ whether or not a formal merge just happened.
17
+ - Periodically, alongside `/pm kb-review`, as KB hygiene.
18
+
19
+ ## Trust boundary (state honestly, do not skip)
20
+
21
+ Step 1 (`kb_import`) reads a bible file. Importing the repo-resolved
22
+ `.fleet/kb-canonical.json` is the git-reviewed, human-merged trusted channel
23
+ -- non-directive entries there keep their bible confidence. An explicit
24
+ `--path` bible is CALLER-ASSERTED trust: equivalent in power to the
25
+ already-exposed `kb_promote` surface (which can walk any entry
26
+ `INFERRED -> CONFIRMED` one call at a time), not a new privilege class.
27
+ `type: 'user-directive'` entries are quarantined to pending proposals either
28
+ way -- a bible can never smuggle an active directive; activation stays
29
+ CLI-only (`apra-fleet kb approve-directive`).
30
+
31
+ ## Steps
32
+
33
+ ### Step 1: Import the merged bible
34
+
35
+ ```
36
+ kb_import({ repo: "<merged worktree path>" })
37
+ ```
38
+
39
+ or the CLI equivalent, `apra-fleet kb import --repo <path>`, for a human
40
+ running this post-merge by hand. Omit `path` to resolve
41
+ `<repo>/.fleet/kb-canonical.json` (the trusted channel); pass an explicit
42
+ `path` only when importing a bible from somewhere else (caller-asserted
43
+ trust, see above).
44
+
45
+ Report: `{ imported, skipped, linked, flagged, sweep }`. `kb_import`
46
+ already runs a freshness sweep internally at the end of its own run, scoped
47
+ to the imported entries' impact -- Step 2 below is still worth running
48
+ explicitly (see its note).
49
+
50
+ ### Step 2: Freshness sweep
51
+
52
+ ```
53
+ kb_freshness_sweep()
54
+ ```
55
+
56
+ Re-hashes EVERY entry in the KB that carries a stored basis against the
57
+ CURRENT (merged) worktree -- not just the entries `kb_import` just touched.
58
+ Un-stales matches (the D2 predicate still excludes superseded, downvoted, and
59
+ invalidated entries from revival), stales mismatches. This is what actually
60
+ performs branch-switch revival: `kb_session_prime`'s candidate set excludes
61
+ stale entries by definition, so priming alone can never revive anything.
62
+
63
+ Idempotent, and worth running explicitly even right after `kb_import` (whose
64
+ internal sweep covers the same ground) because it also covers the
65
+ reconcile-WITHOUT-import path -- e.g. re-running `/pm kb-reconcile` after
66
+ just switching worktree state with no new bible to import.
67
+
68
+ No sweep is needed AFTER Step 3 or Step 4 below: `kb_resolve_contradiction`
69
+ sets each winner's final stale state itself, including the predicate-guarded
70
+ un-stale check, as part of resolving the pair (hardened D4) -- a
71
+ post-resolution sweep would be redundant.
72
+
73
+ ### Step 3: Hash prefilter
74
+
75
+ ```
76
+ kb_reconcile_prefilter()
77
+ ```
78
+
79
+ For every remaining flagged contradiction pair (`flaggedPairs()` -- this
80
+ INCLUDES stale members; the imported side of a pair is typically stale
81
+ right after Step 1/2, and that is exactly the case this step exists to
82
+ resolve), re-hashes both sides' full source-file bases against the CURRENT
83
+ worktree. Exactly one side fully matching wins mechanically, via the same
84
+ `kb_resolve_contradiction` write path the reconciler agent uses (evidence:
85
+ `"hash-basis match on merged worktree"`). Pairs where both sides match, both
86
+ mismatch, either has an empty/missing basis, or either side is an ACTIVE
87
+ user-directive are left untouched for Step 4.
88
+
89
+ Report: `{ pairs, resolved, left_for_agent, skipped_directive }`.
90
+
91
+ ### Step 4: Reconciler agent
92
+
93
+ If `left_for_agent` is non-empty, dispatch the `kb-reconciler` agent
94
+ (`agents/kb-reconciler.md`, model tier cheap/standard)
95
+ with that array. It reads the MERGED code via `code_context`/`code_impact`/
96
+ `code_query` (never Glob/Grep) for each remaining pair, resolves what the
97
+ code decides via `kb_resolve_contradiction`, falls back to a trust-tier
98
+ tiebreak (`CONFIRMED > INFERRED > UNVERIFIED`) when the code is silent, and
99
+ leaves genuinely undecidable pairs flagged for `/pm kb-review`. Active
100
+ user-directives are NEVER auto-retired. See `agents/kb-reconciler.md` for the
101
+ full process and the single-write-path rule.
102
+
103
+ If `left_for_agent` is empty, skip straight to Step 5.
104
+
105
+ ### Step 5: Export
106
+
107
+ ```
108
+ kb_export()
109
+ ```
110
+
111
+ Writes every live `CONFIRMED` project entry -- which now includes every
112
+ mechanical and agent-resolved winner -- to `.fleet/kb-canonical.json` and
113
+ auto-commits it (pathspec-only, identity `pm-kb`, non-fatal on any git
114
+ failure). This is existing `kb_export` machinery; no new commit step is
115
+ needed here. Push is not automatic; it rides the normal sprint push cadence.
116
+
117
+ ## Report
118
+
119
+ After all steps:
120
+
121
+ ```
122
+ /pm kb-reconcile complete.
123
+ Import: imported=<n> skipped=<n> linked=<n> flagged=<n>
124
+ Sweep: checked=<n> staled=<n> unstaled=<n>
125
+ Prefilter: pairs=<n> resolved=<n> left_for_agent=<n> skipped_directive=<n>
126
+ Reconciler: codeDecided=<n> tierDecided=<n> deferred=<n> (omitted if Step 4 was skipped)
127
+ Export: exported=<n> committed=<true|false>
128
+ ```
129
+
130
+ Any `deferred` pairs from the reconciler, and any pair `kb_reconcile_prefilter`
131
+ skipped for an active directive, are handled the same way as any other
132
+ flagged entry going forward: surface them next time `/pm kb-review` runs.
@@ -0,0 +1,109 @@
1
+ # /pm kb-review
2
+
3
+ Surface all contradiction-flagged KB entries and resolve them interactively.
4
+
5
+ Note: `/pm kb-review` also surfaces pending `user-directive` proposals (via
6
+ `kb_query({ flagged_only: true })`) and instructs the human to run
7
+ `apra-fleet kb approve-directive <id>` or `reject-directive <id>` -- these are
8
+ CLI-only resolutions, never `kb_promote`.
9
+
10
+ ## When to run
11
+
12
+ - After any sprint completes, as part of KB hygiene.
13
+ - When an agent reports a `flagged` audn_decision from `kb_capture`.
14
+ - Periodically, to keep the KB free of unresolved contradictions.
15
+
16
+ ## Steps
17
+
18
+ ### Step 1: Fetch flagged entries
19
+
20
+ Call `kb_query(flagged_only=true)`.
21
+
22
+ - If the response says "No flagged contradictions found -- KB is clean.", report that to the user and stop.
23
+ - Otherwise, collect all returned entries.
24
+
25
+ ### Step 2: Group into contradiction pairs
26
+
27
+ For each entry with `contradiction_of` set, pair it with the entry whose `id` matches `contradiction_of`.
28
+ Entries with `flagged_for_review=true` and no `contradiction_of` are the original (challenged) entries.
29
+
30
+ Group: `{ original: entry_A, challenger: entry_B }` where `entry_B.contradiction_of = entry_A.id`.
31
+
32
+ ### Step 3: Present each pair to the user
33
+
34
+ For each pair, show:
35
+
36
+ ```
37
+ Contradiction pair (N of M):
38
+
39
+ [ORIGINAL] id: <id> confidence: <confidence> created: <created_at>
40
+ Title: <title>
41
+ Summary: <summary>
42
+ Content: <content>
43
+
44
+ [CHALLENGER] id: <id> confidence: <confidence> created: <created_at>
45
+ Title: <title>
46
+ Summary: <summary>
47
+ Content: <content>
48
+
49
+ Resolution options:
50
+ A - Keep original, discard challenger
51
+ B - Keep challenger, discard original
52
+ M - Merge both into a new entry (you provide merged content)
53
+ D - Delete both (neither is correct)
54
+ S - Skip (defer to later)
55
+ ```
56
+
57
+ Wait for the user's response before proceeding to the next pair.
58
+
59
+ ### Step 4: Apply resolution
60
+
61
+ Supersede is OPT-IN: you must name the entry you are retiring via
62
+ `supersedes=<id>`. It is honored only when AUDN independently matches that same
63
+ entry (same type, overlapping symbols and source_files), so the corrective
64
+ capture must still carry the SAME title/symbols/source_files as its target --
65
+ otherwise nothing is retired and you get a second live entry instead. A capture
66
+ without `supersedes` never retires anything.
67
+
68
+ **A -- Keep original:**
69
+ - `kb_promote(original.id, reason="contradiction resolved: original kept")` -- upgrades its confidence.
70
+ - `kb_capture` a new entry with the SAME title/symbols/source_files as the challenger, corrected content that carries no contradiction keyword or polarity word (or AUDN will flag it again instead of updating), `confidence=UNVERIFIED`, and `supersedes=<challenger.id>`. That retires the challenger.
71
+
72
+ **B -- Keep challenger:**
73
+ - `kb_promote(challenger.id, reason="contradiction resolved: challenger kept")`.
74
+ - `kb_capture` a corrected entry with the SAME title/symbols/source_files as the original, corrected content free of contradiction/polarity words, and `supersedes=<original.id>`. That retires the original.
75
+
76
+ **M -- Merge:**
77
+ - Ask the user to provide the merged content.
78
+ - `kb_capture` a new entry with merged content and `supersedes=<id of whichever entry it replaces>`. Repeat for the second entry if both must be retired -- `supersedes` names ONE entry, so retiring both takes two captures.
79
+ - `kb_promote` the newly captured entry id.
80
+
81
+ **D -- Delete both:**
82
+ - `kb_capture` a retraction entry: `title=<original title>`, `content="Retracted: neither entry describes current behavior."` (no contradiction keyword or polarity word, or AUDN will flag it again instead of updating), `confidence=UNVERIFIED`, `supersedes=<original.id>`.
83
+ - `kb_capture` same for the challenger, with `supersedes=<challenger.id>`.
84
+
85
+ **S -- Skip:**
86
+ - No action. Note it in the session summary.
87
+
88
+ **Verified actual behavior (T3.7, F11 e2e proof) -- read this before reporting "resolved":**
89
+ - Superseding an entry (via the corrective `kb_capture` above with `supersedes` set, AUDN decision `update`) sets its `superseded_at` and `stale=1`. That entry then drops out of every future `kb_query({flagged_only:true})` listing -- the tool always excludes superseded entries.
90
+ - `kb_promote` does **NOT** clear `flagged_for_review` and does **NOT** clear `contradiction_of`. This means the entry you KEPT (promoted, not superseded) stays visible in `kb_query({flagged_only:true})` forever -- it is not automatically delisted just because it was resolved. Do not expect the pair to fully disappear from the flagged list; expect only the superseded side to disappear. Recognize an already-resolved pair by its counterpart's absence (or by checking `promoted_at`/`confidence` on the id you kept), not by the pair vanishing entirely.
91
+ - A `kb_feedback`-downvoted entry (`stale=1` + `flagged_for_review=1`, never superseded) stays listed under `flagged_only` until it is separately resolved the same way -- superseded via a corrective capture, or otherwise retired. Simply promoting a *different* entry never clears it.
92
+
93
+ ### Step 5: Report
94
+
95
+ After all pairs are processed, report:
96
+
97
+ ```
98
+ KB Review complete.
99
+ - Pairs resolved: N
100
+ - Pairs skipped: M
101
+ - Total flagged entries cleared: K
102
+ ```
103
+
104
+ "Cleared" here means the SUPERSEDED side of each resolved pair (the one whose
105
+ `superseded_at` got set) -- per the verified behavior in Step 4, the kept/
106
+ promoted side of a resolved pair remains in `kb_query({flagged_only:true})`
107
+ indefinitely, so K is normally N, not 2N. Do not report a pair as fully gone
108
+ from the flagged list; report it as resolved (one side superseded, the other
109
+ promoted).
@@ -1,4 +1,5 @@
1
1
  import { z } from 'zod';
2
+ import { type VersionMismatch } from '../services/version-check.js';
2
3
  export declare const fleetStatusSchema: z.ZodObject<{
3
4
  format: z.ZodDefault<z.ZodEnum<["compact", "json"]>>;
4
5
  }, "strip", z.ZodTypeAny, {
@@ -6,6 +7,52 @@ export declare const fleetStatusSchema: z.ZodObject<{
6
7
  }, {
7
8
  format?: "compact" | "json" | undefined;
8
9
  }>;
10
+ export interface TopSymbol {
11
+ target: string;
12
+ count: number;
13
+ }
14
+ export interface CodeIntelligenceHealth {
15
+ present: boolean;
16
+ nodes?: number;
17
+ edges?: number;
18
+ files?: number;
19
+ indexedAt?: string;
20
+ lastCommit?: string;
21
+ headStatus?: 'matching' | 'behind' | 'unavailable';
22
+ commitsBehind?: number;
23
+ topSymbols?: TopSymbol[];
24
+ }
25
+ export declare function computeTopSymbols(now?: number, usagePath?: string, rotatedUsagePath?: string): TopSymbol[] | undefined;
26
+ export declare function codeIntelligenceHealth(repoDir: string): CodeIntelligenceHealth;
27
+ /** Render the one-line compact fleet_status code intelligence summary. */
28
+ export declare function codeIntelligenceCompactLine(health: CodeIntelligenceHealth): string;
29
+ export interface KbHealthBible {
30
+ present: boolean;
31
+ entries: number;
32
+ drift: number;
33
+ }
34
+ export interface KbHealth {
35
+ totals: {
36
+ by_confidence: Record<string, number>;
37
+ by_type: Record<string, number>;
38
+ total: number;
39
+ };
40
+ stale: number;
41
+ flagged: number;
42
+ superseded: number;
43
+ retrieval: {
44
+ entries_retrieved: number;
45
+ total_uses: number;
46
+ hit_rate: number | null;
47
+ };
48
+ promote_ratio: number | null;
49
+ bible: KbHealthBible;
50
+ }
51
+ /** Read kb_stats and shape it for fleet_status. Never throws -- any failure (DB unavailable, bad JSON) yields null so the caller omits the KB section entirely. */
52
+ export declare function kbHealthSummary(): Promise<KbHealth | null>;
53
+ /** Render the one-line compact fleet_status KB health summary. */
54
+ export declare function kbHealthCompactLine(health: KbHealth): string;
55
+ export declare function versionMismatchCompactLine(mismatch: VersionMismatch): string;
9
56
  export type FleetStatusInput = z.infer<typeof fleetStatusSchema>;
10
57
  export declare function fleetStatus(input?: FleetStatusInput): Promise<string>;
11
58
  //# sourceMappingURL=check-status.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"check-status.d.ts","sourceRoot":"","sources":["../../src/tools/check-status.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAiBxB,eAAO,MAAM,iBAAiB;;;;;;EAE5B,CAAC;AAgLH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAEjE,wBAAsB,WAAW,CAAC,KAAK,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,CA8G3E"}
1
+ {"version":3,"file":"check-status.d.ts","sourceRoot":"","sources":["../../src/tools/check-status.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAqBxB,OAAO,EAAwB,KAAK,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAE1F,eAAO,MAAM,iBAAiB;;;;;;EAE5B,CAAC;AA2LH,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,UAAU,GAAG,QAAQ,GAAG,aAAa,CAAC;IACnD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,SAAS,EAAE,CAAC;CAC1B;AA0DD,wBAAgB,iBAAiB,CAC/B,GAAG,GAAE,MAAmB,EACxB,SAAS,GAAE,MAAuB,EAClC,gBAAgB,GAAE,MAA+B,GAChD,SAAS,EAAE,GAAG,SAAS,CA4BzB;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,sBAAsB,CAsC9E;AAqBD,0EAA0E;AAC1E,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,sBAAsB,GAAG,MAAM,CASlF;AAQD,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE;QAAE,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAClG,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE;QAAE,iBAAiB,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;IACtF,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,KAAK,EAAE,aAAa,CAAC;CACtB;AAED,mKAAmK;AACnK,wBAAsB,eAAe,IAAI,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAOhE;AAWD,kEAAkE;AAClE,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,QAAQ,GAAG,MAAM,CAK5D;AASD,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,eAAe,GAAG,MAAM,CAE5E;AAED,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAEjE,wBAAsB,WAAW,CAAC,KAAK,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,CAkK3E"}
@@ -1,4 +1,7 @@
1
1
  import { z } from 'zod';
2
+ import { existsSync, readFileSync } from 'fs';
3
+ import { execFileSync } from 'child_process';
4
+ import { join } from 'path';
2
5
  import { getAllAgents } from '../services/registry.js';
3
6
  import { getStrategy } from '../services/strategy.js';
4
7
  import { getOsCommands } from '../os/index.js';
@@ -14,6 +17,9 @@ import { estimateCost, hourlyRate, formatUptimeDuration, uptimeHoursFromLaunch,
14
17
  import { parseGpuUtilization } from '../utils/gpu-parser.js';
15
18
  import { getUpdateNotice } from '../services/update-check.js';
16
19
  import { getActiveLogFile } from '../utils/log-helpers.js';
20
+ import { USAGE_LOG_PATH, ROTATED_USAGE_LOG_PATH } from './code-intelligence-telemetry.js';
21
+ import { kbStats } from './kb-stats.js';
22
+ import { checkVersionMismatch } from '../services/version-check.js';
17
23
  export const fleetStatusSchema = z.object({
18
24
  format: z.enum(['compact', 'json']).default('compact').describe('Output format: "compact" (default, few lines) or "json" (structured data for detailed rendering)'),
19
25
  });
@@ -59,6 +65,7 @@ async function checkAgent(agent) {
59
65
  session: agent.sessionId ? agent.sessionId.substring(0, 8) + '...' : '(none)',
60
66
  lastActivity: formatTimeAgo(agent.lastUsed),
61
67
  lastLlmActivityAt: agent.lastLlmActivityAt,
68
+ llmProvider: agent.llmProvider,
62
69
  branch: agent.lastBranch,
63
70
  tokenUsage: agent.tokenUsage,
64
71
  category: agent.category?.trim() || null,
@@ -156,10 +163,196 @@ async function checkAgent(agent) {
156
163
  }
157
164
  return row;
158
165
  }
166
+ function readGitNexusMeta(repoDir) {
167
+ const metaPath = join(repoDir, '.gitnexus', 'meta.json');
168
+ if (!existsSync(metaPath))
169
+ return null;
170
+ try {
171
+ return JSON.parse(readFileSync(metaPath, 'utf-8'));
172
+ }
173
+ catch {
174
+ return null;
175
+ }
176
+ }
177
+ function currentHead(repoDir) {
178
+ try {
179
+ return execFileSync('git', ['rev-parse', 'HEAD'], {
180
+ cwd: repoDir, encoding: 'utf-8', timeout: 3000, stdio: ['ignore', 'pipe', 'ignore'],
181
+ }).trim();
182
+ }
183
+ catch {
184
+ return null;
185
+ }
186
+ }
187
+ function commitsBehindCount(repoDir, lastCommit, head) {
188
+ try {
189
+ const out = execFileSync('git', ['rev-list', '--count', `${lastCommit}..${head}`], {
190
+ cwd: repoDir, encoding: 'utf-8', timeout: 3000, stdio: ['ignore', 'pipe', 'ignore'],
191
+ }).trim();
192
+ const count = Number.parseInt(out, 10);
193
+ return Number.isFinite(count) ? count : null;
194
+ }
195
+ catch {
196
+ return null;
197
+ }
198
+ }
199
+ // ---------------------------------------------------------------------------
200
+ // Top symbols read (T4.2, design D8 read spec). Single pass over usage.jsonl
201
+ // AND usage.jsonl.1 (if present), 30-day window, aggregate count by target,
202
+ // top 5. Degraded-safe: no usage file, an unreadable file, or any other
203
+ // error -> undefined (field/segment omitted entirely from fleet_status).
204
+ // Unparseable individual lines are skipped rather than failing the pass.
205
+ // ---------------------------------------------------------------------------
206
+ const TOP_SYMBOLS_WINDOW_MS = 30 * 24 * 60 * 60 * 1000;
207
+ const TOP_SYMBOLS_LIMIT = 5;
208
+ function readUsageLines(path) {
209
+ try {
210
+ return readFileSync(path, 'utf-8').split('\n').filter((line) => line.trim().length > 0);
211
+ }
212
+ catch {
213
+ return [];
214
+ }
215
+ }
216
+ export function computeTopSymbols(now = Date.now(), usagePath = USAGE_LOG_PATH, rotatedUsagePath = ROTATED_USAGE_LOG_PATH) {
217
+ try {
218
+ const lines = [...readUsageLines(usagePath), ...readUsageLines(rotatedUsagePath)];
219
+ if (lines.length === 0)
220
+ return undefined;
221
+ const cutoff = now - TOP_SYMBOLS_WINDOW_MS;
222
+ const counts = new Map();
223
+ for (const line of lines) {
224
+ try {
225
+ const record = JSON.parse(line);
226
+ if (typeof record.ts !== 'string' || typeof record.target !== 'string')
227
+ continue;
228
+ const ts = new Date(record.ts).getTime();
229
+ if (!Number.isFinite(ts) || ts < cutoff)
230
+ continue;
231
+ counts.set(record.target, (counts.get(record.target) ?? 0) + 1);
232
+ }
233
+ catch {
234
+ // Unparseable line -- skip it, keep going.
235
+ }
236
+ }
237
+ if (counts.size === 0)
238
+ return undefined;
239
+ return [...counts.entries()]
240
+ .sort((a, b) => b[1] - a[1])
241
+ .slice(0, TOP_SYMBOLS_LIMIT)
242
+ .map(([target, count]) => ({ target, count }));
243
+ }
244
+ catch {
245
+ return undefined;
246
+ }
247
+ }
248
+ export function codeIntelligenceHealth(repoDir) {
249
+ const meta = readGitNexusMeta(repoDir);
250
+ if (!meta)
251
+ return { present: false };
252
+ const health = {
253
+ present: true,
254
+ nodes: meta.stats?.nodes,
255
+ edges: meta.stats?.edges,
256
+ files: meta.stats?.files,
257
+ indexedAt: meta.indexedAt,
258
+ lastCommit: meta.lastCommit,
259
+ };
260
+ if (!meta.lastCommit) {
261
+ health.headStatus = 'unavailable';
262
+ return health;
263
+ }
264
+ const head = currentHead(repoDir);
265
+ if (!head) {
266
+ health.headStatus = 'unavailable';
267
+ return health;
268
+ }
269
+ if (head === meta.lastCommit) {
270
+ health.headStatus = 'matching';
271
+ return health;
272
+ }
273
+ const behind = commitsBehindCount(repoDir, meta.lastCommit, head);
274
+ if (behind === null) {
275
+ health.headStatus = 'unavailable';
276
+ return health;
277
+ }
278
+ health.headStatus = 'behind';
279
+ health.commitsBehind = behind;
280
+ return health;
281
+ }
282
+ /**
283
+ * Render the trailing head-comparison fragment used by the compact
284
+ * fleet_status line, e.g. "matching HEAD", "5 commits behind HEAD", or
285
+ * "indexed a1b2c3d4, HEAD comparison unavailable".
286
+ */
287
+ function headComparisonLabel(health) {
288
+ if (health.headStatus === 'matching')
289
+ return 'matching HEAD';
290
+ if (health.headStatus === 'behind')
291
+ return `${health.commitsBehind} commits behind HEAD`;
292
+ const shortSha = health.lastCommit ? health.lastCommit.slice(0, 8) : 'unknown';
293
+ return `indexed ${shortSha}, HEAD comparison unavailable`;
294
+ }
295
+ /** Render the trailing "top symbols (30d): a (12), b (9), ..." fragment, or "" when absent. */
296
+ function topSymbolsFragment(topSymbols) {
297
+ if (!topSymbols || topSymbols.length === 0)
298
+ return '';
299
+ const rendered = topSymbols.map((s) => `${s.target} (${s.count})`).join(', ');
300
+ return ` | top symbols (30d): ${rendered}`;
301
+ }
302
+ /** Render the one-line compact fleet_status code intelligence summary. */
303
+ export function codeIntelligenceCompactLine(health) {
304
+ if (!health.present) {
305
+ return "code-intel: no index (run 'npx gitnexus analyze' or /pm index)" + topSymbolsFragment(health.topSymbols);
306
+ }
307
+ const nodes = health.nodes ?? 0;
308
+ const edges = health.edges ?? 0;
309
+ const files = health.files ?? 0;
310
+ const indexedAt = health.indexedAt ?? 'unknown';
311
+ return `code-intel: index present | ${nodes} nodes / ${edges} edges / ${files} files | indexed ${indexedAt} | ${headComparisonLabel(health)}${topSymbolsFragment(health.topSymbols)}`;
312
+ }
313
+ /** Read kb_stats and shape it for fleet_status. Never throws -- any failure (DB unavailable, bad JSON) yields null so the caller omits the KB section entirely. */
314
+ export async function kbHealthSummary() {
315
+ try {
316
+ const raw = await kbStats({});
317
+ return JSON.parse(raw);
318
+ }
319
+ catch {
320
+ return null;
321
+ }
322
+ }
323
+ // D5 (AMENDED): with F6a auto-commit in place inside kb_export, nonzero drift
324
+ // is an ANOMALY signal (a failed auto-commit), not a routine reminder -- the
325
+ // wording says so explicitly. Omitted entirely when drift is not positive
326
+ // (nothing anomalous to report).
327
+ function bibleDriftFragment(bible) {
328
+ if (bible.drift <= 0)
329
+ return '';
330
+ return ` | bible: ${bible.drift} promotions behind (auto-commit may have failed -- run apra-fleet kb commit)`;
331
+ }
332
+ /** Render the one-line compact fleet_status KB health summary. */
333
+ export function kbHealthCompactLine(health) {
334
+ const hitRatePct = health.retrieval.hit_rate === null ? 'n/a' : `${Math.round(health.retrieval.hit_rate * 100)}%`;
335
+ const promotePct = health.promote_ratio === null ? 'n/a' : `${Math.round(health.promote_ratio * 100)}%`;
336
+ const confirmed = health.totals.by_confidence.CONFIRMED ?? 0;
337
+ return `kb: ${health.totals.total} entries (confirmed:${confirmed} stale:${health.stale} flagged:${health.flagged}) | hit-rate:${hitRatePct} | promote-ratio:${promotePct}${bibleDriftFragment(health.bible)}`;
338
+ }
339
+ // ---------------------------------------------------------------------------
340
+ // Server version handshake (T2.4, F7, D6). Compares the compiled-in
341
+ // serverVersion against a fresh on-disk read (src/services/version-check.ts)
342
+ // of the code this process was launched from -- catches the "rebuilt dist
343
+ // but forgot to restart the MCP client" scenario. Degraded-safe: disk read
344
+ // failure -> omit silently; no auto-restart, surface only.
345
+ // ---------------------------------------------------------------------------
346
+ export function versionMismatchCompactLine(mismatch) {
347
+ return `server running ${mismatch.running}, disk has ${mismatch.disk} -- restart your MCP client`;
348
+ }
159
349
  export async function fleetStatus(input) {
160
350
  const format = input?.format ?? 'compact';
161
351
  const agents = getAllAgents();
162
352
  if (agents.length === 0) {
353
+ if (format === 'json') {
354
+ return JSON.stringify({ version: serverVersion, summary: { total: 0, online: 0, offline: 0 }, members: [] });
355
+ }
163
356
  return 'No members registered. Use register_member to add one.';
164
357
  }
165
358
  // Query all members in parallel
@@ -203,12 +396,60 @@ export async function fleetStatus(input) {
203
396
  writeStatusline(statusOverrides);
204
397
  const updateNotice = getUpdateNotice();
205
398
  const logFile = getActiveLogFile();
399
+ let codeIntelligence;
400
+ try {
401
+ codeIntelligence = codeIntelligenceHealth(process.cwd());
402
+ }
403
+ catch {
404
+ // Defensive: codeIntelligenceHealth() already degrades gracefully
405
+ // internally, but fleet_status must never fail because of this section.
406
+ codeIntelligence = { present: false };
407
+ }
408
+ // T4.2: usage-telemetry top symbols (30d), independent of index presence --
409
+ // recordUsage() fires on every code_* call regardless of whether the repo
410
+ // has an index. Defensive on top of computeTopSymbols()'s own try/catch;
411
+ // any failure here just omits the field, never fails fleet_status.
412
+ try {
413
+ const topSymbols = computeTopSymbols();
414
+ if (topSymbols)
415
+ codeIntelligence.topSymbols = topSymbols;
416
+ }
417
+ catch {
418
+ // omit -- see comment above
419
+ }
420
+ // T2.2 (F5/F6, D4/D5 amended): KB health -- degraded-safe, mirrors the
421
+ // code-intelligence section above. kbHealthSummary() already catches
422
+ // internally; the outer try/catch here is defensive belt-and-suspenders
423
+ // (same rationale as the codeIntelligence call above), so fleet_status
424
+ // NEVER fails because of the KB.
425
+ let kbHealth = null;
426
+ try {
427
+ kbHealth = await kbHealthSummary();
428
+ }
429
+ catch {
430
+ kbHealth = null;
431
+ }
432
+ // T2.4 (F7, D6): version handshake -- degraded-safe, same belt-and-
433
+ // suspenders shape as the two sections above. checkVersionMismatch()
434
+ // already catches internally; the outer try/catch is defensive.
435
+ let versionMismatch = null;
436
+ try {
437
+ versionMismatch = checkVersionMismatch(serverVersion);
438
+ }
439
+ catch {
440
+ versionMismatch = null;
441
+ }
206
442
  if (format === 'json') {
207
443
  const payload = {
208
444
  version: serverVersion,
209
445
  summary: { total: rows.length, online, offline: rows.length - online },
210
446
  members: rows,
447
+ codeIntelligence,
211
448
  };
449
+ if (kbHealth)
450
+ payload.kbHealth = kbHealth;
451
+ if (versionMismatch)
452
+ payload.versionMismatch = versionMismatch;
212
453
  if (logFile)
213
454
  payload.logFile = logFile;
214
455
  if (updateNotice) {
@@ -241,8 +482,10 @@ export async function fleetStatus(input) {
241
482
  t += `\n[${category}]\n`;
242
483
  for (const { row: r } of members) {
243
484
  const branchStr = r.branch ? ` | branch=${r.branch}` : '';
244
- const tokenStr = (r.tokenUsage && (r.tokenUsage.input > 0 || r.tokenUsage.output > 0))
245
- ? ` | tokens=in:${r.tokenUsage.input} out:${r.tokenUsage.output}` : '';
485
+ const tokenStr = r.llmProvider === 'none'
486
+ ? ' | compute only'
487
+ : (r.tokenUsage && (r.tokenUsage.input > 0 || r.tokenUsage.output > 0))
488
+ ? ` | tokens=in:${r.tokenUsage.input} out:${r.tokenUsage.output}` : '';
246
489
  const tagsStr = (r.tags && r.tags.length > 0) ? ` | tags=[${r.tags.join(', ')}]` : '';
247
490
  let line = ` ${r.icon} ${r.name}: ${r.host} | session=${r.session} | ${r.lastActivity}${branchStr}${tokenStr}${tagsStr}`;
248
491
  if (r.cloudInfo) {
@@ -260,6 +503,11 @@ export async function fleetStatus(input) {
260
503
  t += line + '\n';
261
504
  }
262
505
  }
506
+ t += codeIntelligenceCompactLine(codeIntelligence) + '\n';
507
+ if (kbHealth)
508
+ t += kbHealthCompactLine(kbHealth) + '\n';
509
+ if (versionMismatch)
510
+ t += versionMismatchCompactLine(versionMismatch) + '\n';
263
511
  return t;
264
512
  }
265
513
  //# sourceMappingURL=check-status.js.map