From 76c04e79f56519f88baab7900b799087de4d684c Mon Sep 17 00:00:00 2001 From: Younes Abouelnagah Date: Wed, 28 Oct 2026 18:46:27 -0400 Subject: [PATCH] docs(blueprints): record approval of tic-tac-toe designs --- blueprints/README.md | 2 +- blueprints/features/application_setup.blueprint.md | 2 +- blueprints/features/getting_started_tracks.blueprint.md | 9 +++++---- blueprints/features/reusable_mcp_connector.blueprint.md | 2 ++ blueprints/features/view_conversation.blueprint.md | 5 +++-- 5 files changed, 12 insertions(+), 8 deletions(-) diff --git a/blueprints/README.md b/blueprints/README.md index 4a1967cb..8eb409f9 100644 --- a/blueprints/README.md +++ b/blueprints/README.md @@ -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). diff --git a/blueprints/features/application_setup.blueprint.md b/blueprints/features/application_setup.blueprint.md index 4cf2ba52..cd4e6273 100644 --- a/blueprints/features/application_setup.blueprint.md +++ b/blueprints/features/application_setup.blueprint.md @@ -14,7 +14,7 @@ date_added: 2026-10-16 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. diff --git a/blueprints/features/getting_started_tracks.blueprint.md b/blueprints/features/getting_started_tracks.blueprint.md index 6bdfe159..76e46cb4 100644 --- a/blueprints/features/getting_started_tracks.blueprint.md +++ b/blueprints/features/getting_started_tracks.blueprint.md @@ -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 @@ -10,10 +10,11 @@ date_added: 2026-10-27 ## 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)). diff --git a/blueprints/features/reusable_mcp_connector.blueprint.md b/blueprints/features/reusable_mcp_connector.blueprint.md index 4b9776ac..dac3479f 100644 --- a/blueprints/features/reusable_mcp_connector.blueprint.md +++ b/blueprints/features/reusable_mcp_connector.blueprint.md @@ -14,6 +14,8 @@ For example, a subscription tool receives a filter, not an account ID. The appli ## 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. diff --git a/blueprints/features/view_conversation.blueprint.md b/blueprints/features/view_conversation.blueprint.md index 0d4de8d3..504edd93 100644 --- a/blueprints/features/view_conversation.blueprint.md +++ b/blueprints/features/view_conversation.blueprint.md @@ -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 @@ -10,8 +10,9 @@ date_added: 2026-10-27 ## 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.