ronin-skillforce 0.0.0-stage → 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (429) hide show
  1. package/CHANGELOG.md +26 -0
  2. package/LICENSE +21 -0
  3. package/README.md +225 -2
  4. package/bin/cli.js +811 -0
  5. package/bin/commands/check.js +298 -0
  6. package/bin/commands/create.js +169 -0
  7. package/bin/commands/doctor.js +392 -0
  8. package/bin/commands/import.js +557 -0
  9. package/bin/commands/next.js +125 -0
  10. package/bin/commands/review.js +207 -0
  11. package/bin/commands/status.js +114 -0
  12. package/bin/commands/studio.js +497 -0
  13. package/bin/commands/trail.js +211 -0
  14. package/bin/commands/web.js +350 -0
  15. package/bin/course-reader.js +611 -0
  16. package/bin/node-version.js +60 -0
  17. package/bin/platforms/_shared.js +211 -0
  18. package/bin/platforms/claude.js +104 -0
  19. package/bin/platforms/cursor.js +49 -0
  20. package/bin/platforms/gemini.js +65 -0
  21. package/bin/platforms/opencode.js +95 -0
  22. package/bin/registry-helpers.js +504 -0
  23. package/bin/static-server.js +153 -0
  24. package/bin/studio-store.js +94 -0
  25. package/bin/sync-shared.sh +5 -0
  26. package/package.json +91 -4
  27. package/plugin.json +139 -0
  28. package/shared/SKILL.md +568 -0
  29. package/shared/agents/coach.md +225 -0
  30. package/shared/agents/navigator.md +215 -0
  31. package/shared/agents/professor.md +372 -0
  32. package/shared/agents/researcher.md +181 -0
  33. package/shared/agents/spotter.md +129 -0
  34. package/shared/commands/professor/archive.md +103 -0
  35. package/shared/commands/professor/capstone-review.md +79 -0
  36. package/shared/commands/professor/capstone.md +34 -0
  37. package/shared/commands/professor/discuss.md +18 -0
  38. package/shared/commands/professor/done.md +44 -0
  39. package/shared/commands/professor/export.md +69 -0
  40. package/shared/commands/professor/hint.md +108 -0
  41. package/shared/commands/professor/navigator.md +67 -0
  42. package/shared/commands/professor/new-topic.md +73 -0
  43. package/shared/commands/professor/next.md +174 -0
  44. package/shared/commands/professor/note.md +63 -0
  45. package/shared/commands/professor/onboard.md +95 -0
  46. package/shared/commands/professor/progress.md +46 -0
  47. package/shared/commands/professor/publish.md +93 -0
  48. package/shared/commands/professor/quiz.md +27 -0
  49. package/shared/commands/professor/recall.md +74 -0
  50. package/shared/commands/professor/review.md +43 -0
  51. package/shared/commands/professor/schedule.md +75 -0
  52. package/shared/commands/professor/skill-export.md +87 -0
  53. package/shared/commands/professor/spotter.md +76 -0
  54. package/shared/commands/professor/stuck.md +27 -0
  55. package/shared/commands/professor/switch.md +50 -0
  56. package/shared/commands/professor/syllabus.md +9 -0
  57. package/shared/commands/professor/template-export.md +91 -0
  58. package/shared/commands/professor/template-import.md +111 -0
  59. package/shared/commands/professor/worktrees.md +58 -0
  60. package/shared/hooks/pre-compact.js +232 -0
  61. package/studio/README.md +313 -0
  62. package/studio/dist/assets/BetaReportPanel-8NrDLiPm.js +1 -0
  63. package/studio/dist/assets/Capstone-Cv9kH6LY.js +6 -0
  64. package/studio/dist/assets/CodeWorkspace-BwCEINWo.js +2 -0
  65. package/studio/dist/assets/Course-BJ_hafUP.js +1 -0
  66. package/studio/dist/assets/Editor-CV0mNhlz.js +53 -0
  67. package/studio/dist/assets/Home-C1ry89ak.js +1 -0
  68. package/studio/dist/assets/KaTeX_AMS-Regular-BQhdFMY1.woff2 +0 -0
  69. package/studio/dist/assets/KaTeX_AMS-Regular-DMm9YOAa.woff +0 -0
  70. package/studio/dist/assets/KaTeX_AMS-Regular-DRggAlZN.ttf +0 -0
  71. package/studio/dist/assets/KaTeX_Caligraphic-Bold-ATXxdsX0.ttf +0 -0
  72. package/studio/dist/assets/KaTeX_Caligraphic-Bold-BEiXGLvX.woff +0 -0
  73. package/studio/dist/assets/KaTeX_Caligraphic-Bold-Dq_IR9rO.woff2 +0 -0
  74. package/studio/dist/assets/KaTeX_Caligraphic-Regular-CTRA-rTL.woff +0 -0
  75. package/studio/dist/assets/KaTeX_Caligraphic-Regular-Di6jR-x-.woff2 +0 -0
  76. package/studio/dist/assets/KaTeX_Caligraphic-Regular-wX97UBjC.ttf +0 -0
  77. package/studio/dist/assets/KaTeX_Fraktur-Bold-BdnERNNW.ttf +0 -0
  78. package/studio/dist/assets/KaTeX_Fraktur-Bold-BsDP51OF.woff +0 -0
  79. package/studio/dist/assets/KaTeX_Fraktur-Bold-CL6g_b3V.woff2 +0 -0
  80. package/studio/dist/assets/KaTeX_Fraktur-Regular-CB_wures.ttf +0 -0
  81. package/studio/dist/assets/KaTeX_Fraktur-Regular-CTYiF6lA.woff2 +0 -0
  82. package/studio/dist/assets/KaTeX_Fraktur-Regular-Dxdc4cR9.woff +0 -0
  83. package/studio/dist/assets/KaTeX_Main-Bold-Cx986IdX.woff2 +0 -0
  84. package/studio/dist/assets/KaTeX_Main-Bold-Jm3AIy58.woff +0 -0
  85. package/studio/dist/assets/KaTeX_Main-Bold-waoOVXN0.ttf +0 -0
  86. package/studio/dist/assets/KaTeX_Main-BoldItalic-DxDJ3AOS.woff2 +0 -0
  87. package/studio/dist/assets/KaTeX_Main-BoldItalic-DzxPMmG6.ttf +0 -0
  88. package/studio/dist/assets/KaTeX_Main-BoldItalic-SpSLRI95.woff +0 -0
  89. package/studio/dist/assets/KaTeX_Main-Italic-3WenGoN9.ttf +0 -0
  90. package/studio/dist/assets/KaTeX_Main-Italic-BMLOBm91.woff +0 -0
  91. package/studio/dist/assets/KaTeX_Main-Italic-NWA7e6Wa.woff2 +0 -0
  92. package/studio/dist/assets/KaTeX_Main-Regular-B22Nviop.woff2 +0 -0
  93. package/studio/dist/assets/KaTeX_Main-Regular-Dr94JaBh.woff +0 -0
  94. package/studio/dist/assets/KaTeX_Main-Regular-ypZvNtVU.ttf +0 -0
  95. package/studio/dist/assets/KaTeX_Math-BoldItalic-B3XSjfu4.ttf +0 -0
  96. package/studio/dist/assets/KaTeX_Math-BoldItalic-CZnvNsCZ.woff2 +0 -0
  97. package/studio/dist/assets/KaTeX_Math-BoldItalic-iY-2wyZ7.woff +0 -0
  98. package/studio/dist/assets/KaTeX_Math-Italic-DA0__PXp.woff +0 -0
  99. package/studio/dist/assets/KaTeX_Math-Italic-flOr_0UB.ttf +0 -0
  100. package/studio/dist/assets/KaTeX_Math-Italic-t53AETM-.woff2 +0 -0
  101. package/studio/dist/assets/KaTeX_SansSerif-Bold-CFMepnvq.ttf +0 -0
  102. package/studio/dist/assets/KaTeX_SansSerif-Bold-D1sUS0GD.woff2 +0 -0
  103. package/studio/dist/assets/KaTeX_SansSerif-Bold-DbIhKOiC.woff +0 -0
  104. package/studio/dist/assets/KaTeX_SansSerif-Italic-C3H0VqGB.woff2 +0 -0
  105. package/studio/dist/assets/KaTeX_SansSerif-Italic-DN2j7dab.woff +0 -0
  106. package/studio/dist/assets/KaTeX_SansSerif-Italic-YYjJ1zSn.ttf +0 -0
  107. package/studio/dist/assets/KaTeX_SansSerif-Regular-BNo7hRIc.ttf +0 -0
  108. package/studio/dist/assets/KaTeX_SansSerif-Regular-CS6fqUqJ.woff +0 -0
  109. package/studio/dist/assets/KaTeX_SansSerif-Regular-DDBCnlJ7.woff2 +0 -0
  110. package/studio/dist/assets/KaTeX_Script-Regular-C5JkGWo-.ttf +0 -0
  111. package/studio/dist/assets/KaTeX_Script-Regular-D3wIWfF6.woff2 +0 -0
  112. package/studio/dist/assets/KaTeX_Script-Regular-D5yQViql.woff +0 -0
  113. package/studio/dist/assets/KaTeX_Size1-Regular-C195tn64.woff +0 -0
  114. package/studio/dist/assets/KaTeX_Size1-Regular-Dbsnue_I.ttf +0 -0
  115. package/studio/dist/assets/KaTeX_Size1-Regular-mCD8mA8B.woff2 +0 -0
  116. package/studio/dist/assets/KaTeX_Size2-Regular-B7gKUWhC.ttf +0 -0
  117. package/studio/dist/assets/KaTeX_Size2-Regular-Dy4dx90m.woff2 +0 -0
  118. package/studio/dist/assets/KaTeX_Size2-Regular-oD1tc_U0.woff +0 -0
  119. package/studio/dist/assets/KaTeX_Size3-Regular-CTq5MqoE.woff +0 -0
  120. package/studio/dist/assets/KaTeX_Size3-Regular-DgpXs0kz.ttf +0 -0
  121. package/studio/dist/assets/KaTeX_Size4-Regular-BF-4gkZK.woff +0 -0
  122. package/studio/dist/assets/KaTeX_Size4-Regular-DWFBv043.ttf +0 -0
  123. package/studio/dist/assets/KaTeX_Size4-Regular-Dl5lxZxV.woff2 +0 -0
  124. package/studio/dist/assets/KaTeX_Typewriter-Regular-C0xS9mPB.woff +0 -0
  125. package/studio/dist/assets/KaTeX_Typewriter-Regular-CO6r4hn1.woff2 +0 -0
  126. package/studio/dist/assets/KaTeX_Typewriter-Regular-D3Ib7_Hf.ttf +0 -0
  127. package/studio/dist/assets/Lesson-2e9TD9yL.js +2 -0
  128. package/studio/dist/assets/NewCourse-BZeOg2xn.js +952 -0
  129. package/studio/dist/assets/Progress-CRc_xEWC.js +1 -0
  130. package/studio/dist/assets/Review-6QEbHEfk.js +1 -0
  131. package/studio/dist/assets/Settings-NFnqVQui.js +1 -0
  132. package/studio/dist/assets/TutorPanel-DXQ6Z3BY.js +123 -0
  133. package/studio/dist/assets/abnfDiagram-WEYOIA3C-qeSjKlGM.js +1 -0
  134. package/studio/dist/assets/anthropic-D7NiQCUH.js +15 -0
  135. package/studio/dist/assets/arc-Y1ARJVZ4.js +1 -0
  136. package/studio/dist/assets/architecture-WOLXFQ4H-COG-m35l.js +1 -0
  137. package/studio/dist/assets/architectureDiagram-ZHVYKT53-VO7uKoeD.js +36 -0
  138. package/studio/dist/assets/array-BifhSqXX.js +1 -0
  139. package/studio/dist/assets/blockDiagram-RJAE7QA3-BGJF_qiL.js +140 -0
  140. package/studio/dist/assets/bridge-BTh0AeNX.js +1 -0
  141. package/studio/dist/assets/c4Diagram-XDPPPE54-C-S10RgU.js +38 -0
  142. package/studio/dist/assets/capstone-Amn6Hztq.js +135 -0
  143. package/studio/dist/assets/card-store-BrbrtX9w.js +1 -0
  144. package/studio/dist/assets/channel-SJiUQu_N.js +1 -0
  145. package/studio/dist/assets/chunk-2E7WHVMD-fv-iqTyC.js +88 -0
  146. package/studio/dist/assets/chunk-2Q5K7J3B-C1jixKkw.js +1 -0
  147. package/studio/dist/assets/chunk-4EMNKR2T-CY9IZrgv.js +1 -0
  148. package/studio/dist/assets/chunk-55XCU76K-DyTZz7v_.js +1 -0
  149. package/studio/dist/assets/chunk-5VM5RSS4-ZNzvKenW.js +15 -0
  150. package/studio/dist/assets/chunk-7S6XSTFO-BNMzTLRW.js +2 -0
  151. package/studio/dist/assets/chunk-AQDTSKZB-CEYANohH.js +72 -0
  152. package/studio/dist/assets/chunk-DSNLSHJZ-CDk5EXjH.js +129 -0
  153. package/studio/dist/assets/chunk-DUW6YSOI-Dgx8z5s3.js +1 -0
  154. package/studio/dist/assets/chunk-HAGFOTED-hNAi1zh_.js +62 -0
  155. package/studio/dist/assets/chunk-HNE4Q36P-COJnSYoZ.js +1 -0
  156. package/studio/dist/assets/chunk-J5ZVWO5B-oDCd-gWO.js +1 -0
  157. package/studio/dist/assets/chunk-JWPE2WC7-DVXcaiue.js +1 -0
  158. package/studio/dist/assets/chunk-NGNAAXSQ-C2Wy9Xmz.js +136 -0
  159. package/studio/dist/assets/chunk-NQOKRVIF-BU6KVxRr.js +213 -0
  160. package/studio/dist/assets/chunk-UHW7PFBP-DYvxL9JG.js +1 -0
  161. package/studio/dist/assets/chunk-VQ5W62QI-CuRfk65j.js +1 -0
  162. package/studio/dist/assets/chunk-WQQL4CDK-KaG7x-Mb.js +10 -0
  163. package/studio/dist/assets/chunk-XXDRQBXY-CnbRkih_.js +1 -0
  164. package/studio/dist/assets/chunk-Y2CYZVJY-DsF7k-Jl.js +1 -0
  165. package/studio/dist/assets/chunk-YZO67HFG-DbuqIZmk.js +1 -0
  166. package/studio/dist/assets/chunk-ZAUX2LTX-bk4ivUmc.js +1 -0
  167. package/studio/dist/assets/chunk-ZCHMQSOR-B_LElfwh.js +2 -0
  168. package/studio/dist/assets/classDiagram-v2-4MYWR3UA-DtCJ6H_X.js +217 -0
  169. package/studio/dist/assets/cose-bilkent-JH36ORCC-DMBAZFnj.js +1 -0
  170. package/studio/dist/assets/course-export-DpaOTT3a.js +1 -0
  171. package/studio/dist/assets/cynefin-EF2NZ3EQ-D9btHJvU.js +1 -0
  172. package/studio/dist/assets/cynefinDiagram-WF24UDRP-CsFJuv27.js +62 -0
  173. package/studio/dist/assets/cytoscape.esm-CHBj4VkZ.js +321 -0
  174. package/studio/dist/assets/dagre-NK4GIZVX-Cg1Duec7.js +4 -0
  175. package/studio/dist/assets/defaultLocale-BFoDCU3G.js +1 -0
  176. package/studio/dist/assets/diagram-CBK3MWTC-_KU2m5gd.js +24 -0
  177. package/studio/dist/assets/diagram-I5XIIV2D-5RaBrwUA.js +24 -0
  178. package/studio/dist/assets/diagram-ODIL2UCW-C0VKxoD3.js +30 -0
  179. package/studio/dist/assets/diagram-PFBEJUXE-BaHcZEP2.js +3 -0
  180. package/studio/dist/assets/diagram-RJA3I4VV-cwSAZ90p.js +41 -0
  181. package/studio/dist/assets/diagram-TYUNFSNR-BJImxCEN.js +200 -0
  182. package/studio/dist/assets/dist-CumnGVmJ.js +1 -0
  183. package/studio/dist/assets/ebnfDiagram-V4P3TTPT-OQQLRXcm.js +1 -0
  184. package/studio/dist/assets/elk-QONTBCTQ-BJGhQHxQ.js +27 -0
  185. package/studio/dist/assets/erDiagram-KYQIGQAA-D91EKSep.js +99 -0
  186. package/studio/dist/assets/error-BTdmRKoB.js +1 -0
  187. package/studio/dist/assets/errors-BZa_CNHL.js +1 -0
  188. package/studio/dist/assets/eventmodeling-K75KTNOO-DgdTRgnw.js +1 -0
  189. package/studio/dist/assets/fetch-local-DG3O3hmQ.js +4 -0
  190. package/studio/dist/assets/flowDiagram-IUGLLWBU-CVnJYMum.js +1 -0
  191. package/studio/dist/assets/ganttDiagram-R7GPNTJY-CSYLPWEI.js +292 -0
  192. package/studio/dist/assets/gitGraph-VSP46ZUC-D6GWaV9y.js +1 -0
  193. package/studio/dist/assets/gitGraphDiagram-PDYL7XHY-CaV31bvT.js +106 -0
  194. package/studio/dist/assets/graphlib-DS17s2tU.js +1 -0
  195. package/studio/dist/assets/index-CVenTTOY.css +2 -0
  196. package/studio/dist/assets/index-DioXTZVc.js +313 -0
  197. package/studio/dist/assets/info-OHQRW6UA-BN-x8GoN.js +1 -0
  198. package/studio/dist/assets/infoDiagram-MVDRKAX5-CIose_cy.js +2 -0
  199. package/studio/dist/assets/init-C-OQMol4.js +1 -0
  200. package/studio/dist/assets/ishikawaDiagram-HPEHV2GE-DCihSNBw.js +70 -0
  201. package/studio/dist/assets/journeyDiagram-BOSHW7O7-Bz3o3RIX.js +139 -0
  202. package/studio/dist/assets/js.worker-AD7DjksO.js +4 -0
  203. package/studio/dist/assets/kanban-definition-FNSA4HC5-BUyqvlFE.js +89 -0
  204. package/studio/dist/assets/katex-B_JcIwqj.js +257 -0
  205. package/studio/dist/assets/katex-BgsA2lO1.css +1 -0
  206. package/studio/dist/assets/line-B08T8KlK.js +1 -0
  207. package/studio/dist/assets/linear-C9iwaMOi.js +1 -0
  208. package/studio/dist/assets/mermaid-parser.core-BYwreSUy.js +7 -0
  209. package/studio/dist/assets/mermaid.core-DTO1oDmq.js +44 -0
  210. package/studio/dist/assets/mindmap-definition-6OY57UG3-BGLwKheY.js +98 -0
  211. package/studio/dist/assets/node.browser-BISniYn8.js +1 -0
  212. package/studio/dist/assets/node.browser-HQ5SKBOf.js +1 -0
  213. package/studio/dist/assets/ollama-De5w84tG.js +1 -0
  214. package/studio/dist/assets/openai-compatible-Joy1oK3L.js +1 -0
  215. package/studio/dist/assets/ordinal-BDEzSJ7C.js +1 -0
  216. package/studio/dist/assets/packet-JDAUHWVQ-CDIMjHS_.js +1 -0
  217. package/studio/dist/assets/path-fybaL0A-.js +1 -0
  218. package/studio/dist/assets/pegDiagram-ECIUJNBX-DWXm4mwS.js +1 -0
  219. package/studio/dist/assets/pie-XZMESJXO-CY3QQiKZ.js +1 -0
  220. package/studio/dist/assets/pieDiagram-GNMPY74T-M1aCnI7W.js +39 -0
  221. package/studio/dist/assets/python.worker-CzTrFdd9.js +24 -0
  222. package/studio/dist/assets/quadrantDiagram-D57K4MC3-BFFtO7U5.js +7 -0
  223. package/studio/dist/assets/radar-ABXABTNO-DT0W4_Xn.js +1 -0
  224. package/studio/dist/assets/railroad-I3PHUGI6-_VCpgZR5.js +1 -0
  225. package/studio/dist/assets/railroad-abnf-LNEFI6M7-DkSpQ5YY.js +1 -0
  226. package/studio/dist/assets/railroad-ebnf-DWYD2UWJ-BqWILdGb.js +1 -0
  227. package/studio/dist/assets/railroad-peg-JR7BVNR7-BB0bQL-Z.js +1 -0
  228. package/studio/dist/assets/railroadDiagram-Y72NRBL7-CjLKjIdJ.js +1 -0
  229. package/studio/dist/assets/react-B8SKf8RM.js +1 -0
  230. package/studio/dist/assets/rehype-katex-C-sKddsH.js +259 -0
  231. package/studio/dist/assets/remark-math-C-ox67hE.js +5 -0
  232. package/studio/dist/assets/requirementDiagram-EQYSW5RA-CnwzZqR8.js +84 -0
  233. package/studio/dist/assets/rolldown-runtime-COiEfhsA.js +1 -0
  234. package/studio/dist/assets/rough.esm-Dy-Kn_BL.js +1 -0
  235. package/studio/dist/assets/sankeyDiagram-SY24JHO5-CPDugTUl.js +40 -0
  236. package/studio/dist/assets/schemas-BOc2YsOP.js +55 -0
  237. package/studio/dist/assets/sequenceDiagram-BLEHNHQU-1dLfeU9Y.js +169 -0
  238. package/studio/dist/assets/settings-DhwuyNPU.js +1 -0
  239. package/studio/dist/assets/sizeCapture-INFHLROL-3uHXrFqA.js +1 -0
  240. package/studio/dist/assets/spec-nAnsSMkw.js +1 -0
  241. package/studio/dist/assets/sql-wasm-C1D_RJuy.wasm +0 -0
  242. package/studio/dist/assets/sql.worker-D7pBHOrq.js +4 -0
  243. package/studio/dist/assets/src-BWF7jMDv.js +1 -0
  244. package/studio/dist/assets/stateDiagram-v2-A6IESKWZ-DR7CmEjj.js +291 -0
  245. package/studio/dist/assets/swimlanes-B3ENRKFQ-BAWB9omQ.js +1 -0
  246. package/studio/dist/assets/swimlanesDiagram-AYQRV4AK-qeuHru16.js +8 -0
  247. package/studio/dist/assets/timeline-definition-JXYKGLGB-DNkj8z77.js +120 -0
  248. package/studio/dist/assets/treeView-D4JQ5SDB-BA-ouhMb.js +1 -0
  249. package/studio/dist/assets/treemap-SAJKECNS-BrrGxsAb.js +1 -0
  250. package/studio/dist/assets/useStream-rdsR6A7P.js +1 -0
  251. package/studio/dist/assets/usecaseDiagram-WPOLBNNX-BB3D0Dt_.js +328 -0
  252. package/studio/dist/assets/vennDiagram-Q3Y3IDCW-BrtqtKTE.js +34 -0
  253. package/studio/dist/assets/wardley-7MLQ67FV-BKkemDql.js +1 -0
  254. package/studio/dist/assets/wardleyDiagram-IVAIDKWA-DFnI3P5z.js +78 -0
  255. package/studio/dist/assets/xychartDiagram-4URNHDU4-Da0DZG_q.js +7 -0
  256. package/studio/dist/index.html +20 -0
  257. package/studio/dist/preview.html +22 -0
  258. package/studio/migrations/0001_init.sql +188 -0
  259. package/studio/migrations/0002_external_ids.sql +20 -0
  260. package/studio/migrations/0003_course_language.sql +12 -0
  261. package/studio/migrations/0004_capstone.sql +51 -0
  262. package/studio/migrations/0005_beta_loop.sql +73 -0
  263. package/studio/migrations/0006_interactive_exercises.sql +49 -0
  264. package/studio/src/lib/activity.js +92 -0
  265. package/studio/src/lib/ai/anthropic.js +109 -0
  266. package/studio/src/lib/ai/bridge.js +126 -0
  267. package/studio/src/lib/ai/catalog.js +160 -0
  268. package/studio/src/lib/ai/config.js +70 -0
  269. package/studio/src/lib/ai/errors.js +95 -0
  270. package/studio/src/lib/ai/fetch-local.js +104 -0
  271. package/studio/src/lib/ai/index.js +194 -0
  272. package/studio/src/lib/ai/ollama.js +136 -0
  273. package/studio/src/lib/ai/openai-compatible.js +101 -0
  274. package/studio/src/lib/ai/provider-utils.js +107 -0
  275. package/studio/src/lib/ai/sse.js +99 -0
  276. package/studio/src/lib/ai/status.js +92 -0
  277. package/studio/src/lib/ai/useStream.js +109 -0
  278. package/studio/src/lib/beta/metrics.js +147 -0
  279. package/studio/src/lib/beta/report.js +134 -0
  280. package/studio/src/lib/capstone-evidence.js +758 -0
  281. package/studio/src/lib/capstone.js +663 -0
  282. package/studio/src/lib/chat-store.js +128 -0
  283. package/studio/src/lib/course-export.js +38 -0
  284. package/studio/src/lib/course.js +187 -0
  285. package/studio/src/lib/exercises/journal-entry.js +259 -0
  286. package/studio/src/lib/exercises/placement.js +31 -0
  287. package/studio/src/lib/exercises/registry.js +19 -0
  288. package/studio/src/lib/exercises/spec.js +129 -0
  289. package/studio/src/lib/i18n/detect.js +162 -0
  290. package/studio/src/lib/i18n/en/app.json +23 -0
  291. package/studio/src/lib/i18n/en/betaReport.json +55 -0
  292. package/studio/src/lib/i18n/en/capstone.json +57 -0
  293. package/studio/src/lib/i18n/en/common.json +25 -0
  294. package/studio/src/lib/i18n/en/course.json +27 -0
  295. package/studio/src/lib/i18n/en/data.json +35 -0
  296. package/studio/src/lib/i18n/en/durability.json +5 -0
  297. package/studio/src/lib/i18n/en/errors.json +20 -0
  298. package/studio/src/lib/i18n/en/exercises.json +55 -0
  299. package/studio/src/lib/i18n/en/externalEvidence.json +76 -0
  300. package/studio/src/lib/i18n/en/home.json +18 -0
  301. package/studio/src/lib/i18n/en/lesson.json +33 -0
  302. package/studio/src/lib/i18n/en/nav.json +8 -0
  303. package/studio/src/lib/i18n/en/newCourse.json +51 -0
  304. package/studio/src/lib/i18n/en/onboarding.json +35 -0
  305. package/studio/src/lib/i18n/en/playwrightTemplate.json +20 -0
  306. package/studio/src/lib/i18n/en/practice.json +79 -0
  307. package/studio/src/lib/i18n/en/provider.json +27 -0
  308. package/studio/src/lib/i18n/en/providerMeta.json +26 -0
  309. package/studio/src/lib/i18n/en/reflection.json +17 -0
  310. package/studio/src/lib/i18n/en/revision.json +52 -0
  311. package/studio/src/lib/i18n/en/runnerNotice.json +14 -0
  312. package/studio/src/lib/i18n/en/settings.json +12 -0
  313. package/studio/src/lib/i18n/en/storage.json +49 -0
  314. package/studio/src/lib/i18n/en/tutor.json +39 -0
  315. package/studio/src/lib/i18n/en/workspace.json +50 -0
  316. package/studio/src/lib/i18n/index.js +144 -0
  317. package/studio/src/lib/i18n/languages.js +93 -0
  318. package/studio/src/lib/i18n/vi/app.json +23 -0
  319. package/studio/src/lib/i18n/vi/betaReport.json +55 -0
  320. package/studio/src/lib/i18n/vi/capstone.json +57 -0
  321. package/studio/src/lib/i18n/vi/common.json +25 -0
  322. package/studio/src/lib/i18n/vi/course.json +27 -0
  323. package/studio/src/lib/i18n/vi/data.json +35 -0
  324. package/studio/src/lib/i18n/vi/durability.json +5 -0
  325. package/studio/src/lib/i18n/vi/errors.json +20 -0
  326. package/studio/src/lib/i18n/vi/exercises.json +55 -0
  327. package/studio/src/lib/i18n/vi/externalEvidence.json +76 -0
  328. package/studio/src/lib/i18n/vi/home.json +18 -0
  329. package/studio/src/lib/i18n/vi/lesson.json +33 -0
  330. package/studio/src/lib/i18n/vi/nav.json +8 -0
  331. package/studio/src/lib/i18n/vi/newCourse.json +51 -0
  332. package/studio/src/lib/i18n/vi/onboarding.json +35 -0
  333. package/studio/src/lib/i18n/vi/playwrightTemplate.json +20 -0
  334. package/studio/src/lib/i18n/vi/practice.json +79 -0
  335. package/studio/src/lib/i18n/vi/provider.json +27 -0
  336. package/studio/src/lib/i18n/vi/providerMeta.json +26 -0
  337. package/studio/src/lib/i18n/vi/reflection.json +17 -0
  338. package/studio/src/lib/i18n/vi/revision.json +52 -0
  339. package/studio/src/lib/i18n/vi/runnerNotice.json +14 -0
  340. package/studio/src/lib/i18n/vi/settings.json +12 -0
  341. package/studio/src/lib/i18n/vi/storage.json +49 -0
  342. package/studio/src/lib/i18n/vi/tutor.json +39 -0
  343. package/studio/src/lib/i18n/vi/workspace.json +50 -0
  344. package/studio/src/lib/ids.js +10 -0
  345. package/studio/src/lib/json.js +26 -0
  346. package/studio/src/lib/markdown.js +74 -0
  347. package/studio/src/lib/prompts/base.js +139 -0
  348. package/studio/src/lib/prompts/capstone.js +777 -0
  349. package/studio/src/lib/prompts/course.js +150 -0
  350. package/studio/src/lib/prompts/lesson.js +275 -0
  351. package/studio/src/lib/prompts/practice.js +511 -0
  352. package/studio/src/lib/prompts/tutor.js +509 -0
  353. package/studio/src/lib/repo/blocked-adapter.js +69 -0
  354. package/studio/src/lib/repo/events.js +239 -0
  355. package/studio/src/lib/repo/idb-adapter.js +226 -0
  356. package/studio/src/lib/repo/index.js +1315 -0
  357. package/studio/src/lib/repo/memory-adapter.js +115 -0
  358. package/studio/src/lib/repo/remote-adapter.js +158 -0
  359. package/studio/src/lib/repo/schema.js +143 -0
  360. package/studio/src/lib/repo/select-adapter.js +345 -0
  361. package/studio/src/lib/router.js +71 -0
  362. package/studio/src/lib/runner/browser.js +244 -0
  363. package/studio/src/lib/runner/checks.js +248 -0
  364. package/studio/src/lib/runner/current-code.js +98 -0
  365. package/studio/src/lib/runner/esm-cjs.js +109 -0
  366. package/studio/src/lib/runner/hash.js +34 -0
  367. package/studio/src/lib/runner/history.js +48 -0
  368. package/studio/src/lib/runner/index.js +168 -0
  369. package/studio/src/lib/runner/languages.js +258 -0
  370. package/studio/src/lib/runner/local.js +139 -0
  371. package/studio/src/lib/runner/path.js +104 -0
  372. package/studio/src/lib/runner/skeleton.js +315 -0
  373. package/studio/src/lib/runner/strip-types.js +134 -0
  374. package/studio/src/lib/settings.js +399 -0
  375. package/studio/src/lib/srs.js +39 -0
  376. package/templates/agent/settings.json +6 -0
  377. package/templates/claude/plugin.json +139 -0
  378. package/templates/claude/settings.json +15 -0
  379. package/templates/cursor/professor.mdc +4 -0
  380. package/templates/cursor/settings.json +18 -0
  381. package/templates/gemini/GEMINI.md +28 -0
  382. package/templates/gemini/settings.json +5 -0
  383. package/templates/opencode/opencode.json +3 -0
  384. package/templates/researcher/README.md +61 -0
  385. package/templates/researcher/settings.json +18 -0
  386. package/web/client/components.json +15 -0
  387. package/web/client/index.html +12 -0
  388. package/web/client/package-lock.json +8732 -0
  389. package/web/client/package.json +39 -0
  390. package/web/client/postcss.config.js +6 -0
  391. package/web/client/src/App.jsx +140 -0
  392. package/web/client/src/api/client.js +357 -0
  393. package/web/client/src/components/ChatPanel.jsx +417 -0
  394. package/web/client/src/components/CommandPills.jsx +50 -0
  395. package/web/client/src/components/DeprecationBanner.jsx +21 -0
  396. package/web/client/src/components/ExerciseEditor.jsx +164 -0
  397. package/web/client/src/components/Header.jsx +119 -0
  398. package/web/client/src/components/LecturePanel.jsx +342 -0
  399. package/web/client/src/components/MobileTabSwitcher.jsx +51 -0
  400. package/web/client/src/components/SplitPane.jsx +42 -0
  401. package/web/client/src/components/ui/alert.jsx +38 -0
  402. package/web/client/src/components/ui/badge.jsx +24 -0
  403. package/web/client/src/components/ui/button.jsx +23 -0
  404. package/web/client/src/components/ui/select.jsx +74 -0
  405. package/web/client/src/hooks/useSSE.js +152 -0
  406. package/web/client/src/hooks/useWebSocket.js +98 -0
  407. package/web/client/src/index.css +23 -0
  408. package/web/client/src/lib/utils.js +6 -0
  409. package/web/client/src/main.jsx +12 -0
  410. package/web/client/src/utils/markdown.js +50 -0
  411. package/web/client/tailwind.config.js +8 -0
  412. package/web/client/vite.config.js +21 -0
  413. package/web/dist/assets/index-C1W0eXIQ.js +294 -0
  414. package/web/dist/assets/index-C3OUx70T.css +1 -0
  415. package/web/dist/index.html +13 -0
  416. package/web/lecture-archive.js +172 -0
  417. package/web/legacy-server.js +1277 -0
  418. package/web/package-lock.json +855 -0
  419. package/web/package.json +10 -0
  420. package/web/security.js +1016 -0
  421. package/web/server.js +390 -0
  422. package/web/studio-api/agents.js +580 -0
  423. package/web/studio-api/bridge.js +199 -0
  424. package/web/studio-api/db.js +66 -0
  425. package/web/studio-api/guards.js +201 -0
  426. package/web/studio-api/health.js +538 -0
  427. package/web/studio-api.js +214 -0
  428. package/web/studio-db.js +380 -0
  429. package/web/studio-runner.js +568 -0
@@ -0,0 +1,345 @@
1
+ /**
2
+ * select-adapter — resolve the ONE storage backend the learner chose (STORE-01/02).
3
+ *
4
+ * `settings.storage` is `'browser' | 'sqlite' | null`. When it is `null` the app calls
5
+ * `resolveStorageChoice()` once, which adopts the store that actually holds data (or the default:
6
+ * SQLite when a bridge is paired, else the browser) and records it. After that, `initAdapter()` uses
7
+ * ONLY the chosen store and never auto-falls back — if SQLite is chosen but the server is down, a
8
+ * BlockedAdapter is installed so nothing is read from or written to IndexedDB in that state.
9
+ *
10
+ * Deliberately free of React imports so the same code runs in tests/Node; Settings are read from
11
+ * localStorage directly when not passed in.
12
+ */
13
+ import { useAdapter, exportAll } from './index.js';
14
+ import { createIdbAdapter, IDB_DB_NAME } from './idb-adapter.js';
15
+ import { createRemoteAdapter } from './remote-adapter.js';
16
+ import { createBlockedAdapter, StorageUnavailableError } from './blocked-adapter.js';
17
+ import {
18
+ SETTINGS_KEY as SETTINGS_KEY_FROM_SETTINGS,
19
+ STORAGE_BROWSER,
20
+ STORAGE_SQLITE,
21
+ STORAGE_KINDS,
22
+ saveSettings,
23
+ } from '../settings.js';
24
+
25
+ export const SETTINGS_KEY = SETTINGS_KEY_FROM_SETTINGS;
26
+ export { STORAGE_BROWSER, STORAGE_SQLITE, STORAGE_KINDS };
27
+ const PROBE_TIMEOUT_MS = 1500;
28
+
29
+ /**
30
+ * Stable reason codes for a failed SQLite probe (RON-210). The UI localizes these codes; `error`
31
+ * stays as an English developer-facing detail for logs. Adding a code means adding its `storage.
32
+ * reasons.<code>.short` / `.hint` strings to BOTH catalogs.
33
+ */
34
+ export const PROBE_REASONS = Object.freeze({
35
+ NOT_PAIRED: 'not_paired',
36
+ UNREACHABLE: 'unreachable',
37
+ UNEXPECTED: 'unexpected',
38
+ });
39
+
40
+ /** @returns {object} the stored settings object, or {} when unavailable. */
41
+ export function readStoredSettings() {
42
+ try {
43
+ if (typeof localStorage === 'undefined') return {};
44
+ const raw = localStorage.getItem(SETTINGS_KEY);
45
+ return raw ? JSON.parse(raw) : {};
46
+ } catch {
47
+ return {};
48
+ }
49
+ }
50
+
51
+ /** @param {object} [settings] */
52
+ export function bridgeConfigFrom(settings = readStoredSettings()) {
53
+ const bridge = settings.bridge || {};
54
+ return {
55
+ bridgeUrl: bridge.bridgeUrl || settings.bridgeUrl || '',
56
+ bridgeToken: bridge.bridgeToken || settings.bridgeToken || '',
57
+ agent: bridge.agent || '',
58
+ };
59
+ }
60
+
61
+ /** Whether a local server is paired (URL + token) — the signal for the SQLite default. */
62
+ export function hasBridgeConfig(settings = readStoredSettings()) {
63
+ const cfg = bridgeConfigFrom(settings);
64
+ return Boolean(cfg.bridgeUrl && cfg.bridgeToken);
65
+ }
66
+
67
+ /** The explicit choice, or null when the learner has not decided yet. */
68
+ export function storageKindFrom(settings = readStoredSettings()) {
69
+ return STORAGE_KINDS.includes(settings?.storage) ? settings.storage : null;
70
+ }
71
+
72
+ /** The default used when there is no explicit choice: SQLite when a bridge is paired, else browser. */
73
+ export function defaultStorageKind(settings = readStoredSettings()) {
74
+ return hasBridgeConfig(settings) ? STORAGE_SQLITE : STORAGE_BROWSER;
75
+ }
76
+
77
+ /** The store the app will actually use: explicit choice, else the default. */
78
+ export function effectiveStorageKind(settings = readStoredSettings()) {
79
+ return storageKindFrom(settings) || defaultStorageKind(settings);
80
+ }
81
+
82
+ function withTimeout(promise, ms) {
83
+ return Promise.race([
84
+ promise,
85
+ new Promise((_, reject) => setTimeout(() => reject(new Error('timeout')), ms)),
86
+ ]);
87
+ }
88
+
89
+ /** Total rows across every table in a tables map. */
90
+ export function countRows(tables = {}) {
91
+ return Object.values(tables).reduce((n, rows) => n + (Array.isArray(rows) ? rows.length : 0), 0);
92
+ }
93
+
94
+ /** Per-table row counts. */
95
+ export function tableCounts(dump) {
96
+ const out = {};
97
+ for (const [table, rows] of Object.entries(dump?.tables || {})) out[table] = Array.isArray(rows) ? rows.length : 0;
98
+ return out;
99
+ }
100
+
101
+ /**
102
+ * Probe the paired local server's `/db/health`.
103
+ *
104
+ * On failure the result carries a stable `reason` code from `PROBE_REASONS` (the UI localizes it) and
105
+ * an English `error` detail that is only meant for logs. `reason` is absent when the probe succeeds.
106
+ *
107
+ * @returns {Promise<{ available: boolean, configured: boolean, path: string, health?: object, reason?: string, error?: string }>}
108
+ */
109
+ export async function probeSqlite(settings = readStoredSettings(), { fetchImpl, timeoutMs = PROBE_TIMEOUT_MS } = {}) {
110
+ const cfg = bridgeConfigFrom(settings);
111
+ if (!cfg.bridgeUrl || !cfg.bridgeToken) {
112
+ return {
113
+ available: false,
114
+ configured: false,
115
+ path: '',
116
+ reason: PROBE_REASONS.NOT_PAIRED,
117
+ error: 'No local server is paired.',
118
+ };
119
+ }
120
+ const adapter = createRemoteAdapter({ baseUrl: cfg.bridgeUrl, token: cfg.bridgeToken, fetchImpl });
121
+ try {
122
+ const health = await withTimeout(adapter.health(), timeoutMs);
123
+ if (health?.ok) return { available: true, configured: true, path: health.path || '', health };
124
+ return {
125
+ available: false,
126
+ configured: true,
127
+ path: '',
128
+ reason: PROBE_REASONS.UNEXPECTED,
129
+ error: 'The local server answered unexpectedly.',
130
+ };
131
+ } catch (err) {
132
+ // A network failure/timeout means "never answered"; a coded server rejection (bad token, 5xx,
133
+ // unexpected payload) means it answered, just not the way we need.
134
+ const code = err?.code;
135
+ const reason = code && code !== 'network' ? PROBE_REASONS.UNEXPECTED : PROBE_REASONS.UNREACHABLE;
136
+ return {
137
+ available: false,
138
+ configured: true,
139
+ path: '',
140
+ reason,
141
+ error: err?.message || 'The local server is not reachable.',
142
+ };
143
+ }
144
+ }
145
+
146
+ /** Count what currently lives in the browser copy (IndexedDB), if any. */
147
+ export async function probeBrowserStore({ adapter } = {}) {
148
+ try {
149
+ const idb = adapter || createIdbAdapter();
150
+ const dump = await idb.exportAll();
151
+ const total = countRows(dump.tables);
152
+ return { hasData: total > 0, total, dump };
153
+ } catch {
154
+ return { hasData: false, total: 0, dump: null };
155
+ }
156
+ }
157
+
158
+ /** Probe both stores: availability + whether each holds data (used for one-time migration). */
159
+ export async function detectAvailableStores(settings = readStoredSettings(), opts = {}) {
160
+ const probe = await probeSqlite(settings, opts);
161
+ let sqliteTotal = 0;
162
+ if (probe.available) {
163
+ const cfg = bridgeConfigFrom(settings);
164
+ try {
165
+ const remote = createRemoteAdapter({ baseUrl: cfg.bridgeUrl, token: cfg.bridgeToken, fetchImpl: opts.fetchImpl });
166
+ sqliteTotal = countRows((await remote.exportAll()).tables);
167
+ } catch {
168
+ /* treat as empty */
169
+ }
170
+ }
171
+ const browser = await probeBrowserStore(opts);
172
+ return {
173
+ sqlite: { ...probe, hasData: sqliteTotal > 0, total: sqliteTotal },
174
+ browser,
175
+ };
176
+ }
177
+
178
+ /**
179
+ * Decide where data should live for a learner who has not chosen yet (STORE-01 migration).
180
+ * Pure: it never writes settings.
181
+ *
182
+ * @returns {Promise<{ storage?: string, migrated?: boolean, needsDecision?: boolean, stores?: object }>}
183
+ */
184
+ export async function resolveStorageChoice(settings = readStoredSettings(), opts = {}) {
185
+ const chosen = storageKindFrom(settings);
186
+ if (chosen) return { storage: chosen, migrated: false };
187
+
188
+ const stores = await detectAvailableStores(settings, opts);
189
+ const sqliteHasData = stores.sqlite.available && stores.sqlite.total > 0;
190
+ const browserHasData = stores.browser.total > 0;
191
+
192
+ if (sqliteHasData && browserHasData) return { needsDecision: true, stores };
193
+ if (sqliteHasData) return { storage: STORAGE_SQLITE, migrated: true, stores };
194
+ if (browserHasData) return { storage: STORAGE_BROWSER, migrated: true, stores };
195
+ return { storage: defaultStorageKind(settings), migrated: true, stores };
196
+ }
197
+
198
+ /**
199
+ * Resolve the adapter for the chosen store. Never falls back: SQLite down ⇒ BlockedAdapter.
200
+ * @param {{ settings?: object, timeoutMs?: number, fetchImpl?: typeof fetch }} [opts]
201
+ * @returns {Promise<{ adapter: object, kind: 'remote'|'indexeddb'|'blocked', storage: string, health?: object, blocked?: boolean, error?: string }>}
202
+ */
203
+ export async function selectAdapter({ settings, timeoutMs = PROBE_TIMEOUT_MS, fetchImpl } = {}) {
204
+ const effective = settings || readStoredSettings();
205
+ const storage = effectiveStorageKind(effective);
206
+
207
+ if (storage === STORAGE_SQLITE) {
208
+ const probe = await probeSqlite(effective, { fetchImpl, timeoutMs });
209
+ if (probe.available) {
210
+ const cfg = bridgeConfigFrom(effective);
211
+ const adapter = createRemoteAdapter({ baseUrl: cfg.bridgeUrl, token: cfg.bridgeToken, fetchImpl });
212
+ return { adapter, kind: 'remote', storage, health: probe.health };
213
+ }
214
+ const reason = probe.configured
215
+ ? 'The local server isn’t running — start it with `npx ronin-skillforce studio`.'
216
+ : 'SQLite storage needs the local server, but no bridge is paired.';
217
+ return {
218
+ adapter: createBlockedAdapter({ kind: 'sqlite', reason, path: probe.path }),
219
+ kind: 'blocked',
220
+ storage,
221
+ blocked: true,
222
+ reason: probe.reason,
223
+ error: probe.error,
224
+ };
225
+ }
226
+
227
+ return { adapter: createIdbAdapter(), kind: 'indexeddb', storage };
228
+ }
229
+
230
+ /**
231
+ * Detect the backend and install it into the repository. Call once at startup.
232
+ * @param {{ settings?: object, timeoutMs?: number, fetchImpl?: typeof fetch }} [opts]
233
+ */
234
+ export async function initAdapter(opts = {}) {
235
+ const result = await selectAdapter(opts);
236
+ useAdapter(result.adapter);
237
+ return result;
238
+ }
239
+
240
+ /* ------------------------------------------------------------------ moving data (STORE-03) */
241
+
242
+ /**
243
+ * Describe a pending move so the UI can ask "Move N courses, M cards… to <target>?".
244
+ * Reads the current store; when it is unreachable (blocked), returns `sourceUnavailable`.
245
+ *
246
+ * @param {string} target 'browser' | 'sqlite'
247
+ * @returns {Promise<{ from: string, to: string, counts: object, targetReady: boolean, targetReason?: string, targetError: string, sourceUnavailable?: boolean, dump?: object, error?: string }>}
248
+ */
249
+ export async function planStorageMove(target, { settings, fetchImpl, timeoutMs } = {}) {
250
+ const effective = settings || readStoredSettings();
251
+ const from = effectiveStorageKind(effective);
252
+ const empty = { courses: 0, cards: 0, total: 0, tables: {} };
253
+
254
+ let dump;
255
+ try {
256
+ dump = await exportAll();
257
+ } catch (err) {
258
+ return { from, to: target, counts: empty, targetReady: false, targetError: '', sourceUnavailable: true, error: err?.message || String(err) };
259
+ }
260
+
261
+ const tables = tableCounts(dump);
262
+ const counts = { courses: tables.courses || 0, cards: tables.cards || 0, total: countRows(dump.tables), tables };
263
+
264
+ let targetReady = true;
265
+ let targetReason;
266
+ let targetError = '';
267
+ if (target === STORAGE_SQLITE) {
268
+ const probe = await probeSqlite(effective, { fetchImpl, timeoutMs });
269
+ targetReady = probe.available;
270
+ targetReason = probe.reason;
271
+ targetError = probe.error || '';
272
+ }
273
+ return { from, to: target, counts, targetReady, targetReason, targetError, dump };
274
+ }
275
+
276
+ /**
277
+ * Copy everything from `dump` (or the current store) into `target`, verify per-table counts, and —
278
+ * only when the counts match — record the setting and install the target adapter. The source copy is
279
+ * left untouched (call `removePreviousCopy` when the learner asks). Settings/keys are never moved:
280
+ * the repository has no settings table.
281
+ *
282
+ * @param {string} target 'browser' | 'sqlite'
283
+ * @returns {Promise<{ switched: boolean, imported: number, expected: object, after: object, mismatches: string[], adapter?: object, error?: string }>}
284
+ */
285
+ export async function performStorageMove(target, { settings, fetchImpl, timeoutMs, dump } = {}) {
286
+ const effective = settings || readStoredSettings();
287
+ const cfg = bridgeConfigFrom(effective);
288
+
289
+ let targetAdapter;
290
+ if (target === STORAGE_SQLITE) {
291
+ const probe = await probeSqlite(effective, { fetchImpl, timeoutMs });
292
+ if (!probe.available) {
293
+ throw new StorageUnavailableError(probe.error || 'The local server is not reachable.', {
294
+ kind: 'sqlite',
295
+ code: probe.reason || 'storage_unavailable',
296
+ path: probe.path,
297
+ });
298
+ }
299
+ targetAdapter = createRemoteAdapter({ baseUrl: cfg.bridgeUrl, token: cfg.bridgeToken, fetchImpl });
300
+ } else {
301
+ targetAdapter = createIdbAdapter();
302
+ }
303
+
304
+ const source = dump || (await exportAll());
305
+ const expected = tableCounts(source);
306
+ const result = await targetAdapter.importAll(source);
307
+ const after = tableCounts(await targetAdapter.exportAll());
308
+ const mismatches = Object.keys(expected).filter((t) => (after[t] || 0) < expected[t]);
309
+ const imported = result?.imported ?? countRows(source.tables);
310
+
311
+ if (mismatches.length) {
312
+ return { switched: false, imported, expected, after, mismatches, adapter: targetAdapter };
313
+ }
314
+
315
+ saveSettings({ storage: target });
316
+ useAdapter(targetAdapter);
317
+ return { switched: true, imported, expected, after, mismatches, adapter: targetAdapter };
318
+ }
319
+
320
+ /** Delete the IndexedDB database (the whole browser copy). */
321
+ export function deleteBrowserDatabase(dbName = IDB_DB_NAME) {
322
+ return new Promise((resolve) => {
323
+ if (typeof indexedDB === 'undefined') {
324
+ resolve({ deleted: false });
325
+ return;
326
+ }
327
+ const req = indexedDB.deleteDatabase(dbName);
328
+ req.onsuccess = () => resolve({ deleted: true });
329
+ req.onerror = () => resolve({ deleted: false, error: req.error });
330
+ req.onblocked = () => resolve({ deleted: false, blocked: true });
331
+ });
332
+ }
333
+
334
+ /**
335
+ * Remove the copy left behind after a switch (STORE-03). Never touches settings.
336
+ * @param {string} kind the *old* store's kind ('browser' | 'sqlite')
337
+ */
338
+ export async function removePreviousCopy(kind, { settings, fetchImpl } = {}) {
339
+ if (kind === STORAGE_SQLITE) {
340
+ const cfg = bridgeConfigFrom(settings || readStoredSettings());
341
+ const remote = createRemoteAdapter({ baseUrl: cfg.bridgeUrl, token: cfg.bridgeToken, fetchImpl });
342
+ return remote.clearAll();
343
+ }
344
+ return deleteBrowserDatabase();
345
+ }
@@ -0,0 +1,71 @@
1
+ /**
2
+ * Tiny hash router (SHELL-02, no router dependency).
3
+ *
4
+ * The fragment is never sent to the server, so deep links and refresh work on any static host.
5
+ * Routes:
6
+ * #/ Home
7
+ * #/new NewCourse
8
+ * #/course/:id Course
9
+ * #/course/:id/lesson/:lessonId Lesson
10
+ * #/course/:id/capstone Capstone
11
+ * #/review Review
12
+ * #/settings Settings
13
+ */
14
+ import { useEffect, useState, createElement } from 'react';
15
+
16
+ const ROUTES = [
17
+ { name: 'home', pattern: /^\/?$/ },
18
+ { name: 'new', pattern: /^\/new\/?$/ },
19
+ { name: 'lesson', pattern: /^\/course\/([^/]+)\/lesson\/([^/]+)\/?$/, keys: ['id', 'lessonId'] },
20
+ { name: 'capstone', pattern: /^\/course\/([^/]+)\/capstone\/?$/, keys: ['id'] },
21
+ { name: 'course', pattern: /^\/course\/([^/]+)\/?$/, keys: ['id'] },
22
+ { name: 'review', pattern: /^\/review\/?$/ },
23
+ { name: 'settings', pattern: /^\/settings\/?$/ },
24
+ ];
25
+
26
+ /**
27
+ * @param {string} [hash]
28
+ * @returns {{ name: string, path: string, params: Record<string,string> }}
29
+ */
30
+ export function matchRoute(hash = '') {
31
+ const path = String(hash || '').replace(/^#/, '').split('?')[0] || '/';
32
+ for (const route of ROUTES) {
33
+ const m = path.match(route.pattern);
34
+ if (m) {
35
+ const params = {};
36
+ (route.keys || []).forEach((key, i) => {
37
+ params[key] = decodeURIComponent(m[i + 1]);
38
+ });
39
+ return { name: route.name, path, params };
40
+ }
41
+ }
42
+ return { name: 'notfound', path, params: {} };
43
+ }
44
+
45
+ export function currentRoute() {
46
+ if (typeof window === 'undefined') return matchRoute('/');
47
+ return matchRoute(window.location.hash);
48
+ }
49
+
50
+ /** Navigate programmatically. */
51
+ export function navigate(to) {
52
+ const target = to.startsWith('#') ? to : `#${to.startsWith('/') ? to : `/${to}`}`;
53
+ if (typeof window !== 'undefined') window.location.hash = target;
54
+ }
55
+
56
+ /** Reactive route hook — re-renders on hashchange. */
57
+ export function useRoute() {
58
+ const [route, setRoute] = useState(currentRoute);
59
+ useEffect(() => {
60
+ const onChange = () => setRoute(currentRoute());
61
+ window.addEventListener('hashchange', onChange);
62
+ if (!window.location.hash) window.location.hash = '#/';
63
+ return () => window.removeEventListener('hashchange', onChange);
64
+ }, []);
65
+ return route;
66
+ }
67
+
68
+ /** Anchor that keeps normal link semantics (middle-click, copy link) with hash routing. */
69
+ export function Link({ to, children, ...rest }) {
70
+ return createElement('a', { href: `#${to.startsWith('/') ? to : `/${to}`}`, ...rest }, children);
71
+ }
@@ -0,0 +1,244 @@
1
+ /**
2
+ * In-browser runner backends (CODE-02), all killable with a hard timeout and an output cap.
3
+ *
4
+ * Workers are created with Vite's `new Worker(new URL(...), { type: 'module' })` form so each
5
+ * backend lands in its own lazy chunk — the CodeMirror/sql.js/Pyodide weight never enters the
6
+ * main bundle. HTML/CSS runs in a sandboxed iframe (no worker) via an inline `srcdoc`.
7
+ *
8
+ * Every backend resolves to the same result shape the runner interface promises (see ./index.js).
9
+ * A timeout is reported as exit code 124 (the shell convention); an abort resolves with
10
+ * `aborted: true` so the UI can drop it silently.
11
+ */
12
+ import { defaultEntry, languageForPath } from './languages.js';
13
+
14
+ export const DEFAULT_TIMEOUT_MS = 10_000;
15
+ export const MAX_OUTPUT_BYTES = 200_000;
16
+
17
+ /** @param {string} language @returns {Worker|null} */
18
+ function createWorker(language) {
19
+ switch (language) {
20
+ case 'javascript':
21
+ case 'typescript':
22
+ return new Worker(new URL('../../workers/js.worker.js', import.meta.url), { type: 'module' });
23
+ case 'python':
24
+ return new Worker(new URL('../../workers/python.worker.js', import.meta.url), { type: 'module' });
25
+ case 'sql':
26
+ return new Worker(new URL('../../workers/sql.worker.js', import.meta.url), { type: 'module' });
27
+ default:
28
+ return null;
29
+ }
30
+ }
31
+
32
+ /** @param {'timeout'|'aborted'|'unavailable'} code @param {string} message */
33
+ class RunnerError extends Error {
34
+ constructor(code, message) {
35
+ super(message);
36
+ this.name = 'RunnerError';
37
+ this.code = code;
38
+ }
39
+ }
40
+
41
+ /**
42
+ * @typedef {object} RunResult
43
+ * @property {string} stdout
44
+ * @property {string} stderr
45
+ * @property {number|null} exitCode
46
+ * @property {Array<{name:string,passed:boolean,message?:string}>} checks
47
+ * @property {number} durationMs
48
+ * @property {'browser'|'local'} runner
49
+ * @property {boolean} [timedOut]
50
+ * @property {boolean} [aborted]
51
+ * @property {boolean} [outputTruncated]
52
+ * @property {{columns:string[], rows:any[]}} [rows]
53
+ * @property {{html:string}} [preview]
54
+ */
55
+
56
+ /**
57
+ * @param {object} input
58
+ * @param {string} input.language
59
+ * @param {Record<string,string>} input.files
60
+ * @param {string|null} [input.entry]
61
+ * @param {AbortSignal} [input.signal]
62
+ * @param {(chunk:{stream:'stdout'|'stderr',text:string})=>void} [input.onOutput]
63
+ * @param {number} [input.timeoutMs]
64
+ * @param {number} [input.maxOutputBytes]
65
+ * @returns {Promise<RunResult>}
66
+ */
67
+ export async function runBrowser({
68
+ language,
69
+ files = {},
70
+ entry = null,
71
+ signal,
72
+ onOutput,
73
+ timeoutMs = DEFAULT_TIMEOUT_MS,
74
+ maxOutputBytes = MAX_OUTPUT_BYTES,
75
+ } = {}) {
76
+ if (language === 'html' || language === 'css') {
77
+ return { stdout: '', stderr: '', exitCode: 0, checks: [], durationMs: 0, runner: 'browser', preview: { html: buildPreviewDocument(files, entry) } };
78
+ }
79
+ const worker = createWorker(language);
80
+ if (!worker) throw new RunnerError('unavailable', `No browser runner for "${language}"`);
81
+ return runWorker(worker, { type: 'run', language, files, entry: entry || defaultEntry(language) }, {
82
+ signal,
83
+ onOutput,
84
+ timeoutMs,
85
+ maxOutputBytes,
86
+ });
87
+ }
88
+
89
+ /**
90
+ * @param {Worker} worker
91
+ * @param {object} payload
92
+ * @param {{ signal?: AbortSignal, onOutput?: Function, timeoutMs: number, maxOutputBytes: number }} opts
93
+ * @returns {Promise<RunResult>}
94
+ */
95
+ function runWorker(worker, payload, { signal, onOutput, timeoutMs, maxOutputBytes }) {
96
+ return new Promise((resolve) => {
97
+ const started = Date.now();
98
+ let stdout = '';
99
+ let stderr = '';
100
+ let checks = [];
101
+ let rows = null;
102
+ let settled = false;
103
+ let truncated = false;
104
+ let statusText = '';
105
+
106
+ const result = (extra = {}) => ({
107
+ stdout,
108
+ stderr,
109
+ exitCode: null,
110
+ checks,
111
+ durationMs: Date.now() - started,
112
+ runner: 'browser',
113
+ outputTruncated: truncated || undefined,
114
+ ...(rows ? { rows } : {}),
115
+ ...extra,
116
+ });
117
+
118
+ const cleanup = () => {
119
+ clearTimeout(timer);
120
+ signal?.removeEventListener?.('abort', onAbort);
121
+ try {
122
+ worker.terminate();
123
+ } catch {
124
+ /* already gone */
125
+ }
126
+ };
127
+ const settle = (value) => {
128
+ if (settled) return;
129
+ settled = true;
130
+ cleanup();
131
+ resolve(value);
132
+ };
133
+
134
+ const append = (stream, text) => {
135
+ const chunk = String(text ?? '');
136
+ const current = stream === 'stdout' ? stdout : stderr;
137
+ if (current.length + chunk.length > maxOutputBytes) {
138
+ truncated = true;
139
+ const room = Math.max(0, maxOutputBytes - current.length);
140
+ const clipped = room > 0 ? chunk.slice(0, room) : '';
141
+ if (stream === 'stdout') stdout = current + clipped + '\n… (output truncated)';
142
+ else stderr = current + clipped + '\n… (output truncated)';
143
+ } else if (stream === 'stdout') stdout = current + chunk;
144
+ else stderr = current + chunk;
145
+ onOutput?.({ stream, text: truncated && chunk ? '' : chunk });
146
+ };
147
+
148
+ const timer = setTimeout(() => {
149
+ settle(result({ exitCode: 124, timedOut: true, stderr: `${stderr}${stderr ? '\n' : ''}Timed out after ${Math.round(timeoutMs / 1000)}s — the process was stopped.` }));
150
+ }, timeoutMs);
151
+
152
+ const onAbort = () => settle(result({ aborted: true, exitCode: null }));
153
+ if (signal) {
154
+ if (signal.aborted) {
155
+ settle(result({ aborted: true, exitCode: null }));
156
+ return;
157
+ }
158
+ signal.addEventListener('abort', onAbort, { once: true });
159
+ }
160
+
161
+ worker.onmessage = (event) => {
162
+ const msg = event.data || {};
163
+ switch (msg.type) {
164
+ case 'stdout':
165
+ append('stdout', msg.text);
166
+ break;
167
+ case 'stderr':
168
+ append('stderr', msg.text);
169
+ break;
170
+ case 'status':
171
+ statusText = String(msg.text || '');
172
+ onOutput?.({ stream: 'status', text: statusText });
173
+ break;
174
+ case 'checks':
175
+ checks = Array.isArray(msg.checks) ? msg.checks : [];
176
+ break;
177
+ case 'rows':
178
+ rows = { columns: msg.columns || [], rows: msg.rows || [] };
179
+ break;
180
+ case 'done':
181
+ settle(result({ exitCode: typeof msg.exitCode === 'number' ? msg.exitCode : 0 }));
182
+ break;
183
+ case 'error':
184
+ append('stderr', `${msg.message || 'Runner error'}\n`);
185
+ settle(result({ exitCode: 1 }));
186
+ break;
187
+ default:
188
+ break;
189
+ }
190
+ };
191
+ worker.onerror = (event) => {
192
+ append('stderr', `${event?.message || 'The runner crashed.'}\n`);
193
+ settle(result({ exitCode: 1 }));
194
+ };
195
+
196
+ try {
197
+ worker.postMessage(payload);
198
+ } catch (err) {
199
+ append('stderr', `${err?.message || err}\n`);
200
+ settle(result({ exitCode: 1 }));
201
+ }
202
+ });
203
+ }
204
+
205
+ /**
206
+ * Build a self-contained HTML document from the workspace files, inlining local `<link>`/`<script>`
207
+ * references so a sandboxed iframe (`allow-scripts`, no same-origin) can render it.
208
+ * @param {Record<string,string>} files
209
+ * @param {string|null} entry
210
+ * @returns {string}
211
+ */
212
+ export function buildPreviewDocument(files = {}, entry = null) {
213
+ const entryPath = String(entry || Object.keys(files).find((p) => languageForPath(p) === 'html') || 'index.html');
214
+ let html = files[entryPath];
215
+ if (html === undefined) return '<!doctype html><meta charset="utf-8"><body>No HTML file to preview.</body>';
216
+
217
+ html = html.replace(/<link\b[^>]*href=["']([^"']+)["'][^>]*>/gi, (tag, href) => {
218
+ const target = resolveRef(entryPath, href, files);
219
+ if (target === null) return tag;
220
+ return `<style>\n${files[target]}\n</style>`;
221
+ });
222
+ html = html.replace(/<script\b[^>]*src=["']([^"']+)["'][^>]*>\s*<\/script>/gi, (tag, src) => {
223
+ const target = resolveRef(entryPath, src, files);
224
+ if (target === null) return tag;
225
+ return `<script>\n${files[target]}\n</script>`;
226
+ });
227
+ return html;
228
+ }
229
+
230
+ /** @param {string} entryPath @param {string} ref @param {Record<string,string>} files */
231
+ function resolveRef(entryPath, ref, files) {
232
+ if (/^(https?:)?\/\//.test(ref) || ref.startsWith('data:')) return null;
233
+ const base = entryPath.split('/').slice(0, -1);
234
+ const parts = [...base];
235
+ for (const seg of ref.split('/')) {
236
+ if (seg === '' || seg === '.') continue;
237
+ if (seg === '..') parts.pop();
238
+ else parts.push(seg);
239
+ }
240
+ const joined = parts.join('/');
241
+ return Object.prototype.hasOwnProperty.call(files, joined) ? joined : null;
242
+ }
243
+
244
+ export { RunnerError };