ronin-skillforce 0.0.0-stage → 0.2.0-beta.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 (434) hide show
  1. package/CHANGELOG.md +74 -0
  2. package/LICENSE +202 -0
  3. package/NOTICE +19 -0
  4. package/README.md +258 -2
  5. package/bin/cli.js +823 -0
  6. package/bin/commands/archive.js +192 -0
  7. package/bin/commands/capstone-status.js +82 -0
  8. package/bin/commands/check.js +298 -0
  9. package/bin/commands/create.js +226 -0
  10. package/bin/commands/doctor.js +392 -0
  11. package/bin/commands/import.js +557 -0
  12. package/bin/commands/next.js +125 -0
  13. package/bin/commands/review.js +207 -0
  14. package/bin/commands/status.js +114 -0
  15. package/bin/commands/studio-autostart.js +414 -0
  16. package/bin/commands/studio-state.js +159 -0
  17. package/bin/commands/studio.js +831 -0
  18. package/bin/commands/trail.js +361 -0
  19. package/bin/commands/web.js +348 -0
  20. package/bin/course-reader.js +602 -0
  21. package/bin/node-version.js +60 -0
  22. package/bin/platforms/_shared.js +337 -0
  23. package/bin/platforms/claude.js +85 -0
  24. package/bin/platforms/cursor.js +52 -0
  25. package/bin/platforms/gemini.js +64 -0
  26. package/bin/platforms/opencode.js +114 -0
  27. package/bin/registry-helpers.js +504 -0
  28. package/bin/static-server.js +153 -0
  29. package/bin/studio-store.js +94 -0
  30. package/bin/sync-shared.sh +5 -0
  31. package/package.json +92 -4
  32. package/plugin.json +139 -0
  33. package/shared/SKILL.md +598 -0
  34. package/shared/agents/coach.md +228 -0
  35. package/shared/agents/navigator.md +208 -0
  36. package/shared/agents/professor.md +354 -0
  37. package/shared/agents/researcher.md +181 -0
  38. package/shared/agents/spotter.md +128 -0
  39. package/shared/commands/professor/archive.md +96 -0
  40. package/shared/commands/professor/capstone-review.md +79 -0
  41. package/shared/commands/professor/capstone.md +34 -0
  42. package/shared/commands/professor/discuss.md +18 -0
  43. package/shared/commands/professor/done.md +72 -0
  44. package/shared/commands/professor/export.md +69 -0
  45. package/shared/commands/professor/hint.md +120 -0
  46. package/shared/commands/professor/navigator.md +93 -0
  47. package/shared/commands/professor/new-topic.md +73 -0
  48. package/shared/commands/professor/next.md +178 -0
  49. package/shared/commands/professor/note.md +63 -0
  50. package/shared/commands/professor/onboard.md +95 -0
  51. package/shared/commands/professor/progress.md +46 -0
  52. package/shared/commands/professor/publish.md +93 -0
  53. package/shared/commands/professor/quiz.md +27 -0
  54. package/shared/commands/professor/recall.md +74 -0
  55. package/shared/commands/professor/review.md +57 -0
  56. package/shared/commands/professor/schedule.md +75 -0
  57. package/shared/commands/professor/skill-export.md +86 -0
  58. package/shared/commands/professor/spotter.md +93 -0
  59. package/shared/commands/professor/stuck.md +51 -0
  60. package/shared/commands/professor/switch.md +50 -0
  61. package/shared/commands/professor/syllabus.md +9 -0
  62. package/shared/commands/professor/template-export.md +91 -0
  63. package/shared/commands/professor/template-import.md +111 -0
  64. package/shared/commands/professor/worktrees.md +54 -0
  65. package/shared/hooks/pre-compact.js +221 -0
  66. package/studio/README.md +313 -0
  67. package/studio/dist/assets/BetaReportPanel-BJ9HIAnz.js +1 -0
  68. package/studio/dist/assets/Capstone-CoUU-jP7.js +6 -0
  69. package/studio/dist/assets/CodeWorkspace-BNrL4qvR.js +2 -0
  70. package/studio/dist/assets/Course-BMGTXus_.js +1 -0
  71. package/studio/dist/assets/Editor-Cw9j3cnp.js +53 -0
  72. package/studio/dist/assets/Home-D2woITq5.js +1 -0
  73. package/studio/dist/assets/KaTeX_AMS-Regular-BQhdFMY1.woff2 +0 -0
  74. package/studio/dist/assets/KaTeX_AMS-Regular-DMm9YOAa.woff +0 -0
  75. package/studio/dist/assets/KaTeX_AMS-Regular-DRggAlZN.ttf +0 -0
  76. package/studio/dist/assets/KaTeX_Caligraphic-Bold-ATXxdsX0.ttf +0 -0
  77. package/studio/dist/assets/KaTeX_Caligraphic-Bold-BEiXGLvX.woff +0 -0
  78. package/studio/dist/assets/KaTeX_Caligraphic-Bold-Dq_IR9rO.woff2 +0 -0
  79. package/studio/dist/assets/KaTeX_Caligraphic-Regular-CTRA-rTL.woff +0 -0
  80. package/studio/dist/assets/KaTeX_Caligraphic-Regular-Di6jR-x-.woff2 +0 -0
  81. package/studio/dist/assets/KaTeX_Caligraphic-Regular-wX97UBjC.ttf +0 -0
  82. package/studio/dist/assets/KaTeX_Fraktur-Bold-BdnERNNW.ttf +0 -0
  83. package/studio/dist/assets/KaTeX_Fraktur-Bold-BsDP51OF.woff +0 -0
  84. package/studio/dist/assets/KaTeX_Fraktur-Bold-CL6g_b3V.woff2 +0 -0
  85. package/studio/dist/assets/KaTeX_Fraktur-Regular-CB_wures.ttf +0 -0
  86. package/studio/dist/assets/KaTeX_Fraktur-Regular-CTYiF6lA.woff2 +0 -0
  87. package/studio/dist/assets/KaTeX_Fraktur-Regular-Dxdc4cR9.woff +0 -0
  88. package/studio/dist/assets/KaTeX_Main-Bold-Cx986IdX.woff2 +0 -0
  89. package/studio/dist/assets/KaTeX_Main-Bold-Jm3AIy58.woff +0 -0
  90. package/studio/dist/assets/KaTeX_Main-Bold-waoOVXN0.ttf +0 -0
  91. package/studio/dist/assets/KaTeX_Main-BoldItalic-DxDJ3AOS.woff2 +0 -0
  92. package/studio/dist/assets/KaTeX_Main-BoldItalic-DzxPMmG6.ttf +0 -0
  93. package/studio/dist/assets/KaTeX_Main-BoldItalic-SpSLRI95.woff +0 -0
  94. package/studio/dist/assets/KaTeX_Main-Italic-3WenGoN9.ttf +0 -0
  95. package/studio/dist/assets/KaTeX_Main-Italic-BMLOBm91.woff +0 -0
  96. package/studio/dist/assets/KaTeX_Main-Italic-NWA7e6Wa.woff2 +0 -0
  97. package/studio/dist/assets/KaTeX_Main-Regular-B22Nviop.woff2 +0 -0
  98. package/studio/dist/assets/KaTeX_Main-Regular-Dr94JaBh.woff +0 -0
  99. package/studio/dist/assets/KaTeX_Main-Regular-ypZvNtVU.ttf +0 -0
  100. package/studio/dist/assets/KaTeX_Math-BoldItalic-B3XSjfu4.ttf +0 -0
  101. package/studio/dist/assets/KaTeX_Math-BoldItalic-CZnvNsCZ.woff2 +0 -0
  102. package/studio/dist/assets/KaTeX_Math-BoldItalic-iY-2wyZ7.woff +0 -0
  103. package/studio/dist/assets/KaTeX_Math-Italic-DA0__PXp.woff +0 -0
  104. package/studio/dist/assets/KaTeX_Math-Italic-flOr_0UB.ttf +0 -0
  105. package/studio/dist/assets/KaTeX_Math-Italic-t53AETM-.woff2 +0 -0
  106. package/studio/dist/assets/KaTeX_SansSerif-Bold-CFMepnvq.ttf +0 -0
  107. package/studio/dist/assets/KaTeX_SansSerif-Bold-D1sUS0GD.woff2 +0 -0
  108. package/studio/dist/assets/KaTeX_SansSerif-Bold-DbIhKOiC.woff +0 -0
  109. package/studio/dist/assets/KaTeX_SansSerif-Italic-C3H0VqGB.woff2 +0 -0
  110. package/studio/dist/assets/KaTeX_SansSerif-Italic-DN2j7dab.woff +0 -0
  111. package/studio/dist/assets/KaTeX_SansSerif-Italic-YYjJ1zSn.ttf +0 -0
  112. package/studio/dist/assets/KaTeX_SansSerif-Regular-BNo7hRIc.ttf +0 -0
  113. package/studio/dist/assets/KaTeX_SansSerif-Regular-CS6fqUqJ.woff +0 -0
  114. package/studio/dist/assets/KaTeX_SansSerif-Regular-DDBCnlJ7.woff2 +0 -0
  115. package/studio/dist/assets/KaTeX_Script-Regular-C5JkGWo-.ttf +0 -0
  116. package/studio/dist/assets/KaTeX_Script-Regular-D3wIWfF6.woff2 +0 -0
  117. package/studio/dist/assets/KaTeX_Script-Regular-D5yQViql.woff +0 -0
  118. package/studio/dist/assets/KaTeX_Size1-Regular-C195tn64.woff +0 -0
  119. package/studio/dist/assets/KaTeX_Size1-Regular-Dbsnue_I.ttf +0 -0
  120. package/studio/dist/assets/KaTeX_Size1-Regular-mCD8mA8B.woff2 +0 -0
  121. package/studio/dist/assets/KaTeX_Size2-Regular-B7gKUWhC.ttf +0 -0
  122. package/studio/dist/assets/KaTeX_Size2-Regular-Dy4dx90m.woff2 +0 -0
  123. package/studio/dist/assets/KaTeX_Size2-Regular-oD1tc_U0.woff +0 -0
  124. package/studio/dist/assets/KaTeX_Size3-Regular-CTq5MqoE.woff +0 -0
  125. package/studio/dist/assets/KaTeX_Size3-Regular-DgpXs0kz.ttf +0 -0
  126. package/studio/dist/assets/KaTeX_Size4-Regular-BF-4gkZK.woff +0 -0
  127. package/studio/dist/assets/KaTeX_Size4-Regular-DWFBv043.ttf +0 -0
  128. package/studio/dist/assets/KaTeX_Size4-Regular-Dl5lxZxV.woff2 +0 -0
  129. package/studio/dist/assets/KaTeX_Typewriter-Regular-C0xS9mPB.woff +0 -0
  130. package/studio/dist/assets/KaTeX_Typewriter-Regular-CO6r4hn1.woff2 +0 -0
  131. package/studio/dist/assets/KaTeX_Typewriter-Regular-D3Ib7_Hf.ttf +0 -0
  132. package/studio/dist/assets/Lesson-CYQhrDCZ.js +2 -0
  133. package/studio/dist/assets/NewCourse-CMpwVRQb.js +952 -0
  134. package/studio/dist/assets/Progress-2rS19Fur.js +1 -0
  135. package/studio/dist/assets/Review-SlqK-hjp.js +1 -0
  136. package/studio/dist/assets/Settings-t42u7n9H.js +1 -0
  137. package/studio/dist/assets/TutorPanel-DQDWIU7f.js +123 -0
  138. package/studio/dist/assets/abnfDiagram-WEYOIA3C-jTUmGBuB.js +1 -0
  139. package/studio/dist/assets/anthropic-iIm2l85r.js +15 -0
  140. package/studio/dist/assets/arc-Y1ARJVZ4.js +1 -0
  141. package/studio/dist/assets/architecture-WOLXFQ4H-Ch9Ld_vv.js +1 -0
  142. package/studio/dist/assets/architectureDiagram-ZHVYKT53-Dy-z6wsy.js +36 -0
  143. package/studio/dist/assets/array-BifhSqXX.js +1 -0
  144. package/studio/dist/assets/blockDiagram-RJAE7QA3-2fHVrc6N.js +140 -0
  145. package/studio/dist/assets/bridge-Cr0q4rLp.js +1 -0
  146. package/studio/dist/assets/c4Diagram-XDPPPE54-BuuKlG4V.js +38 -0
  147. package/studio/dist/assets/capstone-DhwBeNqk.js +135 -0
  148. package/studio/dist/assets/card-store-CVMBc-Pv.js +1 -0
  149. package/studio/dist/assets/channel-M_JkdHrL.js +1 -0
  150. package/studio/dist/assets/chunk-2E7WHVMD-lZdQWttk.js +88 -0
  151. package/studio/dist/assets/chunk-2Q5K7J3B-C1jixKkw.js +1 -0
  152. package/studio/dist/assets/chunk-4EMNKR2T-C6kbMwke.js +1 -0
  153. package/studio/dist/assets/chunk-55XCU76K-rkBzkZog.js +1 -0
  154. package/studio/dist/assets/chunk-5VM5RSS4-ZNzvKenW.js +15 -0
  155. package/studio/dist/assets/chunk-7S6XSTFO-Skg347QF.js +2 -0
  156. package/studio/dist/assets/chunk-AQDTSKZB-0pSDBJ23.js +72 -0
  157. package/studio/dist/assets/chunk-DSNLSHJZ-BaeQDl2i.js +129 -0
  158. package/studio/dist/assets/chunk-DUW6YSOI-Dgx8z5s3.js +1 -0
  159. package/studio/dist/assets/chunk-HAGFOTED-BEm00juw.js +62 -0
  160. package/studio/dist/assets/chunk-HNE4Q36P-DyCR-LvS.js +1 -0
  161. package/studio/dist/assets/chunk-J5ZVWO5B-oDCd-gWO.js +1 -0
  162. package/studio/dist/assets/chunk-JWPE2WC7-DVXcaiue.js +1 -0
  163. package/studio/dist/assets/chunk-NGNAAXSQ-C2Wy9Xmz.js +136 -0
  164. package/studio/dist/assets/chunk-NQOKRVIF-BNJ9uMmB.js +213 -0
  165. package/studio/dist/assets/chunk-UHW7PFBP-DqJczBLs.js +1 -0
  166. package/studio/dist/assets/chunk-VQ5W62QI-CVWYSP5Q.js +1 -0
  167. package/studio/dist/assets/chunk-WQQL4CDK-DJf0Dx05.js +10 -0
  168. package/studio/dist/assets/chunk-XXDRQBXY-CnbRkih_.js +1 -0
  169. package/studio/dist/assets/chunk-Y2CYZVJY-DsF7k-Jl.js +1 -0
  170. package/studio/dist/assets/chunk-YZO67HFG-BFUm_JHA.js +1 -0
  171. package/studio/dist/assets/chunk-ZAUX2LTX-C5ETkkSE.js +1 -0
  172. package/studio/dist/assets/chunk-ZCHMQSOR-WVX9r9PZ.js +2 -0
  173. package/studio/dist/assets/classDiagram-v2-4MYWR3UA-CI77SpuR.js +217 -0
  174. package/studio/dist/assets/cose-bilkent-JH36ORCC-DMBAZFnj.js +1 -0
  175. package/studio/dist/assets/course-export-C8jSPuda.js +1 -0
  176. package/studio/dist/assets/cynefin-EF2NZ3EQ-CLffmM25.js +1 -0
  177. package/studio/dist/assets/cynefinDiagram-WF24UDRP-BvLwocOb.js +62 -0
  178. package/studio/dist/assets/cytoscape.esm-CHBj4VkZ.js +321 -0
  179. package/studio/dist/assets/dagre-NK4GIZVX-C2nMAVdh.js +4 -0
  180. package/studio/dist/assets/defaultLocale-BFoDCU3G.js +1 -0
  181. package/studio/dist/assets/diagram-CBK3MWTC-Bid-pdax.js +24 -0
  182. package/studio/dist/assets/diagram-I5XIIV2D-DYJeAvzl.js +24 -0
  183. package/studio/dist/assets/diagram-ODIL2UCW-B06X2r_F.js +30 -0
  184. package/studio/dist/assets/diagram-PFBEJUXE-CwY--5Rz.js +3 -0
  185. package/studio/dist/assets/diagram-RJA3I4VV-4SqhH8zw.js +41 -0
  186. package/studio/dist/assets/diagram-TYUNFSNR-CrW4AIM9.js +200 -0
  187. package/studio/dist/assets/dist-CumnGVmJ.js +1 -0
  188. package/studio/dist/assets/ebnfDiagram-V4P3TTPT-xeoCmH-d.js +1 -0
  189. package/studio/dist/assets/elk-QONTBCTQ-Dadmz6iS.js +27 -0
  190. package/studio/dist/assets/erDiagram-KYQIGQAA-CSuH0bbF.js +99 -0
  191. package/studio/dist/assets/error-BTdmRKoB.js +1 -0
  192. package/studio/dist/assets/errors-BZa_CNHL.js +1 -0
  193. package/studio/dist/assets/eventmodeling-K75KTNOO-CciVfx3I.js +1 -0
  194. package/studio/dist/assets/fetch-local-DG3O3hmQ.js +4 -0
  195. package/studio/dist/assets/flowDiagram-IUGLLWBU-DgNR54qK.js +1 -0
  196. package/studio/dist/assets/ganttDiagram-R7GPNTJY-C0wtA-2y.js +292 -0
  197. package/studio/dist/assets/gitGraph-VSP46ZUC-BXoDzaA3.js +1 -0
  198. package/studio/dist/assets/gitGraphDiagram-PDYL7XHY-vZBlNRPe.js +106 -0
  199. package/studio/dist/assets/graphlib-DS17s2tU.js +1 -0
  200. package/studio/dist/assets/index-CS8XPYbB.js +313 -0
  201. package/studio/dist/assets/index-CVenTTOY.css +2 -0
  202. package/studio/dist/assets/info-OHQRW6UA-bs2Qpf7P.js +1 -0
  203. package/studio/dist/assets/infoDiagram-MVDRKAX5-rPJio6-1.js +2 -0
  204. package/studio/dist/assets/init-C-OQMol4.js +1 -0
  205. package/studio/dist/assets/ishikawaDiagram-HPEHV2GE-CXf9XFff.js +70 -0
  206. package/studio/dist/assets/journeyDiagram-BOSHW7O7-C3MSH79o.js +139 -0
  207. package/studio/dist/assets/js.worker-AD7DjksO.js +4 -0
  208. package/studio/dist/assets/kanban-definition-FNSA4HC5-Bdh7SB4n.js +89 -0
  209. package/studio/dist/assets/katex-B_JcIwqj.js +257 -0
  210. package/studio/dist/assets/katex-BgsA2lO1.css +1 -0
  211. package/studio/dist/assets/line-CHkoQXJF.js +1 -0
  212. package/studio/dist/assets/linear-C9iwaMOi.js +1 -0
  213. package/studio/dist/assets/mermaid-parser.core-Do1oxD1S.js +7 -0
  214. package/studio/dist/assets/mermaid.core-DgZUD0sU.js +44 -0
  215. package/studio/dist/assets/mindmap-definition-6OY57UG3-PUaK6oE_.js +98 -0
  216. package/studio/dist/assets/node.browser-DkpMze_r.js +1 -0
  217. package/studio/dist/assets/node.browser-HQ5SKBOf.js +1 -0
  218. package/studio/dist/assets/ollama-bJNp3jaD.js +1 -0
  219. package/studio/dist/assets/openai-compatible-0tmAyMlN.js +1 -0
  220. package/studio/dist/assets/ordinal-BDEzSJ7C.js +1 -0
  221. package/studio/dist/assets/packet-JDAUHWVQ-vf2FtqFr.js +1 -0
  222. package/studio/dist/assets/path-fybaL0A-.js +1 -0
  223. package/studio/dist/assets/pegDiagram-ECIUJNBX-NEVrgPTY.js +1 -0
  224. package/studio/dist/assets/pie-XZMESJXO-BIWydVNZ.js +1 -0
  225. package/studio/dist/assets/pieDiagram-GNMPY74T-BI9_u6rT.js +39 -0
  226. package/studio/dist/assets/python.worker-CzTrFdd9.js +24 -0
  227. package/studio/dist/assets/quadrantDiagram-D57K4MC3-ryNpoBC5.js +7 -0
  228. package/studio/dist/assets/radar-ABXABTNO-D8TjnvBB.js +1 -0
  229. package/studio/dist/assets/railroad-I3PHUGI6-BmEDV5kf.js +1 -0
  230. package/studio/dist/assets/railroad-abnf-LNEFI6M7-Cs_sArMc.js +1 -0
  231. package/studio/dist/assets/railroad-ebnf-DWYD2UWJ-DYuCq46d.js +1 -0
  232. package/studio/dist/assets/railroad-peg-JR7BVNR7-BcXSgdMy.js +1 -0
  233. package/studio/dist/assets/railroadDiagram-Y72NRBL7-DBcc8b2c.js +1 -0
  234. package/studio/dist/assets/react-B8SKf8RM.js +1 -0
  235. package/studio/dist/assets/rehype-katex-BfUIq5As.js +259 -0
  236. package/studio/dist/assets/remark-math-XvZOjmDO.js +5 -0
  237. package/studio/dist/assets/requirementDiagram-EQYSW5RA-CVcBgM1L.js +84 -0
  238. package/studio/dist/assets/rolldown-runtime-COiEfhsA.js +1 -0
  239. package/studio/dist/assets/rough.esm-Dy-Kn_BL.js +1 -0
  240. package/studio/dist/assets/sankeyDiagram-SY24JHO5-DjZ81hDs.js +40 -0
  241. package/studio/dist/assets/schemas-BOc2YsOP.js +55 -0
  242. package/studio/dist/assets/sequenceDiagram-BLEHNHQU-BNwOa2S7.js +169 -0
  243. package/studio/dist/assets/settings-DhwuyNPU.js +1 -0
  244. package/studio/dist/assets/sizeCapture-INFHLROL-3uHXrFqA.js +1 -0
  245. package/studio/dist/assets/spec-nAnsSMkw.js +1 -0
  246. package/studio/dist/assets/sql-wasm-C1D_RJuy.wasm +0 -0
  247. package/studio/dist/assets/sql.worker-D7pBHOrq.js +4 -0
  248. package/studio/dist/assets/src-BWF7jMDv.js +1 -0
  249. package/studio/dist/assets/stateDiagram-v2-A6IESKWZ-BFWa5lEx.js +291 -0
  250. package/studio/dist/assets/swimlanes-B3ENRKFQ-LfM_Jg6Z.js +1 -0
  251. package/studio/dist/assets/swimlanesDiagram-AYQRV4AK-BDmpoiGp.js +8 -0
  252. package/studio/dist/assets/timeline-definition-JXYKGLGB-BwGzkWgZ.js +120 -0
  253. package/studio/dist/assets/treeView-D4JQ5SDB-MLk3VuRt.js +1 -0
  254. package/studio/dist/assets/treemap-SAJKECNS-D8iSjp7L.js +1 -0
  255. package/studio/dist/assets/useStream-rdsR6A7P.js +1 -0
  256. package/studio/dist/assets/usecaseDiagram-WPOLBNNX-BqxpaNlT.js +328 -0
  257. package/studio/dist/assets/vennDiagram-Q3Y3IDCW-CpeUDMhQ.js +34 -0
  258. package/studio/dist/assets/wardley-7MLQ67FV-tAMbCZAj.js +1 -0
  259. package/studio/dist/assets/wardleyDiagram-IVAIDKWA-CDJViWzt.js +78 -0
  260. package/studio/dist/assets/xychartDiagram-4URNHDU4-CwaQrd3_.js +7 -0
  261. package/studio/dist/index.html +20 -0
  262. package/studio/dist/preview.html +22 -0
  263. package/studio/migrations/0001_init.sql +188 -0
  264. package/studio/migrations/0002_external_ids.sql +20 -0
  265. package/studio/migrations/0003_course_language.sql +12 -0
  266. package/studio/migrations/0004_capstone.sql +51 -0
  267. package/studio/migrations/0005_beta_loop.sql +73 -0
  268. package/studio/migrations/0006_interactive_exercises.sql +49 -0
  269. package/studio/src/lib/activity.js +92 -0
  270. package/studio/src/lib/ai/anthropic.js +109 -0
  271. package/studio/src/lib/ai/bridge.js +126 -0
  272. package/studio/src/lib/ai/catalog.js +160 -0
  273. package/studio/src/lib/ai/config.js +70 -0
  274. package/studio/src/lib/ai/errors.js +95 -0
  275. package/studio/src/lib/ai/fetch-local.js +104 -0
  276. package/studio/src/lib/ai/index.js +194 -0
  277. package/studio/src/lib/ai/ollama.js +136 -0
  278. package/studio/src/lib/ai/openai-compatible.js +101 -0
  279. package/studio/src/lib/ai/provider-utils.js +107 -0
  280. package/studio/src/lib/ai/sse.js +99 -0
  281. package/studio/src/lib/ai/status.js +92 -0
  282. package/studio/src/lib/ai/useStream.js +109 -0
  283. package/studio/src/lib/beta/metrics.js +147 -0
  284. package/studio/src/lib/beta/report.js +134 -0
  285. package/studio/src/lib/capstone-evidence.js +758 -0
  286. package/studio/src/lib/capstone.js +663 -0
  287. package/studio/src/lib/chat-store.js +128 -0
  288. package/studio/src/lib/course-export.js +38 -0
  289. package/studio/src/lib/course.js +187 -0
  290. package/studio/src/lib/exercises/journal-entry.js +259 -0
  291. package/studio/src/lib/exercises/placement.js +31 -0
  292. package/studio/src/lib/exercises/registry.js +19 -0
  293. package/studio/src/lib/exercises/spec.js +129 -0
  294. package/studio/src/lib/i18n/detect.js +162 -0
  295. package/studio/src/lib/i18n/en/app.json +23 -0
  296. package/studio/src/lib/i18n/en/betaReport.json +55 -0
  297. package/studio/src/lib/i18n/en/capstone.json +57 -0
  298. package/studio/src/lib/i18n/en/common.json +25 -0
  299. package/studio/src/lib/i18n/en/course.json +27 -0
  300. package/studio/src/lib/i18n/en/data.json +35 -0
  301. package/studio/src/lib/i18n/en/durability.json +5 -0
  302. package/studio/src/lib/i18n/en/errors.json +20 -0
  303. package/studio/src/lib/i18n/en/exercises.json +55 -0
  304. package/studio/src/lib/i18n/en/externalEvidence.json +76 -0
  305. package/studio/src/lib/i18n/en/home.json +18 -0
  306. package/studio/src/lib/i18n/en/lesson.json +33 -0
  307. package/studio/src/lib/i18n/en/nav.json +8 -0
  308. package/studio/src/lib/i18n/en/newCourse.json +51 -0
  309. package/studio/src/lib/i18n/en/onboarding.json +35 -0
  310. package/studio/src/lib/i18n/en/playwrightTemplate.json +20 -0
  311. package/studio/src/lib/i18n/en/practice.json +79 -0
  312. package/studio/src/lib/i18n/en/provider.json +27 -0
  313. package/studio/src/lib/i18n/en/providerMeta.json +26 -0
  314. package/studio/src/lib/i18n/en/reflection.json +17 -0
  315. package/studio/src/lib/i18n/en/revision.json +52 -0
  316. package/studio/src/lib/i18n/en/runnerNotice.json +14 -0
  317. package/studio/src/lib/i18n/en/settings.json +12 -0
  318. package/studio/src/lib/i18n/en/storage.json +49 -0
  319. package/studio/src/lib/i18n/en/tutor.json +39 -0
  320. package/studio/src/lib/i18n/en/workspace.json +50 -0
  321. package/studio/src/lib/i18n/index.js +144 -0
  322. package/studio/src/lib/i18n/languages.js +93 -0
  323. package/studio/src/lib/i18n/vi/app.json +23 -0
  324. package/studio/src/lib/i18n/vi/betaReport.json +55 -0
  325. package/studio/src/lib/i18n/vi/capstone.json +57 -0
  326. package/studio/src/lib/i18n/vi/common.json +25 -0
  327. package/studio/src/lib/i18n/vi/course.json +27 -0
  328. package/studio/src/lib/i18n/vi/data.json +35 -0
  329. package/studio/src/lib/i18n/vi/durability.json +5 -0
  330. package/studio/src/lib/i18n/vi/errors.json +20 -0
  331. package/studio/src/lib/i18n/vi/exercises.json +55 -0
  332. package/studio/src/lib/i18n/vi/externalEvidence.json +76 -0
  333. package/studio/src/lib/i18n/vi/home.json +18 -0
  334. package/studio/src/lib/i18n/vi/lesson.json +33 -0
  335. package/studio/src/lib/i18n/vi/nav.json +8 -0
  336. package/studio/src/lib/i18n/vi/newCourse.json +51 -0
  337. package/studio/src/lib/i18n/vi/onboarding.json +35 -0
  338. package/studio/src/lib/i18n/vi/playwrightTemplate.json +20 -0
  339. package/studio/src/lib/i18n/vi/practice.json +79 -0
  340. package/studio/src/lib/i18n/vi/provider.json +27 -0
  341. package/studio/src/lib/i18n/vi/providerMeta.json +26 -0
  342. package/studio/src/lib/i18n/vi/reflection.json +17 -0
  343. package/studio/src/lib/i18n/vi/revision.json +52 -0
  344. package/studio/src/lib/i18n/vi/runnerNotice.json +14 -0
  345. package/studio/src/lib/i18n/vi/settings.json +12 -0
  346. package/studio/src/lib/i18n/vi/storage.json +49 -0
  347. package/studio/src/lib/i18n/vi/tutor.json +39 -0
  348. package/studio/src/lib/i18n/vi/workspace.json +50 -0
  349. package/studio/src/lib/ids.js +10 -0
  350. package/studio/src/lib/json.js +26 -0
  351. package/studio/src/lib/markdown.js +74 -0
  352. package/studio/src/lib/prompts/base.js +139 -0
  353. package/studio/src/lib/prompts/capstone.js +777 -0
  354. package/studio/src/lib/prompts/course.js +150 -0
  355. package/studio/src/lib/prompts/lesson.js +275 -0
  356. package/studio/src/lib/prompts/practice.js +511 -0
  357. package/studio/src/lib/prompts/tutor.js +509 -0
  358. package/studio/src/lib/repo/blocked-adapter.js +69 -0
  359. package/studio/src/lib/repo/events.js +239 -0
  360. package/studio/src/lib/repo/idb-adapter.js +226 -0
  361. package/studio/src/lib/repo/index.js +1315 -0
  362. package/studio/src/lib/repo/memory-adapter.js +115 -0
  363. package/studio/src/lib/repo/remote-adapter.js +158 -0
  364. package/studio/src/lib/repo/schema.js +143 -0
  365. package/studio/src/lib/repo/select-adapter.js +345 -0
  366. package/studio/src/lib/router.js +71 -0
  367. package/studio/src/lib/runner/browser.js +244 -0
  368. package/studio/src/lib/runner/checks.js +248 -0
  369. package/studio/src/lib/runner/current-code.js +98 -0
  370. package/studio/src/lib/runner/esm-cjs.js +109 -0
  371. package/studio/src/lib/runner/hash.js +34 -0
  372. package/studio/src/lib/runner/history.js +48 -0
  373. package/studio/src/lib/runner/index.js +168 -0
  374. package/studio/src/lib/runner/languages.js +258 -0
  375. package/studio/src/lib/runner/local.js +139 -0
  376. package/studio/src/lib/runner/path.js +104 -0
  377. package/studio/src/lib/runner/skeleton.js +315 -0
  378. package/studio/src/lib/runner/strip-types.js +134 -0
  379. package/studio/src/lib/settings.js +399 -0
  380. package/studio/src/lib/srs.js +39 -0
  381. package/templates/agent/settings.json +6 -0
  382. package/templates/claude/plugin.json +139 -0
  383. package/templates/claude/settings.json +15 -0
  384. package/templates/cursor/professor.mdc +4 -0
  385. package/templates/cursor/settings.json +18 -0
  386. package/templates/gemini/GEMINI.md +30 -0
  387. package/templates/gemini/settings.json +5 -0
  388. package/templates/opencode/opencode.json +3 -0
  389. package/templates/researcher/README.md +61 -0
  390. package/templates/researcher/settings.json +18 -0
  391. package/web/client/components.json +15 -0
  392. package/web/client/index.html +12 -0
  393. package/web/client/package-lock.json +8732 -0
  394. package/web/client/package.json +39 -0
  395. package/web/client/postcss.config.js +6 -0
  396. package/web/client/src/App.jsx +140 -0
  397. package/web/client/src/api/client.js +357 -0
  398. package/web/client/src/components/ChatPanel.jsx +417 -0
  399. package/web/client/src/components/CommandPills.jsx +50 -0
  400. package/web/client/src/components/DeprecationBanner.jsx +21 -0
  401. package/web/client/src/components/ExerciseEditor.jsx +164 -0
  402. package/web/client/src/components/Header.jsx +119 -0
  403. package/web/client/src/components/LecturePanel.jsx +342 -0
  404. package/web/client/src/components/MobileTabSwitcher.jsx +51 -0
  405. package/web/client/src/components/SplitPane.jsx +42 -0
  406. package/web/client/src/components/ui/alert.jsx +38 -0
  407. package/web/client/src/components/ui/badge.jsx +24 -0
  408. package/web/client/src/components/ui/button.jsx +23 -0
  409. package/web/client/src/components/ui/select.jsx +74 -0
  410. package/web/client/src/hooks/useSSE.js +152 -0
  411. package/web/client/src/hooks/useWebSocket.js +98 -0
  412. package/web/client/src/index.css +23 -0
  413. package/web/client/src/lib/utils.js +6 -0
  414. package/web/client/src/main.jsx +12 -0
  415. package/web/client/src/utils/markdown.js +50 -0
  416. package/web/client/tailwind.config.js +8 -0
  417. package/web/client/vite.config.js +21 -0
  418. package/web/dist/assets/index-C1W0eXIQ.js +294 -0
  419. package/web/dist/assets/index-C3OUx70T.css +1 -0
  420. package/web/dist/index.html +13 -0
  421. package/web/lecture-archive.js +172 -0
  422. package/web/legacy-server.js +1277 -0
  423. package/web/package-lock.json +855 -0
  424. package/web/package.json +10 -0
  425. package/web/security.js +1016 -0
  426. package/web/server.js +390 -0
  427. package/web/studio-api/agents.js +580 -0
  428. package/web/studio-api/bridge.js +199 -0
  429. package/web/studio-api/db.js +66 -0
  430. package/web/studio-api/guards.js +201 -0
  431. package/web/studio-api/health.js +538 -0
  432. package/web/studio-api.js +214 -0
  433. package/web/studio-db.js +380 -0
  434. package/web/studio-runner.js +568 -0
@@ -0,0 +1,39 @@
1
+ {
2
+ "name": "professor-client",
3
+ "private": true,
4
+ "version": "2.0.0",
5
+ "type": "module",
6
+ "scripts": {
7
+ "dev": "vite",
8
+ "build": "vite build",
9
+ "preview": "vite preview",
10
+ "test": "vitest"
11
+ },
12
+ "dependencies": {
13
+ "@bytemd/plugin-gfm": "^1.22.0",
14
+ "@bytemd/vue": "^1.22.0",
15
+ "@radix-ui/react-select": "^2.2.6",
16
+ "@tiptap/markdown": "^3.20.5",
17
+ "@tiptap/react": "^3.20.5",
18
+ "@tiptap/starter-kit": "^3.20.5",
19
+ "class-variance-authority": "^0.7.1",
20
+ "clsx": "^2.1.1",
21
+ "dompurify": "^3.0.0",
22
+ "lucide-react": "^1.7.0",
23
+ "react": "^19.0.0",
24
+ "react-dom": "^19.0.0",
25
+ "react-markdown": "^10.0.0",
26
+ "react-syntax-highlighter": "^16.0.0",
27
+ "remark-gfm": "^4.0.0",
28
+ "tailwind-merge": "^3.5.0"
29
+ },
30
+ "devDependencies": {
31
+ "@tailwindcss/postcss": "^4.2.2",
32
+ "@vitejs/plugin-react": "^4.0.0",
33
+ "autoprefixer": "^10.4.27",
34
+ "postcss": "^8.5.8",
35
+ "tailwindcss": "^4.2.2",
36
+ "vite": "^7.0.0",
37
+ "vitest": "^3.0.0"
38
+ }
39
+ }
@@ -0,0 +1,6 @@
1
+ export default {
2
+ plugins: {
3
+ '@tailwindcss/postcss': {},
4
+ autoprefixer: {},
5
+ },
6
+ };
@@ -0,0 +1,140 @@
1
+ /**
2
+ * App.jsx - Main application component with all components wired together
3
+ */
4
+
5
+ import { useState, useEffect, useCallback } from 'react';
6
+ import Header from './components/Header.jsx';
7
+ import SplitPane from './components/SplitPane.jsx';
8
+ import LecturePanel from './components/LecturePanel.jsx';
9
+ import ChatPanel from './components/ChatPanel.jsx';
10
+ import MobileTabSwitcher from './components/MobileTabSwitcher.jsx';
11
+ import DeprecationBanner from './components/DeprecationBanner.jsx';
12
+ import { fetchCourses, initPairing } from './api/client.js';
13
+
14
+ initPairing();
15
+
16
+ /**
17
+ * Main App component - wires all components together
18
+ */
19
+ export default function App() {
20
+ // State
21
+ const [courses, setCourses] = useState([]);
22
+ const [selectedCourse, setSelectedCourse] = useState(null);
23
+ const [currentPhase, setCurrentPhase] = useState('idle');
24
+ const [activeTab, setActiveTab] = useState('both'); // 'both', 'lecture', or 'chat'
25
+ const [lectureContent, setLectureContent] = useState('');
26
+ const [isMobile, setIsMobile] = useState(false);
27
+
28
+ // Detect mobile viewport
29
+ useEffect(() => {
30
+ const checkMobile = () => {
31
+ setIsMobile(window.innerWidth < 768);
32
+ if (window.innerWidth < 768) {
33
+ setActiveTab('lecture'); // Default to lecture on mobile
34
+ } else {
35
+ setActiveTab('both');
36
+ }
37
+ };
38
+
39
+ checkMobile();
40
+ window.addEventListener('resize', checkMobile);
41
+ return () => window.removeEventListener('resize', checkMobile);
42
+ }, []);
43
+
44
+ // Load courses on mount and on refresh-courses event
45
+ useEffect(() => {
46
+ loadCourses(null);
47
+ const handleRefresh = (e) => loadCourses(e.detail?.slug);
48
+ window.addEventListener('refresh-courses', handleRefresh);
49
+ return () => window.removeEventListener('refresh-courses', handleRefresh);
50
+ }, []);
51
+
52
+ async function loadCourses(preferSlug = null) {
53
+ try {
54
+ const data = await fetchCourses();
55
+ setCourses(data || []);
56
+ if (!data || data.length === 0) return;
57
+
58
+ setSelectedCourse(prev => {
59
+ // If a specific slug is preferred (e.g., just created), select it
60
+ if (preferSlug) {
61
+ const target = data.find(c => c.slug === preferSlug);
62
+ if (target) return target;
63
+ }
64
+ // Re-select current to pick up metadata updates
65
+ if (prev) {
66
+ const refreshed = data.find(c => c.slug === prev.slug);
67
+ return refreshed || prev;
68
+ }
69
+ // Default: first course
70
+ return data[0];
71
+ });
72
+ } catch (err) {
73
+ console.error('Failed to load courses:', err);
74
+ }
75
+ }
76
+
77
+ // Handle course selection
78
+ function handleCourseSelect(course) {
79
+ setSelectedCourse(course);
80
+ setCurrentPhase(course ? 'lecture' : 'idle');
81
+ }
82
+
83
+ useEffect(() => {
84
+ setCurrentPhase(selectedCourse ? 'lecture' : 'idle');
85
+ }, [selectedCourse]);
86
+
87
+ // Handle tab change for mobile
88
+ function handleTabChange(tab) {
89
+ setActiveTab(tab);
90
+ }
91
+
92
+ // Handle lecture update (from WebSocket)
93
+ const handleLectureUpdate = useCallback((data) => {
94
+ if (data.courseSlug === selectedCourse?.slug) {
95
+ // Trigger lecture refresh
96
+ window.dispatchEvent(new CustomEvent('refresh-lecture'));
97
+ }
98
+ }, [selectedCourse]);
99
+
100
+ // NOTE: WebSocket updates are temporarily disabled until the backend WS endpoint is implemented.
101
+ // Lecture refresh is still triggered via SSE events from chat actions.
102
+
103
+ // Mobile tab
104
+ const mobileTab = activeTab === 'both' ? 'lecture' : activeTab;
105
+
106
+ return (
107
+ <div className="flex h-full min-h-0 flex-1 flex-col overflow-hidden bg-slate-950 text-slate-100">
108
+ <DeprecationBanner />
109
+ <Header
110
+ selectedCourse={selectedCourse}
111
+ onCourseSelect={handleCourseSelect}
112
+ />
113
+
114
+ {isMobile && (
115
+ <MobileTabSwitcher
116
+ activeTab={activeTab === 'both' ? 'lecture' : activeTab}
117
+ onTabChange={handleTabChange}
118
+ />
119
+ )}
120
+
121
+ <SplitPane
122
+ activeTab={activeTab}
123
+ mobileTab={mobileTab}
124
+ lecturePanel={
125
+ <LecturePanel
126
+ courseSlug={selectedCourse?.slug}
127
+ content={lectureContent}
128
+ onLectureUpdate={setLectureContent}
129
+ />
130
+ }
131
+ chatPanel={
132
+ <ChatPanel
133
+ courseSlug={selectedCourse?.slug}
134
+ currentPhase={currentPhase}
135
+ />
136
+ }
137
+ />
138
+ </div>
139
+ );
140
+ }
@@ -0,0 +1,357 @@
1
+ /**
2
+ * API client for the legacy Express backend.
3
+ *
4
+ * The pairing token reaches this app only through the URL fragment (`#token=…`), is kept in
5
+ * `sessionStorage` (never persistent storage or a query string), and is sent as `X-Studio-Token`
6
+ * on every request. A `#bridge=` fragment may point the API at another loopback port; non-loopback
7
+ * bridges are rejected before the token is ever attached.
8
+ */
9
+
10
+ const TOKEN_STORAGE_KEY = 'professor.bridgeToken';
11
+ const BRIDGE_STORAGE_KEY = 'professor.bridgeBase';
12
+ export const BRIDGE_LOOPBACK_ERROR = 'Bridge URL must be loopback';
13
+
14
+ let initialized = false;
15
+ let pairingFailure = null;
16
+
17
+ function browserWindow() {
18
+ return typeof window === 'undefined' ? null : window;
19
+ }
20
+
21
+ function browserStorage() {
22
+ try {
23
+ return typeof sessionStorage === 'undefined' ? null : sessionStorage;
24
+ } catch {
25
+ return null;
26
+ }
27
+ }
28
+
29
+ function readStorage(key) {
30
+ try {
31
+ return browserStorage()?.getItem(key) || null;
32
+ } catch {
33
+ return null;
34
+ }
35
+ }
36
+
37
+ function writeStorage(key, value) {
38
+ try {
39
+ browserStorage()?.setItem(key, value);
40
+ } catch {
41
+ /* storage can be unavailable in private mode; the pairing stays in-memory only */
42
+ }
43
+ }
44
+
45
+ function removeStorage(key) {
46
+ try {
47
+ browserStorage()?.removeItem(key);
48
+ } catch {
49
+ /* ignore */
50
+ }
51
+ }
52
+
53
+ /**
54
+ * Accept only loopback `http:`/`https:` bridge URLs and normalize them to their origin.
55
+ * @param {unknown} raw
56
+ * @returns {string|null}
57
+ */
58
+ export function validateBridgeUrl(raw) {
59
+ if (typeof raw !== 'string' || !raw) return null;
60
+ let url;
61
+ try {
62
+ url = new URL(raw);
63
+ } catch {
64
+ return null;
65
+ }
66
+ if (url.protocol !== 'http:' && url.protocol !== 'https:') return null;
67
+ const hostname = String(url.hostname || '').toLowerCase();
68
+ const loopback =
69
+ hostname === 'localhost' ||
70
+ hostname === '127.0.0.1' ||
71
+ hostname === '[::1]' ||
72
+ hostname === '::1' ||
73
+ hostname.startsWith('127.');
74
+ if (!loopback) return null;
75
+ return url.origin;
76
+ }
77
+
78
+ /**
79
+ * Read the `#token=`/`#bridge=` fragment once, persist the token in `sessionStorage`, scrub the
80
+ * fragment, and record a visible error for an invalid bridge.
81
+ * @returns {{ token: string|null, bridge: string|null, error: string|null }}
82
+ */
83
+ export function initPairing() {
84
+ const win = browserWindow();
85
+ if (!win || initialized) return pairingState();
86
+ initialized = true;
87
+
88
+ const hash = typeof win.location?.hash === 'string' ? win.location.hash : '';
89
+ if (!hash) return pairingState();
90
+
91
+ const params = new URLSearchParams(hash.replace(/^#/, ''));
92
+ const token = params.get('token');
93
+ const bridge = params.get('bridge');
94
+ let shouldScrub = false;
95
+
96
+ if (token) {
97
+ writeStorage(TOKEN_STORAGE_KEY, token);
98
+ shouldScrub = true;
99
+ }
100
+
101
+ if (bridge) {
102
+ const normalized = validateBridgeUrl(bridge);
103
+ if (normalized) {
104
+ writeStorage(BRIDGE_STORAGE_KEY, normalized);
105
+ } else {
106
+ removeStorage(BRIDGE_STORAGE_KEY);
107
+ pairingFailure = BRIDGE_LOOPBACK_ERROR;
108
+ }
109
+ shouldScrub = true;
110
+ }
111
+
112
+ if (shouldScrub) {
113
+ try {
114
+ win.history?.replaceState(null, '', `${win.location.pathname}${win.location.search}`);
115
+ } catch {
116
+ /* ignore */
117
+ }
118
+ }
119
+
120
+ return pairingState();
121
+ }
122
+
123
+ /** @returns {{ token: string|null, bridge: string|null, error: string|null }} */
124
+ export function pairingState() {
125
+ return {
126
+ token: readStorage(TOKEN_STORAGE_KEY),
127
+ bridge: readStorage(BRIDGE_STORAGE_KEY),
128
+ error: pairingFailure,
129
+ };
130
+ }
131
+
132
+ /** @returns {string|null} */
133
+ export function pairingError() {
134
+ return pairingFailure;
135
+ }
136
+
137
+ /** @returns {boolean} */
138
+ export function hasToken() {
139
+ return Boolean(readStorage(TOKEN_STORAGE_KEY)) && !pairingFailure;
140
+ }
141
+
142
+ /** @returns {boolean} */
143
+ export function pairingRequired() {
144
+ return !hasToken();
145
+ }
146
+
147
+ /** Test-only reset so unit tests can exercise multiple fragments in one process. */
148
+ export function resetPairing() {
149
+ initialized = false;
150
+ pairingFailure = null;
151
+ removeStorage(TOKEN_STORAGE_KEY);
152
+ removeStorage(BRIDGE_STORAGE_KEY);
153
+ }
154
+
155
+ /**
156
+ * API prefix for every legacy call. A paired bridge returns `<origin>/api`; otherwise same-origin.
157
+ * @returns {string}
158
+ */
159
+ export function apiBase() {
160
+ return apiBaseFrom(readStorage(BRIDGE_STORAGE_KEY));
161
+ }
162
+
163
+ /** @param {string|null} bridge @returns {string} */
164
+ export function apiBaseFrom(bridge) {
165
+ return bridge ? `${bridge}/api` : '/api';
166
+ }
167
+
168
+ /**
169
+ * Resolve a legacy API path (`/api/...`) through the same base used by every fetch.
170
+ * @param {string} path
171
+ * @returns {string}
172
+ */
173
+ export function resolveApiUrl(path) {
174
+ if (typeof path === 'string' && path.startsWith('/api')) {
175
+ return `${apiBase()}${path.slice('/api'.length)}`;
176
+ }
177
+ return path;
178
+ }
179
+
180
+ /** @returns {Record<string,string>} */
181
+ export function authHeaders() {
182
+ const token = readStorage(TOKEN_STORAGE_KEY);
183
+ if (!token || pairingFailure) return {};
184
+ return { 'X-Studio-Token': token };
185
+ }
186
+
187
+ function requestHeaders(extra = {}) {
188
+ return { ...authHeaders(), ...extra };
189
+ }
190
+
191
+ function pairingRequiredError() {
192
+ const err = new Error('Pair this browser to use the legacy UI.');
193
+ err.code = 'pairing_required';
194
+ return err;
195
+ }
196
+
197
+ /**
198
+ * Fetch list of all courses.
199
+ * @returns {Promise<Array>}
200
+ */
201
+ export async function fetchCourses() {
202
+ if (!hasToken()) return [];
203
+ const response = await fetch(`${apiBase()}/courses`, { headers: requestHeaders() });
204
+ if (!response.ok) {
205
+ throw new Error(`Failed to fetch courses: ${response.statusText}`);
206
+ }
207
+ return response.json();
208
+ }
209
+
210
+ /**
211
+ * Fetch a specific file from a course.
212
+ * @param {string} slug
213
+ * @param {string} file
214
+ * @returns {Promise<string>}
215
+ */
216
+ export async function fetchCourseFile(slug, file) {
217
+ if (!hasToken()) throw pairingRequiredError();
218
+ const response = await fetch(`${apiBase()}/courses/${slug}/${file}`, {
219
+ headers: requestHeaders(),
220
+ });
221
+ if (!response.ok) {
222
+ throw new Error(`Failed to fetch course file: ${response.statusText}`);
223
+ }
224
+ return response.json();
225
+ }
226
+
227
+ /**
228
+ * Send a chat message over a fetch POST SSE stream (a native event source cannot set headers).
229
+ * @param {string} message
230
+ * @param {{ messages?: Array<{role:string,content:string}>, courseSlug?: string,
231
+ * sessionId?: string|null, provider?: string, model?: string,
232
+ * onChunk?: Function, onComplete?: Function, onError?: Function }} [options]
233
+ * @returns {Promise<{ abort: () => void }>}
234
+ */
235
+ export async function sendChatMessage(message, options = {}) {
236
+ if (!hasToken()) throw pairingRequiredError();
237
+
238
+ const { onChunk, onComplete, onError } = options;
239
+ const controller = new AbortController();
240
+ const body = {
241
+ messages: options.messages || [{ role: 'user', content: message }],
242
+ courseSlug: options.courseSlug,
243
+ sessionId: options.sessionId,
244
+ provider: options.provider || 'auto',
245
+ model: options.model || undefined,
246
+ };
247
+
248
+ let fullResponse = '';
249
+
250
+ try {
251
+ const response = await fetch(`${apiBase()}/chat`, {
252
+ method: 'POST',
253
+ headers: requestHeaders({ 'Content-Type': 'application/json' }),
254
+ body: JSON.stringify(body),
255
+ signal: controller.signal,
256
+ });
257
+ if (!response.ok) {
258
+ throw new Error(`HTTP ${response.status}: ${response.statusText}`);
259
+ }
260
+
261
+ const reader = response.body.getReader();
262
+ const decoder = new TextDecoder();
263
+ let buffer = '';
264
+
265
+ while (true) {
266
+ const { done, value } = await reader.read();
267
+ if (done) break;
268
+ buffer += decoder.decode(value, { stream: true });
269
+ const lines = buffer.split('\n');
270
+ buffer = lines.pop();
271
+
272
+ for (const line of lines) {
273
+ if (!line.startsWith('data: ')) continue;
274
+ const raw = line.slice(6);
275
+ if (raw === '[DONE]') {
276
+ onComplete?.(fullResponse);
277
+ return { abort: () => controller.abort() };
278
+ }
279
+ let data;
280
+ try {
281
+ data = JSON.parse(raw);
282
+ } catch {
283
+ continue;
284
+ }
285
+ if (data.type === 'chunk' || typeof data.content === 'string') {
286
+ fullResponse += data.content || '';
287
+ onChunk?.(data.content || '', fullResponse);
288
+ } else if (data.type === 'complete') {
289
+ onComplete?.(fullResponse);
290
+ return { abort: () => controller.abort() };
291
+ } else if (data.type === 'error' || data.error) {
292
+ onError?.(new Error(data.message || data.error || 'Chat failed'));
293
+ return { abort: () => controller.abort() };
294
+ }
295
+ }
296
+ }
297
+
298
+ onComplete?.(fullResponse);
299
+ } catch (err) {
300
+ if (err.name !== 'AbortError') onError?.(err);
301
+ }
302
+
303
+ return { abort: () => controller.abort() };
304
+ }
305
+
306
+ /**
307
+ * Fetch all exercises for a course.
308
+ * @param {string} slug
309
+ * @returns {Promise<{exercises: Array, activeExercise: string|null}>}
310
+ */
311
+ export async function fetchExercises(slug) {
312
+ if (!hasToken()) throw pairingRequiredError();
313
+ const response = await fetch(`${apiBase()}/courses/${slug}/exercises`, {
314
+ headers: requestHeaders(),
315
+ });
316
+ if (!response.ok) {
317
+ throw new Error(`Failed to fetch exercises: ${response.statusText}`);
318
+ }
319
+ return response.json();
320
+ }
321
+
322
+ /**
323
+ * Fetch a specific exercise.
324
+ * @param {string} slug
325
+ * @param {string} filename
326
+ * @returns {Promise<{content: string, filename: string}>}
327
+ */
328
+ export async function fetchExercise(slug, filename) {
329
+ if (!hasToken()) throw pairingRequiredError();
330
+ const response = await fetch(`${apiBase()}/courses/${slug}/exercises/${filename}`, {
331
+ headers: requestHeaders(),
332
+ });
333
+ if (!response.ok) {
334
+ throw new Error(`Failed to fetch exercise: ${response.statusText}`);
335
+ }
336
+ return response.json();
337
+ }
338
+
339
+ /**
340
+ * Save exercise content.
341
+ * @param {string} slug
342
+ * @param {string} filename
343
+ * @param {string} content
344
+ * @returns {Promise<{success: boolean}>}
345
+ */
346
+ export async function saveExercise(slug, filename, content) {
347
+ if (!hasToken()) throw pairingRequiredError();
348
+ const response = await fetch(`${apiBase()}/courses/${slug}/exercises/${filename}`, {
349
+ method: 'POST',
350
+ headers: requestHeaders({ 'Content-Type': 'application/json' }),
351
+ body: JSON.stringify({ content }),
352
+ });
353
+ if (!response.ok) {
354
+ throw new Error(`Failed to save exercise: ${response.statusText}`);
355
+ }
356
+ return response.json();
357
+ }