Phase 2: Studio-Core + MCP Tools (S1-S18) + Theme/Component Coverage

[mikewolfd]

Motivation

Each studio-core helper addition ships with its MCP tool in the same pass. Theme and component full coverage runs in parallel. This phase delivers MCP full parity with the Project API — the prerequisite for chat integration (Phase 4B).

Parent epic: #9 — Unified Authoring Architecture

Scope

Pass 2a: Catalogs + Widget Compatibility (S1-S5)

• S1-S5: Type metadata, field type catalog, widget compatibility matrix
• New MCP tool: formspec_widget (hint resolution, compatibility)

Pass 2b: FEL Editing Support (S6-S8)

• S6-S8: FEL editing, humanization, function catalog display
• Expand MCP tool: formspec_fel (editing, validation, highlighting, autocomplete)

Pass 2c: Parsing + Defaults + Structure (S9-S13)

• S9-S13: Input parsing, field defaults, sanitization, placement logic, widget mapping
• Expand MCP tools: formspec_update, formspec_structure
• formspec_structure batch ops: wrapItemsInGroup, wrapInLayoutComponent, batchDelete/Duplicate, reorder

Pass 2d: Preview + Sample Data (S14-S16)

• S14-S16: Document normalization, sample data generation, engine seeding
• Expand MCP tool: formspec_preview (sample data generation)

Pass 2e: Audit + Classification (S17-S18)

• S17-S18: Item classification, bind behavior enumeration
• Expand MCP tool: formspec_audit

Pass 2f: Theme Full Coverage

• Breakpoints, platform, responsive region overrides
• Stylesheets (external CSS URIs), document metadata
• Expand MCP tool: formspec_theme

Pass 2g: Component Full Coverage

• when conditional rendering, custom component registry
• Tokens (Tier 3 token map), responsive per-component overrides
• Stable node id, document-level breakpoints
• Expand MCP tool: formspec_component

Acceptance Criteria

• Every Project helper method has a corresponding MCP tool operation
• Studio-originated business logic (field-helpers, fel-editor-utils, humanize, tree-helpers, etc.) deleted and replaced with studio-core/core imports
• MCP tool annotations set correctly (readOnlyHint, destructiveHint)
• Integration tests for each MCP tool operation
• npm run check:deps passes

Layer

Management Instance (Layers 2-4)

Dependencies

• Phase 1 (Phase 1: Foundation — Engine + Core (E1-E3, C1-C11) #10) — core query layer must exist before MCP tools can wrap it