@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
package/dist/ui/server.js CHANGED
@@ -1,3 +1,6 @@
1
+ import { nonInteractiveGitEnv } from "../utils-helpers.js";
2
+ import { moduleSnapshot } from "../modules/runtime.js";
3
+ import { disabledHint } from "../modules/registry.js";
1
4
  import * as http from "http";
2
5
  import * as crypto from "crypto";
3
6
  import { timingSafeEqual } from "crypto";
@@ -29,6 +32,7 @@ import { logger } from "../logger.js";
29
32
  import { addNote, editNote, listNotes, removeNote } from "../data/notes.js";
30
33
  import { promoteNote } from "../core/note.js";
31
34
  import { FINDING_TYPES } from "../shared.js";
35
+ import { storeCommitMessage } from "../machine-identity.js";
32
36
  const CSRF_TOKEN_TTL_MS = 15 * 60 * 1000;
33
37
  const MAX_FORM_BODY_BYTES = 1_048_576;
34
38
  const WEB_UI_READY_ATTEMPTS = 12;
@@ -310,6 +314,21 @@ function jsonErr(res, error, status = 200) {
310
314
  res.writeHead(status, { "content-type": "application/json" });
311
315
  res.end(JSON.stringify({ ok: false, error }));
312
316
  }
317
+ function handleRequestError(res, err) {
318
+ if (res.destroyed || res.writableEnded)
319
+ return;
320
+ if (res.headersSent) {
321
+ res.destroy();
322
+ return;
323
+ }
324
+ if (err instanceof URIError) {
325
+ jsonErr(res, "Invalid URL encoding", 400);
326
+ }
327
+ else {
328
+ logger.debug("web-ui", `request failed: ${errorMessage(err)}`);
329
+ jsonErr(res, "Internal server error", 500);
330
+ }
331
+ }
313
332
  function withPostBody(req, res, url, ctx, handler) {
314
333
  void readFormBody(req, res).then((parsed) => {
315
334
  if (!parsed)
@@ -319,7 +338,7 @@ function withPostBody(req, res, url, ctx, handler) {
319
338
  if (!requireCsrf(res, parsed, ctx.csrfTokens, true))
320
339
  return;
321
340
  handler(parsed);
322
- });
341
+ }).catch((err) => handleRequestError(res, err));
323
342
  }
324
343
  // ── GET handlers ──────────────────────────────────────────────────────────────
325
344
  function handleGetHome(res, ctx) {
@@ -430,7 +449,7 @@ function handleGetProjectContent(res, url, ctx) {
430
449
  const file = String(qs.file || "");
431
450
  if (!project || !isValidProjectName(project) || !file)
432
451
  return jsonErr(res, "Invalid project or file", 400);
433
- const allowedFiles = [FINDINGS_FILENAME, TASKS_FILENAME, "CLAUDE.md", "summary.md"];
452
+ const allowedFiles = [FINDINGS_FILENAME, TASKS_FILENAME, "AGENTS.md", "summary.md"];
434
453
  if (!allowedFiles.includes(file))
435
454
  return jsonErr(res, `File not allowed: ${file}`, 400);
436
455
  const basePath = resolveProjectBasePath(ctx.phrenPath, project);
@@ -579,7 +598,7 @@ function handleGetSettings(res, url, ctx) {
579
598
  diskPath: projConfig.sourcePath || projectDir, ownership: projConfig.ownership || "default",
580
599
  configFile, configExists: fs.existsSync(configFile), hasFindings: fs.existsSync(findingsPath),
581
600
  hasTasks: fs.existsSync(taskPath), hasSummary: fs.existsSync(path.join(projectDir, "summary.md")),
582
- hasClaudeMd: fs.existsSync(path.join(projectDir, "CLAUDE.md")), findingCount, taskCount,
601
+ hasClaudeMd: fs.existsSync(path.join(projectDir, "AGENTS.md")), findingCount, taskCount,
583
602
  };
584
603
  }
585
604
  const indexPolicy = getIndexPolicy(ctx.phrenPath);
@@ -660,15 +679,32 @@ function handlePostSync(req, res, url, ctx) {
660
679
  const message = String(parsed.message || "update phren");
661
680
  try {
662
681
  const EXEC_TIMEOUT = 15_000;
663
- const runGit = (args) => execFileSync("git", args, { cwd: ctx.phrenPath, encoding: "utf8", timeout: EXEC_TIMEOUT }).trim();
682
+ const runGit = (args) => execFileSync("git", args, { env: nonInteractiveGitEnv(), cwd: ctx.phrenPath, encoding: "utf8", timeout: EXEC_TIMEOUT }).trim();
664
683
  const status = runGit(["status", "--porcelain"]);
665
684
  if (!status)
666
685
  return jsonOk(res, { ok: true, message: "Nothing to sync — working tree clean." });
667
- runGit(["add", "--", "*.md", "*.json", "*.yaml", "*.yml", "*.jsonl", "*.txt"]);
686
+ // Stage each extension separately: `git add` exits 128 as soon as ONE
687
+ // pathspec matches nothing, and a normal store has no tracked .yml,
688
+ // .jsonl or .txt (.runtime/*.jsonl is gitignored, and gitignored files do
689
+ // not satisfy a pathspec). One combined add therefore failed on every
690
+ // non-clean store and the user saw a raw git fatal instead of a sync.
691
+ for (const spec of ["*.md", "*.json", "*.yaml", "*.yml", "*.jsonl", "*.txt"]) {
692
+ try {
693
+ execFileSync("git", ["add", "--", spec], {
694
+ env: nonInteractiveGitEnv(),
695
+ cwd: ctx.phrenPath,
696
+ encoding: "utf8",
697
+ timeout: EXEC_TIMEOUT,
698
+ // A non-matching pathspec is expected here; don't print git's fatal.
699
+ stdio: ["ignore", "ignore", "ignore"],
700
+ });
701
+ }
702
+ catch { /* no file with this extension */ }
703
+ }
668
704
  const stagedFiles = runGit(["diff", "--cached", "--name-only"]);
669
705
  if (!stagedFiles)
670
706
  return jsonOk(res, { ok: true, message: "Nothing to sync — no matching files to commit." });
671
- runGit(["commit", "-m", message, "--only", "--", ...stagedFiles.split("\n").filter(Boolean)]);
707
+ runGit(["commit", "-m", storeCommitMessage(message), "--only", "--", ...stagedFiles.split("\n").filter(Boolean)]);
672
708
  let pushed = false;
673
709
  try {
674
710
  if (runGit(["remote"])) {
@@ -1288,10 +1324,11 @@ export function createWebUiHttpServer(phrenPath, renderPage, profile, opts) {
1288
1324
  catch (err) {
1289
1325
  logger.debug("web-ui", `web-ui repair: ${errorMessage(err)}`);
1290
1326
  }
1327
+ const modules = moduleSnapshot(phrenPath, profile);
1291
1328
  const ctx = {
1292
1329
  phrenPath, profile, authToken: opts?.authToken, csrfTokens: opts?.csrfTokens, renderPage,
1293
1330
  };
1294
- return http.createServer(async (req, res) => {
1331
+ const handleRequest = async (req, res) => {
1295
1332
  const url = req.url || "/";
1296
1333
  const pathname = url.includes("?") ? url.slice(0, url.indexOf("?")) : url;
1297
1334
  // Home page
@@ -1307,6 +1344,9 @@ export function createWebUiHttpServer(phrenPath, renderPage, profile, opts) {
1307
1344
  // Auth gate for all GET /api/* routes
1308
1345
  if (pathname.startsWith("/api/") && req.method === "GET" && !requireGetAuth(req, res, url, ctx.authToken))
1309
1346
  return;
1347
+ if (!modules.has("tasks") && (pathname === "/api/tasks" || pathname.startsWith("/api/tasks/") || pathname === "/api/settings/task-mode")) {
1348
+ return jsonErr(res, disabledHint("tasks"), 404);
1349
+ }
1310
1350
  // ── GET routes ──
1311
1351
  if (req.method === "GET") {
1312
1352
  switch (pathname) {
@@ -1382,6 +1422,11 @@ export function createWebUiHttpServer(phrenPath, renderPage, profile, opts) {
1382
1422
  }
1383
1423
  res.writeHead(404, { "content-type": "text/plain" });
1384
1424
  res.end("Not found");
1425
+ };
1426
+ return http.createServer((req, res) => {
1427
+ // Node does not handle rejected promises from request listeners. Contain
1428
+ // malformed URI components and unexpected route failures to this request.
1429
+ void handleRequest(req, res).catch((err) => handleRequestError(res, err));
1385
1430
  });
1386
1431
  }
1387
1432
  export async function startWebUiServer(phrenPath, port, renderPage, profile, opts = {}) {
package/dist/update.js CHANGED
@@ -1,16 +1,25 @@
1
1
  import * as fs from "fs";
2
2
  import * as path from "path";
3
3
  import { execFileSync } from "child_process";
4
- import { fileURLToPath } from "url";
5
4
  import { errorMessage } from "./utils.js";
6
- import { PACKAGE_NAME, PACKAGE_SPEC } from "./package-metadata.js";
5
+ import { PACKAGE_NAME, PACKAGE_SPEC, ROOT } from "./package-metadata.js";
6
+ import { resolveEntryScript } from "./init/shared.js";
7
+ import { findPhrenPath } from "./shared.js";
7
8
  import { logger } from "./logger.js";
8
9
  function shellCommand(bin) {
9
10
  return process.platform === "win32" ? `${bin}.cmd` : bin;
10
11
  }
11
- function packageRootFromRuntime() {
12
- const current = fileURLToPath(import.meta.url);
13
- return path.resolve(path.dirname(current), "..", "..");
12
+ /**
13
+ * The source checkout this build runs from, or null for an installed package.
14
+ * The package root is packages/cli, so the monorepo root is two levels above it.
15
+ * An installed package (under node_modules) is never treated as a checkout, even
16
+ * if some directory above it happens to be a git repo.
17
+ */
18
+ function sourceCheckoutRoot() {
19
+ if (ROOT.split(path.sep).includes("node_modules"))
20
+ return null;
21
+ const repoRoot = path.resolve(ROOT, "..", "..");
22
+ return fs.existsSync(path.join(repoRoot, ".git")) ? repoRoot : null;
14
23
  }
15
24
  function run(cmd, args, cwd) {
16
25
  return execFileSync(cmd, args, {
@@ -45,16 +54,18 @@ function maybeRefreshStarter(root, builtEntry, refreshStarter) {
45
54
  return " Run `phren update --refresh-starter` to refresh global starter assets.";
46
55
  }
47
56
  run(process.execPath, [builtEntry, "init", "--apply-starter-update", "-y"], root);
48
- const cleaned = cleanupStarterRefreshArtifacts(root);
57
+ // The staged starter files live in the store, not the package.
58
+ const phrenPath = findPhrenPath();
59
+ const cleaned = phrenPath ? cleanupStarterRefreshArtifacts(phrenPath) : 0;
49
60
  return cleaned > 0
50
61
  ? ` Refreshed starter assets and cleaned ${cleaned} staged starter artifact(s).`
51
62
  : " Refreshed starter assets.";
52
63
  }
53
64
  export async function runPhrenUpdate(opts = {}) {
54
- const root = packageRootFromRuntime();
55
- const hasGit = fs.existsSync(path.join(root, ".git"));
56
- const builtEntry = path.join(root, "mcp", "dist", "index.js");
57
- if (hasGit) {
65
+ const checkout = sourceCheckoutRoot();
66
+ const root = checkout ?? ROOT;
67
+ const builtEntry = resolveEntryScript();
68
+ if (checkout) {
58
69
  try {
59
70
  // Warn if working tree is dirty (autostash handles it, but good to know)
60
71
  try {
@@ -66,7 +77,7 @@ export async function runPhrenUpdate(opts = {}) {
66
77
  catch (err) {
67
78
  logger.debug("runPhrenUpdate gitStatus", errorMessage(err));
68
79
  }
69
- const pull = run("git", ["pull", "--rebase", "--autostash"], root);
80
+ const pull = run("git", ["pull", "--ff-only", "--autostash"], root);
70
81
  run(shellCommand("npm"), ["install"], root);
71
82
  try {
72
83
  run(shellCommand("npm"), ["run", "build"], root);
package/dist/utils-fts.js CHANGED
@@ -53,6 +53,7 @@ export const STOP_WORDS = new Set([
53
53
  "other", "into", "over", "such", "only", "own", "same", "also", "back",
54
54
  "get", "got", "make", "made", "take", "like", "well", "here", "there",
55
55
  "use", "using", "used", "need", "want", "look", "help", "please",
56
+ "those", "these", "both",
56
57
  ]);
57
58
  // Extract meaningful keywords from a prompt, including bigrams (2-word noun phrases).
58
59
  // Bigrams capture intent better than isolated words (e.g., "rate limit" vs "rate" + "limit").
@@ -1,3 +1,10 @@
1
+ /**
2
+ * Git run by phren never asks a human anything. Without this, a store or
3
+ * project with an HTTPS remote and no credential helper makes git read
4
+ * "Username for 'https://github.com':" from the controlling terminal, which
5
+ * inside an agent's pane stalls the agent before its first prompt.
6
+ */
7
+ export declare const nonInteractiveGitEnv: (env?: NodeJS.ProcessEnv) => NodeJS.ProcessEnv;
1
8
  export declare function runGitOrThrow(cwd: string, args: string[], timeoutMs: number): string;
2
9
  export declare function runGit(cwd: string, args: string[], timeoutMs: number, debugLogFn?: (msg: string) => void): string | null;
3
10
  interface ResolvedExecCommand {
@@ -2,12 +2,29 @@ import * as path from "path";
2
2
  import { execFileSync, spawnSync } from "child_process";
3
3
  import { bootstrapPhrenDotEnv } from "./phren-dotenv.js";
4
4
  // ── Shared Git helper ────────────────────────────────────────────────────────
5
+ /**
6
+ * Git run by phren never asks a human anything. Without this, a store or
7
+ * project with an HTTPS remote and no credential helper makes git read
8
+ * "Username for 'https://github.com':" from the controlling terminal, which
9
+ * inside an agent's pane stalls the agent before its first prompt.
10
+ */
11
+ export const nonInteractiveGitEnv = (env = process.env) => ({
12
+ ...env,
13
+ GIT_TERMINAL_PROMPT: "0",
14
+ GCM_INTERACTIVE: "never",
15
+ // A nonempty command overrides core.askPass and inherited GUI helpers.
16
+ // Git for Windows also executes askpass commands through its bundled sh.
17
+ GIT_ASKPASS: "false",
18
+ SSH_ASKPASS: "false",
19
+ SSH_ASKPASS_REQUIRE: "force",
20
+ });
5
21
  export function runGitOrThrow(cwd, args, timeoutMs) {
6
22
  const result = spawnSync("git", args, {
7
23
  cwd,
8
24
  encoding: "utf8",
9
25
  stdio: ["ignore", "pipe", "pipe"],
10
26
  timeout: timeoutMs,
27
+ env: nonInteractiveGitEnv(),
11
28
  });
12
29
  if (result.error)
13
30
  throw result.error;
package/dist/utils.d.ts CHANGED
@@ -1,3 +1,3 @@
1
- export { runGitOrThrow, runGit, normalizeExecCommand, resolveExecCommand, errorMessage, isFeatureEnabled, clampInt, clampFloat, getOptionValue, getPositionalArgs, } from "./utils-helpers.js";
1
+ export { nonInteractiveGitEnv, runGitOrThrow, runGit, normalizeExecCommand, resolveExecCommand, errorMessage, isFeatureEnabled, clampInt, clampFloat, getOptionValue, getPositionalArgs, } from "./utils-helpers.js";
2
2
  export { isValidProjectName, safeProjectPath, queueFilePath, QUEUE_FILENAME, } from "./utils-paths.js";
3
3
  export { STOP_WORDS, extractKeywordEntries, extractKeywords, learnedSynonymsPath, loadLearnedSynonyms, loadSynonymMap, learnSynonym, removeLearnedSynonym, sanitizeFts5Query, buildRobustFtsQuery, buildRelaxedFtsQuery, buildFtsQueryVariants, } from "./utils-fts.js";
package/dist/utils.js CHANGED
@@ -1,6 +1,6 @@
1
1
  // Barrel re-export. Implementations split across utils-helpers.ts (general
2
2
  // helpers, argv parsing, exec helpers), utils-paths.ts (path validation),
3
3
  // utils-fts.ts (FTS5 query building, synonym/keyword extraction).
4
- export { runGitOrThrow, runGit, normalizeExecCommand, resolveExecCommand, errorMessage, isFeatureEnabled, clampInt, clampFloat, getOptionValue, getPositionalArgs, } from "./utils-helpers.js";
4
+ export { nonInteractiveGitEnv, runGitOrThrow, runGit, normalizeExecCommand, resolveExecCommand, errorMessage, isFeatureEnabled, clampInt, clampFloat, getOptionValue, getPositionalArgs, } from "./utils-helpers.js";
5
5
  export { isValidProjectName, safeProjectPath, queueFilePath, QUEUE_FILENAME, } from "./utils-paths.js";
6
6
  export { STOP_WORDS, extractKeywordEntries, extractKeywords, learnedSynonymsPath, loadLearnedSynonyms, loadSynonymMap, learnSynonym, removeLearnedSynonym, sanitizeFts5Query, buildRobustFtsQuery, buildRelaxedFtsQuery, buildFtsQueryVariants, } from "./utils-fts.js";
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@phren/cli",
3
- "version": "0.2.15",
4
- "description": "Knowledge layer for AI agents — CLI, MCP server, and data layer",
3
+ "version": "0.3.0",
4
+ "description": "Knowledge layer for AI agents - CLI, MCP server, and data layer",
5
5
  "type": "module",
6
6
  "bin": {
7
7
  "phren": "dist/index.js"
@@ -92,10 +92,51 @@
92
92
  "./phren-art": {
93
93
  "types": "./dist/phren-art.d.ts",
94
94
  "default": "./dist/phren-art.js"
95
+ },
96
+ "./code-host/project-config": {
97
+ "types": "./dist/project-config.d.ts",
98
+ "default": "./dist/project-config.js"
99
+ },
100
+ "./code-host/phren-paths": {
101
+ "types": "./dist/phren-paths.d.ts",
102
+ "default": "./dist/phren-paths.js"
103
+ },
104
+ "./code-host/utils": {
105
+ "types": "./dist/utils.d.ts",
106
+ "default": "./dist/utils.js"
107
+ },
108
+ "./code-host/governance/locks": {
109
+ "types": "./dist/governance/locks.d.ts",
110
+ "default": "./dist/governance/locks.js"
111
+ },
112
+ "./code-host/logger": {
113
+ "types": "./dist/logger.d.ts",
114
+ "default": "./dist/logger.js"
115
+ },
116
+ "./code-host/index-query": {
117
+ "types": "./dist/index-query.d.ts",
118
+ "default": "./dist/index-query.js"
119
+ },
120
+ "./code-host/utils-paths": {
121
+ "types": "./dist/utils-paths.d.ts",
122
+ "default": "./dist/utils-paths.js"
123
+ },
124
+ "./code-host/shared/sqljs": {
125
+ "types": "./dist/shared/sqljs.d.ts",
126
+ "default": "./dist/shared/sqljs.js"
127
+ },
128
+ "./code-host/data/access": {
129
+ "types": "./dist/data/access.d.ts",
130
+ "default": "./dist/data/access.js"
131
+ },
132
+ "./code-host/content/summarize": {
133
+ "types": "./dist/content/summarize.d.ts",
134
+ "default": "./dist/content/summarize.js"
95
135
  }
96
136
  },
97
137
  "files": [
98
138
  "dist",
139
+ "plugins",
99
140
  "starter",
100
141
  "skills",
101
142
  "scripts/preuninstall.mjs"
@@ -108,14 +149,14 @@
108
149
  "preuninstall": "node scripts/preuninstall.mjs"
109
150
  },
110
151
  "dependencies": {
111
- "@modelcontextprotocol/sdk": "^1.30.0",
152
+ "@modelcontextprotocol/sdk": "^1.30.1",
112
153
  "chalk": "^6.0.0",
113
154
  "glob": "^13.0.6",
114
- "inquirer": "^14.1.0",
115
- "js-yaml": "^5.3.0",
155
+ "inquirer": "^14.2.2",
156
+ "js-yaml": "^5.4.2",
116
157
  "sql.js-fts5": "^1.4.0",
117
158
  "ws": "8.21.3",
118
- "zod": "^4.4.3"
159
+ "zod": "^4.6.5"
119
160
  },
120
161
  "engines": {
121
162
  "node": ">=20.0.0"
@@ -136,8 +177,9 @@
136
177
  },
137
178
  "devDependencies": {
138
179
  "3d-force-graph": "^1.80.0",
180
+ "@phren/code": "workspace:*",
139
181
  "@types/ws": "8.18.1",
140
- "three": "^0.185.1"
182
+ "three": "^0.186.1"
141
183
  },
142
184
  "publishConfig": {
143
185
  "access": "public"