@apralabs/apra-fleet 0.4.2 → 0.4.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (997) hide show
  1. package/README.md +103 -34
  2. package/dist/agents/backlog-groomer.md +87 -14
  3. package/dist/agents/ci-watcher.md +35 -9
  4. package/dist/agents/deployer.md +63 -11
  5. package/dist/agents/doer.md +99 -41
  6. package/dist/agents/harvester.md +47 -27
  7. package/dist/agents/integ-test-runner.md +38 -10
  8. package/dist/agents/kb-reconciler.md +37 -7
  9. package/dist/agents/plan-reviewer.md +145 -32
  10. package/dist/agents/planner.md +180 -69
  11. package/dist/agents/regression-test-runner.md +98 -64
  12. package/dist/agents/reviewer.md +117 -45
  13. package/dist/agents/schemas/backlog-groomer-output.json +1 -1
  14. package/dist/agents/schemas/doer-output.json +32 -0
  15. package/dist/agents/schemas/harvester-input.json +1 -5
  16. package/dist/agents/schemas/plan-reviewer-output.json +37 -0
  17. package/dist/agents/schemas/planner-output.json +1 -1
  18. package/dist/agents/schemas/regression-test-runner-output.json +41 -7
  19. package/dist/agents/schemas/reviewer-output.json +62 -3
  20. package/dist/cli/agent-transform.d.ts +90 -2
  21. package/dist/cli/agent-transform.js +310 -20
  22. package/dist/cli/auth.d.ts +1 -0
  23. package/dist/cli/auth.js +66 -17
  24. package/dist/cli/beads-install.d.ts +35 -0
  25. package/dist/cli/beads-install.js +125 -0
  26. package/dist/cli/beads-pin.d.ts +5 -0
  27. package/dist/cli/beads-pin.js +27 -0
  28. package/dist/cli/call.d.ts +27 -0
  29. package/dist/cli/call.js +177 -0
  30. package/dist/cli/config.d.ts +31 -6
  31. package/dist/cli/config.js +113 -36
  32. package/dist/cli/dolt-install.d.ts +18 -2
  33. package/dist/cli/dolt-install.js +46 -15
  34. package/dist/cli/fleet-se-guard.d.ts +51 -0
  35. package/dist/cli/fleet-se-guard.js +215 -0
  36. package/dist/cli/install-guard.d.ts +54 -0
  37. package/dist/cli/install-guard.js +132 -4
  38. package/dist/cli/install.d.ts +100 -11
  39. package/dist/cli/install.js +864 -139
  40. package/dist/cli/kb-commit.d.ts +2 -1
  41. package/dist/cli/kb-commit.js +1 -1
  42. package/dist/cli/kb-directives.js +2 -1
  43. package/dist/cli/kb-import.d.ts +2 -1
  44. package/dist/cli/kb-import.js +1 -1
  45. package/dist/cli/register-member.js +26 -5
  46. package/dist/cli/remove-member.d.ts +4 -0
  47. package/dist/cli/remove-member.js +63 -0
  48. package/dist/cli/secret.js +9 -0
  49. package/dist/cli/start.js +59 -4
  50. package/dist/cli/status.d.ts +3 -0
  51. package/dist/cli/status.js +45 -12
  52. package/dist/cli/stop.js +64 -9
  53. package/dist/cli/uninstall.js +101 -15
  54. package/dist/cli/update.js +33 -2
  55. package/dist/cli/watch.js +1 -1
  56. package/dist/cli/workflow.js +3 -2
  57. package/dist/commands/kb-server.d.ts +3 -0
  58. package/dist/commands/kb-server.js +52 -5
  59. package/dist/hub-service/http-server.d.ts +5 -1
  60. package/dist/hub-service/http-server.js +55 -5
  61. package/dist/index.js +158 -11
  62. package/dist/os/child-env-bound.d.ts +77 -0
  63. package/dist/os/child-env-bound.js +171 -0
  64. package/dist/os/linux.d.ts +13 -2
  65. package/dist/os/linux.js +75 -16
  66. package/dist/os/macos.d.ts +1 -1
  67. package/dist/os/macos.js +2 -11
  68. package/dist/os/os-commands.d.ts +78 -4
  69. package/dist/os/windows-gitbash.d.ts +6 -0
  70. package/dist/os/windows-gitbash.js +32 -3
  71. package/dist/os/windows-wrapper.d.ts +0 -4
  72. package/dist/os/windows-wrapper.js +2 -1
  73. package/dist/os/windows.d.ts +11 -2
  74. package/dist/os/windows.js +121 -32
  75. package/dist/paths.d.ts +21 -0
  76. package/dist/paths.js +35 -0
  77. package/dist/providers/agy.d.ts +120 -7
  78. package/dist/providers/agy.js +741 -86
  79. package/dist/providers/claude-permission-denial.d.ts +7 -0
  80. package/dist/providers/claude-permission-denial.js +137 -0
  81. package/dist/providers/claude.d.ts +132 -6
  82. package/dist/providers/claude.js +644 -48
  83. package/dist/providers/codex.d.ts +4 -2
  84. package/dist/providers/codex.js +23 -2
  85. package/dist/providers/copilot.d.ts +4 -2
  86. package/dist/providers/copilot.js +24 -2
  87. package/dist/providers/none.d.ts +4 -2
  88. package/dist/providers/none.js +17 -2
  89. package/dist/providers/opencode.d.ts +12 -2
  90. package/dist/providers/opencode.js +135 -54
  91. package/dist/providers/provider.d.ts +368 -35
  92. package/dist/providers/provider.js +219 -2
  93. package/dist/services/agent-provisioner.d.ts +29 -0
  94. package/dist/services/agent-provisioner.js +107 -0
  95. package/dist/services/agent-shadow.d.ts +96 -0
  96. package/dist/services/agent-shadow.js +479 -0
  97. package/dist/services/agy-project.d.ts +103 -0
  98. package/dist/services/agy-project.js +354 -0
  99. package/dist/services/auth-socket.d.ts +25 -0
  100. package/dist/services/auth-socket.js +72 -27
  101. package/dist/services/auth-web.js +2 -2
  102. package/dist/services/budget-awareness.d.ts +11 -11
  103. package/dist/services/budget-awareness.js +15 -3
  104. package/dist/services/claude-local-scope-mcp.d.ts +19 -0
  105. package/dist/services/claude-local-scope-mcp.js +91 -0
  106. package/dist/services/cloud/aws.js +2 -1
  107. package/dist/services/cloud/lifecycle.js +52 -6
  108. package/dist/services/cloud/task-wrapper.d.ts +0 -9
  109. package/dist/services/cloud/task-wrapper.js +15 -6
  110. package/dist/services/credential-cleanup.js +35 -17
  111. package/dist/services/event-loop-watchdog.d.ts +32 -0
  112. package/dist/services/event-loop-watchdog.js +140 -0
  113. package/dist/services/exit-drain.d.ts +44 -0
  114. package/dist/services/exit-drain.js +52 -0
  115. package/dist/services/github-app.js +32 -4
  116. package/dist/services/http-transport.d.ts +50 -1
  117. package/dist/services/http-transport.js +238 -25
  118. package/dist/services/in-flight-agents.d.ts +2 -0
  119. package/dist/services/in-flight-agents.js +4 -0
  120. package/dist/services/knowledge/bible-basis-filter.d.ts +53 -0
  121. package/dist/services/knowledge/bible-basis-filter.js +134 -0
  122. package/dist/services/knowledge/bible-blob-id.d.ts +44 -0
  123. package/dist/services/knowledge/bible-blob-id.js +113 -0
  124. package/dist/services/knowledge/bible-import.d.ts +65 -0
  125. package/dist/services/knowledge/bible-import.js +211 -0
  126. package/dist/services/knowledge/file-hash.d.ts +31 -0
  127. package/dist/services/knowledge/file-hash.js +153 -23
  128. package/dist/services/knowledge/http-provider.d.ts +4 -3
  129. package/dist/services/knowledge/http-provider.js +17 -5
  130. package/dist/services/knowledge/kb-config.d.ts +42 -0
  131. package/dist/services/knowledge/kb-config.js +54 -0
  132. package/dist/services/knowledge/kb-maintainer-grant.d.ts +15 -0
  133. package/dist/services/knowledge/kb-maintainer-grant.js +34 -0
  134. package/dist/services/knowledge/kb-providers.d.ts +11 -1
  135. package/dist/services/knowledge/kb-providers.js +199 -17
  136. package/dist/services/knowledge/kb-removed-scope-keys.d.ts +28 -0
  137. package/dist/services/knowledge/kb-removed-scope-keys.js +59 -0
  138. package/dist/services/knowledge/kb-scopes.d.ts +14 -0
  139. package/dist/services/knowledge/kb-scopes.js +47 -0
  140. package/dist/services/knowledge/kb-self.d.ts +91 -0
  141. package/dist/services/knowledge/kb-self.js +198 -0
  142. package/dist/services/knowledge/member-bible-view.d.ts +21 -0
  143. package/dist/services/knowledge/member-bible-view.js +194 -0
  144. package/dist/services/knowledge/pre-init.js +1 -0
  145. package/dist/services/knowledge/project-slug.js +2 -2
  146. package/dist/services/knowledge/require-sqlite-project.d.ts +32 -0
  147. package/dist/services/knowledge/require-sqlite-project.js +38 -0
  148. package/dist/services/knowledge/sqlite-provider.d.ts +64 -11
  149. package/dist/services/knowledge/sqlite-provider.js +303 -41
  150. package/dist/services/knowledge/types.d.ts +45 -2
  151. package/dist/services/member-access-secret.d.ts +70 -0
  152. package/dist/services/member-access-secret.js +195 -0
  153. package/dist/services/member-call-counts.d.ts +24 -0
  154. package/dist/services/member-call-counts.js +58 -0
  155. package/dist/services/member-config-io.d.ts +192 -0
  156. package/dist/services/member-config-io.js +443 -0
  157. package/dist/services/member-fleet-install.d.ts +710 -0
  158. package/dist/services/member-fleet-install.js +1895 -0
  159. package/dist/services/member-secret-env.d.ts +42 -0
  160. package/dist/services/member-secret-env.js +68 -0
  161. package/dist/services/member-tool-allowlist.d.ts +49 -0
  162. package/dist/services/member-tool-allowlist.js +111 -0
  163. package/dist/services/model-pricing.d.ts +19 -0
  164. package/dist/services/model-pricing.js +60 -10
  165. package/dist/services/port-holder.d.ts +86 -0
  166. package/dist/services/port-holder.js +351 -0
  167. package/dist/services/preflight-check.js +2 -0
  168. package/dist/services/registry.d.ts +13 -2
  169. package/dist/services/registry.js +27 -1
  170. package/dist/services/relay-strategy.d.ts +2 -0
  171. package/dist/services/relay-strategy.js +8 -0
  172. package/dist/services/secret-token.d.ts +38 -0
  173. package/dist/services/secret-token.js +51 -0
  174. package/dist/services/server-lifecycle.d.ts +26 -0
  175. package/dist/services/server-lifecycle.js +85 -0
  176. package/dist/services/service-manager/index.d.ts +7 -1
  177. package/dist/services/service-manager/index.js +17 -4
  178. package/dist/services/service-manager/linux.d.ts +1 -1
  179. package/dist/services/service-manager/linux.js +15 -7
  180. package/dist/services/service-manager/macos.d.ts +11 -1
  181. package/dist/services/service-manager/macos.js +45 -7
  182. package/dist/services/service-manager/service-path.d.ts +24 -0
  183. package/dist/services/service-manager/service-path.js +55 -0
  184. package/dist/services/service-manager/types.d.ts +39 -2
  185. package/dist/services/service-manager/types.js +29 -0
  186. package/dist/services/service-manager/windows.d.ts +194 -3
  187. package/dist/services/service-manager/windows.js +705 -30
  188. package/dist/services/service-notice.d.ts +14 -0
  189. package/dist/services/service-notice.js +62 -0
  190. package/dist/services/service-start-guard.d.ts +20 -0
  191. package/dist/services/service-start-guard.js +86 -0
  192. package/dist/services/session-cost.d.ts +24 -0
  193. package/dist/services/session-cost.js +105 -0
  194. package/dist/services/session-mcp-config.d.ts +83 -0
  195. package/dist/services/session-mcp-config.js +211 -0
  196. package/dist/services/sftp.d.ts +34 -0
  197. package/dist/services/sftp.js +304 -76
  198. package/dist/services/shell-probe.d.ts +0 -24
  199. package/dist/services/shell-probe.js +28 -3
  200. package/dist/services/singleton.d.ts +68 -2
  201. package/dist/services/singleton.js +168 -11
  202. package/dist/services/sprint-coordination.js +9 -3
  203. package/dist/services/ssh.d.ts +27 -0
  204. package/dist/services/ssh.js +287 -40
  205. package/dist/services/stall/find-log-file.js +12 -5
  206. package/dist/services/stall/index.d.ts +1 -1
  207. package/dist/services/stall/read-log-tail.d.ts +23 -0
  208. package/dist/services/stall/read-log-tail.js +53 -12
  209. package/dist/services/stall/stall-detector.d.ts +78 -5
  210. package/dist/services/stall/stall-detector.js +296 -39
  211. package/dist/services/stall/stall-poller.d.ts +16 -0
  212. package/dist/services/stall/stall-poller.js +50 -6
  213. package/dist/services/stopped-marker.d.ts +16 -0
  214. package/dist/services/stopped-marker.js +55 -0
  215. package/dist/services/strategy.d.ts +33 -1
  216. package/dist/services/strategy.js +165 -19
  217. package/dist/services/substitution-engine.js +2 -2
  218. package/dist/services/supervisor-service-cleanup.d.ts +52 -0
  219. package/dist/services/supervisor-service-cleanup.js +332 -0
  220. package/dist/services/tool-registry.d.ts +8 -1
  221. package/dist/services/tool-registry.js +164 -61
  222. package/dist/services/tool-scope.d.ts +58 -0
  223. package/dist/services/tool-scope.js +99 -0
  224. package/dist/services/vcs/azure-devops.d.ts +66 -1
  225. package/dist/services/vcs/azure-devops.js +192 -21
  226. package/dist/services/vcs/types.d.ts +1 -1
  227. package/dist/services/watch/project-resolver.js +1 -0
  228. package/dist/skills/auto-sprint-args/SKILL.md +2 -2
  229. package/dist/skills/fleet-sprint-cli/SKILL.md +48 -6
  230. package/dist/skills/pm/SKILL.md +4 -4
  231. package/dist/skills/pm/cost.md +0 -3
  232. package/dist/skills/pm/fleet-addendum.md +2 -2
  233. package/dist/skills/pm/index.md +4 -2
  234. package/dist/skills/pm/kb-reconcile.md +29 -14
  235. package/dist/skills/pm/kb-review.md +1 -0
  236. package/dist/skills/pm/sprint.md +5 -5
  237. package/dist/tools/check-status.d.ts +60 -9
  238. package/dist/tools/check-status.js +211 -52
  239. package/dist/tools/child-id-allocator.d.ts +2 -2
  240. package/dist/tools/child-id-allocator.js +1 -1
  241. package/dist/tools/code-index-heal.d.ts +8 -0
  242. package/dist/tools/code-index-heal.js +21 -0
  243. package/dist/tools/code-index-state.d.ts +45 -0
  244. package/dist/tools/code-index-state.js +115 -0
  245. package/dist/tools/code-intelligence-codebase-memory.js +6 -33
  246. package/dist/tools/code-intelligence-freshness.js +1 -1
  247. package/dist/tools/code-intelligence-gitnexus.d.ts +30 -0
  248. package/dist/tools/code-intelligence-gitnexus.js +333 -57
  249. package/dist/tools/code-intelligence-kb-enrich.js +7 -6
  250. package/dist/tools/code-intelligence-readiness.d.ts +99 -0
  251. package/dist/tools/code-intelligence-readiness.js +206 -0
  252. package/dist/tools/code-intelligence-reindex.d.ts +195 -0
  253. package/dist/tools/code-intelligence-reindex.js +530 -50
  254. package/dist/tools/code-intelligence-telemetry.d.ts +6 -1
  255. package/dist/tools/code-intelligence-telemetry.js +12 -3
  256. package/dist/tools/code-intelligence.d.ts +81 -31
  257. package/dist/tools/code-intelligence.js +156 -52
  258. package/dist/tools/compose-permissions.d.ts +63 -2
  259. package/dist/tools/compose-permissions.js +673 -72
  260. package/dist/tools/credential-store-set.js +1 -1
  261. package/dist/tools/execute-command.d.ts +11 -0
  262. package/dist/tools/execute-command.js +111 -32
  263. package/dist/tools/execute-prompt.d.ts +69 -12
  264. package/dist/tools/execute-prompt.js +1610 -895
  265. package/dist/tools/kb-bible-commit.d.ts +65 -0
  266. package/dist/tools/kb-bible-commit.js +239 -0
  267. package/dist/tools/kb-capture.d.ts +15 -11
  268. package/dist/tools/kb-capture.js +71 -16
  269. package/dist/tools/kb-context.d.ts +27 -7
  270. package/dist/tools/kb-context.js +60 -9
  271. package/dist/tools/kb-export.d.ts +98 -9
  272. package/dist/tools/kb-export.js +230 -92
  273. package/dist/tools/kb-feedback.d.ts +13 -9
  274. package/dist/tools/kb-feedback.js +16 -8
  275. package/dist/tools/kb-freshness-sweep.d.ts +11 -7
  276. package/dist/tools/kb-freshness-sweep.js +10 -8
  277. package/dist/tools/kb-harvest.d.ts +11 -7
  278. package/dist/tools/kb-harvest.js +7 -7
  279. package/dist/tools/kb-import.d.ts +26 -10
  280. package/dist/tools/kb-import.js +170 -159
  281. package/dist/tools/kb-invalidate.d.ts +17 -10
  282. package/dist/tools/kb-invalidate.js +41 -8
  283. package/dist/tools/kb-list.d.ts +14 -10
  284. package/dist/tools/kb-list.js +33 -11
  285. package/dist/tools/kb-promote.d.ts +11 -7
  286. package/dist/tools/kb-promote.js +14 -8
  287. package/dist/tools/kb-query.d.ts +21 -11
  288. package/dist/tools/kb-query.js +76 -13
  289. package/dist/tools/kb-reconcile-prefilter.d.ts +11 -7
  290. package/dist/tools/kb-reconcile-prefilter.js +13 -9
  291. package/dist/tools/kb-resolve-contradiction.d.ts +11 -7
  292. package/dist/tools/kb-resolve-contradiction.js +10 -8
  293. package/dist/tools/kb-session-prime.d.ts +14 -7
  294. package/dist/tools/kb-session-prime.js +44 -44
  295. package/dist/tools/kb-setup.d.ts +11 -4
  296. package/dist/tools/kb-setup.js +146 -27
  297. package/dist/tools/kb-stats.d.ts +11 -10
  298. package/dist/tools/kb-stats.js +84 -82
  299. package/dist/tools/list-members.d.ts +2 -2
  300. package/dist/tools/list-members.js +6 -2
  301. package/dist/tools/member-detail.d.ts +5 -2
  302. package/dist/tools/member-detail.js +105 -17
  303. package/dist/tools/member-reservation.d.ts +60 -3
  304. package/dist/tools/member-reservation.js +61 -20
  305. package/dist/tools/provision-auth.d.ts +118 -1
  306. package/dist/tools/provision-auth.js +402 -92
  307. package/dist/tools/provision-vcs-auth.d.ts +93 -3
  308. package/dist/tools/provision-vcs-auth.js +209 -49
  309. package/dist/tools/receive-files.js +3 -1
  310. package/dist/tools/register-member.d.ts +44 -15
  311. package/dist/tools/register-member.js +175 -70
  312. package/dist/tools/remove-member.js +118 -15
  313. package/dist/tools/send-email.d.ts +2 -2
  314. package/dist/tools/send-files.js +6 -4
  315. package/dist/tools/session-stats.d.ts +17 -0
  316. package/dist/tools/session-stats.js +27 -0
  317. package/dist/tools/setup-git-app.js +11 -7
  318. package/dist/tools/shutdown-server.d.ts +2 -0
  319. package/dist/tools/shutdown-server.js +28 -1
  320. package/dist/tools/update-agent-cli.d.ts +19 -0
  321. package/dist/tools/update-agent-cli.js +59 -2
  322. package/dist/tools/update-member.d.ts +23 -17
  323. package/dist/tools/update-member.js +181 -18
  324. package/dist/tools/vcs-credential-exec.d.ts +127 -0
  325. package/dist/tools/vcs-credential-exec.js +203 -0
  326. package/dist/types.d.ts +111 -1
  327. package/dist/utils/agent-helpers.js +2 -0
  328. package/dist/utils/auth-env.d.ts +15 -4
  329. package/dist/utils/auth-env.js +52 -23
  330. package/dist/utils/find-on-path.d.ts +37 -0
  331. package/dist/utils/find-on-path.js +85 -0
  332. package/dist/utils/log-helpers.d.ts +37 -0
  333. package/dist/utils/log-helpers.js +108 -22
  334. package/dist/utils/owner-only-fs.d.ts +56 -0
  335. package/dist/utils/owner-only-fs.js +98 -0
  336. package/dist/utils/process-utils.d.ts +28 -0
  337. package/dist/utils/process-utils.js +68 -0
  338. package/dist/utils/prompt-errors.js +11 -2
  339. package/dist/utils/session-caller.d.ts +4 -2
  340. package/dist/utils/session-caller.js +3 -2
  341. package/dist/utils/shell-escape.d.ts +58 -3
  342. package/dist/utils/shell-escape.js +91 -5
  343. package/dist/utils/ssh-error-messages.js +3 -0
  344. package/dist/utils/vcs-provider-detect.d.ts +65 -0
  345. package/dist/utils/vcs-provider-detect.js +109 -0
  346. package/dist/utils/workspace-trust.d.ts +26 -0
  347. package/dist/utils/workspace-trust.js +91 -1
  348. package/dist/workflows/auto-sprint.js +397 -56
  349. package/package.json +15 -10
  350. package/packages/apra-fleet-client/package.json +2 -2
  351. package/packages/apra-fleet-client/src/client/api.mjs +864 -31
  352. package/packages/apra-fleet-client/src/client/auto-start.mjs +434 -0
  353. package/packages/apra-fleet-client/src/client/client.mjs +9 -0
  354. package/packages/apra-fleet-client/src/client/errors.mjs +6 -2
  355. package/packages/apra-fleet-client/src/client/factory.mjs +23 -4
  356. package/packages/apra-fleet-client/src/client/reconnecting-transport.mjs +137 -0
  357. package/packages/apra-fleet-client/src/client/server-resolution.mjs +267 -30
  358. package/packages/apra-fleet-client/src/client/transport.mjs +37 -3
  359. package/packages/apra-fleet-se/apra-pm/agents/_shared/GRAPH-SEMANTICS.md +10 -2
  360. package/packages/apra-fleet-se/apra-pm/agents/backlog-groomer.md +87 -14
  361. package/packages/apra-fleet-se/apra-pm/agents/ci-watcher.md +35 -9
  362. package/packages/apra-fleet-se/apra-pm/agents/deployer.md +63 -11
  363. package/packages/apra-fleet-se/apra-pm/agents/doer.md +99 -41
  364. package/packages/apra-fleet-se/apra-pm/agents/harvester.md +47 -27
  365. package/packages/apra-fleet-se/apra-pm/agents/integ-test-runner.md +38 -10
  366. package/packages/apra-fleet-se/apra-pm/agents/kb-reconciler.md +37 -7
  367. package/packages/apra-fleet-se/apra-pm/agents/plan-reviewer.md +145 -32
  368. package/packages/apra-fleet-se/apra-pm/agents/planner.md +180 -69
  369. package/packages/apra-fleet-se/apra-pm/agents/regression-test-runner.md +98 -64
  370. package/packages/apra-fleet-se/apra-pm/agents/reviewer.md +117 -45
  371. package/packages/apra-fleet-se/apra-pm/agents/schemas/backlog-groomer-output.json +1 -1
  372. package/packages/apra-fleet-se/apra-pm/agents/schemas/doer-output.json +32 -0
  373. package/packages/apra-fleet-se/apra-pm/agents/schemas/harvester-input.json +1 -5
  374. package/packages/apra-fleet-se/apra-pm/agents/schemas/plan-reviewer-output.json +37 -0
  375. package/packages/apra-fleet-se/apra-pm/agents/schemas/planner-output.json +1 -1
  376. package/packages/apra-fleet-se/apra-pm/agents/schemas/regression-test-runner-output.json +41 -7
  377. package/packages/apra-fleet-se/apra-pm/agents/schemas/reviewer-output.json +62 -3
  378. package/packages/apra-fleet-se/apra-pm/skills/pm/SKILL.md +4 -4
  379. package/packages/apra-fleet-se/apra-pm/skills/pm/cost.md +0 -3
  380. package/packages/apra-fleet-se/apra-pm/skills/pm/fleet-addendum.md +2 -2
  381. package/packages/apra-fleet-se/apra-pm/skills/pm/index.md +4 -2
  382. package/packages/apra-fleet-se/apra-pm/skills/pm/kb-reconcile.md +29 -14
  383. package/packages/apra-fleet-se/apra-pm/skills/pm/kb-review.md +1 -0
  384. package/packages/apra-fleet-se/apra-pm/skills/pm/sprint.md +5 -5
  385. package/packages/apra-fleet-se/bin/cli.mjs +326 -48
  386. package/packages/apra-fleet-se/bin/serve.mjs +218 -11
  387. package/packages/apra-fleet-se/fleet-sprint/abort.mjs +517 -0
  388. package/packages/apra-fleet-se/fleet-sprint/backlog-role.mjs +93 -0
  389. package/packages/apra-fleet-se/fleet-sprint/beads-children.mjs +646 -0
  390. package/packages/apra-fleet-se/fleet-sprint/beads-identity-check.mjs +825 -0
  391. package/packages/apra-fleet-se/fleet-sprint/beads-identity.mjs +217 -0
  392. package/packages/apra-fleet-se/fleet-sprint/beads-memory-hygiene.mjs +201 -0
  393. package/packages/apra-fleet-se/fleet-sprint/beads-scope.mjs +745 -0
  394. package/packages/apra-fleet-se/fleet-sprint/beads-transitions.mjs +447 -0
  395. package/packages/apra-fleet-se/fleet-sprint/branch-ensure.mjs +96 -0
  396. package/packages/apra-fleet-se/fleet-sprint/ci-gate.mjs +353 -0
  397. package/packages/apra-fleet-se/fleet-sprint/conflict-ladder.mjs +20 -0
  398. package/packages/apra-fleet-se/fleet-sprint/contracts.mjs +121 -15
  399. package/packages/apra-fleet-se/fleet-sprint/coordination.mjs +539 -0
  400. package/packages/apra-fleet-se/fleet-sprint/dispatch-accounting.mjs +270 -0
  401. package/packages/apra-fleet-se/fleet-sprint/dispatch-failure.mjs +204 -0
  402. package/packages/apra-fleet-se/fleet-sprint/dispatch-role.mjs +1310 -0
  403. package/packages/apra-fleet-se/fleet-sprint/dispatch-safety-guard.mjs +216 -4
  404. package/packages/apra-fleet-se/fleet-sprint/docs/README.md +53 -15
  405. package/packages/apra-fleet-se/fleet-sprint/docs/dolt-sync-redesign.md +281 -0
  406. package/packages/apra-fleet-se/fleet-sprint/docs/escalate-to-llm-design.md +1 -1
  407. package/packages/apra-fleet-se/fleet-sprint/docs/fleet-sprint-diagram.md +3 -3
  408. package/packages/apra-fleet-se/fleet-sprint/docs/run-sprint-cycle-prelude-decision.md +215 -0
  409. package/packages/apra-fleet-se/fleet-sprint/dolt-literal-guard.mjs +56 -1
  410. package/packages/apra-fleet-se/fleet-sprint/dolt-sync.mjs +1327 -44
  411. package/packages/apra-fleet-se/fleet-sprint/errors.mjs +470 -4
  412. package/packages/apra-fleet-se/fleet-sprint/explicit-id-create-guard.mjs +501 -0
  413. package/packages/apra-fleet-se/fleet-sprint/fatal-diagnostics.mjs +134 -0
  414. package/packages/apra-fleet-se/fleet-sprint/full-db-fetch-guard.mjs +102 -0
  415. package/packages/apra-fleet-se/fleet-sprint/git-sync.mjs +747 -0
  416. package/packages/apra-fleet-se/fleet-sprint/git-topology.mjs +543 -0
  417. package/packages/apra-fleet-se/fleet-sprint/guarded-modules.mjs +613 -0
  418. package/packages/apra-fleet-se/fleet-sprint/inline-ladder-guard.mjs +216 -0
  419. package/packages/apra-fleet-se/fleet-sprint/kb-hints.mjs +181 -0
  420. package/packages/apra-fleet-se/fleet-sprint/kb-injection.mjs +64 -0
  421. package/packages/apra-fleet-se/fleet-sprint/kb-maintainer.mjs +298 -0
  422. package/packages/apra-fleet-se/fleet-sprint/kb.mjs +1684 -0
  423. package/packages/apra-fleet-se/fleet-sprint/lower-quality.mjs +39 -0
  424. package/packages/apra-fleet-se/fleet-sprint/mcp-result.mjs +75 -0
  425. package/packages/apra-fleet-se/fleet-sprint/member-align.mjs +391 -0
  426. package/packages/apra-fleet-se/fleet-sprint/member-call.mjs +374 -0
  427. package/packages/apra-fleet-se/fleet-sprint/member-init-probe.mjs +644 -0
  428. package/packages/apra-fleet-se/fleet-sprint/member-provisioning.mjs +699 -0
  429. package/packages/apra-fleet-se/fleet-sprint/member-sync.mjs +802 -0
  430. package/packages/apra-fleet-se/fleet-sprint/member-target.mjs +93 -0
  431. package/packages/apra-fleet-se/fleet-sprint/newtask-text.mjs +266 -0
  432. package/packages/apra-fleet-se/fleet-sprint/orphan-reclaim.mjs +153 -0
  433. package/packages/apra-fleet-se/fleet-sprint/parent-notes-staleness.mjs +201 -0
  434. package/packages/apra-fleet-se/fleet-sprint/phases/deploy.mjs +218 -0
  435. package/packages/apra-fleet-se/fleet-sprint/phases/develop.mjs +869 -0
  436. package/packages/apra-fleet-se/fleet-sprint/phases/ensure-sprint-branch.mjs +295 -0
  437. package/packages/apra-fleet-se/fleet-sprint/phases/final-review.mjs +466 -0
  438. package/packages/apra-fleet-se/fleet-sprint/phases/harvest.mjs +212 -0
  439. package/packages/apra-fleet-se/fleet-sprint/phases/integ-test.mjs +358 -0
  440. package/packages/apra-fleet-se/fleet-sprint/phases/plan.mjs +395 -0
  441. package/packages/apra-fleet-se/fleet-sprint/phases/publish-pr.mjs +345 -0
  442. package/packages/apra-fleet-se/fleet-sprint/phases/re-review.mjs +264 -0
  443. package/packages/apra-fleet-se/fleet-sprint/phases/regression-test.mjs +179 -0
  444. package/packages/apra-fleet-se/fleet-sprint/phases/replan.mjs +230 -0
  445. package/packages/apra-fleet-se/fleet-sprint/phases/review.mjs +365 -0
  446. package/packages/apra-fleet-se/fleet-sprint/pr-body.mjs +259 -0
  447. package/packages/apra-fleet-se/fleet-sprint/prompts.mjs +617 -0
  448. package/packages/apra-fleet-se/fleet-sprint/role-policies.mjs +1434 -0
  449. package/packages/apra-fleet-se/fleet-sprint/round-session.mjs +100 -0
  450. package/packages/apra-fleet-se/fleet-sprint/runner.js +2289 -9928
  451. package/packages/apra-fleet-se/fleet-sprint/se-os-commands.mjs +24 -0
  452. package/packages/apra-fleet-se/fleet-sprint/se-posix.mjs +147 -12
  453. package/packages/apra-fleet-se/fleet-sprint/se-windows.mjs +111 -0
  454. package/packages/apra-fleet-se/fleet-sprint/shell-command-guard.mjs +347 -0
  455. package/packages/apra-fleet-se/fleet-sprint/skills/fleet-sprint-cli/SKILL.md +48 -6
  456. package/packages/apra-fleet-se/fleet-sprint/skills/fleet-supervisor/SKILL.md +98 -25
  457. package/packages/apra-fleet-se/fleet-sprint/sprint-args.mjs +590 -0
  458. package/packages/apra-fleet-se/fleet-sprint/sprint-report.mjs +339 -0
  459. package/packages/apra-fleet-se/fleet-sprint/sprint-state.mjs +185 -0
  460. package/packages/apra-fleet-se/fleet-sprint/unbracketed-push-guard.mjs +234 -0
  461. package/packages/apra-fleet-se/fleet-sprint/usage-limit-controller.mjs +218 -0
  462. package/packages/apra-fleet-se/fleet-sprint/vcs-auth.mjs +1445 -0
  463. package/packages/apra-fleet-se/fleet-sprint/vcs-module.mjs +284 -23
  464. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/azure-devops.mjs +170 -21
  465. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/bitbucket.mjs +28 -0
  466. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/github.mjs +354 -0
  467. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/index.mjs +189 -16
  468. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/shell-helpers.mjs +9 -4
  469. package/packages/apra-fleet-se/fleet-sprint/verify-block.mjs +152 -0
  470. package/packages/apra-fleet-se/fleet-sprint/viewer-extensions.mjs +311 -22
  471. package/packages/apra-fleet-se/fleet-sprint/worklists.mjs +559 -0
  472. package/packages/apra-fleet-se/package.json +2 -2
  473. package/packages/apra-fleet-se/src/supervisor/api.mjs +919 -0
  474. package/packages/apra-fleet-se/src/supervisor/backlog-member.mjs +332 -0
  475. package/packages/apra-fleet-se/src/supervisor/backlog.mjs +982 -0
  476. package/packages/apra-fleet-se/src/supervisor/beads-identity.mjs +246 -0
  477. package/packages/apra-fleet-se/src/supervisor/beads-view.mjs +438 -0
  478. package/packages/apra-fleet-se/src/supervisor/child-port.mjs +36 -0
  479. package/packages/apra-fleet-se/src/supervisor/dashboard.mjs +1659 -0
  480. package/packages/apra-fleet-se/src/supervisor/dolt-mutex.mjs +350 -0
  481. package/packages/apra-fleet-se/src/supervisor/dolt-orphan-sweep.mjs +338 -0
  482. package/packages/apra-fleet-se/src/supervisor/fleet-members.mjs +279 -0
  483. package/packages/apra-fleet-se/src/supervisor/history-view.mjs +276 -0
  484. package/packages/apra-fleet-se/src/supervisor/history.mjs +328 -0
  485. package/packages/apra-fleet-se/src/supervisor/id-allocator.mjs +521 -0
  486. package/packages/apra-fleet-se/src/supervisor/launch-form.mjs +444 -0
  487. package/packages/apra-fleet-se/src/supervisor/ledger.mjs +629 -0
  488. package/packages/apra-fleet-se/src/supervisor/lib/exec-bd.mjs +303 -0
  489. package/packages/apra-fleet-se/src/supervisor/log-timestamp.mjs +51 -0
  490. package/packages/apra-fleet-se/src/supervisor/log-view.mjs +159 -0
  491. package/packages/apra-fleet-se/src/supervisor/proxy.mjs +474 -0
  492. package/packages/apra-fleet-se/src/supervisor/readopt.mjs +136 -0
  493. package/packages/apra-fleet-se/src/supervisor/reconcile.mjs +263 -0
  494. package/packages/apra-fleet-se/src/supervisor/rename-with-retry.mjs +87 -0
  495. package/packages/apra-fleet-se/src/supervisor/scope-overlap.mjs +327 -0
  496. package/packages/apra-fleet-se/src/supervisor/self-log.mjs +133 -0
  497. package/packages/apra-fleet-se/src/supervisor/server.mjs +399 -0
  498. package/packages/apra-fleet-se/src/supervisor/spawner.mjs +542 -0
  499. package/packages/apra-fleet-se/src/supervisor/sprint-identity.mjs +96 -0
  500. package/packages/apra-fleet-se/src/supervisor/watchdog.mjs +987 -0
  501. package/packages/apra-fleet-workflow/package.json +1 -1
  502. package/packages/apra-fleet-workflow/src/viewer/index.mjs +81 -15
  503. package/packages/apra-fleet-workflow/src/viewer/run-summary.mjs +127 -0
  504. package/packages/apra-fleet-workflow/src/workflow/index.mjs +118 -10
  505. package/packages/apra-fleet-workflow/src/workflow/pricing.mjs +75 -25
  506. package/skills/fleet/SKILL.md +8 -8
  507. package/skills/fleet/auth-azdevops.md +14 -3
  508. package/skills/fleet/auth-bitbucket.md +2 -2
  509. package/skills/fleet/auth-github.md +5 -4
  510. package/skills/fleet/onboarding.md +3 -3
  511. package/skills/fleet/permissions.md +14 -1
  512. package/skills/fleet/profiles/node.json +1 -1
  513. package/skills/fleet/profiles/tag-kb-reconciler.json +2 -6
  514. package/skills/fleet/troubleshooting.md +3 -3
  515. package/version.json +1 -1
  516. package/dist/cli/agent-transform.d.ts.map +0 -1
  517. package/dist/cli/agent-transform.js.map +0 -1
  518. package/dist/cli/auth.d.ts.map +0 -1
  519. package/dist/cli/auth.js.map +0 -1
  520. package/dist/cli/config.d.ts.map +0 -1
  521. package/dist/cli/config.js.map +0 -1
  522. package/dist/cli/dolt-install.d.ts.map +0 -1
  523. package/dist/cli/dolt-install.js.map +0 -1
  524. package/dist/cli/install-guard.d.ts.map +0 -1
  525. package/dist/cli/install-guard.js.map +0 -1
  526. package/dist/cli/install.d.ts.map +0 -1
  527. package/dist/cli/install.js.map +0 -1
  528. package/dist/cli/join.d.ts.map +0 -1
  529. package/dist/cli/join.js.map +0 -1
  530. package/dist/cli/kb-commit.d.ts.map +0 -1
  531. package/dist/cli/kb-commit.js.map +0 -1
  532. package/dist/cli/kb-directives.d.ts.map +0 -1
  533. package/dist/cli/kb-directives.js.map +0 -1
  534. package/dist/cli/kb-import.d.ts.map +0 -1
  535. package/dist/cli/kb-import.js.map +0 -1
  536. package/dist/cli/register-member.d.ts.map +0 -1
  537. package/dist/cli/register-member.js.map +0 -1
  538. package/dist/cli/restart.d.ts.map +0 -1
  539. package/dist/cli/restart.js.map +0 -1
  540. package/dist/cli/secret.d.ts.map +0 -1
  541. package/dist/cli/secret.js.map +0 -1
  542. package/dist/cli/spoke.d.ts.map +0 -1
  543. package/dist/cli/spoke.js.map +0 -1
  544. package/dist/cli/start.d.ts.map +0 -1
  545. package/dist/cli/start.js.map +0 -1
  546. package/dist/cli/status.d.ts.map +0 -1
  547. package/dist/cli/status.js.map +0 -1
  548. package/dist/cli/stop.d.ts.map +0 -1
  549. package/dist/cli/stop.js.map +0 -1
  550. package/dist/cli/uninstall.d.ts.map +0 -1
  551. package/dist/cli/uninstall.js.map +0 -1
  552. package/dist/cli/update.d.ts.map +0 -1
  553. package/dist/cli/update.js.map +0 -1
  554. package/dist/cli/watch.d.ts.map +0 -1
  555. package/dist/cli/watch.js.map +0 -1
  556. package/dist/cli/workflow-assets.d.ts.map +0 -1
  557. package/dist/cli/workflow-assets.js.map +0 -1
  558. package/dist/cli/workflow.d.ts.map +0 -1
  559. package/dist/cli/workflow.js.map +0 -1
  560. package/dist/commands/kb-server.d.ts.map +0 -1
  561. package/dist/commands/kb-server.js.map +0 -1
  562. package/dist/delivery-mode.d.ts.map +0 -1
  563. package/dist/delivery-mode.js.map +0 -1
  564. package/dist/hub-service/activity.d.ts.map +0 -1
  565. package/dist/hub-service/activity.js.map +0 -1
  566. package/dist/hub-service/audit-log.d.ts.map +0 -1
  567. package/dist/hub-service/audit-log.js.map +0 -1
  568. package/dist/hub-service/db/pool.d.ts.map +0 -1
  569. package/dist/hub-service/db/pool.js.map +0 -1
  570. package/dist/hub-service/enrollment.d.ts.map +0 -1
  571. package/dist/hub-service/enrollment.js.map +0 -1
  572. package/dist/hub-service/envelope-routes.d.ts.map +0 -1
  573. package/dist/hub-service/envelope-routes.js.map +0 -1
  574. package/dist/hub-service/handlers/installers.d.ts.map +0 -1
  575. package/dist/hub-service/handlers/installers.js.map +0 -1
  576. package/dist/hub-service/http-server.d.ts.map +0 -1
  577. package/dist/hub-service/http-server.js.map +0 -1
  578. package/dist/hub-service/hub-jwt.d.ts.map +0 -1
  579. package/dist/hub-service/hub-jwt.js.map +0 -1
  580. package/dist/hub-service/jwt-revocation.d.ts.map +0 -1
  581. package/dist/hub-service/jwt-revocation.js.map +0 -1
  582. package/dist/hub-service/machines.d.ts.map +0 -1
  583. package/dist/hub-service/machines.js.map +0 -1
  584. package/dist/hub-service/main.d.ts.map +0 -1
  585. package/dist/hub-service/main.js.map +0 -1
  586. package/dist/hub-service/member-tokens.d.ts.map +0 -1
  587. package/dist/hub-service/member-tokens.js.map +0 -1
  588. package/dist/hub-service/member-view.d.ts.map +0 -1
  589. package/dist/hub-service/member-view.js.map +0 -1
  590. package/dist/hub-service/members.d.ts.map +0 -1
  591. package/dist/hub-service/members.js.map +0 -1
  592. package/dist/hub-service/presence.d.ts.map +0 -1
  593. package/dist/hub-service/presence.js.map +0 -1
  594. package/dist/hub-service/project-view.d.ts.map +0 -1
  595. package/dist/hub-service/project-view.js.map +0 -1
  596. package/dist/hub-service/projects.d.ts.map +0 -1
  597. package/dist/hub-service/projects.js.map +0 -1
  598. package/dist/hub-service/relay-queue.d.ts.map +0 -1
  599. package/dist/hub-service/relay-queue.js.map +0 -1
  600. package/dist/hub-service/session-jwt.d.ts.map +0 -1
  601. package/dist/hub-service/session-jwt.js.map +0 -1
  602. package/dist/hub-service/usage.d.ts.map +0 -1
  603. package/dist/hub-service/usage.js.map +0 -1
  604. package/dist/hub-service/users.d.ts.map +0 -1
  605. package/dist/hub-service/users.js.map +0 -1
  606. package/dist/hub-service/workspaces.d.ts.map +0 -1
  607. package/dist/hub-service/workspaces.js.map +0 -1
  608. package/dist/index.d.ts.map +0 -1
  609. package/dist/index.js.map +0 -1
  610. package/dist/onboarding/text.d.ts.map +0 -1
  611. package/dist/onboarding/text.js.map +0 -1
  612. package/dist/os/git-bash-candidates.d.ts.map +0 -1
  613. package/dist/os/git-bash-candidates.js.map +0 -1
  614. package/dist/os/index.d.ts.map +0 -1
  615. package/dist/os/index.js.map +0 -1
  616. package/dist/os/linux.d.ts.map +0 -1
  617. package/dist/os/linux.js.map +0 -1
  618. package/dist/os/macos.d.ts.map +0 -1
  619. package/dist/os/macos.js.map +0 -1
  620. package/dist/os/os-commands.d.ts.map +0 -1
  621. package/dist/os/os-commands.js.map +0 -1
  622. package/dist/os/windows-gitbash.d.ts.map +0 -1
  623. package/dist/os/windows-gitbash.js.map +0 -1
  624. package/dist/os/windows-wrapper.d.ts.map +0 -1
  625. package/dist/os/windows-wrapper.js.map +0 -1
  626. package/dist/os/windows.d.ts.map +0 -1
  627. package/dist/os/windows.js.map +0 -1
  628. package/dist/paths.d.ts.map +0 -1
  629. package/dist/paths.js.map +0 -1
  630. package/dist/providers/agy.d.ts.map +0 -1
  631. package/dist/providers/agy.js.map +0 -1
  632. package/dist/providers/claude.d.ts.map +0 -1
  633. package/dist/providers/claude.js.map +0 -1
  634. package/dist/providers/codex.d.ts.map +0 -1
  635. package/dist/providers/codex.js.map +0 -1
  636. package/dist/providers/copilot.d.ts.map +0 -1
  637. package/dist/providers/copilot.js.map +0 -1
  638. package/dist/providers/email/headers.d.ts.map +0 -1
  639. package/dist/providers/email/headers.js.map +0 -1
  640. package/dist/providers/email/index.d.ts.map +0 -1
  641. package/dist/providers/email/index.js.map +0 -1
  642. package/dist/providers/email/provider.d.ts.map +0 -1
  643. package/dist/providers/email/provider.js.map +0 -1
  644. package/dist/providers/email/sendgrid.d.ts.map +0 -1
  645. package/dist/providers/email/sendgrid.js.map +0 -1
  646. package/dist/providers/email/smtp.d.ts.map +0 -1
  647. package/dist/providers/email/smtp.js.map +0 -1
  648. package/dist/providers/index.d.ts.map +0 -1
  649. package/dist/providers/index.js.map +0 -1
  650. package/dist/providers/none.d.ts.map +0 -1
  651. package/dist/providers/none.js.map +0 -1
  652. package/dist/providers/opencode.d.ts.map +0 -1
  653. package/dist/providers/opencode.js.map +0 -1
  654. package/dist/providers/provider.d.ts.map +0 -1
  655. package/dist/providers/provider.js.map +0 -1
  656. package/dist/services/agent-provisioner.d.ts.map +0 -1
  657. package/dist/services/agent-provisioner.js.map +0 -1
  658. package/dist/services/auth-socket.d.ts.map +0 -1
  659. package/dist/services/auth-socket.js.map +0 -1
  660. package/dist/services/auth-web.d.ts.map +0 -1
  661. package/dist/services/auth-web.js.map +0 -1
  662. package/dist/services/budget-awareness.d.ts.map +0 -1
  663. package/dist/services/budget-awareness.js.map +0 -1
  664. package/dist/services/cloud/activity.d.ts.map +0 -1
  665. package/dist/services/cloud/activity.js.map +0 -1
  666. package/dist/services/cloud/aws.d.ts.map +0 -1
  667. package/dist/services/cloud/aws.js.map +0 -1
  668. package/dist/services/cloud/cost.d.ts.map +0 -1
  669. package/dist/services/cloud/cost.js.map +0 -1
  670. package/dist/services/cloud/idle-manager.d.ts.map +0 -1
  671. package/dist/services/cloud/idle-manager.js.map +0 -1
  672. package/dist/services/cloud/lifecycle.d.ts.map +0 -1
  673. package/dist/services/cloud/lifecycle.js.map +0 -1
  674. package/dist/services/cloud/task-wrapper.d.ts.map +0 -1
  675. package/dist/services/cloud/task-wrapper.js.map +0 -1
  676. package/dist/services/cloud/types.d.ts.map +0 -1
  677. package/dist/services/cloud/types.js.map +0 -1
  678. package/dist/services/cloud-sync.d.ts.map +0 -1
  679. package/dist/services/cloud-sync.js.map +0 -1
  680. package/dist/services/context-admission.d.ts.map +0 -1
  681. package/dist/services/context-admission.js.map +0 -1
  682. package/dist/services/credential-cleanup.d.ts.map +0 -1
  683. package/dist/services/credential-cleanup.js.map +0 -1
  684. package/dist/services/credential-store.d.ts.map +0 -1
  685. package/dist/services/credential-store.js.map +0 -1
  686. package/dist/services/event-bus.d.ts.map +0 -1
  687. package/dist/services/event-bus.js.map +0 -1
  688. package/dist/services/file-chunker.d.ts.map +0 -1
  689. package/dist/services/file-chunker.js.map +0 -1
  690. package/dist/services/file-transfer-relay.d.ts.map +0 -1
  691. package/dist/services/file-transfer-relay.js.map +0 -1
  692. package/dist/services/file-transfer.d.ts.map +0 -1
  693. package/dist/services/file-transfer.js.map +0 -1
  694. package/dist/services/git-config.d.ts.map +0 -1
  695. package/dist/services/git-config.js.map +0 -1
  696. package/dist/services/github-app.d.ts.map +0 -1
  697. package/dist/services/github-app.js.map +0 -1
  698. package/dist/services/http-transport.d.ts.map +0 -1
  699. package/dist/services/http-transport.js.map +0 -1
  700. package/dist/services/hub-client.d.ts.map +0 -1
  701. package/dist/services/hub-client.js.map +0 -1
  702. package/dist/services/icons.d.ts.map +0 -1
  703. package/dist/services/icons.js.map +0 -1
  704. package/dist/services/jwt.d.ts.map +0 -1
  705. package/dist/services/jwt.js.map +0 -1
  706. package/dist/services/knowledge/audn.d.ts.map +0 -1
  707. package/dist/services/knowledge/audn.js.map +0 -1
  708. package/dist/services/knowledge/file-hash.d.ts.map +0 -1
  709. package/dist/services/knowledge/file-hash.js.map +0 -1
  710. package/dist/services/knowledge/http-provider.d.ts.map +0 -1
  711. package/dist/services/knowledge/http-provider.js.map +0 -1
  712. package/dist/services/knowledge/kb-providers.d.ts.map +0 -1
  713. package/dist/services/knowledge/kb-providers.js.map +0 -1
  714. package/dist/services/knowledge/kb-scope-input.d.ts +0 -5
  715. package/dist/services/knowledge/kb-scope-input.d.ts.map +0 -1
  716. package/dist/services/knowledge/kb-scope-input.js +0 -11
  717. package/dist/services/knowledge/kb-scope-input.js.map +0 -1
  718. package/dist/services/knowledge/kb-service.d.ts.map +0 -1
  719. package/dist/services/knowledge/kb-service.js.map +0 -1
  720. package/dist/services/knowledge/path-validation.d.ts.map +0 -1
  721. package/dist/services/knowledge/path-validation.js.map +0 -1
  722. package/dist/services/knowledge/pre-init.d.ts.map +0 -1
  723. package/dist/services/knowledge/pre-init.js.map +0 -1
  724. package/dist/services/knowledge/project-slug.d.ts.map +0 -1
  725. package/dist/services/knowledge/project-slug.js.map +0 -1
  726. package/dist/services/knowledge/sqlite-provider.d.ts.map +0 -1
  727. package/dist/services/knowledge/sqlite-provider.js.map +0 -1
  728. package/dist/services/knowledge/types.d.ts.map +0 -1
  729. package/dist/services/knowledge/types.js.map +0 -1
  730. package/dist/services/known-hosts.d.ts.map +0 -1
  731. package/dist/services/known-hosts.js.map +0 -1
  732. package/dist/services/known-sessions.d.ts.map +0 -1
  733. package/dist/services/known-sessions.js.map +0 -1
  734. package/dist/services/member-home.d.ts.map +0 -1
  735. package/dist/services/member-home.js.map +0 -1
  736. package/dist/services/member-remote-url.d.ts.map +0 -1
  737. package/dist/services/member-remote-url.js.map +0 -1
  738. package/dist/services/model-pricing.d.ts.map +0 -1
  739. package/dist/services/model-pricing.js.map +0 -1
  740. package/dist/services/onboarding.d.ts.map +0 -1
  741. package/dist/services/onboarding.js.map +0 -1
  742. package/dist/services/orphan-recovery.d.ts.map +0 -1
  743. package/dist/services/orphan-recovery.js.map +0 -1
  744. package/dist/services/pending-responses.d.ts.map +0 -1
  745. package/dist/services/pending-responses.js.map +0 -1
  746. package/dist/services/preflight-check.d.ts.map +0 -1
  747. package/dist/services/preflight-check.js.map +0 -1
  748. package/dist/services/registry.d.ts.map +0 -1
  749. package/dist/services/registry.js.map +0 -1
  750. package/dist/services/relay-context.d.ts.map +0 -1
  751. package/dist/services/relay-context.js.map +0 -1
  752. package/dist/services/relay-executor.d.ts.map +0 -1
  753. package/dist/services/relay-executor.js.map +0 -1
  754. package/dist/services/relay-request.d.ts.map +0 -1
  755. package/dist/services/relay-request.js.map +0 -1
  756. package/dist/services/relay-strategy.d.ts.map +0 -1
  757. package/dist/services/relay-strategy.js.map +0 -1
  758. package/dist/services/service-manager/index.d.ts.map +0 -1
  759. package/dist/services/service-manager/index.js.map +0 -1
  760. package/dist/services/service-manager/linux.d.ts.map +0 -1
  761. package/dist/services/service-manager/linux.js.map +0 -1
  762. package/dist/services/service-manager/macos.d.ts.map +0 -1
  763. package/dist/services/service-manager/macos.js.map +0 -1
  764. package/dist/services/service-manager/types.d.ts.map +0 -1
  765. package/dist/services/service-manager/types.js.map +0 -1
  766. package/dist/services/service-manager/windows.d.ts.map +0 -1
  767. package/dist/services/service-manager/windows.js.map +0 -1
  768. package/dist/services/session-registry.d.ts.map +0 -1
  769. package/dist/services/session-registry.js.map +0 -1
  770. package/dist/services/sftp.d.ts.map +0 -1
  771. package/dist/services/sftp.js.map +0 -1
  772. package/dist/services/shell-probe.d.ts.map +0 -1
  773. package/dist/services/shell-probe.js.map +0 -1
  774. package/dist/services/singleton.d.ts.map +0 -1
  775. package/dist/services/singleton.js.map +0 -1
  776. package/dist/services/sprint-coordination.d.ts.map +0 -1
  777. package/dist/services/sprint-coordination.js.map +0 -1
  778. package/dist/services/ssh.d.ts.map +0 -1
  779. package/dist/services/ssh.js.map +0 -1
  780. package/dist/services/stall/find-log-file.d.ts.map +0 -1
  781. package/dist/services/stall/find-log-file.js.map +0 -1
  782. package/dist/services/stall/index.d.ts.map +0 -1
  783. package/dist/services/stall/index.js.map +0 -1
  784. package/dist/services/stall/log-path-resolver.d.ts.map +0 -1
  785. package/dist/services/stall/log-path-resolver.js.map +0 -1
  786. package/dist/services/stall/read-log-tail.d.ts.map +0 -1
  787. package/dist/services/stall/read-log-tail.js.map +0 -1
  788. package/dist/services/stall/stall-detector.d.ts.map +0 -1
  789. package/dist/services/stall/stall-detector.js.map +0 -1
  790. package/dist/services/stall/stall-poller.d.ts.map +0 -1
  791. package/dist/services/stall/stall-poller.js.map +0 -1
  792. package/dist/services/stall/time-utils.d.ts.map +0 -1
  793. package/dist/services/stall/time-utils.js.map +0 -1
  794. package/dist/services/statusline.d.ts.map +0 -1
  795. package/dist/services/statusline.js.map +0 -1
  796. package/dist/services/strategy.d.ts.map +0 -1
  797. package/dist/services/strategy.js.map +0 -1
  798. package/dist/services/substitution-engine.d.ts.map +0 -1
  799. package/dist/services/substitution-engine.js.map +0 -1
  800. package/dist/services/task-cleanup.d.ts.map +0 -1
  801. package/dist/services/task-cleanup.js.map +0 -1
  802. package/dist/services/token-issuer.d.ts.map +0 -1
  803. package/dist/services/token-issuer.js.map +0 -1
  804. package/dist/services/tool-registry.d.ts.map +0 -1
  805. package/dist/services/tool-registry.js.map +0 -1
  806. package/dist/services/update-check.d.ts.map +0 -1
  807. package/dist/services/update-check.js.map +0 -1
  808. package/dist/services/user-config.d.ts.map +0 -1
  809. package/dist/services/user-config.js.map +0 -1
  810. package/dist/services/vcs/azure-devops.d.ts.map +0 -1
  811. package/dist/services/vcs/azure-devops.js.map +0 -1
  812. package/dist/services/vcs/bitbucket.d.ts.map +0 -1
  813. package/dist/services/vcs/bitbucket.js.map +0 -1
  814. package/dist/services/vcs/constants.d.ts.map +0 -1
  815. package/dist/services/vcs/constants.js.map +0 -1
  816. package/dist/services/vcs/github.d.ts.map +0 -1
  817. package/dist/services/vcs/github.js.map +0 -1
  818. package/dist/services/vcs/types.d.ts.map +0 -1
  819. package/dist/services/vcs/types.js.map +0 -1
  820. package/dist/services/version-check.d.ts.map +0 -1
  821. package/dist/services/version-check.js.map +0 -1
  822. package/dist/services/watch/fleet-log.d.ts.map +0 -1
  823. package/dist/services/watch/fleet-log.js.map +0 -1
  824. package/dist/services/watch/project-resolver.d.ts.map +0 -1
  825. package/dist/services/watch/project-resolver.js.map +0 -1
  826. package/dist/services/watch/transcript-formatter.d.ts.map +0 -1
  827. package/dist/services/watch/transcript-formatter.js.map +0 -1
  828. package/dist/smoke-test.d.ts.map +0 -1
  829. package/dist/smoke-test.js.map +0 -1
  830. package/dist/tools/check-status.d.ts.map +0 -1
  831. package/dist/tools/check-status.js.map +0 -1
  832. package/dist/tools/child-id-allocator.d.ts.map +0 -1
  833. package/dist/tools/child-id-allocator.js.map +0 -1
  834. package/dist/tools/cloud-control.d.ts.map +0 -1
  835. package/dist/tools/cloud-control.js.map +0 -1
  836. package/dist/tools/code-intelligence-codebase-memory.d.ts.map +0 -1
  837. package/dist/tools/code-intelligence-codebase-memory.js.map +0 -1
  838. package/dist/tools/code-intelligence-freshness.d.ts.map +0 -1
  839. package/dist/tools/code-intelligence-freshness.js.map +0 -1
  840. package/dist/tools/code-intelligence-gitnexus.d.ts.map +0 -1
  841. package/dist/tools/code-intelligence-gitnexus.js.map +0 -1
  842. package/dist/tools/code-intelligence-kb-enrich.d.ts.map +0 -1
  843. package/dist/tools/code-intelligence-kb-enrich.js.map +0 -1
  844. package/dist/tools/code-intelligence-reindex.d.ts.map +0 -1
  845. package/dist/tools/code-intelligence-reindex.js.map +0 -1
  846. package/dist/tools/code-intelligence-telemetry.d.ts.map +0 -1
  847. package/dist/tools/code-intelligence-telemetry.js.map +0 -1
  848. package/dist/tools/code-intelligence-tests.d.ts.map +0 -1
  849. package/dist/tools/code-intelligence-tests.js.map +0 -1
  850. package/dist/tools/code-intelligence.d.ts.map +0 -1
  851. package/dist/tools/code-intelligence.js.map +0 -1
  852. package/dist/tools/compose-permissions.d.ts.map +0 -1
  853. package/dist/tools/compose-permissions.js.map +0 -1
  854. package/dist/tools/credential-store-delete.d.ts.map +0 -1
  855. package/dist/tools/credential-store-delete.js.map +0 -1
  856. package/dist/tools/credential-store-list.d.ts.map +0 -1
  857. package/dist/tools/credential-store-list.js.map +0 -1
  858. package/dist/tools/credential-store-set.d.ts.map +0 -1
  859. package/dist/tools/credential-store-set.js.map +0 -1
  860. package/dist/tools/credential-store-update.d.ts.map +0 -1
  861. package/dist/tools/credential-store-update.js.map +0 -1
  862. package/dist/tools/dolt-push-mutex.d.ts.map +0 -1
  863. package/dist/tools/dolt-push-mutex.js.map +0 -1
  864. package/dist/tools/execute-command.d.ts.map +0 -1
  865. package/dist/tools/execute-command.js.map +0 -1
  866. package/dist/tools/execute-prompt.d.ts.map +0 -1
  867. package/dist/tools/execute-prompt.js.map +0 -1
  868. package/dist/tools/get-member-model-pricing.d.ts.map +0 -1
  869. package/dist/tools/get-member-model-pricing.js.map +0 -1
  870. package/dist/tools/kb-capture.d.ts.map +0 -1
  871. package/dist/tools/kb-capture.js.map +0 -1
  872. package/dist/tools/kb-context.d.ts.map +0 -1
  873. package/dist/tools/kb-context.js.map +0 -1
  874. package/dist/tools/kb-export.d.ts.map +0 -1
  875. package/dist/tools/kb-export.js.map +0 -1
  876. package/dist/tools/kb-feedback.d.ts.map +0 -1
  877. package/dist/tools/kb-feedback.js.map +0 -1
  878. package/dist/tools/kb-freshness-sweep.d.ts.map +0 -1
  879. package/dist/tools/kb-freshness-sweep.js.map +0 -1
  880. package/dist/tools/kb-harvest.d.ts.map +0 -1
  881. package/dist/tools/kb-harvest.js.map +0 -1
  882. package/dist/tools/kb-import.d.ts.map +0 -1
  883. package/dist/tools/kb-import.js.map +0 -1
  884. package/dist/tools/kb-invalidate.d.ts.map +0 -1
  885. package/dist/tools/kb-invalidate.js.map +0 -1
  886. package/dist/tools/kb-list.d.ts.map +0 -1
  887. package/dist/tools/kb-list.js.map +0 -1
  888. package/dist/tools/kb-promote.d.ts.map +0 -1
  889. package/dist/tools/kb-promote.js.map +0 -1
  890. package/dist/tools/kb-query.d.ts.map +0 -1
  891. package/dist/tools/kb-query.js.map +0 -1
  892. package/dist/tools/kb-reconcile-prefilter.d.ts.map +0 -1
  893. package/dist/tools/kb-reconcile-prefilter.js.map +0 -1
  894. package/dist/tools/kb-resolve-contradiction.d.ts.map +0 -1
  895. package/dist/tools/kb-resolve-contradiction.js.map +0 -1
  896. package/dist/tools/kb-session-prime.d.ts.map +0 -1
  897. package/dist/tools/kb-session-prime.js.map +0 -1
  898. package/dist/tools/kb-setup.d.ts.map +0 -1
  899. package/dist/tools/kb-setup.js.map +0 -1
  900. package/dist/tools/kb-stats.d.ts.map +0 -1
  901. package/dist/tools/kb-stats.js.map +0 -1
  902. package/dist/tools/list-members.d.ts.map +0 -1
  903. package/dist/tools/list-members.js.map +0 -1
  904. package/dist/tools/member-detail.d.ts.map +0 -1
  905. package/dist/tools/member-detail.js.map +0 -1
  906. package/dist/tools/member-reservation.d.ts.map +0 -1
  907. package/dist/tools/member-reservation.js.map +0 -1
  908. package/dist/tools/monitor-task.d.ts.map +0 -1
  909. package/dist/tools/monitor-task.js.map +0 -1
  910. package/dist/tools/provision-auth.d.ts.map +0 -1
  911. package/dist/tools/provision-auth.js.map +0 -1
  912. package/dist/tools/provision-vcs-auth.d.ts.map +0 -1
  913. package/dist/tools/provision-vcs-auth.js.map +0 -1
  914. package/dist/tools/receive-files.d.ts.map +0 -1
  915. package/dist/tools/receive-files.js.map +0 -1
  916. package/dist/tools/register-member.d.ts.map +0 -1
  917. package/dist/tools/register-member.js.map +0 -1
  918. package/dist/tools/remove-member.d.ts.map +0 -1
  919. package/dist/tools/remove-member.js.map +0 -1
  920. package/dist/tools/report-status.d.ts.map +0 -1
  921. package/dist/tools/report-status.js.map +0 -1
  922. package/dist/tools/respond-to-message.d.ts.map +0 -1
  923. package/dist/tools/respond-to-message.js.map +0 -1
  924. package/dist/tools/revoke-vcs-auth.d.ts.map +0 -1
  925. package/dist/tools/revoke-vcs-auth.js.map +0 -1
  926. package/dist/tools/send-email.d.ts.map +0 -1
  927. package/dist/tools/send-email.js.map +0 -1
  928. package/dist/tools/send-files.d.ts.map +0 -1
  929. package/dist/tools/send-files.js.map +0 -1
  930. package/dist/tools/send-message.d.ts.map +0 -1
  931. package/dist/tools/send-message.js.map +0 -1
  932. package/dist/tools/setup-git-app.d.ts.map +0 -1
  933. package/dist/tools/setup-git-app.js.map +0 -1
  934. package/dist/tools/setup-ssh-key.d.ts.map +0 -1
  935. package/dist/tools/setup-ssh-key.js.map +0 -1
  936. package/dist/tools/shutdown-server.d.ts.map +0 -1
  937. package/dist/tools/shutdown-server.js.map +0 -1
  938. package/dist/tools/stop-prompt.d.ts.map +0 -1
  939. package/dist/tools/stop-prompt.js.map +0 -1
  940. package/dist/tools/update-agent-cli.d.ts.map +0 -1
  941. package/dist/tools/update-agent-cli.js.map +0 -1
  942. package/dist/tools/update-member.d.ts.map +0 -1
  943. package/dist/tools/update-member.js.map +0 -1
  944. package/dist/tools/version.d.ts.map +0 -1
  945. package/dist/tools/version.js.map +0 -1
  946. package/dist/types.d.ts.map +0 -1
  947. package/dist/types.js.map +0 -1
  948. package/dist/utils/agent-helpers.d.ts.map +0 -1
  949. package/dist/utils/agent-helpers.js.map +0 -1
  950. package/dist/utils/ansi.d.ts.map +0 -1
  951. package/dist/utils/ansi.js.map +0 -1
  952. package/dist/utils/auth-env.d.ts.map +0 -1
  953. package/dist/utils/auth-env.js.map +0 -1
  954. package/dist/utils/collect-secret.d.ts.map +0 -1
  955. package/dist/utils/collect-secret.js.map +0 -1
  956. package/dist/utils/credential-validation.d.ts.map +0 -1
  957. package/dist/utils/credential-validation.js.map +0 -1
  958. package/dist/utils/crypto.d.ts.map +0 -1
  959. package/dist/utils/crypto.js.map +0 -1
  960. package/dist/utils/deep-merge.d.ts.map +0 -1
  961. package/dist/utils/deep-merge.js.map +0 -1
  962. package/dist/utils/file-permissions.d.ts.map +0 -1
  963. package/dist/utils/file-permissions.js.map +0 -1
  964. package/dist/utils/gpu-parser.d.ts.map +0 -1
  965. package/dist/utils/gpu-parser.js.map +0 -1
  966. package/dist/utils/log-helpers.d.ts.map +0 -1
  967. package/dist/utils/log-helpers.js.map +0 -1
  968. package/dist/utils/oob-timeout.d.ts.map +0 -1
  969. package/dist/utils/oob-timeout.js.map +0 -1
  970. package/dist/utils/opencode-model-validation.d.ts.map +0 -1
  971. package/dist/utils/opencode-model-validation.js.map +0 -1
  972. package/dist/utils/pid-helpers.d.ts.map +0 -1
  973. package/dist/utils/pid-helpers.js.map +0 -1
  974. package/dist/utils/platform.d.ts.map +0 -1
  975. package/dist/utils/platform.js.map +0 -1
  976. package/dist/utils/process-utils.d.ts.map +0 -1
  977. package/dist/utils/process-utils.js.map +0 -1
  978. package/dist/utils/prompt-errors.d.ts.map +0 -1
  979. package/dist/utils/prompt-errors.js.map +0 -1
  980. package/dist/utils/resolve-member.d.ts.map +0 -1
  981. package/dist/utils/resolve-member.js.map +0 -1
  982. package/dist/utils/secure-input.d.ts.map +0 -1
  983. package/dist/utils/secure-input.js.map +0 -1
  984. package/dist/utils/session-caller.d.ts.map +0 -1
  985. package/dist/utils/session-caller.js.map +0 -1
  986. package/dist/utils/shell-escape.d.ts.map +0 -1
  987. package/dist/utils/shell-escape.js.map +0 -1
  988. package/dist/utils/skill-matrix.d.ts.map +0 -1
  989. package/dist/utils/skill-matrix.js.map +0 -1
  990. package/dist/utils/ssh-error-messages.d.ts.map +0 -1
  991. package/dist/utils/ssh-error-messages.js.map +0 -1
  992. package/dist/utils/work-folder-validation.d.ts.map +0 -1
  993. package/dist/utils/work-folder-validation.js.map +0 -1
  994. package/dist/utils/workspace-trust.d.ts.map +0 -1
  995. package/dist/utils/workspace-trust.js.map +0 -1
  996. package/dist/version.d.ts.map +0 -1
  997. package/dist/version.js.map +0 -1
package/dist/types.d.ts CHANGED
@@ -20,6 +20,11 @@ export interface Agent {
20
20
  keyPath?: string;
21
21
  workFolder: string;
22
22
  sessionId?: string;
23
+ /** Server build (serverVersion) that recorded sessionId. A default resume
24
+ * (resume=true) of a session recorded under another build -- or with no
25
+ * stamp, i.e. before this field existed -- starts fresh instead: the old
26
+ * session's transcript lists tools/MCP config that build no longer serves. */
27
+ sessionServerVersion?: string;
23
28
  os?: 'windows' | 'macos' | 'linux';
24
29
  /** Windows shell this member's OS commands should target. Only meaningful
25
30
  * when os is 'windows' -- non-windows members leave this unset. Set by
@@ -33,7 +38,20 @@ export interface Agent {
33
38
  gitRepos?: string[];
34
39
  vcsProvider?: 'github' | 'bitbucket' | 'azure-devops';
35
40
  vcsTokenExpiresAt?: string;
41
+ /** The label/scopeUrl actually used for the LAST provision_vcs_auth deploy
42
+ * on this agent. scheduleCredentialCleanup's timer reads these back so the
43
+ * eventual revoke targets the exact same credential-helper file/config-key
44
+ * pair the deploy wrote, instead of guessing at unlabeled/default-host
45
+ * values that may belong to a different, still-valid credential. */
46
+ vcsCredentialLabel?: string;
47
+ vcsCredentialScopeUrl?: string;
36
48
  llmProvider?: LlmProvider;
49
+ /** AGY only: id of the member's own agy project (~/.gemini/config/projects/<id>.json),
50
+ * created by `agy --new-project` and passed as `--project <id>` on every dispatch.
51
+ * compose_permissions writes the member's grants into that file. Absent for
52
+ * members registered before project binding; provisioned on their next
53
+ * compose_permissions or execute_prompt. */
54
+ agyProjectId?: string;
37
55
  modelCheap?: string;
38
56
  modelStandard?: string;
39
57
  modelPremium?: string;
@@ -59,11 +77,103 @@ export interface Agent {
59
77
  * service-local supervisor ledger. Set/enforced by later eft.10.x tasks;
60
78
  * this field only introduces and persists the value. */
61
79
  reservedBy?: string | null;
62
- /** This member fills a role (e.g. fleet-sprint's `orchestrator`) that is
80
+ /** This member fills a role (e.g. fleet-sprint's `backlog`) that is
63
81
  * designed to be shared by more than one sprint at once, so it can never
64
82
  * be exclusively reserved: reserve/release/force_release are no-op
65
83
  * successes and overlap guards skip it. Defaults to false/absent. */
66
84
  unreservable?: boolean;
85
+ /** Last OBSERVED state of this member's own apra-fleet MCP server (install,
86
+ * self-registration, per-folder MCP entry, MEMBER session). Never sticky:
87
+ * every probe overwrites it, so a manual fix flips unavailable -> available
88
+ * on the next probe with no restart (src/services/member-fleet-install.ts). */
89
+ fleetMcp?: FleetMcpStatus;
90
+ /** Remote members: the port the member's OWN apra-fleet install records in
91
+ * its member-install marker, i.e. where its server listens. memberMcpUrl
92
+ * builds the member's MCP URL from it; absent means the install recorded
93
+ * no port (the built-in default is used, and fleetMcp detail says so).
94
+ * Set by the fleetMcp probe (recordFleetMcpStatus) and kept separate from
95
+ * fleetMcp so a later status overwrite never silently drops it. */
96
+ memberMcpPort?: number;
97
+ /** Remote members: the member install's member access secret
98
+ * (<data dir>/member-access.key there), encrypted like encryptedPassword.
99
+ * Its server accepts a `?member=` session only with this secret in the
100
+ * X-Apra-Fleet-Member-Secret header (src/services/member-access-secret.ts).
101
+ * Set by the fleetMcp probe; absent until it read the secret. */
102
+ encryptedMemberMcpSecret?: string;
103
+ }
104
+ /** Observation of a member's apra-fleet MCP server (see Agent.fleetMcp). */
105
+ export interface FleetMcpStatus {
106
+ state: 'available' | 'unavailable';
107
+ /** Machine-readable cause when unavailable (e.g. install-too-old,
108
+ * E-FOLDER-TAKEN, mcp-entry-missing, no-per-project-mcp). */
109
+ reason?: string;
110
+ /** apra-fleet version the member's own install reports, when known. */
111
+ version?: string;
112
+ /** ISO 8601 time of the probe that produced this observation. */
113
+ checkedAt: string;
114
+ /** Human-readable diagnostic for the reason. Never required. */
115
+ detail?: string;
116
+ /** True when the member's KB/code tools could not be verified (e.g. agy),
117
+ * so callers must treat it as unverified (it gets the injected KB block). */
118
+ unverified?: boolean;
119
+ /** ISO 8601 time this fleet last SUCCESSFULLY installed apra-fleet on the
120
+ * member (ensureOnce returned installed:true). Written only by a successful
121
+ * fleet install and carried across later probes; never set by a refusal or
122
+ * an observation-only probe. An observation only: it is NOT an ownership
123
+ * signal (a human full install over a fleet install clears the marker but
124
+ * leaves this set); the member-install marker alone is (see
125
+ * memberHasInstallMarker), and the fleet never sends --force-stop-full-install. */
126
+ fleetInstalledAt?: string;
127
+ /** A requested apra-fleet upgrade that failed before the member was touched
128
+ * (no arch/source, download, checksum or transfer failure) while the older
129
+ * install stayed in use. Present on available and unavailable statuses so a
130
+ * later step can never hide it; `detail` names it too. */
131
+ installFailure?: {
132
+ reason: string;
133
+ detail?: string;
134
+ };
135
+ /** Present only when the beads CLI (bd) is NOT usable on a remote member
136
+ * (neither on its PATH nor in <home>/.apra-fleet/bin): sprint roles there
137
+ * cannot run bd. Independent of `state` (the KB/code tools may still work);
138
+ * absent when bd works or could not be probed. */
139
+ beads?: {
140
+ state: 'missing' | 'broken';
141
+ detail: string;
142
+ fix: string;
143
+ };
144
+ /** Remote members: the port the member's MCP URL uses, as resolved by this
145
+ * probe from the member's own install. Absent when the probe did not get
146
+ * that far (the previously recorded port is kept then). */
147
+ port?: number;
148
+ /** Where `port` came from: the member-install marker, or the built-in
149
+ * default because the marker records no port (detail says so). */
150
+ portSource?: 'marker' | 'default';
151
+ /** Set by the probe that replaced an unmarked (full) install with a member
152
+ * install (fleet_install "replace-full"): the replaced version, what was
153
+ * removed or moved, and the timestamped backup directory on the member.
154
+ * An observation of that probe only; not carried to later probes. */
155
+ replacedFullInstall?: {
156
+ previousVersion: string;
157
+ removed: string[];
158
+ backupPath: string;
159
+ };
160
+ /** Set when a requested apra-fleet install/upgrade on the member did not
161
+ * happen (any install reason, on available and unavailable statuses): the
162
+ * exact manual steps, built for the member's OS/shell, to install this
163
+ * orchestrator's build there by hand (anonymous download URL, SHA-256
164
+ * check, member-mode install, then update_member). register_member /
165
+ * update_member print it in a WARNING; the call itself still succeeds. */
166
+ manualInstall?: string;
167
+ /** Set by the probe that installed the signed stable release of the
168
+ * orchestrator's core (`tag`, e.g. v0.4.4) because no release carries the
169
+ * exact build (`wantedBuild`); only when the member had no apra-fleet or an
170
+ * older core. `why` says what was tried. register_member / update_member
171
+ * print it as a NOTICE. */
172
+ sameCoreFallback?: {
173
+ tag: string;
174
+ wantedBuild: string;
175
+ why: string;
176
+ };
67
177
  }
68
178
  export interface GitHubAppConfig {
69
179
  appId: string;
@@ -1,4 +1,5 @@
1
1
  import { getAgent, findAgentByName, updateAgent } from '../services/registry.js';
2
+ import { serverVersion } from '../version.js';
2
3
  /**
3
4
  * Look up an agent by ID or return a formatted error string.
4
5
  * Eliminates the repeated pattern of getAgent() + "not found" check in every tool.
@@ -141,6 +142,7 @@ export function touchAgent(agentId, sessionId) {
141
142
  const updates = { lastUsed: new Date().toISOString() };
142
143
  if (sessionId !== undefined) {
143
144
  updates.sessionId = sessionId;
145
+ updates.sessionServerVersion = serverVersion;
144
146
  }
145
147
  updateAgent(agentId, updates);
146
148
  idleTouchHook?.(agentId); // T7: notify idle manager to reset idle timer
@@ -1,8 +1,19 @@
1
1
  import type { Agent } from '../types.js';
2
- import type { RemoteOS } from './platform.js';
2
+ /** Decrypted stored auth env vars for the member ({} when none). */
3
+ export declare function decryptAuthEnvVars(agent: Agent): Record<string, string>;
3
4
  /**
4
- * Build a platform-correct inline export prefix for all stored auth env vars.
5
- * Returns empty string if the agent has no stored env vars.
5
+ * File content for the member's shell.
6
+ * - POSIX: `export NAME='value'` lines (single-quoted: fully literal, safe for
7
+ * any byte including newlines), loaded with `.`.
8
+ * - PowerShell: `NAME=<base64(utf8 value)>` lines, parsed (never executed --
9
+ * no execution-policy or quoting exposure).
6
10
  */
7
- export declare function buildAuthEnvPrefix(agent: Agent, os: RemoteOS): string;
11
+ export declare function buildAuthEnvFileContent(vars: Record<string, string>, posix: boolean): string;
12
+ /**
13
+ * Command prefix that loads the staged file into the current shell's
14
+ * environment and deletes it. Carries only the file path, never a value.
15
+ * POSIX: a missing/unreadable file short-circuits the `&&` chain (no
16
+ * unauthenticated run). PowerShell: fails loudly with exit 1.
17
+ */
18
+ export declare function buildAuthEnvSourcePrefix(filePath: string, posix: boolean): string;
8
19
  //# sourceMappingURL=auth-env.d.ts.map
@@ -1,30 +1,59 @@
1
1
  import { decryptPassword } from './crypto.js';
2
- import { escapeDoubleQuoted } from './shell-escape.js';
2
+ import { escapeShellArg, escapePowerShellArg } from './shell-escape.js';
3
3
  /**
4
- * Build a platform-correct inline export prefix for all stored auth env vars.
5
- * Returns empty string if the agent has no stored env vars.
4
+ * Stored member auth env vars (encryptedEnvVars) reach the member's CLI
5
+ * process through a short-lived owner-only FILE, never through the command
6
+ * line: anything in a member-bound command string ends up in the argv of the
7
+ * member's shell (`bash -c <cmd>` / `powershell -c <cmd>`) for the lifetime of
8
+ * the dispatch, readable by every local user via ps or /proc/<pid>/cmdline.
9
+ *
10
+ * The flow (see services/member-secret-env.ts):
11
+ * 1. buildAuthEnvFileContent() renders the values for the member's shell;
12
+ * 2. the file is written over SFTP (remote) or fs (local) -- no argv;
13
+ * 3. buildAuthEnvSourcePrefix() returns a prefix that carries ONLY the file
14
+ * path: it loads the file into the shell's environment and deletes it
15
+ * before the CLI starts, so the CLI inherits the variables.
6
16
  */
7
- export function buildAuthEnvPrefix(agent, os) {
8
- const vars = agent.encryptedEnvVars;
9
- if (!vars || Object.keys(vars).length === 0)
10
- return '';
11
- const parts = [];
12
- for (const [name, encrypted] of Object.entries(vars)) {
13
- const value = decryptPassword(encrypted);
14
- if (os === 'windows') {
15
- // PowerShell: single-quote escaping (matching windows.ts envPrefix pattern)
16
- const escaped = value.replace(/'/g, "''");
17
- parts.push(`$env:${name}='${escaped}'`);
18
- }
19
- else {
20
- // Linux/macOS: double-quote escaping
21
- const escaped = escapeDoubleQuoted(value);
22
- parts.push(`export ${name}="${escaped}"`);
23
- }
17
+ const ENV_NAME_RE = /^[A-Za-z_][A-Za-z0-9_]*$/;
18
+ /** Decrypted stored auth env vars for the member ({} when none). */
19
+ export function decryptAuthEnvVars(agent) {
20
+ const out = {};
21
+ for (const [name, encrypted] of Object.entries(agent.encryptedEnvVars ?? {})) {
22
+ if (!ENV_NAME_RE.test(name))
23
+ throw new Error(`Invalid stored env var name: ${name}`);
24
+ out[name] = decryptPassword(encrypted);
24
25
  }
25
- if (os === 'windows') {
26
- return parts.join('; ') + '; ';
26
+ return out;
27
+ }
28
+ /**
29
+ * File content for the member's shell.
30
+ * - POSIX: `export NAME='value'` lines (single-quoted: fully literal, safe for
31
+ * any byte including newlines), loaded with `.`.
32
+ * - PowerShell: `NAME=<base64(utf8 value)>` lines, parsed (never executed --
33
+ * no execution-policy or quoting exposure).
34
+ */
35
+ export function buildAuthEnvFileContent(vars, posix) {
36
+ const lines = Object.entries(vars).map(([name, value]) => {
37
+ if (!ENV_NAME_RE.test(name))
38
+ throw new Error(`Invalid env var name: ${name}`);
39
+ return posix
40
+ ? `export ${name}=${escapeShellArg(value)}`
41
+ : `${name}=${Buffer.from(value, 'utf-8').toString('base64')}`;
42
+ });
43
+ return lines.join('\n') + '\n';
44
+ }
45
+ /**
46
+ * Command prefix that loads the staged file into the current shell's
47
+ * environment and deletes it. Carries only the file path, never a value.
48
+ * POSIX: a missing/unreadable file short-circuits the `&&` chain (no
49
+ * unauthenticated run). PowerShell: fails loudly with exit 1.
50
+ */
51
+ export function buildAuthEnvSourcePrefix(filePath, posix) {
52
+ if (posix) {
53
+ const q = escapeShellArg(filePath);
54
+ return `. ${q} && rm -f ${q} && `;
27
55
  }
28
- return parts.join(' && ') + ' && ';
56
+ const q = escapePowerShellArg(filePath);
57
+ return `$__fleetEnv = ${q}; try { foreach ($__l in [IO.File]::ReadAllLines($__fleetEnv)) { $__i = $__l.IndexOf('='); if ($__i -gt 0) { [Environment]::SetEnvironmentVariable($__l.Substring(0, $__i), [Text.Encoding]::UTF8.GetString([Convert]::FromBase64String($__l.Substring($__i + 1))), 'Process') } } } catch { [Console]::Error.WriteLine('apra-fleet: could not load the member credential file'); exit 1 } finally { Remove-Item -LiteralPath $__fleetEnv -Force -ErrorAction SilentlyContinue }; `;
29
58
  }
30
59
  //# sourceMappingURL=auth-env.js.map
@@ -0,0 +1,37 @@
1
+ export interface FindOnPathOptions {
2
+ /** PATH string to search (default: process.env.PATH). */
3
+ envPath?: string;
4
+ /** Platform whose PATH rules apply (default: process.platform). */
5
+ platform?: NodeJS.Platform;
6
+ /** PATHEXT for win32 (default: process.env.PATHEXT). */
7
+ pathExt?: string;
8
+ /** File-existence check (default: statSync(...).isFile()). Injected by tests. */
9
+ isFile?: (p: string) => boolean;
10
+ }
11
+ /**
12
+ * Split a PATH string with the target platform's delimiter, dropping empty
13
+ * entries. On win32 an entry may be wrapped in double quotes (to carry a `;`
14
+ * or spaces); those are stripped, since a quoted dir is not a valid path.
15
+ */
16
+ export declare function splitPath(envPath: string, platform?: NodeJS.Platform): string[];
17
+ /** Resolve an executable on PATH (PATHEXT-aware on Windows) without a shell. */
18
+ export declare function findExecutableOnPath(name: string, opts?: FindOnPathOptions): string | null;
19
+ /**
20
+ * Actionable text for "npx (or the node it runs under) is not on this
21
+ * server's PATH". A service-managed server gets the PATH recorded in its
22
+ * service definition at install time, so re-running install refreshes it.
23
+ */
24
+ export declare function missingOnServerPathMessage(name: string, envPath?: string): string;
25
+ /**
26
+ * Null when npx (and, off Windows, the node its `#!/usr/bin/env node` shebang
27
+ * needs) resolve on PATH; otherwise the actionable missing-on-PATH message.
28
+ */
29
+ export declare function npxUnavailableReason(opts?: FindOnPathOptions): string | null;
30
+ /**
31
+ * The install-time warning line when node and/or npx cannot be resolved from
32
+ * the installer's PATH (the PATH a service definition records), naming each
33
+ * missing tool; null when both resolve. Code intelligence runs through npx, so
34
+ * without them it stays unavailable until fixed.
35
+ */
36
+ export declare function codeIntelPathWarning(opts?: FindOnPathOptions): string | null;
37
+ //# sourceMappingURL=find-on-path.d.ts.map
@@ -0,0 +1,85 @@
1
+ import { statSync } from 'node:fs';
2
+ import path from 'node:path';
3
+ /**
4
+ * A regular file; off Windows it must also carry an execute bit, so a plain
5
+ * (non-executable) file named node/npx is skipped the way the shell would.
6
+ */
7
+ function defaultIsFile(p) {
8
+ try {
9
+ const st = statSync(p);
10
+ if (!st.isFile())
11
+ return false;
12
+ return process.platform === 'win32' || (st.mode & 0o111) !== 0;
13
+ }
14
+ catch {
15
+ return false;
16
+ }
17
+ }
18
+ /**
19
+ * Split a PATH string with the target platform's delimiter, dropping empty
20
+ * entries. On win32 an entry may be wrapped in double quotes (to carry a `;`
21
+ * or spaces); those are stripped, since a quoted dir is not a valid path.
22
+ */
23
+ export function splitPath(envPath, platform = process.platform) {
24
+ const parts = envPath.split(platform === 'win32' ? ';' : ':');
25
+ return (platform === 'win32' ? parts.map((d) => d.trim().replace(/^"(.*)"$/, '$1')) : parts).filter(Boolean);
26
+ }
27
+ /** Resolve an executable on PATH (PATHEXT-aware on Windows) without a shell. */
28
+ export function findExecutableOnPath(name, opts = {}) {
29
+ const platform = opts.platform ?? process.platform;
30
+ const envPath = opts.envPath ?? process.env.PATH ?? '';
31
+ const isFile = opts.isFile ?? defaultIsFile;
32
+ const join = platform === 'win32' ? path.win32.join : path.posix.join;
33
+ const exts = platform === 'win32'
34
+ ? ['', ...(opts.pathExt ?? process.env.PATHEXT ?? '.COM;.EXE;.BAT;.CMD').split(';').filter(Boolean)]
35
+ : [''];
36
+ for (const dir of splitPath(envPath, platform)) {
37
+ for (const ext of exts) {
38
+ const candidate = join(dir, name + ext);
39
+ if (isFile(candidate))
40
+ return candidate;
41
+ }
42
+ }
43
+ return null;
44
+ }
45
+ /**
46
+ * Actionable text for "npx (or the node it runs under) is not on this
47
+ * server's PATH". A service-managed server gets the PATH recorded in its
48
+ * service definition at install time, so re-running install refreshes it.
49
+ */
50
+ export function missingOnServerPathMessage(name, envPath = process.env.PATH ?? '') {
51
+ return `${name} was not found on the apra-fleet server's PATH (searched: ${envPath || '<empty>'}). ` +
52
+ `Install Node.js (which provides node and npx), then re-run 'apra-fleet install' to refresh the service PATH ` +
53
+ `and restart the server.`;
54
+ }
55
+ /**
56
+ * Null when npx (and, off Windows, the node its `#!/usr/bin/env node` shebang
57
+ * needs) resolve on PATH; otherwise the actionable missing-on-PATH message.
58
+ */
59
+ export function npxUnavailableReason(opts = {}) {
60
+ const platform = opts.platform ?? process.platform;
61
+ const envPath = opts.envPath ?? process.env.PATH ?? '';
62
+ const o = { ...opts, platform, envPath };
63
+ if (!findExecutableOnPath('npx', o))
64
+ return missingOnServerPathMessage('npx', envPath);
65
+ if (platform !== 'win32' && !findExecutableOnPath('node', o))
66
+ return missingOnServerPathMessage('node (required by npx)', envPath);
67
+ return null;
68
+ }
69
+ /**
70
+ * The install-time warning line when node and/or npx cannot be resolved from
71
+ * the installer's PATH (the PATH a service definition records), naming each
72
+ * missing tool; null when both resolve. Code intelligence runs through npx, so
73
+ * without them it stays unavailable until fixed.
74
+ */
75
+ export function codeIntelPathWarning(opts = {}) {
76
+ const platform = opts.platform ?? process.platform;
77
+ const envPath = opts.envPath ?? process.env.PATH ?? '';
78
+ const o = { ...opts, platform, envPath };
79
+ const missing = ['node', 'npx'].filter((name) => !findExecutableOnPath(name, o));
80
+ if (missing.length === 0)
81
+ return null;
82
+ return `${missing.join(' and ')} ${missing.length > 1 ? 'are' : 'is'} not resolvable from the installer PATH: code intelligence will be unavailable until it is fixed. ` +
83
+ `Install Node.js (which provides node and npx) or add it to PATH, then re-run 'apra-fleet install'.`;
84
+ }
85
+ //# sourceMappingURL=find-on-path.js.map
@@ -1,5 +1,29 @@
1
+ import { type OwnerOnlyDeps } from './owner-only-fs.js';
1
2
  /** Returns the resolved path of the active log file, or null if logging is unavailable. */
2
3
  export declare function getActiveLogFile(): string | null;
4
+ /**
5
+ * Open this process's log (<data dir>/logs/fleet-<pid>.log) owner-only, and
6
+ * tighten the data dir, the logs dir and the service log (<data dir>/fleet.log,
7
+ * written by `apra-fleet start` and the OS service manager) to the owner too.
8
+ * Server logs carry member ids, paths and session handles, so they must not be
9
+ * group/world-readable: POSIX dirs 0700 and files 0600 (pre-existing ones are
10
+ * chmod-tightened); Windows strips inherited ACEs and grants only the current
11
+ * user (see owner-only-fs.ts). Returns the open fd and every tightening
12
+ * failure (never fatal: logging must keep working).
13
+ */
14
+ export declare function openOwnerOnlyLog(dataDir: string, pid: number, deps?: OwnerOnlyDeps): {
15
+ fd: number;
16
+ logFile: string;
17
+ problems: string[];
18
+ };
19
+ /** Close the log fd (the next write reopens it). Used by tests that rotate data dirs. */
20
+ export declare function closeLogFile(): void;
21
+ /**
22
+ * Append one raw JSON record (ts + level are prepended) to the server log,
23
+ * synchronously and WITHOUT the stderr mirror. For records that must land
24
+ * even when stderr is blocked or the process is about to exit.
25
+ */
26
+ export declare function appendLogRecord(level: 'info' | 'warn' | 'error', record: Record<string, unknown>): void;
3
27
  type LogAgent = {
4
28
  id: string;
5
29
  friendlyName: string;
@@ -7,6 +31,13 @@ type LogAgent = {
7
31
  export declare function logLine(tag: string, msg: string, agent?: LogAgent, inv?: string): void;
8
32
  export declare function logWarn(tag: string, msg: string, agent?: LogAgent): void;
9
33
  export declare function logError(tag: string, msg: string, agent?: LogAgent): void;
34
+ /**
35
+ * Per-invocation correlation id: 5 lowercase base36 chars. CSPRNG, not
36
+ * Math.random -- besides tagging log lines and the prompt instruction, the
37
+ * id names the durable output file a Linux member tees into under the
38
+ * shared /tmp (see durableOutputPath), so it must not be predictable.
39
+ */
40
+ export declare function newInvocationId(): string;
10
41
  export declare class LogScope {
11
42
  private readonly inv;
12
43
  private readonly start;
@@ -24,6 +55,12 @@ export declare class LogScope {
24
55
  private _exit;
25
56
  }
26
57
  export declare function maskSecrets(text: string): string;
58
+ /**
59
+ * Log form of an MCP session id: its first 8 characters. A session id is a
60
+ * bearer-like handle (a full id addresses the session), so log lines carry
61
+ * only this non-reversible prefix -- enough to correlate lines of one session.
62
+ */
63
+ export declare function shortSid(sid: string | null | undefined): string;
27
64
  export declare function truncateForLog(text: string, maxLen?: number): string;
28
65
  export {};
29
66
  //# sourceMappingURL=log-helpers.d.ts.map
@@ -1,27 +1,92 @@
1
1
  import fs from 'node:fs';
2
2
  import path from 'node:path';
3
- import { FLEET_DIR } from '../paths.js';
4
- let _stream = null;
3
+ import { randomInt } from 'node:crypto';
4
+ import { FLEET_DIR, LOG_FILE_PATH } from '../paths.js';
5
+ import { redactSecretTokens } from '../services/secret-token.js';
6
+ import { ensureOwnerOnlyDir, openOwnerOnlyAppend, restrictToOwner } from './owner-only-fs.js';
7
+ // The server log is written SYNCHRONOUSLY (append-mode fd + fs.writeSync), and
8
+ // before the stderr mirror (GitHub #562): a console in QuickEdit selection or
9
+ // an undrained stderr pipe blocks console.error forever, and an async
10
+ // WriteStream only flushes from the (now blocked) event loop -- the result was
11
+ // a frozen server with zero lines in fleet-<pid>.log. A sync append also makes
12
+ // a line written just before process.exit durable (shutdown records).
13
+ let _fd = null;
5
14
  let _activeLogFile = null;
6
15
  /** Returns the resolved path of the active log file, or null if logging is unavailable. */
7
16
  export function getActiveLogFile() {
8
- getStream(); // ensure initialised
17
+ getFd(); // ensure initialised
9
18
  return _activeLogFile;
10
19
  }
11
- function getStream() {
12
- if (_stream)
13
- return _stream;
20
+ /**
21
+ * Open this process's log (<data dir>/logs/fleet-<pid>.log) owner-only, and
22
+ * tighten the data dir, the logs dir and the service log (<data dir>/fleet.log,
23
+ * written by `apra-fleet start` and the OS service manager) to the owner too.
24
+ * Server logs carry member ids, paths and session handles, so they must not be
25
+ * group/world-readable: POSIX dirs 0700 and files 0600 (pre-existing ones are
26
+ * chmod-tightened); Windows strips inherited ACEs and grants only the current
27
+ * user (see owner-only-fs.ts). Returns the open fd and every tightening
28
+ * failure (never fatal: logging must keep working).
29
+ */
30
+ export function openOwnerOnlyLog(dataDir, pid, deps = {}) {
31
+ const logsDir = path.join(dataDir, 'logs');
32
+ const problems = [...ensureOwnerOnlyDir(dataDir, deps), ...ensureOwnerOnlyDir(logsDir, deps)];
33
+ const logFile = path.join(logsDir, `fleet-${pid}.log`);
34
+ const fd = openOwnerOnlyAppend(logFile, problems, deps);
35
+ const serviceLog = path.join(dataDir, path.basename(LOG_FILE_PATH));
36
+ if (fs.existsSync(serviceLog)) {
37
+ const why = restrictToOwner(serviceLog, 'file', deps);
38
+ if (why)
39
+ problems.push(why);
40
+ }
41
+ return { fd, logFile, problems };
42
+ }
43
+ function getFd() {
44
+ if (_fd !== null)
45
+ return _fd;
14
46
  try {
15
- const logsDir = path.join(FLEET_DIR, 'logs');
16
- fs.mkdirSync(logsDir, { recursive: true });
17
- const logFile = path.join(logsDir, `fleet-${process.pid}.log`);
18
- _stream = fs.createWriteStream(logFile, { flags: 'a' });
47
+ const { fd, logFile, problems } = openOwnerOnlyLog(FLEET_DIR, process.pid);
48
+ _fd = fd;
19
49
  _activeLogFile = logFile;
50
+ for (const why of problems) {
51
+ appendLogRecord('warn', { tag: 'log', msg: `log permissions: ${why}` });
52
+ try {
53
+ console.error(`[fleet:warn] log log permissions: ${why}`);
54
+ }
55
+ catch { /* ignore */ }
56
+ }
20
57
  }
21
58
  catch {
22
59
  // data dir not available
23
60
  }
24
- return _stream;
61
+ return _fd;
62
+ }
63
+ /** Close the log fd (the next write reopens it). Used by tests that rotate data dirs. */
64
+ export function closeLogFile() {
65
+ if (_fd !== null) {
66
+ try {
67
+ fs.closeSync(_fd);
68
+ }
69
+ catch { /* ignore */ }
70
+ }
71
+ _fd = null;
72
+ _activeLogFile = null;
73
+ }
74
+ function appendLine(text) {
75
+ try {
76
+ const fd = getFd();
77
+ if (fd === null)
78
+ return;
79
+ fs.writeSync(fd, text);
80
+ }
81
+ catch { /* ignore */ }
82
+ }
83
+ /**
84
+ * Append one raw JSON record (ts + level are prepended) to the server log,
85
+ * synchronously and WITHOUT the stderr mirror. For records that must land
86
+ * even when stderr is blocked or the process is about to exit.
87
+ */
88
+ export function appendLogRecord(level, record) {
89
+ appendLine(JSON.stringify({ ts: localISOString(), level, ...record }) + '\n');
25
90
  }
26
91
  function localISOString() {
27
92
  const now = new Date();
@@ -35,9 +100,6 @@ function localISOString() {
35
100
  }
36
101
  function writeLog(level, tag, maskedMsg, agent, inv) {
37
102
  try {
38
- const stream = getStream();
39
- if (!stream)
40
- return;
41
103
  const line = { ts: localISOString(), level, tag };
42
104
  if (inv !== undefined)
43
105
  line.inv = inv;
@@ -47,46 +109,61 @@ function writeLog(level, tag, maskedMsg, agent, inv) {
47
109
  line.mem = agent.friendlyName;
48
110
  }
49
111
  line.msg = maskedMsg;
50
- stream.write(JSON.stringify(line) + '\n');
112
+ appendLine(JSON.stringify(line) + '\n');
51
113
  }
52
114
  catch { /* ignore */ }
53
115
  }
116
+ // Every emitter writes the file line FIRST, then mirrors to stderr (which may block).
54
117
  export function logLine(tag, msg, agent, inv) {
55
118
  const maskedMsg = maskSecrets(msg);
119
+ writeLog('info', tag, maskedMsg, agent, inv);
56
120
  try {
57
121
  console.error(`[fleet] ${tag} ${maskedMsg}`);
58
122
  }
59
123
  catch { /* ignore */ }
60
- writeLog('info', tag, maskedMsg, agent, inv);
61
124
  }
62
125
  export function logWarn(tag, msg, agent) {
63
126
  const maskedMsg = maskSecrets(msg);
127
+ writeLog('warn', tag, maskedMsg, agent);
64
128
  try {
65
129
  console.error(`[fleet:warn] ${tag} ${maskedMsg}`);
66
130
  }
67
131
  catch { /* ignore */ }
68
- writeLog('warn', tag, maskedMsg, agent);
69
132
  }
70
133
  export function logError(tag, msg, agent) {
71
134
  const maskedMsg = maskSecrets(msg);
135
+ writeLog('error', tag, maskedMsg, agent);
72
136
  try {
73
137
  console.error(`[fleet:error] ${tag} ${maskedMsg}`);
74
138
  }
75
139
  catch { /* ignore */ }
76
- writeLog('error', tag, maskedMsg, agent);
77
140
  }
78
141
  const LEVEL_PREFIX = {
79
142
  info: '[fleet]',
80
143
  warn: '[fleet:warn]',
81
144
  error: '[fleet:error]',
82
145
  };
146
+ const INV_ALPHABET = '0123456789abcdefghijklmnopqrstuvwxyz';
147
+ const INV_LENGTH = 5;
148
+ /**
149
+ * Per-invocation correlation id: 5 lowercase base36 chars. CSPRNG, not
150
+ * Math.random -- besides tagging log lines and the prompt instruction, the
151
+ * id names the durable output file a Linux member tees into under the
152
+ * shared /tmp (see durableOutputPath), so it must not be predictable.
153
+ */
154
+ export function newInvocationId() {
155
+ let id = '';
156
+ for (let i = 0; i < INV_LENGTH; i++)
157
+ id += INV_ALPHABET[randomInt(INV_ALPHABET.length)];
158
+ return id;
159
+ }
83
160
  export class LogScope {
84
161
  inv;
85
162
  start;
86
163
  tag;
87
164
  agent;
88
165
  constructor(tag, entryMsg, agent) {
89
- this.inv = Math.random().toString(36).slice(2, 7);
166
+ this.inv = newInvocationId();
90
167
  this.start = Date.now();
91
168
  this.tag = tag;
92
169
  this.agent = agent;
@@ -101,11 +178,11 @@ export class LogScope {
101
178
  abort(msg) { this._exit('error', msg); }
102
179
  _emit(level, msg) {
103
180
  const masked = maskSecrets(msg);
181
+ writeLog(level, this.tag, masked, this.agent, this.inv);
104
182
  try {
105
183
  console.error(`${LEVEL_PREFIX[level]} ${this.tag} ${masked}`);
106
184
  }
107
185
  catch { /* ignore */ }
108
- writeLog(level, this.tag, masked, this.agent, this.inv);
109
186
  }
110
187
  _exit(level, msg) {
111
188
  this._emit(level, `${msg} elapsed=${Date.now() - this.start}ms`);
@@ -113,14 +190,23 @@ export class LogScope {
113
190
  }
114
191
  export function maskSecrets(text) {
115
192
  try {
116
- return text
117
- .replace(/\{\{secure\.[a-zA-Z0-9_-]{1,64}\}\}/g, '[REDACTED]')
193
+ return redactSecretTokens(text)
118
194
  .replace(/sec:\/\/[a-zA-Z0-9_]+/g, '[REDACTED]');
119
195
  }
120
196
  catch {
121
197
  return text;
122
198
  }
123
199
  }
200
+ /**
201
+ * Log form of an MCP session id: its first 8 characters. A session id is a
202
+ * bearer-like handle (a full id addresses the session), so log lines carry
203
+ * only this non-reversible prefix -- enough to correlate lines of one session.
204
+ */
205
+ export function shortSid(sid) {
206
+ if (!sid)
207
+ return 'none';
208
+ return sid.length <= 8 ? sid : `${sid.slice(0, 8)}...`;
209
+ }
124
210
  export function truncateForLog(text, maxLen = 80) {
125
211
  const single = text.replace(/[\n\t]/g, ' ');
126
212
  return single.length <= maxLen ? single : single.slice(0, maxLen) + '...';