diff --git a/notes/pr16_update_summary.md b/notes/pr16_update_summary.md new file mode 100644 index 0000000000..0a3ccfdecf --- /dev/null +++ b/notes/pr16_update_summary.md @@ -0,0 +1,23 @@ +# PR #16 Update Summary + +## Chosen-branch execution record + +The branch now defines one editable record that captures current reality, the one chosen branch, whether its preconditions were satisfied, whether it was actually executed, and what blocker remained after that choice. + +## Current reality snapshot + +The branch now fixes one place to record dispatch state, reply presence, and +transition state before selecting a branch. + +## Chosen branch + +The branch now fixes one place to record the single chosen branch and whether +it was executed or blocked. + +## Current label + +`continue_sharpening` + +## Current bottleneck + +One returned filled provider block is still missing. diff --git a/notes/tpi_017_chosen_branch_execution_record.md b/notes/tpi_017_chosen_branch_execution_record.md new file mode 100644 index 0000000000..dcb64bcccd --- /dev/null +++ b/notes/tpi_017_chosen_branch_execution_record.md @@ -0,0 +1,31 @@ +# TPI-017 Chosen Branch Execution Record + +## Current reality snapshot + +- 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 +- current_reality_reference: + +## Chosen branch + +- chosen_branch: send_now | wait | hand_to_intake | not_selected + +## Execution state + +- branch_preconditions_satisfied: yes | no +- branch_executed: yes | no +- execution_reference: +- next_blocker_after_chosen_branch: + +## Branch mapping + +- `send_now` only if dispatch is not yet sent and no returned block exists +- `wait` only if dispatch is already sent and no returned block exists +- `hand_to_intake` only if returned block exists and both checks pass + +## Rule + +Choose exactly one branch and record whether that branch was actually executed +or blocked. diff --git a/notes/tpi_017_decision.md b/notes/tpi_017_decision.md new file mode 100644 index 0000000000..4b05de02b5 --- /dev/null +++ b/notes/tpi_017_decision.md @@ -0,0 +1,31 @@ +# TPI-017 Decision + +## Current bottleneck + +The only blocker is still the absence of one returned filled provider block. + +## Decision label + +`continue_sharpening` + +## Exact next action + +Record current reality, choose exactly one branch from TPI-016, and record whether that chosen branch was actually executed or blocked. + +## Branch rule + +- returned filled 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` + +## Required fields + +- `outbound_dispatch_sent` +- `returned_filled_block_present` +- `returned_block_matches_exact_shape` +- `transition_rule_passed` +- `chosen_branch` +- `branch_preconditions_satisfied` +- `branch_executed` +- `execution_reference` +- `next_blocker_after_chosen_branch`