@raybase/cli 0.0.2 → 0.3.4

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 (321) hide show
  1. package/LICENSE +21 -0
  2. package/dist/admin-assets.d.ts +22 -0
  3. package/dist/admin-assets.d.ts.map +1 -0
  4. package/dist/admin-assets.js +285 -0
  5. package/dist/admin-assets.js.map +1 -0
  6. package/dist/agent-remote-mcp-cli.d.ts +71 -0
  7. package/dist/agent-remote-mcp-cli.d.ts.map +1 -0
  8. package/dist/agent-remote-mcp-cli.js +466 -0
  9. package/dist/agent-remote-mcp-cli.js.map +1 -0
  10. package/dist/agent-skills-cli.d.ts +4 -0
  11. package/dist/agent-skills-cli.d.ts.map +1 -0
  12. package/dist/agent-skills-cli.js +144 -0
  13. package/dist/agent-skills-cli.js.map +1 -0
  14. package/dist/agent.d.ts +169 -0
  15. package/dist/agent.d.ts.map +1 -0
  16. package/dist/agent.js +531 -0
  17. package/dist/agent.js.map +1 -0
  18. package/dist/app-manifest.d.ts +41 -0
  19. package/dist/app-manifest.d.ts.map +1 -0
  20. package/dist/app-manifest.js +294 -0
  21. package/dist/app-manifest.js.map +1 -0
  22. package/dist/dev-cron-backstop.d.ts +53 -0
  23. package/dist/dev-cron-backstop.d.ts.map +1 -0
  24. package/dist/dev-cron-backstop.js +364 -0
  25. package/dist/dev-cron-backstop.js.map +1 -0
  26. package/dist/dev-do-watchdog.d.ts +37 -0
  27. package/dist/dev-do-watchdog.d.ts.map +1 -0
  28. package/dist/dev-do-watchdog.js +75 -0
  29. package/dist/dev-do-watchdog.js.map +1 -0
  30. package/dist/dev-inference-tape.d.ts +35 -0
  31. package/dist/dev-inference-tape.d.ts.map +1 -0
  32. package/dist/dev-inference-tape.js +502 -0
  33. package/dist/dev-inference-tape.js.map +1 -0
  34. package/dist/dev-ports.d.ts +25 -0
  35. package/dist/dev-ports.d.ts.map +1 -0
  36. package/dist/dev-ports.js +84 -0
  37. package/dist/dev-ports.js.map +1 -0
  38. package/dist/dev-project-lock.d.ts +24 -0
  39. package/dist/dev-project-lock.d.ts.map +1 -0
  40. package/dist/dev-project-lock.js +307 -0
  41. package/dist/dev-project-lock.js.map +1 -0
  42. package/dist/env-files.d.ts +10 -0
  43. package/dist/env-files.d.ts.map +1 -0
  44. package/dist/env-files.js +108 -0
  45. package/dist/env-files.js.map +1 -0
  46. package/dist/external-json.d.ts +3 -0
  47. package/dist/external-json.d.ts.map +1 -0
  48. package/dist/external-json.js +21 -0
  49. package/dist/external-json.js.map +1 -0
  50. package/dist/frameworks.d.ts +67 -0
  51. package/dist/frameworks.d.ts.map +1 -0
  52. package/dist/frameworks.js +210 -0
  53. package/dist/frameworks.js.map +1 -0
  54. package/dist/guide-corpus-doctor.d.ts +24 -0
  55. package/dist/guide-corpus-doctor.d.ts.map +1 -0
  56. package/dist/guide-corpus-doctor.js +111 -0
  57. package/dist/guide-corpus-doctor.js.map +1 -0
  58. package/dist/hosting.d.ts +85 -0
  59. package/dist/hosting.d.ts.map +1 -0
  60. package/dist/hosting.js +136 -0
  61. package/dist/hosting.js.map +1 -0
  62. package/dist/index.d.ts +253 -0
  63. package/dist/index.d.ts.map +1 -0
  64. package/dist/index.js +11497 -0
  65. package/dist/index.js.map +1 -0
  66. package/dist/kit-doctor.d.ts +19 -0
  67. package/dist/kit-doctor.d.ts.map +1 -0
  68. package/dist/kit-doctor.js +255 -0
  69. package/dist/kit-doctor.js.map +1 -0
  70. package/dist/kit-install.d.ts +67 -0
  71. package/dist/kit-install.d.ts.map +1 -0
  72. package/dist/kit-install.js +409 -0
  73. package/dist/kit-install.js.map +1 -0
  74. package/dist/kit-manifest.d.ts +154 -0
  75. package/dist/kit-manifest.d.ts.map +1 -0
  76. package/dist/kit-manifest.js +252 -0
  77. package/dist/kit-manifest.js.map +1 -0
  78. package/dist/kit-registry.d.ts +42 -0
  79. package/dist/kit-registry.d.ts.map +1 -0
  80. package/dist/kit-registry.js +231 -0
  81. package/dist/kit-registry.js.map +1 -0
  82. package/dist/kit-spec.d.ts +37 -0
  83. package/dist/kit-spec.d.ts.map +1 -0
  84. package/dist/kit-spec.js +48 -0
  85. package/dist/kit-spec.js.map +1 -0
  86. package/dist/kit-state.d.ts +57 -0
  87. package/dist/kit-state.d.ts.map +1 -0
  88. package/dist/kit-state.js +31 -0
  89. package/dist/kit-state.js.map +1 -0
  90. package/dist/kits.d.ts +82 -0
  91. package/dist/kits.d.ts.map +1 -0
  92. package/dist/kits.js +255 -0
  93. package/dist/kits.js.map +1 -0
  94. package/dist/license-keys.d.ts +3 -0
  95. package/dist/license-keys.d.ts.map +1 -0
  96. package/dist/license-keys.js +10 -0
  97. package/dist/license-keys.js.map +1 -0
  98. package/dist/licensing.d.ts +269 -0
  99. package/dist/licensing.d.ts.map +1 -0
  100. package/dist/licensing.js +477 -0
  101. package/dist/licensing.js.map +1 -0
  102. package/dist/local-codex-relay.d.ts +19 -0
  103. package/dist/local-codex-relay.d.ts.map +1 -0
  104. package/dist/local-codex-relay.js +203 -0
  105. package/dist/local-codex-relay.js.map +1 -0
  106. package/dist/module-doctor.d.ts +35 -0
  107. package/dist/module-doctor.d.ts.map +1 -0
  108. package/dist/module-doctor.js +966 -0
  109. package/dist/module-doctor.js.map +1 -0
  110. package/dist/module-install.d.ts +71 -0
  111. package/dist/module-install.d.ts.map +1 -0
  112. package/dist/module-install.js +1133 -0
  113. package/dist/module-install.js.map +1 -0
  114. package/dist/module-manifest.d.ts +33 -0
  115. package/dist/module-manifest.d.ts.map +1 -0
  116. package/dist/module-manifest.js +301 -0
  117. package/dist/module-manifest.js.map +1 -0
  118. package/dist/module-state.d.ts +76 -0
  119. package/dist/module-state.d.ts.map +1 -0
  120. package/dist/module-state.js +162 -0
  121. package/dist/module-state.js.map +1 -0
  122. package/dist/modules.d.ts +52 -0
  123. package/dist/modules.d.ts.map +1 -0
  124. package/dist/modules.js +110 -0
  125. package/dist/modules.js.map +1 -0
  126. package/dist/palette-check.d.ts +42 -0
  127. package/dist/palette-check.d.ts.map +1 -0
  128. package/dist/palette-check.js +217 -0
  129. package/dist/palette-check.js.map +1 -0
  130. package/dist/palette-compile.d.ts +30 -0
  131. package/dist/palette-compile.d.ts.map +1 -0
  132. package/dist/palette-compile.js +149 -0
  133. package/dist/palette-compile.js.map +1 -0
  134. package/dist/pm.d.ts +11 -0
  135. package/dist/pm.d.ts.map +1 -0
  136. package/dist/pm.js +30 -0
  137. package/dist/pm.js.map +1 -0
  138. package/dist/project-local-codex-relay.d.ts +11 -0
  139. package/dist/project-local-codex-relay.d.ts.map +1 -0
  140. package/dist/project-local-codex-relay.js +95 -0
  141. package/dist/project-local-codex-relay.js.map +1 -0
  142. package/dist/shared.d.ts +4 -0
  143. package/dist/shared.d.ts.map +1 -0
  144. package/dist/shared.js +38 -0
  145. package/dist/shared.js.map +1 -0
  146. package/dist/shell-match.d.ts +29 -0
  147. package/dist/shell-match.d.ts.map +1 -0
  148. package/dist/shell-match.js +160 -0
  149. package/dist/shell-match.js.map +1 -0
  150. package/dist/template-doctor.d.ts +40 -0
  151. package/dist/template-doctor.d.ts.map +1 -0
  152. package/dist/template-doctor.js +722 -0
  153. package/dist/template-doctor.js.map +1 -0
  154. package/dist/template-install.d.ts +135 -0
  155. package/dist/template-install.d.ts.map +1 -0
  156. package/dist/template-install.js +1311 -0
  157. package/dist/template-install.js.map +1 -0
  158. package/dist/template-manifest.d.ts +328 -0
  159. package/dist/template-manifest.d.ts.map +1 -0
  160. package/dist/template-manifest.js +533 -0
  161. package/dist/template-manifest.js.map +1 -0
  162. package/dist/template-registry.d.ts +76 -0
  163. package/dist/template-registry.d.ts.map +1 -0
  164. package/dist/template-registry.js +365 -0
  165. package/dist/template-registry.js.map +1 -0
  166. package/dist/template-spec.d.ts +24 -0
  167. package/dist/template-spec.d.ts.map +1 -0
  168. package/dist/template-spec.js +38 -0
  169. package/dist/template-spec.js.map +1 -0
  170. package/dist/template-state.d.ts +108 -0
  171. package/dist/template-state.d.ts.map +1 -0
  172. package/dist/template-state.js +93 -0
  173. package/dist/template-state.js.map +1 -0
  174. package/dist/templates.d.ts +123 -0
  175. package/dist/templates.d.ts.map +1 -0
  176. package/dist/templates.js +541 -0
  177. package/dist/templates.js.map +1 -0
  178. package/dist/theme-match.d.ts +41 -0
  179. package/dist/theme-match.d.ts.map +1 -0
  180. package/dist/theme-match.js +92 -0
  181. package/dist/theme-match.js.map +1 -0
  182. package/dist/wrangler-secrets.d.ts +15 -0
  183. package/dist/wrangler-secrets.d.ts.map +1 -0
  184. package/dist/wrangler-secrets.js +97 -0
  185. package/dist/wrangler-secrets.js.map +1 -0
  186. package/kits/datasheet-grid/file-manifest.json +65 -0
  187. package/kits/datasheet-grid/files/AGENTS.md +6 -0
  188. package/kits/datasheet-grid/files/docs/datasheet-grid.md +15 -0
  189. package/kits/datasheet-grid/files/files/src/kits/datasheet-grid/DatasheetGridRoute.tsx +35 -0
  190. package/kits/datasheet-grid/files/files/src/kits/datasheet-grid/README.md +10 -0
  191. package/kits/datasheet-grid/files/files/src/kits/datasheet-grid/grid-adapter.ts +30 -0
  192. package/kits/datasheet-grid/files/files/src/kits/datasheet-grid/grid-metadata.ts +19 -0
  193. package/kits/datasheet-grid/files/files/src/kits/datasheet-grid/grid-state.ts +24 -0
  194. package/kits/datasheet-grid/files/kit.json +119 -0
  195. package/kits/datasheet-grid/files/skills/datasheet-grid/SKILL.md +16 -0
  196. package/kits/datasheet-grid/files/tests/datasheet-grid.test.ts +15 -0
  197. package/kits/datasheet-grid/kit.json +146 -0
  198. package/kits/index.json +71 -0
  199. package/kits/resend-email/file-manifest.json +47 -0
  200. package/kits/resend-email/files/AGENTS.md +7 -0
  201. package/kits/resend-email/files/docs/resend-email.md +13 -0
  202. package/kits/resend-email/files/files/src/kits/resend-email/README.md +17 -0
  203. package/kits/resend-email/files/files/src/kits/resend-email/send-email.ts +44 -0
  204. package/kits/resend-email/files/kit.json +128 -0
  205. package/kits/resend-email/files/skills/resend-email/SKILL.md +20 -0
  206. package/kits/resend-email/files/tests/resend-email.test.ts +54 -0
  207. package/kits/resend-email/kit.json +159 -0
  208. package/modules/docs/templates/astro-emdash/content/docs/getting-started.mdx +13 -0
  209. package/modules/docs/templates/astro-emdash/content/docs/index.mdx +13 -0
  210. package/modules/docs/templates/astro-emdash/content/docs/mcp.mdx +11 -0
  211. package/modules/docs/templates/astro-emdash/content/docs/meta.json +4 -0
  212. package/modules/docs/templates/astro-emdash/site/content/docs/getting-started.mdx +12 -0
  213. package/modules/docs/templates/astro-emdash/site/content/docs/index.mdx +12 -0
  214. package/modules/docs/templates/astro-emdash/site/content/docs/mcp.mdx +10 -0
  215. package/modules/docs/templates/astro-emdash/site/content/docs/meta.json +4 -0
  216. package/modules/docs/templates/astro-emdash/site/source.config.ts +10 -0
  217. package/modules/docs/templates/astro-emdash/site/src/docs/docs-assets.ts +1 -0
  218. package/modules/docs/templates/astro-emdash/site/src/docs/docs-client.tsx +22 -0
  219. package/modules/docs/templates/astro-emdash/site/src/docs/docs-data.ts +24 -0
  220. package/modules/docs/templates/astro-emdash/site/src/docs/docs-handler.tsx +105 -0
  221. package/modules/docs/templates/astro-emdash/site/src/docs/docs-layout.tsx +56 -0
  222. package/modules/docs/templates/astro-emdash/site/src/docs/docs-mdx.tsx +79 -0
  223. package/modules/docs/templates/astro-emdash/site/src/docs/docs-page-actions.tsx +146 -0
  224. package/modules/docs/templates/astro-emdash/site/src/docs/docs-page.tsx +70 -0
  225. package/modules/docs/templates/astro-emdash/site/src/docs/llm-text.ts +61 -0
  226. package/modules/docs/templates/astro-emdash/site/src/docs/source.ts +7 -0
  227. package/modules/docs/templates/astro-emdash/site/src/pages/docs/[...slug].ts +6 -0
  228. package/modules/docs/templates/astro-emdash/site/src/pages/docs/api/markdown.ts +4 -0
  229. package/modules/docs/templates/astro-emdash/site/src/pages/docs/api/search.ts +4 -0
  230. package/modules/docs/templates/astro-emdash/site/src/pages/llms.txt.ts +8 -0
  231. package/modules/docs/templates/astro-emdash/site/src/styles-docs.css +3 -0
  232. package/modules/docs/templates/astro-emdash/source.config.ts +10 -0
  233. package/modules/docs/templates/astro-emdash/src/docs/docs-assets.ts +1 -0
  234. package/modules/docs/templates/astro-emdash/src/docs/docs-client.tsx +22 -0
  235. package/modules/docs/templates/astro-emdash/src/docs/docs-data.ts +24 -0
  236. package/modules/docs/templates/astro-emdash/src/docs/docs-handler.tsx +105 -0
  237. package/modules/docs/templates/astro-emdash/src/docs/docs-layout.tsx +56 -0
  238. package/modules/docs/templates/astro-emdash/src/docs/docs-mdx.tsx +79 -0
  239. package/modules/docs/templates/astro-emdash/src/docs/docs-page-actions.tsx +146 -0
  240. package/modules/docs/templates/astro-emdash/src/docs/docs-page.tsx +70 -0
  241. package/modules/docs/templates/astro-emdash/src/docs/llm-text.ts +61 -0
  242. package/modules/docs/templates/astro-emdash/src/docs/source.ts +7 -0
  243. package/modules/docs/templates/astro-emdash/src/routes/docs/$.tsx +22 -0
  244. package/modules/docs/templates/astro-emdash/src/routes/docs/api/markdown.ts +12 -0
  245. package/modules/docs/templates/astro-emdash/src/routes/docs/api/search.ts +12 -0
  246. package/modules/docs/templates/astro-emdash/src/routes/docs.index.tsx +22 -0
  247. package/modules/docs/templates/astro-emdash/src/routes/docs.tsx +22 -0
  248. package/modules/docs/templates/astro-emdash/src/styles-docs.css +3 -0
  249. package/modules/docs/templates/react-router/app/components/mdx.tsx +79 -0
  250. package/modules/docs/templates/react-router/app/lib/layout.shared.tsx +54 -0
  251. package/modules/docs/templates/react-router/app/lib/source.ts +7 -0
  252. package/modules/docs/templates/react-router/app/routes/docs.$.tsx +49 -0
  253. package/modules/docs/templates/react-router/app/routes/docs.api.search.ts +10 -0
  254. package/modules/docs/templates/react-router/app/routes/docs.tsx +13 -0
  255. package/modules/docs/templates/react-router/content/docs/getting-started.mdx +8 -0
  256. package/modules/docs/templates/react-router/content/docs/index.mdx +8 -0
  257. package/modules/docs/templates/react-router/content/docs/mcp.mdx +121 -0
  258. package/modules/docs/templates/react-router/content/docs/meta.json +4 -0
  259. package/modules/docs/templates/react-router/source.config.ts +5 -0
  260. package/modules/docs/templates/tanstack-start/content/docs/getting-started.mdx +10 -0
  261. package/modules/docs/templates/tanstack-start/content/docs/index.mdx +8 -0
  262. package/modules/docs/templates/tanstack-start/content/docs/mcp.mdx +121 -0
  263. package/modules/docs/templates/tanstack-start/content/docs/meta.json +4 -0
  264. package/modules/docs/templates/tanstack-start/source.config.ts +10 -0
  265. package/modules/docs/templates/tanstack-start/src/docs/docs-assets.ts +1 -0
  266. package/modules/docs/templates/tanstack-start/src/docs/docs-client.tsx +22 -0
  267. package/modules/docs/templates/tanstack-start/src/docs/docs-data.ts +24 -0
  268. package/modules/docs/templates/tanstack-start/src/docs/docs-handler.tsx +105 -0
  269. package/modules/docs/templates/tanstack-start/src/docs/docs-layout.tsx +56 -0
  270. package/modules/docs/templates/tanstack-start/src/docs/docs-mdx.tsx +79 -0
  271. package/modules/docs/templates/tanstack-start/src/docs/docs-page-actions.tsx +146 -0
  272. package/modules/docs/templates/tanstack-start/src/docs/docs-page.tsx +70 -0
  273. package/modules/docs/templates/tanstack-start/src/docs/llm-text.ts +61 -0
  274. package/modules/docs/templates/tanstack-start/src/docs/source.ts +7 -0
  275. package/modules/docs/templates/tanstack-start/src/routes/docs/$.tsx +22 -0
  276. package/modules/docs/templates/tanstack-start/src/routes/docs/api/markdown.ts +12 -0
  277. package/modules/docs/templates/tanstack-start/src/routes/docs/api/search.ts +12 -0
  278. package/modules/docs/templates/tanstack-start/src/routes/docs.index.tsx +22 -0
  279. package/modules/docs/templates/tanstack-start/src/routes/docs.tsx +22 -0
  280. package/modules/docs/templates/tanstack-start/src/styles-docs.css +3 -0
  281. package/modules/guide/templates/astro-emdash/content/guide/capability-map.md +17 -0
  282. package/modules/guide/templates/astro-emdash/src/components/guide-widget.tsx +41 -0
  283. package/modules/guide/templates/astro-emdash/src/guide/actions.ts +8 -0
  284. package/modules/guide/templates/astro-emdash/src/guide/config.ts +21 -0
  285. package/modules/guide/templates/astro-emdash/src/guide/corpus.gen.ts +4 -0
  286. package/modules/guide/templates/astro-emdash/src/guide/corpus.manifest.json +72 -0
  287. package/modules/guide/templates/astro-emdash/src/guide/corpus.ts +4 -0
  288. package/modules/guide/templates/astro-emdash/src/guide/resources.json +4 -0
  289. package/modules/guide/templates/react-router/app/components/guide-widget.tsx +29 -0
  290. package/modules/guide/templates/react-router/app/guide/actions.ts +3 -0
  291. package/modules/guide/templates/react-router/app/guide/config.ts +21 -0
  292. package/modules/guide/templates/react-router/app/guide/corpus.gen.ts +4 -0
  293. package/modules/guide/templates/react-router/app/guide/corpus.manifest.json +22 -0
  294. package/modules/guide/templates/react-router/app/guide/corpus.ts +4 -0
  295. package/modules/guide/templates/react-router/app/guide/resources.json +4 -0
  296. package/modules/guide/templates/react-router/content/guide/capability-map.md +13 -0
  297. package/modules/guide/templates/tanstack-start/content/guide/capability-map.md +17 -0
  298. package/modules/guide/templates/tanstack-start/src/components/guide-widget.tsx +41 -0
  299. package/modules/guide/templates/tanstack-start/src/guide/actions.ts +17 -0
  300. package/modules/guide/templates/tanstack-start/src/guide/config.ts +21 -0
  301. package/modules/guide/templates/tanstack-start/src/guide/corpus.gen.ts +4 -0
  302. package/modules/guide/templates/tanstack-start/src/guide/corpus.manifest.json +22 -0
  303. package/modules/guide/templates/tanstack-start/src/guide/corpus.ts +4 -0
  304. package/modules/guide/templates/tanstack-start/src/guide/resources.json +4 -0
  305. package/modules/openai-subscription/templates/astro-emdash/.agents/skills/raybase-openai-subscription/SKILL.md +57 -0
  306. package/modules/openai-subscription/templates/astro-emdash/.agents/skills/raybase-openai-subscription/references/compatibility-and-testing.md +129 -0
  307. package/modules/openai-subscription/templates/astro-emdash/.agents/skills/raybase-openai-subscription/references/module-contract.md +133 -0
  308. package/modules/openai-subscription/templates/astro-emdash/.agents/skills/raybase-openai-subscription/references/structured-outputs.md +159 -0
  309. package/modules/openai-subscription/templates/astro-emdash/src/openai-subscription.ts +11 -0
  310. package/modules/openai-subscription/templates/react-router/.agents/skills/raybase-openai-subscription/SKILL.md +57 -0
  311. package/modules/openai-subscription/templates/react-router/.agents/skills/raybase-openai-subscription/references/compatibility-and-testing.md +129 -0
  312. package/modules/openai-subscription/templates/react-router/.agents/skills/raybase-openai-subscription/references/module-contract.md +133 -0
  313. package/modules/openai-subscription/templates/react-router/.agents/skills/raybase-openai-subscription/references/structured-outputs.md +159 -0
  314. package/modules/openai-subscription/templates/react-router/app/openai-subscription.ts +11 -0
  315. package/modules/openai-subscription/templates/tanstack-start/.agents/skills/raybase-openai-subscription/SKILL.md +57 -0
  316. package/modules/openai-subscription/templates/tanstack-start/.agents/skills/raybase-openai-subscription/references/compatibility-and-testing.md +129 -0
  317. package/modules/openai-subscription/templates/tanstack-start/.agents/skills/raybase-openai-subscription/references/module-contract.md +133 -0
  318. package/modules/openai-subscription/templates/tanstack-start/.agents/skills/raybase-openai-subscription/references/structured-outputs.md +159 -0
  319. package/modules/openai-subscription/templates/tanstack-start/src/openai-subscription.ts +11 -0
  320. package/package.json +34 -8
  321. package/README.md +0 -3
@@ -0,0 +1,1133 @@
1
+ import { randomBytes } from "node:crypto";
2
+ import { cpSync, existsSync, lstatSync, mkdirSync, readFileSync, readlinkSync, rmSync, statSync, symlinkSync, writeFileSync } from "node:fs";
3
+ import { dirname, join } from "node:path";
4
+ import { applyEdits, modify, parse } from "jsonc-parser";
5
+ import { assertNoSymlink, resolveInside, sha256File } from "./kit-manifest.js";
6
+ import { docsSitePlacementFiles, firstPartyModuleFiles, firstPartyModuleManifests, moduleTemplateRoot } from "./module-manifest.js";
7
+ import { emptyModuleLock, inferFirstPartyModuleFileMode, moduleFileMode, readModuleLock, resolveFirstPartyModuleState, writeModuleLock } from "./module-state.js";
8
+ import { declareWranglerRequiredSecrets } from "./wrangler-secrets.js";
9
+ const DEFAULT_AI_CONFIG_BLOCK = ` ai: {
10
+ enabled: true,
11
+ defaults: {
12
+ model: "@cf/zai-org/glm-4.7-flash",
13
+ embeddingModel: "@cf/baai/bge-base-en-v1.5",
14
+ maxInputChars: 20000,
15
+ maxOutputTokens: 1200
16
+ },
17
+ limits: {
18
+ // Daily spend caps are opt-in and unlimited when unset. Set them only if
19
+ // your inference lane bills per token and you want a hard ceiling:
20
+ // perUserDailyRequests: 50,
21
+ // perUserDailyOutputTokens: 25000,
22
+ // perAppDailyRequests: 500,
23
+ perPublicDailyRequests: 200,
24
+ perPublicDailyOutputTokens: 60000,
25
+ maxToolCallsPerTurn: 6,
26
+ maxLoopStepsPerTurn: 8,
27
+ maxConversationMessages: 40
28
+ }
29
+ },`;
30
+ export function installFirstPartyModule(projectRoot, options) {
31
+ const manifest = firstPartyModuleManifests[options.id];
32
+ const placement = resolveInstallPlacement(options.id, options.template, options.placement);
33
+ const sourceRoot = moduleTemplateRoot(options.id, options.template);
34
+ const plan = [];
35
+ const files = [];
36
+ const conflicts = [];
37
+ planModuleFiles(projectRoot, sourceRoot, manifest, options.template, placement, Boolean(options.overwrite), plan, files, conflicts);
38
+ planModuleSkillLinks(projectRoot, manifest, plan, conflicts);
39
+ plan.push({ action: "package", target: "package.json", status: "update" });
40
+ if (manifest.id === "docs" && placement === "site")
41
+ plan.push({ action: "package", target: "site/package.json", status: "update" });
42
+ plan.push({ action: "patch", target: templateServerFile(options.template), status: "update" });
43
+ if (manifest.id === "openai-subscription")
44
+ plan.push({ action: "patch", target: "wrangler.jsonc", status: "update" });
45
+ plan.push({ action: "state", target: ".raybase/modules.json", status: "update" });
46
+ if (conflicts.length)
47
+ throw new Error(`Module install has conflicts:\n${conflicts.map((conflict) => `- ${conflict}`).join("\n")}`);
48
+ if (!options.dryRun) {
49
+ applyModuleFiles(projectRoot, sourceRoot, manifest, options.template, placement, Boolean(options.overwrite));
50
+ applyModuleSkillLinks(projectRoot, manifest);
51
+ applyPackageModule(projectRoot, manifest, true, placement);
52
+ applyInstallHooks(projectRoot, manifest.id, options.template, placement);
53
+ writeInstalledModule(projectRoot, manifest, options.template, files, true, placement);
54
+ }
55
+ return {
56
+ ok: true,
57
+ module: manifest.id,
58
+ version: manifest.version,
59
+ packageName: manifest.packageName,
60
+ projectDir: projectRoot,
61
+ template: options.template,
62
+ dryRun: Boolean(options.dryRun),
63
+ plan,
64
+ files,
65
+ changedFiles: changedTargets(plan),
66
+ nextSteps: manifest.nextSteps,
67
+ lockFile: join(projectRoot, ".raybase/modules.json"),
68
+ warnings: []
69
+ };
70
+ }
71
+ export function updateFirstPartyModules(projectRoot, options) {
72
+ const lock = readModuleLock(projectRoot);
73
+ if (!lock)
74
+ return { ok: true, dryRun: Boolean(options.dryRun), projectDir: projectRoot, updates: [], warnings: ["No Raybase modules are installed."] };
75
+ const targets = options.modules?.length ? options.modules : Object.keys(lock.modules);
76
+ const updates = [];
77
+ for (const id of targets) {
78
+ const installed = lock.modules[id];
79
+ const manifest = firstPartyModuleManifests[id];
80
+ if (!installed || !manifest) {
81
+ updates.push({ module: id, currentVersion: "not-installed", status: "blocked", conflicts: [`${id} is not installed.`], warnings: [] });
82
+ continue;
83
+ }
84
+ const drift = moduleFileDrift(projectRoot, installed);
85
+ if (drift.length && !options.overwrite) {
86
+ updates.push({ module: id, currentVersion: installed.version, latestVersion: manifest.version, status: "blocked", conflicts: drift, warnings: ["Local drift must be reviewed before updating."] });
87
+ continue;
88
+ }
89
+ const sourceRoot = moduleTemplateRoot(id, options.template);
90
+ const placement = installed.id === "docs" ? installed.placement ?? "spine" : undefined;
91
+ const sourceChanges = moduleSourceChanges(sourceRoot, manifest, options.template, installed, placement);
92
+ const hasAutomaticSourceChanges = moduleHasAutomaticSourceChanges(sourceRoot, manifest, options.template, installed, placement);
93
+ const stateWarnings = moduleStateWarnings(projectRoot, installed);
94
+ const hasRestorableEditableFile = installed.files.some((file) => moduleFileMode(installed, file) === "editable" && !existsSync(join(projectRoot, file.path)));
95
+ const shouldUpdate = manifest.version !== installed.version || hasAutomaticSourceChanges || hasRestorableEditableFile;
96
+ if (!shouldUpdate) {
97
+ updates.push({ module: id, currentVersion: installed.version, latestVersion: manifest.version, status: "current", conflicts: [], warnings: [...sourceChanges, ...stateWarnings] });
98
+ continue;
99
+ }
100
+ if (options.dryRun) {
101
+ updates.push({ module: id, currentVersion: installed.version, latestVersion: manifest.version, status: "update-available", conflicts: [], warnings: [...sourceChanges, ...stateWarnings] });
102
+ continue;
103
+ }
104
+ const files = applyModuleUpdate(projectRoot, sourceRoot, manifest, options.template, installed, placement, Boolean(options.overwrite));
105
+ applyModuleSkillLinks(projectRoot, manifest);
106
+ writeInstalledModule(projectRoot, manifest, options.template, files, true, placement);
107
+ updates.push({ module: id, currentVersion: installed.version, latestVersion: manifest.version, status: "updated", conflicts: [], warnings: [...sourceChanges, ...stateWarnings] });
108
+ }
109
+ return { ok: updates.every((update) => update.status !== "blocked"), dryRun: Boolean(options.dryRun), projectDir: projectRoot, updates, warnings: [] };
110
+ }
111
+ export function removeFirstPartyModule(projectRoot, options) {
112
+ const lock = readModuleLock(projectRoot);
113
+ const installed = lock?.modules[options.id] ?? null;
114
+ const plan = [];
115
+ const conflicts = [];
116
+ const removedFiles = [];
117
+ if (!lock || !installed) {
118
+ return {
119
+ ok: true,
120
+ module: options.id,
121
+ projectDir: projectRoot,
122
+ removed: false,
123
+ dryRun: Boolean(options.dryRun),
124
+ force: Boolean(options.force),
125
+ plan: [],
126
+ removedFiles: [],
127
+ conflicts: [],
128
+ warnings: [`${options.id} is not installed.`],
129
+ lockFile: join(projectRoot, ".raybase/modules.json"),
130
+ nextSteps: []
131
+ };
132
+ }
133
+ for (const file of installed.files) {
134
+ const target = join(projectRoot, file.path);
135
+ if (!existsSync(target)) {
136
+ plan.push({ action: "delete", target: file.path, status: "missing" });
137
+ continue;
138
+ }
139
+ assertNoSymlink(target);
140
+ const currentSha = sha256File(target);
141
+ if (currentSha !== file.installedSha256 && !options.force) {
142
+ plan.push({ action: "delete", target: file.path, status: "conflict" });
143
+ conflicts.push(removeConflictMessage(installed, file));
144
+ continue;
145
+ }
146
+ plan.push({ action: "delete", target: file.path, status: "delete" });
147
+ removedFiles.push(file.path);
148
+ }
149
+ planModuleSkillLinkRemoval(projectRoot, firstPartyModuleManifests[options.id], plan);
150
+ plan.push({ action: "package", target: "package.json", status: "update" });
151
+ plan.push({ action: "patch", target: templateServerFile(installed.template), status: "update" });
152
+ plan.push({ action: "state", target: ".raybase/modules.json", status: "update" });
153
+ if (conflicts.length && !options.dryRun) {
154
+ return removeResult(projectRoot, options.id, Boolean(options.dryRun), Boolean(options.force), false, plan, removedFiles, conflicts, ["Resolve conflicts or rerun with --force."]);
155
+ }
156
+ if (!options.dryRun) {
157
+ applyRemoveHooks(projectRoot, options.id, installed.template, installed.placement);
158
+ removeModuleSkillLinks(projectRoot, firstPartyModuleManifests[options.id]);
159
+ for (const file of installed.files) {
160
+ const target = join(projectRoot, file.path);
161
+ if (!existsSync(target))
162
+ continue;
163
+ if (sha256File(target) === file.installedSha256 || options.force)
164
+ rmSync(target, { recursive: true, force: true });
165
+ }
166
+ applyPackageModule(projectRoot, firstPartyModuleManifests[options.id], false, installed.placement);
167
+ delete lock.modules[options.id];
168
+ lock.updatedAt = new Date().toISOString();
169
+ writeModuleLock(projectRoot, lock);
170
+ }
171
+ return removeResult(projectRoot, options.id, Boolean(options.dryRun), Boolean(options.force), !conflicts.length, plan, removedFiles, conflicts, []);
172
+ }
173
+ export function setFirstPartyModuleEnabled(projectRoot, id, enabled, template) {
174
+ const lock = readModuleLock(projectRoot) ?? emptyModuleLock();
175
+ const existing = lock.modules[id];
176
+ const now = new Date().toISOString();
177
+ if (existing) {
178
+ existing.enabled = enabled;
179
+ existing.updatedAt = now;
180
+ }
181
+ else {
182
+ const manifest = firstPartyModuleManifests[id];
183
+ lock.modules[id] = {
184
+ id,
185
+ packageName: manifest.packageName,
186
+ version: manifest.version,
187
+ enabled,
188
+ installedAt: now,
189
+ updatedAt: now,
190
+ template,
191
+ placement: id === "docs" ? "spine" : undefined,
192
+ files: [],
193
+ dependencies: manifest.dependencies,
194
+ devDependencies: manifest.devDependencies,
195
+ skills: manifest.skills,
196
+ commands: manifest.commands,
197
+ doctorHooks: manifest.doctorHooks,
198
+ nextSteps: manifest.nextSteps
199
+ };
200
+ }
201
+ lock.updatedAt = now;
202
+ writeModuleLock(projectRoot, lock);
203
+ applyPackageModule(projectRoot, firstPartyModuleManifests[id], enabled, existing?.placement);
204
+ }
205
+ function resolveInstallPlacement(id, template, placement) {
206
+ if (id !== "docs")
207
+ return undefined;
208
+ if (!placement)
209
+ return "spine";
210
+ if (placement === "site" && template !== "astro-emdash")
211
+ throw new Error("Docs placement \"site\" is only supported by the astro-emdash template.");
212
+ return placement;
213
+ }
214
+ export function firstPartyModuleEnabled(projectRoot, id) {
215
+ return resolveFirstPartyModuleState(projectRoot, id).enabled;
216
+ }
217
+ function planModuleFiles(projectRoot, sourceRoot, manifest, template, placement, overwrite, plan, installedFiles, conflicts) {
218
+ for (const rel of firstPartyModuleFiles(manifest, template, { docsPlacement: placement })) {
219
+ const source = resolveInside(sourceRoot, rel);
220
+ const target = resolveInside(projectRoot, rel);
221
+ assertNoSymlink(source);
222
+ assertNoSymlink(target);
223
+ if (!existsSync(source) || !statSync(source).isFile())
224
+ throw new Error(`${manifest.id} template file ${rel} is missing.`);
225
+ const sourceSha = sha256File(source);
226
+ if (existsSync(target)) {
227
+ if (!statSync(target).isFile()) {
228
+ plan.push({ action: "copy", target: rel, status: "conflict" });
229
+ conflicts.push(`${rel} already exists and is not a file.`);
230
+ }
231
+ else {
232
+ const targetSha = sha256File(target);
233
+ if (targetSha === sourceSha)
234
+ plan.push({ action: "copy", target: rel, status: "unchanged" });
235
+ else if (overwrite)
236
+ plan.push({ action: "copy", target: rel, status: "update" });
237
+ else {
238
+ plan.push({ action: "copy", target: rel, status: "conflict" });
239
+ conflicts.push(`${rel} already exists with different content.`);
240
+ }
241
+ }
242
+ }
243
+ else {
244
+ plan.push({ action: "copy", target: rel, status: "create" });
245
+ }
246
+ installedFiles.push({
247
+ path: rel,
248
+ mode: inferFirstPartyModuleFileMode(manifest.id, template, rel),
249
+ installedSha256: sourceSha,
250
+ sourceSha256: sourceSha
251
+ });
252
+ }
253
+ }
254
+ function applyModuleFiles(projectRoot, sourceRoot, manifest, template, placement, overwrite) {
255
+ for (const rel of firstPartyModuleFiles(manifest, template, { docsPlacement: placement })) {
256
+ const source = resolveInside(sourceRoot, rel);
257
+ const target = resolveInside(projectRoot, rel);
258
+ if (existsSync(target) && sha256File(target) === sha256File(source))
259
+ continue;
260
+ if (existsSync(target)) {
261
+ if (!overwrite)
262
+ throw new Error(`${rel} already exists with different content.`);
263
+ rmSync(target, { recursive: true, force: true });
264
+ }
265
+ mkdirSync(dirname(target), { recursive: true });
266
+ cpSync(source, target, { force: true });
267
+ }
268
+ }
269
+ function moduleSkillLink(skill) {
270
+ return {
271
+ path: `.claude/skills/${skill}`,
272
+ target: `../../.agents/skills/${skill}`
273
+ };
274
+ }
275
+ function pathEntryExists(path) {
276
+ try {
277
+ lstatSync(path);
278
+ return true;
279
+ }
280
+ catch (error) {
281
+ if (error.code === "ENOENT")
282
+ return false;
283
+ throw error;
284
+ }
285
+ }
286
+ function isExpectedSkillLink(path, target) {
287
+ return pathEntryExists(path) && lstatSync(path).isSymbolicLink() && readlinkSync(path) === target;
288
+ }
289
+ function planModuleSkillLinks(projectRoot, manifest, plan, conflicts) {
290
+ for (const skill of manifest.skills) {
291
+ const link = moduleSkillLink(skill);
292
+ const path = join(projectRoot, link.path);
293
+ if (!pathEntryExists(path)) {
294
+ plan.push({ action: "link", target: link.path, status: "create" });
295
+ }
296
+ else if (isExpectedSkillLink(path, link.target)) {
297
+ plan.push({ action: "link", target: link.path, status: "unchanged" });
298
+ }
299
+ else {
300
+ plan.push({ action: "link", target: link.path, status: "conflict" });
301
+ conflicts.push(`${link.path} already exists and is not the expected Raybase skill link.`);
302
+ }
303
+ }
304
+ }
305
+ function applyModuleSkillLinks(projectRoot, manifest) {
306
+ for (const skill of manifest.skills) {
307
+ const link = moduleSkillLink(skill);
308
+ const path = join(projectRoot, link.path);
309
+ if (pathEntryExists(path)) {
310
+ if (isExpectedSkillLink(path, link.target))
311
+ continue;
312
+ throw new Error(`${link.path} already exists and is not the expected Raybase skill link.`);
313
+ }
314
+ mkdirSync(dirname(path), { recursive: true });
315
+ symlinkSync(link.target, path);
316
+ }
317
+ }
318
+ function planModuleSkillLinkRemoval(projectRoot, manifest, plan) {
319
+ for (const skill of manifest.skills) {
320
+ const link = moduleSkillLink(skill);
321
+ const path = join(projectRoot, link.path);
322
+ if (isExpectedSkillLink(path, link.target)) {
323
+ plan.push({ action: "delete", target: link.path, status: "delete" });
324
+ }
325
+ }
326
+ }
327
+ function removeModuleSkillLinks(projectRoot, manifest) {
328
+ for (const skill of manifest.skills) {
329
+ const link = moduleSkillLink(skill);
330
+ const path = join(projectRoot, link.path);
331
+ if (isExpectedSkillLink(path, link.target))
332
+ rmSync(path);
333
+ }
334
+ }
335
+ function applyModuleUpdate(projectRoot, sourceRoot, manifest, template, installed, placement, overwrite) {
336
+ const preservedInstalledSha = new Map();
337
+ for (const rel of firstPartyModuleFiles(manifest, template, { docsPlacement: placement })) {
338
+ const mode = inferFirstPartyModuleFileMode(manifest.id, template, rel);
339
+ const source = resolveInside(sourceRoot, rel);
340
+ const target = resolveInside(projectRoot, rel);
341
+ assertNoSymlink(source);
342
+ assertNoSymlink(target);
343
+ const locked = installed.files.find((file) => file.path === rel);
344
+ if (mode === "generated") {
345
+ if (existsSync(target) && locked)
346
+ preservedInstalledSha.set(rel, locked.installedSha256);
347
+ continue;
348
+ }
349
+ if (mode === "editable" && existsSync(target)) {
350
+ if (locked)
351
+ preservedInstalledSha.set(rel, locked.installedSha256);
352
+ continue;
353
+ }
354
+ if (mode === "copy" && existsSync(target)) {
355
+ if (!overwrite && locked && sha256File(target) !== locked.installedSha256) {
356
+ throw new Error(`${rel} has local edits.`);
357
+ }
358
+ if (sha256File(target) === sha256File(source))
359
+ continue;
360
+ rmSync(target, { recursive: true, force: true });
361
+ }
362
+ mkdirSync(dirname(target), { recursive: true });
363
+ cpSync(source, target, { force: true });
364
+ }
365
+ applyPackageModule(projectRoot, manifest, true, placement);
366
+ applyUpdateHooks(projectRoot, manifest.id, template, placement);
367
+ return updatedModuleLockFiles(sourceRoot, manifest, template, placement, preservedInstalledSha);
368
+ }
369
+ function updatedModuleLockFiles(sourceRoot, manifest, template, placement, preservedInstalledSha) {
370
+ return firstPartyModuleFiles(manifest, template, { docsPlacement: placement }).map((rel) => {
371
+ const source = resolveInside(sourceRoot, rel);
372
+ assertNoSymlink(source);
373
+ if (!existsSync(source) || !statSync(source).isFile())
374
+ throw new Error(`${manifest.id} template file ${rel} is missing.`);
375
+ const sourceSha = sha256File(source);
376
+ const mode = inferFirstPartyModuleFileMode(manifest.id, template, rel);
377
+ return {
378
+ path: rel,
379
+ mode,
380
+ installedSha256: preservedInstalledSha.get(rel) ?? sourceSha,
381
+ sourceSha256: sourceSha
382
+ };
383
+ });
384
+ }
385
+ function writeInstalledModule(projectRoot, manifest, template, files, enabled, placement) {
386
+ const lock = readModuleLock(projectRoot) ?? emptyModuleLock();
387
+ const now = new Date().toISOString();
388
+ const existing = lock.modules[manifest.id];
389
+ lock.updatedAt = now;
390
+ lock.modules[manifest.id] = {
391
+ id: manifest.id,
392
+ packageName: manifest.packageName,
393
+ version: manifest.version,
394
+ enabled,
395
+ installedAt: existing?.installedAt ?? now,
396
+ updatedAt: now,
397
+ template,
398
+ placement: manifest.id === "docs" ? placement ?? "spine" : undefined,
399
+ files: files.map((file) => ({
400
+ ...file,
401
+ mode: inferFirstPartyModuleFileMode(manifest.id, template, file.path)
402
+ })),
403
+ dependencies: manifest.dependencies,
404
+ devDependencies: manifest.devDependencies,
405
+ skills: manifest.skills,
406
+ commands: manifest.commands,
407
+ doctorHooks: manifest.doctorHooks,
408
+ nextSteps: manifest.nextSteps
409
+ };
410
+ writeModuleLock(projectRoot, lock);
411
+ }
412
+ function applyPackageModule(projectRoot, manifest, enabled, placement) {
413
+ const file = join(projectRoot, "package.json");
414
+ const parsed = JSON.parse(readFileSync(file, "utf8"));
415
+ parsed.raybase = {
416
+ ...(parsed.raybase ?? {}),
417
+ modules: {
418
+ ...(parsed.raybase?.modules ?? {}),
419
+ [manifest.id]: manifest.id === "docs" ? { enabled, package: manifest.packageName, placement: placement ?? "spine" } : { enabled, package: manifest.packageName }
420
+ }
421
+ };
422
+ parsed.dependencies = parsed.dependencies ?? {};
423
+ parsed.devDependencies = parsed.devDependencies ?? {};
424
+ if (enabled) {
425
+ const rootDeps = manifest.id === "docs" && placement === "site" ? { "@raybase/docs": manifest.dependencies["@raybase/docs"] } : manifest.dependencies;
426
+ const rootDevDeps = manifest.id === "docs" && placement === "site" ? {} : manifest.devDependencies;
427
+ for (const [name, range] of Object.entries(rootDeps))
428
+ parsed.dependencies[name] = preferredDependencyRange(projectRoot, parsed, name, range);
429
+ for (const [name, range] of Object.entries(rootDevDeps))
430
+ parsed.devDependencies[name] = parsed.devDependencies[name] ?? range;
431
+ if (manifest.id === "docs" && placement === "site")
432
+ applySiteDocsPackageModule(projectRoot, enabled, manifest);
433
+ }
434
+ else {
435
+ delete parsed.dependencies[manifest.packageName];
436
+ if (manifest.id === "docs") {
437
+ for (const name of ["fumadocs-core", "fumadocs-ui"])
438
+ delete parsed.dependencies[name];
439
+ for (const name of ["fumadocs-mdx", "@types/mdx"])
440
+ delete parsed.devDependencies[name];
441
+ applySiteDocsPackageModule(projectRoot, enabled, manifest);
442
+ }
443
+ }
444
+ if (Object.keys(parsed.dependencies).length === 0)
445
+ delete parsed.dependencies;
446
+ if (Object.keys(parsed.devDependencies).length === 0)
447
+ delete parsed.devDependencies;
448
+ writeFileSync(file, `${JSON.stringify(parsed, null, 2)}\n`);
449
+ }
450
+ function applySiteDocsPackageModule(projectRoot, enabled, manifest) {
451
+ const file = join(projectRoot, "site/package.json");
452
+ if (!existsSync(file))
453
+ return;
454
+ const parsed = JSON.parse(readFileSync(file, "utf8"));
455
+ parsed.dependencies = parsed.dependencies ?? {};
456
+ parsed.devDependencies = parsed.devDependencies ?? {};
457
+ if (enabled) {
458
+ for (const name of ["fumadocs-core", "fumadocs-ui", "lucide-react"])
459
+ parsed.dependencies[name] = parsed.dependencies[name] ?? manifest.dependencies[name];
460
+ for (const name of ["fumadocs-mdx", "@types/mdx"])
461
+ parsed.devDependencies[name] = parsed.devDependencies[name] ?? manifest.devDependencies[name];
462
+ }
463
+ else {
464
+ for (const name of ["fumadocs-core", "fumadocs-ui", "lucide-react"])
465
+ delete parsed.dependencies[name];
466
+ for (const name of ["fumadocs-mdx", "@types/mdx"])
467
+ delete parsed.devDependencies[name];
468
+ }
469
+ if (Object.keys(parsed.dependencies).length === 0)
470
+ delete parsed.dependencies;
471
+ if (Object.keys(parsed.devDependencies).length === 0)
472
+ delete parsed.devDependencies;
473
+ writeFileSync(file, `${JSON.stringify(parsed, null, 2)}\n`);
474
+ }
475
+ function preferredDependencyRange(projectRoot, parsed, name, fallback) {
476
+ const existing = parsed.dependencies?.[name] ?? parsed.devDependencies?.[name];
477
+ if (existing)
478
+ return existing;
479
+ if (!name.startsWith("@raybase/"))
480
+ return fallback;
481
+ const core = parsed.dependencies?.["@raybase/core"] ?? parsed.devDependencies?.["@raybase/core"];
482
+ if (core?.startsWith("link:")) {
483
+ const packageDir = name.split("/")[1];
484
+ const corePath = core.slice("link:".length);
485
+ return `link:${join(dirname(corePath), packageDir)}`;
486
+ }
487
+ return fallback;
488
+ }
489
+ function applyInstallHooks(projectRoot, id, template, placement) {
490
+ if (id === "docs") {
491
+ patchServerModule(projectRoot, template, "docs", true, placement);
492
+ patchDocsUi(projectRoot, template, true, placement);
493
+ patchDocsProvider(projectRoot, template, true, placement);
494
+ patchDocsVite(projectRoot, true, placement);
495
+ patchDocsAstro(projectRoot, true, placement);
496
+ patchDocsGitignore(projectRoot, true, placement);
497
+ patchDocsCss(projectRoot, template, true, placement);
498
+ }
499
+ else if (id === "guide") {
500
+ patchServerModule(projectRoot, template, "guide", true);
501
+ patchGuideUi(projectRoot, template, true);
502
+ patchGuideCss(projectRoot, template, true);
503
+ enableTemplateAi(projectRoot, template);
504
+ if (!firstPartyModuleEnabled(projectRoot, "docs"))
505
+ disableGuideDocsSurface(projectRoot, template);
506
+ }
507
+ else if (id === "api") {
508
+ patchServerModule(projectRoot, template, "api", true);
509
+ declareWranglerRequiredSecrets(projectRoot, ["RAYBASE_API_KEY_SECRET"]);
510
+ setDevVar(projectRoot, "RAYBASE_API_KEY_SECRET", randomSecret());
511
+ }
512
+ else {
513
+ patchServerModule(projectRoot, template, "openai-subscription", true);
514
+ declareWranglerRequiredSecrets(projectRoot, ["RAYBASE_OPENAI_SUBSCRIPTION_KEY"]);
515
+ enableTemplateAi(projectRoot, template);
516
+ enableOpenAISubscriptionCodexEgress(projectRoot);
517
+ enableOpenAISubscriptionAiConfig(projectRoot);
518
+ }
519
+ }
520
+ function applyUpdateHooks(projectRoot, id, template, placement) {
521
+ if (id === "docs") {
522
+ patchServerModule(projectRoot, template, "docs", true, placement);
523
+ patchDocsUi(projectRoot, template, true, placement);
524
+ patchDocsProvider(projectRoot, template, true, placement);
525
+ patchDocsVite(projectRoot, true, placement);
526
+ patchDocsAstro(projectRoot, true, placement);
527
+ patchDocsGitignore(projectRoot, true, placement);
528
+ patchDocsCss(projectRoot, template, true, placement);
529
+ }
530
+ else if (id === "guide") {
531
+ patchServerModule(projectRoot, template, "guide", true);
532
+ patchGuideUi(projectRoot, template, true);
533
+ patchGuideCss(projectRoot, template, true);
534
+ enableTemplateAi(projectRoot, template);
535
+ }
536
+ else if (id === "api") {
537
+ patchServerModule(projectRoot, template, "api", true);
538
+ declareWranglerRequiredSecrets(projectRoot, ["RAYBASE_API_KEY_SECRET"]);
539
+ }
540
+ else {
541
+ patchServerModule(projectRoot, template, "openai-subscription", true);
542
+ declareWranglerRequiredSecrets(projectRoot, ["RAYBASE_OPENAI_SUBSCRIPTION_KEY"]);
543
+ enableTemplateAi(projectRoot, template);
544
+ enableOpenAISubscriptionCodexEgress(projectRoot);
545
+ enableOpenAISubscriptionAiConfig(projectRoot);
546
+ }
547
+ }
548
+ function applyRemoveHooks(projectRoot, id, template, placement) {
549
+ if (id === "docs") {
550
+ patchServerModule(projectRoot, template, "docs", false, placement);
551
+ patchDocsUi(projectRoot, template, false, placement);
552
+ patchDocsProvider(projectRoot, template, false, placement);
553
+ patchDocsVite(projectRoot, false, placement);
554
+ patchDocsAstro(projectRoot, false, placement);
555
+ patchDocsCss(projectRoot, template, false, placement);
556
+ if (firstPartyModuleEnabled(projectRoot, "guide"))
557
+ disableGuideDocsSurface(projectRoot, template);
558
+ }
559
+ else if (id === "guide") {
560
+ patchServerModule(projectRoot, template, "guide", false);
561
+ patchGuideUi(projectRoot, template, false);
562
+ patchGuideCss(projectRoot, template, false);
563
+ }
564
+ else if (id === "api") {
565
+ patchServerModule(projectRoot, template, "api", false);
566
+ }
567
+ else {
568
+ patchServerModule(projectRoot, template, "openai-subscription", false);
569
+ removeOpenAISubscriptionAiConfig(projectRoot);
570
+ }
571
+ }
572
+ function patchServerModule(projectRoot, template, id, enabled, placement) {
573
+ const file = join(projectRoot, templateServerFile(template));
574
+ if (!existsSync(file))
575
+ return;
576
+ let source = readFileSync(file, "utf8");
577
+ const docsEnabled = id === "docs" ? enabled : hasExactImport(source, "@raybase/docs", "docsModule");
578
+ const guideEnabled = id === "guide" ? enabled : hasExactImport(source, "@raybase/guide", "guideModule");
579
+ const apiEnabled = id === "api" ? enabled : hasExactImport(source, "./api/operations", "api");
580
+ const openaiSubscriptionEnabled = id === "openai-subscription"
581
+ ? enabled
582
+ : hasExactImport(source, template === "react-router" ? "./openai-subscription" : "./openai-subscription", "openaiSubscription");
583
+ if (enabled) {
584
+ if (id === "docs") {
585
+ source = ensureExactImport(source, "@raybase/docs", "docsModule", "raybase");
586
+ }
587
+ if (id === "guide") {
588
+ source = ensureExactImport(source, "@raybase/guide", "guideModule", "raybase");
589
+ source = ensureExactImport(source, "./guide/actions", "guideActions", "imports");
590
+ source = ensureExactImport(source, "./guide/config", "guideConfig", "imports");
591
+ source = ensureExactImport(source, "./guide/corpus", "guideCorpus", "imports");
592
+ }
593
+ if (id === "api") {
594
+ source = ensureExactImport(source, "./api/operations", "api", "imports");
595
+ }
596
+ if (id === "openai-subscription") {
597
+ source = ensureExactImport(source, "./openai-subscription", "openaiSubscription", "imports");
598
+ }
599
+ }
600
+ else {
601
+ if (id === "docs") {
602
+ source = removeExactImport(source, "@raybase/docs", "docsModule");
603
+ }
604
+ else if (id === "guide") {
605
+ source = removeExactImport(source, "@raybase/guide", "guideModule");
606
+ source = removeExactImport(source, "./guide/actions", "guideActions");
607
+ source = removeExactImport(source, "./guide/config", "guideConfig");
608
+ source = removeExactImport(source, "./guide/corpus", "guideCorpus");
609
+ }
610
+ else if (id === "api") {
611
+ source = removeExactImport(source, "./api/operations", "api");
612
+ }
613
+ else {
614
+ source = removeExactImport(source, "./openai-subscription", "openaiSubscription");
615
+ }
616
+ }
617
+ source = replaceNamedRegion(source, "raybase:modules", renderModulesRegion({
618
+ template,
619
+ docs: docsEnabled,
620
+ guide: guideEnabled,
621
+ api: apiEnabled,
622
+ openaiSubscription: openaiSubscriptionEnabled,
623
+ docsPlacement: placement ?? currentDocsPlacement(projectRoot)
624
+ }));
625
+ if (docsEnabled || guideEnabled)
626
+ source = ensureRaybaseEnvImport(source);
627
+ writeFileSync(file, source);
628
+ }
629
+ function currentDocsPlacement(projectRoot) {
630
+ try {
631
+ const lock = readModuleLock(projectRoot);
632
+ const placement = lock?.modules.docs?.placement;
633
+ if (placement === "site")
634
+ return "site";
635
+ }
636
+ catch {
637
+ // package.json fallback below.
638
+ }
639
+ try {
640
+ const parsed = JSON.parse(readFileSync(join(projectRoot, "package.json"), "utf8"));
641
+ return parsed.raybase?.modules?.docs?.placement === "site" ? "site" : "spine";
642
+ }
643
+ catch {
644
+ return "spine";
645
+ }
646
+ }
647
+ function patchDocsUi(projectRoot, template, enabled, placement) {
648
+ if (template === "astro-emdash" && placement === "site") {
649
+ if (!enabled) {
650
+ for (const rel of docsSitePlacementFiles().filter((file) => file.includes("/pages/docs/")))
651
+ rmSync(join(projectRoot, rel), { force: true });
652
+ }
653
+ return;
654
+ }
655
+ const rel = docsLayoutRouteFile(template);
656
+ const target = join(projectRoot, rel);
657
+ if (enabled) {
658
+ const source = join(moduleTemplateRoot("docs", template), rel);
659
+ if (!existsSync(source))
660
+ throw new Error(`Docs layout route is missing from the ${template} module template: ${source}`);
661
+ mkdirSync(dirname(target), { recursive: true });
662
+ cpSync(source, target);
663
+ }
664
+ else {
665
+ rmSync(target, { force: true });
666
+ }
667
+ }
668
+ function docsLayoutRouteFile(template) {
669
+ return template === "react-router" ? "app/routes/docs.tsx" : "src/routes/docs.tsx";
670
+ }
671
+ function patchDocsProvider(projectRoot, template, enabled, placement) {
672
+ if (template !== "tanstack-start" && !(template === "astro-emdash" && placement !== "site"))
673
+ return;
674
+ const file = join(projectRoot, "src/routes/__root.tsx");
675
+ if (!existsSync(file))
676
+ return;
677
+ let source = readFileSync(file, "utf8");
678
+ const importLine = 'import { RootProvider } from "fumadocs-ui/provider/tanstack";\n';
679
+ if (enabled) {
680
+ source = ensureImportLine(source, importLine);
681
+ if (!source.includes("<RootProvider")) {
682
+ source = source.replace(" {devServerSsr ? <LoadingShell /> : <Outlet />}", ' <RootProvider search={{ options: { api: "/docs/api/search" } }}>\n {devServerSsr ? <LoadingShell /> : <Outlet />}\n </RootProvider>');
683
+ }
684
+ }
685
+ else {
686
+ source = source.replace(importLine, "");
687
+ source = source.replace(/ <RootProvider search=\{\{ options: \{ api: "\/docs\/api\/search" \} \}\}>\n \{devServerSsr \? <LoadingShell \/> : <Outlet \/>\}\n <\/RootProvider>/, " {devServerSsr ? <LoadingShell /> : <Outlet />}");
688
+ }
689
+ writeFileSync(file, source);
690
+ }
691
+ function patchGuideUi(projectRoot, template, enabled) {
692
+ const file = join(projectRoot, template === "react-router" ? "app/root.tsx" : "src/routes/__root.tsx");
693
+ if (!existsSync(file))
694
+ return;
695
+ let source = readFileSync(file, "utf8");
696
+ const importLine = template === "react-router" ? 'import { GuideWidget } from "./components/guide-widget";\n' : 'import { GuideWidget } from "../components/guide-widget";\n';
697
+ const renderLine = template === "react-router" ? " <GuideWidget />" : " {devServerSsr ? null : <GuideWidget />}";
698
+ if (enabled) {
699
+ source = ensureImportLine(source, importLine);
700
+ source = replaceNamedRegion(source, "raybase:guide-widget", renderLine);
701
+ }
702
+ else {
703
+ source = source.replace(importLine, "");
704
+ source = replaceNamedRegion(source, "raybase:guide-widget", "");
705
+ }
706
+ writeFileSync(file, source);
707
+ }
708
+ function patchGuideCss(projectRoot, template, enabled) {
709
+ const file = join(projectRoot, template === "react-router" ? "app/app.css" : "src/styles.css");
710
+ if (!existsSync(file))
711
+ return;
712
+ let source = readFileSync(file, "utf8");
713
+ const line = '@source "../node_modules/@raybase/agent-ui/dist";\n';
714
+ if (enabled) {
715
+ if (!source.includes(line))
716
+ source = source.replace(/^@import "tailwindcss";\n/m, `@import "tailwindcss";\n${line}`);
717
+ }
718
+ else {
719
+ source = source.replace(line, "");
720
+ }
721
+ writeFileSync(file, source);
722
+ }
723
+ function patchDocsVite(projectRoot, enabled, placement) {
724
+ if (placement === "site")
725
+ return;
726
+ const file = join(projectRoot, "vite.config.ts");
727
+ if (!existsSync(file))
728
+ return;
729
+ let source = readFileSync(file, "utf8");
730
+ if (enabled) {
731
+ if (!source.includes('from "fumadocs-mdx/vite"'))
732
+ source = insertAfterImportBlock(source, 'import mdx from "fumadocs-mdx/vite";\n');
733
+ if (!/\bmdx\(\)/.test(source))
734
+ source = source.replace(/plugins:\s*\[/, "plugins: [mdx(), ");
735
+ source = ensureViteResolveTsconfigPaths(source);
736
+ source = ensureViteSsrReactOptimizeDeps(source);
737
+ }
738
+ else {
739
+ source = source.replace(/^import mdx from "fumadocs-mdx\/vite";\n/m, "").replace(/\bmdx\(\),\s*/g, "");
740
+ }
741
+ writeFileSync(file, source);
742
+ }
743
+ function ensureViteResolveTsconfigPaths(source) {
744
+ if (/tsconfigPaths\s*:\s*true/.test(source))
745
+ return source;
746
+ if (/resolve\s*:\s*\{/.test(source)) {
747
+ return source.replace(/resolve\s*:\s*\{/, "resolve: {\n tsconfigPaths: true,");
748
+ }
749
+ return insertViteTopLevelProperty(source, " resolve: {\n tsconfigPaths: true\n }");
750
+ }
751
+ function ensureViteSsrReactOptimizeDeps(source) {
752
+ const includeLine = 'include: ["react", "react/jsx-runtime", "react-dom/server"]';
753
+ if (source.includes(includeLine))
754
+ return source;
755
+ const optimizeDeps = ` optimizeDeps: {\n ${includeLine}\n }`;
756
+ if (/ssr\s*:\s*\{/.test(source)) {
757
+ if (/ssr\s*:\s*\{[\s\S]*?optimizeDeps\s*:\s*\{/.test(source))
758
+ return source;
759
+ return source.replace(/ssr\s*:\s*\{/, `ssr: {\n${optimizeDeps},`);
760
+ }
761
+ return insertViteTopLevelProperty(source, ` ssr: {\n${optimizeDeps}\n }`);
762
+ }
763
+ function insertViteTopLevelProperty(source, property) {
764
+ const index = source.lastIndexOf("};");
765
+ if (index === -1)
766
+ return source;
767
+ const prefix = source.slice(0, index).replace(/\s*$/, "");
768
+ const suffix = source.slice(index);
769
+ const separator = prefix.endsWith("{") || prefix.endsWith(",") ? "\n" : ",\n";
770
+ return `${prefix}${separator}${property}\n${suffix}`;
771
+ }
772
+ function patchDocsAstro(projectRoot, enabled, placement) {
773
+ if (placement !== "site")
774
+ return;
775
+ const file = join(projectRoot, "site/astro.config.mjs");
776
+ if (!existsSync(file))
777
+ return;
778
+ let source = readFileSync(file, "utf8");
779
+ if (enabled) {
780
+ if (!source.includes('from "fumadocs-mdx/vite"'))
781
+ source = insertAfterImportBlock(source, 'import mdx from "fumadocs-mdx/vite";\n');
782
+ if (!/\bmdx\(\)/.test(source))
783
+ source = source.replace(/vite:\s*\{\s*/, (match) => `${match}plugins: [mdx()],\n `);
784
+ }
785
+ else {
786
+ source = source.replace(/^import mdx from "fumadocs-mdx\/vite";\n/m, "").replace(/\s*plugins:\s*\[\s*mdx\(\)\s*\],?\n/m, "");
787
+ }
788
+ writeFileSync(file, source);
789
+ }
790
+ function patchDocsGitignore(projectRoot, enabled, placement) {
791
+ if (placement !== "site" || !enabled)
792
+ return;
793
+ const file = join(projectRoot, "site/.gitignore");
794
+ const source = existsSync(file) ? readFileSync(file, "utf8") : "";
795
+ if (/(^|\n)\.source\/?(\n|$)/.test(source))
796
+ return;
797
+ writeFileSync(file, `${source.replace(/\s*$/, "")}\n.source/\n`);
798
+ }
799
+ function patchDocsCss(projectRoot, template, enabled, placement) {
800
+ if (template === "astro-emdash" && placement === "site")
801
+ return;
802
+ const file = join(projectRoot, template === "react-router" ? "app/app.css" : "src/styles.css");
803
+ if (!existsSync(file))
804
+ return;
805
+ let source = readFileSync(file, "utf8");
806
+ const imports = '@import "fumadocs-ui/css/neutral.css";\n@import "fumadocs-ui/css/preset.css";\n';
807
+ source = removeDocsCssImports(source);
808
+ if (enabled && template === "react-router") {
809
+ source = source.replace(/^@import "tailwindcss";\n/m, `@import "tailwindcss";\n${imports}`);
810
+ }
811
+ writeFileSync(file, source);
812
+ }
813
+ function removeDocsCssImports(source) {
814
+ return source
815
+ .replace(/^\/\* Keep after app Tailwind integrations so Fumadocs layout utilities win the cascade in Vite dev\. \*\/\n/m, "")
816
+ .replace(/^@import "fumadocs-ui\/style\.css";\n/m, "")
817
+ .replace(/^@import "fumadocs-ui\/css\/neutral\.css";\n/m, "")
818
+ .replace(/^@import "fumadocs-ui\/css\/preset\.css";\n/m, "");
819
+ }
820
+ function disableGuideDocsSurface(projectRoot, template) {
821
+ const file = join(projectRoot, template === "react-router" ? "app/guide/config.ts" : "src/guide/config.ts");
822
+ if (!existsSync(file))
823
+ return;
824
+ const source = readFileSync(file, "utf8");
825
+ const next = source.replace(/docs: \{ enabled: true, audience: "signed-in" \}/, 'docs: { enabled: false, audience: "signed-in" }');
826
+ if (next !== source)
827
+ writeFileSync(file, next);
828
+ }
829
+ function enableTemplateAi(projectRoot, template) {
830
+ const file = join(projectRoot, "wrangler.jsonc");
831
+ if (!existsSync(file))
832
+ return;
833
+ const source = readFileSync(file, "utf8");
834
+ const parsed = parse(source);
835
+ if (!parsed.ai) {
836
+ writeFileSync(file, editJsoncValue(source, ["ai"], { binding: "AI" }));
837
+ }
838
+ if (template === "tanstack-start") {
839
+ const latest = readFileSync(file, "utf8");
840
+ writeFileSync(file, removeLocalAiPlaceholder(editJsoncValue(latest, ["env", "local-dev", "ai"], { binding: "AI", remote: true })));
841
+ declareWranglerRequiredSecrets(projectRoot, ["RAYBASE_ENV", "RAYBASE_AI_MODE"]);
842
+ setDevVar(projectRoot, "RAYBASE_ENV", "local");
843
+ setDevVar(projectRoot, "RAYBASE_AI_MODE", "live");
844
+ }
845
+ enableTemplateAiConfig(projectRoot);
846
+ }
847
+ const OPENAI_SUBSCRIPTION_CODEX_EGRESS_BINDING = {
848
+ binding: "CODEX_EGRESS",
849
+ network_id: "cf1:network",
850
+ remote: true
851
+ };
852
+ function enableOpenAISubscriptionCodexEgress(projectRoot) {
853
+ const file = join(projectRoot, "wrangler.jsonc");
854
+ if (!existsSync(file))
855
+ return;
856
+ let source = readFileSync(file, "utf8");
857
+ source = ensureOpenAISubscriptionCodexEgressAtPath(source, ["vpc_networks"]);
858
+ writeFileSync(file, source);
859
+ }
860
+ function ensureOpenAISubscriptionCodexEgressAtPath(source, path) {
861
+ const parsed = parse(source);
862
+ let value = parsed;
863
+ for (const segment of path)
864
+ value = value && typeof value === "object" ? value[segment] : undefined;
865
+ if (value !== undefined && !Array.isArray(value)) {
866
+ throw new Error(`${path.join(".")} in wrangler.jsonc must be an array before installing openai-subscription.`);
867
+ }
868
+ const bindings = Array.isArray(value) ? value : [];
869
+ const index = bindings.findIndex((candidate) => candidate && typeof candidate === "object" && candidate.binding === "CODEX_EGRESS");
870
+ if (index === -1) {
871
+ return editJsoncValue(source, path, [...bindings, OPENAI_SUBSCRIPTION_CODEX_EGRESS_BINDING]);
872
+ }
873
+ const candidate = bindings[index];
874
+ if (candidate.network_id === "cf1:network" && candidate.remote === true)
875
+ return source;
876
+ return editJsoncValue(source, [...path, index], OPENAI_SUBSCRIPTION_CODEX_EGRESS_BINDING);
877
+ }
878
+ function enableTemplateAiConfig(projectRoot) {
879
+ const candidates = ["src/raybase.config.ts", "app/db/schema.ts"];
880
+ for (const candidate of candidates) {
881
+ const file = join(projectRoot, candidate);
882
+ if (!existsSync(file))
883
+ continue;
884
+ const source = readFileSync(file, "utf8");
885
+ if (/^\s*ai\s*:/m.test(source))
886
+ return;
887
+ // Keeps the Gateway and BYOK hints in the template's comment above the block.
888
+ let next = source.replace(/\n\s*\/\/ To enable user-facing AI (?:chat )?features, run `raybase ai enable`\.\n([\s\S]*?)[ \t]*\/\/ ai: \{[\s\S]*?\n\s*\/\/ \}\n?/m, (_match, hints) => `\n${hints}${DEFAULT_AI_CONFIG_BLOCK}\n`);
889
+ if (next === source && candidate === "app/db/schema.ts") {
890
+ next = source.replace(/realtime:\s*\{\s*enabled:\s*true\s*\}/, (match) => `${match},\n${DEFAULT_AI_CONFIG_BLOCK}`);
891
+ }
892
+ if (next === source) {
893
+ next = source.replace(/\n\}\s+satisfies\s+RaybaseConfig;/, `,\n${DEFAULT_AI_CONFIG_BLOCK}\n} satisfies RaybaseConfig;`);
894
+ }
895
+ if (next !== source)
896
+ writeFileSync(file, next);
897
+ return;
898
+ }
899
+ }
900
+ function enableOpenAISubscriptionAiConfig(projectRoot) {
901
+ for (const candidate of ["src/raybase.config.ts", "app/db/schema.ts"]) {
902
+ const file = join(projectRoot, candidate);
903
+ if (!existsSync(file))
904
+ continue;
905
+ let source = readFileSync(file, "utf8");
906
+ if (!/^\s*ai\s*:/m.test(source)) {
907
+ source = source.replace(/\n\}\s+satisfies\s+RaybaseConfig;/, ',\n ai: { enabled: true, provider: "openai-codex-subscription" }\n} satisfies RaybaseConfig;');
908
+ }
909
+ else if (!/provider:\s*"openai-codex-subscription"/.test(source)) {
910
+ source = source.replace(/ai:\s*\{\s*enabled:\s*true/, 'ai: { enabled: true, provider: "openai-codex-subscription"');
911
+ }
912
+ writeFileSync(file, source);
913
+ return;
914
+ }
915
+ }
916
+ function removeOpenAISubscriptionAiConfig(projectRoot) {
917
+ for (const candidate of ["src/raybase.config.ts", "app/db/schema.ts"]) {
918
+ const file = join(projectRoot, candidate);
919
+ if (!existsSync(file))
920
+ continue;
921
+ const source = readFileSync(file, "utf8");
922
+ const next = source
923
+ .replace(/,\s*provider:\s*"openai-codex-subscription"/g, "")
924
+ .replace(/provider:\s*"openai-codex-subscription",?\s*/g, "");
925
+ if (next !== source)
926
+ writeFileSync(file, next);
927
+ }
928
+ }
929
+ function moduleFileDrift(projectRoot, lock) {
930
+ const drift = [];
931
+ for (const file of lock.files) {
932
+ if (moduleFileMode(lock, file) !== "copy")
933
+ continue;
934
+ const target = join(projectRoot, file.path);
935
+ if (!existsSync(target))
936
+ drift.push(`${file.path} is missing.`);
937
+ else if (sha256File(target) !== file.installedSha256)
938
+ drift.push(`${file.path} has local edits.`);
939
+ }
940
+ return drift;
941
+ }
942
+ function moduleSourceChanges(sourceRoot, manifest, template, installed, placement) {
943
+ const current = new Map(installed.files.map((file) => [file.path, file]));
944
+ return firstPartyModuleFiles(manifest, template, { docsPlacement: placement }).flatMap((rel) => {
945
+ const source = join(sourceRoot, rel);
946
+ if (!existsSync(source))
947
+ return [`${rel} is missing from the ${manifest.id} module template.`];
948
+ const sourceSha = sha256File(source);
949
+ const file = current.get(rel);
950
+ if (file?.sourceSha256 === sourceSha)
951
+ return [];
952
+ const mode = file ? moduleFileMode(installed, file) : inferFirstPartyModuleFileMode(manifest.id, template, rel);
953
+ if (mode === "editable")
954
+ return [`${rel} is app-owned; review the updated starter template manually instead of overwriting app content.`];
955
+ if (mode === "generated")
956
+ return [`${rel} is generated app state; run raybase guide index with the current CLI to regenerate it.`];
957
+ return [`${rel} has an updated module source.`];
958
+ });
959
+ }
960
+ function moduleHasAutomaticSourceChanges(sourceRoot, manifest, template, installed, placement) {
961
+ const current = new Map(installed.files.map((file) => [file.path, file]));
962
+ return firstPartyModuleFiles(manifest, template, { docsPlacement: placement }).some((rel) => {
963
+ const source = join(sourceRoot, rel);
964
+ if (!existsSync(source))
965
+ return true;
966
+ const file = current.get(rel);
967
+ const mode = file ? moduleFileMode(installed, file) : inferFirstPartyModuleFileMode(manifest.id, template, rel);
968
+ return mode === "copy" && file?.sourceSha256 !== sha256File(source);
969
+ });
970
+ }
971
+ function moduleStateWarnings(projectRoot, installed) {
972
+ const warnings = [];
973
+ for (const file of installed.files) {
974
+ if (existsSync(join(projectRoot, file.path)))
975
+ continue;
976
+ const mode = moduleFileMode(installed, file);
977
+ if (mode === "editable") {
978
+ warnings.push(`${file.path} is app-owned; module update will restore the current starter template because no file exists.`);
979
+ }
980
+ else if (mode === "generated") {
981
+ warnings.push(`${file.path} is generated app state; run raybase guide index with the current CLI to regenerate it.`);
982
+ }
983
+ }
984
+ return warnings;
985
+ }
986
+ function removeConflictMessage(installed, file) {
987
+ const mode = moduleFileMode(installed, file);
988
+ if (mode === "editable")
989
+ return `${file.path} contains app-authored content.`;
990
+ if (mode === "generated")
991
+ return `${file.path} contains generated Guide corpus state.`;
992
+ return `${file.path} has local edits.`;
993
+ }
994
+ function removeResult(projectRoot, id, dryRun, force, ok, plan, removedFiles, conflicts, warnings) {
995
+ return {
996
+ ok,
997
+ module: id,
998
+ projectDir: projectRoot,
999
+ removed: ok,
1000
+ dryRun,
1001
+ force,
1002
+ plan,
1003
+ removedFiles,
1004
+ conflicts,
1005
+ warnings,
1006
+ lockFile: join(projectRoot, ".raybase/modules.json"),
1007
+ nextSteps: ["Run raybase modules doctor.", "Run raybase doctor."]
1008
+ };
1009
+ }
1010
+ function templateServerFile(template) {
1011
+ return template === "react-router" ? "app/raybase.server.ts" : "src/raybase.server.ts";
1012
+ }
1013
+ function insertAfterRaybaseImport(source, line) {
1014
+ const match = source.match(/^import .* from "@raybase\/(?:core|pro)";\n/m);
1015
+ if (!match?.index && match?.index !== 0)
1016
+ return insertAfterImportBlock(source, line);
1017
+ return `${source.slice(0, match.index + match[0].length)}${line}${source.slice(match.index + match[0].length)}`;
1018
+ }
1019
+ function insertAfterImportBlock(source, line) {
1020
+ const matches = [...source.matchAll(/^import .*\n/gm)];
1021
+ const last = matches.at(-1);
1022
+ if (!last?.index && last?.index !== 0)
1023
+ return `${line}${source}`;
1024
+ return `${source.slice(0, last.index + last[0].length)}${line}${source.slice(last.index + last[0].length)}`;
1025
+ }
1026
+ function editJsoncValue(source, path, value) {
1027
+ return applyEdits(source, modify(source, path, value, { formattingOptions: { insertSpaces: true, tabSize: 2 } }));
1028
+ }
1029
+ function removeLocalAiPlaceholder(source) {
1030
+ return source.replace(/\n\s*\/\/ Live local Workers AI uses a remote binding and Wrangler login\.\n\s*\/\/ Add with `raybase ai enable --dev --mode live`:\n\s*\/\/ "ai": \{\n\s*\/\/ "binding": "AI",\n\s*\/\/ "remote": true\n\s*\/\/ \},/m, "");
1031
+ }
1032
+ function setDevVar(projectRoot, key, value) {
1033
+ const file = join(projectRoot, ".dev.vars");
1034
+ const raw = existsSync(file) ? readFileSync(file, "utf8") : "";
1035
+ const lines = raw ? raw.split(/\r?\n/) : [];
1036
+ let replaced = false;
1037
+ const next = lines.map((line) => {
1038
+ if (new RegExp(`^\\s*${escapeRegExp(key)}\\s*=`).test(line)) {
1039
+ replaced = true;
1040
+ return `${key}=${value}`;
1041
+ }
1042
+ return line;
1043
+ });
1044
+ if (!replaced) {
1045
+ if (next.length && next[next.length - 1] !== "")
1046
+ next.push("");
1047
+ next.push(`${key}=${value}`);
1048
+ }
1049
+ writeFileSync(file, `${next.join("\n").replace(/\n+$/, "")}\n`);
1050
+ }
1051
+ function hasExactImport(source, moduleSpecifier, binding) {
1052
+ return exactImportPattern(moduleSpecifier, binding).test(source);
1053
+ }
1054
+ function ensureExactImport(source, moduleSpecifier, binding, anchor) {
1055
+ if (hasExactImport(source, moduleSpecifier, binding))
1056
+ return source;
1057
+ const line = `import { ${binding} } from "${moduleSpecifier}";\n`;
1058
+ return anchor === "raybase" ? insertAfterRaybaseImport(source, line) : insertAfterImportBlock(source, line);
1059
+ }
1060
+ function ensureImportLine(source, line) {
1061
+ return source.includes(line) ? source : insertAfterImportBlock(source, line);
1062
+ }
1063
+ function removeExactImport(source, moduleSpecifier, binding) {
1064
+ return source.replace(exactImportPattern(moduleSpecifier, binding), "");
1065
+ }
1066
+ function exactImportPattern(moduleSpecifier, binding) {
1067
+ return new RegExp(`^import \\{ ${escapeRegExp(binding)} \\} from "${escapeRegExp(moduleSpecifier)}";\\n`, "m");
1068
+ }
1069
+ // The React Router framework's createRaybaseApp is typed by its worker Env
1070
+ // (env.d.ts, which workers/app.ts passes through), so its modules are too.
1071
+ function moduleEnvType(template) {
1072
+ return template === "react-router" ? "Env" : "RaybaseEnv";
1073
+ }
1074
+ function renderModulesRegion(input) {
1075
+ const env = moduleEnvType(input.template);
1076
+ const docsModuleCall = input.docs && input.docsPlacement === "site" ? ` docsModule<${env}>({ placement: "site", audience: "public" })` : ` docsModule<${env}>()`;
1077
+ const entries = [
1078
+ input.docs ? docsModuleCall : null,
1079
+ input.guide ? ` guideModule<${env}>({ config: guideConfig, corpus: guideCorpus, actions: guideActions })` : null,
1080
+ input.api ? " api" : null,
1081
+ input.openaiSubscription ? " openaiSubscription" : null
1082
+ ].filter(Boolean);
1083
+ return entries.length
1084
+ ? `modules: [\n${entries.join(",\n")}\n],`
1085
+ : "modules: [],";
1086
+ }
1087
+ function randomSecret() {
1088
+ return randomBytes(32).toString("hex");
1089
+ }
1090
+ function replaceNamedRegion(source, name, body) {
1091
+ const start = `${name}:start`;
1092
+ const end = `${name}:end`;
1093
+ const startMatches = indexesOf(source, start);
1094
+ const endMatches = indexesOf(source, end);
1095
+ if (startMatches.length !== 1 || endMatches.length !== 1 || endMatches[0] < startMatches[0]) {
1096
+ throw new Error(`Expected exactly one ordered ${name} anchor region.`);
1097
+ }
1098
+ const startLineEnd = source.indexOf("\n", startMatches[0]);
1099
+ const endLineStart = source.lastIndexOf("\n", endMatches[0]);
1100
+ if (startLineEnd === -1 || endLineStart === -1 || endLineStart < startLineEnd) {
1101
+ throw new Error(`Malformed ${name} anchor region.`);
1102
+ }
1103
+ const linePrefix = source.slice(source.lastIndexOf("\n", startMatches[0]) + 1, startMatches[0]);
1104
+ const indent = /^\s*/.exec(linePrefix)?.[0] ?? "";
1105
+ const replacement = body.trim()
1106
+ ? `\n${indent}${body.trim().replace(/\n/g, `\n${indent}`)}\n${indent}`
1107
+ : `\n${indent}`;
1108
+ return `${source.slice(0, startLineEnd)}${replacement}${source.slice(endLineStart)}`;
1109
+ }
1110
+ function ensureRaybaseEnvImport(source) {
1111
+ if (/^import\s+(?:type\s+)?\{[^}]*\bRaybaseEnv\b[^}]*\}\s+from "@raybase\/core\/worker";\n/m.test(source))
1112
+ return source;
1113
+ return ensureImportLine(source, 'import type { RaybaseEnv } from "@raybase/core/worker";\n');
1114
+ }
1115
+ function indexesOf(source, needle) {
1116
+ const indexes = [];
1117
+ let index = source.indexOf(needle);
1118
+ while (index !== -1) {
1119
+ indexes.push(index);
1120
+ index = source.indexOf(needle, index + needle.length);
1121
+ }
1122
+ return indexes;
1123
+ }
1124
+ function escapeRegExp(value) {
1125
+ return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
1126
+ }
1127
+ function changedTargets(plan) {
1128
+ return plan
1129
+ .filter((entry) => entry.target && (entry.status === "create" || entry.status === "update" || entry.status === "delete"))
1130
+ .map((entry) => entry.target)
1131
+ .sort((left, right) => left.localeCompare(right));
1132
+ }
1133
+ //# sourceMappingURL=module-install.js.map