summaryrefslogtreecommitdiff
path: root/docs/superpowers/specs/2026-09-20-artifact-pipeline-design.md
Commit message (Collapse)AuthorAgeFilesLines
* feat(pipeline): add runnable artifact pipeline incrementSomhairle H. Marisol2026-09-211-12/+20
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | [Change Nature] - This commit adds the first runnable increment of the F# artifact pipeline: CLI, server, frontend bundle, stage fixture, and tests. It is feature work, not a bug fix. [New Capability] - CLI `run` executes the three-step Blender fixture through the process bridge and writes GLBs, step logs, events, and a manifest; `verify` validates a manifest without Blender. - Server exposes run start, run-scoped SSE, artifact manifest/file routes, and serves the Fable frontend from its build output. - Frontend starts runs, follows run-scoped SSE progress, and links the artifact manifest on completion. [Implementation] - Shared layer holds domain, run state, replay, and artifact contracts; Modeling holds the pipeline, 120s bridge timeout, and result-file protocol; stage/blender/fixture.py owns geometry in Python (bpy owns geometry, F# owns orchestration). - Fable bundle is regenerated into public/ and copied by the server project; solution includes all projects with warnings-as-errors. - README documents build, Fable, server, interpreter/env, fixture limitations, and current verification status. [Impact] - Verified: 40/40 solution tests pass; Release build 0 warnings/errors; real CLI run with bpy 5.0.1 produced 3 GLBs, 3 logs, and a verify-clean manifest; isolated-port server smoke flow succeeded. - Not yet verified: browser end-to-end behavior and production fidelity. Artifacts and caches are gitignored.
* docs(modeling): define artifact pipeline contractSomhairle H. Marisol2026-09-201-0/+236
[Change Nature] - This commit adds the approved design contract for the modeling pipeline. [Documentation Update] - Define shared lifecycle events, artifact manifests, immutable filesystem rules, and Blender bridge protocol. - Define CLI, server, browser, verification, and cgit publication boundaries. [Update Plan] - Use this contract to implement the shared F# library, stage fixture, CLI, and server adapter. - Preserve the existing replay/browser scaffold while adding verified artifact execution. [Impact] - Documentation only. Runtime behavior is unchanged.