@phren/cli 0.2.15 → 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 (386) 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.js +1 -1
  235. package/dist/init/init.js +26 -6
  236. package/dist/init/management-preset.d.ts +1 -1
  237. package/dist/init/management-preset.js +2 -2
  238. package/dist/init/preferences.js +1 -1
  239. package/dist/init/self-wiring.js +1 -1
  240. package/dist/init/setup.d.ts +3 -26
  241. package/dist/init/setup.js +49 -588
  242. package/dist/init/shared.js +2 -0
  243. package/dist/init/store-gitignore.d.ts +1 -1
  244. package/dist/init/store-gitignore.js +2 -0
  245. package/dist/init/teardown.d.ts +1 -1
  246. package/dist/init/teardown.js +2 -2
  247. package/dist/link/context.js +1 -1
  248. package/dist/link/doctor.d.ts +22 -1
  249. package/dist/link/doctor.js +100 -54
  250. package/dist/link/link.js +29 -61
  251. package/dist/link/refresh.js +2 -2
  252. package/dist/link/skills.js +26 -5
  253. package/dist/machine-identity.d.ts +3 -0
  254. package/dist/machine-identity.js +6 -0
  255. package/dist/mcp/profile.d.ts +2 -15
  256. package/dist/mcp/profile.js +64 -9
  257. package/dist/memory-ui-graph.runtime.js +279 -283
  258. package/dist/modules/code-package.d.ts +16 -0
  259. package/dist/modules/code-package.js +152 -0
  260. package/dist/modules/command.d.ts +2 -0
  261. package/dist/modules/command.js +67 -0
  262. package/dist/modules/config.d.ts +4 -0
  263. package/dist/modules/config.js +70 -0
  264. package/dist/modules/manifest.d.ts +41 -0
  265. package/dist/modules/manifest.js +1 -0
  266. package/dist/modules/provision.d.ts +3 -0
  267. package/dist/modules/provision.js +84 -0
  268. package/dist/modules/registry.d.ts +16 -0
  269. package/dist/modules/registry.js +250 -0
  270. package/dist/modules/runtime.d.ts +15 -0
  271. package/dist/modules/runtime.js +59 -0
  272. package/dist/package-metadata.js +10 -2
  273. package/dist/phren-dotenv.js +4 -2
  274. package/dist/phren-paths.d.ts +3 -2
  275. package/dist/phren-paths.js +4 -5
  276. package/dist/profile-store.js +4 -5
  277. package/dist/project-config.d.ts +19 -1
  278. package/dist/project-config.js +29 -3
  279. package/dist/project-topics.js +4 -4
  280. package/dist/provider-adapters.js +1 -4
  281. package/dist/query-correlation.js +6 -6
  282. package/dist/session/artifacts.js +5 -5
  283. package/dist/session/checkpoints.js +5 -0
  284. package/dist/session/utils.d.ts +2 -2
  285. package/dist/session/utils.js +6 -6
  286. package/dist/shared/content.d.ts +1 -1
  287. package/dist/shared/content.js +1 -1
  288. package/dist/shared/data-utils.js +1 -1
  289. package/dist/shared/fragment-graph.d.ts +1 -1
  290. package/dist/shared/fragment-graph.js +5 -5
  291. package/dist/shared/index.js +48 -7
  292. package/dist/shared/retrieval.d.ts +18 -1
  293. package/dist/shared/retrieval.js +100 -11
  294. package/dist/shared/search-fallback.js +4 -6
  295. package/dist/shared/sqljs.d.ts +2 -0
  296. package/dist/shared/sqljs.js +4 -2
  297. package/dist/shared.d.ts +0 -1
  298. package/dist/shared.js +0 -1
  299. package/dist/shell/input.d.ts +1 -5
  300. package/dist/shell/input.js +16 -10
  301. package/dist/shell/palette.d.ts +2 -2
  302. package/dist/shell/palette.js +3 -7
  303. package/dist/shell/render.d.ts +3 -1
  304. package/dist/shell/render.js +4 -4
  305. package/dist/shell/shell.js +4 -1
  306. package/dist/shell/types.d.ts +1 -0
  307. package/dist/shell/types.js +4 -0
  308. package/dist/shell/view.d.ts +0 -4
  309. package/dist/shell/view.js +19 -27
  310. package/dist/skill/registry.js +25 -17
  311. package/dist/skill/state.d.ts +3 -0
  312. package/dist/skill/state.js +13 -7
  313. package/dist/status.js +38 -17
  314. package/dist/store-registry.d.ts +44 -18
  315. package/dist/store-registry.js +169 -60
  316. package/dist/store-weight.d.ts +1 -6
  317. package/dist/store-weight.js +4 -2
  318. package/dist/sync/auth-doctor.d.ts +8 -0
  319. package/dist/sync/auth-doctor.js +27 -0
  320. package/dist/sync/auth.d.ts +27 -0
  321. package/dist/sync/auth.js +114 -0
  322. package/dist/sync/conflict-resolve.d.ts +9 -0
  323. package/dist/sync/conflict-resolve.js +146 -0
  324. package/dist/sync/git-state.d.ts +4 -0
  325. package/dist/sync/git-state.js +49 -0
  326. package/dist/sync/outcome.d.ts +34 -0
  327. package/dist/sync/outcome.js +57 -0
  328. package/dist/sync/pull.d.ts +15 -7
  329. package/dist/sync/pull.js +84 -35
  330. package/dist/sync/store-merge.d.ts +29 -0
  331. package/dist/sync/store-merge.js +137 -0
  332. package/dist/sync/task-merge.d.ts +22 -0
  333. package/dist/sync/task-merge.js +158 -0
  334. package/dist/task/github.js +1 -1
  335. package/dist/task/lifecycle.d.ts +5 -0
  336. package/dist/task/lifecycle.js +67 -23
  337. package/dist/terminal-text.d.ts +5 -0
  338. package/dist/terminal-text.js +11 -0
  339. package/dist/test-global-setup.js +7 -0
  340. package/dist/tool-registry.d.ts +1 -1
  341. package/dist/tool-registry.js +3 -1
  342. package/dist/tools/code.d.ts +3 -0
  343. package/dist/tools/code.js +178 -0
  344. package/dist/tools/config.js +5 -0
  345. package/dist/tools/data.js +14 -7
  346. package/dist/tools/dispatch.d.ts +2 -0
  347. package/dist/tools/dispatch.js +66 -0
  348. package/dist/tools/finding.js +43 -41
  349. package/dist/tools/ops.js +5 -2
  350. package/dist/tools/search.js +21 -8
  351. package/dist/tools/session.js +21 -22
  352. package/dist/tools/tasks.js +8 -2
  353. package/dist/tools/types.d.ts +2 -2
  354. package/dist/tools/types.js +2 -2
  355. package/dist/ui/assets.js +1 -1
  356. package/dist/ui/data.js +14 -15
  357. package/dist/ui/deep-void.d.ts +1 -1
  358. package/dist/ui/deep-void.js +0 -1
  359. package/dist/ui/graph-chrome.d.ts +1 -1
  360. package/dist/ui/graph-chrome.js +51 -0
  361. package/dist/ui/page.js +5 -5
  362. package/dist/ui/scripts.js +67 -30
  363. package/dist/ui/server.js +34 -6
  364. package/dist/update.js +1 -1
  365. package/dist/utils-fts.js +1 -0
  366. package/dist/utils-helpers.d.ts +7 -0
  367. package/dist/utils-helpers.js +17 -0
  368. package/dist/utils.d.ts +1 -1
  369. package/dist/utils.js +1 -1
  370. package/package.json +45 -3
  371. package/plugins/opencode/phren-transcript.js +340 -0
  372. package/starter/README.md +4 -4
  373. package/starter/global/{CLAUDE.md → AGENTS.md} +2 -2
  374. package/starter/global/skills/conductor/SKILL.md +106 -0
  375. package/starter/global/skills/fanout/SKILL.md +20 -0
  376. package/starter/global/skills/phren-discover/SKILL.md +6 -6
  377. package/starter/global/skills/phren-init/SKILL.md +4 -4
  378. package/starter/global/skills/phren-sync/SKILL.md +3 -3
  379. package/starter/templates/frontend/reference/README.md +1 -1
  380. package/starter/templates/library/reference/README.md +1 -1
  381. package/starter/templates/monorepo/reference/README.md +1 -1
  382. package/starter/templates/python-project/reference/README.md +1 -1
  383. /package/starter/templates/frontend/{CLAUDE.md → AGENTS.md} +0 -0
  384. /package/starter/templates/library/{CLAUDE.md → AGENTS.md} +0 -0
  385. /package/starter/templates/monorepo/{CLAUDE.md → AGENTS.md} +0 -0
  386. /package/starter/templates/python-project/{CLAUDE.md → AGENTS.md} +0 -0
@@ -429,12 +429,12 @@ export async function runUninstall(opts = {}) {
429
429
  catch (err) {
430
430
  debugLog(`uninstall: cleanup failed for ${contextFile}: ${errorMessage(err)}`);
431
431
  }
432
- // Remove global CLAUDE.md symlink (created by linkGlobal -> ~/.claude/CLAUDE.md)
432
+ // Remove global AGENTS.md symlink (created by linkGlobal -> ~/.claude/CLAUDE.md)
433
433
  const globalClaudeLink = homePath(".claude", "CLAUDE.md");
434
434
  try {
435
435
  if (fs.lstatSync(globalClaudeLink).isSymbolicLink()) {
436
436
  fs.unlinkSync(globalClaudeLink);
437
- log(` Removed global CLAUDE.md symlink (${globalClaudeLink})`);
437
+ log(` Removed global AGENTS.md symlink (${globalClaudeLink})`);
438
438
  }
439
439
  }
440
440
  catch {
@@ -303,7 +303,7 @@ export async function runWalkthrough(phrenPath, options) {
303
303
  }
304
304
  else {
305
305
  log("Choose who owns repo-facing instruction files for projects you add.");
306
- log(" phren-managed: Phren may mirror CLAUDE.md / AGENTS.md into the repo");
306
+ log(" phren-managed: Phren may mirror AGENTS.md plus vendor compatibility files into the repo");
307
307
  log(" detached: Phren keeps its own docs but does not write into the repo");
308
308
  log(" repo-managed: keep the repo's existing CLAUDE/AGENTS files as canonical");
309
309
  log(" Change later: phren config project-ownership <mode>");
package/dist/init/init.js CHANGED
@@ -1,3 +1,8 @@
1
+ import { nonInteractiveGitEnv } from "../utils-helpers.js";
2
+ import { migrateInstalledModules, moduleEnabled } from "../modules/runtime.js";
3
+ import { initializeModules } from "../modules/config.js";
4
+ import { skillEnabled } from "../modules/provision.js";
5
+ import { reconcileModuleHooks } from "../bridge/install.js";
1
6
  /**
2
7
  * CLI orchestrator for phren init, mcp-mode, hooks-mode, and uninstall.
3
8
  * Delegates to focused helpers in init-config, init-setup, init-preferences,
@@ -215,6 +220,7 @@ export async function runInit(opts = {}) {
215
220
  log(`\nCloning existing phren from ${opts._walkthroughCloneUrl}...`);
216
221
  try {
217
222
  execFileSync("git", ["clone", opts._walkthroughCloneUrl, phrenPath], {
223
+ env: nonInteractiveGitEnv(),
218
224
  stdio: ["ignore", "pipe", "pipe"],
219
225
  timeout: 60_000,
220
226
  });
@@ -329,7 +335,7 @@ export async function runInit(opts = {}) {
329
335
  log(` Would offer to add current project directory (${pendingBootstrap.path})`);
330
336
  }
331
337
  if (opts.applyStarterUpdate) {
332
- log(` Apply starter template updates to global/CLAUDE.md and global skills`);
338
+ log(` Apply starter template updates to global/AGENTS.md and global skills`);
333
339
  }
334
340
  log(` Run post-init verification checks`);
335
341
  log(`\nDry run complete.\n`);
@@ -362,6 +368,12 @@ export async function runInit(opts = {}) {
362
368
  log(` Updated storage binding: ${change}`);
363
369
  }
364
370
  }
371
+ if (hasExistingInstall)
372
+ migrateInstalledModules(phrenPath);
373
+ else {
374
+ initializeModules(phrenPath);
375
+ log("Memory only. Enable what you need with phren modules enable <name>.");
376
+ }
365
377
  if (hasExistingInstall) {
366
378
  writeRootManifest(phrenPath, {
367
379
  version: 1,
@@ -381,16 +393,18 @@ export async function runInit(opts = {}) {
381
393
  log(` MCP mode: ${mcpLabel}`);
382
394
  log(` Hooks mode: ${hooksLabel}`);
383
395
  log(` Default project ownership: ${ownershipDefault}`);
384
- log(` Task mode: ${getWorkflowPolicy(phrenPath).taskMode}`);
396
+ if (moduleEnabled(phrenPath, "tasks"))
397
+ log(` Task mode: ${getWorkflowPolicy(phrenPath).taskMode}`);
385
398
  log(` Git repo: ${existingGitRepo.detail}`);
386
399
  // Always reconfigure MCP and hooks (picks up new features on upgrade)
387
400
  configureMcpTargets(phrenPath, { mcpEnabled, hooksEnabled, caps: managementCaps }, "Updated");
388
401
  configureHooksIfEnabled(phrenPath, hooksEnabled, "Updated", managementCaps);
402
+ await reconcileModuleHooks(phrenPath);
389
403
  const prefs = readInstallPreferences(phrenPath);
390
404
  const previousVersion = prefs.installedVersion;
391
405
  if (isVersionNewer(VERSION, previousVersion)) {
392
406
  log(`\n Starter template update available: v${previousVersion} -> v${VERSION}`);
393
- log(` Run \`phren init --apply-starter-update\` to refresh global/CLAUDE.md and global skills.`);
407
+ log(` Run \`phren init --apply-starter-update\` to refresh global/AGENTS.md and global skills.`);
394
408
  }
395
409
  if (opts.applyStarterUpdate) {
396
410
  const updated = applyStarterTemplateUpdates(phrenPath);
@@ -479,6 +493,10 @@ export async function runInit(opts = {}) {
479
493
  function copyDir(src, dest) {
480
494
  fs.mkdirSync(dest, { recursive: true });
481
495
  for (const entry of fs.readdirSync(src, { withFileTypes: true })) {
496
+ if (entry.name === "tasks.md" && !moduleEnabled(phrenPath, "tasks"))
497
+ continue;
498
+ if (path.basename(src) === "skills" && !skillEnabled(phrenPath, entry.name))
499
+ continue;
482
500
  const srcPath = path.join(src, entry.name);
483
501
  const destPath = path.join(dest, entry.name);
484
502
  if (entry.isDirectory()) {
@@ -525,7 +543,7 @@ export async function runInit(opts = {}) {
525
543
  });
526
544
  fs.mkdirSync(path.join(phrenPath, "global", "skills"), { recursive: true });
527
545
  fs.mkdirSync(path.join(phrenPath, "profiles"), { recursive: true });
528
- atomicWriteText(path.join(phrenPath, "global", "CLAUDE.md"), `# Global Context\n\nThis file is loaded in every project.\n\n## General preferences\n\n<!-- Your coding style, preferred tools, things Claude should always know -->\n`);
546
+ atomicWriteText(path.join(phrenPath, "global", "AGENTS.md"), `# Global Context\n\nThis file is loaded in every project.\n\n## General preferences\n\n<!-- Your coding style, preferred tools, things Claude should always know -->\n`);
529
547
  if (useTemplateProject) {
530
548
  const projectDir = path.join(phrenPath, firstProjectName);
531
549
  if (opts.template && applyTemplate(projectDir, opts.template, firstProjectName)) {
@@ -568,7 +586,8 @@ export async function runInit(opts = {}) {
568
586
  log(` MCP mode: ${mcpLabel}`);
569
587
  log(` Hooks mode: ${hooksLabel}`);
570
588
  log(` Default project ownership: ${ownershipDefault}`);
571
- log(` Task mode: ${getWorkflowPolicy(phrenPath).taskMode}`);
589
+ if (moduleEnabled(phrenPath, "tasks"))
590
+ log(` Task mode: ${getWorkflowPolicy(phrenPath).taskMode}`);
572
591
  log(` Git repo: ${localGitRepo.detail}`);
573
592
  if (repaired.removedLegacyProjects > 0) {
574
593
  log(` Removed ${repaired.removedLegacyProjects} legacy starter project entr${repaired.removedLegacyProjects === 1 ? "y" : "ies"} from profiles.`);
@@ -580,6 +599,7 @@ export async function runInit(opts = {}) {
580
599
  // Configure MCP for all detected AI coding tools and hooks
581
600
  configureMcpTargets(phrenPath, { mcpEnabled, hooksEnabled, caps: managementCaps }, "Configured");
582
601
  configureHooksIfEnabled(phrenPath, hooksEnabled, "Configured", managementCaps);
602
+ await reconcileModuleHooks(phrenPath);
583
603
  writeInstallPreferences(phrenPath, { mcpEnabled, hooksEnabled, skillsScope, installedVersion: VERSION, syncIntent });
584
604
  // Post-init verification
585
605
  log(`\nVerifying setup...`);
@@ -588,7 +608,7 @@ export async function runInit(opts = {}) {
588
608
  log(` ${check.ok ? "pass" : "FAIL"} ${check.name}: ${check.detail}`);
589
609
  }
590
610
  log(`\nWhat was created:`);
591
- log(` ${phrenPath}/global/CLAUDE.md Global instructions loaded in every session`);
611
+ log(` ${phrenPath}/global/AGENTS.md Global instructions loaded in every session`);
592
612
  log(` ${phrenPath}/global/skills/ Phren slash commands`);
593
613
  log(` ${phrenPath}/profiles/ Machine-to-project mappings`);
594
614
  log(` ${phrenPath}/.config/ Memory quality settings and config`);
@@ -3,7 +3,7 @@ export declare const MANAGEMENT_PRESETS: readonly ManagementPreset[];
3
3
  export declare const DEFAULT_MANAGEMENT_PRESET: ManagementPreset;
4
4
  /** Structural + behavioral capabilities a preset expands into. */
5
5
  export interface ManagementCapabilities {
6
- /** Symlink global/CLAUDE.md into ~/.claude/CLAUDE.md (+ copilot instructions). */
6
+ /** Symlink global/AGENTS.md into ~/.claude/CLAUDE.md (+ copilot instructions). */
7
7
  linkGlobalClaudeMd: boolean;
8
8
  /** Symlink managed skills into ~/.claude/skills (+ other agent skill dirs). */
9
9
  installSkillLinks: boolean;
@@ -11,7 +11,7 @@
11
11
  * automations, and SessionStart self-heal of the above.
12
12
  * - assisted: MCP + hooks (context injection, capture, store git sync) but
13
13
  * phren writes NOTHING outside its own store and agent settings —
14
- * no CLAUDE.md symlink, no skills symlinks, no ~/.local/bin
14
+ * no AGENTS.md symlink, no skills symlinks, no ~/.local/bin
15
15
  * wrappers, no self-heal. Project ownership defaults to detached.
16
16
  * Init prints a self-wiring snippet so users wire their own files.
17
17
  * - manual: MCP server registration only. No hooks, no automations, no
@@ -115,7 +115,7 @@ export function presetSummaryLines(preset) {
115
115
  case "managed":
116
116
  return "phren wires everything: MCP, hooks, ~/.claude symlinks, skills, self-heal (recommended)";
117
117
  case "assisted":
118
- return "MCP + hooks only — phren never writes outside its store; you wire CLAUDE.md/skills yourself";
118
+ return "MCP + hooks only — phren never writes outside its store; you wire AGENTS.md/skills yourself";
119
119
  case "manual":
120
120
  return "MCP server only — pull-based knowledge base, no hooks or automations";
121
121
  }
@@ -6,7 +6,7 @@ import * as path from "path";
6
6
  import * as crypto from "crypto";
7
7
  import { debugLog, installPreferencesFile } from "../phren-paths.js";
8
8
  import { errorMessage } from "../utils.js";
9
- import { withFileLock } from "../shared/governance.js";
9
+ import { withFileLock } from "../governance/locks.js";
10
10
  function preferencesFile(phrenPath) {
11
11
  return installPreferencesFile(phrenPath);
12
12
  }
@@ -11,7 +11,7 @@ import { log } from "./shared.js";
11
11
  import { getManagementPreset } from "./management-preset.js";
12
12
  /** Build the self-wiring instructions as lines (testable without stdout). */
13
13
  export function buildSelfWiringSnippet(phrenPath, preset) {
14
- const globalClaude = path.join(phrenPath, "global", "CLAUDE.md");
14
+ const globalClaude = path.join(phrenPath, "global", "AGENTS.md");
15
15
  const globalSkills = path.join(phrenPath, "global", "skills");
16
16
  const lines = [];
17
17
  lines.push("");
@@ -4,30 +4,19 @@
4
4
  import * as fs from "fs";
5
5
  import { commandVersion } from "./shared.js";
6
6
  import { type ManagementCapabilities, type ManagementPreset } from "./management-preset.js";
7
- import { type ProjectOwnershipMode } from "../project-config.js";
8
- import { type BuiltinTopic } from "../project-topics.js";
7
+ import { bootstrapFromExisting, ensureProjectScaffold, inferInitScaffoldFromRepo, type InferredInitScaffold, type InitProjectDomain } from "../core/project-registry.js";
8
+ export { bootstrapFromExisting, ensureProjectScaffold, inferInitScaffoldFromRepo, type InferredInitScaffold, type InitProjectDomain, };
9
9
  export interface PostInitCheck {
10
10
  name: string;
11
11
  ok: boolean;
12
12
  detail: string;
13
13
  fix?: string;
14
14
  }
15
- interface BootstrapProjectOptions {
16
- profile?: string;
17
- profilePhrenPath?: string;
18
- ownership?: ProjectOwnershipMode;
19
- }
20
- interface BootstrapProjectResult {
21
- project: string;
22
- ownership: ProjectOwnershipMode;
23
- claudePath: string | null;
24
- }
25
15
  interface LocalGitRepoStatus {
26
16
  ok: boolean;
27
17
  initialized: boolean;
28
18
  detail: string;
29
19
  }
30
- export type InitProjectDomain = "software" | "music" | "game" | "research" | "writing" | "creative" | "other";
31
20
  export declare function resolvePreferredHomeDir(phrenPath: string): string;
32
21
  interface RepairInstallResult {
33
22
  profileFilesUpdated: number;
@@ -56,25 +45,14 @@ export declare function applyStarterTemplateUpdates(phrenPath: string): string[]
56
45
  export declare function ensureGovernanceFiles(phrenPath: string): string[];
57
46
  export declare function listTemplates(): string[];
58
47
  export declare function applyTemplate(projectDir: string, templateName: string, projectName: string): boolean;
59
- export interface InferredInitScaffold {
60
- domain: InitProjectDomain;
61
- topics: BuiltinTopic[];
62
- referenceHints: string[];
63
- commandHints: string[];
64
- confidence: number;
65
- reason: string;
66
- }
67
- export declare function inferInitScaffoldFromRepo(repoRoot: string, fallbackDomain?: InitProjectDomain): InferredInitScaffold | null;
68
- export declare function ensureProjectScaffold(projectDir: string, projectName: string, domain?: InitProjectDomain, inference?: InferredInitScaffold | null): void;
69
48
  export declare function ensureLocalGitRepo(phrenPath: string): LocalGitRepoStatus;
70
- export declare function bootstrapFromExisting(phrenPath: string, projectPath: string, opts?: string | BootstrapProjectOptions): BootstrapProjectResult;
71
49
  export declare function updateMachinesYaml(phrenPath: string, machine?: string, profile?: string): void;
72
50
  /**
73
51
  * Detect if a directory looks like a project that should be bootstrapped.
74
52
  * Returns the path if it qualifies, null otherwise.
75
53
  * A directory qualifies if it:
76
54
  * - Is not the home directory or phren directory
77
- * - Has a CLAUDE.md, AGENTS.md, .claude/CLAUDE.md, or .git directory
55
+ * - Has an AGENTS.md, legacy CLAUDE.md, .claude/CLAUDE.md, or .git directory
78
56
  *
79
57
  * A git worktree resolves to the repository it belongs to. Without this a
80
58
  * throwaway agent worktree under `.claude/worktrees/<codename>` looks like its
@@ -89,4 +67,3 @@ export declare function runPostInitVerify(phrenPath: string): {
89
67
  ok: boolean;
90
68
  checks: PostInitCheck[];
91
69
  };
92
- export {};