Files
bquarkz 1471b427f1
Test / Tests and coverage occurred while executing withChecks step.
Intrepid/Prometeu/Studio/pipeline/pr-master There was a failure building this commit
feat(studio): deliver asset authoring and automation workflows
Add shared human/task asset batches with reviewed atomic publication, explicit
reference rebinds, ownership inspection and qualified glyph/scene budgets.
Expose the same authoring and capacity results through Assets and MCP.

Deliver isolated guest test targets, retained visual evidence and immutable
runtime lifecycle/control observations. Preserve provider qualification and
installed authoring examples alongside the completed discussion lessons.

Close AGD-106 coordination and the delivered discussion workflows through
housekeeping, updating lesson references and preserving qualification limits.
Sound remains outside the asset delivery wave.

Validation: 579 module tests and 31 additional desktop, process and installed
checks passed; native glyph/scene 16/17 boundaries qualified. Discussion
validation passed after housekeeping.
2026-11-11 01:21:25 +00:00
..

Studio Specs

Owner: studio. Canonical source: docs/specs/studio.

This directory contains the normative Studio specification set.

Purpose

Specs define the official Studio contract.

They exist to stabilize:

  • the application shell,
  • workspace responsibilities,
  • interaction flows,
  • service and event integration expectations,
  • UX behavior that implementation should preserve.

Expected Format

The exact structure may vary by document, but a Studio spec should usually contain:

  1. Title
  2. Status
  3. Scope or Applies To
  4. Purpose
  5. Authority and Precedence
  6. Normative Inputs
  7. Core Rules
  8. Non-Goals
  9. Exit Criteria

Writing Rules

  • Write in normative language.
  • Integrate only decisions that have already been closed.
  • Keep design exploration and option analysis out of the spec body.
  • Preserve clear boundaries between shell, workspace, and integration specs.

Upstream Rule

Specs should normally be fed by:

  1. agendas that frame the open Studio topic,
  2. decisions that close the product or interaction choice,
  3. plans that define propagation,
  4. then spec integration.

If a spec edit would require guessing unresolved UI behavior, stop and surface the missing decision first.

Current Corpus

The current Studio core corpus is:

  1. 1. Studio Shell and Workspace Layout Specification.md
  2. 2. Studio UI Foundations Specification.md
  3. 3. Studio Components Module Specification.md
  4. 4. Assets Workspace Specification.md
  5. 8. Project-Local Studio State Specification.md
  6. 9. Studio Core and Adapter Architecture Specification.md
  7. 10. DEV and Automation Specification.md
  8. 11. MCP Tools and Project Knowledge Contract.md

Reading Order

Recommended order:

  1. shell and workspace layout;
  2. shared UI foundations;
  3. components module policy;
  4. assets workspace behavior;
  5. project-local Studio state behavior;
  6. Studio Core, adapter, composition, and external integration boundaries;
  7. DEV authority, document handoff, automation operations/captures and phased integration gates;
  8. MCP transport/tool schemas and project/language knowledge contracts.

Current Wave Notes

The embedded Studio code-editor stack was removed by DEC-0031.

Normative reminders:

  • the accepted Studio workspace corpus is Assets, Debug, Shipper, and DEV; the DEV implementation follows DEC-0060's phased delivery;
  • project-local Studio session state remains normative and is owned by StudioProjectSession;
  • DEC-0060 authorizes an external coding agent using native file tools and the existing project LSP through MCP; it does not reinstate the embedded editor or authorize a replacement language-service architecture;
  • the Studio backend is exposed through neutral API contracts shared by JavaFX and the local MCP adapter, without duplicated authority or orchestration;
  • Spring Boot remains the desktop composition root with the narrow DEC-0060 local MCP HTTP exception; Spring Modulith still verifies the JavaFX-free p.studio.core boundary;
  • p.studio.Container, AppContainer, and the mixed prometeu-studio module are not valid final architecture.

Integrated MCP connection

DEC-0061 revises the baseline with Studio-owned mcp --project mode, grant-time project discovery, scoped HTTP credentials, one-time scaffold/preparation and a stable installation with bundled Java. Specs 8–11 define the lifecycle and transport boundaries; spec 1 defines project creation. PLN-0140 is complete; automated results and user-confirmed manual acceptance are consolidated in LSN-0077. The earlier HTTP evidence was not substituted for these gates. The embedded terminal remains separate.

See the specification guide for compiler, language and provider boundaries.