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,214 @@
1
+ /**
2
+ * studio-api.js — Express Router mounted at `/api/studio` (AI-06, DATA-04, DEPLOY-04).
3
+ *
4
+ * Three concerns, deliberately small:
5
+ *
6
+ * 1. Bridge (`/health`, `/complete`) — lets Studio stream from the learner's OWN local agent
7
+ * (Claude Code / OpenCode / Cursor CLI) or Ollama with no API key. See `studio-api/bridge.js`.
8
+ * 2. Database (`/db/health`, `/db`) — see `studio-api/db.js`.
9
+ * 3. Safety — composed Host/Origin/token/JSON guards on every route. See `studio-api/guards.js`.
10
+ *
11
+ * Importing this module has no side effects: it opens no database, writes no token and prints
12
+ * nothing. `createStudioRouter` resolves a token only when neither `token` nor `getToken` is
13
+ * supplied, and even then the quiet file-backed getter is lazy (D-04, D-06).
14
+ *
15
+ * Mount (see web/server.js): `app.use('/api/studio', studioRouter);`
16
+ */
17
+ import express from 'express';
18
+ import { join, dirname } from 'path';
19
+ import { fileURLToPath } from 'url';
20
+
21
+ import { createStudioDb } from './studio-db.js';
22
+ import { createRunnerRouter } from './studio-runner.js';
23
+ import { installGuards, parseOrigins } from './studio-api/guards.js';
24
+ import { registerBridgeRoutes } from './studio-api/bridge.js';
25
+ import { registerDbRoutes } from './studio-api/db.js';
26
+ import { detectAgents, listAgentModels } from './studio-api/health.js';
27
+ import { defaultAgentRunners } from './studio-api/agents.js';
28
+ import * as security from './security.js';
29
+
30
+ const __dirname = dirname(fileURLToPath(import.meta.url));
31
+ const REPO_ROOT = join(__dirname, '..');
32
+
33
+ export const VERSION = '1';
34
+ export const STUDIO_URL_HINT = 'http://localhost:5180';
35
+
36
+ /**
37
+ * @deprecated Use `security.tokenFilePath(process.env)`. Kept only for the Phase 1 re-export
38
+ * surface; this no longer points at the legacy `web/.studio-token`.
39
+ */
40
+ export const TOKEN_FILE = security.tokenFilePath(process.env);
41
+
42
+ function flagEnabled(value) {
43
+ if (value === undefined || value === null || value === '') return false;
44
+ const normalized = String(value).trim().toLowerCase();
45
+ return normalized === '1' || normalized === 'true';
46
+ }
47
+
48
+ /**
49
+ * Build the Studio Express Router.
50
+ *
51
+ * @param {object} [options]
52
+ * @param {string} [options.token] pairing token (test/back-compat)
53
+ * @param {() => string} [options.getToken] pairing-token getter (preferred; observes rotation)
54
+ * @param {Set<string>|string} [options.origins] allowed origins (default: STUDIO_ORIGINS)
55
+ * @param {object} [options.db] an existing studio-db instance (default: open ~/.professor)
56
+ * @param {Record<string, Function>} [options.runners] agent runners (default: real CLI spawns)
57
+ * @param {boolean} [options.allowNonLoopback] permit non-loopback clients (default: false)
58
+ * @param {string[]} [options.extraHosts] explicitly opted-in non-loopback hosts
59
+ * @param {() => object} [options.capabilities] installer probe (default: detectAgents)
60
+ * @param {(agent: string, deps: object) => Promise<object>} [options.listAgentModels] models resolver
61
+ * @param {boolean} [options.probeReachable] probe Ollama reachability on /health (default: true)
62
+ * @param {Map} [options.modelCache] session model cache (default: fresh per router)
63
+ * @param {object} [options.runner] options forwarded to the Phase 29 runner router (studio-runner.js)
64
+ * @param {(...a:any[])=>void} [options.log] logger (default: silent)
65
+ * @returns {import('express').Router}
66
+ */
67
+ export function createStudioRouter(options = {}) {
68
+ const log = options.log || (() => {});
69
+ const env = process.env;
70
+
71
+ const db = options.db || createStudioDb({ log: (...a) => log(' [studio-db]', ...a) });
72
+
73
+ const suppliedToken =
74
+ typeof options.token === 'string' && options.token.length > 0 ? options.token : null;
75
+ const suppliedGetter = typeof options.getToken === 'function' ? options.getToken : null;
76
+ // Never generate or write a token during construction when one is supplied (D-04).
77
+ const getToken =
78
+ suppliedGetter ||
79
+ (suppliedToken
80
+ ? () => suppliedToken
81
+ : security.createTokenGetter({ env, legacyFile: security.legacyTokenPath(REPO_ROOT) }));
82
+
83
+ const origins =
84
+ options.origins instanceof Set
85
+ ? options.origins
86
+ : parseOrigins(options.origins ?? env.STUDIO_ORIGINS);
87
+ const runners = options.runners || defaultAgentRunners();
88
+ const capabilities = options.capabilities || detectAgents;
89
+ const listAgentModelsFn = options.listAgentModels || listAgentModels;
90
+ const probeReachable = options.probeReachable !== false;
91
+ const modelCache = options.modelCache || new Map();
92
+ const allowNonLoopback =
93
+ options.allowNonLoopback ?? flagEnabled(env.STUDIO_ALLOW_NON_LOOPBACK);
94
+ const extraHosts =
95
+ options.extraHosts ?? security.resolveExtraHosts({ env, host: env.HOST });
96
+
97
+ const router = express.Router();
98
+
99
+ // Guards: Host -> Origin/preflight -> token -> JSON content-type -> parser -> error mapper.
100
+ installGuards(router, { getToken, origins, allowNonLoopback, extraHosts });
101
+
102
+ /* -------------------------------------------------- local runner (Phase 29) */
103
+
104
+ // Mounted INSIDE the guards above, so the runner inherits auth for free (HANDOFF-29 §1).
105
+ router.use('/run', createRunnerRouter(options.runner));
106
+
107
+ /* -------------------------------------------------- bridge */
108
+
109
+ registerBridgeRoutes(router, {
110
+ capabilities,
111
+ probeReachable,
112
+ env,
113
+ runners,
114
+ modelCache,
115
+ listAgentModelsFn,
116
+ log,
117
+ version: VERSION,
118
+ });
119
+
120
+ /* -------------------------------------------------- database */
121
+
122
+ registerDbRoutes(router, { db });
123
+
124
+ router.__studio = { db, getToken, token: suppliedToken ?? undefined, origins };
125
+ return router;
126
+ }
127
+
128
+ /**
129
+ * Convenience: a bare Express app with the router already mounted at `/api/studio`.
130
+ * Used by tests and by anyone running the Studio API standalone.
131
+ * @param {Parameters<typeof createStudioRouter>[0]} [options]
132
+ * @returns {import('express').Express}
133
+ */
134
+ export function createStudioApp(options = {}) {
135
+ const app = express();
136
+ app.use('/api/studio', createStudioRouter(options));
137
+ return app;
138
+ }
139
+
140
+ /* ------------------------------------------------------------------ default mount */
141
+
142
+ let defaultRouter = null;
143
+ let defaultInitError = null;
144
+
145
+ /**
146
+ * Default export: a fully silent, lazy request handler so `app.use('/api/studio', studioRouter)`
147
+ * keeps working. No banner, no eager DB open and no token write at import time.
148
+ */
149
+ export default function studioRouter(req, res, next) {
150
+ if (defaultInitError) {
151
+ res.status(503).json({
152
+ ok: false,
153
+ error: `Studio server failed to start: ${defaultInitError.message}`,
154
+ code: 'server',
155
+ });
156
+ return;
157
+ }
158
+ if (!defaultRouter) {
159
+ try {
160
+ defaultRouter = createStudioRouter();
161
+ } catch (err) {
162
+ defaultInitError = err;
163
+ res.status(503).json({
164
+ ok: false,
165
+ error: `Studio server failed to start: ${err.message}`,
166
+ code: 'server',
167
+ });
168
+ return;
169
+ }
170
+ }
171
+ return defaultRouter(req, res, next);
172
+ }
173
+
174
+ export { createStudioDb };
175
+
176
+ /* ------------------------------------------------------------------ re-exports */
177
+ /* Preserve the original public surface so importers need zero changes (Phase 1 D-01). */
178
+
179
+ export { DEFAULT_ORIGINS, parseOrigins } from './studio-api/guards.js';
180
+
181
+ export {
182
+ AGENT_BINARIES,
183
+ AGENT_PRIORITY,
184
+ AGENT_LABELS,
185
+ AGENT_MODEL_SUPPORT,
186
+ AGENT_CURATED_MODELS,
187
+ detectAgentLogin,
188
+ detectAgents,
189
+ probeOllama,
190
+ parseOpencodeModels,
191
+ parseAntigravityModels,
192
+ parseCursorModels,
193
+ curatedAgentModels,
194
+ listAgentModels,
195
+ firstMeaningfulStderr,
196
+ diagnoseAgentFailure,
197
+ describeNoOutput,
198
+ } from './studio-api/health.js';
199
+
200
+ export { flattenConversation, clampMessages } from './studio-api/bridge.js';
201
+
202
+ export {
203
+ extractClaudeText,
204
+ extractOpencodeText,
205
+ extractGeminiText,
206
+ extractAntigravityText,
207
+ antigravityStep,
208
+ antigravityErrorText,
209
+ antigravityArgs,
210
+ opencodeErrorText,
211
+ claudeErrorText,
212
+ geminiErrorText,
213
+ defaultAgentRunners,
214
+ } from './studio-api/agents.js';
@@ -0,0 +1,380 @@
1
+ /**
2
+ * studio-db.js — the Studio SQLite storage layer (DATA-04).
3
+ *
4
+ * A dumb, table-level StorageAdapter (see `studio/src/lib/repo/remote-adapter.js` for the contract)
5
+ * backed by Node's built-in `node:sqlite` (`DatabaseSync`). No business logic: `studio/src/lib/repo`
6
+ * owns ids, owner_id, timestamps and tombstones.
7
+ *
8
+ * • DB file: ${PROFESSOR_HOME:-~/.professor}/professor.db (override with STUDIO_DB)
9
+ * • Migrations: studio/migrations/*.sql applied in filename order (override with STUDIO_MIGRATIONS_DIR)
10
+ * • Tracking table: `d1_migrations` (same name/shape wrangler D1 uses) so the SAME migration files
11
+ * run unchanged here and on Cloudflare D1.
12
+ *
13
+ * Safety: table and column names are validated against the migration-defined schema, read once at
14
+ * startup via `sqlite_master` + `pragma_table_info`. Every statement is parameterized; identifiers
15
+ * are only ever emitted after a whitelist check.
16
+ */
17
+ import { DatabaseSync } from 'node:sqlite';
18
+ import { readFileSync, readdirSync, mkdirSync } from 'fs';
19
+ import { join, dirname } from 'path';
20
+ import { homedir } from 'os';
21
+ import { fileURLToPath } from 'url';
22
+ import { LATEST_MIGRATION_VERSION } from '../studio/src/lib/repo/schema.js';
23
+
24
+ const __dirname = dirname(fileURLToPath(import.meta.url));
25
+
26
+ export const APP_ID = 'professor-studio';
27
+ export const MIGRATIONS_TABLE = 'd1_migrations';
28
+
29
+ /** Error carrying a stable machine code for the HTTP layer. */
30
+ export class StudioDbError extends Error {
31
+ /** @param {string} message @param {string} [code] */
32
+ constructor(message, code = 'db_error') {
33
+ super(message);
34
+ this.name = 'StudioDbError';
35
+ this.code = code;
36
+ }
37
+ }
38
+
39
+ /**
40
+ * @param {Record<string,string|undefined>} [env]
41
+ * @returns {string} absolute path to the SQLite file
42
+ */
43
+ export function resolveDbPath(env = process.env) {
44
+ if (env.STUDIO_DB) return env.STUDIO_DB;
45
+ const home = env.PROFESSOR_HOME || join(homedir(), '.professor');
46
+ return join(home, 'professor.db');
47
+ }
48
+
49
+ /**
50
+ * @param {Record<string,string|undefined>} [env]
51
+ * @returns {string} absolute path to the migrations directory
52
+ */
53
+ export function resolveMigrationsDir(env = process.env) {
54
+ if (env.STUDIO_MIGRATIONS_DIR) return env.STUDIO_MIGRATIONS_DIR;
55
+ return join(__dirname, '..', 'studio', 'migrations');
56
+ }
57
+
58
+ /** Quote a SQL identifier (only ever called after a whitelist check). */
59
+ function q(name) {
60
+ return `"${String(name).replace(/"/g, '""')}"`;
61
+ }
62
+
63
+ /** Default value for a NOT NULL column that has no SQL DEFAULT and was not supplied. */
64
+ function defaultForType(type) {
65
+ const t = String(type || '').toUpperCase();
66
+ if (t.includes('INT') || t.includes('REAL') || t.includes('NUM') || t.includes('DEC') || t.includes('DOUB') || t.includes('FLOA')) {
67
+ return 0;
68
+ }
69
+ return '';
70
+ }
71
+
72
+ /** Coerce a JS value into something node:sqlite can bind. */
73
+ function bindValue(value) {
74
+ if (value === undefined || value === null) return null;
75
+ const type = typeof value;
76
+ if (type === 'string' || type === 'number' || type === 'bigint') return value;
77
+ if (type === 'boolean') return value ? 1 : 0;
78
+ if (value instanceof Uint8Array) return value;
79
+ // JSON / objects / arrays are stored as TEXT (the schema stores JSON as TEXT).
80
+ try {
81
+ return JSON.stringify(value);
82
+ } catch {
83
+ return String(value);
84
+ }
85
+ }
86
+
87
+ function ensureMigrationsTable(db) {
88
+ db.exec(
89
+ `CREATE TABLE IF NOT EXISTS ${q(MIGRATIONS_TABLE)} (` +
90
+ 'id INTEGER PRIMARY KEY AUTOINCREMENT, ' +
91
+ 'name TEXT UNIQUE, ' +
92
+ 'applied_at TEXT)'
93
+ );
94
+ }
95
+
96
+ /**
97
+ * Apply every *.sql file in `dir` that is not yet recorded, in filename order.
98
+ * @param {DatabaseSync} db
99
+ * @param {string} dir
100
+ * @returns {string[]} names of migrations applied in this run
101
+ */
102
+ export function runMigrations(db, dir) {
103
+ ensureMigrationsTable(db);
104
+ const applied = new Set(db.prepare(`SELECT name FROM ${q(MIGRATIONS_TABLE)}`).all().map((r) => r.name));
105
+ const files = readdirSync(dir)
106
+ .filter((f) => f.endsWith('.sql'))
107
+ .sort();
108
+ const ran = [];
109
+ for (const file of files) {
110
+ if (applied.has(file)) continue;
111
+ const sql = readFileSync(join(dir, file), 'utf-8');
112
+ db.exec('BEGIN');
113
+ try {
114
+ db.exec(sql);
115
+ db.prepare(`INSERT INTO ${q(MIGRATIONS_TABLE)} (name, applied_at) VALUES (?, ?)`).run(
116
+ file,
117
+ new Date().toISOString()
118
+ );
119
+ db.exec('COMMIT');
120
+ ran.push(file);
121
+ } catch (err) {
122
+ db.exec('ROLLBACK');
123
+ throw new StudioDbError(`Migration ${file} failed: ${err.message}`, 'migration_failed');
124
+ }
125
+ }
126
+ return ran;
127
+ }
128
+
129
+ /**
130
+ * Highest numeric migration prefix recorded in `d1_migrations`, or 0 when no row matches.
131
+ * Malformed names and suffixes are ignored; the value is never derived from a row COUNT because a
132
+ * missing middle migration would then report a version the database does not actually have.
133
+ * @param {DatabaseSync} db
134
+ * @returns {number}
135
+ */
136
+ export function appliedMigrationVersion(db) {
137
+ const rows = db.prepare(`SELECT name FROM ${q(MIGRATIONS_TABLE)}`).all();
138
+ return rows.reduce((max, row) => {
139
+ const match = /^(\d+)_/.exec(String(row.name));
140
+ if (!match) return max;
141
+ const version = Number(match[1]);
142
+ return Number.isInteger(version) ? Math.max(max, version) : max;
143
+ }, 0);
144
+ }
145
+
146
+ /**
147
+ * Read the live schema (tables + columns) via sqlite_master + pragma_table_info.
148
+ * @param {DatabaseSync} db
149
+ * @returns {Record<string, { idName: string, columns: Map<string, {name:string,type:string,notnull:boolean,pk:boolean,dflt:any}> }>}
150
+ */
151
+ export function introspectSchema(db) {
152
+ const schema = {};
153
+ const tables = db
154
+ .prepare(
155
+ "SELECT name FROM sqlite_master WHERE type = 'table' AND name NOT LIKE 'sqlite_%' AND name != ?"
156
+ )
157
+ .all(MIGRATIONS_TABLE);
158
+ for (const { name } of tables) {
159
+ const cols = db.prepare('SELECT * FROM pragma_table_info(?)').all(name);
160
+ const columns = new Map();
161
+ let idName = 'id';
162
+ for (const c of cols) {
163
+ const entry = {
164
+ name: c.name,
165
+ type: c.type,
166
+ notnull: !!c.notnull,
167
+ pk: !!c.pk,
168
+ dflt: c.dflt_value,
169
+ };
170
+ columns.set(c.name, entry);
171
+ if (entry.pk) idName = entry.name;
172
+ }
173
+ schema[name] = { idName, columns };
174
+ }
175
+ return schema;
176
+ }
177
+
178
+ /**
179
+ * Open (creating if needed) the SQLite database, run migrations and introspect the schema.
180
+ * @param {{ dbPath?: string, migrationsDir?: string, log?: (msg: string) => void }} [opts]
181
+ */
182
+ export function createStudioDb({ dbPath, migrationsDir, log = () => {} } = {}) {
183
+ const path = dbPath || resolveDbPath();
184
+ mkdirSync(dirname(path), { recursive: true });
185
+ const db = new DatabaseSync(path);
186
+ db.exec('PRAGMA journal_mode = WAL');
187
+ db.exec('PRAGMA busy_timeout = 4000');
188
+
189
+ const migrationsRun = runMigrations(db, migrationsDir || resolveMigrationsDir());
190
+ const schema = introspectSchema(db);
191
+ // D-12: report the schema the database actually has, not the code's idea of it. An empty ledger
192
+ // (a brand-new DB before the first migration recorded) falls back to the shared constant.
193
+ const schemaVersion = appliedMigrationVersion(db) || LATEST_MIGRATION_VERSION;
194
+ if (migrationsRun.length) log(`Applied ${migrationsRun.length} migration(s): ${migrationsRun.join(', ')}`);
195
+
196
+ function specFor(table) {
197
+ const spec = schema[table];
198
+ if (!spec) throw new StudioDbError(`Unknown table: ${table}`, 'unknown_table');
199
+ return spec;
200
+ }
201
+ function assertColumn(spec, column, table) {
202
+ if (!spec.columns.has(column)) {
203
+ throw new StudioDbError(`Unknown column "${column}" on table "${table}"`, 'unknown_column');
204
+ }
205
+ }
206
+
207
+ /**
208
+ * Upsert a row, replacing the whole record (matches the memory/IndexedDB adapters: fields the
209
+ * caller omits are reset to their column default / NULL, not merged).
210
+ * @returns {object|null} the stored row
211
+ */
212
+ function put(table, row) {
213
+ const spec = specFor(table);
214
+ if (!row || typeof row !== 'object') throw new StudioDbError(`put(${table}) needs a row object`, 'bad_row');
215
+ const id = row[spec.idName];
216
+ if (id === undefined || id === null) {
217
+ throw new StudioDbError(`Row for "${table}" is missing "${spec.idName}"`, 'missing_id');
218
+ }
219
+ const cols = [];
220
+ const values = [];
221
+ for (const [key, value] of Object.entries(row)) {
222
+ if (value === undefined) continue;
223
+ // Ignore keys that are not columns of this table (keeps the store dumb/KV-like; the repo
224
+ // always writes schema columns, so this only tolerates extra fields).
225
+ if (!spec.columns.has(key)) continue;
226
+ cols.push(key);
227
+ values.push(bindValue(value));
228
+ }
229
+ // Fill NOT NULL columns that have no SQL default so the insert cannot violate constraints.
230
+ for (const col of spec.columns.values()) {
231
+ if (col.pk || cols.includes(col.name)) continue;
232
+ if (col.notnull && col.dflt === null) {
233
+ cols.push(col.name);
234
+ values.push(defaultForType(col.type));
235
+ }
236
+ }
237
+ const placeholders = cols.map(() => '?').join(', ');
238
+ const sql = `INSERT OR REPLACE INTO ${q(table)} (${cols.map(q).join(', ')}) VALUES (${placeholders})`;
239
+ db.prepare(sql).run(...values);
240
+ return get(table, id);
241
+ }
242
+
243
+ /** @returns {object|null} */
244
+ function get(table, id) {
245
+ const spec = specFor(table);
246
+ const row = db.prepare(`SELECT * FROM ${q(table)} WHERE ${q(spec.idName)} = ?`).get(id);
247
+ return row ?? null;
248
+ }
249
+
250
+ /** @returns {object[]} */
251
+ function putMany(table, rows) {
252
+ specFor(table);
253
+ const list = Array.isArray(rows) ? rows : [];
254
+ db.exec('BEGIN');
255
+ try {
256
+ for (const row of list) put(table, row);
257
+ db.exec('COMMIT');
258
+ } catch (err) {
259
+ db.exec('ROLLBACK');
260
+ throw err;
261
+ }
262
+ return list.map((r) => get(table, r[specFor(table).idName])).filter(Boolean);
263
+ }
264
+
265
+ /**
266
+ * @param {string} table
267
+ * @param {{ where?: Record<string, any>, includeDeleted?: boolean, orderBy?: string|{field:string,dir?:'asc'|'desc'}, limit?: number }} [opts]
268
+ * @returns {object[]}
269
+ */
270
+ function list(table, opts = {}) {
271
+ const spec = specFor(table);
272
+ const conds = [];
273
+ const params = [];
274
+ for (const [field, value] of Object.entries(opts.where || {})) {
275
+ assertColumn(spec, field, table);
276
+ conds.push(`${q(field)} = ?`);
277
+ params.push(bindValue(value));
278
+ }
279
+ if (!opts.includeDeleted) conds.push('deleted_at IS NULL');
280
+ let sql = `SELECT * FROM ${q(table)}`;
281
+ if (conds.length) sql += ` WHERE ${conds.join(' AND ')}`;
282
+ if (opts.orderBy) {
283
+ const field = typeof opts.orderBy === 'string' ? opts.orderBy : opts.orderBy.field;
284
+ const dir = typeof opts.orderBy === 'object' && opts.orderBy.dir === 'desc' ? 'DESC' : 'ASC';
285
+ assertColumn(spec, field, table);
286
+ sql += ` ORDER BY ${q(field)} ${dir}`;
287
+ }
288
+ if (typeof opts.limit === 'number' && Number.isFinite(opts.limit)) {
289
+ sql += ` LIMIT ${Math.max(0, Math.floor(opts.limit))}`;
290
+ }
291
+ return db.prepare(sql).all(...params);
292
+ }
293
+
294
+ /** @returns {object|null} */
295
+ function softDelete(table, id) {
296
+ const spec = specFor(table);
297
+ db.prepare(`UPDATE ${q(table)} SET deleted_at = ? WHERE ${q(spec.idName)} = ?`).run(
298
+ new Date().toISOString(),
299
+ id
300
+ );
301
+ return get(table, id);
302
+ }
303
+
304
+ function exportAll() {
305
+ const tables = {};
306
+ for (const name of Object.keys(schema)) {
307
+ tables[name] = db.prepare(`SELECT * FROM ${q(name)}`).all();
308
+ }
309
+ return {
310
+ app: APP_ID,
311
+ version: 1,
312
+ schemaVersion,
313
+ exportedAt: new Date().toISOString(),
314
+ tables,
315
+ };
316
+ }
317
+
318
+ function importAll(dump) {
319
+ if (!dump || dump.app !== APP_ID) throw new StudioDbError('Not a Professor Studio backup file', 'bad_backup');
320
+ if (!dump.tables || typeof dump.tables !== 'object') {
321
+ throw new StudioDbError('Backup file has no tables', 'bad_backup');
322
+ }
323
+ let imported = 0;
324
+ db.exec('BEGIN');
325
+ try {
326
+ for (const table of Object.keys(schema)) {
327
+ for (const row of dump.tables[table] || []) {
328
+ put(table, row);
329
+ imported += 1;
330
+ }
331
+ }
332
+ db.exec('COMMIT');
333
+ } catch (err) {
334
+ db.exec('ROLLBACK');
335
+ throw err;
336
+ }
337
+ return { imported };
338
+ }
339
+
340
+ function close() {
341
+ try {
342
+ db.close();
343
+ } catch {
344
+ /* already closed */
345
+ }
346
+ }
347
+
348
+ /** Remove every row from every table (STORE-03 "remove the old copy"). Schema is preserved. */
349
+ function clearAll() {
350
+ db.exec('BEGIN');
351
+ try {
352
+ for (const name of Object.keys(schema)) db.exec(`DELETE FROM ${q(name)}`);
353
+ db.exec('COMMIT');
354
+ } catch (err) {
355
+ db.exec('ROLLBACK');
356
+ throw err;
357
+ }
358
+ return { cleared: true };
359
+ }
360
+
361
+ return {
362
+ path,
363
+ tables: Object.keys(schema),
364
+ schemaVersion,
365
+ migrationsRun,
366
+ get,
367
+ put,
368
+ putMany,
369
+ list,
370
+ softDelete,
371
+ exportAll,
372
+ importAll,
373
+ clearAll,
374
+ close,
375
+ /** @returns {{kind:'sqlite', path:string, schemaVersion:number}} */
376
+ info() {
377
+ return { kind: 'sqlite', path, schemaVersion };
378
+ },
379
+ };
380
+ }