TPI-017 eval-first monkey model chosen-branch execution record

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.

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: <fill or not_applicable>
+
+## 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: <fill or not_applicable>
+- next_blocker_after_chosen_branch: <fill or none>
+
+## 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.

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`