Li World Studio — master production plan¶

Status: Active (rev. 1 — 2026-05-29)
Audience: Architects, agents, UX builders, package owners
Maturity: ~18% product (interface-heavy, algorithm-light) — see §1

Canonical stack (precedence):

1. This document — hub, modes, agent flows, WP index, DoD
2. studio-full-implementation-plan.md — 68 WPs, batches, stub inventory
3. world-studio-vision.md — why, architecture, program phases
4. PH-world-studio-program.md — cross-program tracker (sync with §1.3)
5. RFCs under specs/ when non-stub; package READMEs for API truth

Policy: Native Li only for product demo — .cursor/rules/li-studio-demo-native-only.mdc. HTML under deploy/studio-demo/ is marketing-only until an explicit li-render embed path lands (§12).

Table of contents¶

1. Executive summary
2. Product surface — what Studio is
3. Interaction modes & chrome layout
4. Viewport / canvas architecture
5. Agentic system — modes, tools, loops
6. Li integration map
7. Program registry & phase graph
8. Work packages by track
9. PH-UX — SOTA rubric & design system
10. PH-PUB — export & publication pipeline
11. Runtime profiles & vertical DoD
12. Future: optional HTML / web viewport embed
13. Execution mechanics
14. Parallel dispatch & milestone calendar
15. Living sync rules

1. Executive summary¶

1.1 One sentence¶

Li World Studio is an agent-native, proof-first editor on Li Engine: one native executable (li-studio-demo → shipped li-studio) composes dock, outliner, viewport, timeline, inspector, and agent chrome from li-ui / li-gui / li-render, drives seven sim profiles through li-sim, and exposes lis mcp li-engine + @cursor/sdk for Cursor-class agent loops — every ship path runs lic build.

1.2 Maturity rollup¶

1.3 Honesty rule¶

lic check composable green = interface landed, not product parity. Do not score UX-14 or demo capture as “native product” when pixels come from CPU host or HTML mocks.

1.4 North-star metrics¶

2. Product surface — what Studio is¶

2.1 Native executable (not HTML)¶

Build/run:

./scripts/build.sh
lic build packages/li-studio/src/main.li -o build/li-studio-demo
STUDIO_DEMO_PROFILE=sim_scientific STUDIO_SHELL_DEMO_BUILD_RUN=1 LIG_HOST_PRESENT=1 \
  ./scripts/studio-shell-demo-present-loop.sh

2.2 Editor regions (stable layout)¶

┌─────────────────────────────────────────────────────────────────────────┐
│ Topbar: project name · profile chip · play controls · agent invoke      │
├──┬──────────┬──────────────────────────────────────────────┬───────────┤
│  │ Outliner │              VIEWPORT (canvas)                 │ Inspector │
│D │ scene    │  grid · selection · sim viz · particle tiers   │ selection │
│o │ hierarchy│  HUD: FPS · particle count · honesty flags     │ fields    │
│c │          ├──────────────────────────────────────────────┤           │
│k │          │ Agent strip: task · tool trace · cancel       │           │
│  │          ├──────────────────────────────────────────────┤           │
│  │          │ Timeline: tracks · playhead · frame counter     │           │
└──┴──────────┴──────────────────────────────────────────────┴───────────┘

Packages owning regions:

2.3 Project on disk¶

my-project/
  world.li          # Scene + sim config (text, git-diffable)
  studio.toml       # [engine] profile, determinism, export
  assets/           # glTF, textures, assay CSV, etc.
  compliance.toml   # Optional CRITICAL tier overrides
  publish/          # Generated figures + bundle (PH-PUB)

3. Interaction modes & chrome layout¶

Studio is one shell with mode overlays — not separate apps. Modes change which panels are prominent, which tools are allowlisted, and which sim hook runs. All modes share the same compose tree; mode state lives in StudioShellCompose.mode (to be formalized in WP-UX-15).

3.1 Mode matrix¶

3.2 Mode transitions¶

3.3 Keyboard-first (UX-09)¶

Bridge: studio-shell-input-bridge.md — SDL/mock → studio_handle_studio_key.

3.4 Adaptive layouts (drug / role)¶

studio.adaptive (WP-DRUG-03): panel sets per LITL stage — discovery, docking, MD, QM, assay, optimize. Inspector fields and agent hints follow studio_adaptive_drug_inspector. MCP: studio_adaptive_layout(role, stage).

4. Viewport / canvas architecture¶

4.1 Layer stack (bottom → top)¶

4.2 Present paths (honesty)¶

4.3 Viewport display controls (landed partial)¶

MCP + runtime hooks (PH-UX viewport display):

Smokes: studio_viewport_display.li, studio_viewport_error.li.

4.4 Particle & perf tiers (scientific)¶

Registry: benchmarks/competitive/studio-ui.toml → ./scripts/bench-studio-viewport-perf.sh.

4.5 Canvas work packages¶

5. Agentic system — modes, tools, loops¶

5.1 Agent interaction modes¶

Required chrome (UX-06, studio-agentic-ux skill): idle / running / blocked / failed / done; step progress; cancel; context label; error strip + retry; last action; undo when safe.

5.2 MCP tool registry (AGENT-0 — done)¶

Canonical: studio-mcp-tools.md. 11 tools — all mutations gated on lic_build.

5.3 apply_patch loop (WP-AG-04)¶

RFC: studio-cursor-sdk-rfc.md

User prompt
  → studio_ai_complete (lillm local OR Cursor SDK cloud)
  → unified diff for workspace .li paths
  → studio_ai_apply_patch
  → lic check --format=json
  → on error: feed diagnostics to LLM (max N retries)
  → on green: lic build
  → refresh viewport / sim_step / save checkpoint
  → agent strip → done

Security: tool allowlist; patches scoped to session root; no shell from MCP args; secrets via guard-secrets.sh.

5.4 Agent packages¶

5.5 Agent work packages¶

5.6 Eval & regression¶

6. Li integration map¶

6.1 Compiler & proof¶

6.2 Engine stack¶

li-studio (shell)
  → li-ui (layout IR, tokens, focus rings)
  → li-gui (paint ops)
  → li-render + lig (viewport)
  → li-scene + li-world (entities, save/load)
  → li-sim + li-sim-* (profiles, step, replay)
  → li-physics-* (kernels)
  → li-chem / li-ml-rl (QM, env pools)

6.3 Profile → package routing¶

Smoke: studio_sim_step_by_profile.li, studio_vertical_profile_roundtrip.li.

6.4 External agent hosts¶

7. Program registry & phase graph¶

7.1 Programs¶

Tracker sync: PH-world-studio-program.md.

7.2 Phase dependency graph¶

flowchart TB
  P[PH-PLATFORM Wave A-C]
  GD[PH-GD]
  UX[PH-UX]
  SIM[PH-SIM]
  HW[PH-HW]
  AG[PH-AGENT]
  P --> SIM
  SIM --> GD
  HW --> GD
  GD --> UX
  HW --> ML[PH-ML]
  SIM --> ROBO[PH-ROBO]
  SIM --> SCI[PH-SCI]
  SCI --> AM[PH-AM]
  SCI --> DRUG[PH-DRUG]
  GD --> DRUG
  AG --> DRUG
  P --> QM[PH-QM]
  HW --> QM
  GD --> VOX[PH-VOXEL]
  UX --> PUB[PH-PUB]
  SCI --> PUB
  AG --> GD

7.3 Recommended delivery waves¶

8. Work packages by track¶

Full tables: studio-full-implementation-plan.md §3 (68 WPs).

8.1 Summary index¶

8.2 New WPs proposed (this master plan)¶

Add rows to full implementation plan when scheduled.

8.3 Critical path (serial)¶

WP-PLAT-02 (Lean build)
  → WP-GD-05 (wgpu viewport)
  → WP-UX-14 (native_pixels truth)
  → WP-AG-03 (MCP server)
  → WP-AG-04 (patch loop)
  → WP-PUB-03 (repro bundle)

9. PH-UX — SOTA rubric & design system¶

Canonical rubric: competitive-intel/ui-ux-by-dimension.md.

9.1 Performance gates¶

9.2 UX dimensions (score 0–3 per iteration)¶

9.3 Design tokens¶

Source: docs/design/studio-design-tokens.toml
Generated: studio-design-system.generated.md
Module target: studio.design (WP-UX-12).

Anti-patterns: dashboard sprawl; hidden agent failures; HTML passed as product; spinner without step list; shifting layout during agent stream.

9.4 UX builder loop¶

Wave 1 (studio-ux-00…10): done in YAML. Wave 2 (11…19): merge into YAML when resuming loop.

10. PH-PUB — export & publication pipeline¶

10.1 Export types¶

10.2 Publish mode flow (≤3 clicks target)¶

1. User: Publish → Figure (or Export print job)
2. Studio: run lic build (blocking overlay if fail)
3. Snapshot: world + sim checksum + git hash + lic version
4. Render: vector raster / slice / table writers
5. Write: publish/ + audit log entry (PH-COMPLY)
6. Optional: open folder / send to printer (trusted tier)

10.3 Reproducibility manifest (WP-PUB-03)¶

{
  "lic_version": "...",
  "engine_profile": "sim_scientific",
  "determinism_tier": 2,
  "sim_checksum": "...",
  "world_sha256": "...",
  "figures": ["figures/fig1.svg"],
  "data": ["data/traj.h5"]
}

RFC to expand: publication-export-rfc.md (currently stub — flesh from this §).

11. Runtime profiles & vertical DoD¶

Per-profile done criteria: studio-full-implementation-plan.md §6.

Recording honesty: VERTICALS-RECORDING.md.

12. Future: optional HTML / web viewport embed¶

Not a substitute for native studio (li-studio-demo-native-only.mdc).

When prioritized, embed path must:

1. Live under li-render or packages/li-studio-webview with explicit def API
2. Same honesty flags as wgpu (UX-14)
3. Smokes + bench hooks — no ad-hoc deploy/*.html product demos
4. Agent tools unchanged — still lic check / lic build on Li sources

Until then: marketing HTML stays in deploy/studio-demo/ with mock banner.

13. Execution mechanics¶

13.1 Proof commands (daily)¶

lic check packages/li-studio/li-tests/smoke/studio_shell_demo.li
lic check packages/li-studio/li-tests/smoke/studio_vertical_profile_roundtrip.li
lic check packages/li-studio/li-tests/smoke/studio_sim_step_by_profile.li
lic check packages/li-studio/li-tests/smoke/studio_mcp_tools.li
LIG_HOST_PRESENT=1 ./scripts/studio-verticals-capture-native.sh
./scripts/bench-studio-viewport-perf.sh

13.2 Agent lanes¶

13.3 Demo & capture policy¶

13.4 CI gates¶

13.5 World Studio master plan loop (goal-directed)¶

Plan YAML: docs/superpowers/plans/2026-05-29-world-studio-master-plan-loop.md
Goal file: data/goal-directed-sprints/world-studio-master-plan.md

14. Parallel dispatch & milestone calendar¶

14.1 Immediate parallel batch (from full plan)¶

Batch 1: WP-AL-02, WP-SCI-02, WP-RL-01, WP-GAME-01, WP-ROBO-02, WP-DRUG-02, WP-UX-05, WP-AG-02, WP-VOX-01, WP-PUB-01

14.2 Suggested calendar (quarters)¶

Adjust when Wave A (WP-PLAT-02) slips.

15. Living sync rules¶

1. WP state change → update studio-full-implementation-plan.md §1.3 and PH-world-studio-program.md.
2. workload_class change → bump benchmarks/competitive/verticals.toml updated.
3. RFC stub → partial → expand matching file under specs/ when WP leaves stub.
4. New MCP tool → studio-mcp-tools.md + smoke + studio_mcp_tool_count.
5. Vision §3 baseline → refresh when GD-1/SIM-0 land (remove false “gaps”).
6. Mode / agent FSM change → update §3 and §5 in this doc + WP-UX-15.

Appendix A — RFC index¶

Appendix B — Related documents¶

Maintainers: Treat this file as the navigation hub. Deep WP tables stay in studio-full-implementation-plan.md; do not duplicate state in two places — link and summarize here.