Skip to content
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions blueprints/features/view_composition.blueprint.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,3 @@
---
feature_name: view_composition
status: approved
Expand All @@ -12,9 +12,9 @@

## Status

**Approved.** The human owner approved the reviewed design at [`7a78e7e`](https://github.com/MachineWisdomAI/saga-a2ui/blob/7a78e7eae99285174a11c62d43c1f0035658ec96/blueprints/features/view_composition.blueprint.md) (commit [`7a78e7eae99285174a11c62d43c1f0035658ec96`](https://github.com/MachineWisdomAI/saga-a2ui/commit/7a78e7eae99285174a11c62d43c1f0035658ec96)), proposed in [PR #237](https://github.com/MachineWisdomAI/saga-a2ui/pull/237) and merged into `main` at `4d70df2d001511050d3dff578c3885ce2557058b`. This records that decision only; it approves no code head. The earlier design approvals stay in the history: the baseline ([`db83e84a`](https://github.com/MachineWisdomAI/saga-a2ui/blob/db83e84a7d8d6d9527c5ab350472e82809afd609/blueprints/features/view_composition.blueprint.md)), the revision ([`4b1215a4`](https://github.com/MachineWisdomAI/saga-a2ui/blob/4b1215a4d588f537e93e8a4099cdfc5268a26ab3/blueprints/features/view_composition.blueprint.md)) and the correction ([`49e39bdb`](https://github.com/MachineWisdomAI/saga-a2ui/blob/49e39bdb434f5848ded9c042e425c5cefe735b31/blueprints/features/view_composition.blueprint.md)). The correction is implemented at `MachineWisdomAI/saga-a2ui@18153793795d4ecfc12d2785d96422d2e397a3b2` via [PR #234](https://github.com/MachineWisdomAI/saga-a2ui/pull/234). Blueprint `7a78e7eae99285174a11c62d43c1f0035658ec96` is partially implemented at `MachineWisdomAI/saga-a2ui@6b2aabf8a73e47347f70ade99d7584227c6e943b`: the renderer update-contract and Lit session-default repair (layer B), via [PR #238](https://github.com/MachineWisdomAI/saga-a2ui/pull/238) and [independent review](https://github.com/MachineWisdomAI/saga-a2ui/pull/238#pullrequestreview-5617059507). Affected renderer, type-contract and example checks passed, as did all four current CI checks on the reviewed head `cfdf45a1cf048d2034b6d445d13fbb39800b41fe`. Blueprint `7a78e7eae99285174a11c62d43c1f0035658ec96` is also partially implemented at `MachineWisdomAI/saga-a2ui@3a37b200e44ba36fa785202d1b63498a4ac70be1`: core's neutral `DeliveredResult`, the MCP mapping, the definition's single result reader and removal of `classifyResult`, via [PR #240](https://github.com/MachineWisdomAI/saga-a2ui/pull/240) and [independent review](https://github.com/MachineWisdomAI/saga-a2ui/pull/240#pullrequestreview-5618100272). Verification includes both packed card-stack module graphs and the unchanged 42-case Chromium result matrix, plus definition, mapping, export and type checks; all four latest CI checks passed on reviewed head `3d3cad3266e1eb0f96c26745411fc8893869c749`. Blueprint `7a78e7eae99285174a11c62d43c1f0035658ec96` is also partially implemented at `MachineWisdomAI/saga-a2ui@d465ab394f801c8a6e800af738438b7dbf6133da`: the stack-only public consumer repair, via [PR #242](https://github.com/MachineWisdomAI/saga-a2ui/pull/242) and [independent review](https://github.com/MachineWisdomAI/saga-a2ui/pull/242#pullrequestreview-5619017679). Each stack's main entry re-exports the catalog, schema and action names the maintained consumers use, plus `StartError`, `StartMisuse` and `ErrorPhase`; the five starters and the examples' stack views use those exports. Independent verification passed the affected export, module-graph, consumer, guide and five-starter checks, root and renderer/stack typechecks, strict packed React and Lit stack-only installs with framework peers and singleton runtimes, and a separate MCP server-only install and compile. Components and Markdown remain expected installed transitives and are excluded from own-catalog browser graphs. All four latest CI checks passed on reviewed head `1fc4aa41c02cb9b757531bab373e3e914c9af90c`, including the normal application-job rerun after GitHub left the first completed job's check pending. The stack's server entry choice is unchanged. Blueprint `7a78e7eae99285174a11c62d43c1f0035658ec96` is also partially implemented at `MachineWisdomAI/saga-a2ui@39777a6b81ff2a4757f58232686dc1e31b9c7080`: the consumer-boundary qualification repair, via [PR #244](https://github.com/MachineWisdomAI/saga-a2ui/pull/244) and [independent review](https://github.com/MachineWisdomAI/saga-a2ui/pull/244#pullrequestreview-5620133622). The existing scan now runs in the always-on documentation command and explicitly covers maintained server consumers, with two reviewed per-line backend-registration exceptions. Independent verification passed 125 documentation and boundary tests, a prohibited documentation fence failed the actual documentation command, and eight real-Git routing tests passed. All four latest CI checks passed on reviewed head `349fda2e24964408b2a7cc228c2bff30ee870955`; application routing and supported MCP server-only composition are unchanged. Blueprint `7a78e7eae99285174a11c62d43c1f0035658ec96` is also partially implemented at `MachineWisdomAI/saga-a2ui@d0f04f1ee213075c7c611eb9c1b348f6f0dcc0f7`: the starting-view retirement and throwing-cleanup repair, via [PR #245](https://github.com/MachineWisdomAI/saga-a2ui/pull/245) and [independent review](https://github.com/MachineWisdomAI/saga-a2ui/pull/245#pullrequestreview-5620594181). Both stacks retire and unmount explicitly disposed starting views before closing their transport, preserve failed-start presentation until disposal, remove pagehide listeners before callbacks, and release containers despite throwing cleanup or reporting. The five starters leave presentation-owned bindings with the surface. Independent verification passed 163 affected lifecycle tests, 282 starter, guide and boundary tests, 12 real Chromium cases across both stacks and the affected typechecks. All four latest CI checks passed on reviewed head `a6a427915eb09450d3662c40d5279d0da710b836`, including the normal application-job rerun after a test-discovery subprocess exceeded its five-second limit; no assertion or time limit was changed. Branding and final documentation reconciliation remain open.
**Approved.** The human owner approved the reviewed design at [`7a78e7e`](https://github.com/MachineWisdomAI/saga-a2ui/blob/7a78e7eae99285174a11c62d43c1f0035658ec96/blueprints/features/view_composition.blueprint.md) (commit [`7a78e7eae99285174a11c62d43c1f0035658ec96`](https://github.com/MachineWisdomAI/saga-a2ui/commit/7a78e7eae99285174a11c62d43c1f0035658ec96)), proposed in [PR #237](https://github.com/MachineWisdomAI/saga-a2ui/pull/237) and merged into `main` at `4d70df2d001511050d3dff578c3885ce2557058b`. This records that decision only; it approves no code head. The earlier design approvals stay in the history: the baseline ([`db83e84a`](https://github.com/MachineWisdomAI/saga-a2ui/blob/db83e84a7d8d6d9527c5ab350472e82809afd609/blueprints/features/view_composition.blueprint.md)), the revision ([`4b1215a4`](https://github.com/MachineWisdomAI/saga-a2ui/blob/4b1215a4d588f537e93e8a4099cdfc5268a26ab3/blueprints/features/view_composition.blueprint.md)) and the correction ([`49e39bdb`](https://github.com/MachineWisdomAI/saga-a2ui/blob/49e39bdb434f5848ded9c042e425c5cefe735b31/blueprints/features/view_composition.blueprint.md)). The correction is implemented at `MachineWisdomAI/saga-a2ui@18153793795d4ecfc12d2785d96422d2e397a3b2` via [PR #234](https://github.com/MachineWisdomAI/saga-a2ui/pull/234). Blueprint `7a78e7eae99285174a11c62d43c1f0035658ec96` is partially implemented at `MachineWisdomAI/saga-a2ui@6b2aabf8a73e47347f70ade99d7584227c6e943b`: the renderer update-contract and Lit session-default repair (layer B), via [PR #238](https://github.com/MachineWisdomAI/saga-a2ui/pull/238) and [independent review](https://github.com/MachineWisdomAI/saga-a2ui/pull/238#pullrequestreview-5617059507). Affected renderer, type-contract and example checks passed, as did all four current CI checks on the reviewed head `cfdf45a1cf048d2034b6d445d13fbb39800b41fe`. Blueprint `7a78e7eae99285174a11c62d43c1f0035658ec96` is also partially implemented at `MachineWisdomAI/saga-a2ui@3a37b200e44ba36fa785202d1b63498a4ac70be1`: core's neutral `DeliveredResult`, the MCP mapping, the definition's single result reader and removal of `classifyResult`, via [PR #240](https://github.com/MachineWisdomAI/saga-a2ui/pull/240) and [independent review](https://github.com/MachineWisdomAI/saga-a2ui/pull/240#pullrequestreview-5618100272). Verification includes both packed card-stack module graphs and the unchanged 42-case Chromium result matrix, plus definition, mapping, export and type checks; all four latest CI checks passed on reviewed head `3d3cad3266e1eb0f96c26745411fc8893869c749`. Blueprint `7a78e7eae99285174a11c62d43c1f0035658ec96` is also partially implemented at `MachineWisdomAI/saga-a2ui@d465ab394f801c8a6e800af738438b7dbf6133da`: the stack-only public consumer repair, via [PR #242](https://github.com/MachineWisdomAI/saga-a2ui/pull/242) and [independent review](https://github.com/MachineWisdomAI/saga-a2ui/pull/242#pullrequestreview-5619017679). Each stack's main entry re-exports the catalog, schema and action names the maintained consumers use, plus `StartError`, `StartMisuse` and `ErrorPhase`; the five starters and the examples' stack views use those exports. Independent verification passed the affected export, module-graph, consumer, guide and five-starter checks, root and renderer/stack typechecks, strict packed React and Lit stack-only installs with framework peers and singleton runtimes, and a separate MCP server-only install and compile. Components and Markdown remain expected installed transitives and are excluded from own-catalog browser graphs. All four latest CI checks passed on reviewed head `1fc4aa41c02cb9b757531bab373e3e914c9af90c`, including the normal application-job rerun after GitHub left the first completed job's check pending. The stack's server entry choice is unchanged. Blueprint `7a78e7eae99285174a11c62d43c1f0035658ec96` is also partially implemented at `MachineWisdomAI/saga-a2ui@39777a6b81ff2a4757f58232686dc1e31b9c7080`: the consumer-boundary qualification repair, via [PR #244](https://github.com/MachineWisdomAI/saga-a2ui/pull/244) and [independent review](https://github.com/MachineWisdomAI/saga-a2ui/pull/244#pullrequestreview-5620133622). The existing scan now runs in the always-on documentation command and explicitly covers maintained server consumers, with two reviewed per-line backend-registration exceptions. Independent verification passed 125 documentation and boundary tests, a prohibited documentation fence failed the actual documentation command, and eight real-Git routing tests passed. All four latest CI checks passed on reviewed head `349fda2e24964408b2a7cc228c2bff30ee870955`; application routing and supported MCP server-only composition are unchanged. Blueprint `7a78e7eae99285174a11c62d43c1f0035658ec96` is also partially implemented at `MachineWisdomAI/saga-a2ui@d0f04f1ee213075c7c611eb9c1b348f6f0dcc0f7`: the starting-view retirement and throwing-cleanup repair, via [PR #245](https://github.com/MachineWisdomAI/saga-a2ui/pull/245) and [independent review](https://github.com/MachineWisdomAI/saga-a2ui/pull/245#pullrequestreview-5620594181). Both stacks retire and unmount explicitly disposed starting views before closing their transport, preserve failed-start presentation until disposal, remove pagehide listeners before callbacks, and release containers despite throwing cleanup or reporting. The five starters leave presentation-owned bindings with the surface. Independent verification passed 163 affected lifecycle tests, 282 starter, guide and boundary tests, 12 real Chromium cases across both stacks and the affected typechecks. All four latest CI checks passed on reviewed head `a6a427915eb09450d3662c40d5279d0da710b836`, including the normal application-job rerun after a test-discovery subprocess exceeded its five-second limit; no assertion or time limit was changed. Blueprint `7a78e7eae99285174a11c62d43c1f0035658ec96` is also partially implemented at `MachineWisdomAI/saga-a2ui@e62514504f7501ef20d9cfeed319ded6159f42b6`: branded-card qualification through both public stack starts, via [PR #248](https://github.com/MachineWisdomAI/saga-a2ui/pull/248) and [independent review](https://github.com/MachineWisdomAI/saga-a2ui/pull/248#pullrequestreview-5621359008). The Lit start passes the application's constructable stylesheets to the existing card view; React uses page CSS and the public stack stylesheet. Both stacks run the same semantic and computed-style checks for paragraphs, emphasis, right-to-left text, lists, links, rules and the closing footer, together with readiness, consent reset and sizing. Independent verification passed 191 affected tests, 58 Chromium cases on the workspace build and 58 on isolated packed-package builds, and the affected typechecks. All four latest CI checks passed on reviewed head `e3a04efdb07ba807723c18e6b865bba71f10ee8c`. Final documentation reconciliation remains open.

The earlier SDK integration at `a4ec1ab` used `0.7.0-rc.1`; the renderer repair used `0.7.1-rc.1`, the definition-owned reader used `0.7.2-rc.1`, the stack-only consumer repair used `0.7.3-rc.1`, the boundary qualification repair used `0.7.4-rc.1`, and the starting-view repair advances the five public source versions to `0.7.5-rc.1`. Publication, repaired-consumer adoption and named-host acceptance remain open; stable promotion is held. Two historical pieces of evidence are separate: the motivating consumer's rehearsal against a packed candidate from `20b370df`, and the SDK's own qualification of a packed candidate from `a4ec1ab`. Neither qualifies these repairs or proves acceptance in a named host. The approved design and implementation history is preserved in the [record on `main`](https://github.com/MachineWisdomAI/saga-a2ui/blob/a4ec1abfeb6a0c098e39bf86aaab3e0e299a3a78/blueprints/features/view_composition.blueprint.md). The whole-result override, convenience exports, reading aliases and semantic styling landed in [PR #229](https://github.com/MachineWisdomAI/saga-a2ui/pull/229) under a delivery scope record, without separate human design approval. The approved decision covers the definition-owned reader and Lit construction API together; the override is replaced by repair 102's reader, and the Lit construction change landed with layer B in PR #238.
The earlier SDK integration at `a4ec1ab` used `0.7.0-rc.1`; the renderer repair used `0.7.1-rc.1`, the definition-owned reader used `0.7.2-rc.1`, the stack-only consumer repair used `0.7.3-rc.1`, the boundary qualification repair used `0.7.4-rc.1`, the starting-view repair used `0.7.5-rc.1`, and the branded-card qualification advances the five public source versions to `0.7.6-rc.1`. Publication, repaired-consumer adoption and named-host acceptance remain open; stable promotion is held. Two historical pieces of evidence are separate: the motivating consumer's rehearsal against a packed candidate from `20b370df`, and the SDK's own qualification of a packed candidate from `a4ec1ab`. Neither qualifies these repairs or proves acceptance in a named host. The approved design and implementation history is preserved in the [record on `main`](https://github.com/MachineWisdomAI/saga-a2ui/blob/a4ec1abfeb6a0c098e39bf86aaab3e0e299a3a78/blueprints/features/view_composition.blueprint.md). The whole-result override, convenience exports, reading aliases and semantic styling landed in [PR #229](https://github.com/MachineWisdomAI/saga-a2ui/pull/229) under a delivery scope record, without separate human design approval. The approved decision covers the definition-owned reader and Lit construction API together; the override is replaced by repair 102's reader, and the Lit construction change landed with layer B in PR #238.

## Ownership and example

Expand Down
Loading