Skip to content
Merged
Show file tree
Hide file tree
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
2 changes: 1 addition & 1 deletion blueprints/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -29,7 +29,7 @@ Use stable `snake_case` capability and module names. Codebase paths mirror the i
| UI actions and rendering | [Action binding](modules/action_binding.blueprint.md) and [Lit adapter](features/reusable_lit_adapter.blueprint.md) |
| Protected media | [Authorized playback](features/authorized_playback.blueprint.md) |
| Project setup and host submission | [Application setup](features/application_setup.blueprint.md) and [host publication](features/host_publication.blueprint.md) |
| A React starter, the tic-tac-toe guide and messages from a view to the conversation | [Getting-started tracks](features/getting_started_tracks.blueprint.md) and [view conversation](features/view_conversation.blueprint.md) (both draft) |
| A React starter, the tic-tac-toe guide and messages from a view to the conversation | [Getting-started tracks](features/getting_started_tracks.blueprint.md) and [view conversation](features/view_conversation.blueprint.md) (both approved; implementation not started) |

Each design's Status section separates its approved scope, implemented slices and outstanding acceptance. Host publication has working ChatGPT and Claude preparation commands; a fixture-verified local resumable-handoff record is also implemented, and none of these tools establishes publication. For working setup instructions, use [Getting started](../docs/getting-started.md).

Expand Down
2 changes: 1 addition & 1 deletion blueprints/features/application_setup.blueprint.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,3 @@
---
feature_name: application_setup
status: approved
Expand All @@ -14,7 +14,7 @@

Hapi's direct-registration lifecycle amendment, [`6ac09eb2e7790179fc7e01ec561462e795b90469`](https://github.com/MachineWisdomAI/saga-a2ui/blob/6ac09eb2e7790179fc7e01ec561462e795b90469/blueprints/features/application_setup.blueprint.md), is implemented at `MachineWisdomAI/saga-a2ui@00e23b080493432250c9ae84c90385f5e5acc4f9` ([PR #215](https://github.com/MachineWisdomAI/saga-a2ui/pull/215)); [independent review](https://github.com/MachineWisdomAI/saga-a2ui/pull/215#pullrequestreview-5605193916) covered `072b3c2b1478cdbbb4c551a1fd2fc380e2e5cd6a`.

Successor (draft, not approved): [getting-started tracks](getting_started_tracks.blueprint.md) proposes to amend two parts of this design. It would add a qualified React/Hono starter pair (`templates/react-hono`, offered as `--a2ui-stack react-mcp --server hono`), and split the setup guide into a common guide plus Lit and React build tracks. Until it is approved, this design stays current, including its statement that no React pair is offered.
Approved partial successor: [getting-started tracks at `6c3638b3f372c27d12b406a0c4800ea01f93cf24`](https://github.com/MachineWisdomAI/saga-a2ui/blob/6c3638b3f372c27d12b406a0c4800ea01f93cf24/blueprints/features/getting_started_tracks.blueprint.md), approved by the owner on 2026-10-28 including its diagram, replaces this design in two areas: a qualified React/Hono starter pair (`templates/react-hono`, offered as `--a2ui-stack react-mcp --server hono`), and the setup-guide split into a common guide plus Lit and React build tracks. Implementation of that amendment has not started; no React pair is offered yet. The unaffected contract and earlier implementation records remain current.

The seven SDK packages are published at [`0.7.7-rc.1`](https://github.com/MachineWisdomAI/saga-a2ui/releases/tag/v0.7.7-rc.1). Templates, the source CLI, demo and tour are development tooling, not npm packages or hosted services. Qualification of these outputs is local/installed evidence; it does not establish new OAuth, production or assistant-host acceptance. [Design and delivery history](#design-and-delivery-history) preserves the exact earlier scope and revisions.

Expand Down
9 changes: 5 additions & 4 deletions blueprints/features/getting_started_tracks.blueprint.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
feature_name: getting_started_tracks
status: draft
status: approved
module_blueprints: [action_binding]
dependencies: [application_setup, view_conversation, view_composition, reusable_mcp_connector]
date_added: 2026-10-27
Expand All @@ -10,10 +10,11 @@

## Status

- Design: draft awaiting human approval.
- Design: approved by the owner on 2026-10-28 at [`6c3638b3f372c27d12b406a0c4800ea01f93cf24`](https://github.com/MachineWisdomAI/saga-a2ui/blob/6c3638b3f372c27d12b406a0c4800ea01f93cf24/blueprints/features/getting_started_tracks.blueprint.md), including the reviewed diagram ([Mermaid](https://github.com/MachineWisdomAI/saga-a2ui/blob/6c3638b3f372c27d12b406a0c4800ea01f93cf24/diagrams/tic-tac-toe-turn-loop.mmd), [SVG](https://github.com/MachineWisdomAI/saga-a2ui/blob/6c3638b3f372c27d12b406a0c4800ea01f93cf24/diagrams/tic-tac-toe-turn-loop.svg), [PNG](https://github.com/MachineWisdomAI/saga-a2ui/blob/6c3638b3f372c27d12b406a0c4800ea01f93cf24/diagrams/tic-tac-toe-turn-loop.png)).
- Implementation: not started.
- This would partially amend [application setup](application_setup.blueprint.md) in two places: a qualified React/Hono starter pair, and the split of the setup guide into a short common guide plus two build tracks. The approved application-setup contract stays in force for everything else, including the five Lit pairs, the demo, the CLI's safety behaviour and the generated existing-backend recipes.
- It would also make `view` optional on [reusable MCP connector](reusable_mcp_connector.blueprint.md) operation declarations, keeping every execution guarantee ([operations without a view](#operations-without-a-view)).
- Acceptance: implementation qualification and the specified host runs remain outstanding. The wait cadence and limit remain open for host runs to settle; design approval does not establish host support.
- This approved design partially amends [application setup](application_setup.blueprint.md) in two places: a qualified React/Hono starter pair, and the split of the setup guide into a short common guide plus two build tracks. The approved application-setup contract stays in force for everything else, including the five Lit pairs, the demo, the CLI's safety behaviour and the generated existing-backend recipes.
- It also approves making `view` optional on [reusable MCP connector](reusable_mcp_connector.blueprint.md) operation declarations, keeping every execution guarantee ([operations without a view](#operations-without-a-view)).

<!-- Maintain this section using ../README.md#lifecycle-and-revision-records. -->

Expand Down
2 changes: 2 additions & 0 deletions blueprints/features/reusable_mcp_connector.blueprint.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,3 @@
---
feature_name: reusable_mcp_connector
status: approved
Expand All @@ -14,6 +14,8 @@

## Status

Approved partial amendment: [operations without a view at `6c3638b3f372c27d12b406a0c4800ea01f93cf24`](https://github.com/MachineWisdomAI/saga-a2ui/blob/6c3638b3f372c27d12b406a0c4800ea01f93cf24/blueprints/features/getting_started_tracks.blueprint.md#operations-without-a-view), approved by the owner on 2026-10-28, makes `view` optional on operation declarations while preserving execution guarantees. Implementation has not started; the current SDK still requires a view. The unaffected contract and earlier implementation records remain current.

The connector is published as `@saga-a2ui/mcp@0.7.7-rc.1`, with separate `server`, `view` and `policy` entries. All seven SDK packages have `0.7.7-rc.1` under npm's `next` tag. The [release receipt](https://github.com/MachineWisdomAI/saga-a2ui/releases/tag/v0.7.7-rc.1) identifies the release; the implementation and acceptance records below concern their named scopes, not universal host support.

The human-approved baseline is [`19fb26c84116b15a56fec31bfa358898fe96d791`](https://github.com/MachineWisdomAI/saga-a2ui/blob/19fb26c84116b15a56fec31bfa358898fe96d791/blueprints/features/reusable_mcp_connector.blueprint.md), with the [content-policy clarification at `6785ae1d8205a45e668f478ea303fbdd7e474663`](https://github.com/MachineWisdomAI/saga-a2ui/blob/6785ae1d8205a45e668f478ea303fbdd7e474663/blueprints/features/reusable_mcp_connector.blueprint.md). The sequencing amendment recorded at `6c268cc924886d4f7dfeb1668d83d0e17324f00b` allowed preparation before the lifetime work; it did not waive the later acceptance gates.
Expand Down
5 changes: 3 additions & 2 deletions blueprints/features/view_conversation.blueprint.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
feature_name: view_conversation
status: draft
status: approved
module_blueprints: [action_binding]
dependencies: [view_composition, reusable_mcp_connector]
date_added: 2026-10-27
Expand All @@ -10,8 +10,9 @@

## Status

- Design: draft awaiting human approval.
- Design: approved by the owner on 2026-10-28 at [`6c3638b3f372c27d12b406a0c4800ea01f93cf24`](https://github.com/MachineWisdomAI/saga-a2ui/blob/6c3638b3f372c27d12b406a0c4800ea01f93cf24/blueprints/features/view_conversation.blueprint.md), including the reviewed diagram ([Mermaid](https://github.com/MachineWisdomAI/saga-a2ui/blob/6c3638b3f372c27d12b406a0c4800ea01f93cf24/diagrams/view-conversation.mmd), [SVG](https://github.com/MachineWisdomAI/saga-a2ui/blob/6c3638b3f372c27d12b406a0c4800ea01f93cf24/diagrams/view-conversation.svg), [PNG](https://github.com/MachineWisdomAI/saga-a2ui/blob/6c3638b3f372c27d12b406a0c4800ea01f93cf24/diagrams/view-conversation.png)).
- Implementation: not started.
- Acceptance: implementation qualification and the specified host runs remain outstanding. Design approval does not establish host support.

<!-- Maintain this section using ../README.md#lifecycle-and-revision-records. -->

Expand Down
Loading