docs(mapgen-studio): redesign workstream — frame, research, audit, target architecture

[mateicanavra]

docs(mapgen-studio): redesign workstream — frame, research, audit, target architecture

Open the MapGen Studio redesign initiative: a top-1%, data-driven React 19 rebuild
that decomposes the 3,010-line App.tsx, introduces a native effect-orpc server on
Bun, oRPC-native TanStack Query + Zustand on the client, and full canonical
shadcn/ui + Tailwind v4 — with behavior parity for map-gen, Deck.gl, recipes, and
the live-game control loop.

Artifacts:

• 00-GOAL.md — framed objective, user decisions, falsifier, parity hard core
• research/01-orpc-effect-bun.md, research/02-orpc-tanstack-zustand.md
• audit/03-component-architecture, 04-design-system, 05-server-contracts, 06-typescript-rigor
• architecture/10-target-architecture.md, 11-slice-plan.md
• apps/mapgen-studio/system.md — extracted current design language

Co-Authored-By: Claude Opus 4.8 noreply@anthropic.com

feat(studio-server): A1 — scaffold @civ7/studio-server + oRPC contracts (16 endpoints)

Contract-first oRPC package (zod I/O) covering all 16 current /api endpoints
across civ7., civ7.live., runInGame., mapConfigs., studio.* — the typed corpus
the client will consume. No business logic yet (services/router land in A2/A3).

Parity captured as contract-level invariants: live.status embedded-{error} 200
shape, non-uniform error status codes, runInGame.start .catchall so the
assertNoRawControlFields security scan can still reject raw control keys, and the
status-404 serverInstanceId/serverStartedAt restart-detection echo. App-anchored
outputs (run-in-game status, save/deploy status, setup catalog) reproduced
field-for-field from features/*/status.ts without importing app code.

Verified: bunx turbo run check --filter=@civ7/studio-server — clean (0 errors).

Co-Authored-By: Claude Opus 4.8 noreply@anthropic.com

docs(mapgen-studio): PAUSE redesign — live-control substrate correction

User correction: no FireTuner reads; consume the actual latest live-control code.
Verified the new effect-oRPC control substrate (control-oRPC router +
Civ7IntelligenceBridge) is NOT in this base (packages/civ7-control-orpc is empty)
— it lives in the 570-branch live-control stack still being consolidated, and the
mapgen-studio Studio link is itself being rebuilt there. Studio reads live state
today via @civ7/direct-control (vite.config.ts:32), the surface being superseded.

Decision: full pause. Re-baseline off main once the consolidated control-oRPC
work merges. Server (Phase A) + data (Phase B) + live-coupled decomposition are
blocked; their server-contract audit (05) and architecture §1 are marked
provisional. Design-system / component-architecture / TS-rigor audits and
client-pattern research remain valid. Resume conditions recorded in 00-GOAL.md.

Co-Authored-By: Claude Opus 4.8 noreply@anthropic.com

docs(mapgen-studio): add post-merge resume prompt for redesign workstream

Self-contained handoff packet (framing-design: objective-framing × audience-export
for a post-compaction recipient). Lets the user re-enter the paused redesign after
the control-oRPC substrate merges to main: read-first docs, confirmed decisions,
realign+re-baseline checklist (consume control-oRPC, no FireTuner), Phase A→G plan,
hard core + falsifier. Includes a guard to STOP if main lacks the substrate.

Co-Authored-By: Claude Opus 4.8 noreply@anthropic.com

docs(mapgen-studio): reframe redesign — normative FRAME, un-pause, design-system-first

• Add FRAME.md: normative operating model + guardrails (Graphite never-submit,
  design-system-first, OpenSpec-backed slices, live-control seam vs wait-for-merge,
  parity hard core, falsifier).
• Reset controlling goal in 00-GOAL.md (create-goal fallback record); supersede
  the PAUSED/wait-for-merge sections; ACTIVE status ledger in design-system-first
  phase order (P1 design system → P7 hand over unsubmitted stack).

Co-Authored-By: Claude Opus 4.8 noreply@anthropic.com

[github-actions]

Railway preview (MapGen Studio): not provisioned for this PR.

Policy (Graphite stacks): previews are created only for the top-of-stack PR by default.

• To force a preview for this PR: add label railway-preview
• To suppress a preview: add label no-railway-preview

Debug: {"isClosed":true,"isFork":false,"suppress":false,"force":false,"isTopOfStack":true,"hasToken":true,"draft":false}

[mateicanavra]

• docs(mapgen-studio): tuner-session workstream frame — Effect-scoped shared tuner session (strict valid) #1653
• feat(mapgen-studio): standalone Bun daemon owns the server surface — vite is frontend-only; legacy /api retired outright #1652
• refactor(mapgen-studio): control-oRPC mount on the fetch adapter behind a Connect shim #1651
• refactor(mapgen-studio): extract studio engines out of vite.config into src/server/studio (verbatim move, no topology change) #1650
• docs(mapgen-studio): bun-server workstream frame — P5b cutover proposal/design/tasks/spec (strict valid) #1649
• fix(mapgen): projection step phases carry their subject domain, not 'gameplay' #1648
• refactor(mapgen-studio): recipe-dag oRPC mount — fetch adapter, per-request ssrLoadModule, shared node⇄web bridge #1647
• feat(mapgen-studio): add Pipeline stage view with Map|Pipeline switcher, TanStack Query DAG data layer, and token-driven PipelineStage chrome #1646
• docs(mapgen-studio): add pipeline DAG stage-view workstream record, proposal, design, spec deltas, and tasks #1645
• docs(mapgen-studio): mark X6 and X7 as executed with hex-convention audit and world-console map-params revision notes #1644
• feat(mapgen-studio): remove Resources control from World console, codify pipeline-input zone boundary rule #1643
• fix(studio): render game's odd-R hex geometry for both tile spaces and retune tile border to graphite #1642
• docs(mapgen-studio): record Pass-5 design fixes (toolbar v2, tile orientation, grid icon, flash guard, pre-run cursor) #1641
• fix(mapgen-studio): apply flash guard to :root for between-navigations clear color #1640
• feat(mapgen-studio): disable canvas controller and grab cursor pre-run #1639
• fix(mapgen-studio): odd-Q flat-top orientation, canonical hex-space lattice, and tile-mesh contract #1638
• fix(mapgen-studio): replace empty grid toggle placeholder with Grid3x3 lucide icon #1637
• feat(mapgen-studio): toolbar architecture v2 — top = Game bar, bottom = World/Map console with History affordance #1636
• docs(mapgen-studio): add Pass 5 design-fixes spec (toolbar architecture v2, tile orientation, canvas affordances) #1635
• feat(mapgen-studio): add collapsible config objects with per-object header anatomy, sticky auto-expand-on-scroll toggle, and useConfigCollapse hook #1634
• feat(mapgen-studio): icon-only autoplay and run-in-game buttons, add Explore placeholder #1633
• feat(studio): dock game console beneath world bar, remove it from footer #1632
• docs(mapgen-studio): add Pass-4 design fixes — game console dock, console icon contract, and config collapse #1631
• feat(explore-toolbar): regroup into VIEW/LAYER clusters and relocate debug toggle to data list header #1630
• feat(mapgen-studio): extract GameConsole component and split footer into centered studio console and right-docked game console #1629
• feat(mapgen-studio): replace border-l indent ladder with page-tint well surface and codify 4/8/12px rhythm tiers #1628
• docs(mapgen-studio-no-hardcoded-defaults): mark all tasks as executed #1627
• fix(mapgen-studio): replace global reset with body-only flash guard and align theme bootstrap with useTheme system-preference resolution #1626
• docs(mapgen-studio): pass-3 frame — spacing substrate repair, config surface elevation, footer console split, explore toolbar grouping, and no-hardcoded-defaults law #1625
• fix(mapgen-studio): sync .dark class to theme preference at runtime #1624
• fix(mapgen-studio): add rAF backstop timeout to prevent viz commits being starved in backgrounded documents #1623
• feat(mapgen-studio): wrap Render and Space toolbar options in segmented controls #1622
• feat(mapgen-studio): remove Run button from RecipePanel footer, promote Save & Deploy to full-width, and expand resource mode labels #1621
• fix(mapgen-studio): split field label to foreground tier and gate error live regions on rawErrors #1620
• feat(mapgen-studio): pin docks between header and footer with bottom constraint, pointer-events pass-through, and LAYOUT geometry update #1619
• docs(mapgen-studio): add pass-2 design-fix frame, five OpenSpec slices (layout geometry, form hierarchy, run console, explore toolbar, first-run visibility) #1618
• feat(studio): a11y fixes — Radix save menu, rjsf error association, skip-link target, and group disclosure names #1617
• refactor(mapgen-studio): remove legacy createTheme/lightMode prop threading and dead field primitives; migrate rjsf chrome to design-system tokens #1616
• refactor(mapgen-studio): centralize ORPCError data cast, drop dead success fallbacks, and narrow router to contract-derived type #1615
• feat(mapgen-studio): migrate authoring/run state to Zustand persist stores, reads to TanStack Query, and fix runInGame contract selectedConfig.id optional #1614
• feat(mapgen-studio): token-driven chrome, a11y landmarks/live-regions/aria, and OptionSelect adapter #1613
• fix(mapgen-studio): wrap AppFooter test in TooltipProvider and add @ alias to vitest config #1612
• feat(mapgen-studio): decompose App.tsx into StudioProviders/StudioShell + chrome tree #1611
• feat(mapgen-studio): migrate client transport to oRPC, add TanStack Query client, and introduce Zustand viewStore #1610
• feat(studio-server): implement effect-orpc router, mount /rpc, and add typed client with TanStack Query utils #1609
• refactor(studio): decompose App.tsx non-React corpus into feature modules and shared utilities #1608
• refactor(studio): reskin shell chrome onto design tokens, shadcn primitives, and sonner toast #1607
• feat(mapgen-studio): add canonical token-driven shadcn primitive library with Radix UI and sonner #1606
• docs(studio): add control-oRPC seam doc, thin LiveControlPort adapter design, and re-baseline server-contract audit + target architecture for live-read surface #1605
• feat(mapgen-studio): migrate to Tailwind v4, establish tokenized design system, shadcn scaffolding, and .dark class theming #1604
• docs(mapgen-studio): redesign workstream — frame, research, audit, target architecture #1603 👈 (View in Graphite)
• main

This stack of pull requests is managed by Graphite. Learn more about stacking.