@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
@@ -1,3 +1,7 @@
1
+ import { createHash } from "node:crypto";
2
+ import { atomicWriteText } from "../phren-paths.js";
3
+ import { moduleSnapshot } from "../modules/runtime.js";
4
+ import { getRegisteredTools } from "../tool-registry.js";
1
5
  import * as fs from "fs";
2
6
  import * as path from "path";
3
7
  import * as yaml from "js-yaml";
@@ -7,7 +11,7 @@ import { errorMessage } from "../utils.js";
7
11
  import { buildSharedLifecycleCommands } from "../hooks.js";
8
12
  import { VERSION } from "../package-metadata.js";
9
13
  import { getToolCount, renderToolCatalogMarkdown } from "../tool-registry.js";
10
- import { isSkillEnabled } from "../skill/state.js";
14
+ import { readSkillEnabledState } from "../skill/state.js";
11
15
  import { logger } from "../logger.js";
12
16
  const REQUIRED_SKILL_FIELDS = ["name", "description"];
13
17
  export function parseSkillFrontmatter(rawContent) {
@@ -202,11 +206,12 @@ export function linkSkillsDir(srcDir, destDir, managedRoot, symlinkFile, opts) {
202
206
  fs.mkdirSync(destDir, { recursive: true });
203
207
  const expectedNames = new Set();
204
208
  const collisions = [];
209
+ const isEnabled = opts?.phrenPath && opts.scope ? readSkillEnabledState(opts.phrenPath) : undefined;
205
210
  for (const entry of fs.readdirSync(srcDir)) {
206
211
  const srcPath = path.join(srcDir, entry);
207
212
  const stat = fs.statSync(srcPath);
208
213
  const skillName = stat.isDirectory() ? entry : entry.replace(/\.md$/, "");
209
- if (opts?.phrenPath && opts.scope && !isSkillEnabled(opts.phrenPath, opts.scope, skillName)) {
214
+ if (isEnabled && opts?.scope && !isEnabled(opts.scope, skillName)) {
210
215
  continue;
211
216
  }
212
217
  if (stat.isFile() && entry.endsWith(".md")) {
@@ -254,8 +259,10 @@ export function writeSkillMd(phrenPath) {
254
259
  const promptCmd = lifecycle.userPromptSubmit.replace(/"/g, '\\"');
255
260
  const stopCmd = lifecycle.stop.replace(/"/g, '\\"');
256
261
  const version = VERSION;
257
- const toolCount = getToolCount();
258
- const toolCatalog = renderToolCatalogMarkdown();
262
+ const allowed = new Set(moduleSnapshot(phrenPath).modules.flatMap(module => module.tools.map(tool => tool.name)));
263
+ const excluded = getRegisteredTools().filter(tool => !allowed.has(tool.name));
264
+ const toolCount = getToolCount() - excluded.length;
265
+ const toolCatalog = excluded.length ? renderToolCatalogMarkdown(allowed) : renderToolCatalogMarkdown();
259
266
  const content = `---
260
267
  name: phren
261
268
  description: Long-term memory for your AI agents with automatic context injection and finding capture
@@ -295,5 +302,19 @@ ${toolCatalog}
295
302
 
296
303
  `;
297
304
  const dest = path.join(phrenPath, "phren.SKILL.md");
298
- fs.writeFileSync(dest, content);
305
+ const ledger = path.join(phrenPath, ".runtime", "module-skill.sha256");
306
+ const digest = (text) => createHash("sha256").update(text).digest("hex");
307
+ const stat = fs.lstatSync(dest, { throwIfNoEntry: false });
308
+ if (stat) {
309
+ if (!stat.isFile() || stat.isSymbolicLink())
310
+ return;
311
+ const existing = fs.readFileSync(dest, "utf8");
312
+ const previous = fs.existsSync(ledger) ? fs.readFileSync(ledger, "utf8").trim() : "";
313
+ const legacy = content.replace(`## MCP tools (${toolCount})\n\n${toolCatalog}`, `## MCP tools (${getToolCount()})\n\n${renderToolCatalogMarkdown()}`);
314
+ if (existing !== content && existing !== legacy && digest(existing) !== previous)
315
+ return;
316
+ }
317
+ atomicWriteText(dest, content);
318
+ fs.mkdirSync(path.dirname(ledger), { recursive: true });
319
+ atomicWriteText(ledger, digest(content) + "\n");
299
320
  }
@@ -1,5 +1,8 @@
1
1
  export declare function machineFilePath(): string;
2
2
  export declare function defaultMachineName(): string;
3
3
  export declare function getMachineName(): string;
4
+ /** A store commit's subject with this machine's name, so `git log` on a synced
5
+ * store shows which computer wrote each change. */
6
+ export declare function storeCommitMessage(message: string): string;
4
7
  export declare function persistMachineName(machine: string): void;
5
8
  export declare function getCurrentActor(): string;
@@ -25,6 +25,12 @@ export function getMachineName() {
25
25
  }
26
26
  return (cachedMachineName = defaultMachineName());
27
27
  }
28
+ /** A store commit's subject with this machine's name, so `git log` on a synced
29
+ * store shows which computer wrote each change. */
30
+ export function storeCommitMessage(message) {
31
+ const machine = getMachineName().replace(/[\r\n\]]/g, " ").trim();
32
+ return machine ? `${message} [${machine}]` : message;
33
+ }
28
34
  export function persistMachineName(machine) {
29
35
  const normalized = machine.trim();
30
36
  if (!normalized)
@@ -1,18 +1,4 @@
1
- /**
2
- * MCP tool profiles.
3
- *
4
- * The server used to hand every client 59 tools, about 11k tokens of schema
5
- * before a word was said, and 59 similar verbs to choose the wrong one from.
6
- * The `core` profile (the default) exposes the handful an agent reaches for
7
- * during normal work plus one `phren_admin` tool that reaches everything
8
- * else by name. `full` is the old surface for anyone who scripted against
9
- * it, and it also gains the composites.
10
- *
11
- * Nothing here knows how a tool works. Modules register tools exactly as
12
- * before; the server's registerTool wrapper records each one in a catalog and
13
- * only exposes the core ones, and the composites built here dispatch into
14
- * that catalog, validating against the target tool's own schema first.
15
- */
1
+ import type { ModuleManifest } from "../modules/manifest.js";
16
2
  export type McpProfile = "core" | "full";
17
3
  export declare const MCP_PROFILES: readonly McpProfile[];
18
4
  /** What an agent gets in the core profile. Order is the order clients list them. */
@@ -56,6 +42,7 @@ export interface ToolGate {
56
42
  */
57
43
  export declare function createToolGate(opts: {
58
44
  profile: McpProfile;
45
+ modules?: readonly ModuleManifest[];
59
46
  register: (name: string, config: ToolConfig, handler: ToolHandler) => unknown;
60
47
  /** Wraps every handler (guards, telemetry) before it is stored or exposed. */
61
48
  wrap?: (name: string, handler: ToolHandler) => ToolHandler;
@@ -1,3 +1,4 @@
1
+ import { toolOwner, disabledHint } from "../modules/registry.js";
1
2
  /**
2
3
  * MCP tool profiles.
3
4
  *
@@ -125,7 +126,9 @@ export function decorateAddFinding(entry, catalog) {
125
126
  * Code, and registers the composites when `finish` is called.
126
127
  */
127
128
  export function createToolGate(opts) {
128
- const alwaysLoad = new Set([...CORE_TOOLS, ...(opts.alwaysLoad ?? [])]);
129
+ const allowed = opts.modules && new Set(opts.modules.flatMap(module => module.tools.map(tool => tool.name)));
130
+ const core = opts.modules ? CORE_TOOLS.filter(name => opts.modules.some(module => module.tools.some(tool => tool.name === name && tool.profiles.includes("core")))) : CORE_TOOLS;
131
+ const alwaysLoad = new Set([...core, ...(opts.alwaysLoad ?? [])]);
129
132
  const catalog = new Map();
130
133
  const exposed = new Set();
131
134
  const expose = (name, config, handler) => {
@@ -138,6 +141,8 @@ export function createToolGate(opts) {
138
141
  exposed.add(name);
139
142
  };
140
143
  const registerTool = (name, config, handler) => {
144
+ if (allowed && !allowed.has(name))
145
+ return;
141
146
  if (catalog.has(name))
142
147
  throw new Error(`Duplicate MCP tool registration: "${name}"`);
143
148
  const wrapped = opts.wrap ? opts.wrap(name, handler) : handler;
@@ -145,13 +150,13 @@ export function createToolGate(opts) {
145
150
  if (name === "add_finding")
146
151
  entry = decorateAddFinding(entry, catalog);
147
152
  catalog.set(name, entry);
148
- if (opts.profile === "core" && !CORE_TOOLS.includes(name))
153
+ if (opts.profile === "core" && !core.includes(name))
149
154
  return;
150
155
  expose(name, entry.config, entry.handler);
151
156
  };
152
157
  const finish = () => {
153
158
  for (const tool of buildCompositeTools(catalog)) {
154
- if (catalog.has(tool.name))
159
+ if (catalog.has(tool.name) || (allowed && !allowed.has(tool.name)))
155
160
  continue;
156
161
  catalog.set(tool.name, { name: tool.name, config: tool.config, handler: tool.handler });
157
162
  expose(tool.name, tool.config, tool.handler);
@@ -192,14 +197,64 @@ function actionLine(action, entry) {
192
197
  function errorResponse(error, extra = {}) {
193
198
  return { content: [{ type: "text", text: JSON.stringify({ ok: false, error, ...extra }, null, 2) }] };
194
199
  }
200
+ /**
201
+ * A composite's schema is `passthrough`, so the host serializes whatever it
202
+ * does not recognize; Claude Code hands nested objects (`updates`, `settings`)
203
+ * over as JSON strings, sometimes wrapped twice. A JSON-looking string whose
204
+ * decode validates replaces the raw string; so does a decode that does not
205
+ * validate when the raw string never would, so the miss reports its real inner
206
+ * path instead of "expected object, received string". A string the field
207
+ * accepts as-is (JSON that is genuinely text) and a string that is not JSON
208
+ * are left to the schema's own error. The same untyped schema turns a number
209
+ * or a boolean into its text ("5", "true"); that text is decoded only when the
210
+ * field rejects it and accepts the decoded value.
211
+ */
212
+ function decodeJsonArguments(schema, args) {
213
+ const out = { ...args };
214
+ for (const [key, value] of Object.entries(args)) {
215
+ if (typeof value !== "string")
216
+ continue;
217
+ const field = schema.shape[key];
218
+ if (!field)
219
+ continue;
220
+ const text = value.trim();
221
+ if (/^(?:true|false|-?\d+(?:\.\d+)?)$/.test(text)) {
222
+ const primitive = text === "true" ? true : text === "false" ? false : Number(text);
223
+ if (!field.safeParse(value).success && field.safeParse(primitive).success)
224
+ out[key] = primitive;
225
+ continue;
226
+ }
227
+ if (!/^\s*[[{"]/.test(value))
228
+ continue;
229
+ let decoded = value;
230
+ for (let hop = 0; hop < 3; hop++) {
231
+ if (typeof decoded !== "string" || !/^\s*[[{"]/.test(decoded))
232
+ break;
233
+ try {
234
+ decoded = JSON.parse(decoded);
235
+ }
236
+ catch {
237
+ decoded = undefined;
238
+ break;
239
+ }
240
+ }
241
+ if (decoded === undefined || decoded === null || typeof decoded !== "object")
242
+ continue;
243
+ if (field.safeParse(decoded).success || !field.safeParse(value).success)
244
+ out[key] = decoded;
245
+ }
246
+ return out;
247
+ }
195
248
  /** Run a catalog tool by name after validating the arguments against its own schema. */
196
249
  export async function dispatch(catalog, target, args) {
197
250
  const entry = catalog.get(target);
198
- if (!entry)
199
- return errorResponse(`Unknown tool "${target}"`);
251
+ if (!entry) {
252
+ const owner = toolOwner(target);
253
+ return errorResponse(`Unknown tool "${target}"${owner ? `: ${disabledHint(owner.name)}` : ""}`, { errorCode: "UNAVAILABLE" });
254
+ }
200
255
  const schema = schemaOf(entry);
201
256
  if (schema) {
202
- const parsed = schema.safeParse(args);
257
+ const parsed = schema.safeParse(decodeJsonArguments(schema, args));
203
258
  if (!parsed.success) {
204
259
  return errorResponse(`Invalid arguments for ${target}`, {
205
260
  issues: parsed.error.issues.map((i) => ({ path: i.path.join("."), message: i.message })),
@@ -228,11 +283,11 @@ export function buildCompositeTools(catalog) {
228
283
  config: {
229
284
  title: composite.title,
230
285
  description: `${composite.summary}\nActions:\n${lines.map((l) => `- ${l}`).join("\n")}`,
231
- inputSchema: z.object({ action: z.enum(actionNames).describe("Which change to make.") }).passthrough(),
286
+ inputSchema: z.object({ action: z.string().describe(`Which change to make: ${actionNames.join(", ")}.`) }).passthrough(),
232
287
  },
233
288
  handler: (args) => {
234
289
  const { action, ...rest } = args;
235
- return dispatch(catalog, map[action], rest);
290
+ return dispatch(catalog, map[action] ?? composite.actions[action] ?? action, rest);
236
291
  },
237
292
  });
238
293
  }
@@ -250,7 +305,7 @@ export function buildCompositeTools(catalog) {
250
305
  description: "Everything else phren can do — skills, hooks, config, notes, review queue, export/import, doctor, the fragment graph — behind one tool. " +
251
306
  "Pass `action` plus that action's parameters; `list_actions` returns every action with its full parameter list.\nActions:\n" +
252
307
  lines.map((l) => `- ${l}`).join("\n"),
253
- inputSchema: z.object({ action: z.enum(actionNames).describe("Which admin action to run, or list_actions.") }).passthrough(),
308
+ inputSchema: z.object({ action: z.string().describe(`Which admin action to run: ${actionNames.join(", ")}.`) }).passthrough(),
254
309
  },
255
310
  handler: (args) => {
256
311
  const { action, ...rest } = args;