@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,319 @@
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 } 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
+ async recent(projectValue, directoryValue) {
111
+ const project = projectSchema.parse(projectValue ?? "");
112
+ const result = await (await requireCodePackage(this.store)).recentSymbols(this.store, project, optionalPath(directoryValue));
113
+ if (!result.available)
114
+ throw noIndex(project);
115
+ return { project, entries: result.value };
116
+ }
117
+ /** Turns code intelligence off for a project: its index is deleted, and
118
+ * the reindexer follows only projects that have one, so nothing rebuilds it
119
+ * until the phone turns it on again. */
120
+ async disable(projectValue) {
121
+ const project = projectSchema.parse(projectValue ?? "");
122
+ const { codeDatabasePath } = await requireCodePackage(this.store);
123
+ const file = codeDatabasePath(this.store, project);
124
+ await Promise.all([file, `${file}-journal`, `${file}-wal`, `${file}-shm`].map(path => rm(path, { force: true })));
125
+ return { project, disabled: true };
126
+ }
127
+ async reindex(projectValue) {
128
+ const project = projectSchema.parse(projectValue ?? "");
129
+ await indexProject(this.store, project);
130
+ return this.status(project);
131
+ }
132
+ async outline(projectValue, pathValue) {
133
+ const project = projectSchema.parse(projectValue ?? "");
134
+ const file = pathSchema.parse(pathValue ?? "");
135
+ const result = await (await requireCodePackage(this.store)).outline(this.store, project, file);
136
+ if (!result.available)
137
+ throw noIndex(project);
138
+ return { project, path: file, entries: result.value };
139
+ }
140
+ /** Resolved uses made from one file, with the declaration each names, so the
141
+ * phone's code viewer can make those identifiers tappable. */
142
+ async fileReferences(projectValue, pathValue) {
143
+ const project = projectSchema.parse(projectValue ?? "");
144
+ const file = relativePathSchema.parse(pathValue ?? "");
145
+ const code = await requireCodePackage(this.store);
146
+ if (typeof code.fileReferences !== "function")
147
+ throw new BridgeError(503, "Update @phren/code to make identifiers tappable.");
148
+ const result = await code.fileReferences(this.store, project, file);
149
+ if (!result.available)
150
+ throw noIndex(project);
151
+ return { project, path: file, references: result.value };
152
+ }
153
+ async outlineSummary(projectValue, pathsValue) {
154
+ const project = projectSchema.parse(projectValue ?? "");
155
+ let raw;
156
+ try {
157
+ raw = JSON.parse(pathsValue ?? "[]");
158
+ }
159
+ catch {
160
+ throw new BridgeError(400, "Choose valid paths.");
161
+ }
162
+ const paths = z.array(pathSchema.refine(value => !path.isAbsolute(value) && !path.win32.isAbsolute(value)
163
+ && !value.split(/[\\/]/).includes(".."))).min(1).max(200).parse(raw);
164
+ const result = await (await requireCodePackage(this.store)).outlineSummary(this.store, project, [...new Set(paths)]);
165
+ if (!result.available)
166
+ throw noIndex(project);
167
+ return { project, entries: result.value };
168
+ }
169
+ async definition(projectValue, symbolValue) {
170
+ const project = projectSchema.parse(projectValue ?? "");
171
+ const symbol = symbolSchema.parse(symbolValue ?? "");
172
+ const result = await (await requireCodePackage(this.store)).definition(this.store, project, symbol);
173
+ if (!result.available)
174
+ throw noIndex(project);
175
+ if (!result.value)
176
+ throw new BridgeError(404, `No symbol "${symbol}" in ${project}.`);
177
+ return { project, definition: { ...result.value, findings: (await requireCodePackage(this.store)).findingsCitingSymbol(this.store, project, (await requireCodePackage(this.store)).citationSymbolName(result.value.symbol)) } };
178
+ }
179
+ async references(projectValue, symbolValue, limitValue) {
180
+ const project = projectSchema.parse(projectValue ?? "");
181
+ const symbol = symbolSchema.parse(symbolValue ?? "");
182
+ const limit = limitValue === null || limitValue === "" ? undefined : limitSchema.parse(limitValue);
183
+ const result = await (await requireCodePackage(this.store)).references(this.store, project, symbol, limit ?? 200);
184
+ if (!result.available)
185
+ throw noIndex(project);
186
+ if (!result.value)
187
+ throw new BridgeError(404, `No symbol "${symbol}" in ${project}.`);
188
+ return { project, references: result.value };
189
+ }
190
+ async usage(projectValue, topValue) {
191
+ const project = projectSchema.parse(projectValue ?? "");
192
+ const top = topValue === null || topValue === "" ? undefined : topSchema.parse(topValue);
193
+ const result = await (await requireCodePackage(this.store)).usage(this.store, project, top ?? 10);
194
+ if (!result.available)
195
+ throw noIndex(project);
196
+ return { project, usage: { hot: result.value.top, cold: result.value.bottom } };
197
+ }
198
+ }
199
+ /**
200
+ * Re-indexes a project when the git module's change capture records a file
201
+ * event inside it. The Hook only constructs this while the `code` module is on,
202
+ * and only projects that already have an index are followed. A branch switch
203
+ * (the repository's HEAD moved) upgrades the pending run to a full re-index.
204
+ */
205
+ export class CodeReindexer {
206
+ store;
207
+ index;
208
+ log;
209
+ debounceMs;
210
+ timers = new Map();
211
+ pendingFull = new Set();
212
+ running = new Set();
213
+ rerun = new Set();
214
+ heads = new Map();
215
+ closed = false;
216
+ constructor(options) {
217
+ this.store = options.store;
218
+ this.index = options.index ?? indexProject;
219
+ this.log = options.log ?? (line => logger.info("code", line));
220
+ this.debounceMs = options.debounceMs ?? 500;
221
+ }
222
+ /** One recorded change event; schedules an incremental re-index of the project it belongs to. */
223
+ record(files) {
224
+ if (this.closed || files.length === 0)
225
+ return;
226
+ void this.recordAsync(files).catch(error => this.log(errorMessage(error)));
227
+ }
228
+ async recordAsync(files) {
229
+ const projects = await this.indexedProjects();
230
+ if (this.closed)
231
+ return;
232
+ for (const root of new Set(files.map(file => file.root))) {
233
+ const project = projects.find(entry => entry.root === root);
234
+ if (!project)
235
+ continue;
236
+ const head = readHead(root);
237
+ const previous = this.heads.get(root);
238
+ if (head !== undefined)
239
+ this.heads.set(root, head);
240
+ this.schedule(project.project, previous !== undefined && head !== undefined && previous !== head);
241
+ }
242
+ }
243
+ close() {
244
+ this.closed = true;
245
+ for (const timer of this.timers.values())
246
+ clearTimeout(timer);
247
+ this.timers.clear();
248
+ this.rerun.clear();
249
+ this.pendingFull.clear();
250
+ }
251
+ async indexedProjects() {
252
+ const { codeDatabasePath, resolveRepoRoot } = await requireCodePackage(this.store);
253
+ const result = [];
254
+ for (const directory of getProjectDirs(this.store)) {
255
+ const project = path.basename(directory);
256
+ if (!fs.existsSync(codeDatabasePath(this.store, project)))
257
+ continue;
258
+ try {
259
+ result.push({ project, root: fs.realpathSync(resolveRepoRoot(this.store, project)) });
260
+ }
261
+ catch { /* No checkout for this project on this computer. */ }
262
+ }
263
+ return result;
264
+ }
265
+ schedule(project, full) {
266
+ if (this.closed)
267
+ return;
268
+ if (full)
269
+ this.pendingFull.add(project);
270
+ const existing = this.timers.get(project);
271
+ if (existing)
272
+ clearTimeout(existing);
273
+ const timer = setTimeout(() => { this.timers.delete(project); void this.run(project); }, this.debounceMs);
274
+ timer.unref?.();
275
+ this.timers.set(project, timer);
276
+ }
277
+ async run(project) {
278
+ if (this.closed)
279
+ return;
280
+ // A run already in flight: let it finish, then take the newest event.
281
+ if (this.running.has(project)) {
282
+ this.rerun.add(project);
283
+ return;
284
+ }
285
+ const full = this.pendingFull.delete(project);
286
+ this.running.add(project);
287
+ try {
288
+ const result = await this.index(this.store, project, { full });
289
+ this.log(`re-indexed ${project}${full ? " (full)" : ""}: ${result.parsed} parsed, ${result.symbols} symbols, ${result.durationMs} ms`);
290
+ }
291
+ catch (error) {
292
+ this.log(`re-index of ${project} failed: ${errorMessage(error)}`);
293
+ }
294
+ finally {
295
+ this.running.delete(project);
296
+ if (this.rerun.delete(project))
297
+ this.schedule(project, false);
298
+ }
299
+ }
300
+ }
301
+ /** HEAD of the repository root, for branch-switch detection. A linked worktree's
302
+ * `.git` is a file that points at its real git directory. */
303
+ function readHead(root) {
304
+ try {
305
+ const dotGit = path.join(root, ".git");
306
+ const gitDirectory = fs.statSync(dotGit).isDirectory()
307
+ ? dotGit
308
+ : (() => {
309
+ const match = /^gitdir:\s*(.+)$/m.exec(fs.readFileSync(dotGit, "utf8"));
310
+ return match ? path.resolve(root, match[1]) : undefined;
311
+ })();
312
+ if (!gitDirectory)
313
+ return undefined;
314
+ return fs.readFileSync(path.join(gitDirectory, "HEAD"), "utf8").trim();
315
+ }
316
+ catch {
317
+ return undefined;
318
+ }
319
+ }
@@ -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>;