From 6b25b52796e9e68e64ec6d2b01860038bc457750 Mon Sep 17 00:00:00 2001 From: gb250e <71205769+gb250e@users.noreply.github.com> Date: Sat, 21 Mar 2026 05:12:09 -0700 Subject: [PATCH 1/5] docs: add TPI-014 operator dispatch kit --- notes/tpi_014_operator_dispatch_kit.md | 17 +++++++++++++++++ 1 file changed, 17 insertions(+) create mode 100644 notes/tpi_014_operator_dispatch_kit.md diff --git a/notes/tpi_014_operator_dispatch_kit.md b/notes/tpi_014_operator_dispatch_kit.md new file mode 100644 index 0000000000..3cd29e32ad --- /dev/null +++ b/notes/tpi_014_operator_dispatch_kit.md @@ -0,0 +1,17 @@ +# TPI-014 Operator Dispatch Kit + +## Objective + +Package the exact operational surface needed to send the fixed outbound dispatch packet, track whether it was sent, record whether a reply arrived, and decide whether the reply may move into intake. + +## Operator checklist + +- outbound dispatch packet prepared +- outbound dispatch packet sent or not sent +- returned filled block received or not received +- transition rule passed or not passed +- TPI-011 intake started or not started + +## Rule + +This loop is complete only when the operational state is explicit enough that the next actor can tell whether the workflow is still waiting on a returned filled block or may move into intake immediately. From acb0f8c8ffc24312991e8de8e14e1de3db511063 Mon Sep 17 00:00:00 2001 From: gb250e <71205769+gb250e@users.noreply.github.com> Date: Sat, 21 Mar 2026 05:12:25 -0700 Subject: [PATCH 2/5] docs: add TPI-014 turn DoD --- notes/tpi_014_turn_dod.md | 13 +++++++++++++ 1 file changed, 13 insertions(+) create mode 100644 notes/tpi_014_turn_dod.md diff --git a/notes/tpi_014_turn_dod.md b/notes/tpi_014_turn_dod.md new file mode 100644 index 0000000000..7fad87ab31 --- /dev/null +++ b/notes/tpi_014_turn_dod.md @@ -0,0 +1,13 @@ +# TPI-014 Turn DoD + +A turn is done only if all of the following are explicit in the PR artifacts or PR comment: + +- current bottleneck +- decision label +- exact next action +- whether outbound dispatch is already sent +- whether a returned filled block exists +- whether the transition rule passed +- whether intake may start now or must remain blocked + +If any one of these is missing, the turn is not done. From e8ae056b16a91bab267253f29f73b804975037a7 Mon Sep 17 00:00:00 2001 From: gb250e <71205769+gb250e@users.noreply.github.com> Date: Sat, 21 Mar 2026 05:12:46 -0700 Subject: [PATCH 3/5] docs: add TPI-014 status surface --- notes/tpi_014_status_surface.md | 13 +++++++++++++ 1 file changed, 13 insertions(+) create mode 100644 notes/tpi_014_status_surface.md diff --git a/notes/tpi_014_status_surface.md b/notes/tpi_014_status_surface.md new file mode 100644 index 0000000000..ff92b501cb --- /dev/null +++ b/notes/tpi_014_status_surface.md @@ -0,0 +1,13 @@ +# TPI-014 Status Surface + +## Required explicit fields + +- outbound_dispatch_sent: yes | no +- returned_filled_block_present: yes | no +- transition_rule_passed: yes | no | not_applicable +- intake_started: yes | no +- still_waiting_on_provider: yes | no + +## Interpretation + +This note should let the next actor see the operational state in one glance. From 6747c67a75d5c4b7039c09a54546831a473ca932 Mon Sep 17 00:00:00 2001 From: gb250e <71205769+gb250e@users.noreply.github.com> Date: Sat, 21 Mar 2026 05:13:18 -0700 Subject: [PATCH 4/5] docs: add TPI-014 decision --- notes/tpi_014_decision.md | 17 +++++++++++++++++ 1 file changed, 17 insertions(+) create mode 100644 notes/tpi_014_decision.md diff --git a/notes/tpi_014_decision.md b/notes/tpi_014_decision.md new file mode 100644 index 0000000000..2174539694 --- /dev/null +++ b/notes/tpi_014_decision.md @@ -0,0 +1,17 @@ +# TPI-014 Decision + +## Current bottleneck + +The only blocker is still the absence of one returned filled provider block. + +## Decision label + +`continue_sharpening` + +## Exact next action + +Send the fixed outbound dispatch packet if not yet sent, record whether it was sent, and record whether any returned filled block has arrived and may transition into intake. + +## Turn DoD + +This turn is done only if the status surface and turn DoD fields are explicit. From db14b42aa55f49ad44bff75e0d1c19e6820e18a6 Mon Sep 17 00:00:00 2001 From: eb24516 Date: Sat, 21 Mar 2026 21:18:40 +0900 Subject: [PATCH 5/5] docs: add TPI-014 operator dispatch kit --- notes/pr13_update_summary.md | 19 +++++++++++++++++++ notes/tpi_014_decision.md | 10 +++++++++- notes/tpi_014_operator_dispatch_kit.md | 12 +++++++++++- notes/tpi_014_status_surface.md | 18 ++++++++++++++++-- notes/tpi_014_turn_dod.md | 25 +++++++++++++++++++------ 5 files changed, 74 insertions(+), 10 deletions(-) create mode 100644 notes/pr13_update_summary.md diff --git a/notes/pr13_update_summary.md b/notes/pr13_update_summary.md new file mode 100644 index 0000000000..fc2bd47b00 --- /dev/null +++ b/notes/pr13_update_summary.md @@ -0,0 +1,19 @@ +# PR #13 Update Summary + +## Operator dispatch kit + +The branch now defines the operational kit needed to send the fixed outbound +packet and track reply-to-intake readiness. + +## Turn DoD + +The branch now defines explicit done criteria for 10+ loop operational turns. + +## At-a-glance status surface + +The branch now defines one explicit status surface for dispatch, reply, +transition, and intake readiness. + +## Current label + +`continue_sharpening` diff --git a/notes/tpi_014_decision.md b/notes/tpi_014_decision.md index 2174539694..da65b1ec19 100644 --- a/notes/tpi_014_decision.md +++ b/notes/tpi_014_decision.md @@ -10,7 +10,15 @@ The only blocker is still the absence of one returned filled provider block. ## Exact next action -Send the fixed outbound dispatch packet if not yet sent, record whether it was sent, and record whether any returned filled block has arrived and may transition into intake. +Send the fixed outbound dispatch packet if not yet sent. Otherwise, record +whether a returned filled block arrived, whether it matches the exact return +shape, whether the transition rule passed, and whether intake may start now. + +## Branch rule + +- returned block absent: `continue_sharpening` +- returned block accepted and landing verified: `promote_to_execution_resume` +- returned block accepted but attach or landing fails: `move_to_failure_ledger` ## Turn DoD diff --git a/notes/tpi_014_operator_dispatch_kit.md b/notes/tpi_014_operator_dispatch_kit.md index 3cd29e32ad..eb69742d04 100644 --- a/notes/tpi_014_operator_dispatch_kit.md +++ b/notes/tpi_014_operator_dispatch_kit.md @@ -4,14 +4,24 @@ Package the exact operational surface needed to send the fixed outbound dispatch packet, track whether it was sent, record whether a reply arrived, and decide whether the reply may move into intake. +## Fixed outbound artifact + +- use the TPI-012 outbound dispatch packet exactly as written +- do not rewrite the return block shape +- do not reopen provider discovery, Git auth, or execution logic + ## Operator checklist - outbound dispatch packet prepared - outbound dispatch packet sent or not sent - returned filled block received or not received +- returned reply matches the exact return block or not - transition rule passed or not passed +- TPI-011 intake may start now or not - TPI-011 intake started or not started ## Rule -This loop is complete only when the operational state is explicit enough that the next actor can tell whether the workflow is still waiting on a returned filled block or may move into intake immediately. +This loop is complete only when the operational state is explicit enough that +the next actor can tell, at a glance, whether the workflow is still waiting on +a returned filled block or may move into intake immediately. diff --git a/notes/tpi_014_status_surface.md b/notes/tpi_014_status_surface.md index ff92b501cb..5e1f21286d 100644 --- a/notes/tpi_014_status_surface.md +++ b/notes/tpi_014_status_surface.md @@ -4,10 +4,24 @@ - outbound_dispatch_sent: yes | no - returned_filled_block_present: yes | no +- returned_block_matches_exact_shape: yes | no | not_applicable - transition_rule_passed: yes | no | not_applicable - intake_started: yes | no +- intake_may_start_now: yes | no - still_waiting_on_provider: yes | no +- current_bottleneck: +- exact_next_action: -## Interpretation +## Field meanings -This note should let the next actor see the operational state in one glance. +- `outbound_dispatch_sent`: whether the TPI-012 outbound packet has actually been sent +- `returned_filled_block_present`: whether any returned block exists yet +- `returned_block_matches_exact_shape`: whether the returned reply uses the exact TPI-012 return block shape +- `transition_rule_passed`: whether the TPI-012 transition rule passed +- `intake_started`: whether TPI-011 intake has already started +- `intake_may_start_now`: whether intake may begin immediately in this turn +- `still_waiting_on_provider`: whether the workflow is still blocked on provider reply +- `current_bottleneck`: the single active blocker +- `exact_next_action`: the one next move for the next actor + +`not_applicable` is allowed only when no returned block exists yet. diff --git a/notes/tpi_014_turn_dod.md b/notes/tpi_014_turn_dod.md index 7fad87ab31..ae2710f71c 100644 --- a/notes/tpi_014_turn_dod.md +++ b/notes/tpi_014_turn_dod.md @@ -1,13 +1,26 @@ # TPI-014 Turn DoD -A turn is done only if all of the following are explicit in the PR artifacts or PR comment: +A turn is done only if all of the following are explicit in the PR artifacts or +PR comment: - current bottleneck - decision label - exact next action -- whether outbound dispatch is already sent -- whether a returned filled block exists -- whether the transition rule passed -- whether intake may start now or must remain blocked +- outbound dispatch sent or not +- returned filled block exists or not +- returned block matches exact shape or not +- transition rule passed or not +- intake may start now or must remain blocked -If any one of these is missing, the turn is not done. +## Checklist + +- [ ] current bottleneck is explicit +- [ ] decision label is explicit +- [ ] exact next action is explicit +- [ ] outbound dispatch state is explicit +- [ ] returned block presence is explicit +- [ ] exact-shape match state is explicit +- [ ] transition rule state is explicit +- [ ] intake start readiness is explicit + +If any one item is missing, the turn is not done.