@raybase/create 0.0.1 → 0.3.3

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 (644) hide show
  1. package/LICENSE +21 -0
  2. package/THIRD_PARTY_NOTICES.md +38 -0
  3. package/assets/apple-touch-icons/0.png +0 -0
  4. package/assets/apple-touch-icons/1.png +0 -0
  5. package/assets/apple-touch-icons/2.png +0 -0
  6. package/assets/apple-touch-icons/3.png +0 -0
  7. package/assets/apple-touch-icons/4.png +0 -0
  8. package/assets/apple-touch-icons/5.png +0 -0
  9. package/assets/apple-touch-icons/6.png +0 -0
  10. package/assets/apple-touch-icons/7.png +0 -0
  11. package/assets/apple-touch-icons/8.png +0 -0
  12. package/assets/apple-touch-icons/9.png +0 -0
  13. package/assets/apple-touch-icons/A.png +0 -0
  14. package/assets/apple-touch-icons/B.png +0 -0
  15. package/assets/apple-touch-icons/C.png +0 -0
  16. package/assets/apple-touch-icons/D.png +0 -0
  17. package/assets/apple-touch-icons/E.png +0 -0
  18. package/assets/apple-touch-icons/F.png +0 -0
  19. package/assets/apple-touch-icons/G.png +0 -0
  20. package/assets/apple-touch-icons/H.png +0 -0
  21. package/assets/apple-touch-icons/I.png +0 -0
  22. package/assets/apple-touch-icons/J.png +0 -0
  23. package/assets/apple-touch-icons/K.png +0 -0
  24. package/assets/apple-touch-icons/L.png +0 -0
  25. package/assets/apple-touch-icons/M.png +0 -0
  26. package/assets/apple-touch-icons/N.png +0 -0
  27. package/assets/apple-touch-icons/O.png +0 -0
  28. package/assets/apple-touch-icons/P.png +0 -0
  29. package/assets/apple-touch-icons/Q.png +0 -0
  30. package/assets/apple-touch-icons/R.png +0 -0
  31. package/assets/apple-touch-icons/S.png +0 -0
  32. package/assets/apple-touch-icons/T.png +0 -0
  33. package/assets/apple-touch-icons/U.png +0 -0
  34. package/assets/apple-touch-icons/V.png +0 -0
  35. package/assets/apple-touch-icons/W.png +0 -0
  36. package/assets/apple-touch-icons/X.png +0 -0
  37. package/assets/apple-touch-icons/Y.png +0 -0
  38. package/assets/apple-touch-icons/Z.png +0 -0
  39. package/assets/apple-touch-icons/default.png +0 -0
  40. package/dist/.source-hash +1 -0
  41. package/dist/index.d.ts +56 -0
  42. package/dist/index.d.ts.map +1 -0
  43. package/dist/index.js +2351 -0
  44. package/dist/index.js.map +1 -0
  45. package/dist/raybase-package-ranges.d.ts +11 -0
  46. package/dist/raybase-package-ranges.d.ts.map +1 -0
  47. package/dist/raybase-package-ranges.js +11 -0
  48. package/dist/raybase-package-ranges.js.map +1 -0
  49. package/dist/source-fetch.d.ts +91 -0
  50. package/dist/source-fetch.d.ts.map +1 -0
  51. package/dist/source-fetch.js +325 -0
  52. package/dist/source-fetch.js.map +1 -0
  53. package/dist/source-hash.d.ts +2 -0
  54. package/dist/source-hash.d.ts.map +1 -0
  55. package/dist/source-hash.js +23 -0
  56. package/dist/source-hash.js.map +1 -0
  57. package/dist/starter-description.d.ts +44 -0
  58. package/dist/starter-description.d.ts.map +1 -0
  59. package/dist/starter-description.js +273 -0
  60. package/dist/starter-description.js.map +1 -0
  61. package/dist/starter-source.d.ts +43 -0
  62. package/dist/starter-source.d.ts.map +1 -0
  63. package/dist/starter-source.js +156 -0
  64. package/dist/starter-source.js.map +1 -0
  65. package/dist/store-app-apply.d.ts +27 -0
  66. package/dist/store-app-apply.d.ts.map +1 -0
  67. package/dist/store-app-apply.js +100 -0
  68. package/dist/store-app-apply.js.map +1 -0
  69. package/dist/store-app-manifest.d.ts +86 -0
  70. package/dist/store-app-manifest.d.ts.map +1 -0
  71. package/dist/store-app-manifest.js +110 -0
  72. package/dist/store-app-manifest.js.map +1 -0
  73. package/dist/store-app-registry.d.ts +30 -0
  74. package/dist/store-app-registry.d.ts.map +1 -0
  75. package/dist/store-app-registry.js +232 -0
  76. package/dist/store-app-registry.js.map +1 -0
  77. package/models/recommended.json +42 -0
  78. package/modules/api/templates/react-router/app/api/operations.ts +8 -0
  79. package/modules/api/templates/tanstack-start/src/api/operations.ts +15 -0
  80. package/modules/docs/templates/astro-emdash/content/docs/getting-started.mdx +13 -0
  81. package/modules/docs/templates/astro-emdash/content/docs/index.mdx +13 -0
  82. package/modules/docs/templates/astro-emdash/content/docs/mcp.mdx +11 -0
  83. package/modules/docs/templates/astro-emdash/content/docs/meta.json +4 -0
  84. package/modules/docs/templates/astro-emdash/site/content/docs/getting-started.mdx +12 -0
  85. package/modules/docs/templates/astro-emdash/site/content/docs/index.mdx +12 -0
  86. package/modules/docs/templates/astro-emdash/site/content/docs/mcp.mdx +10 -0
  87. package/modules/docs/templates/astro-emdash/site/content/docs/meta.json +4 -0
  88. package/modules/docs/templates/astro-emdash/site/source.config.ts +10 -0
  89. package/modules/docs/templates/astro-emdash/site/src/docs/docs-assets.ts +1 -0
  90. package/modules/docs/templates/astro-emdash/site/src/docs/docs-client.tsx +22 -0
  91. package/modules/docs/templates/astro-emdash/site/src/docs/docs-data.ts +24 -0
  92. package/modules/docs/templates/astro-emdash/site/src/docs/docs-handler.tsx +105 -0
  93. package/modules/docs/templates/astro-emdash/site/src/docs/docs-layout.tsx +56 -0
  94. package/modules/docs/templates/astro-emdash/site/src/docs/docs-mdx.tsx +79 -0
  95. package/modules/docs/templates/astro-emdash/site/src/docs/docs-page-actions.tsx +146 -0
  96. package/modules/docs/templates/astro-emdash/site/src/docs/docs-page.tsx +70 -0
  97. package/modules/docs/templates/astro-emdash/site/src/docs/llm-text.ts +61 -0
  98. package/modules/docs/templates/astro-emdash/site/src/docs/source.ts +7 -0
  99. package/modules/docs/templates/astro-emdash/site/src/pages/docs/[...slug].ts +6 -0
  100. package/modules/docs/templates/astro-emdash/site/src/pages/docs/api/markdown.ts +4 -0
  101. package/modules/docs/templates/astro-emdash/site/src/pages/docs/api/search.ts +4 -0
  102. package/modules/docs/templates/astro-emdash/site/src/pages/llms.txt.ts +8 -0
  103. package/modules/docs/templates/astro-emdash/site/src/styles-docs.css +3 -0
  104. package/modules/docs/templates/astro-emdash/source.config.ts +10 -0
  105. package/modules/docs/templates/astro-emdash/src/docs/docs-assets.ts +1 -0
  106. package/modules/docs/templates/astro-emdash/src/docs/docs-client.tsx +22 -0
  107. package/modules/docs/templates/astro-emdash/src/docs/docs-data.ts +24 -0
  108. package/modules/docs/templates/astro-emdash/src/docs/docs-handler.tsx +105 -0
  109. package/modules/docs/templates/astro-emdash/src/docs/docs-layout.tsx +56 -0
  110. package/modules/docs/templates/astro-emdash/src/docs/docs-mdx.tsx +79 -0
  111. package/modules/docs/templates/astro-emdash/src/docs/docs-page-actions.tsx +146 -0
  112. package/modules/docs/templates/astro-emdash/src/docs/docs-page.tsx +70 -0
  113. package/modules/docs/templates/astro-emdash/src/docs/llm-text.ts +61 -0
  114. package/modules/docs/templates/astro-emdash/src/docs/source.ts +7 -0
  115. package/modules/docs/templates/astro-emdash/src/routes/docs/$.tsx +22 -0
  116. package/modules/docs/templates/astro-emdash/src/routes/docs/api/markdown.ts +12 -0
  117. package/modules/docs/templates/astro-emdash/src/routes/docs/api/search.ts +12 -0
  118. package/modules/docs/templates/astro-emdash/src/routes/docs.index.tsx +22 -0
  119. package/modules/docs/templates/astro-emdash/src/routes/docs.tsx +22 -0
  120. package/modules/docs/templates/astro-emdash/src/styles-docs.css +3 -0
  121. package/modules/docs/templates/react-router/app/components/mdx.tsx +79 -0
  122. package/modules/docs/templates/react-router/app/lib/layout.shared.tsx +54 -0
  123. package/modules/docs/templates/react-router/app/lib/source.ts +7 -0
  124. package/modules/docs/templates/react-router/app/routes/docs.$.tsx +49 -0
  125. package/modules/docs/templates/react-router/app/routes/docs.api.search.ts +10 -0
  126. package/modules/docs/templates/react-router/app/routes/docs.tsx +13 -0
  127. package/modules/docs/templates/react-router/content/docs/getting-started.mdx +8 -0
  128. package/modules/docs/templates/react-router/content/docs/index.mdx +8 -0
  129. package/modules/docs/templates/react-router/content/docs/mcp.mdx +121 -0
  130. package/modules/docs/templates/react-router/content/docs/meta.json +4 -0
  131. package/modules/docs/templates/react-router/source.config.ts +5 -0
  132. package/modules/docs/templates/tanstack-start/content/docs/getting-started.mdx +10 -0
  133. package/modules/docs/templates/tanstack-start/content/docs/index.mdx +8 -0
  134. package/modules/docs/templates/tanstack-start/content/docs/mcp.mdx +121 -0
  135. package/modules/docs/templates/tanstack-start/content/docs/meta.json +4 -0
  136. package/modules/docs/templates/tanstack-start/source.config.ts +10 -0
  137. package/modules/docs/templates/tanstack-start/src/docs/docs-assets.ts +1 -0
  138. package/modules/docs/templates/tanstack-start/src/docs/docs-client.tsx +22 -0
  139. package/modules/docs/templates/tanstack-start/src/docs/docs-data.ts +24 -0
  140. package/modules/docs/templates/tanstack-start/src/docs/docs-handler.tsx +105 -0
  141. package/modules/docs/templates/tanstack-start/src/docs/docs-layout.tsx +56 -0
  142. package/modules/docs/templates/tanstack-start/src/docs/docs-mdx.tsx +79 -0
  143. package/modules/docs/templates/tanstack-start/src/docs/docs-page-actions.tsx +146 -0
  144. package/modules/docs/templates/tanstack-start/src/docs/docs-page.tsx +70 -0
  145. package/modules/docs/templates/tanstack-start/src/docs/llm-text.ts +61 -0
  146. package/modules/docs/templates/tanstack-start/src/docs/source.ts +7 -0
  147. package/modules/docs/templates/tanstack-start/src/routes/docs/$.tsx +22 -0
  148. package/modules/docs/templates/tanstack-start/src/routes/docs/api/markdown.ts +12 -0
  149. package/modules/docs/templates/tanstack-start/src/routes/docs/api/search.ts +12 -0
  150. package/modules/docs/templates/tanstack-start/src/routes/docs.index.tsx +22 -0
  151. package/modules/docs/templates/tanstack-start/src/routes/docs.tsx +22 -0
  152. package/modules/docs/templates/tanstack-start/src/styles-docs.css +3 -0
  153. package/modules/guide/templates/astro-emdash/content/guide/capability-map.md +17 -0
  154. package/modules/guide/templates/astro-emdash/src/components/guide-widget.tsx +41 -0
  155. package/modules/guide/templates/astro-emdash/src/guide/actions.ts +8 -0
  156. package/modules/guide/templates/astro-emdash/src/guide/config.ts +21 -0
  157. package/modules/guide/templates/astro-emdash/src/guide/corpus.gen.ts +4 -0
  158. package/modules/guide/templates/astro-emdash/src/guide/corpus.manifest.json +72 -0
  159. package/modules/guide/templates/astro-emdash/src/guide/corpus.ts +4 -0
  160. package/modules/guide/templates/astro-emdash/src/guide/resources.json +4 -0
  161. package/modules/guide/templates/react-router/app/components/guide-widget.tsx +29 -0
  162. package/modules/guide/templates/react-router/app/guide/actions.ts +3 -0
  163. package/modules/guide/templates/react-router/app/guide/config.ts +21 -0
  164. package/modules/guide/templates/react-router/app/guide/corpus.gen.ts +4 -0
  165. package/modules/guide/templates/react-router/app/guide/corpus.manifest.json +22 -0
  166. package/modules/guide/templates/react-router/app/guide/corpus.ts +4 -0
  167. package/modules/guide/templates/react-router/app/guide/resources.json +4 -0
  168. package/modules/guide/templates/react-router/content/guide/capability-map.md +13 -0
  169. package/modules/guide/templates/tanstack-start/content/guide/capability-map.md +17 -0
  170. package/modules/guide/templates/tanstack-start/src/components/guide-widget.tsx +41 -0
  171. package/modules/guide/templates/tanstack-start/src/guide/actions.ts +17 -0
  172. package/modules/guide/templates/tanstack-start/src/guide/config.ts +21 -0
  173. package/modules/guide/templates/tanstack-start/src/guide/corpus.gen.ts +4 -0
  174. package/modules/guide/templates/tanstack-start/src/guide/corpus.manifest.json +22 -0
  175. package/modules/guide/templates/tanstack-start/src/guide/corpus.ts +4 -0
  176. package/modules/guide/templates/tanstack-start/src/guide/resources.json +4 -0
  177. package/modules/openai-subscription/templates/astro-emdash/.agents/skills/raybase-openai-subscription/SKILL.md +57 -0
  178. package/modules/openai-subscription/templates/astro-emdash/.agents/skills/raybase-openai-subscription/references/compatibility-and-testing.md +129 -0
  179. package/modules/openai-subscription/templates/astro-emdash/.agents/skills/raybase-openai-subscription/references/module-contract.md +133 -0
  180. package/modules/openai-subscription/templates/astro-emdash/.agents/skills/raybase-openai-subscription/references/structured-outputs.md +159 -0
  181. package/modules/openai-subscription/templates/astro-emdash/src/openai-subscription.ts +11 -0
  182. package/modules/openai-subscription/templates/react-router/.agents/skills/raybase-openai-subscription/SKILL.md +57 -0
  183. package/modules/openai-subscription/templates/react-router/.agents/skills/raybase-openai-subscription/references/compatibility-and-testing.md +129 -0
  184. package/modules/openai-subscription/templates/react-router/.agents/skills/raybase-openai-subscription/references/module-contract.md +133 -0
  185. package/modules/openai-subscription/templates/react-router/.agents/skills/raybase-openai-subscription/references/structured-outputs.md +159 -0
  186. package/modules/openai-subscription/templates/react-router/app/openai-subscription.ts +11 -0
  187. package/modules/openai-subscription/templates/tanstack-start/.agents/skills/raybase-openai-subscription/SKILL.md +57 -0
  188. package/modules/openai-subscription/templates/tanstack-start/.agents/skills/raybase-openai-subscription/references/compatibility-and-testing.md +129 -0
  189. package/modules/openai-subscription/templates/tanstack-start/.agents/skills/raybase-openai-subscription/references/module-contract.md +133 -0
  190. package/modules/openai-subscription/templates/tanstack-start/.agents/skills/raybase-openai-subscription/references/structured-outputs.md +159 -0
  191. package/modules/openai-subscription/templates/tanstack-start/src/openai-subscription.ts +11 -0
  192. package/package.json +34 -8
  193. package/skills/README.md +122 -0
  194. package/skills/raybase-actions/SKILL.md +223 -0
  195. package/skills/raybase-actions/references/action-patterns.md +190 -0
  196. package/skills/raybase-actions/references/adapting-actions.md +93 -0
  197. package/skills/raybase-actions/references/testing-actions.md +48 -0
  198. package/skills/raybase-agent-debugging/SKILL.md +230 -0
  199. package/skills/raybase-ai/SKILL.md +1310 -0
  200. package/skills/raybase-api/SKILL.md +45 -0
  201. package/skills/raybase-astro-emdash/SKILL.md +143 -0
  202. package/skills/raybase-astro-emdash-content-model/SKILL.md +217 -0
  203. package/skills/raybase-astro-emdash-content-model/references/LICENSE-emdash +9 -0
  204. package/skills/raybase-astro-emdash-content-model/references/emdash-collections.md +265 -0
  205. package/skills/raybase-astro-emdash-design/LICENSE-impeccable +60 -0
  206. package/skills/raybase-astro-emdash-design/SKILL.md +170 -0
  207. package/skills/raybase-astro-emdash-design/reference/color.md +91 -0
  208. package/skills/raybase-astro-emdash-design/reference/copy.md +73 -0
  209. package/skills/raybase-astro-emdash-design/reference/direction.md +115 -0
  210. package/skills/raybase-astro-emdash-design/reference/imagery.md +84 -0
  211. package/skills/raybase-astro-emdash-design/reference/layout.md +69 -0
  212. package/skills/raybase-astro-emdash-design/reference/motion.md +75 -0
  213. package/skills/raybase-astro-emdash-design/reference/polish.md +75 -0
  214. package/skills/raybase-astro-emdash-design/reference/typography.md +72 -0
  215. package/skills/raybase-astro-emdash-galley/SKILL.md +265 -0
  216. package/skills/raybase-astro-emdash-migration/SKILL.md +218 -0
  217. package/skills/raybase-astro-emdash-migration/references/inventory-and-conversion.md +242 -0
  218. package/skills/raybase-astro-emdash-security-review/SKILL.md +68 -0
  219. package/skills/raybase-astro-emdash-theme-selection/SKILL.md +216 -0
  220. package/skills/raybase-auth/SKILL.md +358 -0
  221. package/skills/raybase-background-jobs/SKILL.md +774 -0
  222. package/skills/raybase-building/SKILL.md +409 -0
  223. package/skills/raybase-building/references/interview-and-spec.md +87 -0
  224. package/skills/raybase-building/references/planning-docs.md +26 -0
  225. package/skills/raybase-building/references/schema-and-config.md +70 -0
  226. package/skills/raybase-changing-a-live-app/SKILL.md +119 -0
  227. package/skills/raybase-data-and-policies/SKILL.md +377 -0
  228. package/skills/raybase-deploy/SKILL.md +136 -0
  229. package/skills/raybase-docs-writing/SKILL.md +119 -0
  230. package/skills/raybase-guide/SKILL.md +235 -0
  231. package/skills/raybase-mcp/SKILL.md +309 -0
  232. package/skills/raybase-mcp/agents/openai.yaml +4 -0
  233. package/skills/raybase-notifications/SKILL.md +138 -0
  234. package/skills/raybase-pro-migration/SKILL.md +28 -0
  235. package/skills/raybase-react-router/SKILL.md +241 -0
  236. package/skills/raybase-react-router-design/LICENSE-impeccable +60 -0
  237. package/skills/raybase-react-router-design/SKILL.md +135 -0
  238. package/skills/raybase-react-router-design/reference/color.md +87 -0
  239. package/skills/raybase-react-router-design/reference/copy.md +83 -0
  240. package/skills/raybase-react-router-design/reference/delight.md +48 -0
  241. package/skills/raybase-react-router-design/reference/interaction.md +91 -0
  242. package/skills/raybase-react-router-design/reference/layout.md +82 -0
  243. package/skills/raybase-react-router-design/reference/motion.md +86 -0
  244. package/skills/raybase-react-router-design/reference/polish.md +79 -0
  245. package/skills/raybase-react-router-design/reference/typography.md +71 -0
  246. package/skills/raybase-react-router-security-review/LICENSE +22 -0
  247. package/skills/raybase-react-router-security-review/SKILL.md +190 -0
  248. package/skills/raybase-react-router-security-review/agents/openai.yaml +4 -0
  249. package/skills/raybase-react-router-security-review/references/api-security.md +519 -0
  250. package/skills/raybase-react-router-security-review/references/authentication.md +353 -0
  251. package/skills/raybase-react-router-security-review/references/authorization.md +372 -0
  252. package/skills/raybase-react-router-security-review/references/business-logic.md +443 -0
  253. package/skills/raybase-react-router-security-review/references/cryptography.md +329 -0
  254. package/skills/raybase-react-router-security-review/references/csrf.md +398 -0
  255. package/skills/raybase-react-router-security-review/references/data-protection.md +378 -0
  256. package/skills/raybase-react-router-security-review/references/deserialization.md +410 -0
  257. package/skills/raybase-react-router-security-review/references/error-handling.md +436 -0
  258. package/skills/raybase-react-router-security-review/references/file-security.md +457 -0
  259. package/skills/raybase-react-router-security-review/references/injection.md +259 -0
  260. package/skills/raybase-react-router-security-review/references/logging.md +433 -0
  261. package/skills/raybase-react-router-security-review/references/misconfiguration.md +435 -0
  262. package/skills/raybase-react-router-security-review/references/modern-threats.md +475 -0
  263. package/skills/raybase-react-router-security-review/references/raybase-react-router-security.md +235 -0
  264. package/skills/raybase-react-router-security-review/references/ssrf.md +413 -0
  265. package/skills/raybase-react-router-security-review/references/supply-chain.md +405 -0
  266. package/skills/raybase-react-router-security-review/references/xss.md +336 -0
  267. package/skills/raybase-realtime/SKILL.md +158 -0
  268. package/skills/raybase-realtime/agents/openai.yaml +4 -0
  269. package/skills/raybase-schema/SKILL.md +209 -0
  270. package/skills/raybase-search/SKILL.md +137 -0
  271. package/skills/raybase-search/agents/openai.yaml +4 -0
  272. package/skills/raybase-settings/SKILL.md +139 -0
  273. package/skills/raybase-settings/agents/openai.yaml +4 -0
  274. package/skills/raybase-tanstack-start/SKILL.md +166 -0
  275. package/skills/raybase-tanstack-start-design/LICENSE-impeccable +60 -0
  276. package/skills/raybase-tanstack-start-design/SKILL.md +140 -0
  277. package/skills/raybase-tanstack-start-design/reference/color.md +80 -0
  278. package/skills/raybase-tanstack-start-design/reference/copy.md +83 -0
  279. package/skills/raybase-tanstack-start-design/reference/delight.md +48 -0
  280. package/skills/raybase-tanstack-start-design/reference/interaction.md +91 -0
  281. package/skills/raybase-tanstack-start-design/reference/layout.md +82 -0
  282. package/skills/raybase-tanstack-start-design/reference/motion.md +86 -0
  283. package/skills/raybase-tanstack-start-design/reference/polish.md +79 -0
  284. package/skills/raybase-tanstack-start-design/reference/typography.md +71 -0
  285. package/skills/raybase-tanstack-start-security-review/LICENSE +22 -0
  286. package/skills/raybase-tanstack-start-security-review/SKILL.md +194 -0
  287. package/skills/raybase-tanstack-start-security-review/agents/openai.yaml +4 -0
  288. package/skills/raybase-tanstack-start-security-review/references/api-security.md +519 -0
  289. package/skills/raybase-tanstack-start-security-review/references/authentication.md +353 -0
  290. package/skills/raybase-tanstack-start-security-review/references/authorization.md +372 -0
  291. package/skills/raybase-tanstack-start-security-review/references/business-logic.md +443 -0
  292. package/skills/raybase-tanstack-start-security-review/references/cryptography.md +329 -0
  293. package/skills/raybase-tanstack-start-security-review/references/csrf.md +398 -0
  294. package/skills/raybase-tanstack-start-security-review/references/data-protection.md +378 -0
  295. package/skills/raybase-tanstack-start-security-review/references/deserialization.md +410 -0
  296. package/skills/raybase-tanstack-start-security-review/references/error-handling.md +436 -0
  297. package/skills/raybase-tanstack-start-security-review/references/file-security.md +457 -0
  298. package/skills/raybase-tanstack-start-security-review/references/injection.md +259 -0
  299. package/skills/raybase-tanstack-start-security-review/references/logging.md +433 -0
  300. package/skills/raybase-tanstack-start-security-review/references/misconfiguration.md +435 -0
  301. package/skills/raybase-tanstack-start-security-review/references/modern-threats.md +475 -0
  302. package/skills/raybase-tanstack-start-security-review/references/raybase-tanstack-security.md +208 -0
  303. package/skills/raybase-tanstack-start-security-review/references/ssrf.md +413 -0
  304. package/skills/raybase-tanstack-start-security-review/references/supply-chain.md +405 -0
  305. package/skills/raybase-tanstack-start-security-review/references/xss.md +336 -0
  306. package/skills-manifest.json +41 -0
  307. package/templates/astro-emdash/.dev.vars.example +7 -0
  308. package/templates/astro-emdash/AGENTS.md +122 -0
  309. package/templates/astro-emdash/DESIGN.md +90 -0
  310. package/templates/astro-emdash/components.json +21 -0
  311. package/templates/astro-emdash/content/docs/getting-started.mdx +20 -0
  312. package/templates/astro-emdash/content/docs/index.mdx +13 -0
  313. package/templates/astro-emdash/content/docs/mcp.mdx +11 -0
  314. package/templates/astro-emdash/content/docs/meta.json +4 -0
  315. package/templates/astro-emdash/content/docs/site-templates.mdx +62 -0
  316. package/templates/astro-emdash/dev/CODEBASE-MAP.md +46 -0
  317. package/templates/astro-emdash/dev/SPEC-OVERVIEW.md +15 -0
  318. package/templates/astro-emdash/dev/SPEC.md +84 -0
  319. package/templates/astro-emdash/dev/features/archive/.gitkeep +1 -0
  320. package/templates/astro-emdash/docs/theme-previews/base.svg +24 -0
  321. package/templates/astro-emdash/docs/theme-previews/steel.svg +24 -0
  322. package/templates/astro-emdash/docs/theme-previews/zen.svg +24 -0
  323. package/templates/astro-emdash/docs/themes.md +106 -0
  324. package/templates/astro-emdash/drizzle.config.ts +5 -0
  325. package/templates/astro-emdash/gitignore +11 -0
  326. package/templates/astro-emdash/migrations/app/meta/_journal.json +5 -0
  327. package/templates/astro-emdash/package.json +79 -0
  328. package/templates/astro-emdash/pnpm-workspace.yaml +71 -0
  329. package/templates/astro-emdash/public/_headers +4 -0
  330. package/templates/astro-emdash/site/astro.config.mjs +120 -0
  331. package/templates/astro-emdash/site/demo/README.md +72 -0
  332. package/templates/astro-emdash/site/demo/content/collection.json +43 -0
  333. package/templates/astro-emdash/site/demo/content/entries.json +120 -0
  334. package/templates/astro-emdash/site/demo/templates/demo-article-card/manifest.json +51 -0
  335. package/templates/astro-emdash/site/demo/templates/demo-article-card/sample-content.json +5 -0
  336. package/templates/astro-emdash/site/demo/templates/demo-article-card/template.liquid +48 -0
  337. package/templates/astro-emdash/site/demo/templates/demo-article-page/host.json +9 -0
  338. package/templates/astro-emdash/site/demo/templates/demo-article-page/manifest.json +38 -0
  339. package/templates/astro-emdash/site/demo/templates/demo-article-page/sample-content.json +34 -0
  340. package/templates/astro-emdash/site/demo/templates/demo-article-page/template.liquid +84 -0
  341. package/templates/astro-emdash/site/demo/templates/demo-articles-index/manifest.json +64 -0
  342. package/templates/astro-emdash/site/demo/templates/demo-articles-index/page.json +7 -0
  343. package/templates/astro-emdash/site/demo/templates/demo-articles-index/sample-content.json +24 -0
  344. package/templates/astro-emdash/site/demo/templates/demo-articles-index/template.liquid +100 -0
  345. package/templates/astro-emdash/site/demo/templates/demo-menu-nav/manifest.json +51 -0
  346. package/templates/astro-emdash/site/demo/templates/demo-menu-nav/sample-content.json +5 -0
  347. package/templates/astro-emdash/site/demo/templates/demo-menu-nav/template.liquid +70 -0
  348. package/templates/astro-emdash/site/gitignore +1 -0
  349. package/templates/astro-emdash/site/package.json +56 -0
  350. package/templates/astro-emdash/site/scripts/apply-site-templates.mjs +560 -0
  351. package/templates/astro-emdash/site/scripts/galley-demo.mjs +298 -0
  352. package/templates/astro-emdash/site/scripts/seed-galley-starter.mjs +360 -0
  353. package/templates/astro-emdash/site/scripts/site-origin.mjs +45 -0
  354. package/templates/astro-emdash/site/seed/seed.json +154 -0
  355. package/templates/astro-emdash/site/seed/templates/.gitkeep +1 -0
  356. package/templates/astro-emdash/site/src/components/RaybaseSignedInMenu.astro +163 -0
  357. package/templates/astro-emdash/site/src/components/blocks/RaybaseActionIsland.astro +41 -0
  358. package/templates/astro-emdash/site/src/content-door/raybase-routes.ts +738 -0
  359. package/templates/astro-emdash/site/src/content-door/resolve-page.ts +142 -0
  360. package/templates/astro-emdash/site/src/content-door/seed.ts +85 -0
  361. package/templates/astro-emdash/site/src/env.d.ts +12 -0
  362. package/templates/astro-emdash/site/src/layouts/SiteLayout.astro +68 -0
  363. package/templates/astro-emdash/site/src/lib/palettes.gen.ts +7 -0
  364. package/templates/astro-emdash/site/src/lib/site-motion.ts +169 -0
  365. package/templates/astro-emdash/site/src/lib/site-shell.ts +294 -0
  366. package/templates/astro-emdash/site/src/live.config.ts +8 -0
  367. package/templates/astro-emdash/site/src/middleware.ts +20 -0
  368. package/templates/astro-emdash/site/src/pages/[...slug].astro +113 -0
  369. package/templates/astro-emdash/site/src/pages/_raybase/handoff/consume.ts +6 -0
  370. package/templates/astro-emdash/site/src/pages/_raybase/islands/action.ts +8 -0
  371. package/templates/astro-emdash/site/src/pages/_raybase/sign-out/index.ts +6 -0
  372. package/templates/astro-emdash/site/src/styles/palette-fonts.gen.css +1 -0
  373. package/templates/astro-emdash/site/src/styles/palettes.gen.css +3 -0
  374. package/templates/astro-emdash/site/src/styles.css +607 -0
  375. package/templates/astro-emdash/site/tsconfig.json +12 -0
  376. package/templates/astro-emdash/site/wrangler.jsonc +34 -0
  377. package/templates/astro-emdash/source.config.ts +10 -0
  378. package/templates/astro-emdash/src/actions.ts +58 -0
  379. package/templates/astro-emdash/src/ai/agents.ts +20 -0
  380. package/templates/astro-emdash/src/ai/retrieval.ts +36 -0
  381. package/templates/astro-emdash/src/auth-door.ts +18 -0
  382. package/templates/astro-emdash/src/client.tsx +25 -0
  383. package/templates/astro-emdash/src/components/.gitkeep +1 -0
  384. package/templates/astro-emdash/src/components/account-menu.tsx +91 -0
  385. package/templates/astro-emdash/src/components/auth-shell.tsx +69 -0
  386. package/templates/astro-emdash/src/components/mode-toggle.tsx +32 -0
  387. package/templates/astro-emdash/src/components/search-command-palette.tsx +107 -0
  388. package/templates/astro-emdash/src/components/setup-token-page.tsx +196 -0
  389. package/templates/astro-emdash/src/components/ui/avatar.tsx +107 -0
  390. package/templates/astro-emdash/src/components/ui/badge.tsx +52 -0
  391. package/templates/astro-emdash/src/components/ui/button.tsx +69 -0
  392. package/templates/astro-emdash/src/components/ui/checkbox.tsx +29 -0
  393. package/templates/astro-emdash/src/components/ui/dialog.tsx +158 -0
  394. package/templates/astro-emdash/src/components/ui/dropdown-menu.tsx +303 -0
  395. package/templates/astro-emdash/src/components/ui/input.tsx +20 -0
  396. package/templates/astro-emdash/src/components/ui/label.tsx +20 -0
  397. package/templates/astro-emdash/src/components/ui/scroll-area.tsx +53 -0
  398. package/templates/astro-emdash/src/components/ui/select.tsx +215 -0
  399. package/templates/astro-emdash/src/components/ui/separator.tsx +23 -0
  400. package/templates/astro-emdash/src/components/ui/sheet.tsx +138 -0
  401. package/templates/astro-emdash/src/components/ui/sidebar.tsx +728 -0
  402. package/templates/astro-emdash/src/components/ui/skeleton.tsx +13 -0
  403. package/templates/astro-emdash/src/components/ui/textarea.tsx +18 -0
  404. package/templates/astro-emdash/src/components/ui/tooltip.tsx +66 -0
  405. package/templates/astro-emdash/src/db/migrations.gen.ts +6 -0
  406. package/templates/astro-emdash/src/db/schema.ts +6 -0
  407. package/templates/astro-emdash/src/db/seed.ts +16 -0
  408. package/templates/astro-emdash/src/db/storage.ts +32 -0
  409. package/templates/astro-emdash/src/docs/docs-assets.ts +1 -0
  410. package/templates/astro-emdash/src/docs/docs-client.tsx +22 -0
  411. package/templates/astro-emdash/src/docs/docs-data.ts +24 -0
  412. package/templates/astro-emdash/src/docs/docs-handler.tsx +105 -0
  413. package/templates/astro-emdash/src/docs/docs-layout.tsx +56 -0
  414. package/templates/astro-emdash/src/docs/docs-mdx.tsx +79 -0
  415. package/templates/astro-emdash/src/docs/docs-page-actions.tsx +146 -0
  416. package/templates/astro-emdash/src/docs/docs-page.tsx +70 -0
  417. package/templates/astro-emdash/src/docs/llm-text.ts +61 -0
  418. package/templates/astro-emdash/src/docs/source.ts +7 -0
  419. package/templates/astro-emdash/src/guide/corpus.gen.ts +4 -0
  420. package/templates/astro-emdash/src/guide/corpus.manifest.json +72 -0
  421. package/templates/astro-emdash/src/hooks/use-mobile.ts +19 -0
  422. package/templates/astro-emdash/src/jobs.example.ts +48 -0
  423. package/templates/astro-emdash/src/lib/account.ts +12 -0
  424. package/templates/astro-emdash/src/lib/auth-client.ts +181 -0
  425. package/templates/astro-emdash/src/lib/utils.ts +6 -0
  426. package/templates/astro-emdash/src/mcp-app.ts +57 -0
  427. package/templates/astro-emdash/src/notifications.example.ts +37 -0
  428. package/templates/astro-emdash/src/raybase.auth.ts +70 -0
  429. package/templates/astro-emdash/src/raybase.config.ts +49 -0
  430. package/templates/astro-emdash/src/raybase.server.ts +56 -0
  431. package/templates/astro-emdash/src/realtime.example.ts +18 -0
  432. package/templates/astro-emdash/src/router.tsx +19 -0
  433. package/templates/astro-emdash/src/routes/__root.tsx +56 -0
  434. package/templates/astro-emdash/src/routes/_app/admin.tsx +13 -0
  435. package/templates/astro-emdash/src/routes/_app/forgot-password.tsx +97 -0
  436. package/templates/astro-emdash/src/routes/_app/index.tsx +169 -0
  437. package/templates/astro-emdash/src/routes/_app/invite.$token.tsx +11 -0
  438. package/templates/astro-emdash/src/routes/_app/login.tsx +193 -0
  439. package/templates/astro-emdash/src/routes/_app/profile.tsx +98 -0
  440. package/templates/astro-emdash/src/routes/_app/reset-password.$token.tsx +15 -0
  441. package/templates/astro-emdash/src/routes/_app/reset-password.tsx +115 -0
  442. package/templates/astro-emdash/src/routes/_app/setup.$token.tsx +11 -0
  443. package/templates/astro-emdash/src/routes/_app/signup.tsx +141 -0
  444. package/templates/astro-emdash/src/routes/_app/verify-email.$token.tsx +15 -0
  445. package/templates/astro-emdash/src/routes/_app/verify-email.tsx +154 -0
  446. package/templates/astro-emdash/src/routes/_app.tsx +33 -0
  447. package/templates/astro-emdash/src/routes/admin/$.ts +20 -0
  448. package/templates/astro-emdash/src/routes/api/$.ts +19 -0
  449. package/templates/astro-emdash/src/routes/docs/$.tsx +22 -0
  450. package/templates/astro-emdash/src/routes/docs/api/markdown.ts +12 -0
  451. package/templates/astro-emdash/src/routes/docs/api/search.ts +12 -0
  452. package/templates/astro-emdash/src/routes/docs.index.tsx +22 -0
  453. package/templates/astro-emdash/src/routes/docs.tsx +22 -0
  454. package/templates/astro-emdash/src/search.ts +6 -0
  455. package/templates/astro-emdash/src/settings.ts +12 -0
  456. package/templates/astro-emdash/src/styles-docs.css +3 -0
  457. package/templates/astro-emdash/src/styles.css +101 -0
  458. package/templates/astro-emdash/src/themes/base.css +76 -0
  459. package/templates/astro-emdash/src/themes/carbon.css +76 -0
  460. package/templates/astro-emdash/src/themes/fonts.css +25 -0
  461. package/templates/astro-emdash/src/themes/sage.css +76 -0
  462. package/templates/astro-emdash/src/themes/sand.css +76 -0
  463. package/templates/astro-emdash/src/themes/slate.css +81 -0
  464. package/templates/astro-emdash/src/themes/ultra.css +76 -0
  465. package/templates/astro-emdash/src/themes/zen.css +76 -0
  466. package/templates/astro-emdash/src/worker-entry.ts +31 -0
  467. package/templates/astro-emdash/tests/raybase-patterns.test.ts +29 -0
  468. package/templates/astro-emdash/tsconfig.json +36 -0
  469. package/templates/astro-emdash/vite.config.ts +130 -0
  470. package/templates/astro-emdash/vitest.config.ts +8 -0
  471. package/templates/astro-emdash/wrangler.jsonc +112 -0
  472. package/templates/react-router/.dev.vars.example +5 -0
  473. package/templates/react-router/.editorconfig +15 -0
  474. package/templates/react-router/AGENTS.md +54 -0
  475. package/templates/react-router/README.md +52 -0
  476. package/templates/react-router/app/app.css +44 -0
  477. package/templates/react-router/app/components/mdx.tsx +79 -0
  478. package/templates/react-router/app/components/ui/button.tsx +45 -0
  479. package/templates/react-router/app/components/ui/card.tsx +87 -0
  480. package/templates/react-router/app/components/ui/separator.tsx +22 -0
  481. package/templates/react-router/app/db/migrations.gen.ts +6 -0
  482. package/templates/react-router/app/db/schema.ts +56 -0
  483. package/templates/react-router/app/db/seed.ts +14 -0
  484. package/templates/react-router/app/entry.server.tsx +41 -0
  485. package/templates/react-router/app/globals.d.ts +1 -0
  486. package/templates/react-router/app/lib/layout.shared.tsx +52 -0
  487. package/templates/react-router/app/lib/source.ts +7 -0
  488. package/templates/react-router/app/lib/utils.ts +6 -0
  489. package/templates/react-router/app/raybase.server.ts +65 -0
  490. package/templates/react-router/app/root.tsx +23 -0
  491. package/templates/react-router/app/routes/_index.tsx +53 -0
  492. package/templates/react-router/app/routes/docs.$.tsx +49 -0
  493. package/templates/react-router/app/routes/docs.api.search.ts +10 -0
  494. package/templates/react-router/app/routes/docs.tsx +13 -0
  495. package/templates/react-router/app/routes.ts +3 -0
  496. package/templates/react-router/components.json +22 -0
  497. package/templates/react-router/content/docs/getting-started.mdx +15 -0
  498. package/templates/react-router/content/docs/index.mdx +8 -0
  499. package/templates/react-router/content/docs/mcp.mdx +121 -0
  500. package/templates/react-router/content/docs/meta.json +4 -0
  501. package/templates/react-router/dev/CODEBASE-MAP.md +48 -0
  502. package/templates/react-router/dev/SPEC-OVERVIEW.md +35 -0
  503. package/templates/react-router/dev/SPEC.md +93 -0
  504. package/templates/react-router/dev/features/archive/.gitkeep +1 -0
  505. package/templates/react-router/drizzle.config.ts +5 -0
  506. package/templates/react-router/env.d.ts +53 -0
  507. package/templates/react-router/gitignore +23 -0
  508. package/templates/react-router/migrations/app/meta/_journal.json +1 -0
  509. package/templates/react-router/package.json +70 -0
  510. package/templates/react-router/public/_headers +4 -0
  511. package/templates/react-router/public/favicon.ico +0 -0
  512. package/templates/react-router/react-router.config.ts +9 -0
  513. package/templates/react-router/source.config.ts +5 -0
  514. package/templates/react-router/tests/raybase-patterns.test.ts +23 -0
  515. package/templates/react-router/tsconfig.json +27 -0
  516. package/templates/react-router/vite.config.ts +59 -0
  517. package/templates/react-router/vitest.config.ts +8 -0
  518. package/templates/react-router/workers/app.ts +40 -0
  519. package/templates/react-router/wrangler.jsonc +111 -0
  520. package/templates/tanstack-start/.dev.vars.example +5 -0
  521. package/templates/tanstack-start/AGENTS.md +95 -0
  522. package/templates/tanstack-start/DESIGN.md +65 -0
  523. package/templates/tanstack-start/components.json +21 -0
  524. package/templates/tanstack-start/content/docs/getting-started.mdx +65 -0
  525. package/templates/tanstack-start/content/docs/index.mdx +10 -0
  526. package/templates/tanstack-start/content/docs/mcp.mdx +122 -0
  527. package/templates/tanstack-start/content/docs/meta.json +4 -0
  528. package/templates/tanstack-start/dev/CODEBASE-MAP.md +84 -0
  529. package/templates/tanstack-start/dev/SPEC-OVERVIEW.md +46 -0
  530. package/templates/tanstack-start/dev/SPEC.md +213 -0
  531. package/templates/tanstack-start/dev/features/archive/.gitkeep +1 -0
  532. package/templates/tanstack-start/docs/theme-previews/base.svg +24 -0
  533. package/templates/tanstack-start/docs/theme-previews/steel.svg +24 -0
  534. package/templates/tanstack-start/docs/theme-previews/zen.svg +24 -0
  535. package/templates/tanstack-start/docs/themes.md +116 -0
  536. package/templates/tanstack-start/drizzle.config.ts +5 -0
  537. package/templates/tanstack-start/gitignore +11 -0
  538. package/templates/tanstack-start/migrations/app/0000_low_karen_page.sql +26 -0
  539. package/templates/tanstack-start/migrations/app/meta/0000_snapshot.json +196 -0
  540. package/templates/tanstack-start/migrations/app/meta/_journal.json +13 -0
  541. package/templates/tanstack-start/package.json +77 -0
  542. package/templates/tanstack-start/public/_headers +8 -0
  543. package/templates/tanstack-start/public/icons/app-icon-maskable.svg +1 -0
  544. package/templates/tanstack-start/public/icons/app-icon.svg +1 -0
  545. package/templates/tanstack-start/public/icons/apple-touch-icon.png +0 -0
  546. package/templates/tanstack-start/public/manifest.webmanifest +14 -0
  547. package/templates/tanstack-start/public/raybase-push-sw.js +32 -0
  548. package/templates/tanstack-start/source.config.ts +10 -0
  549. package/templates/tanstack-start/src/actions.ts +560 -0
  550. package/templates/tanstack-start/src/ai/agents.ts +78 -0
  551. package/templates/tanstack-start/src/ai/retrieval.ts +36 -0
  552. package/templates/tanstack-start/src/auth-door.ts +18 -0
  553. package/templates/tanstack-start/src/client.tsx +25 -0
  554. package/templates/tanstack-start/src/components/.gitkeep +1 -0
  555. package/templates/tanstack-start/src/components/account-menu.tsx +127 -0
  556. package/templates/tanstack-start/src/components/auth-shell.tsx +69 -0
  557. package/templates/tanstack-start/src/components/install-app.tsx +35 -0
  558. package/templates/tanstack-start/src/components/mode-toggle.tsx +32 -0
  559. package/templates/tanstack-start/src/components/search-command-palette.tsx +107 -0
  560. package/templates/tanstack-start/src/components/setup-token-page.tsx +197 -0
  561. package/templates/tanstack-start/src/components/ui/avatar.tsx +107 -0
  562. package/templates/tanstack-start/src/components/ui/badge.tsx +52 -0
  563. package/templates/tanstack-start/src/components/ui/button.tsx +69 -0
  564. package/templates/tanstack-start/src/components/ui/checkbox.tsx +29 -0
  565. package/templates/tanstack-start/src/components/ui/dialog.tsx +158 -0
  566. package/templates/tanstack-start/src/components/ui/dropdown-menu.tsx +303 -0
  567. package/templates/tanstack-start/src/components/ui/input.tsx +20 -0
  568. package/templates/tanstack-start/src/components/ui/label.tsx +20 -0
  569. package/templates/tanstack-start/src/components/ui/scroll-area.tsx +53 -0
  570. package/templates/tanstack-start/src/components/ui/select.tsx +215 -0
  571. package/templates/tanstack-start/src/components/ui/separator.tsx +23 -0
  572. package/templates/tanstack-start/src/components/ui/sheet.tsx +138 -0
  573. package/templates/tanstack-start/src/components/ui/sidebar.tsx +728 -0
  574. package/templates/tanstack-start/src/components/ui/skeleton.tsx +13 -0
  575. package/templates/tanstack-start/src/components/ui/textarea.tsx +18 -0
  576. package/templates/tanstack-start/src/components/ui/tooltip.tsx +66 -0
  577. package/templates/tanstack-start/src/db/migrations.gen.ts +6 -0
  578. package/templates/tanstack-start/src/db/schema.ts +90 -0
  579. package/templates/tanstack-start/src/db/seed.ts +106 -0
  580. package/templates/tanstack-start/src/db/storage.ts +32 -0
  581. package/templates/tanstack-start/src/docs/docs-assets.ts +1 -0
  582. package/templates/tanstack-start/src/docs/docs-client.tsx +22 -0
  583. package/templates/tanstack-start/src/docs/docs-data.ts +24 -0
  584. package/templates/tanstack-start/src/docs/docs-handler.tsx +105 -0
  585. package/templates/tanstack-start/src/docs/docs-layout.tsx +56 -0
  586. package/templates/tanstack-start/src/docs/docs-mdx.tsx +79 -0
  587. package/templates/tanstack-start/src/docs/docs-page-actions.tsx +146 -0
  588. package/templates/tanstack-start/src/docs/docs-page.tsx +70 -0
  589. package/templates/tanstack-start/src/docs/llm-text.ts +61 -0
  590. package/templates/tanstack-start/src/docs/source.ts +7 -0
  591. package/templates/tanstack-start/src/hooks/use-mobile.ts +19 -0
  592. package/templates/tanstack-start/src/hooks/use-pwa-install.ts +77 -0
  593. package/templates/tanstack-start/src/jobs.example.ts +56 -0
  594. package/templates/tanstack-start/src/lib/account.ts +13 -0
  595. package/templates/tanstack-start/src/lib/auth-client.ts +187 -0
  596. package/templates/tanstack-start/src/lib/push-client.ts +98 -0
  597. package/templates/tanstack-start/src/lib/utils.ts +6 -0
  598. package/templates/tanstack-start/src/mcp-app.ts +74 -0
  599. package/templates/tanstack-start/src/notifications.example.ts +37 -0
  600. package/templates/tanstack-start/src/raybase.auth.ts +86 -0
  601. package/templates/tanstack-start/src/raybase.config.ts +86 -0
  602. package/templates/tanstack-start/src/raybase.server.ts +155 -0
  603. package/templates/tanstack-start/src/realtime.example.ts +46 -0
  604. package/templates/tanstack-start/src/router.tsx +19 -0
  605. package/templates/tanstack-start/src/routes/__root.tsx +73 -0
  606. package/templates/tanstack-start/src/routes/_app/admin.tsx +13 -0
  607. package/templates/tanstack-start/src/routes/_app/forgot-password.tsx +97 -0
  608. package/templates/tanstack-start/src/routes/_app/index.tsx +1316 -0
  609. package/templates/tanstack-start/src/routes/_app/invite.$token.tsx +11 -0
  610. package/templates/tanstack-start/src/routes/_app/login.tsx +193 -0
  611. package/templates/tanstack-start/src/routes/_app/profile.tsx +98 -0
  612. package/templates/tanstack-start/src/routes/_app/reset-password.$token.tsx +16 -0
  613. package/templates/tanstack-start/src/routes/_app/reset-password.tsx +115 -0
  614. package/templates/tanstack-start/src/routes/_app/setup.$token.tsx +11 -0
  615. package/templates/tanstack-start/src/routes/_app/signup.tsx +141 -0
  616. package/templates/tanstack-start/src/routes/_app/verify-email.$token.tsx +15 -0
  617. package/templates/tanstack-start/src/routes/_app/verify-email.tsx +154 -0
  618. package/templates/tanstack-start/src/routes/_app.tsx +33 -0
  619. package/templates/tanstack-start/src/routes/admin/$.ts +20 -0
  620. package/templates/tanstack-start/src/routes/api/$.ts +19 -0
  621. package/templates/tanstack-start/src/routes/docs/$.tsx +22 -0
  622. package/templates/tanstack-start/src/routes/docs/api/markdown.ts +12 -0
  623. package/templates/tanstack-start/src/routes/docs/api/search.ts +12 -0
  624. package/templates/tanstack-start/src/routes/docs.index.tsx +22 -0
  625. package/templates/tanstack-start/src/routes/docs.tsx +22 -0
  626. package/templates/tanstack-start/src/search.ts +26 -0
  627. package/templates/tanstack-start/src/settings.ts +12 -0
  628. package/templates/tanstack-start/src/styles-docs.css +3 -0
  629. package/templates/tanstack-start/src/styles.css +73 -0
  630. package/templates/tanstack-start/src/themes/base.css +76 -0
  631. package/templates/tanstack-start/src/themes/carbon.css +76 -0
  632. package/templates/tanstack-start/src/themes/fonts.css +18 -0
  633. package/templates/tanstack-start/src/themes/sage.css +76 -0
  634. package/templates/tanstack-start/src/themes/sand.css +76 -0
  635. package/templates/tanstack-start/src/themes/slate.css +76 -0
  636. package/templates/tanstack-start/src/themes/ultra.css +76 -0
  637. package/templates/tanstack-start/src/themes/zen.css +76 -0
  638. package/templates/tanstack-start/src/worker-entry.ts +30 -0
  639. package/templates/tanstack-start/tests/raybase-patterns.test.ts +247 -0
  640. package/templates/tanstack-start/tsconfig.json +33 -0
  641. package/templates/tanstack-start/vite.config.ts +132 -0
  642. package/templates/tanstack-start/vitest.config.ts +8 -0
  643. package/templates/tanstack-start/wrangler.jsonc +112 -0
  644. package/README.md +0 -3
@@ -0,0 +1,41 @@
1
+ import { useRouter } from "@tanstack/react-router";
2
+ import { RaybaseAgentWidget } from "@raybase/agent-ui";
3
+ import { useEffect } from "react";
4
+ import { guideConfig } from "../guide/config";
5
+
6
+ export function GuideWidget() {
7
+ const router = useRouter();
8
+
9
+ useEffect(() => {
10
+ const refreshData = () => {
11
+ void router.invalidate();
12
+ };
13
+ window.addEventListener("raybase:data-changed", refreshData);
14
+ return () => window.removeEventListener("raybase:data-changed", refreshData);
15
+ }, [router]);
16
+
17
+ return (
18
+ <RaybaseAgentWidget
19
+ agentName={guideConfig.agent?.name ?? "guide"}
20
+ enabled={guideConfig.enabled ?? true}
21
+ isSurfaceEnabled={isGuideSurfaceEnabled}
22
+ resolveSurface={resolveGuideSurface}
23
+ title={guideConfig.agent?.title ?? "Guide"}
24
+ />
25
+ );
26
+ }
27
+
28
+ type GuideSurface = "app" | "docs";
29
+
30
+ function resolveGuideSurface(route: string): GuideSurface {
31
+ return route.startsWith("/docs") ? "docs" : "app";
32
+ }
33
+
34
+ function isGuideSurfaceEnabled(surface: string): boolean {
35
+ if (!isGuideSurface(surface)) return false;
36
+ return guideConfig.surfaces?.[surface]?.enabled ?? surface === "app";
37
+ }
38
+
39
+ function isGuideSurface(surface: string): surface is GuideSurface {
40
+ return surface === "app" || surface === "docs";
41
+ }
@@ -0,0 +1,8 @@
1
+ import type { RaybaseAction } from "@raybase/core/actions";
2
+ import type { RaybaseEnv } from "@raybase/core/worker";
3
+ import { actions } from "../actions";
4
+
5
+ // Keep Guide on a narrow allow-list of app-declared actions.
6
+ export const guideActions = [
7
+ actions.contentSiteSnapshot
8
+ ] satisfies Array<RaybaseAction<any, any, RaybaseEnv>>;
@@ -0,0 +1,21 @@
1
+ import type { GuideConfig } from "@raybase/guide";
2
+
3
+ export const guideConfig = {
4
+ enabled: true,
5
+ surfaces: {
6
+ app: { enabled: true, audience: "signed-in" },
7
+ docs: { enabled: true, audience: "signed-in" }
8
+ },
9
+ agent: {
10
+ name: "guide",
11
+ title: "Guide"
12
+ },
13
+ limits: {
14
+ publicIpHourlyRequests: 20,
15
+ publicIpHourlyOutputTokens: 12000,
16
+ publicDailyRequests: 200,
17
+ publicDailyOutputTokens: 60000,
18
+ signedInDailyRequests: 50,
19
+ maxCorpusSnippets: 8
20
+ }
21
+ } satisfies GuideConfig;
@@ -0,0 +1,4 @@
1
+ import type { GuideCorpusDocument } from "@raybase/guide";
2
+ import manifest from "./corpus.manifest.json";
3
+
4
+ export const generatedGuideCorpus = manifest.documents as GuideCorpusDocument[];
@@ -0,0 +1,72 @@
1
+ {
2
+ "schemaVersion": 1,
3
+ "generatedAt": "2026-11-14T04:05:39.782Z",
4
+ "sources": [
5
+ {
6
+ "kind": "docs",
7
+ "path": "content/docs"
8
+ }
9
+ ],
10
+ "documents": [
11
+ {
12
+ "id": "docs:content/docs:getting-started.mdx",
13
+ "title": "Opening the CMS",
14
+ "source": "docs",
15
+ "text": "Sign in with the account your team gave you, then open the public site and choose CMS from the signed in menu. Start with Pages. Open an existing draft to review the editing pattern, or create a page when you need a new public URL. Use the page content field to arrange reusable sections. Each section owns its own copy, media, links, and display options. Preview before publishing. If a page needs a new reusable section or a layout change, note the goal clearly and ask the project maintainer to add the building block. Local time travel In local development, use the fixed dev chrome or POST /api/dev/time with \"now\":\"2030 08 12T09:00:00.000Z\" to move the application clock. GET /api/dev/time reports virtual and real time; \"reset\":true returns to wall time. Forward jumps start bounded catch up for Jobs, Agent schedules, wakes, and follow ups. Repeating schedules coalesce to one run, while one shot work drains without waiting for the HTTP response. Auth, leases, retries, tokens, provider calls, and diagnostics remain on real time. Moving backward or resetting does not rewrite future dated rows; reset and reseed when a QA scenario crosses that edge. Local tooling can restore the spine's base world with POST /api/dev/seed and \"reset\":true or apply one named variant with \"variant\":\"empty spine\" . Reset is destructive for spine app tables; use sequential calls to layer variants, and use restore after time travel leaves future dated rows. Content site demo data remains owned by site/ . GET /api/dev/manifest serves the same validated manifestVersion: 1 checkpoint written to .raybase/app.manifest.json at dev startup. Route sources use project relative POSIX paths. Restart raybase dev after changing routes or declarations. The endpoint is local only.",
16
+ "url": "/docs/getting-started",
17
+ "routePatterns": [
18
+ "/docs/getting-started",
19
+ "/docs/getting-started/*"
20
+ ],
21
+ "public": false,
22
+ "guideContext": null,
23
+ "updatedAt": "2026-11-14T04:05:26.116Z",
24
+ "hash": "sha256:6aec1b2e381585c532b62df227dd807aef7dbf91fe71d1f804a05e7793ce36ae"
25
+ },
26
+ {
27
+ "id": "docs:content/docs:index.mdx",
28
+ "title": "Editing the site",
29
+ "source": "docs",
30
+ "text": "The CMS is where signed in editors manage public site pages, drafts, media, and reusable page sections. Use the CMS link in the signed in site menu to open the editing workspace. If the link is not visible, ask the person who manages access to invite you or adjust your role. Most pages are built from a title, slug, metadata, and a sequence of reusable sections. Edit copy and media in the CMS, preview changes, then publish when the page is ready. Keep structural changes deliberate. If you need a new section type, navigation pattern, layout, or data backed block, ask the project maintainer to add it safely.",
31
+ "url": "/docs",
32
+ "routePatterns": [
33
+ "/docs",
34
+ "/docs/*"
35
+ ],
36
+ "public": false,
37
+ "guideContext": null,
38
+ "updatedAt": "2026-11-14T04:05:26.115Z",
39
+ "hash": "sha256:cee1dfcd47c0cc800581e7557c206d725f783ebcab122825455ada421faf13b4"
40
+ },
41
+ {
42
+ "id": "docs:content/docs:mcp.mdx",
43
+ "title": "Connecting an assistant",
44
+ "source": "docs",
45
+ "text": "Some apps let signed in members connect an approved AI assistant through the app's /mcp endpoint. Only connect assistants you trust. The assistant should explain what it can read or change before you approve a task. If the connection fails, confirm you are signed in and ask the project maintainer whether assistant access is enabled for your role.",
46
+ "url": "/docs/mcp",
47
+ "routePatterns": [
48
+ "/docs/mcp",
49
+ "/docs/mcp/*"
50
+ ],
51
+ "public": false,
52
+ "guideContext": null,
53
+ "updatedAt": "2026-11-14T04:05:26.116Z",
54
+ "hash": "sha256:9b7a64f4ce851af9f6664b4de67c6d92c4770228e76f06b3916f050d4b2f6467"
55
+ },
56
+ {
57
+ "id": "docs:content/docs:site-templates.mdx",
58
+ "title": "Reusable sections",
59
+ "source": "docs",
60
+ "text": "Templates are reusable Liquid templates for the public content site. Use them when a template fits the page section, layout, or page starter you need and the result should stay editable in the CMS. Discovery works from any directory: Installed templates are staged under site/seed/templates/ / : template.json is the draft Galley template payload. sample content.json carries registry sample data for review. page starters are Liquid templates that compose their sections with % render % tags; they also stage a page seed under site/seed/pages/ .json that points the page's design field at the starter. optional behavior sidecars are copied beside the staged payload when a template declares one. provenance.json records source URLs, generated hashes, dependencies, bindings, and install choices. Packs that read an EmDash collection through galley.dataSources use their manifest default collection when one is declared. Override or provide a required collection with bind : Theme manifests group a family's voice and vocabulary: palettes, sections, and page starter choices. A theme install stages the required dependencies plus the choices you select: palette is required when a theme lists more than one palette. page stages an EmDash page from a theme page starter key or exact template id. Use all optional only when you intentionally want every optional dependency staged. The site's structure is a shell: a layout with its welded nav and footer, selected by the site plan's capacity needs rather than by theme membership. raybase templates shell match nav items 5 footer links 12 theme raybase/lumen studio filters shells that fit and ranks them by voice fit. For one page sites, add anchor to filter to anchor tuned brand bar shells ( nav items 0 is valid — the logo block still renders at zero links). Then stage the chosen shell: activate stages an ephemeral activation.json work order beside the selected layout; during apply, selected templates are published, the active Galley layout pointer (and palette) is updated in the app database, and the work order is deleted. With the Astro/EmDash dev server running, apply staged templates: Without activate , templates are installed as draft templates. Structural pages point their design field at a page starter template; prose pages keep Portable Text in pages.content , where inline galley.block or galley.shared embeds are still supported. With shell add activate , templates:apply publishes the selected shell and section templates, upserts staged page seeds, and activates the layout for public rendering. Review staged JSON before apply and commit .raybase/templates.json , site/seed/templates/ , and site/seed/pages/ . The visual editor edits copy, fields, rich text, and Portable Text content. Page structure lives in Liquid: page starters compose sections with % render % tags, and structural changes remain agent/code work in Galley templates, resolved by installation (bare template ids, no per reference version pins).",
61
+ "url": "/docs/site-templates",
62
+ "routePatterns": [
63
+ "/docs/site-templates",
64
+ "/docs/site-templates/*"
65
+ ],
66
+ "public": false,
67
+ "guideContext": null,
68
+ "updatedAt": "2026-11-14T04:05:26.116Z",
69
+ "hash": "sha256:9799eff846de2718833130cbdeda6309a584705c1a536fbe95647c7596fef05f"
70
+ }
71
+ ]
72
+ }
@@ -0,0 +1,4 @@
1
+ import type { GuideCorpusDocument } from "@raybase/guide";
2
+ import { generatedGuideCorpus } from "./corpus.gen";
3
+
4
+ export const guideCorpus = generatedGuideCorpus satisfies GuideCorpusDocument[];
@@ -0,0 +1,4 @@
1
+ {
2
+ "schemaVersion": 1,
3
+ "resources": []
4
+ }
@@ -0,0 +1,29 @@
1
+ import { RaybaseAgentWidget } from "@raybase/agent-ui";
2
+ import { guideConfig } from "../guide/config";
3
+
4
+ export function GuideWidget() {
5
+ return (
6
+ <RaybaseAgentWidget
7
+ agentName={guideConfig.agent?.name ?? "guide"}
8
+ enabled={guideConfig.enabled ?? true}
9
+ isSurfaceEnabled={isGuideSurfaceEnabled}
10
+ resolveSurface={resolveGuideSurface}
11
+ title={guideConfig.agent?.title ?? "Guide"}
12
+ />
13
+ );
14
+ }
15
+
16
+ type GuideSurface = "app" | "docs";
17
+
18
+ function resolveGuideSurface(route: string): GuideSurface {
19
+ return route.startsWith("/docs") ? "docs" : "app";
20
+ }
21
+
22
+ function isGuideSurfaceEnabled(surface: string): boolean {
23
+ if (!isGuideSurface(surface)) return false;
24
+ return guideConfig.surfaces?.[surface]?.enabled ?? surface === "app";
25
+ }
26
+
27
+ function isGuideSurface(surface: string): surface is GuideSurface {
28
+ return surface === "app" || surface === "docs";
29
+ }
@@ -0,0 +1,3 @@
1
+ import type { RaybaseAction } from "@raybase/core/actions";
2
+
3
+ export const guideActions: RaybaseAction[] = [];
@@ -0,0 +1,21 @@
1
+ import type { GuideConfig } from "@raybase/guide";
2
+
3
+ export const guideConfig = {
4
+ enabled: true,
5
+ surfaces: {
6
+ app: { enabled: true, audience: "signed-in" },
7
+ docs: { enabled: true, audience: "signed-in" }
8
+ },
9
+ agent: {
10
+ name: "guide",
11
+ title: "Guide"
12
+ },
13
+ limits: {
14
+ publicIpHourlyRequests: 20,
15
+ publicIpHourlyOutputTokens: 12000,
16
+ publicDailyRequests: 200,
17
+ publicDailyOutputTokens: 60000,
18
+ signedInDailyRequests: 50,
19
+ maxCorpusSnippets: 8
20
+ }
21
+ } satisfies GuideConfig;
@@ -0,0 +1,4 @@
1
+ import type { GuideCorpusDocument } from "@raybase/guide";
2
+ import manifest from "./corpus.manifest.json";
3
+
4
+ export const generatedGuideCorpus = manifest.documents as GuideCorpusDocument[];
@@ -0,0 +1,22 @@
1
+ {
2
+ "schemaVersion": 1,
3
+ "generatedAt": "2026-11-14T04:05:33.795Z",
4
+ "sources": [
5
+ {
6
+ "kind": "guide",
7
+ "path": "content/guide"
8
+ }
9
+ ],
10
+ "documents": [
11
+ {
12
+ "id": "faq:capability-map.md",
13
+ "title": "What Guide can do in this app",
14
+ "source": "faq",
15
+ "text": "Guide should answer from the checked in app docs, help knowledge, and explicit Agent actions registered by the app. It can explain what the app tracks, where to go, how common workflows work, what the current user is allowed to do, and which tasks it can help perform. When the app registers Agent actions, Guide may use those actions only after the user clearly asks and the action policy allows it. If no action is registered for a task, it can explain the workflow but should not claim it can perform the task. Guide should not expose raw tool names, internal errors, JSON, SQL, source code details, admin/operator capabilities, secrets, or implementation jargon. If context is missing or a tool fails, it should respond plainly, offer a useful next step, and ask one clarifying question only when needed.",
16
+ "public": false,
17
+ "guideContext": "app-capability-map",
18
+ "updatedAt": "2026-11-14T04:05:26.038Z",
19
+ "hash": "sha256:9744984def63323f0435b3386509a0ff7d6f6a9986d1f159a1d04d037351ee53"
20
+ }
21
+ ]
22
+ }
@@ -0,0 +1,4 @@
1
+ import type { GuideCorpusDocument } from "@raybase/guide";
2
+ import { generatedGuideCorpus } from "./corpus.gen";
3
+
4
+ export const guideCorpus = generatedGuideCorpus satisfies GuideCorpusDocument[];
@@ -0,0 +1,4 @@
1
+ {
2
+ "schemaVersion": 1,
3
+ "resources": []
4
+ }
@@ -0,0 +1,13 @@
1
+ ---
2
+ title: What Guide can do in this app
3
+ guideContext: app-capability-map
4
+ public: false
5
+ ---
6
+
7
+ Guide should answer from the checked-in app docs, help knowledge, and explicit Agent actions registered by the app.
8
+
9
+ It can explain what the app tracks, where to go, how common workflows work, what the current user is allowed to do, and which tasks it can help perform.
10
+
11
+ When the app registers Agent actions, Guide may use those actions only after the user clearly asks and the action policy allows it. If no action is registered for a task, it can explain the workflow but should not claim it can perform the task.
12
+
13
+ Guide should not expose raw tool names, internal errors, JSON, SQL, source-code details, admin/operator capabilities, secrets, or implementation jargon. If context is missing or a tool fails, it should respond plainly, offer a useful next step, and ask one clarifying question only when needed.
@@ -0,0 +1,17 @@
1
+ ---
2
+ title: What Guide can do in this app
3
+ guideContext: app-capability-map
4
+ public: false
5
+ ---
6
+
7
+ Guide should answer from the checked-in app docs, help knowledge, and explicit Agent actions registered by the app.
8
+
9
+ It can explain what the app tracks, where to go, how common workflows work, what the current user is allowed to do, and which tasks it can help perform.
10
+
11
+ In the Team Tasks starter, Guide can summarize visible projects and tasks, list visible projects and tasks, create projects, create tasks, update task fields, mark tasks done, archive tasks or projects, and list assignable users through narrow declared app actions that share the same policies and invariants as the UI workflow.
12
+
13
+ Guide should prefer archive over hard delete. It does not have hard-delete actions in its allow-list. If a user asks to permanently delete work, explain that deletion is handled from the app UI by someone with permission after the item is archived.
14
+
15
+ When the app registers Agent actions, Guide may use those actions only after the user clearly asks and the action policy allows it. If no action is registered for a task, it can explain the workflow but should not claim it can perform the task.
16
+
17
+ Guide should not expose raw tool names, internal errors, JSON, SQL, source-code details, admin/operator capabilities, or implementation jargon. If context is missing or a tool fails, it should respond plainly, offer a useful next step, and ask one clarifying question only when needed.
@@ -0,0 +1,41 @@
1
+ import { useRouter } from "@tanstack/react-router";
2
+ import { RaybaseAgentWidget } from "@raybase/agent-ui";
3
+ import { useEffect } from "react";
4
+ import { guideConfig } from "../guide/config";
5
+
6
+ export function GuideWidget() {
7
+ const router = useRouter();
8
+
9
+ useEffect(() => {
10
+ const refreshData = () => {
11
+ void router.invalidate();
12
+ };
13
+ window.addEventListener("raybase:data-changed", refreshData);
14
+ return () => window.removeEventListener("raybase:data-changed", refreshData);
15
+ }, [router]);
16
+
17
+ return (
18
+ <RaybaseAgentWidget
19
+ agentName={guideConfig.agent?.name ?? "guide"}
20
+ enabled={guideConfig.enabled ?? true}
21
+ isSurfaceEnabled={isGuideSurfaceEnabled}
22
+ resolveSurface={resolveGuideSurface}
23
+ title={guideConfig.agent?.title ?? "Guide"}
24
+ />
25
+ );
26
+ }
27
+
28
+ type GuideSurface = "app" | "docs";
29
+
30
+ function resolveGuideSurface(route: string): GuideSurface {
31
+ return route.startsWith("/docs") ? "docs" : "app";
32
+ }
33
+
34
+ function isGuideSurfaceEnabled(surface: string): boolean {
35
+ if (!isGuideSurface(surface)) return false;
36
+ return guideConfig.surfaces?.[surface]?.enabled ?? surface === "app";
37
+ }
38
+
39
+ function isGuideSurface(surface: string): surface is GuideSurface {
40
+ return surface === "app" || surface === "docs";
41
+ }
@@ -0,0 +1,17 @@
1
+ import type { RaybaseAction } from "@raybase/core/actions";
2
+ import type { RaybaseEnv } from "@raybase/core/worker";
3
+ import { actions } from "../actions";
4
+
5
+ // Keep Guide on a narrow allow-list of app-declared actions.
6
+ export const guideActions = [
7
+ actions.workspaceSnapshot,
8
+ actions.listVisibleProjects,
9
+ actions.listVisibleTodos,
10
+ actions.createProject,
11
+ actions.createTodo,
12
+ actions.updateTodo,
13
+ actions.markTodoDone,
14
+ actions.archiveTodo,
15
+ actions.archiveProject,
16
+ actions.listAssignableUsers
17
+ ] satisfies Array<RaybaseAction<any, any, RaybaseEnv>>;
@@ -0,0 +1,21 @@
1
+ import type { GuideConfig } from "@raybase/guide";
2
+
3
+ export const guideConfig = {
4
+ enabled: true,
5
+ surfaces: {
6
+ app: { enabled: true, audience: "signed-in" },
7
+ docs: { enabled: true, audience: "signed-in" }
8
+ },
9
+ agent: {
10
+ name: "guide",
11
+ title: "Guide"
12
+ },
13
+ limits: {
14
+ publicIpHourlyRequests: 20,
15
+ publicIpHourlyOutputTokens: 12000,
16
+ publicDailyRequests: 200,
17
+ publicDailyOutputTokens: 60000,
18
+ signedInDailyRequests: 50,
19
+ maxCorpusSnippets: 8
20
+ }
21
+ } satisfies GuideConfig;
@@ -0,0 +1,4 @@
1
+ import type { GuideCorpusDocument } from "@raybase/guide";
2
+ import manifest from "./corpus.manifest.json";
3
+
4
+ export const generatedGuideCorpus = manifest.documents as GuideCorpusDocument[];
@@ -0,0 +1,22 @@
1
+ {
2
+ "schemaVersion": 1,
3
+ "generatedAt": "2026-06-23T05:51:54.320Z",
4
+ "sources": [
5
+ {
6
+ "kind": "guide",
7
+ "path": "content/guide"
8
+ }
9
+ ],
10
+ "documents": [
11
+ {
12
+ "id": "faq:capability-map.md",
13
+ "title": "What Guide can do in this app",
14
+ "source": "faq",
15
+ "text": "Guide should answer from the checked in app docs, help knowledge, and explicit Agent actions registered by the app. It can explain what the app tracks, where to go, how common workflows work, what the current user is allowed to do, and which tasks it can help perform. In the Team Tasks starter, Guide can summarize visible projects and tasks, list visible projects and tasks, create projects, create tasks, update task fields, mark tasks done, archive tasks or projects, and list assignable users through narrow declared app actions that share the same policies and invariants as the UI workflow. Guide should prefer archive over hard delete. It does not have hard delete actions in its allow list. If a user asks to permanently delete work, explain that deletion is handled from the app UI by someone with permission after the item is archived. When the app registers Agent actions, Guide may use those actions only after the user clearly asks and the action policy allows it. If no action is registered for a task, it can explain the workflow but should not claim it can perform the task. Guide should not expose raw tool names, internal errors, JSON, SQL, source code details, admin/operator capabilities, or implementation jargon. If context is missing or a tool fails, it should respond plainly, offer a useful next step, and ask one clarifying question only when needed.",
16
+ "public": false,
17
+ "guideContext": "app-capability-map",
18
+ "updatedAt": "2026-06-23T05:50:43.356Z",
19
+ "hash": "sha256:531e7a1160a7b21c50b7c5b6164873c7cde5114090dfc7aa544762c992548618"
20
+ }
21
+ ]
22
+ }
@@ -0,0 +1,4 @@
1
+ import type { GuideCorpusDocument } from "@raybase/guide";
2
+ import { generatedGuideCorpus } from "./corpus.gen";
3
+
4
+ export const guideCorpus = generatedGuideCorpus satisfies GuideCorpusDocument[];
@@ -0,0 +1,4 @@
1
+ {
2
+ "schemaVersion": 1,
3
+ "resources": []
4
+ }
@@ -0,0 +1,57 @@
1
+ ---
2
+ name: raybase-openai-subscription
3
+ description: Install, configure, debug, test, or change Raybase's experimental ChatGPT/Codex subscription inference module, local relay, transport, health handling, or strict tool and response schemas.
4
+ ---
5
+
6
+ # Raybase OpenAI Subscription
7
+
8
+ Use this skill only for the explicitly selected `@raybase/openai-subscription`
9
+ module. It is developer guidance for an experimental integration, not a public
10
+ or stable OpenAI subscription API.
11
+
12
+ Read the reference that matches the task:
13
+
14
+ - [Module contract](references/module-contract.md): installed and runtime
15
+ integration, credential scope, relay/egress, secrets, health, and safe
16
+ operator guidance.
17
+ - [Structured outputs](references/structured-outputs.md): self-contained
18
+ Responses `text.format` and strict function-tool JSON Schema rules, examples,
19
+ Zod pitfalls, and reversible app adapters.
20
+ - [Compatibility and testing](references/compatibility-and-testing.md): a
21
+ secret-safe diagnostic ladder, error ownership, fixtures, and live smoke
22
+ criteria.
23
+
24
+ The module supports two declaration shapes:
25
+
26
+ - Installed: run `raybase modules add openai-subscription`. Omitted
27
+ `integration` means `"installed"`; preserve the generated provider/config,
28
+ credential-mode, background strategy, manifest, and egress contract.
29
+ - Runtime-registered: register the package through its public runtime API and
30
+ declare `{"enabled":true,"package":"@raybase/openai-subscription","integration":"runtime"}`.
31
+ Keep the package in production `dependencies`; declare
32
+ `RAYBASE_OPENAI_SUBSCRIPTION_KEY` in applicable Wrangler
33
+ `secrets.required` scopes and both local relay names in
34
+ `env.local-dev.secrets.required`. Do not adopt installed-only provider or
35
+ manifest checks.
36
+
37
+ Both enabled shapes start the dev-only Codex relay. Keep encryption keys and
38
+ all credential material exclusively in local/deployed Worker secrets. Never
39
+ put access tokens, refresh tokens, device secrets, identity tokens, relay
40
+ secrets, encryption keys, or account identifiers in source, logs, evidence,
41
+ browser storage, backups, fixtures, or handoff text.
42
+
43
+ Never silently fall back to Workers AI, OpenRouter, API-billed OpenAI, or
44
+ another chat provider. Embeddings may continue through their explicitly
45
+ configured path.
46
+
47
+ Preserve this non-blocking doctor information line exactly:
48
+
49
+ ```text
50
+ info openai-subscription-usage-scope: Confirm that the selected credential scope matches the permitted use of the linked ChatGPT/Codex plan. Personal plans should not be pooled across unrelated users or tenants. For teams, use individually linked accounts or an appropriate Business, Enterprise, or API arrangement. Raybase informs but does not certify or enforce compliance.
51
+ ```
52
+
53
+ Do not infer compliance from app shape, user count, tenancy, routes, prose, or
54
+ source text. If health is genuinely `protocol_update_required`, tell the
55
+ operator to update to a newly published reviewed module version; never suggest
56
+ editing fixed endpoints or allowlists. An app-owned invalid tool or response
57
+ schema is not subscription protocol drift and must not poison module health.
@@ -0,0 +1,129 @@
1
+ # Compatibility and testing
2
+
3
+ Use this ladder to diagnose the narrowest failing contract without leaking
4
+ credentials or poisoning a healthy subscription lane.
5
+
6
+ ## Diagnostic ladder
7
+
8
+ 1. Start with a freshly linked eligible account and a minimal request with no
9
+ tools or response format. Confirm account/workspace/model routing and SSE.
10
+ 2. Add one known-valid strict function tool whose parameters are a closed root
11
+ object. This isolates tool transport from the app's tool catalog.
12
+ 3. Test final structured output separately with Responses `text.format`.
13
+ Function `parameters` and final response schemas share the strict subset but
14
+ occupy different request fields.
15
+ 4. Replay the exact failing app schema. Record only HTTP status, the module's
16
+ sanitized and bounded fingerprint, request ID presence, counts, and sizes.
17
+ A bounded request ID may remain on the thrown error as an opaque support
18
+ correlation handle, but do not persist it automatically. Never record
19
+ request authorization, relay secrets, cookies, account IDs, raw messages or
20
+ parameter paths, bodies containing private input, or unrelated response
21
+ headers.
22
+ 5. Classify ownership before changing health:
23
+ - auth/revocation/eligibility/account selection;
24
+ - rate limit or transient upstream failure;
25
+ - fixed transport envelope/header/stream drift;
26
+ - caller tool or response schema;
27
+ - app action validation after a valid model response.
28
+ 6. For a parseable caller schema `400`, assert the public fingerprint is
29
+ sanitized and capped, the upstream message/parameter are absent, and
30
+ subscription health stays at its previous connected state. The app may
31
+ separately record its selected model attempt as failed.
32
+ 7. After focused fixtures pass, complete a real subscription-backed app turn
33
+ through the local relay with the app's full tool catalog. Check the rendered
34
+ response and both health surfaces.
35
+
36
+ ## Minimum fixtures
37
+
38
+ Cover all of these with exact schema assertions and restoration tests:
39
+
40
+ - closed root object with every property required;
41
+ - optional scalar represented with `null` and removed for the original app
42
+ validator;
43
+ - optional `const` using `anyOf` with `null`;
44
+ - root discriminated and plain unions normalized to one object;
45
+ - nested `oneOf` policy and nested `anyOf` output;
46
+ - selected-branch recursive restoration;
47
+ - arrays containing normalized objects;
48
+ - open records encoded as JSON strings and parsed back to objects;
49
+ - unconstrained values encoded as JSON strings and parsed back to every JSON
50
+ value kind;
51
+ - malformed/non-object roots rejected before transport;
52
+ - invalid JSON encodings rejected by the original validator;
53
+ - sanitized JSON refusal fixtures for both response-format
54
+ `invalid_json_schema` and tool `invalid_function_parameters` envelopes;
55
+ - `invalid_function_parameters` mapped without upstream detail or a health
56
+ incident;
57
+ - code-first/type-fallback normalization, hostile punctuation, a 32-character
58
+ token cap, and omission of overlong request IDs;
59
+ - empty, malformed, oversized, non-object, and detail-free `400` bodies mapped
60
+ to `protocol:unexpected_http_status_400` with
61
+ `protocol_update_required`;
62
+ - provider-level proof that a connected subscription remains connected with no
63
+ incident for a parseable request rejection, while an unclassifiable `400`
64
+ still transitions health.
65
+
66
+ ## Request content verified 2026-08-11
67
+
68
+ A redacted local probe against the private subscription endpoint verified the
69
+ request-side image boundary independently of the public OpenAI API:
70
+
71
+ - Ordered image content uses `{ "type": "input_image", "image_url": ... }`.
72
+ Both an absolute HTTPS URL and a `data:image/...;base64,...` value completed.
73
+ - Inline PNG, JPEG, WEBP, and non-animated GIF samples completed.
74
+ - Omitting `detail` completed, as did explicit upstream probes for `auto`,
75
+ `low`, `high`, and `original`. Raybase's provider-neutral image contract does
76
+ not expose that knob, so the adapter always omits it; no semantic equivalence
77
+ between the values was inferred.
78
+ - `quality` is not an image-input field here. The endpoint rejected it with
79
+ `400 unknown_parameter` at the image part, and Raybase rejects it locally
80
+ rather than sending it.
81
+ - A valid 1x1 PNG carrying valid ancillary padding completed through
82
+ **19,573,864 encoded JSON request bytes** and **14,680,144 decoded image
83
+ bytes**. No rejection occurred below the probe's hard 20 MiB request-body
84
+ safety cap, so the exact private limit remains unverified. This proves a
85
+ request-body lower bound, not an image-decoding or useful-pixel bound.
86
+
87
+ Agent attachments remain deliberately more conservative: the default is 8 MiB
88
+ per file, before base64 expansion, plus the configured per-message attachment
89
+ count. Endpoint permissiveness does not widen those runtime admission limits.
90
+
91
+ Documented or adjacent content kinds that remain unsupported are Responses
92
+ `input_file` (file URL, file ID, or base64 file data), image-by-file-ID, Codex
93
+ `input_audio`/audio URLs, multimodal function-call outputs, assistant image
94
+ content, and image-generation/output-item families. Core exposes no image
95
+ result or stream event and this module does not author an image-generation
96
+ tool. The response-side test therefore asserts the gap precisely:
97
+ `image_generation_call` still fails closed as
98
+ `protocol:unknown_output_item`; it is not silently skipped.
99
+
100
+ ## Live smoke requirements
101
+
102
+ Use a disposable app copy and the candidate Core CLI/package, not an old
103
+ workspace binary. Keep existing secret files out of output and source control.
104
+ For a runtime integration:
105
+
106
+ 1. `raybase modules doctor` passes the runtime contract.
107
+ 2. `raybase doctor`/`raybase check` contain no installed-only subscription
108
+ findings.
109
+ 3. `raybase modules status --json` reports `integration: "runtime"`, enabled,
110
+ not scaffold-installed.
111
+ 4. `raybase dev` starts the loopback relay and injects both local names.
112
+ 5. A linked subscription turn reaches the expected model with the full app tool
113
+ set and renders a response.
114
+ 6. Subscription health and app model health are healthy afterward.
115
+ 7. Clean shutdown removes temporary relay values.
116
+ 8. Removing the declaration restores the non-blocking undeclared-dependency
117
+ advisory and skips relay startup.
118
+
119
+ Do not replace the real linked turn with a mock when live acceptance is part of
120
+ the plan. If linking or upstream access is unavailable, record the exact blocker
121
+ and keep the implementation partial.
122
+
123
+ ## Reconfirming Codex mapping
124
+
125
+ When Codex CLI behavior matters, inspect a pinned open-source tag. Trace
126
+ `--output-schema` from CLI configuration to the Responses request and compare it
127
+ with current official OpenAI docs. Do not infer an API parameter from an
128
+ internal Rust type name, and do not vendor a mutable Codex checkout into the
129
+ module skill.