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.
- package/CHANGELOG.md +74 -0
- package/LICENSE +202 -0
- package/NOTICE +19 -0
- package/README.md +258 -2
- package/bin/cli.js +823 -0
- package/bin/commands/archive.js +192 -0
- package/bin/commands/capstone-status.js +82 -0
- package/bin/commands/check.js +298 -0
- package/bin/commands/create.js +226 -0
- package/bin/commands/doctor.js +392 -0
- package/bin/commands/import.js +557 -0
- package/bin/commands/next.js +125 -0
- package/bin/commands/review.js +207 -0
- package/bin/commands/status.js +114 -0
- package/bin/commands/studio-autostart.js +414 -0
- package/bin/commands/studio-state.js +159 -0
- package/bin/commands/studio.js +831 -0
- package/bin/commands/trail.js +361 -0
- package/bin/commands/web.js +348 -0
- package/bin/course-reader.js +602 -0
- package/bin/node-version.js +60 -0
- package/bin/platforms/_shared.js +337 -0
- package/bin/platforms/claude.js +85 -0
- package/bin/platforms/cursor.js +52 -0
- package/bin/platforms/gemini.js +64 -0
- package/bin/platforms/opencode.js +114 -0
- package/bin/registry-helpers.js +504 -0
- package/bin/static-server.js +153 -0
- package/bin/studio-store.js +94 -0
- package/bin/sync-shared.sh +5 -0
- package/package.json +92 -4
- package/plugin.json +139 -0
- package/shared/SKILL.md +598 -0
- package/shared/agents/coach.md +228 -0
- package/shared/agents/navigator.md +208 -0
- package/shared/agents/professor.md +354 -0
- package/shared/agents/researcher.md +181 -0
- package/shared/agents/spotter.md +128 -0
- package/shared/commands/professor/archive.md +96 -0
- package/shared/commands/professor/capstone-review.md +79 -0
- package/shared/commands/professor/capstone.md +34 -0
- package/shared/commands/professor/discuss.md +18 -0
- package/shared/commands/professor/done.md +72 -0
- package/shared/commands/professor/export.md +69 -0
- package/shared/commands/professor/hint.md +120 -0
- package/shared/commands/professor/navigator.md +93 -0
- package/shared/commands/professor/new-topic.md +73 -0
- package/shared/commands/professor/next.md +178 -0
- package/shared/commands/professor/note.md +63 -0
- package/shared/commands/professor/onboard.md +95 -0
- package/shared/commands/professor/progress.md +46 -0
- package/shared/commands/professor/publish.md +93 -0
- package/shared/commands/professor/quiz.md +27 -0
- package/shared/commands/professor/recall.md +74 -0
- package/shared/commands/professor/review.md +57 -0
- package/shared/commands/professor/schedule.md +75 -0
- package/shared/commands/professor/skill-export.md +86 -0
- package/shared/commands/professor/spotter.md +93 -0
- package/shared/commands/professor/stuck.md +51 -0
- package/shared/commands/professor/switch.md +50 -0
- package/shared/commands/professor/syllabus.md +9 -0
- package/shared/commands/professor/template-export.md +91 -0
- package/shared/commands/professor/template-import.md +111 -0
- package/shared/commands/professor/worktrees.md +54 -0
- package/shared/hooks/pre-compact.js +221 -0
- package/studio/README.md +313 -0
- package/studio/dist/assets/BetaReportPanel-BJ9HIAnz.js +1 -0
- package/studio/dist/assets/Capstone-CoUU-jP7.js +6 -0
- package/studio/dist/assets/CodeWorkspace-BNrL4qvR.js +2 -0
- package/studio/dist/assets/Course-BMGTXus_.js +1 -0
- package/studio/dist/assets/Editor-Cw9j3cnp.js +53 -0
- package/studio/dist/assets/Home-D2woITq5.js +1 -0
- package/studio/dist/assets/KaTeX_AMS-Regular-BQhdFMY1.woff2 +0 -0
- package/studio/dist/assets/KaTeX_AMS-Regular-DMm9YOAa.woff +0 -0
- package/studio/dist/assets/KaTeX_AMS-Regular-DRggAlZN.ttf +0 -0
- package/studio/dist/assets/KaTeX_Caligraphic-Bold-ATXxdsX0.ttf +0 -0
- package/studio/dist/assets/KaTeX_Caligraphic-Bold-BEiXGLvX.woff +0 -0
- package/studio/dist/assets/KaTeX_Caligraphic-Bold-Dq_IR9rO.woff2 +0 -0
- package/studio/dist/assets/KaTeX_Caligraphic-Regular-CTRA-rTL.woff +0 -0
- package/studio/dist/assets/KaTeX_Caligraphic-Regular-Di6jR-x-.woff2 +0 -0
- package/studio/dist/assets/KaTeX_Caligraphic-Regular-wX97UBjC.ttf +0 -0
- package/studio/dist/assets/KaTeX_Fraktur-Bold-BdnERNNW.ttf +0 -0
- package/studio/dist/assets/KaTeX_Fraktur-Bold-BsDP51OF.woff +0 -0
- package/studio/dist/assets/KaTeX_Fraktur-Bold-CL6g_b3V.woff2 +0 -0
- package/studio/dist/assets/KaTeX_Fraktur-Regular-CB_wures.ttf +0 -0
- package/studio/dist/assets/KaTeX_Fraktur-Regular-CTYiF6lA.woff2 +0 -0
- package/studio/dist/assets/KaTeX_Fraktur-Regular-Dxdc4cR9.woff +0 -0
- package/studio/dist/assets/KaTeX_Main-Bold-Cx986IdX.woff2 +0 -0
- package/studio/dist/assets/KaTeX_Main-Bold-Jm3AIy58.woff +0 -0
- package/studio/dist/assets/KaTeX_Main-Bold-waoOVXN0.ttf +0 -0
- package/studio/dist/assets/KaTeX_Main-BoldItalic-DxDJ3AOS.woff2 +0 -0
- package/studio/dist/assets/KaTeX_Main-BoldItalic-DzxPMmG6.ttf +0 -0
- package/studio/dist/assets/KaTeX_Main-BoldItalic-SpSLRI95.woff +0 -0
- package/studio/dist/assets/KaTeX_Main-Italic-3WenGoN9.ttf +0 -0
- package/studio/dist/assets/KaTeX_Main-Italic-BMLOBm91.woff +0 -0
- package/studio/dist/assets/KaTeX_Main-Italic-NWA7e6Wa.woff2 +0 -0
- package/studio/dist/assets/KaTeX_Main-Regular-B22Nviop.woff2 +0 -0
- package/studio/dist/assets/KaTeX_Main-Regular-Dr94JaBh.woff +0 -0
- package/studio/dist/assets/KaTeX_Main-Regular-ypZvNtVU.ttf +0 -0
- package/studio/dist/assets/KaTeX_Math-BoldItalic-B3XSjfu4.ttf +0 -0
- package/studio/dist/assets/KaTeX_Math-BoldItalic-CZnvNsCZ.woff2 +0 -0
- package/studio/dist/assets/KaTeX_Math-BoldItalic-iY-2wyZ7.woff +0 -0
- package/studio/dist/assets/KaTeX_Math-Italic-DA0__PXp.woff +0 -0
- package/studio/dist/assets/KaTeX_Math-Italic-flOr_0UB.ttf +0 -0
- package/studio/dist/assets/KaTeX_Math-Italic-t53AETM-.woff2 +0 -0
- package/studio/dist/assets/KaTeX_SansSerif-Bold-CFMepnvq.ttf +0 -0
- package/studio/dist/assets/KaTeX_SansSerif-Bold-D1sUS0GD.woff2 +0 -0
- package/studio/dist/assets/KaTeX_SansSerif-Bold-DbIhKOiC.woff +0 -0
- package/studio/dist/assets/KaTeX_SansSerif-Italic-C3H0VqGB.woff2 +0 -0
- package/studio/dist/assets/KaTeX_SansSerif-Italic-DN2j7dab.woff +0 -0
- package/studio/dist/assets/KaTeX_SansSerif-Italic-YYjJ1zSn.ttf +0 -0
- package/studio/dist/assets/KaTeX_SansSerif-Regular-BNo7hRIc.ttf +0 -0
- package/studio/dist/assets/KaTeX_SansSerif-Regular-CS6fqUqJ.woff +0 -0
- package/studio/dist/assets/KaTeX_SansSerif-Regular-DDBCnlJ7.woff2 +0 -0
- package/studio/dist/assets/KaTeX_Script-Regular-C5JkGWo-.ttf +0 -0
- package/studio/dist/assets/KaTeX_Script-Regular-D3wIWfF6.woff2 +0 -0
- package/studio/dist/assets/KaTeX_Script-Regular-D5yQViql.woff +0 -0
- package/studio/dist/assets/KaTeX_Size1-Regular-C195tn64.woff +0 -0
- package/studio/dist/assets/KaTeX_Size1-Regular-Dbsnue_I.ttf +0 -0
- package/studio/dist/assets/KaTeX_Size1-Regular-mCD8mA8B.woff2 +0 -0
- package/studio/dist/assets/KaTeX_Size2-Regular-B7gKUWhC.ttf +0 -0
- package/studio/dist/assets/KaTeX_Size2-Regular-Dy4dx90m.woff2 +0 -0
- package/studio/dist/assets/KaTeX_Size2-Regular-oD1tc_U0.woff +0 -0
- package/studio/dist/assets/KaTeX_Size3-Regular-CTq5MqoE.woff +0 -0
- package/studio/dist/assets/KaTeX_Size3-Regular-DgpXs0kz.ttf +0 -0
- package/studio/dist/assets/KaTeX_Size4-Regular-BF-4gkZK.woff +0 -0
- package/studio/dist/assets/KaTeX_Size4-Regular-DWFBv043.ttf +0 -0
- package/studio/dist/assets/KaTeX_Size4-Regular-Dl5lxZxV.woff2 +0 -0
- package/studio/dist/assets/KaTeX_Typewriter-Regular-C0xS9mPB.woff +0 -0
- package/studio/dist/assets/KaTeX_Typewriter-Regular-CO6r4hn1.woff2 +0 -0
- package/studio/dist/assets/KaTeX_Typewriter-Regular-D3Ib7_Hf.ttf +0 -0
- package/studio/dist/assets/Lesson-CYQhrDCZ.js +2 -0
- package/studio/dist/assets/NewCourse-CMpwVRQb.js +952 -0
- package/studio/dist/assets/Progress-2rS19Fur.js +1 -0
- package/studio/dist/assets/Review-SlqK-hjp.js +1 -0
- package/studio/dist/assets/Settings-t42u7n9H.js +1 -0
- package/studio/dist/assets/TutorPanel-DQDWIU7f.js +123 -0
- package/studio/dist/assets/abnfDiagram-WEYOIA3C-jTUmGBuB.js +1 -0
- package/studio/dist/assets/anthropic-iIm2l85r.js +15 -0
- package/studio/dist/assets/arc-Y1ARJVZ4.js +1 -0
- package/studio/dist/assets/architecture-WOLXFQ4H-Ch9Ld_vv.js +1 -0
- package/studio/dist/assets/architectureDiagram-ZHVYKT53-Dy-z6wsy.js +36 -0
- package/studio/dist/assets/array-BifhSqXX.js +1 -0
- package/studio/dist/assets/blockDiagram-RJAE7QA3-2fHVrc6N.js +140 -0
- package/studio/dist/assets/bridge-Cr0q4rLp.js +1 -0
- package/studio/dist/assets/c4Diagram-XDPPPE54-BuuKlG4V.js +38 -0
- package/studio/dist/assets/capstone-DhwBeNqk.js +135 -0
- package/studio/dist/assets/card-store-CVMBc-Pv.js +1 -0
- package/studio/dist/assets/channel-M_JkdHrL.js +1 -0
- package/studio/dist/assets/chunk-2E7WHVMD-lZdQWttk.js +88 -0
- package/studio/dist/assets/chunk-2Q5K7J3B-C1jixKkw.js +1 -0
- package/studio/dist/assets/chunk-4EMNKR2T-C6kbMwke.js +1 -0
- package/studio/dist/assets/chunk-55XCU76K-rkBzkZog.js +1 -0
- package/studio/dist/assets/chunk-5VM5RSS4-ZNzvKenW.js +15 -0
- package/studio/dist/assets/chunk-7S6XSTFO-Skg347QF.js +2 -0
- package/studio/dist/assets/chunk-AQDTSKZB-0pSDBJ23.js +72 -0
- package/studio/dist/assets/chunk-DSNLSHJZ-BaeQDl2i.js +129 -0
- package/studio/dist/assets/chunk-DUW6YSOI-Dgx8z5s3.js +1 -0
- package/studio/dist/assets/chunk-HAGFOTED-BEm00juw.js +62 -0
- package/studio/dist/assets/chunk-HNE4Q36P-DyCR-LvS.js +1 -0
- package/studio/dist/assets/chunk-J5ZVWO5B-oDCd-gWO.js +1 -0
- package/studio/dist/assets/chunk-JWPE2WC7-DVXcaiue.js +1 -0
- package/studio/dist/assets/chunk-NGNAAXSQ-C2Wy9Xmz.js +136 -0
- package/studio/dist/assets/chunk-NQOKRVIF-BNJ9uMmB.js +213 -0
- package/studio/dist/assets/chunk-UHW7PFBP-DqJczBLs.js +1 -0
- package/studio/dist/assets/chunk-VQ5W62QI-CVWYSP5Q.js +1 -0
- package/studio/dist/assets/chunk-WQQL4CDK-DJf0Dx05.js +10 -0
- package/studio/dist/assets/chunk-XXDRQBXY-CnbRkih_.js +1 -0
- package/studio/dist/assets/chunk-Y2CYZVJY-DsF7k-Jl.js +1 -0
- package/studio/dist/assets/chunk-YZO67HFG-BFUm_JHA.js +1 -0
- package/studio/dist/assets/chunk-ZAUX2LTX-C5ETkkSE.js +1 -0
- package/studio/dist/assets/chunk-ZCHMQSOR-WVX9r9PZ.js +2 -0
- package/studio/dist/assets/classDiagram-v2-4MYWR3UA-CI77SpuR.js +217 -0
- package/studio/dist/assets/cose-bilkent-JH36ORCC-DMBAZFnj.js +1 -0
- package/studio/dist/assets/course-export-C8jSPuda.js +1 -0
- package/studio/dist/assets/cynefin-EF2NZ3EQ-CLffmM25.js +1 -0
- package/studio/dist/assets/cynefinDiagram-WF24UDRP-BvLwocOb.js +62 -0
- package/studio/dist/assets/cytoscape.esm-CHBj4VkZ.js +321 -0
- package/studio/dist/assets/dagre-NK4GIZVX-C2nMAVdh.js +4 -0
- package/studio/dist/assets/defaultLocale-BFoDCU3G.js +1 -0
- package/studio/dist/assets/diagram-CBK3MWTC-Bid-pdax.js +24 -0
- package/studio/dist/assets/diagram-I5XIIV2D-DYJeAvzl.js +24 -0
- package/studio/dist/assets/diagram-ODIL2UCW-B06X2r_F.js +30 -0
- package/studio/dist/assets/diagram-PFBEJUXE-CwY--5Rz.js +3 -0
- package/studio/dist/assets/diagram-RJA3I4VV-4SqhH8zw.js +41 -0
- package/studio/dist/assets/diagram-TYUNFSNR-CrW4AIM9.js +200 -0
- package/studio/dist/assets/dist-CumnGVmJ.js +1 -0
- package/studio/dist/assets/ebnfDiagram-V4P3TTPT-xeoCmH-d.js +1 -0
- package/studio/dist/assets/elk-QONTBCTQ-Dadmz6iS.js +27 -0
- package/studio/dist/assets/erDiagram-KYQIGQAA-CSuH0bbF.js +99 -0
- package/studio/dist/assets/error-BTdmRKoB.js +1 -0
- package/studio/dist/assets/errors-BZa_CNHL.js +1 -0
- package/studio/dist/assets/eventmodeling-K75KTNOO-CciVfx3I.js +1 -0
- package/studio/dist/assets/fetch-local-DG3O3hmQ.js +4 -0
- package/studio/dist/assets/flowDiagram-IUGLLWBU-DgNR54qK.js +1 -0
- package/studio/dist/assets/ganttDiagram-R7GPNTJY-C0wtA-2y.js +292 -0
- package/studio/dist/assets/gitGraph-VSP46ZUC-BXoDzaA3.js +1 -0
- package/studio/dist/assets/gitGraphDiagram-PDYL7XHY-vZBlNRPe.js +106 -0
- package/studio/dist/assets/graphlib-DS17s2tU.js +1 -0
- package/studio/dist/assets/index-CS8XPYbB.js +313 -0
- package/studio/dist/assets/index-CVenTTOY.css +2 -0
- package/studio/dist/assets/info-OHQRW6UA-bs2Qpf7P.js +1 -0
- package/studio/dist/assets/infoDiagram-MVDRKAX5-rPJio6-1.js +2 -0
- package/studio/dist/assets/init-C-OQMol4.js +1 -0
- package/studio/dist/assets/ishikawaDiagram-HPEHV2GE-CXf9XFff.js +70 -0
- package/studio/dist/assets/journeyDiagram-BOSHW7O7-C3MSH79o.js +139 -0
- package/studio/dist/assets/js.worker-AD7DjksO.js +4 -0
- package/studio/dist/assets/kanban-definition-FNSA4HC5-Bdh7SB4n.js +89 -0
- package/studio/dist/assets/katex-B_JcIwqj.js +257 -0
- package/studio/dist/assets/katex-BgsA2lO1.css +1 -0
- package/studio/dist/assets/line-CHkoQXJF.js +1 -0
- package/studio/dist/assets/linear-C9iwaMOi.js +1 -0
- package/studio/dist/assets/mermaid-parser.core-Do1oxD1S.js +7 -0
- package/studio/dist/assets/mermaid.core-DgZUD0sU.js +44 -0
- package/studio/dist/assets/mindmap-definition-6OY57UG3-PUaK6oE_.js +98 -0
- package/studio/dist/assets/node.browser-DkpMze_r.js +1 -0
- package/studio/dist/assets/node.browser-HQ5SKBOf.js +1 -0
- package/studio/dist/assets/ollama-bJNp3jaD.js +1 -0
- package/studio/dist/assets/openai-compatible-0tmAyMlN.js +1 -0
- package/studio/dist/assets/ordinal-BDEzSJ7C.js +1 -0
- package/studio/dist/assets/packet-JDAUHWVQ-vf2FtqFr.js +1 -0
- package/studio/dist/assets/path-fybaL0A-.js +1 -0
- package/studio/dist/assets/pegDiagram-ECIUJNBX-NEVrgPTY.js +1 -0
- package/studio/dist/assets/pie-XZMESJXO-BIWydVNZ.js +1 -0
- package/studio/dist/assets/pieDiagram-GNMPY74T-BI9_u6rT.js +39 -0
- package/studio/dist/assets/python.worker-CzTrFdd9.js +24 -0
- package/studio/dist/assets/quadrantDiagram-D57K4MC3-ryNpoBC5.js +7 -0
- package/studio/dist/assets/radar-ABXABTNO-D8TjnvBB.js +1 -0
- package/studio/dist/assets/railroad-I3PHUGI6-BmEDV5kf.js +1 -0
- package/studio/dist/assets/railroad-abnf-LNEFI6M7-Cs_sArMc.js +1 -0
- package/studio/dist/assets/railroad-ebnf-DWYD2UWJ-DYuCq46d.js +1 -0
- package/studio/dist/assets/railroad-peg-JR7BVNR7-BcXSgdMy.js +1 -0
- package/studio/dist/assets/railroadDiagram-Y72NRBL7-DBcc8b2c.js +1 -0
- package/studio/dist/assets/react-B8SKf8RM.js +1 -0
- package/studio/dist/assets/rehype-katex-BfUIq5As.js +259 -0
- package/studio/dist/assets/remark-math-XvZOjmDO.js +5 -0
- package/studio/dist/assets/requirementDiagram-EQYSW5RA-CVcBgM1L.js +84 -0
- package/studio/dist/assets/rolldown-runtime-COiEfhsA.js +1 -0
- package/studio/dist/assets/rough.esm-Dy-Kn_BL.js +1 -0
- package/studio/dist/assets/sankeyDiagram-SY24JHO5-DjZ81hDs.js +40 -0
- package/studio/dist/assets/schemas-BOc2YsOP.js +55 -0
- package/studio/dist/assets/sequenceDiagram-BLEHNHQU-BNwOa2S7.js +169 -0
- package/studio/dist/assets/settings-DhwuyNPU.js +1 -0
- package/studio/dist/assets/sizeCapture-INFHLROL-3uHXrFqA.js +1 -0
- package/studio/dist/assets/spec-nAnsSMkw.js +1 -0
- package/studio/dist/assets/sql-wasm-C1D_RJuy.wasm +0 -0
- package/studio/dist/assets/sql.worker-D7pBHOrq.js +4 -0
- package/studio/dist/assets/src-BWF7jMDv.js +1 -0
- package/studio/dist/assets/stateDiagram-v2-A6IESKWZ-BFWa5lEx.js +291 -0
- package/studio/dist/assets/swimlanes-B3ENRKFQ-LfM_Jg6Z.js +1 -0
- package/studio/dist/assets/swimlanesDiagram-AYQRV4AK-BDmpoiGp.js +8 -0
- package/studio/dist/assets/timeline-definition-JXYKGLGB-BwGzkWgZ.js +120 -0
- package/studio/dist/assets/treeView-D4JQ5SDB-MLk3VuRt.js +1 -0
- package/studio/dist/assets/treemap-SAJKECNS-D8iSjp7L.js +1 -0
- package/studio/dist/assets/useStream-rdsR6A7P.js +1 -0
- package/studio/dist/assets/usecaseDiagram-WPOLBNNX-BqxpaNlT.js +328 -0
- package/studio/dist/assets/vennDiagram-Q3Y3IDCW-CpeUDMhQ.js +34 -0
- package/studio/dist/assets/wardley-7MLQ67FV-tAMbCZAj.js +1 -0
- package/studio/dist/assets/wardleyDiagram-IVAIDKWA-CDJViWzt.js +78 -0
- package/studio/dist/assets/xychartDiagram-4URNHDU4-CwaQrd3_.js +7 -0
- package/studio/dist/index.html +20 -0
- package/studio/dist/preview.html +22 -0
- package/studio/migrations/0001_init.sql +188 -0
- package/studio/migrations/0002_external_ids.sql +20 -0
- package/studio/migrations/0003_course_language.sql +12 -0
- package/studio/migrations/0004_capstone.sql +51 -0
- package/studio/migrations/0005_beta_loop.sql +73 -0
- package/studio/migrations/0006_interactive_exercises.sql +49 -0
- package/studio/src/lib/activity.js +92 -0
- package/studio/src/lib/ai/anthropic.js +109 -0
- package/studio/src/lib/ai/bridge.js +126 -0
- package/studio/src/lib/ai/catalog.js +160 -0
- package/studio/src/lib/ai/config.js +70 -0
- package/studio/src/lib/ai/errors.js +95 -0
- package/studio/src/lib/ai/fetch-local.js +104 -0
- package/studio/src/lib/ai/index.js +194 -0
- package/studio/src/lib/ai/ollama.js +136 -0
- package/studio/src/lib/ai/openai-compatible.js +101 -0
- package/studio/src/lib/ai/provider-utils.js +107 -0
- package/studio/src/lib/ai/sse.js +99 -0
- package/studio/src/lib/ai/status.js +92 -0
- package/studio/src/lib/ai/useStream.js +109 -0
- package/studio/src/lib/beta/metrics.js +147 -0
- package/studio/src/lib/beta/report.js +134 -0
- package/studio/src/lib/capstone-evidence.js +758 -0
- package/studio/src/lib/capstone.js +663 -0
- package/studio/src/lib/chat-store.js +128 -0
- package/studio/src/lib/course-export.js +38 -0
- package/studio/src/lib/course.js +187 -0
- package/studio/src/lib/exercises/journal-entry.js +259 -0
- package/studio/src/lib/exercises/placement.js +31 -0
- package/studio/src/lib/exercises/registry.js +19 -0
- package/studio/src/lib/exercises/spec.js +129 -0
- package/studio/src/lib/i18n/detect.js +162 -0
- package/studio/src/lib/i18n/en/app.json +23 -0
- package/studio/src/lib/i18n/en/betaReport.json +55 -0
- package/studio/src/lib/i18n/en/capstone.json +57 -0
- package/studio/src/lib/i18n/en/common.json +25 -0
- package/studio/src/lib/i18n/en/course.json +27 -0
- package/studio/src/lib/i18n/en/data.json +35 -0
- package/studio/src/lib/i18n/en/durability.json +5 -0
- package/studio/src/lib/i18n/en/errors.json +20 -0
- package/studio/src/lib/i18n/en/exercises.json +55 -0
- package/studio/src/lib/i18n/en/externalEvidence.json +76 -0
- package/studio/src/lib/i18n/en/home.json +18 -0
- package/studio/src/lib/i18n/en/lesson.json +33 -0
- package/studio/src/lib/i18n/en/nav.json +8 -0
- package/studio/src/lib/i18n/en/newCourse.json +51 -0
- package/studio/src/lib/i18n/en/onboarding.json +35 -0
- package/studio/src/lib/i18n/en/playwrightTemplate.json +20 -0
- package/studio/src/lib/i18n/en/practice.json +79 -0
- package/studio/src/lib/i18n/en/provider.json +27 -0
- package/studio/src/lib/i18n/en/providerMeta.json +26 -0
- package/studio/src/lib/i18n/en/reflection.json +17 -0
- package/studio/src/lib/i18n/en/revision.json +52 -0
- package/studio/src/lib/i18n/en/runnerNotice.json +14 -0
- package/studio/src/lib/i18n/en/settings.json +12 -0
- package/studio/src/lib/i18n/en/storage.json +49 -0
- package/studio/src/lib/i18n/en/tutor.json +39 -0
- package/studio/src/lib/i18n/en/workspace.json +50 -0
- package/studio/src/lib/i18n/index.js +144 -0
- package/studio/src/lib/i18n/languages.js +93 -0
- package/studio/src/lib/i18n/vi/app.json +23 -0
- package/studio/src/lib/i18n/vi/betaReport.json +55 -0
- package/studio/src/lib/i18n/vi/capstone.json +57 -0
- package/studio/src/lib/i18n/vi/common.json +25 -0
- package/studio/src/lib/i18n/vi/course.json +27 -0
- package/studio/src/lib/i18n/vi/data.json +35 -0
- package/studio/src/lib/i18n/vi/durability.json +5 -0
- package/studio/src/lib/i18n/vi/errors.json +20 -0
- package/studio/src/lib/i18n/vi/exercises.json +55 -0
- package/studio/src/lib/i18n/vi/externalEvidence.json +76 -0
- package/studio/src/lib/i18n/vi/home.json +18 -0
- package/studio/src/lib/i18n/vi/lesson.json +33 -0
- package/studio/src/lib/i18n/vi/nav.json +8 -0
- package/studio/src/lib/i18n/vi/newCourse.json +51 -0
- package/studio/src/lib/i18n/vi/onboarding.json +35 -0
- package/studio/src/lib/i18n/vi/playwrightTemplate.json +20 -0
- package/studio/src/lib/i18n/vi/practice.json +79 -0
- package/studio/src/lib/i18n/vi/provider.json +27 -0
- package/studio/src/lib/i18n/vi/providerMeta.json +26 -0
- package/studio/src/lib/i18n/vi/reflection.json +17 -0
- package/studio/src/lib/i18n/vi/revision.json +52 -0
- package/studio/src/lib/i18n/vi/runnerNotice.json +14 -0
- package/studio/src/lib/i18n/vi/settings.json +12 -0
- package/studio/src/lib/i18n/vi/storage.json +49 -0
- package/studio/src/lib/i18n/vi/tutor.json +39 -0
- package/studio/src/lib/i18n/vi/workspace.json +50 -0
- package/studio/src/lib/ids.js +10 -0
- package/studio/src/lib/json.js +26 -0
- package/studio/src/lib/markdown.js +74 -0
- package/studio/src/lib/prompts/base.js +139 -0
- package/studio/src/lib/prompts/capstone.js +777 -0
- package/studio/src/lib/prompts/course.js +150 -0
- package/studio/src/lib/prompts/lesson.js +275 -0
- package/studio/src/lib/prompts/practice.js +511 -0
- package/studio/src/lib/prompts/tutor.js +509 -0
- package/studio/src/lib/repo/blocked-adapter.js +69 -0
- package/studio/src/lib/repo/events.js +239 -0
- package/studio/src/lib/repo/idb-adapter.js +226 -0
- package/studio/src/lib/repo/index.js +1315 -0
- package/studio/src/lib/repo/memory-adapter.js +115 -0
- package/studio/src/lib/repo/remote-adapter.js +158 -0
- package/studio/src/lib/repo/schema.js +143 -0
- package/studio/src/lib/repo/select-adapter.js +345 -0
- package/studio/src/lib/router.js +71 -0
- package/studio/src/lib/runner/browser.js +244 -0
- package/studio/src/lib/runner/checks.js +248 -0
- package/studio/src/lib/runner/current-code.js +98 -0
- package/studio/src/lib/runner/esm-cjs.js +109 -0
- package/studio/src/lib/runner/hash.js +34 -0
- package/studio/src/lib/runner/history.js +48 -0
- package/studio/src/lib/runner/index.js +168 -0
- package/studio/src/lib/runner/languages.js +258 -0
- package/studio/src/lib/runner/local.js +139 -0
- package/studio/src/lib/runner/path.js +104 -0
- package/studio/src/lib/runner/skeleton.js +315 -0
- package/studio/src/lib/runner/strip-types.js +134 -0
- package/studio/src/lib/settings.js +399 -0
- package/studio/src/lib/srs.js +39 -0
- package/templates/agent/settings.json +6 -0
- package/templates/claude/plugin.json +139 -0
- package/templates/claude/settings.json +15 -0
- package/templates/cursor/professor.mdc +4 -0
- package/templates/cursor/settings.json +18 -0
- package/templates/gemini/GEMINI.md +30 -0
- package/templates/gemini/settings.json +5 -0
- package/templates/opencode/opencode.json +3 -0
- package/templates/researcher/README.md +61 -0
- package/templates/researcher/settings.json +18 -0
- package/web/client/components.json +15 -0
- package/web/client/index.html +12 -0
- package/web/client/package-lock.json +8732 -0
- package/web/client/package.json +39 -0
- package/web/client/postcss.config.js +6 -0
- package/web/client/src/App.jsx +140 -0
- package/web/client/src/api/client.js +357 -0
- package/web/client/src/components/ChatPanel.jsx +417 -0
- package/web/client/src/components/CommandPills.jsx +50 -0
- package/web/client/src/components/DeprecationBanner.jsx +21 -0
- package/web/client/src/components/ExerciseEditor.jsx +164 -0
- package/web/client/src/components/Header.jsx +119 -0
- package/web/client/src/components/LecturePanel.jsx +342 -0
- package/web/client/src/components/MobileTabSwitcher.jsx +51 -0
- package/web/client/src/components/SplitPane.jsx +42 -0
- package/web/client/src/components/ui/alert.jsx +38 -0
- package/web/client/src/components/ui/badge.jsx +24 -0
- package/web/client/src/components/ui/button.jsx +23 -0
- package/web/client/src/components/ui/select.jsx +74 -0
- package/web/client/src/hooks/useSSE.js +152 -0
- package/web/client/src/hooks/useWebSocket.js +98 -0
- package/web/client/src/index.css +23 -0
- package/web/client/src/lib/utils.js +6 -0
- package/web/client/src/main.jsx +12 -0
- package/web/client/src/utils/markdown.js +50 -0
- package/web/client/tailwind.config.js +8 -0
- package/web/client/vite.config.js +21 -0
- package/web/dist/assets/index-C1W0eXIQ.js +294 -0
- package/web/dist/assets/index-C3OUx70T.css +1 -0
- package/web/dist/index.html +13 -0
- package/web/lecture-archive.js +172 -0
- package/web/legacy-server.js +1277 -0
- package/web/package-lock.json +855 -0
- package/web/package.json +10 -0
- package/web/security.js +1016 -0
- package/web/server.js +390 -0
- package/web/studio-api/agents.js +580 -0
- package/web/studio-api/bridge.js +199 -0
- package/web/studio-api/db.js +66 -0
- package/web/studio-api/guards.js +201 -0
- package/web/studio-api/health.js +538 -0
- package/web/studio-api.js +214 -0
- package/web/studio-db.js +380 -0
- package/web/studio-runner.js +568 -0
|
@@ -0,0 +1,414 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* `skillforce studio --autostart on|off`, `--status` and `--stop` (RON-297).
|
|
3
|
+
*
|
|
4
|
+
* Every launchd, process-list and signal call below uses an argument array and is injectable, so
|
|
5
|
+
* tests never load a real LaunchAgent, never list a real process and never signal one.
|
|
6
|
+
*/
|
|
7
|
+
import { execFileSync } from 'child_process';
|
|
8
|
+
import { existsSync, mkdirSync, rmSync, writeFileSync } from 'fs';
|
|
9
|
+
import { homedir } from 'os';
|
|
10
|
+
import { dirname, isAbsolute, join } from 'path';
|
|
11
|
+
import { maskToken, readTokenFile, tokenFilePath } from '../../web/security.js';
|
|
12
|
+
import {
|
|
13
|
+
isPidAlive,
|
|
14
|
+
logFilePath,
|
|
15
|
+
probeStudioHealth,
|
|
16
|
+
readState,
|
|
17
|
+
removeState,
|
|
18
|
+
} from './studio-state.js';
|
|
19
|
+
|
|
20
|
+
export const LABEL = 'com.ronin-skillforce.studio';
|
|
21
|
+
export const LAUNCH_AGENT_FILE = `${LABEL}.plist`;
|
|
22
|
+
export const UNSUPPORTED_PLATFORM = 'Studio auto-start is only supported on macOS yet.';
|
|
23
|
+
export const STABLE_INSTALL_HINT = 'Install it globally first: npm i -g ronin-skillforce';
|
|
24
|
+
|
|
25
|
+
/**
|
|
26
|
+
* Absolute plist path. launchd only reads `~/Library/LaunchAgents`, so this uses the OS home and
|
|
27
|
+
* never `PROFESSOR_HOME`.
|
|
28
|
+
* @param {{ home?: string }} [opts]
|
|
29
|
+
* @returns {string}
|
|
30
|
+
*/
|
|
31
|
+
export function launchAgentPath({ home = homedir() } = {}) {
|
|
32
|
+
return join(home, 'Library', 'LaunchAgents', LAUNCH_AGENT_FILE);
|
|
33
|
+
}
|
|
34
|
+
|
|
35
|
+
/** Escape the five XML entities; a home directory may legitimately contain `&`. */
|
|
36
|
+
function xmlEscape(value) {
|
|
37
|
+
return String(value)
|
|
38
|
+
.replace(/&/g, '&')
|
|
39
|
+
.replace(/</g, '<')
|
|
40
|
+
.replace(/>/g, '>');
|
|
41
|
+
}
|
|
42
|
+
|
|
43
|
+
/** Show a path under the user's home with `~` so status output stays short. */
|
|
44
|
+
export function displayPath(file, { home = homedir() } = {}) {
|
|
45
|
+
const prefix = `${home}/`;
|
|
46
|
+
return file.startsWith(prefix) ? `~/${file.slice(prefix.length)}` : file;
|
|
47
|
+
}
|
|
48
|
+
|
|
49
|
+
/**
|
|
50
|
+
* Build the LaunchAgent plist. `ProgramArguments` point at the absolute Node executable and the
|
|
51
|
+
* absolute CLI entry, never at `npx`: launchd has no shell PATH, no network and no version pinning.
|
|
52
|
+
*
|
|
53
|
+
* @param {{ nodePath: string, cliPath: string, port: number, apiPort: number,
|
|
54
|
+
* professorHome?: string, pathEnv?: string, logPath: string }} opts
|
|
55
|
+
* @returns {string}
|
|
56
|
+
*/
|
|
57
|
+
export function buildLaunchAgentPlist({
|
|
58
|
+
nodePath,
|
|
59
|
+
cliPath,
|
|
60
|
+
port,
|
|
61
|
+
apiPort,
|
|
62
|
+
professorHome,
|
|
63
|
+
pathEnv,
|
|
64
|
+
logPath,
|
|
65
|
+
} = {}) {
|
|
66
|
+
for (const [name, value] of Object.entries({ nodePath, cliPath, logPath })) {
|
|
67
|
+
if (typeof value !== 'string' || value === '') {
|
|
68
|
+
throw new Error(`Cannot build the LaunchAgent plist: ${name} is missing.`);
|
|
69
|
+
}
|
|
70
|
+
}
|
|
71
|
+
for (const [name, value] of Object.entries({ port, apiPort })) {
|
|
72
|
+
if (!Number.isInteger(Number(value)) || Number(value) <= 0) {
|
|
73
|
+
throw new Error(`Cannot build the LaunchAgent plist: ${name} is not a port.`);
|
|
74
|
+
}
|
|
75
|
+
}
|
|
76
|
+
|
|
77
|
+
const args = [
|
|
78
|
+
nodePath,
|
|
79
|
+
cliPath,
|
|
80
|
+
'studio',
|
|
81
|
+
'--no-open',
|
|
82
|
+
'--strict-port',
|
|
83
|
+
'--port',
|
|
84
|
+
String(port),
|
|
85
|
+
'--api-port',
|
|
86
|
+
String(apiPort),
|
|
87
|
+
];
|
|
88
|
+
const env = [];
|
|
89
|
+
if (professorHome) {
|
|
90
|
+
env.push(` <key>PROFESSOR_HOME</key>`, ` <string>${xmlEscape(professorHome)}</string>`);
|
|
91
|
+
}
|
|
92
|
+
if (pathEnv) {
|
|
93
|
+
env.push(` <key>PATH</key>`, ` <string>${xmlEscape(pathEnv)}</string>`);
|
|
94
|
+
}
|
|
95
|
+
|
|
96
|
+
return [
|
|
97
|
+
'<?xml version="1.0" encoding="UTF-8"?>',
|
|
98
|
+
'<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" ' +
|
|
99
|
+
'"http://www.apple.com/DTDs/PropertyList-1.0.dtd">',
|
|
100
|
+
'<plist version="1.0">',
|
|
101
|
+
'<dict>',
|
|
102
|
+
' <key>Label</key>',
|
|
103
|
+
` <string>${LABEL}</string>`,
|
|
104
|
+
' <key>ProgramArguments</key>',
|
|
105
|
+
' <array>',
|
|
106
|
+
...args.map((arg) => ` <string>${xmlEscape(arg)}</string>`),
|
|
107
|
+
' </array>',
|
|
108
|
+
...(env.length
|
|
109
|
+
? [' <key>EnvironmentVariables</key>', ' <dict>', ...env, ' </dict>']
|
|
110
|
+
: []),
|
|
111
|
+
' <key>RunAtLoad</key>',
|
|
112
|
+
' <true/>',
|
|
113
|
+
' <key>KeepAlive</key>',
|
|
114
|
+
' <dict>',
|
|
115
|
+
' <key>SuccessfulExit</key>',
|
|
116
|
+
' <false/>',
|
|
117
|
+
' </dict>',
|
|
118
|
+
' <key>ThrottleInterval</key>',
|
|
119
|
+
' <integer>30</integer>',
|
|
120
|
+
' <key>StandardOutPath</key>',
|
|
121
|
+
` <string>${xmlEscape(logPath)}</string>`,
|
|
122
|
+
' <key>StandardErrorPath</key>',
|
|
123
|
+
` <string>${xmlEscape(logPath)}</string>`,
|
|
124
|
+
'</dict>',
|
|
125
|
+
'</plist>',
|
|
126
|
+
'',
|
|
127
|
+
].join('\n');
|
|
128
|
+
}
|
|
129
|
+
|
|
130
|
+
/**
|
|
131
|
+
* Refuse to install an agent that points into a throwaway path. A npx cache entry is deleted
|
|
132
|
+
* whenever npm feels like it, which would leave a LaunchAgent that fails at every login.
|
|
133
|
+
*
|
|
134
|
+
* @param {{ cliPath: string, execPath?: string }} opts
|
|
135
|
+
* @returns {{ cliPath: string, nodePath: string }}
|
|
136
|
+
*/
|
|
137
|
+
export function assertStableInstall({ cliPath, execPath = process.execPath } = {}) {
|
|
138
|
+
if (typeof cliPath !== 'string' || !isAbsolute(cliPath) || !existsSync(cliPath)) {
|
|
139
|
+
throw new Error(
|
|
140
|
+
`Studio auto-start needs a stable install: the CLI entry point (${cliPath || 'unknown'}) ` +
|
|
141
|
+
`was not found. ${STABLE_INSTALL_HINT}`
|
|
142
|
+
);
|
|
143
|
+
}
|
|
144
|
+
const unstable = [cliPath, execPath].find((value) => String(value).includes('/_npx/'));
|
|
145
|
+
if (unstable) {
|
|
146
|
+
throw new Error(
|
|
147
|
+
`Studio auto-start needs a stable install: this copy runs from the npx cache ` +
|
|
148
|
+
`(${unstable}), which can be deleted at any time. ${STABLE_INSTALL_HINT}`
|
|
149
|
+
);
|
|
150
|
+
}
|
|
151
|
+
return { cliPath, nodePath: execPath };
|
|
152
|
+
}
|
|
153
|
+
|
|
154
|
+
/**
|
|
155
|
+
* The three launchctl calls this feature needs, with argv arrays and no shell.
|
|
156
|
+
* @param {{ exec?: Function, uid?: number, platform?: string }} [opts]
|
|
157
|
+
* @returns {{ bootstrap: (plistPath: string) => object, bootout: () => object,
|
|
158
|
+
* kill: (signal?: string) => object }}
|
|
159
|
+
*/
|
|
160
|
+
export function createLaunchctl({
|
|
161
|
+
exec = execFileSync,
|
|
162
|
+
uid = typeof process.getuid === 'function' ? process.getuid() : null,
|
|
163
|
+
platform = process.platform,
|
|
164
|
+
} = {}) {
|
|
165
|
+
const run = (args) => {
|
|
166
|
+
try {
|
|
167
|
+
const stdout = exec('launchctl', args, { stdio: 'pipe', encoding: 'utf8' });
|
|
168
|
+
return { ok: true, stdout: String(stdout || ''), stderr: '' };
|
|
169
|
+
} catch (err) {
|
|
170
|
+
return {
|
|
171
|
+
ok: false,
|
|
172
|
+
stdout: String(err?.stdout || ''),
|
|
173
|
+
stderr: String(err?.stderr || err?.message || ''),
|
|
174
|
+
};
|
|
175
|
+
}
|
|
176
|
+
};
|
|
177
|
+
const domain = `gui/${uid}`;
|
|
178
|
+
return {
|
|
179
|
+
domain,
|
|
180
|
+
bootstrap: (plistPath) => run(['bootstrap', domain, plistPath]),
|
|
181
|
+
bootout: () => run(['bootout', `${domain}/${LABEL}`]),
|
|
182
|
+
kill: (signal = 'SIGTERM') => run(['kill', signal, `${domain}/${LABEL}`]),
|
|
183
|
+
};
|
|
184
|
+
}
|
|
185
|
+
|
|
186
|
+
/** True for the "already loaded" answers `launchctl bootstrap` gives on a re-install. */
|
|
187
|
+
function isAlreadyLoaded(result) {
|
|
188
|
+
const text = `${result.stderr} ${result.stdout}`;
|
|
189
|
+
return /already|Bootstrap failed: 5|Input\/output error/i.test(text);
|
|
190
|
+
}
|
|
191
|
+
|
|
192
|
+
/**
|
|
193
|
+
* Install (or re-install) the LaunchAgent: log directory, plist, then `launchctl bootstrap`.
|
|
194
|
+
* Re-running is idempotent — the previous registration is removed first and retried once.
|
|
195
|
+
*
|
|
196
|
+
* @param {{ port: number, apiPort: number, cliPath: string, execPath?: string,
|
|
197
|
+
* env?: Record<string,string|undefined>, userHome?: string, platform?: string,
|
|
198
|
+
* exec?: Function, uid?: number }} opts
|
|
199
|
+
* @returns {{ plistPath: string, logPath: string }}
|
|
200
|
+
*/
|
|
201
|
+
export function enableAutostart({
|
|
202
|
+
port,
|
|
203
|
+
apiPort,
|
|
204
|
+
cliPath,
|
|
205
|
+
execPath = process.execPath,
|
|
206
|
+
env = process.env,
|
|
207
|
+
userHome = homedir(),
|
|
208
|
+
platform = process.platform,
|
|
209
|
+
exec = execFileSync,
|
|
210
|
+
uid,
|
|
211
|
+
} = {}) {
|
|
212
|
+
if (platform !== 'darwin') throw new Error(UNSUPPORTED_PLATFORM);
|
|
213
|
+
|
|
214
|
+
const install = assertStableInstall({ cliPath, execPath });
|
|
215
|
+
const plistPath = launchAgentPath({ home: userHome });
|
|
216
|
+
const logPath = logFilePath({ env });
|
|
217
|
+
mkdirSync(dirname(logPath), { recursive: true });
|
|
218
|
+
mkdirSync(dirname(plistPath), { recursive: true });
|
|
219
|
+
|
|
220
|
+
const plist = buildLaunchAgentPlist({
|
|
221
|
+
nodePath: install.nodePath,
|
|
222
|
+
cliPath: install.cliPath,
|
|
223
|
+
port,
|
|
224
|
+
apiPort,
|
|
225
|
+
professorHome: env.PROFESSOR_HOME,
|
|
226
|
+
pathEnv: env.PATH,
|
|
227
|
+
logPath,
|
|
228
|
+
});
|
|
229
|
+
writeFileSync(plistPath, plist, { mode: 0o644 });
|
|
230
|
+
|
|
231
|
+
const launchctl = createLaunchctl({ exec, uid, platform });
|
|
232
|
+
launchctl.bootout();
|
|
233
|
+
let result = launchctl.bootstrap(plistPath);
|
|
234
|
+
if (!result.ok && isAlreadyLoaded(result)) {
|
|
235
|
+
launchctl.bootout();
|
|
236
|
+
result = launchctl.bootstrap(plistPath);
|
|
237
|
+
}
|
|
238
|
+
if (!result.ok) {
|
|
239
|
+
throw new Error(
|
|
240
|
+
`launchctl bootstrap failed for ${plistPath}: ${result.stderr.trim() || 'unknown error'}`
|
|
241
|
+
);
|
|
242
|
+
}
|
|
243
|
+
return { plistPath, logPath };
|
|
244
|
+
}
|
|
245
|
+
|
|
246
|
+
/**
|
|
247
|
+
* Remove the LaunchAgent and its plist. Safe to call when nothing was installed.
|
|
248
|
+
* @param {{ userHome?: string, platform?: string, exec?: Function, uid?: number }} [opts]
|
|
249
|
+
* @returns {{ plistPath: string, removed: boolean }}
|
|
250
|
+
*/
|
|
251
|
+
export function disableAutostart({
|
|
252
|
+
userHome = homedir(),
|
|
253
|
+
platform = process.platform,
|
|
254
|
+
exec = execFileSync,
|
|
255
|
+
uid,
|
|
256
|
+
} = {}) {
|
|
257
|
+
if (platform !== 'darwin') throw new Error(UNSUPPORTED_PLATFORM);
|
|
258
|
+
|
|
259
|
+
const plistPath = launchAgentPath({ home: userHome });
|
|
260
|
+
createLaunchctl({ exec, uid, platform }).bootout();
|
|
261
|
+
const removed = existsSync(plistPath);
|
|
262
|
+
if (removed) rmSync(plistPath, { force: true });
|
|
263
|
+
return { plistPath, removed };
|
|
264
|
+
}
|
|
265
|
+
|
|
266
|
+
/**
|
|
267
|
+
* @param {{ userHome?: string }} [opts]
|
|
268
|
+
* @returns {{ enabled: boolean, plistPath: string }}
|
|
269
|
+
*/
|
|
270
|
+
export function autostartInfo({ userHome = homedir() } = {}) {
|
|
271
|
+
const plistPath = launchAgentPath({ home: userHome });
|
|
272
|
+
return { enabled: existsSync(plistPath), plistPath };
|
|
273
|
+
}
|
|
274
|
+
|
|
275
|
+
/**
|
|
276
|
+
* Collect what `--status` reports. Reads only: no file or token is created, nothing is started.
|
|
277
|
+
*
|
|
278
|
+
* @param {{ env?: Record<string,string|undefined>, userHome?: string, kill?: Function,
|
|
279
|
+
* fetchImpl?: typeof fetch }} [opts]
|
|
280
|
+
* @returns {Promise<{ status: 'running'|'unhealthy'|'stopped', state: object|null,
|
|
281
|
+
* token: string|null, autostart: { enabled: boolean, plistPath: string },
|
|
282
|
+
* logPath: string }>}
|
|
283
|
+
*/
|
|
284
|
+
export async function collectStatus({
|
|
285
|
+
env = process.env,
|
|
286
|
+
userHome = homedir(),
|
|
287
|
+
kill = process.kill,
|
|
288
|
+
fetchImpl = globalThis.fetch,
|
|
289
|
+
} = {}) {
|
|
290
|
+
const state = readState({ env });
|
|
291
|
+
const token = readTokenFile(tokenFilePath(env));
|
|
292
|
+
const alive = Boolean(state) && isPidAlive(state.pid, { kill });
|
|
293
|
+
const answering =
|
|
294
|
+
alive && (await probeStudioHealth({ apiUrl: state.apiUrl, token, fetchImpl }));
|
|
295
|
+
const status = answering ? 'running' : alive ? 'unhealthy' : 'stopped';
|
|
296
|
+
return {
|
|
297
|
+
status,
|
|
298
|
+
state,
|
|
299
|
+
token,
|
|
300
|
+
autostart: autostartInfo({ userHome }),
|
|
301
|
+
logPath: logFilePath({ env }),
|
|
302
|
+
};
|
|
303
|
+
}
|
|
304
|
+
|
|
305
|
+
/**
|
|
306
|
+
* Render the `--status` report. The token appears in full only inside the pairing URL; the separate
|
|
307
|
+
* token line is masked.
|
|
308
|
+
*
|
|
309
|
+
* @param {{ status: string, state: object|null, token: string|null, pairingUrl?: string|null,
|
|
310
|
+
* autostart: { enabled: boolean, plistPath: string }, logPath: string,
|
|
311
|
+
* userHome?: string }} report
|
|
312
|
+
* @returns {string}
|
|
313
|
+
*/
|
|
314
|
+
export function formatStatus({
|
|
315
|
+
status,
|
|
316
|
+
state,
|
|
317
|
+
token,
|
|
318
|
+
pairingUrl,
|
|
319
|
+
autostart,
|
|
320
|
+
logPath,
|
|
321
|
+
userHome = homedir(),
|
|
322
|
+
}) {
|
|
323
|
+
const autostartLine = ` Autostart: ${autostart.enabled ? `on (${LABEL})` : 'off'}`;
|
|
324
|
+
const logLine = ` Log: ${displayPath(logPath, { home: userHome })}`;
|
|
325
|
+
|
|
326
|
+
if (status === 'running' && state) {
|
|
327
|
+
return [
|
|
328
|
+
`Professor Studio: running (pid ${state.pid})`,
|
|
329
|
+
` Studio URL: ${state.studioUrl}`,
|
|
330
|
+
pairingUrl
|
|
331
|
+
? ` Pairing URL: ${pairingUrl}`
|
|
332
|
+
: ' Pairing URL: (no token yet — run: skillforce studio --rotate-token)',
|
|
333
|
+
` Token: ${maskToken(token)}`,
|
|
334
|
+
autostartLine,
|
|
335
|
+
logLine,
|
|
336
|
+
].join('\n');
|
|
337
|
+
}
|
|
338
|
+
if (status === 'unhealthy' && state) {
|
|
339
|
+
return [
|
|
340
|
+
`Professor Studio: not answering (pid ${state.pid} from studio.json)`,
|
|
341
|
+
` Studio URL: ${state.studioUrl}`,
|
|
342
|
+
autostartLine,
|
|
343
|
+
logLine,
|
|
344
|
+
].join('\n');
|
|
345
|
+
}
|
|
346
|
+
return ['Professor Studio: not running', autostartLine, logLine].join('\n');
|
|
347
|
+
}
|
|
348
|
+
|
|
349
|
+
/** The `ps -o command=` line for a pid, or `null` when the process is gone. */
|
|
350
|
+
function readCommandLine(pid, { exec = execFileSync } = {}) {
|
|
351
|
+
try {
|
|
352
|
+
const command = exec('ps', ['-o', 'command=', '-p', String(pid)], {
|
|
353
|
+
stdio: 'pipe',
|
|
354
|
+
encoding: 'utf8',
|
|
355
|
+
});
|
|
356
|
+
return String(command || '').trim() || null;
|
|
357
|
+
} catch {
|
|
358
|
+
return null;
|
|
359
|
+
}
|
|
360
|
+
}
|
|
361
|
+
|
|
362
|
+
/** A pid is ours only when its command line is a Studio CLI run. */
|
|
363
|
+
export function isStudioCommand(command) {
|
|
364
|
+
if (!command) return false;
|
|
365
|
+
return command.includes('cli.js') && command.includes('studio');
|
|
366
|
+
}
|
|
367
|
+
|
|
368
|
+
/**
|
|
369
|
+
* Stop Studio: the LaunchAgent first when it is installed, otherwise the pid from `studio.json`.
|
|
370
|
+
* A pid whose command line is not a Studio CLI run is never signalled.
|
|
371
|
+
*
|
|
372
|
+
* @param {{ env?: Record<string,string|undefined>, userHome?: string, platform?: string,
|
|
373
|
+
* exec?: Function, uid?: number, kill?: Function }} [opts]
|
|
374
|
+
* @returns {Promise<{ stopped: boolean, via?: 'launchctl'|'pid', pid?: number|null,
|
|
375
|
+
* reason?: 'not_running'|'stale', refused?: boolean, command?: string|null }>}
|
|
376
|
+
*/
|
|
377
|
+
export async function stopStudio({
|
|
378
|
+
env = process.env,
|
|
379
|
+
userHome = homedir(),
|
|
380
|
+
platform = process.platform,
|
|
381
|
+
exec = execFileSync,
|
|
382
|
+
uid,
|
|
383
|
+
kill = process.kill,
|
|
384
|
+
} = {}) {
|
|
385
|
+
const state = readState({ env });
|
|
386
|
+
const { plistPath } = autostartInfo({ userHome });
|
|
387
|
+
|
|
388
|
+
if (existsSync(plistPath)) {
|
|
389
|
+
const result = createLaunchctl({ exec, uid, platform }).kill('SIGTERM');
|
|
390
|
+
if (result.ok) {
|
|
391
|
+
removeState({ env });
|
|
392
|
+
return { stopped: true, via: 'launchctl', pid: state?.pid ?? null };
|
|
393
|
+
}
|
|
394
|
+
}
|
|
395
|
+
|
|
396
|
+
if (!state) return { stopped: false, reason: 'not_running' };
|
|
397
|
+
if (!isPidAlive(state.pid, { kill })) {
|
|
398
|
+
removeState({ env });
|
|
399
|
+
return { stopped: false, reason: 'stale', pid: state.pid };
|
|
400
|
+
}
|
|
401
|
+
|
|
402
|
+
const command = readCommandLine(state.pid, { exec });
|
|
403
|
+
if (!isStudioCommand(command)) {
|
|
404
|
+
return { stopped: false, refused: true, pid: state.pid, command };
|
|
405
|
+
}
|
|
406
|
+
|
|
407
|
+
try {
|
|
408
|
+
kill(state.pid, 'SIGTERM');
|
|
409
|
+
} catch (err) {
|
|
410
|
+
if (err?.code !== 'ESRCH') throw err;
|
|
411
|
+
}
|
|
412
|
+
removeState({ env });
|
|
413
|
+
return { stopped: true, via: 'pid', pid: state.pid };
|
|
414
|
+
}
|
|
@@ -0,0 +1,159 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Background state for `skillforce studio` (RON-297): the `studio.json` snapshot that `--status`
|
|
3
|
+
* and `--stop` read, plus the two probes they need (pid liveness, one-shot health check).
|
|
4
|
+
*
|
|
5
|
+
* Nothing here writes during a read path: `writeState` is only called by a running server, and
|
|
6
|
+
* `readState`/`probeStudioHealth` never create a file or a token.
|
|
7
|
+
*/
|
|
8
|
+
import { mkdirSync, readFileSync, renameSync, rmSync, writeFileSync } from 'fs';
|
|
9
|
+
import { homedir } from 'os';
|
|
10
|
+
import { dirname, join } from 'path';
|
|
11
|
+
|
|
12
|
+
export const STATE_FILE = 'studio.json';
|
|
13
|
+
export const LOG_FILE = 'studio.log';
|
|
14
|
+
|
|
15
|
+
/**
|
|
16
|
+
* Resolve `${PROFESSOR_HOME:-~/.professor}` without consulting the real home when one is supplied.
|
|
17
|
+
* @param {{ env?: Record<string,string|undefined>, home?: string }} [opts]
|
|
18
|
+
* @returns {string}
|
|
19
|
+
*/
|
|
20
|
+
export function professorHome({ env = process.env, home } = {}) {
|
|
21
|
+
return home || env.PROFESSOR_HOME || join(homedir(), '.professor');
|
|
22
|
+
}
|
|
23
|
+
|
|
24
|
+
/**
|
|
25
|
+
* Absolute path of the background state file.
|
|
26
|
+
* @param {{ env?: Record<string,string|undefined>, home?: string }} [opts]
|
|
27
|
+
* @returns {string}
|
|
28
|
+
*/
|
|
29
|
+
export function stateFilePath({ env = process.env, home } = {}) {
|
|
30
|
+
return join(professorHome({ env, home }), STATE_FILE);
|
|
31
|
+
}
|
|
32
|
+
|
|
33
|
+
/**
|
|
34
|
+
* Absolute path of the background log file used by the LaunchAgent.
|
|
35
|
+
* @param {{ env?: Record<string,string|undefined>, home?: string }} [opts]
|
|
36
|
+
* @returns {string}
|
|
37
|
+
*/
|
|
38
|
+
export function logFilePath({ env = process.env, home } = {}) {
|
|
39
|
+
return join(professorHome({ env, home }), 'logs', LOG_FILE);
|
|
40
|
+
}
|
|
41
|
+
|
|
42
|
+
/** True for the payload Studio's `/api/studio/health` returns; anything else is a foreign app. */
|
|
43
|
+
export function isStudioHealthPayload(body) {
|
|
44
|
+
return Boolean(body) && body.ok === true && typeof body.version === 'string';
|
|
45
|
+
}
|
|
46
|
+
|
|
47
|
+
/** A recorded state is usable only with a numeric pid; anything else is treated as absent. */
|
|
48
|
+
function isStateShape(value) {
|
|
49
|
+
return Boolean(value) && typeof value === 'object' && Number.isInteger(value.pid);
|
|
50
|
+
}
|
|
51
|
+
|
|
52
|
+
/**
|
|
53
|
+
* Write the state file atomically (temp file + rename, mode `0600`).
|
|
54
|
+
* @param {{ pid: number, port: number, apiPort: number, studioUrl: string, apiUrl: string,
|
|
55
|
+
* startedAt: string }} state
|
|
56
|
+
* @param {{ env?: Record<string,string|undefined>, home?: string }} [opts]
|
|
57
|
+
* @returns {string} the file path
|
|
58
|
+
*/
|
|
59
|
+
export function writeState(state, { env = process.env, home } = {}) {
|
|
60
|
+
const file = stateFilePath({ env, home });
|
|
61
|
+
mkdirSync(dirname(file), { recursive: true });
|
|
62
|
+
const tmp = `${file}.${process.pid}.tmp`;
|
|
63
|
+
try {
|
|
64
|
+
writeFileSync(tmp, `${JSON.stringify(state, null, 2)}\n`, { mode: 0o600 });
|
|
65
|
+
renameSync(tmp, file);
|
|
66
|
+
} catch (err) {
|
|
67
|
+
try {
|
|
68
|
+
rmSync(tmp, { force: true });
|
|
69
|
+
} catch {
|
|
70
|
+
/* ignore */
|
|
71
|
+
}
|
|
72
|
+
throw err;
|
|
73
|
+
}
|
|
74
|
+
return file;
|
|
75
|
+
}
|
|
76
|
+
|
|
77
|
+
/**
|
|
78
|
+
* Read the state file. A missing, malformed or truncated file reads as `null`.
|
|
79
|
+
* @param {{ env?: Record<string,string|undefined>, home?: string }} [opts]
|
|
80
|
+
* @returns {{ pid: number, port: number, apiPort: number, studioUrl: string, apiUrl: string,
|
|
81
|
+
* startedAt: string } | null}
|
|
82
|
+
*/
|
|
83
|
+
export function readState({ env = process.env, home } = {}) {
|
|
84
|
+
try {
|
|
85
|
+
const parsed = JSON.parse(readFileSync(stateFilePath({ env, home }), 'utf-8'));
|
|
86
|
+
return isStateShape(parsed) ? parsed : null;
|
|
87
|
+
} catch {
|
|
88
|
+
return null;
|
|
89
|
+
}
|
|
90
|
+
}
|
|
91
|
+
|
|
92
|
+
/**
|
|
93
|
+
* Remove the state file; missing is not an error.
|
|
94
|
+
* @param {{ env?: Record<string,string|undefined>, home?: string }} [opts]
|
|
95
|
+
* @returns {boolean} true when a file was removed
|
|
96
|
+
*/
|
|
97
|
+
export function removeState({ env = process.env, home } = {}) {
|
|
98
|
+
try {
|
|
99
|
+
rmSync(stateFilePath({ env, home }), { force: true });
|
|
100
|
+
return true;
|
|
101
|
+
} catch {
|
|
102
|
+
return false;
|
|
103
|
+
}
|
|
104
|
+
}
|
|
105
|
+
|
|
106
|
+
/**
|
|
107
|
+
* True when the pid exists. `EPERM` counts as alive: the process exists but is not ours.
|
|
108
|
+
* @param {number} pid
|
|
109
|
+
* @param {{ kill?: (pid: number, signal?: number) => void }} [opts]
|
|
110
|
+
* @returns {boolean}
|
|
111
|
+
*/
|
|
112
|
+
export function isPidAlive(pid, { kill = process.kill } = {}) {
|
|
113
|
+
if (!Number.isInteger(pid) || pid <= 0) return false;
|
|
114
|
+
try {
|
|
115
|
+
kill(pid, 0);
|
|
116
|
+
return true;
|
|
117
|
+
} catch (err) {
|
|
118
|
+
return err?.code === 'EPERM';
|
|
119
|
+
}
|
|
120
|
+
}
|
|
121
|
+
|
|
122
|
+
/**
|
|
123
|
+
* A timeout signal when the runtime has one; `undefined` keeps the probe working on older Nodes.
|
|
124
|
+
*/
|
|
125
|
+
function abortTimeout(ms) {
|
|
126
|
+
try {
|
|
127
|
+
return typeof AbortSignal?.timeout === 'function' ? AbortSignal.timeout(ms) : undefined;
|
|
128
|
+
} catch {
|
|
129
|
+
return undefined;
|
|
130
|
+
}
|
|
131
|
+
}
|
|
132
|
+
|
|
133
|
+
/**
|
|
134
|
+
* One `GET /api/studio/health` against the loopback bridge. Any answer that is not a Studio health
|
|
135
|
+
* payload (404, foreign JSON, timeout, refused connection) is `false`; it never throws.
|
|
136
|
+
*
|
|
137
|
+
* @param {{ apiUrl: string, token?: string|null, fetchImpl?: typeof fetch,
|
|
138
|
+
* timeoutMs?: number }} opts
|
|
139
|
+
* @returns {Promise<boolean>}
|
|
140
|
+
*/
|
|
141
|
+
export async function probeStudioHealth({
|
|
142
|
+
apiUrl,
|
|
143
|
+
token,
|
|
144
|
+
fetchImpl = globalThis.fetch,
|
|
145
|
+
timeoutMs = 1500,
|
|
146
|
+
} = {}) {
|
|
147
|
+
const headers = token ? { 'X-Studio-Token': token } : {};
|
|
148
|
+
try {
|
|
149
|
+
const res = await fetchImpl(`${apiUrl}/api/studio/health`, {
|
|
150
|
+
headers,
|
|
151
|
+
signal: abortTimeout(timeoutMs),
|
|
152
|
+
});
|
|
153
|
+
if (!res || !res.ok) return false;
|
|
154
|
+
const body = await res.json().catch(() => null);
|
|
155
|
+
return isStudioHealthPayload(body);
|
|
156
|
+
} catch {
|
|
157
|
+
return false;
|
|
158
|
+
}
|
|
159
|
+
}
|