Handbook
Forge Intelligence Studio — system reference
Local Electron + Python stack that serves a React SPA and read-mostly APIs over generated registries (intelligence_audit.json, lmeta_lcdl_gap_report.json, integration_cases.yaml) plus session dual-wiki under sessions/.
Updated
Intent
Local Electron + Python stack that serves a React SPA and read-mostly APIs over generated registries (intelligence_audit.json, lmeta_lcdl_gap_report.json, integration_cases.yaml) plus session dual-wiki under sessions/.
Visual hash: Fis. Design contract: Fis-intelligence-studio.md.
Module map
| Path | Role |
|---|---|
scripts/start-intelligence-studio.sh |
Launcher (--build, --server-only) |
desktop/ |
Electron shell |
studio-ui/ |
Vite React SPA → studio-server/static/studio/ |
studio-server/studio_server.py |
HTTP API + static files on port 9791 |
scripts/sync-ks-charts.sh |
Vendors KS forge-data-charts stack |
src/forge_intelligence/studio/creativity_sim.py |
Deterministic Creativity Lab loop |
studio-ui/src/labels.ts |
Human label maps (depth, next step, coverage metrics) |
HTTP API
| Method | Path | Source |
|---|---|---|
| GET | /health |
Service identity |
| GET | /api/intelligences |
registries/intelligence_audit.json |
| GET | /api/maturity-heatmap |
Audit → KS chart envelope |
| GET | /api/coverage |
registries/lmeta_lcdl_gap_report.json |
| GET | /api/cases |
registries/integration_cases.yaml |
| POST | /api/cases/{id}/run |
compose_from_yaml + execute_plan |
| GET | /api/sessions |
sessions/*/machine/session.json |
| GET | /api/sessions/{id} |
read_session() machine surface |
| GET | /api/sessions/{id}/human |
sessions/{id}/human/report.md |
| POST | /api/creativity/run |
run_creativity_sim() |
KS chart load order
Heatmap mounts require chart modules before forge-data-charts.js:
core.js → legacy.js → kpi.js → forge-data-charts.js (+ CSS). See studio-ui/src/ksCharts.ts.
Verification
export PYTHONPATH=src
python3 -m pytest tests/test_studio_server_api.py tests/test_creativity_sim.py -q
./scripts/fi-studio-ux-pdca/check-phase-gate.sh all
node workbench/studio-ux-crawl-v2.mjs # requires studio on :9791
Oracle: docs/design/studio/oracles/Fis.json.
UX remediation PDCA
Phases U00–U11 in docs/prompts/fi-studio-ux-pdca/; gates via scripts/fi-studio-ux-pdca/check-phase-gate.sh.