Phase 3: New Document Types + Remaining MCP Tools

[mikewolfd]

Motivation

Full spec coverage of document types and operations that do not exist yet: locale, ontology, references, migration, changelog, response management, plus expanded mapping, bind, shape, publish, and composition tools.

Parent epic: #9 — Unified Authoring Architecture

Scope

Pass 3a-3c: New Document Types

• 3a: Locale document support in studio-core + formspec_locale MCP tool (string CRUD, context variants, fallback cascade, FEL interpolation validation)
• 3b: Ontology document support in studio-core + formspec_ontology MCP tool (concept bindings, vocabulary bindings, alignments, JSON-LD context)
• 3c: References document support in studio-core + formspec_reference MCP tool (bound reference CRUD, referenceDefs, URI schemes)

Pass 3d-3e: Migration + Mapping

• 3d: Migration rule support + formspec_migration MCP tool (rule CRUD, transform types, defaults for new fields)
• 3e: Mapping full coverage — multi-mapping CRUD, adapters (JSON/XML/CSV), direction, autoMap, autoGenerateMappingRules. Expand formspec_mapping

Pass 3f-3g: Fine-Grained Bind + Shape Composition

• 3f: Bind fine-grained properties (default, whitespace, excludedValue, disabledDisplay, constraintMessage, per-bind nonRelevantBehavior). Expand formspec_behavior / formspec_update
• 3g: Shape composition (and/or/not/xone), updateValidation, activeWhen, timing, context, shape code. Expand formspec_behavior

Pass 3h-3i: Version Lifecycle + Composition

• 3h: Version lifecycle enforcement (status transitions per S6.3, versionAlgorithm, semver validation), sidecar version coordination. Expand formspec_publish
• 3i: $ref composition management (add/remove $ref on groups, keyPrefix, preview assembled, validate targets). New formspec_composition tool

Pass 3j-3l: Changelog, Response, Cross-Document Audit

• 3j: Changelog document support + formspec_changelog tool (diffFromBaseline, structured change objects, impact classification, migration hint generation)
• 3k: Response/validation management + formspec_response tool (test response CRUD, external validation injection, MIP state queries)
• 3l: Cross-document consistency checking + accessibility audit. Expand formspec_audit (definition <-> theme <-> component <-> locale <-> ontology <-> references)

Acceptance Criteria

• Studio-core handlers exist for each new document type
• MCP tools with full operation coverage for each document type
• Spec prose inconsistencies noted in the architecture spec resolved (requiredMessage removal, route message/extensions in S4.7.1, direction in S4.1.1)
• Integration tests for all new tools

Layer

Management Instance (Layers 2-4)

Dependencies

• Phase 1 (Phase 1: Foundation — Engine + Core (E1-E3, C1-C11) #10) — core query layer
• Phase 2 (Phase 2: Studio-Core + MCP Tools (S1-S18) + Theme/Component Coverage #11) — existing MCP tool patterns established