@phren/cli 0.2.14 → 0.2.16

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 (387) hide show
  1. package/README.md +2 -2
  2. package/dist/agent-instructions.d.ts +12 -0
  3. package/dist/agent-instructions.js +52 -0
  4. package/dist/bridge/agent-hook-stores.d.ts +32 -0
  5. package/dist/bridge/agent-hook-stores.js +67 -0
  6. package/dist/bridge/agent-hooks.d.ts +193 -2
  7. package/dist/bridge/agent-hooks.js +1045 -38
  8. package/dist/bridge/canary.d.ts +27 -0
  9. package/dist/bridge/canary.js +189 -0
  10. package/dist/bridge/changes.d.ts +57 -0
  11. package/dist/bridge/changes.js +403 -0
  12. package/dist/bridge/client.d.ts +3 -0
  13. package/dist/bridge/client.js +36 -0
  14. package/dist/bridge/code-note.d.ts +22 -0
  15. package/dist/bridge/code-note.js +42 -0
  16. package/dist/bridge/code-routes.d.ts +133 -0
  17. package/dist/bridge/code-routes.js +319 -0
  18. package/dist/bridge/codex-threads.d.ts +27 -0
  19. package/dist/bridge/codex-threads.js +442 -0
  20. package/dist/bridge/command.d.ts +7 -0
  21. package/dist/bridge/command.js +50 -5
  22. package/dist/bridge/computer-names.d.ts +4 -0
  23. package/dist/bridge/computer-names.js +16 -0
  24. package/dist/bridge/computers.d.ts +9 -0
  25. package/dist/bridge/computers.js +111 -0
  26. package/dist/bridge/context.d.ts +14 -0
  27. package/dist/bridge/context.js +149 -0
  28. package/dist/bridge/dispatch-command.d.ts +3 -0
  29. package/dist/bridge/dispatch-command.js +93 -0
  30. package/dist/bridge/dispatch-hosts.d.ts +23 -0
  31. package/dist/bridge/dispatch-hosts.js +25 -0
  32. package/dist/bridge/dispatch-returns.d.ts +123 -0
  33. package/dist/bridge/dispatch-returns.js +279 -0
  34. package/dist/bridge/dispatch-tree.d.ts +54 -0
  35. package/dist/bridge/dispatch-tree.js +198 -0
  36. package/dist/bridge/dispatch.d.ts +207 -0
  37. package/dist/bridge/dispatch.js +261 -0
  38. package/dist/bridge/enroll.d.ts +31 -0
  39. package/dist/bridge/enroll.js +236 -0
  40. package/dist/bridge/fanout-messages.d.ts +74 -0
  41. package/dist/bridge/fanout-messages.js +230 -0
  42. package/dist/bridge/fanouts.d.ts +160 -0
  43. package/dist/bridge/fanouts.js +702 -0
  44. package/dist/bridge/file-range.d.ts +16 -0
  45. package/dist/bridge/file-range.js +90 -0
  46. package/dist/bridge/files.d.ts +20 -0
  47. package/dist/bridge/files.js +54 -0
  48. package/dist/bridge/git-publish.d.ts +23 -0
  49. package/dist/bridge/git-publish.js +145 -0
  50. package/dist/bridge/git-worktrees.d.ts +21 -0
  51. package/dist/bridge/git-worktrees.js +150 -0
  52. package/dist/bridge/git.d.ts +54 -0
  53. package/dist/bridge/git.js +552 -0
  54. package/dist/bridge/grants.d.ts +31 -0
  55. package/dist/bridge/grants.js +181 -0
  56. package/dist/bridge/hand-off.d.ts +79 -0
  57. package/dist/bridge/hand-off.js +151 -0
  58. package/dist/bridge/health.d.ts +128 -0
  59. package/dist/bridge/health.js +260 -0
  60. package/dist/bridge/herdr.d.ts +79 -6
  61. package/dist/bridge/herdr.js +292 -27
  62. package/dist/bridge/hook-main.js +2 -0
  63. package/dist/bridge/install.d.ts +32 -1
  64. package/dist/bridge/install.js +225 -38
  65. package/dist/bridge/launch-worktree.d.ts +21 -0
  66. package/dist/bridge/launch-worktree.js +70 -0
  67. package/dist/bridge/limits.d.ts +20 -0
  68. package/dist/bridge/limits.js +65 -0
  69. package/dist/bridge/locate.d.ts +16 -0
  70. package/dist/bridge/locate.js +75 -0
  71. package/dist/bridge/metrics.d.ts +29 -0
  72. package/dist/bridge/metrics.js +71 -0
  73. package/dist/bridge/model-switch.d.ts +35 -0
  74. package/dist/bridge/model-switch.js +250 -0
  75. package/dist/bridge/models.d.ts +46 -0
  76. package/dist/bridge/models.js +257 -0
  77. package/dist/bridge/opencode-approvals.d.ts +6 -0
  78. package/dist/bridge/opencode-approvals.js +60 -0
  79. package/dist/bridge/pane-text.d.ts +15 -0
  80. package/dist/bridge/pane-text.js +23 -0
  81. package/dist/bridge/peers.d.ts +27 -0
  82. package/dist/bridge/peers.js +130 -0
  83. package/dist/bridge/projects.d.ts +12 -1
  84. package/dist/bridge/projects.js +268 -20
  85. package/dist/bridge/protocol.d.ts +35 -2
  86. package/dist/bridge/protocol.js +42 -7
  87. package/dist/bridge/push.d.ts +83 -0
  88. package/dist/bridge/push.js +199 -0
  89. package/dist/bridge/questions.d.ts +38 -0
  90. package/dist/bridge/questions.js +205 -0
  91. package/dist/bridge/schedule-format.d.ts +103 -0
  92. package/dist/bridge/schedule-format.js +266 -0
  93. package/dist/bridge/schedule-launch.d.ts +11 -0
  94. package/dist/bridge/schedule-launch.js +169 -0
  95. package/dist/bridge/schedule-watch.d.ts +52 -0
  96. package/dist/bridge/schedule-watch.js +242 -0
  97. package/dist/bridge/schedules.d.ts +48 -0
  98. package/dist/bridge/schedules.js +205 -0
  99. package/dist/bridge/server-launch.d.ts +14 -0
  100. package/dist/bridge/server-launch.js +218 -0
  101. package/dist/bridge/server-overview.d.ts +45 -0
  102. package/dist/bridge/server-overview.js +102 -0
  103. package/dist/bridge/server-pane-routes.d.ts +29 -0
  104. package/dist/bridge/server-pane-routes.js +400 -0
  105. package/dist/bridge/server-routes.d.ts +106 -0
  106. package/dist/bridge/server-routes.js +538 -0
  107. package/dist/bridge/server-stream.d.ts +46 -0
  108. package/dist/bridge/server-stream.js +253 -0
  109. package/dist/bridge/server.d.ts +3 -15
  110. package/dist/bridge/server.js +162 -264
  111. package/dist/bridge/session-servers.d.ts +24 -0
  112. package/dist/bridge/session-servers.js +136 -0
  113. package/dist/bridge/side-questions.d.ts +74 -0
  114. package/dist/bridge/side-questions.js +252 -0
  115. package/dist/bridge/simulators.d.ts +28 -0
  116. package/dist/bridge/simulators.js +198 -0
  117. package/dist/bridge/speech-transcribe.d.ts +24 -0
  118. package/dist/bridge/speech-transcribe.js +124 -0
  119. package/dist/bridge/speech.d.ts +35 -0
  120. package/dist/bridge/speech.js +98 -0
  121. package/dist/bridge/steps.d.ts +13 -0
  122. package/dist/bridge/steps.js +222 -0
  123. package/dist/bridge/tab-activity.d.ts +18 -0
  124. package/dist/bridge/tab-activity.js +99 -0
  125. package/dist/bridge/terminal-choice.d.ts +64 -0
  126. package/dist/bridge/terminal-choice.js +281 -0
  127. package/dist/bridge/transcript-claude.d.ts +22 -0
  128. package/dist/bridge/transcript-claude.js +353 -0
  129. package/dist/bridge/transcript-codex.d.ts +30 -0
  130. package/dist/bridge/transcript-codex.js +282 -0
  131. package/dist/bridge/transcript-copilot.d.ts +4 -0
  132. package/dist/bridge/transcript-copilot.js +14 -0
  133. package/dist/bridge/transcript-opencode.d.ts +5 -0
  134. package/dist/bridge/transcript-opencode.js +26 -0
  135. package/dist/bridge/transcript-preview.d.ts +94 -0
  136. package/dist/bridge/transcript-preview.js +476 -0
  137. package/dist/bridge/transcripts.d.ts +81 -4
  138. package/dist/bridge/transcripts.js +332 -67
  139. package/dist/bridge/transport.d.ts +3 -0
  140. package/dist/bridge/transport.js +96 -15
  141. package/dist/bridge/uploads.d.ts +15 -0
  142. package/dist/bridge/uploads.js +44 -2
  143. package/dist/bridge/usage.d.ts +124 -0
  144. package/dist/bridge/usage.js +859 -0
  145. package/dist/bridge-hook.mjs +41246 -21385
  146. package/dist/cli/actions.js +14 -1
  147. package/dist/cli/config-proactivity.d.ts +3 -1
  148. package/dist/cli/config-proactivity.js +35 -3
  149. package/dist/cli/config.js +4 -1
  150. package/dist/cli/extract.js +3 -6
  151. package/dist/cli/govern.js +5 -2
  152. package/dist/cli/hooks-globs.js +1 -1
  153. package/dist/cli/hooks.d.ts +1 -1
  154. package/dist/cli/hooks.js +9 -7
  155. package/dist/cli/namespaces-projects.js +12 -6
  156. package/dist/cli/namespaces-store.js +37 -6
  157. package/dist/cli/namespaces-tasks.js +1 -1
  158. package/dist/cli/schedules.d.ts +1 -0
  159. package/dist/cli/schedules.js +164 -0
  160. package/dist/cli/session-background.js +1 -1
  161. package/dist/cli/session-git.d.ts +8 -5
  162. package/dist/cli/session-git.js +45 -120
  163. package/dist/cli/session-start.js +3 -1
  164. package/dist/cli/session-stop.js +19 -8
  165. package/dist/cli/team.js +13 -10
  166. package/dist/cli-handlers.d.ts +1 -1
  167. package/dist/cli-handlers.js +8 -4
  168. package/dist/cli-help.d.ts +5 -4
  169. package/dist/cli-help.js +15 -15
  170. package/dist/cli-registry.d.ts +4 -1
  171. package/dist/cli-registry.js +119 -6
  172. package/dist/content/archive.js +2 -2
  173. package/dist/content/citation.d.ts +11 -0
  174. package/dist/content/citation.js +18 -0
  175. package/dist/content/learning.js +2 -0
  176. package/dist/content/summarize.d.ts +14 -15
  177. package/dist/content/summarize.js +60 -5
  178. package/dist/content/validate.d.ts +3 -1
  179. package/dist/content/validate.js +26 -8
  180. package/dist/core/project-registry.d.ts +26 -0
  181. package/dist/core/project-registry.js +573 -0
  182. package/dist/core/project.js +2 -3
  183. package/dist/data/access.d.ts +7 -1
  184. package/dist/data/access.js +13 -3
  185. package/dist/data/tasks.d.ts +18 -3
  186. package/dist/data/tasks.js +8 -7
  187. package/dist/entrypoint.js +44 -10
  188. package/dist/fanout/adapters/claude.d.ts +2 -0
  189. package/dist/fanout/adapters/claude.js +7 -0
  190. package/dist/fanout/adapters/codex.d.ts +2 -0
  191. package/dist/fanout/adapters/codex.js +9 -0
  192. package/dist/fanout/adapters/opencode.d.ts +4 -0
  193. package/dist/fanout/adapters/opencode.js +9 -0
  194. package/dist/fanout/adapters/types.d.ts +21 -0
  195. package/dist/fanout/adapters/types.js +3 -0
  196. package/dist/fanout/command.d.ts +2 -0
  197. package/dist/fanout/command.js +78 -0
  198. package/dist/fanout/launcher.d.ts +27 -0
  199. package/dist/fanout/launcher.js +156 -0
  200. package/dist/fanout/opencode-serve.d.ts +24 -0
  201. package/dist/fanout/opencode-serve.js +191 -0
  202. package/dist/fanout/picker.d.ts +91 -0
  203. package/dist/fanout/picker.js +51 -0
  204. package/dist/fanout/usage.d.ts +5 -0
  205. package/dist/fanout/usage.js +51 -0
  206. package/dist/fanout/watchdog.d.ts +10 -0
  207. package/dist/fanout/watchdog.js +27 -0
  208. package/dist/filenames.d.ts +9 -0
  209. package/dist/filenames.js +11 -0
  210. package/dist/finding/context.js +4 -22
  211. package/dist/generated/memory-ui-graph.browser.js +279 -283
  212. package/dist/governance/policy-constants.d.ts +11 -0
  213. package/dist/governance/policy-constants.js +9 -0
  214. package/dist/governance/policy.d.ts +5 -8
  215. package/dist/governance/policy.js +7 -5
  216. package/dist/graph-core/camera.d.ts +24 -0
  217. package/dist/graph-core/camera.js +18 -0
  218. package/dist/graph-core/index.d.ts +2 -0
  219. package/dist/graph-core/index.js +2 -0
  220. package/dist/graph-core/labels.d.ts +77 -0
  221. package/dist/graph-core/labels.js +124 -0
  222. package/dist/graph-core/model.d.ts +13 -0
  223. package/dist/graph-core/model.js +33 -0
  224. package/dist/graph-core/types.d.ts +2 -0
  225. package/dist/home-paths.d.ts +7 -0
  226. package/dist/home-paths.js +21 -0
  227. package/dist/hooks.d.ts +3 -0
  228. package/dist/hooks.js +13 -0
  229. package/dist/index.js +24 -2
  230. package/dist/init/guard-globals.d.ts +1 -1
  231. package/dist/init/guard-globals.js +4 -4
  232. package/dist/init/init-configure.js +3 -3
  233. package/dist/init/init-uninstall.js +2 -2
  234. package/dist/init/init-walkthrough.d.ts +2 -0
  235. package/dist/init/init-walkthrough.js +17 -6
  236. package/dist/init/init.js +26 -6
  237. package/dist/init/management-preset.d.ts +1 -1
  238. package/dist/init/management-preset.js +2 -2
  239. package/dist/init/preferences.js +1 -1
  240. package/dist/init/self-wiring.js +1 -1
  241. package/dist/init/setup.d.ts +3 -26
  242. package/dist/init/setup.js +49 -588
  243. package/dist/init/shared.js +2 -0
  244. package/dist/init/store-gitignore.d.ts +1 -1
  245. package/dist/init/store-gitignore.js +2 -0
  246. package/dist/init/teardown.d.ts +1 -1
  247. package/dist/init/teardown.js +2 -2
  248. package/dist/link/context.js +1 -1
  249. package/dist/link/doctor.d.ts +22 -1
  250. package/dist/link/doctor.js +100 -54
  251. package/dist/link/link.js +29 -61
  252. package/dist/link/refresh.js +2 -2
  253. package/dist/link/skills.js +26 -5
  254. package/dist/machine-identity.d.ts +3 -0
  255. package/dist/machine-identity.js +6 -0
  256. package/dist/mcp/profile.d.ts +2 -15
  257. package/dist/mcp/profile.js +64 -9
  258. package/dist/memory-ui-graph.runtime.js +279 -283
  259. package/dist/modules/code-package.d.ts +16 -0
  260. package/dist/modules/code-package.js +152 -0
  261. package/dist/modules/command.d.ts +2 -0
  262. package/dist/modules/command.js +67 -0
  263. package/dist/modules/config.d.ts +4 -0
  264. package/dist/modules/config.js +70 -0
  265. package/dist/modules/manifest.d.ts +41 -0
  266. package/dist/modules/manifest.js +1 -0
  267. package/dist/modules/provision.d.ts +3 -0
  268. package/dist/modules/provision.js +84 -0
  269. package/dist/modules/registry.d.ts +16 -0
  270. package/dist/modules/registry.js +250 -0
  271. package/dist/modules/runtime.d.ts +15 -0
  272. package/dist/modules/runtime.js +59 -0
  273. package/dist/package-metadata.js +10 -2
  274. package/dist/phren-dotenv.js +4 -2
  275. package/dist/phren-paths.d.ts +3 -2
  276. package/dist/phren-paths.js +4 -5
  277. package/dist/profile-store.js +4 -5
  278. package/dist/project-config.d.ts +19 -1
  279. package/dist/project-config.js +29 -3
  280. package/dist/project-topics.js +4 -4
  281. package/dist/provider-adapters.js +1 -4
  282. package/dist/query-correlation.js +6 -6
  283. package/dist/session/artifacts.js +5 -5
  284. package/dist/session/checkpoints.js +5 -0
  285. package/dist/session/utils.d.ts +2 -2
  286. package/dist/session/utils.js +6 -6
  287. package/dist/shared/content.d.ts +1 -1
  288. package/dist/shared/content.js +1 -1
  289. package/dist/shared/data-utils.js +1 -1
  290. package/dist/shared/fragment-graph.d.ts +1 -1
  291. package/dist/shared/fragment-graph.js +5 -5
  292. package/dist/shared/index.js +48 -7
  293. package/dist/shared/retrieval.d.ts +18 -1
  294. package/dist/shared/retrieval.js +100 -11
  295. package/dist/shared/search-fallback.js +4 -6
  296. package/dist/shared/sqljs.d.ts +2 -0
  297. package/dist/shared/sqljs.js +4 -2
  298. package/dist/shared.d.ts +0 -1
  299. package/dist/shared.js +0 -1
  300. package/dist/shell/input.d.ts +1 -5
  301. package/dist/shell/input.js +16 -10
  302. package/dist/shell/palette.d.ts +2 -2
  303. package/dist/shell/palette.js +3 -7
  304. package/dist/shell/render.d.ts +3 -1
  305. package/dist/shell/render.js +4 -4
  306. package/dist/shell/shell.js +4 -1
  307. package/dist/shell/types.d.ts +1 -0
  308. package/dist/shell/types.js +4 -0
  309. package/dist/shell/view.d.ts +0 -4
  310. package/dist/shell/view.js +19 -27
  311. package/dist/skill/registry.js +25 -17
  312. package/dist/skill/state.d.ts +3 -0
  313. package/dist/skill/state.js +13 -7
  314. package/dist/status.js +38 -17
  315. package/dist/store-registry.d.ts +44 -18
  316. package/dist/store-registry.js +169 -60
  317. package/dist/store-weight.d.ts +1 -6
  318. package/dist/store-weight.js +4 -2
  319. package/dist/sync/auth-doctor.d.ts +8 -0
  320. package/dist/sync/auth-doctor.js +27 -0
  321. package/dist/sync/auth.d.ts +27 -0
  322. package/dist/sync/auth.js +114 -0
  323. package/dist/sync/conflict-resolve.d.ts +9 -0
  324. package/dist/sync/conflict-resolve.js +146 -0
  325. package/dist/sync/git-state.d.ts +4 -0
  326. package/dist/sync/git-state.js +49 -0
  327. package/dist/sync/outcome.d.ts +34 -0
  328. package/dist/sync/outcome.js +57 -0
  329. package/dist/sync/pull.d.ts +15 -7
  330. package/dist/sync/pull.js +84 -35
  331. package/dist/sync/store-merge.d.ts +29 -0
  332. package/dist/sync/store-merge.js +137 -0
  333. package/dist/sync/task-merge.d.ts +22 -0
  334. package/dist/sync/task-merge.js +158 -0
  335. package/dist/task/github.js +1 -1
  336. package/dist/task/lifecycle.d.ts +5 -0
  337. package/dist/task/lifecycle.js +67 -23
  338. package/dist/terminal-text.d.ts +5 -0
  339. package/dist/terminal-text.js +11 -0
  340. package/dist/test-global-setup.js +7 -0
  341. package/dist/tool-registry.d.ts +1 -1
  342. package/dist/tool-registry.js +3 -1
  343. package/dist/tools/code.d.ts +3 -0
  344. package/dist/tools/code.js +178 -0
  345. package/dist/tools/config.js +5 -0
  346. package/dist/tools/data.js +14 -7
  347. package/dist/tools/dispatch.d.ts +2 -0
  348. package/dist/tools/dispatch.js +66 -0
  349. package/dist/tools/finding.js +43 -41
  350. package/dist/tools/ops.js +5 -2
  351. package/dist/tools/search.js +21 -8
  352. package/dist/tools/session.js +21 -22
  353. package/dist/tools/tasks.js +8 -2
  354. package/dist/tools/types.d.ts +2 -2
  355. package/dist/tools/types.js +2 -2
  356. package/dist/ui/assets.js +1 -1
  357. package/dist/ui/data.js +14 -15
  358. package/dist/ui/deep-void.d.ts +1 -1
  359. package/dist/ui/deep-void.js +0 -1
  360. package/dist/ui/graph-chrome.d.ts +1 -1
  361. package/dist/ui/graph-chrome.js +51 -0
  362. package/dist/ui/page.js +5 -5
  363. package/dist/ui/scripts.js +67 -30
  364. package/dist/ui/server.js +34 -6
  365. package/dist/update.js +1 -1
  366. package/dist/utils-fts.js +1 -0
  367. package/dist/utils-helpers.d.ts +7 -0
  368. package/dist/utils-helpers.js +17 -0
  369. package/dist/utils.d.ts +1 -1
  370. package/dist/utils.js +1 -1
  371. package/package.json +45 -3
  372. package/plugins/opencode/phren-transcript.js +340 -0
  373. package/starter/README.md +4 -4
  374. package/starter/global/{CLAUDE.md → AGENTS.md} +2 -2
  375. package/starter/global/skills/conductor/SKILL.md +106 -0
  376. package/starter/global/skills/fanout/SKILL.md +20 -0
  377. package/starter/global/skills/phren-discover/SKILL.md +6 -6
  378. package/starter/global/skills/phren-init/SKILL.md +4 -4
  379. package/starter/global/skills/phren-sync/SKILL.md +3 -3
  380. package/starter/templates/frontend/reference/README.md +1 -1
  381. package/starter/templates/library/reference/README.md +1 -1
  382. package/starter/templates/monorepo/reference/README.md +1 -1
  383. package/starter/templates/python-project/reference/README.md +1 -1
  384. /package/starter/templates/frontend/{CLAUDE.md → AGENTS.md} +0 -0
  385. /package/starter/templates/library/{CLAUDE.md → AGENTS.md} +0 -0
  386. /package/starter/templates/monorepo/{CLAUDE.md → AGENTS.md} +0 -0
  387. /package/starter/templates/python-project/{CLAUDE.md → AGENTS.md} +0 -0
@@ -0,0 +1,260 @@
1
+ import { execFile, spawn } from "node:child_process";
2
+ import { lstat, readFile } from "node:fs/promises";
3
+ import { homedir, hostname } from "node:os";
4
+ import path from "node:path";
5
+ import { promisify } from "node:util";
6
+ import { assessSyncOutage, FAILED_PUSH_STATUSES, getRuntimeHealth } from "../governance/policy.js";
7
+ import { getProjectDirs } from "../phren-paths.js";
8
+ import { resolveAllStores } from "../store-registry.js";
9
+ import { publicComputerKey } from "./computers.js";
10
+ import { hookPeers, peerRequest } from "./peers.js";
11
+ import { BridgeError, bridgeRoot } from "./protocol.js";
12
+ import { canonicalComputer, readScheduleDocument, readScheduleRuns, scheduleRunsFile } from "./schedules.js";
13
+ import { countGit } from "./metrics.js";
14
+ const exec = promisify(execFile);
15
+ const VERSION_TIMEOUT_MS = 3_000;
16
+ const VERSION_CACHE_MS = 5 * 60_000;
17
+ const PEER_TIMEOUT_MS = 5_000;
18
+ const versionCache = new Map();
19
+ /** `<tool> --version`, bounded to 3 seconds and remembered for 5 minutes. */
20
+ export function toolVersion(tool, executable = tool) {
21
+ const cached = versionCache.get(tool);
22
+ if (cached && Date.now() - cached.at < VERSION_CACHE_MS)
23
+ return cached.value;
24
+ const value = new Promise(resolve => {
25
+ let out = "", done = false;
26
+ const child = spawn(executable, ["--version"], { cwd: homedir(), stdio: ["ignore", "pipe", "pipe"], env: { ...process.env, NO_COLOR: "1" } });
27
+ const finish = (result) => { if (!done) {
28
+ done = true;
29
+ clearTimeout(timer);
30
+ resolve(result);
31
+ } };
32
+ const timer = setTimeout(() => { child.kill("SIGKILL"); finish({ tool, status: "error", detail: "--version did not answer within 3 seconds" }); }, VERSION_TIMEOUT_MS);
33
+ const collect = (chunk) => { if (out.length < 4_096)
34
+ out += chunk.toString(); };
35
+ child.stdout.on("data", collect);
36
+ child.stderr.on("data", collect);
37
+ child.on("error", (error) => finish(error.code === "ENOENT" ? { tool, status: "missing" }
38
+ : { tool, status: "error", detail: error.code ?? "could not run" }));
39
+ child.on("close", code => {
40
+ const version = /\d+\.\d+(?:\.\d+)?(?:[-+][0-9A-Za-z.-]+)?/.exec(out)?.[0];
41
+ finish(version ? { tool, status: "ok", version } : { tool, status: "error", detail: `--version exited ${code ?? "by signal"} without a version` });
42
+ });
43
+ });
44
+ versionCache.set(tool, { at: Date.now(), value });
45
+ return value;
46
+ }
47
+ /** Only for tests: forget cached versions. */
48
+ export function clearVersionCache() { versionCache.clear(); }
49
+ /** A sync failure message without credentials a remote URL might carry. */
50
+ function plainError(value) {
51
+ if (!value)
52
+ return undefined;
53
+ return value.replace(/[a-z][a-z0-9+.-]*:\/\/[^\s/@]+@/gi, match => match.replace(/\/\/[^\s/@]+@/, "//"))
54
+ .replace(/[\x00-\x1f\x7f]+/g, " ").trim().slice(0, 300) || undefined;
55
+ }
56
+ async function git(cwd, args) {
57
+ try {
58
+ countGit("health");
59
+ const { stdout } = await exec("git", args, { cwd, timeout: 5_000, maxBuffer: 65_536, env: { ...process.env, GIT_TERMINAL_PROMPT: "0" } });
60
+ return stdout.trim();
61
+ }
62
+ catch {
63
+ return undefined;
64
+ }
65
+ }
66
+ /** Branch and ahead/behind against the upstream as last fetched; nothing is fetched here. */
67
+ export async function storeSync(store) {
68
+ let stores;
69
+ try {
70
+ stores = resolveAllStores(store);
71
+ }
72
+ catch {
73
+ return [];
74
+ }
75
+ return Promise.all(stores.slice(0, 16).map(async (entry) => {
76
+ const result = { name: entry.name, role: entry.role, available: entry.available !== false, degraded: false };
77
+ if (!result.available) {
78
+ result.error = "The store's folder is missing on this computer.";
79
+ result.degraded = true;
80
+ return result;
81
+ }
82
+ const branch = await git(entry.path, ["rev-parse", "--abbrev-ref", "HEAD"]);
83
+ if (branch)
84
+ result.branch = branch;
85
+ const upstream = branch ? await git(entry.path, ["rev-parse", "--abbrev-ref", "--symbolic-full-name", "@{u}"]) : undefined;
86
+ if (upstream) {
87
+ result.upstream = upstream;
88
+ const counts = /^(\d+)\s+(\d+)$/.exec(await git(entry.path, ["rev-list", "--left-right", "--count", "HEAD...@{u}"]) ?? "");
89
+ if (counts) {
90
+ result.ahead = Number(counts[1]);
91
+ result.behind = Number(counts[2]);
92
+ }
93
+ }
94
+ const sync = getRuntimeHealth(entry.path).lastSync;
95
+ if (sync?.lastPushStatus)
96
+ result.lastPushStatus = sync.lastPushStatus;
97
+ if (sync?.lastPushAt)
98
+ result.lastPushAt = sync.lastPushAt;
99
+ if (sync?.lastSuccessfulPushAt)
100
+ result.lastSuccessfulPushAt = sync.lastSuccessfulPushAt;
101
+ if (sync?.consecutiveFailures)
102
+ result.consecutiveFailures = sync.consecutiveFailures;
103
+ const failing = sync?.lastPushStatus !== undefined && FAILED_PUSH_STATUSES.has(sync.lastPushStatus);
104
+ const pullFailed = sync?.lastPullStatus === "error";
105
+ if (failing || pullFailed)
106
+ result.error = plainError(sync?.lastPushDetail || sync?.lastPullDetail) ?? `Last sync: ${sync?.lastPushStatus ?? "pull failed"}`;
107
+ result.degraded = assessSyncOutage(sync).degraded;
108
+ return result;
109
+ }));
110
+ }
111
+ /** The newest run in schedule-runs.jsonl, with its schedule's name when the project still has it. */
112
+ export async function lastScheduledRun(store, runsFile = scheduleRunsFile()) {
113
+ const runs = await readScheduleRuns(runsFile).catch(() => []);
114
+ const last = runs.reduce((newest, run) => !newest || run.startedAt >= newest.startedAt ? run : newest, undefined);
115
+ if (!last)
116
+ return null;
117
+ let name;
118
+ const directory = getProjectDirs(store).find(dir => path.basename(dir).toLowerCase() === last.project.toLowerCase());
119
+ if (directory)
120
+ name = (await readScheduleDocument(directory).catch(() => undefined))?.schedules.find(item => item.id === last.scheduleId)?.name;
121
+ return { ...(name ? { name } : {}), project: last.project, status: last.status, ...(last.reason ? { reason: plainError(last.reason) } : {}),
122
+ startedAt: last.startedAt, ...(last.finishedAt ? { finishedAt: last.finishedAt } : {}) };
123
+ }
124
+ /** This computer's public SSH host key, the pin a peer's hooks.yaml holds for it. */
125
+ async function ownHostKey() {
126
+ try {
127
+ return publicComputerKey(await readFile("/etc/ssh/ssh_host_ed25519_key.pub", "utf8"));
128
+ }
129
+ catch {
130
+ return undefined;
131
+ }
132
+ }
133
+ /** Whether this computer's hooks.yaml lists the caller, by pinned host key or by name. */
134
+ export async function listsCaller(caller) {
135
+ const peers = await hookPeers().catch(() => []);
136
+ const short = (value) => canonicalComputer(value).split(".")[0];
137
+ const name = caller.name ? short(caller.name) : undefined;
138
+ let key;
139
+ try {
140
+ key = caller.hostKey ? publicComputerKey(caller.hostKey) : undefined;
141
+ }
142
+ catch {
143
+ key = undefined;
144
+ }
145
+ const knowsCaller = peers.some(peer => (key !== undefined && peer.hostKey === key)
146
+ || (name !== undefined && (short(peer.name) === name || short(peer.address) === name)));
147
+ return { computers: peers.map(peer => peer.name), knowsCaller };
148
+ }
149
+ async function probePeer(peer, caller) {
150
+ const started = Date.now();
151
+ const query = new URLSearchParams({ name: caller.name, ...(caller.hostKey ? { hostKey: caller.hostKey } : {}) });
152
+ try {
153
+ let listsBack = null;
154
+ let version;
155
+ try {
156
+ const answer = await peerRequest(peer, `/v1/health/peers?${query}`, undefined, PEER_TIMEOUT_MS);
157
+ listsBack = answer.knowsCaller === true;
158
+ if (typeof answer.version === "string")
159
+ version = answer.version;
160
+ }
161
+ catch (error) {
162
+ // A Hook from before /v1/health/peers still proves it is reachable.
163
+ if (!(error instanceof BridgeError && error.status === 404))
164
+ throw error;
165
+ const answer = await peerRequest(peer, "/v1/health", undefined, Math.max(1_000, PEER_TIMEOUT_MS - (Date.now() - started)));
166
+ if (typeof answer.version === "string")
167
+ version = answer.version;
168
+ }
169
+ return { name: peer.name, reachable: true, ms: Date.now() - started, listsBack, ...(version ? { version } : {}) };
170
+ }
171
+ catch (error) {
172
+ const reason = error instanceof BridgeError && error.status === 504 ? "No answer within 5 seconds."
173
+ : error instanceof Error ? error.message : "Unreachable.";
174
+ return { name: peer.name, reachable: false, ms: Date.now() - started, error: plainError(reason), listsBack: null };
175
+ }
176
+ }
177
+ export function canaryFile(root = bridgeRoot()) { return path.join(root, "canary.json"); }
178
+ export async function readCanary(root = bridgeRoot()) {
179
+ try {
180
+ const info = await lstat(canaryFile(root));
181
+ if (!info.isFile() || info.size > 65_536)
182
+ return null;
183
+ const value = JSON.parse(await readFile(canaryFile(root), "utf8"));
184
+ return value && value.version === 1 && Array.isArray(value.steps) ? value : null;
185
+ }
186
+ catch {
187
+ return null;
188
+ }
189
+ }
190
+ async function pushConfigured() {
191
+ const file = process.env.PHREN_APNS_CONFIG || path.join(bridgeRoot(), "apns.json");
192
+ const info = await lstat(file).catch(() => undefined);
193
+ return { configured: !!info?.isFile() };
194
+ }
195
+ /** Everything a person needs to tell whether phren is healthy on this computer.
196
+ * Bounded: versions are cached, each peer probe stops at 5 seconds, and nothing
197
+ * here returns a secret, a file's contents or a store path. */
198
+ export async function healthDetails(options) {
199
+ const name = hostname();
200
+ const hostKey = await ownHostKey();
201
+ const peersPromise = (async () => {
202
+ let peers;
203
+ try {
204
+ peers = await hookPeers();
205
+ }
206
+ catch (error) {
207
+ if (error instanceof BridgeError && error.status === 409 && /Configure peers/.test(error.message))
208
+ return { configured: false, computers: [] };
209
+ return { configured: true, error: plainError(error instanceof Error ? error.message : "hooks.yaml could not be read."), computers: [] };
210
+ }
211
+ return { configured: true, computers: await Promise.all(peers.map(peer => probePeer(peer, { name, hostKey }))) };
212
+ })();
213
+ const [versions, stores, lastRun, peers, canary, push] = await Promise.all([
214
+ Promise.all([
215
+ Promise.resolve(options.hookVersion ? { tool: "hook", status: "ok", version: options.hookVersion } : { tool: "hook", status: "missing", detail: "Phren Hook is not running." }),
216
+ ...["herdr", "claude", "codex", "copilot", "opencode"].map(tool => toolVersion(tool)),
217
+ ]),
218
+ storeSync(options.store),
219
+ lastScheduledRun(options.store),
220
+ peersPromise,
221
+ readCanary(),
222
+ options.push ? Promise.resolve(options.push) : pushConfigured(),
223
+ ]);
224
+ return {
225
+ product: "phren-hook", computer: { name, ...(options.computerId ? { id: options.computerId } : {}) }, checkedAt: new Date().toISOString(),
226
+ versions, stores,
227
+ schedules: { running: options.scheduler ? options.scheduler.running : null,
228
+ ...(options.scheduler?.lastTickAt ? { lastTickAt: options.scheduler.lastTickAt.toISOString() } : {}), lastRun },
229
+ peers, push, canary,
230
+ };
231
+ }
232
+ /** Plain lines for `phren status`. */
233
+ export function formatHealth(health, color) {
234
+ const { dim, reset, red, yellow, green } = color;
235
+ const lines = [];
236
+ lines.push(` ${dim}versions${reset} ${health.versions.map(item => `${item.tool} ${item.status === "ok" ? item.version : item.status === "missing" ? `${dim}${item.tool === "hook" ? "not running" : "not installed"}${reset}` : `${yellow}?${reset}`}`).join(" · ")}`);
237
+ for (const store of health.stores) {
238
+ const counts = store.ahead !== undefined ? ` ${store.ahead} ahead, ${store.behind} behind${store.upstream ? ` ${dim}${store.upstream}${reset}` : ""}` : store.branch ? ` ${dim}no upstream${reset}` : "";
239
+ lines.push(` ${dim}sync${reset} ${store.name}${store.branch ? ` ${dim}(${store.branch})${reset}` : ""}${counts}${store.lastPushStatus ? ` · last ${store.lastPushStatus}` : ""}`);
240
+ if (store.error)
241
+ lines.push(` ${store.degraded ? red : yellow}! ${store.error}${reset}`);
242
+ }
243
+ const run = health.schedules.lastRun;
244
+ lines.push(` ${dim}schedule${reset} ${run ? `${run.name ?? "a schedule"} in ${run.project}: ${run.status === "failed" ? `${red}failed${reset}` : run.status} ${dim}${run.startedAt}${reset}${run.reason ? ` · ${run.reason}` : ""}` : `${dim}no runs yet${reset}`}`);
245
+ if (!health.peers.configured)
246
+ lines.push(` ${dim}peers${reset} ${dim}none enrolled${reset}`);
247
+ else if (health.peers.error)
248
+ lines.push(` ${dim}peers${reset} ${red}${health.peers.error}${reset}`);
249
+ for (const peer of health.peers.computers) {
250
+ const state = !peer.reachable ? `${red}unreachable${reset} ${dim}${peer.error ?? ""}${reset}`
251
+ : peer.listsBack === false ? `${yellow}one-way${reset} ${dim}(${peer.name} does not list this computer)${reset}` : `${green}ok${reset} ${dim}${peer.ms} ms${reset}`;
252
+ lines.push(` ${dim}peer${reset} ${peer.name} ${state}`);
253
+ }
254
+ lines.push(` ${dim}push${reset} ${health.push.configured ? `${green}configured${reset}` : `${dim}not configured${reset}`}`);
255
+ if (health.canary) {
256
+ const failed = health.canary.steps.filter(step => step.status === "failed");
257
+ lines.push(` ${dim}canary${reset} ${health.canary.ok ? `${green}passed${reset}` : `${red}failed${reset}`} ${dim}${health.canary.startedAt}${reset}${failed.length ? ` · ${failed.map(step => `${step.name}: ${step.reason}`).join("; ")}` : ""}`);
258
+ }
259
+ return lines;
260
+ }
@@ -1,12 +1,85 @@
1
- import { type Json, type Target } from "./protocol.js";
1
+ import { BridgeError, type Json, type Target, type StartingTarget } from "./protocol.js";
2
2
  export declare function herdrRoot(): string;
3
- export declare function herdrSocket(server: string): string;
3
+ /** The Herdr pane this process runs in, from the variables Herdr sets for
4
+ * every pane: the server its socket belongs to plus the pane's ids. */
5
+ export declare function herdrPaneFromEnv(env?: NodeJS.ProcessEnv): {
6
+ server: string;
7
+ workspace: string;
8
+ tab: string;
9
+ pane: string;
10
+ } | undefined;
11
+ /** A socket failure keeps its errno so "not running", "stale socket" and "permissions" stay distinct. */
12
+ export declare function herdrSocketError(error: Error): BridgeError;
13
+ /**
14
+ * For pane reads whose callers treat text as optional: the caller still gets
15
+ * nothing, but the reason is logged once per target (again only if it changes).
16
+ */
17
+ export declare function noteOptionalReadFailure(what: string, key: string, error: unknown): void;
4
18
  /** Herdr's documented newline JSON socket API. No shell, UI focus, or inherited caller context. */
5
- export declare function rpc(server: string, method: string, params?: Json, signal?: AbortSignal): Promise<Json>;
19
+ export declare function rpc(server: string, method: string, params?: Json, signal?: AbortSignal, timeoutMs?: number): Promise<Json>;
20
+ /** How long the activity timer reuses the list of running Herdr servers
21
+ * before pinging every server directory again. */
22
+ export declare const SERVER_LIST_REUSE_MS: number;
23
+ /** The running servers, reusing a list at most `maxAgeMs` old. For
24
+ * background work only: a route that answers the phone calls `servers()`. */
25
+ export declare function recentServers(maxAgeMs?: number): Promise<Json[]>;
6
26
  export declare function servers(): Promise<Json[]>;
27
+ /** How old a shared `session.snapshot` may be for readers that poll: open
28
+ * chat and status streams and the activity timer. The overview and every
29
+ * action take a fresh one, which the pollers then reuse. */
30
+ export declare const SNAPSHOT_SHARE_MS: number;
31
+ /** A fresh snapshot. Its answer also becomes the shared one, so pollers reuse it. */
7
32
  export declare function snapshot(server: string): Promise<Json>;
8
- export declare function workspaceSnapshot(s: Json): Json;
9
- export declare function paneIdentity(server: string, pane: Json): Promise<string | undefined>;
33
+ /**
34
+ * One `session.snapshot` per server shared by every poller: an answer less
35
+ * than `maxAgeMs` old is reused and concurrent callers join the request in
36
+ * flight, so N open chats cost one snapshot per window, not one each, and
37
+ * reuse the overview's when it is recent enough. A pane that disappears or changes identity shows in the next
38
+ * snapshot, at most `maxAgeMs` after the change. Failures are never kept.
39
+ * Anything about to act on a pane (a send, a key, a launch) calls `snapshot`.
40
+ */
41
+ export declare function sharedSnapshot(server: string, maxAgeMs?: number): Promise<Json>;
42
+ /**
43
+ * Every pane on the running servers, from snapshots already held and no older
44
+ * than `maxAgeMs`, without asking Herdr; undefined unless the server list is
45
+ * known and every listed server has such a snapshot.
46
+ */
47
+ export declare function knownPanes(maxAgeMs: number): Json[] | undefined;
48
+ /** For tests: forget every shared snapshot and the server list. */
49
+ export declare function resetSharedHerdrState(): void;
50
+ /** The agent's Herdr name. Newer Herdr keeps it in `agents[].name` rather
51
+ * than on the pane (`agent_name`); read either. */
52
+ export declare function paneAgentName(s: Json, pane: Json | undefined): string | undefined;
53
+ /** Every agent name in use on a server, in either Herdr shape. */
54
+ export declare function agentNames(s: Json): Set<string>;
55
+ /** A pane's place in a snapshot, and optionally the agent that must be running in it. */
56
+ export interface PaneAddress {
57
+ workspace: string;
58
+ tab: string;
59
+ pane: string;
60
+ source?: string;
61
+ }
62
+ /** The snapshot's pane at `address`; with a `source`, only while that agent runs there. */
63
+ export declare function findPane(s: Json, address: PaneAddress): Json | undefined;
64
+ /** A conductor's Herdr name: "conductor", or "conductor-" plus its label. */
65
+ export declare function isConductorName(name: string | undefined): boolean;
66
+ export declare function workspaceSnapshot(s: Json, contextUsedPercent?: ReadonlyMap<Json, number>, approvalPanes?: ReadonlySet<string>, lastChanged?: ReadonlyMap<string, string>): Json;
67
+ export declare function paneIdentity(server: string, pane: Json, fresh?: boolean): Promise<string | undefined>;
68
+ /** Bind first-send permission to the actual terminal/process, never a cwd or
69
+ * a guessed conversation. Tokens expire naturally when the Hook/process restarts. */
70
+ export declare function paneChatState(server: string, pane: Json, options?: {
71
+ tokenWhenIdentified?: boolean;
72
+ }): Promise<Json>;
10
73
  export declare function panes(server: string, workspace: string, tab: string): Promise<Json>;
11
- export declare function validateTarget(target: Target, sending?: boolean): Promise<Json>;
74
+ /** The pane a starting target names, if its terminal/process binding still
75
+ * holds. Status is not checked here: a starting agent's first prompt (folder
76
+ * trust, a login) is exactly what the phone answers with a key. */
77
+ export declare function startingPane(target: StartingTarget): Promise<Json>;
78
+ export declare function validateStartingTarget(target: StartingTarget): Promise<Json>;
79
+ /**
80
+ * The target's pane, only while it still runs the target's conversation.
81
+ * `sharedWithinMs` lets a poller (a stream tick) accept a shared snapshot up
82
+ * to that old; sends, keys and every other mutation keep a fresh one.
83
+ */
84
+ export declare function validateTarget(target: Target, sending?: boolean, refreshIdentity?: boolean, sharedWithinMs?: number): Promise<Json>;
12
85
  export declare function trustedDirectory(pane: Json): Promise<string>;