@ouro.bot/cli 0.1.0-alpha.55 → 0.1.0-alpha.550

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 (386) hide show
  1. package/README.md +133 -19
  2. package/RepairGuide.ouro/agent.json +5 -0
  3. package/RepairGuide.ouro/psyche/IDENTITY.md +19 -0
  4. package/RepairGuide.ouro/psyche/SOUL.md +55 -0
  5. package/RepairGuide.ouro/skills/diagnose-bootstrap-drift.md +54 -0
  6. package/RepairGuide.ouro/skills/diagnose-broken-remote.md +63 -0
  7. package/RepairGuide.ouro/skills/diagnose-stacked-typed-issues.md +35 -0
  8. package/RepairGuide.ouro/skills/diagnose-sync-blocked.md +54 -0
  9. package/RepairGuide.ouro/skills/diagnose-vault-expired.md +60 -0
  10. package/{AdoptionSpecialist.ouro → SerpentGuide.ouro}/agent.json +4 -2
  11. package/{AdoptionSpecialist.ouro → SerpentGuide.ouro}/psyche/SOUL.md +2 -2
  12. package/{AdoptionSpecialist.ouro → SerpentGuide.ouro}/psyche/identities/the-serpent.md +1 -1
  13. package/changelog.json +3555 -0
  14. package/dist/arc/attention-types.js +8 -0
  15. package/dist/arc/cares.js +140 -0
  16. package/dist/arc/episodes.js +117 -0
  17. package/dist/arc/intentions.js +133 -0
  18. package/dist/arc/json-store.js +117 -0
  19. package/dist/arc/obligations.js +237 -0
  20. package/dist/arc/packets.js +193 -0
  21. package/dist/arc/presence.js +185 -0
  22. package/dist/arc/task-lifecycle.js +65 -0
  23. package/dist/heart/active-work.js +837 -26
  24. package/dist/heart/agent-entry.js +58 -3
  25. package/dist/heart/attachments/image-normalize.js +194 -0
  26. package/dist/heart/attachments/materialize.js +97 -0
  27. package/dist/heart/attachments/originals.js +88 -0
  28. package/dist/heart/attachments/render.js +29 -0
  29. package/dist/heart/attachments/sources/adapter.js +2 -0
  30. package/dist/heart/attachments/sources/bluebubbles.js +156 -0
  31. package/dist/heart/attachments/sources/cli-local-file.js +78 -0
  32. package/dist/heart/attachments/sources/index.js +16 -0
  33. package/dist/heart/attachments/store.js +103 -0
  34. package/dist/heart/attachments/types.js +93 -0
  35. package/dist/heart/auth/auth-flow.js +479 -0
  36. package/dist/heart/background-operations.js +281 -0
  37. package/dist/heart/bundle-state.js +168 -0
  38. package/dist/heart/commitments.js +111 -0
  39. package/dist/heart/config-registry.js +304 -0
  40. package/dist/heart/config.js +114 -118
  41. package/dist/heart/core.js +925 -246
  42. package/dist/heart/cross-chat-delivery.js +3 -18
  43. package/dist/heart/daemon/agent-config-check.js +512 -0
  44. package/dist/heart/daemon/agent-discovery.js +102 -3
  45. package/dist/heart/daemon/agent-service.js +522 -0
  46. package/dist/heart/daemon/agentic-repair.js +554 -0
  47. package/dist/heart/daemon/bluebubbles-health-diagnostics.js +122 -0
  48. package/dist/heart/daemon/boot-sync-probe.js +197 -0
  49. package/dist/heart/daemon/cadence.js +70 -0
  50. package/dist/heart/daemon/cli-defaults.js +665 -0
  51. package/dist/heart/daemon/cli-exec.js +7565 -0
  52. package/dist/heart/daemon/cli-help.js +498 -0
  53. package/dist/heart/daemon/cli-parse.js +1590 -0
  54. package/dist/heart/daemon/cli-render-doctor.js +57 -0
  55. package/dist/heart/daemon/cli-render.js +775 -0
  56. package/dist/heart/daemon/cli-types.js +8 -0
  57. package/dist/heart/daemon/connect-bay.js +323 -0
  58. package/dist/heart/daemon/daemon-cli.js +29 -1672
  59. package/dist/heart/daemon/daemon-entry.js +417 -2
  60. package/dist/heart/daemon/daemon-health.js +183 -0
  61. package/dist/heart/daemon/daemon-rollup.js +58 -0
  62. package/dist/heart/daemon/daemon-runtime-sync.js +87 -13
  63. package/dist/heart/daemon/daemon-tombstone.js +236 -0
  64. package/dist/heart/daemon/daemon.js +758 -71
  65. package/dist/heart/daemon/dns-workflow.js +394 -0
  66. package/dist/heart/daemon/doctor-types.js +8 -0
  67. package/dist/heart/daemon/doctor.js +844 -0
  68. package/dist/heart/daemon/drift-detection.js +146 -0
  69. package/dist/heart/daemon/health-monitor.js +122 -1
  70. package/dist/heart/daemon/hooks/agent-config-v2.js +33 -0
  71. package/dist/heart/daemon/hooks/bundle-meta.js +115 -1
  72. package/dist/heart/daemon/http-health-probe.js +80 -0
  73. package/dist/heart/daemon/human-command-screens.js +234 -0
  74. package/dist/heart/daemon/human-readiness.js +114 -0
  75. package/dist/heart/daemon/inner-status.js +102 -0
  76. package/dist/heart/daemon/interactive-repair.js +394 -0
  77. package/dist/heart/daemon/launchd.js +37 -8
  78. package/dist/heart/daemon/log-tailer.js +82 -12
  79. package/dist/heart/daemon/logs-prune.js +110 -0
  80. package/dist/heart/daemon/mcp-canary.js +297 -0
  81. package/dist/heart/daemon/message-router.js +2 -2
  82. package/dist/heart/daemon/os-cron-deps.js +135 -0
  83. package/dist/heart/daemon/os-cron.js +14 -12
  84. package/dist/heart/daemon/ouro-bot-entry.js +4 -2
  85. package/dist/heart/daemon/ouro-entry.js +3 -1
  86. package/dist/heart/daemon/process-manager.js +375 -33
  87. package/dist/heart/daemon/provider-discovery.js +137 -0
  88. package/dist/heart/daemon/provider-ping-progress.js +83 -0
  89. package/dist/heart/daemon/pulse.js +475 -0
  90. package/dist/heart/daemon/readiness-repair.js +365 -0
  91. package/dist/heart/daemon/run-hooks.js +2 -0
  92. package/dist/heart/daemon/runtime-logging.js +67 -16
  93. package/dist/heart/daemon/runtime-metadata.js +3 -31
  94. package/dist/heart/daemon/safe-mode.js +161 -0
  95. package/dist/heart/daemon/sense-manager.js +353 -38
  96. package/dist/heart/daemon/session-id-resolver.js +131 -0
  97. package/dist/heart/daemon/skill-management-installer.js +94 -0
  98. package/dist/heart/daemon/socket-client.js +158 -11
  99. package/dist/heart/daemon/stale-bundle-prune.js +96 -0
  100. package/dist/heart/daemon/startup-tui.js +330 -0
  101. package/dist/heart/daemon/task-scheduler.js +3 -25
  102. package/dist/heart/daemon/terminal-ui.js +499 -0
  103. package/dist/heart/daemon/thoughts.js +162 -17
  104. package/dist/heart/daemon/up-progress.js +366 -0
  105. package/dist/heart/daemon/vault-items.js +56 -0
  106. package/dist/heart/delegation.js +1 -1
  107. package/dist/heart/habits/habit-migration.js +189 -0
  108. package/dist/heart/habits/habit-parser.js +140 -0
  109. package/dist/heart/habits/habit-runtime-state.js +100 -0
  110. package/dist/heart/habits/habit-scheduler.js +372 -0
  111. package/dist/heart/{daemon → hatch}/hatch-flow.js +52 -117
  112. package/dist/heart/{daemon → hatch}/hatch-specialist.js +6 -8
  113. package/dist/heart/{daemon → hatch}/specialist-prompt.js +12 -9
  114. package/dist/heart/{daemon → hatch}/specialist-tools.js +35 -12
  115. package/dist/heart/identity.js +200 -51
  116. package/dist/heart/kept-notes.js +357 -0
  117. package/dist/heart/kicks.js +1 -1
  118. package/dist/heart/machine-identity.js +161 -0
  119. package/dist/heart/mail-import-discovery.js +353 -0
  120. package/dist/heart/mailbox/mailbox-http-hooks.js +66 -0
  121. package/dist/heart/mailbox/mailbox-http-response.js +7 -0
  122. package/dist/heart/mailbox/mailbox-http-routes.js +246 -0
  123. package/dist/heart/mailbox/mailbox-http-static.js +103 -0
  124. package/dist/heart/mailbox/mailbox-http-transport.js +116 -0
  125. package/dist/heart/mailbox/mailbox-http.js +99 -0
  126. package/dist/heart/mailbox/mailbox-read.js +31 -0
  127. package/dist/heart/mailbox/mailbox-types.js +27 -0
  128. package/dist/heart/mailbox/mailbox-view.js +195 -0
  129. package/dist/heart/mailbox/readers/agent-machine.js +382 -0
  130. package/dist/heart/mailbox/readers/continuity-readers.js +338 -0
  131. package/dist/heart/mailbox/readers/mail.js +362 -0
  132. package/dist/heart/mailbox/readers/runtime-readers.js +651 -0
  133. package/dist/heart/mailbox/readers/sessions.js +232 -0
  134. package/dist/heart/mailbox/readers/shared.js +111 -0
  135. package/dist/heart/mcp/mcp-server.js +683 -0
  136. package/dist/heart/migrate-config.js +100 -0
  137. package/dist/heart/model-capabilities.js +19 -0
  138. package/dist/heart/platform.js +81 -0
  139. package/dist/heart/provider-attempt.js +134 -0
  140. package/dist/heart/provider-binding-resolver.js +255 -0
  141. package/dist/heart/provider-credentials.js +425 -0
  142. package/dist/heart/provider-failover.js +301 -0
  143. package/dist/heart/provider-models.js +81 -0
  144. package/dist/heart/provider-ping.js +262 -0
  145. package/dist/heart/provider-state.js +216 -0
  146. package/dist/heart/provider-visibility.js +188 -0
  147. package/dist/heart/providers/anthropic-token.js +131 -0
  148. package/dist/heart/providers/anthropic.js +139 -52
  149. package/dist/heart/providers/azure.js +97 -13
  150. package/dist/heart/providers/error-classification.js +127 -0
  151. package/dist/heart/providers/github-copilot.js +145 -0
  152. package/dist/heart/providers/minimax-vlm.js +189 -0
  153. package/dist/heart/providers/minimax.js +26 -8
  154. package/dist/heart/providers/openai-codex.js +55 -40
  155. package/dist/heart/runtime-capability-check.js +170 -0
  156. package/dist/heart/runtime-credentials.js +367 -0
  157. package/dist/heart/runtime-cwd.js +87 -0
  158. package/dist/heart/sense-truth.js +11 -4
  159. package/dist/heart/session-activity.js +43 -22
  160. package/dist/heart/session-events.js +1149 -0
  161. package/dist/heart/session-playback-cli-main.js +5 -0
  162. package/dist/heart/session-playback-cli.js +36 -0
  163. package/dist/heart/session-playback.js +231 -0
  164. package/dist/heart/session-stats-cli-main.js +5 -0
  165. package/dist/heart/session-stats.js +182 -0
  166. package/dist/heart/session-transcript.js +243 -0
  167. package/dist/heart/start-of-turn-packet.js +345 -0
  168. package/dist/heart/streaming.js +44 -27
  169. package/dist/heart/sync-classification.js +176 -0
  170. package/dist/heart/sync.js +449 -0
  171. package/dist/heart/target-resolution.js +9 -5
  172. package/dist/heart/tempo.js +93 -0
  173. package/dist/heart/temporal-view.js +41 -0
  174. package/dist/heart/timeouts.js +101 -0
  175. package/dist/heart/tool-activity-callbacks.js +59 -0
  176. package/dist/heart/tool-description.js +139 -0
  177. package/dist/heart/tool-friction.js +55 -0
  178. package/dist/heart/tool-loop.js +200 -0
  179. package/dist/heart/turn-context.js +381 -0
  180. package/dist/heart/{daemon → versioning}/ouro-bot-global-installer.js +6 -5
  181. package/dist/heart/{daemon → versioning}/ouro-bot-wrapper.js +1 -1
  182. package/dist/heart/versioning/ouro-path-installer.js +426 -0
  183. package/dist/heart/versioning/ouro-version-manager.js +295 -0
  184. package/dist/heart/{daemon → versioning}/staged-restart.js +40 -8
  185. package/dist/heart/{daemon → versioning}/update-checker.js +6 -1
  186. package/dist/heart/{daemon → versioning}/update-hooks.js +63 -59
  187. package/dist/mailbox-ui/assets/index-BPr5vNuM.css +1 -0
  188. package/dist/mailbox-ui/assets/index-Cm51CY9W.js +61 -0
  189. package/dist/mailbox-ui/index.html +15 -0
  190. package/dist/mailroom/attention.js +167 -0
  191. package/dist/mailroom/autonomy.js +209 -0
  192. package/dist/mailroom/blob-store.js +674 -0
  193. package/dist/mailroom/body-cache.js +61 -0
  194. package/dist/mailroom/core.js +720 -0
  195. package/dist/mailroom/entry.js +160 -0
  196. package/dist/mailroom/file-store.js +430 -0
  197. package/dist/mailroom/mbox-import.js +383 -0
  198. package/dist/mailroom/outbound.js +380 -0
  199. package/dist/mailroom/policy.js +263 -0
  200. package/dist/mailroom/reader.js +233 -0
  201. package/dist/mailroom/search-cache.js +256 -0
  202. package/dist/mailroom/search-relevance.js +319 -0
  203. package/dist/mailroom/smtp-ingress.js +176 -0
  204. package/dist/mailroom/source-state.js +176 -0
  205. package/dist/mailroom/thread.js +109 -0
  206. package/dist/mailroom/travel-extract.js +89 -0
  207. package/dist/mind/bundle-manifest.js +7 -1
  208. package/dist/mind/context.js +165 -101
  209. package/dist/mind/diary-integrity.js +60 -0
  210. package/dist/mind/{memory.js → diary.js} +62 -75
  211. package/dist/mind/embedding-provider.js +60 -0
  212. package/dist/mind/file-state.js +179 -0
  213. package/dist/mind/friends/channel.js +30 -0
  214. package/dist/mind/friends/resolver.js +54 -2
  215. package/dist/mind/friends/store-file.js +39 -3
  216. package/dist/mind/friends/types.js +2 -2
  217. package/dist/mind/journal-index.js +161 -0
  218. package/dist/mind/note-search.js +268 -0
  219. package/dist/mind/obligation-steering.js +221 -0
  220. package/dist/mind/pending.js +4 -0
  221. package/dist/mind/prompt-refresh.js +3 -2
  222. package/dist/mind/prompt.js +995 -123
  223. package/dist/mind/provenance-trust.js +26 -0
  224. package/dist/mind/scrutiny.js +173 -0
  225. package/dist/nerves/cli-logging.js +7 -1
  226. package/dist/nerves/coverage/audit-rules.js +15 -6
  227. package/dist/nerves/coverage/audit.js +28 -2
  228. package/dist/nerves/coverage/cli.js +1 -1
  229. package/dist/nerves/coverage/contract.js +5 -5
  230. package/dist/nerves/coverage/file-completeness.js +139 -5
  231. package/dist/nerves/coverage/run-artifacts.js +1 -1
  232. package/dist/nerves/event-buffer.js +111 -0
  233. package/dist/nerves/index.js +224 -4
  234. package/dist/nerves/observation.js +20 -0
  235. package/dist/nerves/redact.js +79 -0
  236. package/dist/nerves/review/cli-main.js +5 -0
  237. package/dist/nerves/review/cli.js +156 -0
  238. package/dist/nerves/review/core.js +152 -0
  239. package/dist/nerves/runtime.js +5 -1
  240. package/dist/repertoire/ado-client.js +15 -56
  241. package/dist/repertoire/ado-semantic.js +11 -10
  242. package/dist/repertoire/api-client.js +97 -0
  243. package/dist/repertoire/bitwarden-store.js +816 -0
  244. package/dist/repertoire/bundle-templates.js +72 -0
  245. package/dist/repertoire/bw-installer.js +180 -0
  246. package/dist/repertoire/coding/codex-jsonl.js +64 -0
  247. package/dist/repertoire/coding/context-pack.js +330 -0
  248. package/dist/repertoire/coding/feedback.js +197 -30
  249. package/dist/repertoire/coding/manager.js +158 -9
  250. package/dist/repertoire/coding/spawner.js +55 -9
  251. package/dist/repertoire/coding/tools.js +170 -7
  252. package/dist/repertoire/commerce-errors.js +109 -0
  253. package/dist/repertoire/commerce-self-test.js +156 -0
  254. package/dist/repertoire/credential-access.js +111 -0
  255. package/dist/repertoire/duffel-client.js +185 -0
  256. package/dist/repertoire/github-client.js +14 -55
  257. package/dist/repertoire/graph-client.js +11 -52
  258. package/dist/repertoire/guardrails.js +396 -0
  259. package/dist/repertoire/mcp-client.js +295 -0
  260. package/dist/repertoire/mcp-manager.js +362 -0
  261. package/dist/repertoire/mcp-tools.js +63 -0
  262. package/dist/repertoire/shell-sessions.js +133 -0
  263. package/dist/repertoire/skills.js +15 -24
  264. package/dist/repertoire/stripe-client.js +131 -0
  265. package/dist/repertoire/tasks/board.js +31 -5
  266. package/dist/repertoire/tasks/fix.js +182 -0
  267. package/dist/repertoire/tasks/index.js +16 -4
  268. package/dist/repertoire/tasks/lifecycle.js +2 -2
  269. package/dist/repertoire/tasks/parser.js +3 -2
  270. package/dist/repertoire/tasks/scanner.js +194 -37
  271. package/dist/repertoire/tasks/transitions.js +16 -78
  272. package/dist/repertoire/tool-results.js +29 -0
  273. package/dist/repertoire/tools-attachments.js +317 -0
  274. package/dist/repertoire/tools-base.js +47 -1075
  275. package/dist/repertoire/tools-bluebubbles.js +1 -0
  276. package/dist/repertoire/tools-bridge.js +142 -0
  277. package/dist/repertoire/tools-bundle.js +984 -0
  278. package/dist/repertoire/tools-config.js +185 -0
  279. package/dist/repertoire/tools-continuity.js +248 -0
  280. package/dist/repertoire/tools-credential.js +381 -0
  281. package/dist/repertoire/tools-files.js +342 -0
  282. package/dist/repertoire/tools-flight.js +224 -0
  283. package/dist/repertoire/tools-flow.js +119 -0
  284. package/dist/repertoire/tools-github.js +1 -7
  285. package/dist/repertoire/tools-mail.js +1857 -0
  286. package/dist/repertoire/tools-notes.js +421 -0
  287. package/dist/repertoire/tools-session.js +750 -0
  288. package/dist/repertoire/tools-shell.js +120 -0
  289. package/dist/repertoire/tools-stripe.js +180 -0
  290. package/dist/repertoire/tools-surface.js +243 -0
  291. package/dist/repertoire/tools-teams.js +9 -39
  292. package/dist/repertoire/tools-travel.js +125 -0
  293. package/dist/repertoire/tools-trip.js +604 -0
  294. package/dist/repertoire/tools-user-profile.js +144 -0
  295. package/dist/repertoire/tools-vault.js +40 -0
  296. package/dist/repertoire/tools.js +108 -100
  297. package/dist/repertoire/travel-api-client.js +360 -0
  298. package/dist/repertoire/user-profile.js +131 -0
  299. package/dist/repertoire/vault-setup.js +246 -0
  300. package/dist/repertoire/vault-unlock.js +561 -0
  301. package/dist/scripts/claude-code-hook.js +41 -0
  302. package/dist/scripts/claude-code-stop-hook.js +47 -0
  303. package/dist/senses/attention-queue.js +116 -0
  304. package/dist/senses/bluebubbles/active-turns.js +216 -0
  305. package/dist/senses/bluebubbles/attachment-cache.js +53 -0
  306. package/dist/senses/bluebubbles/attachment-download.js +137 -0
  307. package/dist/senses/{bluebubbles-client.js → bluebubbles/client.js} +219 -18
  308. package/dist/senses/bluebubbles/entry.js +77 -0
  309. package/dist/senses/{bluebubbles-inbound-log.js → bluebubbles/inbound-log.js} +20 -3
  310. package/dist/senses/bluebubbles/index.js +2305 -0
  311. package/dist/senses/{bluebubbles-media.js → bluebubbles/media.js} +121 -70
  312. package/dist/senses/{bluebubbles-model.js → bluebubbles/model.js} +33 -12
  313. package/dist/senses/{bluebubbles-mutation-log.js → bluebubbles/mutation-log.js} +3 -3
  314. package/dist/senses/bluebubbles/processed-log.js +133 -0
  315. package/dist/senses/bluebubbles/replay.js +137 -0
  316. package/dist/senses/{bluebubbles-runtime-state.js → bluebubbles/runtime-state.js} +30 -2
  317. package/dist/senses/{bluebubbles-session-cleanup.js → bluebubbles/session-cleanup.js} +1 -1
  318. package/dist/senses/cli/bracketed-paste.js +82 -0
  319. package/dist/senses/cli/image-paste.js +287 -0
  320. package/dist/senses/cli/image-ref-navigation.js +75 -0
  321. package/dist/senses/cli/ink-app.js +156 -0
  322. package/dist/senses/cli/inline-diff.js +64 -0
  323. package/dist/senses/cli/input-keys.js +174 -0
  324. package/dist/senses/cli/kill-ring.js +86 -0
  325. package/dist/senses/cli/message-list.js +51 -0
  326. package/dist/senses/cli/ouro-tui.js +607 -0
  327. package/dist/senses/cli/spinner-imperative.js +135 -0
  328. package/dist/senses/cli/spinner.js +101 -0
  329. package/dist/senses/cli/status-line.js +60 -0
  330. package/dist/senses/cli/streaming-markdown.js +526 -0
  331. package/dist/senses/cli/tool-display.js +85 -0
  332. package/dist/senses/cli/tool-render.js +85 -0
  333. package/dist/senses/cli/tui-store.js +240 -0
  334. package/dist/senses/cli/virtual-list.js +35 -0
  335. package/dist/senses/cli-entry.js +60 -8
  336. package/dist/senses/cli-layout.js +187 -0
  337. package/dist/senses/cli.js +520 -209
  338. package/dist/senses/commands.js +66 -3
  339. package/dist/senses/habit-turn-message.js +108 -0
  340. package/dist/senses/inner-dialog-worker.js +175 -21
  341. package/dist/senses/inner-dialog.js +330 -27
  342. package/dist/senses/mail-entry.js +66 -0
  343. package/dist/senses/mail.js +379 -0
  344. package/dist/senses/pipeline.js +569 -182
  345. package/dist/senses/proactive-content-guard.js +51 -0
  346. package/dist/senses/shared-turn.js +248 -0
  347. package/dist/senses/surface-tool.js +68 -0
  348. package/dist/senses/teams-entry.js +60 -8
  349. package/dist/senses/teams.js +387 -98
  350. package/dist/senses/trust-gate.js +100 -5
  351. package/dist/trips/core.js +138 -0
  352. package/dist/trips/store.js +146 -0
  353. package/package.json +38 -7
  354. package/skills/agent-commerce.md +106 -0
  355. package/skills/browser-navigation.md +117 -0
  356. package/skills/commerce-setup-guide.md +116 -0
  357. package/skills/commerce-setup.md +84 -0
  358. package/skills/configure-dev-tools.md +101 -0
  359. package/skills/travel-planning.md +138 -0
  360. package/dist/heart/daemon/ouro-path-installer.js +0 -178
  361. package/dist/heart/daemon/subagent-installer.js +0 -166
  362. package/dist/heart/session-recall.js +0 -116
  363. package/dist/mind/associative-recall.js +0 -209
  364. package/dist/senses/bluebubbles-entry.js +0 -13
  365. package/dist/senses/bluebubbles.js +0 -1177
  366. package/dist/senses/debug-activity.js +0 -148
  367. package/subagents/README.md +0 -86
  368. package/subagents/work-doer.md +0 -237
  369. package/subagents/work-merger.md +0 -618
  370. package/subagents/work-planner.md +0 -390
  371. /package/{AdoptionSpecialist.ouro → SerpentGuide.ouro}/psyche/identities/basilisk.md +0 -0
  372. /package/{AdoptionSpecialist.ouro → SerpentGuide.ouro}/psyche/identities/jafar.md +0 -0
  373. /package/{AdoptionSpecialist.ouro → SerpentGuide.ouro}/psyche/identities/jormungandr.md +0 -0
  374. /package/{AdoptionSpecialist.ouro → SerpentGuide.ouro}/psyche/identities/kaa.md +0 -0
  375. /package/{AdoptionSpecialist.ouro → SerpentGuide.ouro}/psyche/identities/medusa.md +0 -0
  376. /package/{AdoptionSpecialist.ouro → SerpentGuide.ouro}/psyche/identities/monty.md +0 -0
  377. /package/{AdoptionSpecialist.ouro → SerpentGuide.ouro}/psyche/identities/nagini.md +0 -0
  378. /package/{AdoptionSpecialist.ouro → SerpentGuide.ouro}/psyche/identities/ouroboros.md +0 -0
  379. /package/{AdoptionSpecialist.ouro → SerpentGuide.ouro}/psyche/identities/python.md +0 -0
  380. /package/{AdoptionSpecialist.ouro → SerpentGuide.ouro}/psyche/identities/quetzalcoatl.md +0 -0
  381. /package/{AdoptionSpecialist.ouro → SerpentGuide.ouro}/psyche/identities/sir-hiss.md +0 -0
  382. /package/{AdoptionSpecialist.ouro → SerpentGuide.ouro}/psyche/identities/the-snake.md +0 -0
  383. /package/dist/heart/{daemon → hatch}/hatch-animation.js +0 -0
  384. /package/dist/heart/{daemon → hatch}/specialist-orchestrator.js +0 -0
  385. /package/dist/heart/{daemon → versioning}/ouro-uti.js +0 -0
  386. /package/dist/heart/{daemon → versioning}/wrapper-publish-guard.js +0 -0
@@ -0,0 +1,394 @@
1
+ "use strict";
2
+ /**
3
+ * Interactive repair flow for degraded agents detected during `ouro up`.
4
+ *
5
+ * Examines each degraded agent's errorReason and fixHint to detect common
6
+ * issue patterns and prompt the user for repair actions.
7
+ */
8
+ Object.defineProperty(exports, "__esModule", { value: true });
9
+ exports.hasRunnableInteractiveRepair = hasRunnableInteractiveRepair;
10
+ exports.isAffirmativeAnswer = isAffirmativeAnswer;
11
+ exports.runInteractiveRepair = runInteractiveRepair;
12
+ const runtime_1 = require("../../nerves/runtime");
13
+ const identity_1 = require("../identity");
14
+ const terminal_ui_1 = require("./terminal-ui");
15
+ function isCredentialIssue(degraded) {
16
+ const reason = degraded.errorReason.toLowerCase();
17
+ const hint = degraded.fixHint.toLowerCase();
18
+ return reason.includes("credentials") || hint.includes("ouro auth");
19
+ }
20
+ function isVaultUnlockIssue(degraded) {
21
+ const text = `${degraded.errorReason}\n${degraded.fixHint}`.toLowerCase();
22
+ return /ouro vault unlock|credential vault is locked|vault(?: is)? locked/.test(text);
23
+ }
24
+ function isConfigError(degraded) {
25
+ return degraded.fixHint.length > 0 && !isVaultUnlockIssue(degraded) && !isCredentialIssue(degraded);
26
+ }
27
+ function hasRunnableInteractiveRepair(degraded) {
28
+ if (degraded.issue?.actions.some((action) => typedActionToRunnable(degraded, action) !== undefined)) {
29
+ return true;
30
+ }
31
+ return isVaultUnlockIssue(degraded) || isCredentialIssue(degraded);
32
+ }
33
+ function isAgentProvider(value) {
34
+ return Object.prototype.hasOwnProperty.call(identity_1.PROVIDER_CREDENTIALS, value);
35
+ }
36
+ function extractProviderFromFixHint(fixHint) {
37
+ const provider = fixHint.match(/--provider\s+([a-z0-9-]+)/)?.[1]
38
+ ?? fixHint.match(/providers\.([a-z0-9-]+)/)?.[1];
39
+ if (!provider || !isAgentProvider(provider))
40
+ return undefined;
41
+ return provider;
42
+ }
43
+ function escapeRegExp(value) {
44
+ return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
45
+ }
46
+ function cleanExtractedCommand(command) {
47
+ const cleaned = command?.trim().replace(/[`'",;:.)]+$/g, "").trim();
48
+ return cleaned && cleaned.length > 0 ? cleaned : undefined;
49
+ }
50
+ function extractRepairCommand(fixHint, commandPrefix) {
51
+ const escapedPrefix = escapeRegExp(commandPrefix);
52
+ const commandBody = `${escapedPrefix}(?=\\s|$)[^\`'"]*`;
53
+ const quoted = fixHint.match(new RegExp(`[\`'"](${commandBody})[\`'"]`, "i"))?.[1];
54
+ const unquoted = fixHint.match(new RegExp(`(${escapedPrefix}(?=\\s|$)[^\\n,;.]+)`, "i"))?.[1];
55
+ return cleanExtractedCommand(quoted) ?? cleanExtractedCommand(unquoted);
56
+ }
57
+ function authCommandFor(degraded) {
58
+ const command = extractRepairCommand(degraded.fixHint, "ouro auth");
59
+ return command && command.length > 0 ? command : `ouro auth --agent ${degraded.agent}`;
60
+ }
61
+ function vaultUnlockCommandFor(degraded) {
62
+ const command = extractRepairCommand(degraded.fixHint, "ouro vault unlock");
63
+ return command && command.length > 0 ? command : `ouro vault unlock --agent ${degraded.agent}`;
64
+ }
65
+ function isAffirmativeAnswer(answer) {
66
+ return /^(y|yes)$/i.test(answer.trim());
67
+ }
68
+ function uniqueCommands(commands) {
69
+ const seen = new Set();
70
+ const unique = [];
71
+ commands.forEach((command) => {
72
+ if (!command)
73
+ return;
74
+ if (seen.has(command))
75
+ return;
76
+ seen.add(command);
77
+ unique.push(command);
78
+ });
79
+ return unique;
80
+ }
81
+ function fallbackCommandsFor(degraded, primaryCommand) {
82
+ const issueCommands = degraded.issue?.actions.map((action) => action.command) ?? [];
83
+ return uniqueCommands([
84
+ primaryCommand,
85
+ ...issueCommands,
86
+ extractRepairCommand(degraded.fixHint, "ouro vault replace"),
87
+ extractRepairCommand(degraded.fixHint, "ouro vault recover"),
88
+ extractRepairCommand(degraded.fixHint, "ouro use"),
89
+ ]);
90
+ }
91
+ function renderRepairChoices(prefix, commands) {
92
+ return commands.map((command, index) => ` ${index === 0 ? prefix : "or"}: ${command}`);
93
+ }
94
+ function repairStatusFor(action) {
95
+ return action.kind === "vault-unlock" ? "locked" : "needs credentials";
96
+ }
97
+ function renderRepairQueueSummaryLines(degraded) {
98
+ const repairable = degraded
99
+ .map((entry) => ({ entry, action: runnableRepairActionFor(entry) }))
100
+ .filter((item) => item.action !== undefined);
101
+ if (repairable.length < 2)
102
+ return [];
103
+ const lines = [
104
+ "Repair queue",
105
+ `${repairable.length} agents need attention before startup can finish.`,
106
+ "",
107
+ ];
108
+ repairable.forEach(({ entry, action }, index) => {
109
+ lines.push(`${entry.agent} - ${action.label}`);
110
+ lines.push(` ${action.command}`);
111
+ if (index < repairable.length - 1)
112
+ lines.push("");
113
+ });
114
+ return lines;
115
+ }
116
+ function renderRepairQueueSummary(degraded, deps) {
117
+ const repairable = degraded
118
+ .map((entry) => ({ entry, action: runnableRepairActionFor(entry) }))
119
+ .filter((item) => item.action !== undefined);
120
+ if (!deps.isTTY) {
121
+ return renderRepairQueueSummaryLines(degraded).join("\n");
122
+ }
123
+ return (0, terminal_ui_1.renderTerminalWizard)({
124
+ isTTY: true,
125
+ columns: deps.stdoutColumns,
126
+ masthead: {
127
+ subtitle: "Repair paths ready.",
128
+ },
129
+ title: "Needs attention before startup can finish",
130
+ summary: "Ouro found repair steps it can open right now. It will walk through them one at a time.",
131
+ sections: [{
132
+ title: "Repair queue",
133
+ items: repairable.map(({ entry, action }) => ({
134
+ label: entry.agent,
135
+ status: repairStatusFor(action),
136
+ summary: action.label,
137
+ detailLines: [entry.errorReason],
138
+ command: action.command,
139
+ })),
140
+ }],
141
+ suppressEvent: true,
142
+ }).trimEnd();
143
+ }
144
+ function renderActionPromptLines(agent, action) {
145
+ const lines = [
146
+ `${agent}`,
147
+ ` needs: ${action.label}`,
148
+ ` run: ${action.command}`,
149
+ ];
150
+ if (action.kind === "vault-unlock") {
151
+ lines.push(" note: use the saved vault unlock secret");
152
+ }
153
+ return lines;
154
+ }
155
+ function renderActionPrompt(entry, action, deps) {
156
+ if (!deps.isTTY)
157
+ return renderActionPromptLines(entry.agent, action).join("\n");
158
+ const footer = action.kind === "vault-unlock"
159
+ ? "Only say yes if you have the saved vault unlock secret."
160
+ : "Say yes if you want Ouro to open the auth flow now.";
161
+ return (0, terminal_ui_1.renderTerminalWizard)({
162
+ isTTY: true,
163
+ columns: deps.stdoutColumns,
164
+ masthead: {
165
+ subtitle: "One repair step at a time.",
166
+ },
167
+ title: `Repair ${entry.agent}`,
168
+ summary: "Ouro found one clear next move for this agent.",
169
+ nextStep: {
170
+ label: action.kind === "vault-unlock"
171
+ ? "Unlock the credential vault on this machine."
172
+ : "Refresh provider authentication.",
173
+ detail: action.kind === "vault-unlock"
174
+ ? "Use the saved unlock secret if you have it. If not, leave this for later and choose a replacement or recovery path."
175
+ : "This opens the provider login or refresh flow for the selected provider.",
176
+ command: action.command,
177
+ },
178
+ sections: [{
179
+ title: "Why startup paused",
180
+ items: [{
181
+ label: entry.agent,
182
+ status: repairStatusFor(action),
183
+ summary: entry.errorReason,
184
+ }],
185
+ }],
186
+ footerLines: [footer],
187
+ suppressEvent: true,
188
+ }).trimEnd();
189
+ }
190
+ function renderDeferredRepair(agent, commands, deps) {
191
+ if (!deps.isTTY) {
192
+ return [
193
+ `Leaving ${agent} for later.`,
194
+ ...renderRepairChoices("next", commands),
195
+ ].join("\n");
196
+ }
197
+ return (0, terminal_ui_1.renderTerminalWizard)({
198
+ isTTY: true,
199
+ columns: deps.stdoutColumns,
200
+ masthead: {
201
+ subtitle: "Nothing changed yet.",
202
+ },
203
+ title: `Leaving ${agent} for later`,
204
+ summary: "Ouro did not open this repair flow right now.",
205
+ sections: [{
206
+ title: "Next time",
207
+ items: commands.map((command, index) => ({
208
+ key: String(index + 1),
209
+ label: index === 0 ? "Start here" : "Or try this",
210
+ command,
211
+ })),
212
+ }],
213
+ suppressEvent: true,
214
+ }).trimEnd();
215
+ }
216
+ function renderManualRepairHint(agent, fixHint) {
217
+ return [
218
+ `${agent}`,
219
+ " needs manual attention",
220
+ ` next: ${fixHint}`,
221
+ ].join("\n");
222
+ }
223
+ function renderUnknownRepair(agent, errorReason) {
224
+ return [
225
+ `${agent}`,
226
+ ` ${errorReason}`,
227
+ ].join("\n");
228
+ }
229
+ function writeDeclinedRepair(degraded, command, deps) {
230
+ deps.writeStdout(renderDeferredRepair(degraded.agent, fallbackCommandsFor(degraded, command), deps));
231
+ }
232
+ function runnableRepairActionFor(degraded) {
233
+ const typedAction = degraded.issue?.actions
234
+ .map((action) => typedActionToRunnable(degraded, action))
235
+ .find((action) => action !== undefined);
236
+ if (typedAction)
237
+ return typedAction;
238
+ if (isVaultUnlockIssue(degraded)) {
239
+ return { kind: "vault-unlock", label: "vault unlock", command: vaultUnlockCommandFor(degraded) };
240
+ }
241
+ if (isCredentialIssue(degraded)) {
242
+ return {
243
+ kind: "provider-auth",
244
+ label: "provider auth",
245
+ command: authCommandFor(degraded),
246
+ provider: extractProviderFromFixHint(degraded.fixHint),
247
+ };
248
+ }
249
+ return undefined;
250
+ }
251
+ function typedActionToRunnable(degraded, action) {
252
+ if (action.executable === false || action.command.includes("<"))
253
+ return undefined;
254
+ if (action.kind === "vault-unlock") {
255
+ return { kind: "vault-unlock", label: "vault unlock", command: action.command };
256
+ }
257
+ if (action.kind === "provider-auth") {
258
+ return {
259
+ kind: "provider-auth",
260
+ label: "provider auth",
261
+ command: action.command || `ouro auth --agent ${degraded.agent}`,
262
+ provider: action.provider,
263
+ };
264
+ }
265
+ return undefined;
266
+ }
267
+ function writeRepairQueueSummary(degraded, deps) {
268
+ const lines = renderRepairQueueSummaryLines(degraded);
269
+ if (lines.length > 0)
270
+ deps.writeStdout(renderRepairQueueSummary(degraded, deps));
271
+ }
272
+ async function attemptVaultUnlock(entry, action, deps) {
273
+ deps.writeStdout(renderActionPrompt(entry, action, deps));
274
+ const answer = await deps.promptInput(`Unlock ${entry.agent}'s vault now? [y/N] `);
275
+ if (!isAffirmativeAnswer(answer)) {
276
+ writeDeclinedRepair(entry, action.command, deps);
277
+ return { succeeded: false, attempted: false };
278
+ }
279
+ try {
280
+ if (!deps.runVaultUnlock) {
281
+ deps.writeStdout(renderManualRepairHint(entry.agent, entry.fixHint));
282
+ return { succeeded: false, attempted: false };
283
+ }
284
+ await deps.runVaultUnlock(entry.agent);
285
+ return { succeeded: true, attempted: true };
286
+ }
287
+ catch (error) {
288
+ const msg = error instanceof Error ? error.message : String(error);
289
+ deps.writeStdout(`Vault unlock did not finish for ${entry.agent}.\n ${msg}`);
290
+ (0, runtime_1.emitNervesEvent)({
291
+ level: "error",
292
+ component: "daemon",
293
+ event: "daemon.interactive_repair_vault_unlock_error",
294
+ message: `vault unlock failed for ${entry.agent}`,
295
+ meta: { agent: entry.agent, error: msg },
296
+ });
297
+ return { succeeded: false, attempted: true };
298
+ }
299
+ }
300
+ async function attemptProviderAuth(entry, action, deps) {
301
+ deps.writeStdout(renderActionPrompt(entry, action, deps));
302
+ const answer = await deps.promptInput(`Open the auth flow for ${entry.agent} now? [y/N] `);
303
+ if (!isAffirmativeAnswer(answer)) {
304
+ writeDeclinedRepair(entry, action.command, deps);
305
+ return { succeeded: false, attempted: false };
306
+ }
307
+ try {
308
+ if (action.provider) {
309
+ await deps.runAuthFlow(entry.agent, action.provider);
310
+ }
311
+ else {
312
+ await deps.runAuthFlow(entry.agent);
313
+ }
314
+ return { succeeded: true, attempted: true };
315
+ }
316
+ catch (error) {
317
+ const msg = error instanceof Error ? error.message : String(error);
318
+ deps.writeStdout(`Auth did not finish for ${entry.agent}.\n ${msg}`);
319
+ (0, runtime_1.emitNervesEvent)({
320
+ level: "error",
321
+ component: "daemon",
322
+ event: "daemon.interactive_repair_auth_error",
323
+ message: `auth flow failed for ${entry.agent}`,
324
+ meta: { agent: entry.agent, error: msg },
325
+ });
326
+ return { succeeded: false, attempted: true };
327
+ }
328
+ }
329
+ async function processEntry(entry, deps) {
330
+ let current = entry;
331
+ while (current) {
332
+ const action = runnableRepairActionFor(current);
333
+ let outcome;
334
+ if (action?.kind === "vault-unlock") {
335
+ outcome = await attemptVaultUnlock(current, action, deps);
336
+ }
337
+ else if (action?.kind === "provider-auth") {
338
+ outcome = await attemptProviderAuth(current, action, deps);
339
+ }
340
+ else if (isConfigError(current)) {
341
+ deps.writeStdout(renderManualRepairHint(current.agent, current.fixHint));
342
+ return { attempted: false };
343
+ }
344
+ else {
345
+ deps.writeStdout(renderUnknownRepair(current.agent, current.errorReason));
346
+ return { attempted: false };
347
+ }
348
+ if (!outcome.succeeded || !deps.recheckAgent) {
349
+ return { attempted: outcome.attempted };
350
+ }
351
+ // Re-evaluate the agent after successful repair
352
+ const recheckResult = await deps.recheckAgent(current.agent);
353
+ if (recheckResult === null) {
354
+ deps.writeStdout(`${current.agent} recovered.`);
355
+ return { attempted: true };
356
+ }
357
+ // Agent still degraded with a new error -- loop to present the new action
358
+ current = recheckResult;
359
+ }
360
+ /* v8 ignore next -- unreachable: loop always returns from within @preserve */
361
+ return { attempted: false };
362
+ }
363
+ async function runInteractiveRepair(degraded, deps) {
364
+ (0, runtime_1.emitNervesEvent)({
365
+ level: "info",
366
+ component: "daemon",
367
+ event: "daemon.interactive_repair_start",
368
+ message: "interactive repair flow started",
369
+ meta: { degradedCount: degraded.length },
370
+ });
371
+ if (degraded.length === 0) {
372
+ return { repairsAttempted: false };
373
+ }
374
+ let repairsAttempted = false;
375
+ if (!deps.skipQueueSummary) {
376
+ writeRepairQueueSummary(degraded, deps);
377
+ }
378
+ for (const entry of degraded) {
379
+ const result = await processEntry(entry, deps);
380
+ if (result.attempted)
381
+ repairsAttempted = true;
382
+ }
383
+ if (repairsAttempted) {
384
+ deps.writeStdout("Repair flow complete.");
385
+ }
386
+ (0, runtime_1.emitNervesEvent)({
387
+ level: "info",
388
+ component: "daemon",
389
+ event: "daemon.interactive_repair_end",
390
+ message: "interactive repair flow completed",
391
+ meta: { repairsAttempted },
392
+ });
393
+ return { repairsAttempted };
394
+ }
@@ -34,6 +34,7 @@ var __importStar = (this && this.__importStar) || (function () {
34
34
  })();
35
35
  Object.defineProperty(exports, "__esModule", { value: true });
36
36
  exports.DAEMON_PLIST_LABEL = void 0;
37
+ exports.bootoutLaunchAgentByLabel = bootoutLaunchAgentByLabel;
37
38
  exports.generateDaemonPlist = generateDaemonPlist;
38
39
  exports.writeLaunchAgentPlist = writeLaunchAgentPlist;
39
40
  exports.installLaunchAgent = installLaunchAgent;
@@ -48,6 +49,26 @@ function plistFilePath(homeDir) {
48
49
  function userLaunchDomain(userUid) {
49
50
  return `gui/${userUid}`;
50
51
  }
52
+ function bootoutLaunchAgentByLabel(deps) {
53
+ const domain = userLaunchDomain(deps.userUid);
54
+ try {
55
+ deps.exec(`launchctl bootout ${domain}/${exports.DAEMON_PLIST_LABEL}`);
56
+ (0, runtime_1.emitNervesEvent)({
57
+ component: "daemon",
58
+ event: "daemon.launchd_label_bootout",
59
+ message: "booted out daemon launch agent by label",
60
+ meta: { label: exports.DAEMON_PLIST_LABEL, domain },
61
+ });
62
+ }
63
+ catch (error) {
64
+ (0, runtime_1.emitNervesEvent)({
65
+ component: "daemon",
66
+ event: "daemon.launchd_label_bootout_skipped",
67
+ message: "daemon launch agent label bootout skipped",
68
+ meta: { label: exports.DAEMON_PLIST_LABEL, domain, reason: error instanceof Error ? error.message : String(error) },
69
+ });
70
+ }
71
+ }
51
72
  function generateDaemonPlist(options) {
52
73
  (0, runtime_1.emitNervesEvent)({
53
74
  component: "daemon",
@@ -78,7 +99,13 @@ function generateDaemonPlist(options) {
78
99
  lines.push(` <key>EnvironmentVariables</key>`, ` <dict>`, ` <key>PATH</key>`, ` <string>${options.envPath}</string>`, ` </dict>`);
79
100
  }
80
101
  if (options.logDir) {
81
- lines.push(` <key>StandardOutPath</key>`, ` <string>${path.join(options.logDir, "ouro-daemon-stdout.log")}</string>`, ` <key>StandardErrorPath</key>`, ` <string>${path.join(options.logDir, "ouro-daemon-stderr.log")}</string>`);
102
+ // PR 1 decision: we no longer emit `StandardErrorPath` for the daemon.
103
+ // The daemon's structured nerves ndjson pipeline (rotated + gzipped via
104
+ // createNdjsonFileSink) is the source of truth for diagnostics. Writing
105
+ // raw process stderr to an unrotated file grew to 366 MB in the wild;
106
+ // dropping the key lets launchd forward stray stderr to the system log
107
+ // where it gets rotated by the OS.
108
+ lines.push(` <key>StandardOutPath</key>`, ` <string>${path.join(options.logDir, "ouro-daemon-stdout.log")}</string>`);
82
109
  }
83
110
  lines.push(`</dict>`, `</plist>`, ``);
84
111
  return lines.join("\n");
@@ -117,11 +144,17 @@ function installLaunchAgent(deps, options) {
117
144
  catch { /* best effort */ }
118
145
  }
119
146
  writeLaunchAgentPlist(deps, options);
120
- deps.exec(`launchctl bootstrap ${domain} "${fullPath}"`);
147
+ // Bootstrap the plist so launchd manages crash recovery via KeepAlive.
148
+ // This is safe because ouro up calls this AFTER the daemon is already running,
149
+ // so launchd sees the existing process and just registers for KeepAlive.
150
+ try {
151
+ deps.exec(`launchctl bootstrap ${domain} "${fullPath}"`);
152
+ }
153
+ catch { /* already loaded */ }
121
154
  (0, runtime_1.emitNervesEvent)({
122
155
  component: "daemon",
123
156
  event: "daemon.launchd_installed",
124
- message: "launch agent installed",
157
+ message: "launch agent installed with KeepAlive",
125
158
  meta: { plistPath: fullPath },
126
159
  });
127
160
  }
@@ -133,12 +166,8 @@ function uninstallLaunchAgent(deps) {
133
166
  meta: {},
134
167
  });
135
168
  const fullPath = plistFilePath(deps.homeDir);
136
- const domain = userLaunchDomain(deps.userUid);
169
+ bootoutLaunchAgentByLabel(deps);
137
170
  if (deps.existsFile(fullPath)) {
138
- try {
139
- deps.exec(`launchctl bootout ${domain} "${fullPath}"`);
140
- }
141
- catch { /* best effort */ }
142
171
  deps.removeFile(fullPath);
143
172
  }
144
173
  (0, runtime_1.emitNervesEvent)({
@@ -37,39 +37,103 @@ exports.discoverLogFiles = discoverLogFiles;
37
37
  exports.readLastLines = readLastLines;
38
38
  exports.formatLogLine = formatLogLine;
39
39
  exports.tailLogs = tailLogs;
40
- const os = __importStar(require("os"));
41
40
  const path = __importStar(require("path"));
41
+ const zlib = __importStar(require("zlib"));
42
42
  const nerves_1 = require("../../nerves");
43
43
  const runtime_1 = require("../../nerves/runtime");
44
+ const identity_1 = require("../identity");
44
45
  const LEVEL_COLORS = {
45
46
  debug: "\x1b[2m",
46
47
  info: "\x1b[36m",
47
48
  warn: "\x1b[33m",
48
49
  error: "\x1b[31m",
49
50
  };
51
+ /**
52
+ * Parse a log filename into a (streamBase, generationRank) tuple.
53
+ *
54
+ * - `daemon.ndjson` → { streamBase: "daemon", rank: 0 } (active, newest)
55
+ * - `daemon.1.ndjson.gz` → { streamBase: "daemon", rank: 1 }
56
+ * - `daemon.5.ndjson.gz` → { streamBase: "daemon", rank: 5 } (oldest)
57
+ * - Anything else → null (not a log file).
58
+ *
59
+ * Higher rank = older. Used to sort so the oldest generation is read first
60
+ * and the active stream is read last, producing chronological output.
61
+ */
62
+ function parseLogFilename(name) {
63
+ if (name.endsWith(".ndjson.gz")) {
64
+ // e.g. daemon.1.ndjson.gz → base "daemon.1", strip ".gz" then ".ndjson" then ".<n>"
65
+ const withoutGz = name.slice(0, -".gz".length); // daemon.1.ndjson
66
+ const withoutNdjson = withoutGz.slice(0, -".ndjson".length); // daemon.1
67
+ const genMatch = withoutNdjson.match(/^(.+)\.(\d+)$/);
68
+ if (!genMatch)
69
+ return null;
70
+ return { streamBase: genMatch[1], rank: parseInt(genMatch[2], 10) };
71
+ }
72
+ if (name.endsWith(".ndjson")) {
73
+ const withoutNdjson = name.slice(0, -".ndjson".length);
74
+ // Active file: daemon.ndjson → base "daemon", rank 0
75
+ // Legacy numeric gen: daemon.1.ndjson → base "daemon", rank 1 (treat same as gzipped)
76
+ const legacyMatch = withoutNdjson.match(/^(.+)\.(\d+)$/);
77
+ if (legacyMatch) {
78
+ return { streamBase: legacyMatch[1], rank: parseInt(legacyMatch[2], 10) };
79
+ }
80
+ return { streamBase: withoutNdjson, rank: 0 };
81
+ }
82
+ return null;
83
+ }
50
84
  function discoverLogFiles(options) {
51
85
  /* v8 ignore start -- integration: default DI stubs for real OS @preserve */
52
- const homeDir = options.homeDir ?? os.homedir();
53
86
  const existsSync = options.existsSync ?? (() => false);
54
87
  const readdirSync = options.readdirSync ?? (() => []);
55
88
  /* v8 ignore stop */
56
- const logDir = path.join(homeDir, ".agentstate", "daemon", "logs");
57
- const files = [];
89
+ const logDir = options.homeDir
90
+ ? path.join(options.homeDir, "AgentBundles", `${options.agentName ?? "slugger"}.ouro`, "state", "daemon", "logs")
91
+ : (0, identity_1.getAgentDaemonLogsDir)(options.agentName);
92
+ const entries = [];
58
93
  if (existsSync(logDir)) {
59
94
  for (const name of readdirSync(logDir)) {
60
- if (!name.endsWith(".ndjson"))
95
+ const parsed = parseLogFilename(name);
96
+ if (!parsed)
61
97
  continue;
62
98
  if (options.agentFilter && !name.includes(options.agentFilter))
63
99
  continue;
64
- files.push(path.join(logDir, name));
100
+ entries.push({ name, parsed });
65
101
  }
66
102
  }
67
- return files.sort();
103
+ // Sort chronologically: for each stream, oldest generation first, active last.
104
+ // Across streams, sort alphabetically by streamBase so output is stable.
105
+ entries.sort((a, b) => {
106
+ if (a.parsed.streamBase !== b.parsed.streamBase) {
107
+ return a.parsed.streamBase < b.parsed.streamBase ? -1 : 1;
108
+ }
109
+ // Same stream: higher rank = older = read first.
110
+ return b.parsed.rank - a.parsed.rank;
111
+ });
112
+ return entries.map((e) => path.join(logDir, e.name));
113
+ }
114
+ /**
115
+ * Read a log file as a string, transparently handling gzipped rotations.
116
+ *
117
+ * For `.ndjson.gz` files we read the raw bytes via `fs.readFileSync` (ignoring
118
+ * any caller-supplied DI `readFileSync`, since that stub returns a `string`
119
+ * and would corrupt gzip bytes) and then `zlib.gunzipSync` to recover the
120
+ * original text. For plain `.ndjson` files we defer to the DI stub so tests
121
+ * can keep mocking fs.
122
+ */
123
+ function readNdjsonFileContents(filePath, readFileSync) {
124
+ if (filePath.endsWith(".gz")) {
125
+ // Binary path: tests can mock readFileSync to return a Buffer (typed as
126
+ // string) via `as unknown as string` — we accept both Buffer and Uint8Array.
127
+ const raw = readFileSync(filePath);
128
+ const buf = typeof raw === "string" ? Buffer.from(raw, "binary") : Buffer.from(raw);
129
+ return zlib.gunzipSync(buf).toString("utf-8");
130
+ }
131
+ return readFileSync(filePath, "utf-8");
68
132
  }
69
133
  function readLastLines(filePath, count, readFileSync) {
70
134
  let content;
71
135
  try {
72
- content = readFileSync(filePath, "utf-8");
136
+ content = readNdjsonFileContents(filePath, readFileSync);
73
137
  }
74
138
  catch {
75
139
  return [];
@@ -99,12 +163,17 @@ function tailLogs(options = {}) {
99
163
  const files = discoverLogFiles(options);
100
164
  (0, runtime_1.emitNervesEvent)({ component: "daemon", event: "daemon.log_tailer_started", message: "log tailer started", meta: { fileCount: files.length, follow: !!options.follow } });
101
165
  const fileSizes = new Map();
102
- // Read initial lines
166
+ // Read initial lines from each discovered file (oldest gz → newest gz → active).
167
+ // Gzipped files are historical and never tailed in follow mode.
103
168
  for (const file of files) {
104
169
  const lines = readLastLines(file, lineCount, readFileSync);
105
170
  for (const line of lines) {
106
171
  writer(`${formatLogLine(line)}\n`);
107
172
  }
173
+ if (file.endsWith(".gz")) {
174
+ // Historical rotation — skip size tracking, never followed.
175
+ continue;
176
+ }
108
177
  try {
109
178
  const content = readFileSync(file, "utf-8");
110
179
  fileSizes.set(file, content.length);
@@ -113,9 +182,10 @@ function tailLogs(options = {}) {
113
182
  fileSizes.set(file, 0);
114
183
  }
115
184
  }
116
- // Follow mode
185
+ // Follow mode: only the active (non-gzipped) stream is watched.
117
186
  if (options.follow && watchFile && unwatchFile) {
118
- for (const file of files) {
187
+ const activeFiles = files.filter((f) => !f.endsWith(".gz"));
188
+ for (const file of activeFiles) {
119
189
  watchFile(file, () => {
120
190
  let content;
121
191
  try {
@@ -137,7 +207,7 @@ function tailLogs(options = {}) {
137
207
  });
138
208
  }
139
209
  return () => {
140
- for (const file of files) {
210
+ for (const file of activeFiles) {
141
211
  unwatchFile(file);
142
212
  }
143
213
  };