@phren/cli 0.2.15 → 0.3.0

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 (392) 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 +195 -2
  7. package/dist/bridge/agent-hooks.js +1049 -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 +23 -0
  15. package/dist/bridge/code-note.js +51 -0
  16. package/dist/bridge/code-routes.d.ts +151 -0
  17. package/dist/bridge/code-routes.js +442 -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 +125 -0
  33. package/dist/bridge/dispatch-returns.js +283 -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 +210 -0
  37. package/dist/bridge/dispatch.js +286 -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 +28 -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 +61 -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 +54 -0
  96. package/dist/bridge/schedule-watch.js +255 -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 +36 -0
  104. package/dist/bridge/server-pane-routes.js +479 -0
  105. package/dist/bridge/server-routes.d.ts +108 -0
  106. package/dist/bridge/server-routes.js +556 -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 +96 -0
  136. package/dist/bridge/transcript-preview.js +491 -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 +46545 -21051
  146. package/dist/cli/actions.js +14 -1
  147. package/dist/cli/config-policy.js +25 -0
  148. package/dist/cli/config-proactivity.d.ts +3 -1
  149. package/dist/cli/config-proactivity.js +35 -3
  150. package/dist/cli/config.js +4 -1
  151. package/dist/cli/extract.d.ts +0 -8
  152. package/dist/cli/extract.js +4 -7
  153. package/dist/cli/govern.js +5 -2
  154. package/dist/cli/hooks-globs.js +1 -1
  155. package/dist/cli/hooks.d.ts +1 -1
  156. package/dist/cli/hooks.js +9 -7
  157. package/dist/cli/namespaces-projects.js +12 -6
  158. package/dist/cli/namespaces-store.js +37 -6
  159. package/dist/cli/namespaces-tasks.js +1 -1
  160. package/dist/cli/schedules.d.ts +1 -0
  161. package/dist/cli/schedules.js +164 -0
  162. package/dist/cli/session-background.js +1 -1
  163. package/dist/cli/session-git.d.ts +8 -5
  164. package/dist/cli/session-git.js +45 -120
  165. package/dist/cli/session-start.js +3 -1
  166. package/dist/cli/session-stop.js +19 -8
  167. package/dist/cli/team.js +13 -10
  168. package/dist/cli-handlers.d.ts +1 -1
  169. package/dist/cli-handlers.js +8 -4
  170. package/dist/cli-help.d.ts +5 -4
  171. package/dist/cli-help.js +15 -15
  172. package/dist/cli-registry.d.ts +4 -1
  173. package/dist/cli-registry.js +119 -6
  174. package/dist/content/archive.js +2 -2
  175. package/dist/content/citation.d.ts +11 -0
  176. package/dist/content/citation.js +18 -0
  177. package/dist/content/learning.js +2 -0
  178. package/dist/content/summarize.d.ts +14 -15
  179. package/dist/content/summarize.js +60 -5
  180. package/dist/content/validate.d.ts +17 -4
  181. package/dist/content/validate.js +200 -122
  182. package/dist/core/project-registry.d.ts +26 -0
  183. package/dist/core/project-registry.js +573 -0
  184. package/dist/core/project.js +2 -3
  185. package/dist/data/access.d.ts +16 -1
  186. package/dist/data/access.js +31 -3
  187. package/dist/data/tasks.d.ts +18 -3
  188. package/dist/data/tasks.js +8 -7
  189. package/dist/entrypoint.js +44 -10
  190. package/dist/fanout/adapters/claude.d.ts +2 -0
  191. package/dist/fanout/adapters/claude.js +7 -0
  192. package/dist/fanout/adapters/codex.d.ts +2 -0
  193. package/dist/fanout/adapters/codex.js +9 -0
  194. package/dist/fanout/adapters/opencode.d.ts +4 -0
  195. package/dist/fanout/adapters/opencode.js +9 -0
  196. package/dist/fanout/adapters/types.d.ts +21 -0
  197. package/dist/fanout/adapters/types.js +3 -0
  198. package/dist/fanout/command.d.ts +2 -0
  199. package/dist/fanout/command.js +78 -0
  200. package/dist/fanout/launcher.d.ts +27 -0
  201. package/dist/fanout/launcher.js +156 -0
  202. package/dist/fanout/opencode-serve.d.ts +24 -0
  203. package/dist/fanout/opencode-serve.js +191 -0
  204. package/dist/fanout/picker.d.ts +91 -0
  205. package/dist/fanout/picker.js +51 -0
  206. package/dist/fanout/usage.d.ts +5 -0
  207. package/dist/fanout/usage.js +51 -0
  208. package/dist/fanout/watchdog.d.ts +10 -0
  209. package/dist/fanout/watchdog.js +27 -0
  210. package/dist/filenames.d.ts +9 -0
  211. package/dist/filenames.js +11 -0
  212. package/dist/finding/context.js +4 -22
  213. package/dist/generated/memory-ui-graph.browser.js +525 -419
  214. package/dist/governance/policy-constants.d.ts +11 -0
  215. package/dist/governance/policy-constants.js +9 -0
  216. package/dist/governance/policy.d.ts +5 -8
  217. package/dist/governance/policy.js +11 -8
  218. package/dist/graph-core/camera.d.ts +24 -0
  219. package/dist/graph-core/camera.js +18 -0
  220. package/dist/graph-core/index.d.ts +2 -0
  221. package/dist/graph-core/index.js +2 -0
  222. package/dist/graph-core/labels.d.ts +77 -0
  223. package/dist/graph-core/labels.js +124 -0
  224. package/dist/graph-core/model.d.ts +13 -0
  225. package/dist/graph-core/model.js +33 -0
  226. package/dist/graph-core/types.d.ts +2 -0
  227. package/dist/home-paths.d.ts +7 -0
  228. package/dist/home-paths.js +21 -0
  229. package/dist/hooks.d.ts +3 -15
  230. package/dist/hooks.js +14 -1
  231. package/dist/index.js +24 -2
  232. package/dist/init/guard-globals.d.ts +1 -1
  233. package/dist/init/guard-globals.js +4 -4
  234. package/dist/init/init-configure.js +3 -3
  235. package/dist/init/init-uninstall.js +15 -5
  236. package/dist/init/init-walkthrough.js +1 -1
  237. package/dist/init/init.js +26 -6
  238. package/dist/init/management-preset.d.ts +1 -1
  239. package/dist/init/management-preset.js +2 -2
  240. package/dist/init/preferences.js +1 -1
  241. package/dist/init/self-wiring.js +1 -1
  242. package/dist/init/setup.d.ts +3 -26
  243. package/dist/init/setup.js +68 -593
  244. package/dist/init/shared.js +2 -0
  245. package/dist/init/store-gitignore.d.ts +1 -6
  246. package/dist/init/store-gitignore.js +2 -8
  247. package/dist/init/teardown.d.ts +1 -1
  248. package/dist/init/teardown.js +2 -2
  249. package/dist/link/context-imports.d.ts +15 -0
  250. package/dist/link/context-imports.js +101 -0
  251. package/dist/link/context.js +1 -1
  252. package/dist/link/doctor.d.ts +22 -1
  253. package/dist/link/doctor.js +128 -58
  254. package/dist/link/link.js +29 -61
  255. package/dist/link/refresh.js +2 -2
  256. package/dist/link/skills.js +26 -5
  257. package/dist/machine-identity.d.ts +3 -0
  258. package/dist/machine-identity.js +6 -0
  259. package/dist/mcp/profile.d.ts +2 -19
  260. package/dist/mcp/profile.js +64 -22
  261. package/dist/memory-ui-graph.runtime.js +525 -419
  262. package/dist/modules/code-package.d.ts +16 -0
  263. package/dist/modules/code-package.js +160 -0
  264. package/dist/modules/command.d.ts +2 -0
  265. package/dist/modules/command.js +67 -0
  266. package/dist/modules/config.d.ts +4 -0
  267. package/dist/modules/config.js +70 -0
  268. package/dist/modules/manifest.d.ts +41 -0
  269. package/dist/modules/manifest.js +1 -0
  270. package/dist/modules/provision.d.ts +3 -0
  271. package/dist/modules/provision.js +84 -0
  272. package/dist/modules/registry.d.ts +16 -0
  273. package/dist/modules/registry.js +250 -0
  274. package/dist/modules/runtime.d.ts +15 -0
  275. package/dist/modules/runtime.js +59 -0
  276. package/dist/package-metadata.js +10 -2
  277. package/dist/phren-dotenv.js +4 -2
  278. package/dist/phren-paths.d.ts +3 -2
  279. package/dist/phren-paths.js +4 -5
  280. package/dist/profile-store.js +43 -8
  281. package/dist/project-config.d.ts +19 -1
  282. package/dist/project-config.js +29 -3
  283. package/dist/project-topics.d.ts +1 -0
  284. package/dist/project-topics.js +13 -10
  285. package/dist/provider-adapters.js +1 -4
  286. package/dist/query-correlation.js +6 -6
  287. package/dist/session/artifacts.js +5 -5
  288. package/dist/session/checkpoints.js +5 -0
  289. package/dist/session/utils.d.ts +2 -2
  290. package/dist/session/utils.js +6 -6
  291. package/dist/shared/content.d.ts +1 -1
  292. package/dist/shared/content.js +1 -1
  293. package/dist/shared/data-utils.js +1 -1
  294. package/dist/shared/fragment-graph.d.ts +1 -1
  295. package/dist/shared/fragment-graph.js +5 -5
  296. package/dist/shared/index.js +48 -7
  297. package/dist/shared/retrieval.d.ts +18 -3
  298. package/dist/shared/retrieval.js +101 -12
  299. package/dist/shared/search-fallback.js +4 -6
  300. package/dist/shared/sqljs.d.ts +2 -0
  301. package/dist/shared/sqljs.js +4 -2
  302. package/dist/shared.d.ts +0 -1
  303. package/dist/shared.js +0 -1
  304. package/dist/shell/input.d.ts +1 -5
  305. package/dist/shell/input.js +16 -10
  306. package/dist/shell/palette.d.ts +2 -2
  307. package/dist/shell/palette.js +3 -7
  308. package/dist/shell/render.d.ts +3 -1
  309. package/dist/shell/render.js +4 -4
  310. package/dist/shell/shell.js +4 -1
  311. package/dist/shell/types.d.ts +1 -0
  312. package/dist/shell/types.js +4 -0
  313. package/dist/shell/view.d.ts +0 -4
  314. package/dist/shell/view.js +19 -27
  315. package/dist/skill/registry.js +25 -17
  316. package/dist/skill/state.d.ts +3 -0
  317. package/dist/skill/state.js +13 -7
  318. package/dist/status.js +38 -17
  319. package/dist/store-registry.d.ts +44 -18
  320. package/dist/store-registry.js +169 -60
  321. package/dist/store-weight.d.ts +1 -6
  322. package/dist/store-weight.js +4 -2
  323. package/dist/sync/auth-doctor.d.ts +8 -0
  324. package/dist/sync/auth-doctor.js +27 -0
  325. package/dist/sync/auth.d.ts +27 -0
  326. package/dist/sync/auth.js +114 -0
  327. package/dist/sync/conflict-resolve.d.ts +9 -0
  328. package/dist/sync/conflict-resolve.js +146 -0
  329. package/dist/sync/git-state.d.ts +4 -0
  330. package/dist/sync/git-state.js +49 -0
  331. package/dist/sync/outcome.d.ts +34 -0
  332. package/dist/sync/outcome.js +57 -0
  333. package/dist/sync/pull.d.ts +15 -7
  334. package/dist/sync/pull.js +84 -35
  335. package/dist/sync/store-merge.d.ts +29 -0
  336. package/dist/sync/store-merge.js +137 -0
  337. package/dist/sync/task-merge.d.ts +22 -0
  338. package/dist/sync/task-merge.js +158 -0
  339. package/dist/task/github.js +1 -1
  340. package/dist/task/lifecycle.d.ts +5 -0
  341. package/dist/task/lifecycle.js +67 -23
  342. package/dist/terminal-text.d.ts +5 -0
  343. package/dist/terminal-text.js +11 -0
  344. package/dist/test-global-setup.js +7 -0
  345. package/dist/tool-registry.d.ts +1 -1
  346. package/dist/tool-registry.js +3 -1
  347. package/dist/tools/code.d.ts +3 -0
  348. package/dist/tools/code.js +186 -0
  349. package/dist/tools/config.js +8 -0
  350. package/dist/tools/data.js +14 -7
  351. package/dist/tools/dispatch.d.ts +2 -0
  352. package/dist/tools/dispatch.js +66 -0
  353. package/dist/tools/finding.d.ts +11 -0
  354. package/dist/tools/finding.js +180 -123
  355. package/dist/tools/ops.js +5 -2
  356. package/dist/tools/search.js +21 -8
  357. package/dist/tools/session.js +21 -22
  358. package/dist/tools/tasks.js +8 -2
  359. package/dist/tools/types.d.ts +2 -2
  360. package/dist/tools/types.js +2 -2
  361. package/dist/ui/assets.js +1 -1
  362. package/dist/ui/data.js +14 -15
  363. package/dist/ui/deep-void.d.ts +1 -1
  364. package/dist/ui/deep-void.js +0 -1
  365. package/dist/ui/graph-chrome.d.ts +1 -1
  366. package/dist/ui/graph-chrome.js +51 -0
  367. package/dist/ui/page.js +5 -5
  368. package/dist/ui/scripts.js +67 -30
  369. package/dist/ui/server.js +52 -7
  370. package/dist/update.js +22 -11
  371. package/dist/utils-fts.js +1 -0
  372. package/dist/utils-helpers.d.ts +7 -0
  373. package/dist/utils-helpers.js +17 -0
  374. package/dist/utils.d.ts +1 -1
  375. package/dist/utils.js +1 -1
  376. package/package.json +49 -7
  377. package/plugins/opencode/phren-transcript.js +340 -0
  378. package/starter/README.md +4 -4
  379. package/starter/global/{CLAUDE.md → AGENTS.md} +2 -2
  380. package/starter/global/skills/conductor/SKILL.md +106 -0
  381. package/starter/global/skills/fanout/SKILL.md +20 -0
  382. package/starter/global/skills/phren-discover/SKILL.md +6 -6
  383. package/starter/global/skills/phren-init/SKILL.md +4 -4
  384. package/starter/global/skills/phren-sync/SKILL.md +3 -3
  385. package/starter/templates/frontend/reference/README.md +1 -1
  386. package/starter/templates/library/reference/README.md +1 -1
  387. package/starter/templates/monorepo/reference/README.md +1 -1
  388. package/starter/templates/python-project/reference/README.md +1 -1
  389. /package/starter/templates/frontend/{CLAUDE.md → AGENTS.md} +0 -0
  390. /package/starter/templates/library/{CLAUDE.md → AGENTS.md} +0 -0
  391. /package/starter/templates/monorepo/{CLAUDE.md → AGENTS.md} +0 -0
  392. /package/starter/templates/python-project/{CLAUDE.md → AGENTS.md} +0 -0
@@ -0,0 +1,442 @@
1
+ import { rm } from "node:fs/promises";
2
+ import * as fs from "node:fs";
3
+ import * as path from "node:path";
4
+ import { resolveAllStores } from "../store-registry.js";
5
+ import { git } from "./projects.js";
6
+ import { z } from "zod";
7
+ import { getProjectDirs } from "../shared.js";
8
+ import { CODE_PACKAGE_HINT, loadCodePackage } from "../modules/code-package.js";
9
+ const indexProject = async (store, ...args) => (await requireCodePackage(store)).indexProject(store, ...args);
10
+ import { isValidProjectName } from "../utils-paths.js";
11
+ import { errorMessage } from "../utils.js";
12
+ import { logger } from "../logger.js";
13
+ import { BridgeError, bridgeRoot } from "./protocol.js";
14
+ export async function requireCodePackage(store) {
15
+ const code = await loadCodePackage(store);
16
+ if (!code)
17
+ throw new BridgeError(503, CODE_PACKAGE_HINT);
18
+ return code;
19
+ }
20
+ /** Resolve only registered stores. Phone IDs are repository names; no client
21
+ * path can select a filesystem location. Omitting the ID supports older phones. */
22
+ export async function resolveCodeStore(base, value, write = false) {
23
+ if (!value)
24
+ return base;
25
+ const id = z.string().min(1).max(200).regex(/^[a-zA-Z0-9_.-]+(?:\/[a-zA-Z0-9_.-]+)?$/).parse(value);
26
+ const stores = resolveAllStores(base).filter(store => store.available !== false);
27
+ const matches = [];
28
+ for (const store of stores) {
29
+ const remote = store.remote ?? (await git(store.path, "config", "--get", "remote.origin.url").catch(() => "")).trim();
30
+ const repo = /github\.com[/:]([^/]+\/[^/]+?)(?:\.git)?$/.exec(remote)?.[1];
31
+ if (id === store.id || id === store.name || id.toLowerCase() === repo?.toLowerCase())
32
+ matches.push(store);
33
+ }
34
+ if (matches.length !== 1)
35
+ throw new BridgeError(404, "That store is not uniquely registered on this computer.");
36
+ if (write && matches[0].role === "readonly")
37
+ throw new BridgeError(403, "That store is read-only.");
38
+ return matches[0].path;
39
+ }
40
+ /**
41
+ * Read routes over the `code` module's local symbol index (stage 3).
42
+ *
43
+ * The phone's Code screen calls these over the Hook's HTTP pipe; each one is a
44
+ * thin JSON formatter over `code/query.ts`, so the CLI, the MCP tools and the
45
+ * phone all read the same index the same way. A project with no index is a 404
46
+ * with the command that builds one. `CodeReindexer` follows the git module's
47
+ * recorded change events and re-indexes the affected project after a short
48
+ * debounce; a branch switch (HEAD changed) forces a full re-index.
49
+ */
50
+ const KIND_VALUES = ["function", "method", "class", "struct", "enum", "interface", "type", "variable", "types"];
51
+ const projectSchema = z.string().min(1).max(100).refine(value => isValidProjectName(value), "Choose a valid project name.");
52
+ const querySchema = z.string().max(500);
53
+ const symbolSchema = z.string().min(1).max(4600);
54
+ const pathSchema = z.string().min(1).max(4096).refine(value => !value.includes("\0") && !value.split("/").includes(".."), "Choose a valid file path.");
55
+ const relativePathSchema = pathSchema.refine(value => !path.isAbsolute(value) && !path.win32.isAbsolute(value)
56
+ && !value.includes("\\") && !value.split("/").some(part => part === "." || part === ""));
57
+ const optionalPath = (value) => value ? relativePathSchema.parse(value) : undefined;
58
+ const offsetSchema = z.coerce.number().int().min(0).max(Number.MAX_SAFE_INTEGER);
59
+ const kindSchema = z.enum(KIND_VALUES);
60
+ const limitSchema = z.coerce.number().int().min(1).max(500);
61
+ const topSchema = z.coerce.number().int().min(1).max(100);
62
+ /** The 404 a route throws when the project has no index on this computer. */
63
+ function noIndex(project) {
64
+ return new BridgeError(404, `No code index for "${project}" on this computer. Build one with: phren code index ${project}`);
65
+ }
66
+ /** The phone names a project and an optional query; both are validated here. */
67
+ export class CodeRoutes {
68
+ store;
69
+ constructor(store) {
70
+ this.store = store;
71
+ }
72
+ async status(projectValue) {
73
+ const project = projectSchema.parse(projectValue ?? "");
74
+ const result = await (await requireCodePackage(this.store)).codeIndexStatus(this.store, project);
75
+ if (!result.available)
76
+ throw noIndex(project);
77
+ return result;
78
+ }
79
+ async search(projectValue, queryValue, kindValue, limitValue, directoryValue) {
80
+ const project = projectSchema.parse(projectValue ?? "");
81
+ const query = querySchema.parse(queryValue ?? "");
82
+ const kind = kindValue === null || kindValue === "" ? undefined : kindSchema.parse(kindValue);
83
+ const limit = limitValue === null || limitValue === "" ? undefined : limitSchema.parse(limitValue);
84
+ const result = await (await requireCodePackage(this.store)).search(this.store, project, query, kind, limit ?? 20, optionalPath(directoryValue));
85
+ if (!result.available)
86
+ throw noIndex(project);
87
+ return { project, query, symbols: result.value };
88
+ }
89
+ async tree(projectValue, directoryValue) {
90
+ const project = projectSchema.parse(projectValue ?? "");
91
+ const directory = optionalPath(directoryValue) ?? "";
92
+ const result = await (await requireCodePackage(this.store)).treeSummary(this.store, project, directory);
93
+ if (!result.available)
94
+ throw noIndex(project);
95
+ return { project, directory, entries: result.value };
96
+ }
97
+ async usagePage(projectValue, values = {}) {
98
+ const project = projectSchema.parse(projectValue ?? "");
99
+ const result = await (await requireCodePackage(this.store)).usagePage(this.store, project, {
100
+ kind: values.kind ? kindSchema.parse(values.kind) : undefined,
101
+ file: optionalPath(values.file), directory: optionalPath(values.directory),
102
+ offset: values.offset ? offsetSchema.parse(values.offset) : 0,
103
+ limit: values.limit ? topSchema.parse(values.limit) : 50,
104
+ end: values.end ? z.enum(["0", "1"]).parse(values.end) === "1" : false,
105
+ });
106
+ if (!result.available)
107
+ throw noIndex(project);
108
+ return { project, ...result.value };
109
+ }
110
+ /** The checkout this computer indexes for `project`, or a 404 naming the project. */
111
+ async checkout(project) {
112
+ try {
113
+ return fs.realpathSync((await requireCodePackage(this.store)).resolveRepoRoot(this.store, project));
114
+ }
115
+ catch {
116
+ throw new BridgeError(404, `${project} has no checkout on this computer.`);
117
+ }
118
+ }
119
+ async changedIn(project, added) {
120
+ const code = await requireCodePackage(this.store);
121
+ if (typeof code.changedDeclarations !== "function")
122
+ throw new BridgeError(503, "Update @phren/code to see what changed.");
123
+ const result = await code.changedDeclarations(this.store, project, new Map([...added].map(([file, lines]) => [file, [...lines].sort((a, b) => a - b)])));
124
+ if (!result.available)
125
+ throw noIndex(project);
126
+ return result.value;
127
+ }
128
+ /**
129
+ * What changed: the functions, types and variables that today's agent
130
+ * sessions edited in this project's checkout, and its last 10 commits,
131
+ * grouped by file, most recent work first. Session edits carry the line
132
+ * numbers they had when made, so a later edit to the same file can shift one.
133
+ */
134
+ async whatChanged(projectValue, now = new Date()) {
135
+ const project = projectSchema.parse(projectValue ?? "");
136
+ const root = await this.checkout(project);
137
+ const code = await requireCodePackage(this.store);
138
+ const added = new Map();
139
+ const take = (patch) => {
140
+ for (const [file, lines] of code.addedLinesByFile(patch)) {
141
+ const set = added.get(file) ?? new Set();
142
+ for (const line of lines)
143
+ set.add(line);
144
+ added.set(file, set);
145
+ }
146
+ };
147
+ const midnight = new Date(now);
148
+ midnight.setHours(0, 0, 0, 0);
149
+ const dir = path.join(bridgeRoot(), "changes");
150
+ const logs = fs.existsSync(dir) ? fs.readdirSync(dir).filter(name => name.endsWith(".jsonl")) : [];
151
+ const today = logs.map(name => ({ file: path.join(dir, name), at: fs.statSync(path.join(dir, name)).mtimeMs }))
152
+ .filter(entry => entry.at >= midnight.getTime()).sort((a, b) => b.at - a.at);
153
+ for (const log of today) {
154
+ for (const line of fs.readFileSync(log.file, "utf8").split("\n")) {
155
+ if (!line.trim())
156
+ continue;
157
+ let record;
158
+ try {
159
+ record = JSON.parse(line);
160
+ }
161
+ catch {
162
+ continue;
163
+ }
164
+ for (const file of record.files ?? []) {
165
+ if (typeof file.root !== "string" || typeof file.patch !== "string")
166
+ continue;
167
+ let same = false;
168
+ try {
169
+ same = fs.realpathSync(file.root) === root;
170
+ }
171
+ catch {
172
+ same = false;
173
+ }
174
+ if (same)
175
+ take(file.patch);
176
+ }
177
+ }
178
+ }
179
+ // A repository's first commit adds every file; it is the import, not work.
180
+ try {
181
+ take(await git(root, "-c", "log.showRoot=false", "log", "-10", "--format=", "-p", "-U0", "--no-color", "--no-ext-diff"));
182
+ }
183
+ catch { /* A checkout without commits yet has only its session edits. */ }
184
+ const items = await this.changedIn(project, added);
185
+ const files = [];
186
+ for (const item of items) {
187
+ let group = files.find(entry => entry.path === item.file);
188
+ if (!group) {
189
+ group = { path: item.file, items: [] };
190
+ files.push(group);
191
+ }
192
+ group.items.push(item);
193
+ }
194
+ return { project, files };
195
+ }
196
+ /**
197
+ * Per-file counts for the Changes tree's chips: functions and types the
198
+ * working tree changes or adds (variables stay out to keep a chip short).
199
+ * An untracked file is new throughout.
200
+ */
201
+ async changeCounts(projectValue, pathsValue) {
202
+ const project = projectSchema.parse(projectValue ?? "");
203
+ let raw;
204
+ try {
205
+ raw = JSON.parse(pathsValue ?? "[]");
206
+ }
207
+ catch {
208
+ throw new BridgeError(400, "Choose valid paths.");
209
+ }
210
+ const paths = [...new Set(z.array(relativePathSchema).min(1).max(200).parse(raw))];
211
+ const root = await this.checkout(project);
212
+ const code = await requireCodePackage(this.store);
213
+ const added = new Map();
214
+ for (const [file, lines] of code.addedLinesByFile(await git(root, "diff", "HEAD", "-U0", "--no-color", "--no-ext-diff", "--", ...paths).catch(() => "")))
215
+ added.set(file, new Set(lines));
216
+ const untracked = (await git(root, "ls-files", "--others", "--exclude-standard", "--", ...paths).catch(() => "")).split("\n").filter(Boolean);
217
+ for (const file of untracked) {
218
+ let count = 0;
219
+ try {
220
+ count = fs.readFileSync(path.join(root, file), "utf8").split("\n").length;
221
+ }
222
+ catch {
223
+ continue;
224
+ }
225
+ added.set(file, new Set(Array.from({ length: count }, (_, index) => index + 1)));
226
+ }
227
+ const items = await this.changedIn(project, added);
228
+ const entries = paths.map(file => {
229
+ const mine = items.filter(item => item.file === file || item.file.startsWith(file + "/"));
230
+ const tally = (family) => ({
231
+ changed: mine.filter(item => item.family === family && !item.isNew).length,
232
+ added: mine.filter(item => item.family === family && item.isNew).length,
233
+ });
234
+ const first = mine.find(item => item.family !== "variable");
235
+ return { path: file, functions: tally("function"), types: tally("type"),
236
+ ...(first ? { first: `${first.file}::${first.parent ? first.parent + "." : ""}${first.name}` } : {}) };
237
+ });
238
+ return { project, entries };
239
+ }
240
+ /** Turns code intelligence off for a project: its index is deleted, and
241
+ * the reindexer follows only projects that have one, so nothing rebuilds it
242
+ * until the phone turns it on again. */
243
+ async disable(projectValue) {
244
+ const project = projectSchema.parse(projectValue ?? "");
245
+ const { codeDatabasePath } = await requireCodePackage(this.store);
246
+ const file = codeDatabasePath(this.store, project);
247
+ await Promise.all([file, `${file}-journal`, `${file}-wal`, `${file}-shm`].map(path => rm(path, { force: true })));
248
+ return { project, disabled: true };
249
+ }
250
+ async reindex(projectValue) {
251
+ const project = projectSchema.parse(projectValue ?? "");
252
+ await indexProject(this.store, project);
253
+ return this.status(project);
254
+ }
255
+ async outline(projectValue, pathValue) {
256
+ const project = projectSchema.parse(projectValue ?? "");
257
+ const file = pathSchema.parse(pathValue ?? "");
258
+ const result = await (await requireCodePackage(this.store)).outline(this.store, project, file);
259
+ if (!result.available)
260
+ throw noIndex(project);
261
+ return { project, path: file, entries: result.value };
262
+ }
263
+ /** Resolved uses made from one file, with the declaration each names, so the
264
+ * phone's code viewer can make those identifiers tappable. */
265
+ async fileReferences(projectValue, pathValue) {
266
+ const project = projectSchema.parse(projectValue ?? "");
267
+ const file = relativePathSchema.parse(pathValue ?? "");
268
+ const code = await requireCodePackage(this.store);
269
+ if (typeof code.fileReferences !== "function")
270
+ throw new BridgeError(503, "Update @phren/code to make identifiers tappable.");
271
+ const result = await code.fileReferences(this.store, project, file);
272
+ if (!result.available)
273
+ throw noIndex(project);
274
+ return { project, path: file, references: result.value };
275
+ }
276
+ async outlineSummary(projectValue, pathsValue) {
277
+ const project = projectSchema.parse(projectValue ?? "");
278
+ let raw;
279
+ try {
280
+ raw = JSON.parse(pathsValue ?? "[]");
281
+ }
282
+ catch {
283
+ throw new BridgeError(400, "Choose valid paths.");
284
+ }
285
+ const paths = z.array(pathSchema.refine(value => !path.isAbsolute(value) && !path.win32.isAbsolute(value)
286
+ && !value.split(/[\\/]/).includes(".."))).min(1).max(200).parse(raw);
287
+ const result = await (await requireCodePackage(this.store)).outlineSummary(this.store, project, [...new Set(paths)]);
288
+ if (!result.available)
289
+ throw noIndex(project);
290
+ return { project, entries: result.value };
291
+ }
292
+ async definition(projectValue, symbolValue) {
293
+ const project = projectSchema.parse(projectValue ?? "");
294
+ const symbol = symbolSchema.parse(symbolValue ?? "");
295
+ const result = await (await requireCodePackage(this.store)).definition(this.store, project, symbol);
296
+ if (!result.available)
297
+ throw noIndex(project);
298
+ if (!result.value)
299
+ throw new BridgeError(404, `Nothing named "${symbol}" in ${project}.`);
300
+ return { project, definition: { ...result.value, findings: (await requireCodePackage(this.store)).findingsCitingSymbol(this.store, project, (await requireCodePackage(this.store)).citationSymbolName(result.value.symbol)) } };
301
+ }
302
+ async references(projectValue, symbolValue, limitValue) {
303
+ const project = projectSchema.parse(projectValue ?? "");
304
+ const symbol = symbolSchema.parse(symbolValue ?? "");
305
+ const limit = limitValue === null || limitValue === "" ? undefined : limitSchema.parse(limitValue);
306
+ const result = await (await requireCodePackage(this.store)).references(this.store, project, symbol, limit ?? 200);
307
+ if (!result.available)
308
+ throw noIndex(project);
309
+ if (!result.value)
310
+ throw new BridgeError(404, `Nothing named "${symbol}" in ${project}.`);
311
+ return { project, references: result.value };
312
+ }
313
+ async usage(projectValue, topValue) {
314
+ const project = projectSchema.parse(projectValue ?? "");
315
+ const top = topValue === null || topValue === "" ? undefined : topSchema.parse(topValue);
316
+ const result = await (await requireCodePackage(this.store)).usage(this.store, project, top ?? 10);
317
+ if (!result.available)
318
+ throw noIndex(project);
319
+ return { project, usage: { hot: result.value.top, cold: result.value.bottom } };
320
+ }
321
+ }
322
+ /**
323
+ * Re-indexes a project when the git module's change capture records a file
324
+ * event inside it. The Hook only constructs this while the `code` module is on,
325
+ * and only projects that already have an index are followed. A branch switch
326
+ * (the repository's HEAD moved) upgrades the pending run to a full re-index.
327
+ */
328
+ export class CodeReindexer {
329
+ store;
330
+ index;
331
+ log;
332
+ debounceMs;
333
+ timers = new Map();
334
+ pendingFull = new Set();
335
+ running = new Set();
336
+ rerun = new Set();
337
+ heads = new Map();
338
+ closed = false;
339
+ constructor(options) {
340
+ this.store = options.store;
341
+ this.index = options.index ?? indexProject;
342
+ this.log = options.log ?? (line => logger.info("code", line));
343
+ this.debounceMs = options.debounceMs ?? 500;
344
+ }
345
+ /** One recorded change event; schedules an incremental re-index of the project it belongs to. */
346
+ record(files) {
347
+ if (this.closed || files.length === 0)
348
+ return;
349
+ void this.recordAsync(files).catch(error => this.log(errorMessage(error)));
350
+ }
351
+ async recordAsync(files) {
352
+ const projects = await this.indexedProjects();
353
+ if (this.closed)
354
+ return;
355
+ for (const root of new Set(files.map(file => file.root))) {
356
+ const project = projects.find(entry => entry.root === root);
357
+ if (!project)
358
+ continue;
359
+ const head = readHead(root);
360
+ const previous = this.heads.get(root);
361
+ if (head !== undefined)
362
+ this.heads.set(root, head);
363
+ this.schedule(project.project, previous !== undefined && head !== undefined && previous !== head);
364
+ }
365
+ }
366
+ close() {
367
+ this.closed = true;
368
+ for (const timer of this.timers.values())
369
+ clearTimeout(timer);
370
+ this.timers.clear();
371
+ this.rerun.clear();
372
+ this.pendingFull.clear();
373
+ }
374
+ async indexedProjects() {
375
+ const { codeDatabasePath, resolveRepoRoot } = await requireCodePackage(this.store);
376
+ const result = [];
377
+ for (const directory of getProjectDirs(this.store)) {
378
+ const project = path.basename(directory);
379
+ if (!fs.existsSync(codeDatabasePath(this.store, project)))
380
+ continue;
381
+ try {
382
+ result.push({ project, root: fs.realpathSync(resolveRepoRoot(this.store, project)) });
383
+ }
384
+ catch { /* No checkout for this project on this computer. */ }
385
+ }
386
+ return result;
387
+ }
388
+ schedule(project, full) {
389
+ if (this.closed)
390
+ return;
391
+ if (full)
392
+ this.pendingFull.add(project);
393
+ const existing = this.timers.get(project);
394
+ if (existing)
395
+ clearTimeout(existing);
396
+ const timer = setTimeout(() => { this.timers.delete(project); void this.run(project); }, this.debounceMs);
397
+ timer.unref?.();
398
+ this.timers.set(project, timer);
399
+ }
400
+ async run(project) {
401
+ if (this.closed)
402
+ return;
403
+ // A run already in flight: let it finish, then take the newest event.
404
+ if (this.running.has(project)) {
405
+ this.rerun.add(project);
406
+ return;
407
+ }
408
+ const full = this.pendingFull.delete(project);
409
+ this.running.add(project);
410
+ try {
411
+ const result = await this.index(this.store, project, { full });
412
+ this.log(`re-indexed ${project}${full ? " (full)" : ""}: ${result.parsed} parsed, ${result.symbols} declarations, ${result.durationMs} ms`);
413
+ }
414
+ catch (error) {
415
+ this.log(`re-index of ${project} failed: ${errorMessage(error)}`);
416
+ }
417
+ finally {
418
+ this.running.delete(project);
419
+ if (this.rerun.delete(project))
420
+ this.schedule(project, false);
421
+ }
422
+ }
423
+ }
424
+ /** HEAD of the repository root, for branch-switch detection. A linked worktree's
425
+ * `.git` is a file that points at its real git directory. */
426
+ function readHead(root) {
427
+ try {
428
+ const dotGit = path.join(root, ".git");
429
+ const gitDirectory = fs.statSync(dotGit).isDirectory()
430
+ ? dotGit
431
+ : (() => {
432
+ const match = /^gitdir:\s*(.+)$/m.exec(fs.readFileSync(dotGit, "utf8"));
433
+ return match ? path.resolve(root, match[1]) : undefined;
434
+ })();
435
+ if (!gitDirectory)
436
+ return undefined;
437
+ return fs.readFileSync(path.join(gitDirectory, "HEAD"), "utf8").trim();
438
+ }
439
+ catch {
440
+ return undefined;
441
+ }
442
+ }
@@ -0,0 +1,27 @@
1
+ export declare function materializedRoot(): string;
2
+ export declare function materializedPath(session: string): string;
3
+ /** A working pane whose projection cursor stopped at an unfinished turn can
4
+ * keep accepting input even though none of it will be readable again. */
5
+ export declare function threadHealth(session: string, agentStatus: unknown): Promise<{
6
+ stalled: boolean;
7
+ since?: string;
8
+ }>;
9
+ export declare function codexThreadPreview(session: string): Promise<{
10
+ turnStartedAt: string;
11
+ text: string;
12
+ } | undefined>;
13
+ /** Bring the materialized file up to date with the store. Returns the file
14
+ * when the thread exists there, undefined otherwise. Safe to call often:
15
+ * an unchanged thread costs one aggregate query. */
16
+ export declare function materializeCodexThread(session: string): Promise<string | undefined>;
17
+ /** The pending queued question as the pane's choice shape: the asking
18
+ * sentence and one numbered option per choice (Codex answers with number
19
+ * keys once alt+up has opened the queue). Undefined when nothing answerable
20
+ * remains. */
21
+ export declare function queuedQuestion(session: string): Promise<{
22
+ title: string;
23
+ options: {
24
+ label: string;
25
+ key: string;
26
+ }[];
27
+ } | undefined>;