@linimin/pi-letscook 0.1.66 → 0.1.67

package/scripts/context-proposal-test.sh

@@ -147,7 +147,7 @@ mkdir -p "$ROOT"
 cd "$ROOT"
 git init -q
 
-# No workflow yet: bare /cook should be able to generate a primary-agent handoff in the same entry,
+# No workflow yet: bare /cook should be able to generate a primary-agent startup plan in the same entry,
 # then continue directly to startup confirmation.
 SESSION_ZERO="$TMPDIR/session-zero.jsonl"
 DISCUSSION_ZERO=$'Mission: Remove the completion status line while keeping the completion widget.
@@ -178,7 +178,7 @@ capsule = {
         "Keep observability regression coverage truthful."
     ],
     "risks": [],
-    "notes": ["Generated by the primary-agent handoff step triggered from /cook."],
+    "notes": ["Generated by the primary-agent startup-plan step triggered from /cook."],
     "handoff_kind": "implementation_workflow_handoff",
     "first_slice_goal": "Remove the completion status line while preserving the widget behavior.",
     "first_slice_non_goals": ["Do not reintroduce another status surface."],
@@ -203,13 +203,13 @@ from pathlib import Path
 
 output = Path(sys.argv[1]).read_text() + Path(sys.argv[2]).read_text()
 snapshot = Path(sys.argv[3])
-assert Path('.agent').exists(), 'primary-agent handoff generation should scaffold canonical state in the same /cook entry'
-assert snapshot.exists(), 'primary-agent handoff generation should emit a startup proposal snapshot'
+assert Path('.agent').exists(), 'primary-agent startup-plan generation should scaffold canonical state in the same /cook entry'
+assert snapshot.exists(), 'primary-agent startup-plan generation should emit a startup proposal snapshot'
 proposal = json.loads(snapshot.read_text())
 brief = json.loads(Path('.agent/state.json').read_text())['advisory_startup_brief']
-assert proposal['source'] == 'handoff_capsule', 'generated primary-agent handoff should be consumed as handoff capsule startup source'
-assert brief['source'] == 'primary_agent_handoff', 'generated primary-agent handoff should record primary_agent_handoff advisory intake'
-assert 'Initialized completion control plane' in output, 'same-entry primary-agent handoff generation should initialize canonical workflow state'
+assert proposal['source'] == 'handoff_capsule', 'generated primary-agent startup plan should be consumed as handoff-capsule startup source'
+assert brief['source'] == 'primary_agent_handoff', 'generated primary-agent startup plan should record primary_agent_handoff advisory intake'
+assert 'Initialized completion control plane' in output, 'same-entry primary-agent startup-plan generation should initialize canonical workflow state'
 PY
 
 rm -rf .agent
@@ -258,7 +258,7 @@ output = Path(sys.argv[1]).read_text() + Path(sys.argv[2]).read_text()
 snapshot = Path(sys.argv[3])
 assert not Path('.agent').exists(), 'user-authored faux handoff without supporting discussion should still fail closed without writing canonical state'
 assert not snapshot.exists(), 'user-authored faux handoff should not emit a startup proposal snapshot'
-assert 'primary-agent handoff step could not prepare a concrete startup handoff' in output, 'user-authored faux handoff should fail closed when primary-agent handoff generation yields no handoff'
+assert 'startup-plan step could not prepare a concrete workflow startup plan' in output, 'user-authored faux handoff should fail closed when the startup-plan step yields no plan'
 PY
 
 # No workflow yet: malformed or invalid assistant handoff capsules must also fail closed.
@@ -280,10 +280,10 @@ output = Path(sys.argv[1]).read_text() + Path(sys.argv[2]).read_text()
 snapshot = Path(sys.argv[3])
 assert not Path('.agent').exists(), 'invalid assistant handoff without supporting discussion should fail closed without writing canonical state'
 assert not snapshot.exists(), 'invalid assistant handoff should not emit a startup proposal snapshot'
-assert 'primary-agent handoff step could not prepare a concrete startup handoff' in output, 'invalid assistant handoff should fail closed when no valid handoff can be prepared'
+assert 'startup-plan step could not prepare a concrete workflow startup plan' in output, 'invalid assistant handoff should fail closed when no valid startup plan can be prepared'
 PY
 
-# No workflow yet: a fresh explicit primary-agent handoff should still bootstrap canonical startup state.
+# No workflow yet: a fresh explicit primary-agent startup-plan preview should still bootstrap canonical startup state.
 SESSION_ONE="$TMPDIR/session-one.jsonl"
 HANDOFF_SNAPSHOT_ONE="$TMPDIR/context-proposal-explicit-startup.json"
 HANDOFF_MESSAGES_ONE="$(python3 - <<'PY'
@@ -309,7 +309,7 @@ capsule = {
         "Stale widget-removal discussion could broaden the startup plan if the handoff is ignored."
     ],
     "notes": [
-        "Keep the startup brief aligned with the explicit primary-agent plan."
+        "Keep the startup plan aligned with the explicit primary-agent plan."
     ],
     "handoff_kind": "implementation_workflow_handoff",
     "first_slice_goal": "Land the completion-status removal and keep the completion widget coverage truthful.",
@@ -326,11 +326,11 @@ capsule = {
     "why_this_slice_first": "The startup boundary regression is already bounded enough to implement safely.",
     "task_type": "completion-workflow",
     "evaluation_profile": "completion-rubric-v1",
-    "why_cook_now": "The explicit startup brief is concrete and ready for repo changes."
+    "why_cook_now": "The explicit startup plan is concrete and ready for repo changes."
 }
 messages = [
     {"role": "user", "content": "Please think through the completion widget startup boundary and tell me when it is ready for /cook."},
-    {"role": "assistant", "content": "This task is now ready for /cook. Run /cook to confirm the startup brief.\n\n```cook_handoff\n" + json.dumps(capsule, ensure_ascii=False, indent=2) + "\n```"},
+    {"role": "assistant", "content": "This task is now ready for /cook. Run /cook to confirm the startup plan.\n\n```cook_handoff\n" + json.dumps(capsule, ensure_ascii=False, indent=2) + "\n```"},
 ]
 print(json.dumps(messages, ensure_ascii=False))
 PY
@@ -379,8 +379,8 @@ assert brief['acceptance'] == ['Update README to match the shipped behavior.', '
 assert brief['risks'] == ['Stale widget-removal discussion could broaden the startup plan if the handoff is ignored.'], 'advisory startup brief should preserve handoff risks'
 assert 'First slice goal: Land the completion-status removal and keep the completion widget coverage truthful.' in brief['notes'], 'advisory startup brief should preserve first_slice_goal in notes'
 assert 'Verification commands: npm run context-proposal-test' in brief['notes'], 'advisory startup brief should preserve verification_commands in notes'
-assert plan['candidate_slices'] == [], 'startup brief should remain advisory intake only until regrounder owns plan selection'
-assert active['status'] == 'idle', 'startup brief should not become the active-slice source before regrounder runs'
+assert plan['candidate_slices'] == [], 'startup plan summary should remain advisory intake only until regrounder owns plan selection'
+assert active['status'] == 'idle', 'startup plan summary should not become the active-slice source before regrounder runs'
 assert proposal['mission'] == mission, 'explicit startup proposal snapshot should keep the handoff mission anchor'
 assert proposal['source'] == 'handoff_capsule', 'explicit startup proposal snapshot should expose the handoff capsule source'
 assert proposal['analysis']['taskType'] == expected_task_type, 'explicit startup proposal snapshot should expose task_type hints separately'
@@ -561,7 +561,7 @@ assert plan['mission_anchor'] == mission, 'summary-only active bare /cook should
 assert active['mission_anchor'] == mission, 'summary-only active bare /cook should keep active-slice.json unchanged'
 PY
 
-# Active workflow: a fresh explicit handoff that is not implementation-startable should still fail closed
+# Active workflow: a fresh explicit startup-plan preview that is still too weak should fail closed
 # without rewriting canonical state.
 SESSION_ONE_NON_STARTABLE_ACTIVE="$TMPDIR/session-one-non-startable-active.jsonl"
 NON_STARTABLE_ACTIVE_ROUTING="$TMPDIR/active-non-startable-routing.json"
@@ -577,7 +577,7 @@ capsule = {
     "source_turn_id": "m0002",
     "mission": "Replace the current widget mission from a vague explicit handoff.",
     "scope": [
-        "Replace the active workflow from a fresh explicit handoff."
+        "Replace the active workflow from a fresh explicit startup-plan preview."
     ],
     "constraints": [
         "Do not rely on recent discussion to fill in missing implementation details."
@@ -603,7 +603,7 @@ capsule = {
     "evaluation_profile": "completion-rubric-v1"
 }
 messages = [
-    {"role": "user", "content": "We may need a different active workflow, but only if there is a fresh explicit handoff."},
+    {"role": "user", "content": "We may need a different active workflow, but only if there is a fresh explicit startup-plan preview."},
     {"role": "assistant", "content": "Only use this capsule if it is concrete enough.\n\n```cook_handoff\n" + json.dumps(capsule, ensure_ascii=False, indent=2) + "\n```"},
 ]
 print(json.dumps(messages, ensure_ascii=False))
@@ -656,12 +656,12 @@ after = {
 assert routing['mode'] == 'bare', 'fresh non-startable explicit handoff should snapshot bare routing mode'
 assert routing['action'] == 'blocked', 'fresh non-startable explicit handoff should fail closed for active bare /cook'
 assert routing['reason'] == 'fresh_explicit_handoff_not_startable', 'fresh non-startable explicit handoff should keep the dedicated explicit-handoff fail-closed reason'
-assert 'fresh explicit primary-agent handoff exists' in routing['blockedFailureMessage'], 'fresh non-startable explicit handoff should surface the dedicated fail-closed message'
+assert 'fresh explicit primary-agent startup plan exists' in routing['blockedFailureMessage'], 'fresh non-startable explicit handoff should surface the dedicated fail-closed message'
 assert 'acceptance is not anchored to concrete repo changes or verification' in routing['blockedFailureMessage'], 'fresh non-startable explicit handoff should explain why the capsule is not startable'
 assert not resume_path.exists(), 'fresh non-startable explicit handoff should not queue a resume prompt'
 assert not chooser_path.exists(), 'fresh non-startable explicit handoff should not open the replacement chooser'
 assert not proposal_path.exists(), 'fresh non-startable explicit handoff should not open final proposal confirmation'
-assert 'fresh explicit primary-agent handoff exists' in output, 'fresh non-startable explicit handoff should explain that the explicit capsule blocked active-workflow replacement'
+assert 'fresh explicit primary-agent startup plan exists' in output, 'fresh non-startable explicit handoff should explain that the explicit capsule blocked active-workflow replacement'
 assert before == after, 'fresh non-startable explicit handoff should leave canonical state unchanged'
 PY
 
@@ -706,7 +706,7 @@ state = json.loads(Path('.agent/state.json').read_text())
 assert state['mission_anchor'] == expected, 'completed-topic suppression should keep the done workflow mission anchor unchanged'
 assert state['continuation_policy'] == 'done', 'completed-topic suppression should keep the workflow closed'
 assert not snapshot.exists(), 'completed-topic suppression should not emit a proposal snapshot when the latest discussion only repeats finished work'
-assert 'primary-agent handoff step could not prepare a concrete startup handoff' in output, 'completed-topic suppression should fail closed when no concrete primary-agent handoff can be prepared'
+assert 'startup-plan step could not prepare a concrete workflow startup plan' in output, 'completed-topic suppression should fail closed when no concrete startup plan can be prepared'
 PY
 
 # Completed workflow: bare /cook should also suppress proposals that merely restate canonical
@@ -749,7 +749,7 @@ from pathlib import Path
 output = Path(sys.argv[1]).read_text() + Path(sys.argv[2]).read_text()
 snapshot = Path(sys.argv[3])
 assert not snapshot.exists(), 'verification-evidence overlap suppression should not emit a proposal snapshot for already verified work'
-assert 'primary-agent handoff step could not prepare a concrete startup handoff' in output, 'verification-evidence overlap suppression should fail closed when no concrete primary-agent handoff can be prepared'
+assert 'startup-plan step could not prepare a concrete workflow startup plan' in output, 'verification-evidence overlap suppression should fail closed when no concrete startup plan can be prepared'
 PY
 
 # Completed workflow: bare /cook should fail closed for next-round discussion-only startup too,
@@ -777,7 +777,7 @@ capsule = {
         "Preserve the tracked completion control-plane files."
     ],
     "risks": [],
-    "notes": ["Generated by the primary-agent handoff step triggered from /cook."],
+    "notes": ["Generated by the primary-agent startup-plan step triggered from /cook."],
     "handoff_kind": "implementation_workflow_handoff",
     "first_slice_goal": "Bootstrap the next workflow round from the normalized implementation mission.",
     "first_slice_non_goals": ["Do not reopen finished slices from the previous workflow."],
@@ -803,13 +803,13 @@ previous = sys.argv[4]
 state = json.loads(Path('.agent/state.json').read_text())
 if snapshot.exists():
     proposal = json.loads(snapshot.read_text())
-    assert proposal['source'] == 'handoff_capsule', 'done-workflow generated startup should snapshot the primary-agent handoff source'
+    assert proposal['source'] == 'handoff_capsule', 'done-workflow generated startup should snapshot the primary-agent startup-plan source'
 assert state['mission_anchor'] != previous, 'done-workflow discussion-only startup should advance to the new mission anchor'
 assert state['continuation_policy'] == 'continue', 'done-workflow discussion-only startup should reopen workflow state'
-assert 'Started a new completion workflow round from explicit primary-agent handoff' in output, 'done-workflow generated startup should report explicit primary-agent handoff startup'
+assert 'Started a new completion workflow round and recorded the approved startup plan' in output, 'done-workflow generated startup should report approved startup-plan capture'
 PY
 
-# Completed workflow: a fresh explicit primary-agent handoff should still start the next round.
+# Completed workflow: a fresh explicit primary-agent startup-plan preview should still start the next round.
 mark_done
 
 SESSION_TWO="$TMPDIR/session-two.jsonl"
@@ -821,7 +821,7 @@ capsule = {
     "source": "primary_agent",
     "captured_at": "2026-01-01T00:00:02.000Z",
     "source_turn_id": "m0002",
-    "mission": "Ship the next workflow round from a fresh explicit handoff.",
+    "mission": "Ship the next workflow round from a fresh explicit startup-plan preview.",
     "scope": [
         "Reset canonical state back to reground for the fresh mission.",
         "Preserve the tracked completion control-plane files."
@@ -837,10 +837,10 @@ capsule = {
         "Done-state history could override the fresh mission if the explicit handoff is ignored."
     ],
     "notes": [
-        "This next round must come from the fresh explicit handoff rather than recent discussion."
+        "This next round must come from the fresh explicit startup-plan preview rather than recent discussion."
     ],
     "handoff_kind": "implementation_workflow_handoff",
-    "first_slice_goal": "Start the next round from the fresh explicit handoff and preserve canonical control-plane files.",
+    "first_slice_goal": "Start the next round from the fresh explicit startup-plan preview and preserve canonical control-plane files.",
     "first_slice_non_goals": [
         "Do not resume the completed workflow when the new round is clearly different."
     ],
@@ -851,7 +851,7 @@ capsule = {
     "verification_commands": [
         "npm run context-proposal-test"
     ],
-    "why_this_slice_first": "The fresh explicit handoff is the smallest truthful next-round startup after the previous workflow closed.",
+    "why_this_slice_first": "The fresh explicit startup-plan preview is the smallest truthful next-round startup after the previous workflow closed.",
     "task_type": "completion-workflow",
     "evaluation_profile": "completion-rubric-v1",
     "why_cook_now": "A new implementation-ready mission was identified after the previous round closed."
@@ -875,7 +875,7 @@ import json
 import sys
 from pathlib import Path
 
-mission = 'Ship the next workflow round from a fresh explicit handoff.'
+mission = 'Ship the next workflow round from a fresh explicit startup-plan preview.'
 expected_task_type = 'completion-workflow'
 expected_eval_profile = 'completion-rubric-v1'
 mission_text = Path('.agent/mission.md').read_text()
@@ -891,7 +891,7 @@ assert profile['evaluation_profile'] == expected_eval_profile, 'profile.json eva
 assert state['mission_anchor'] == mission, 'state.json mission_anchor mismatch after starting the next workflow round from explicit handoff'
 assert state['task_type'] == expected_task_type, 'state.json task_type mismatch after starting the next workflow round from explicit handoff'
 assert state['evaluation_profile'] == expected_eval_profile, 'state.json evaluation_profile mismatch after starting the next workflow round from explicit handoff'
-assert state['advisory_startup_brief']['mission'] == mission, 'next-round explicit handoff should preserve the confirmed startup brief as advisory intake'
+assert state['advisory_startup_brief']['mission'] == mission, 'next-round explicit startup plan should preserve the confirmed startup plan as advisory intake'
 assert state['advisory_startup_brief']['source'] == 'primary_agent_handoff', 'next-round explicit handoff should preserve the handoff advisory source'
 assert plan['mission_anchor'] == mission, 'plan.json mission_anchor mismatch after starting the next workflow round from explicit handoff'
 assert plan['task_type'] == expected_task_type, 'plan.json task_type mismatch after starting the next workflow round from explicit handoff'
@@ -960,7 +960,7 @@ tracked = [
 ]
 
 assert not routing.exists(), 'active /cook inline-args rejection should not run active-workflow routing'
-assert not proposal.exists(), 'active /cook inline-args rejection should not emit a replacement startup-brief proposal'
+assert not proposal.exists(), 'active /cook inline-args rejection should not emit a replacement startup-plan proposal'
 assert not chooser.exists(), 'active /cook inline-args rejection should not open the existing-workflow chooser'
 assert '/cook no longer accepts inline arguments.' in output, 'active /cook inline-args rejection should explain the bare-only entry contract'
 after = {path.name: path.read_text() for path in tracked}
@@ -1018,7 +1018,7 @@ state_before = json.loads(before['state.json'])
 assert state_before['current_phase'] == 'done', 'done /cook inline-args rejection should start from a completed workflow'
 assert state_before['project_done'] is True, 'done /cook inline-args rejection should start from project_done=true'
 assert not routing.exists(), 'done /cook inline-args rejection should not run active-workflow routing while starting the next round'
-assert not proposal.exists(), 'done /cook inline-args rejection should not emit a next-round startup-brief proposal'
+assert not proposal.exists(), 'done /cook inline-args rejection should not emit a next-round startup-plan proposal'
 assert not chooser.exists(), 'done /cook inline-args rejection should not open the existing-workflow chooser when starting the next round'
 assert '/cook no longer accepts inline arguments.' in output, 'done /cook inline-args rejection should explain the bare-only entry contract'
 after = {path.name: path.read_text() for path in tracked}
@@ -1026,7 +1026,7 @@ assert before == after, 'done /cook inline-args rejection should leave canonical
 PY
 
 # Completed workflow again: model-assisted discussion analysis alone should still fail closed
-# without a fresh explicit primary-agent handoff.
+# without a fresh explicit primary-agent startup-plan preview.
 mark_done
 
 SESSION_FIVE="$TMPDIR/session-five.jsonl"
@@ -1052,7 +1052,7 @@ capsule = {
         "Add a regression test."
     ],
     "risks": [],
-    "notes": ["Generated by the primary-agent handoff step triggered from /cook."],
+    "notes": ["Generated by the primary-agent startup-plan step triggered from /cook."],
     "handoff_kind": "implementation_workflow_handoff",
     "first_slice_goal": "Land the regression-test-backed parser follow-up without rewriting the parser.",
     "first_slice_non_goals": ["Do not broaden the mission with stale scope."],
@@ -1078,8 +1078,8 @@ state = json.loads(Path('.agent/state.json').read_text())
 
 if snapshot.exists():
     pass
-assert state['continuation_policy'] == 'continue', 'done-workflow analyst-backed primary-agent handoff should reopen the workflow'
-assert 'Started a new completion workflow round from explicit primary-agent handoff' in output, 'done-workflow analyst-backed startup should report explicit primary-agent handoff startup'
+assert state['continuation_policy'] == 'continue', 'done-workflow analyst-backed primary-agent startup plan should reopen the workflow'
+assert 'Started a new completion workflow round and recorded the approved startup plan' in output, 'done-workflow analyst-backed startup should report approved startup-plan capture'
 PY
 
 # Custom confirmation UI: start should render proposal content separately from approval-only Start/Cancel actions.
@@ -1135,17 +1135,17 @@ from pathlib import Path
 snapshot = json.loads(Path(sys.argv[1]).read_text())
 state = json.loads(Path('.agent/state.json').read_text())
 
-assert snapshot['proposalHeading'] == 'Startup brief', 'custom confirmation snapshot should expose a dedicated startup-brief section'
-assert snapshot['critiqueHeading'] == 'Notes and risks', 'custom confirmation snapshot should expose notes separately from the startup-brief body'
+assert snapshot['proposalHeading'] == 'Startup plan', 'custom confirmation snapshot should expose a dedicated startup-plan section'
+assert snapshot['critiqueHeading'] == 'Notes and risks', 'custom confirmation snapshot should expose notes separately from the startup-plan body'
 assert snapshot['routingHeading'] == 'Routing recommendations', 'custom confirmation snapshot should expose routing recommendations separately from the proposal body'
 assert 'approval-only' in snapshot['intro'], 'custom confirmation intro should explain the approval-only gate'
 assert state['task_type'] == 'completion-workflow', 'start action should preserve canonical task_type'
 assert state['evaluation_profile'] == 'completion-rubric-v1', 'start action should preserve canonical evaluation_profile'
 assert 'Mission\nReplace the crowded selector with a clearer action layout.' in snapshot['proposalBody'], 'proposal body should be captured separately from the action list'
-assert 'Keep critique details separate from the approval-only proposal summary.' not in snapshot['proposalBody'], 'critique notes should not be embedded in the startup-brief body'
+assert 'Keep critique details separate from the approval-only proposal summary.' not in snapshot['proposalBody'], 'critique notes should not be embedded in the startup-plan body'
 assert 'Critique\n- Keep critique details separate from the approval-only proposal summary.' in snapshot['critiqueBody'], 'notes section should render accepted critique notes separately'
 assert 'Risks\n- Bundling critique into the action list would make the confirmation harder to scan.' in snapshot['critiqueBody'], 'critique section should render risk notes separately'
-assert '- Possible noise: old selector wording' in snapshot['critiqueBody'], 'critique section should preserve additional operator notes separately from the startup-brief body'
+assert '- Possible noise: old selector wording' in snapshot['critiqueBody'], 'critique section should preserve additional operator notes separately from the startup-plan body'
 assert '- task_type: completion-workflow' in snapshot['routingBody'], 'routing section should render the recommended task_type'
 assert '- evaluation_profile: completion-rubric-v1' in snapshot['routingBody'], 'routing section should render the recommended evaluation_profile'
 assert [action['id'] for action in snapshot['actions']] == ['start', 'cancel'], 'custom confirmation actions should stay Start/Cancel only'
@@ -1155,7 +1155,7 @@ for action in snapshot['actions']:
     assert 'Replace the crowded selector with a clearer action layout.' not in action['label'], 'proposal mission should not be embedded in action labels'
     assert 'Separate proposal text from actions.' not in action['description'], 'proposal scope should not be embedded in action descriptions'
 assert state['mission_anchor'] == 'Replace the crowded selector with a clearer action layout.', 'start action should still accept the proposed mission'
-assert state['advisory_startup_brief']['mission'] == 'Replace the crowded selector with a clearer action layout.', 'start action should preserve the confirmed startup brief canonically'
+assert state['advisory_startup_brief']['mission'] == 'Replace the crowded selector with a clearer action layout.', 'start action should preserve the confirmed startup plan canonically'
 assert state['continuation_reason'].startswith('User started workflow via /cook:'), 'start action should persist the startup routing outcome in continuation_reason'
 assert 'Keep critique details separate from the approval-only proposal summary.' in state['continuation_reason'], 'start action should persist the accepted critique outcome canonically'
 PY
@@ -1221,7 +1221,7 @@ assert 'Discuss changes in the main chat and rerun /cook.' in output, 'cancel co
 assert not Path('.agent').exists(), 'cancel action should not write canonical workflow state'
 PY
 
-# Explicit primary-agent handoff: /cook should prefer the structured handoff capsule over broad context re-inference.
+# Explicit primary-agent startup-plan preview: /cook should prefer the structured handoff capsule over broad context re-inference.
 HANDOFF_ROOT_START="$TMPDIR/handoff-root-start"
 mkdir -p "$HANDOFF_ROOT_START"
 cd "$HANDOFF_ROOT_START"
@@ -1251,7 +1251,7 @@ capsule = {
         "Stale auth discussion could broaden the startup brief if the handoff is ignored."
     ],
     "notes": [
-        "Keep the startup brief aligned with the explicit primary-agent plan."
+        "Keep the startup plan aligned with the explicit primary-agent plan."
     ],
     "handoff_kind": "implementation_workflow_handoff",
     "first_slice_goal": "Land the redirect callback fix and its regression coverage.",
@@ -1272,7 +1272,7 @@ capsule = {
 }
 messages = [
     {"role": "user", "content": "Please think through the login redirect fix and tell me when it is ready for /cook."},
-    {"role": "assistant", "content": "This task is now ready for /cook. Run /cook to confirm the startup brief.\n\n```cook_handoff\n" + json.dumps(capsule, ensure_ascii=False, indent=2) + "\n```"},
+    {"role": "assistant", "content": "This task is now ready for /cook. Run /cook to confirm the startup plan.\n\n```cook_handoff\n" + json.dumps(capsule, ensure_ascii=False, indent=2) + "\n```"},
 ]
 print(json.dumps(messages, ensure_ascii=False))
 PY
@@ -1296,7 +1296,7 @@ assert snapshot['source'] == 'handoff_capsule', 'explicit handoff startup should
 assert snapshot['mission'] == 'Fix login redirect callback behavior.', 'explicit handoff startup should preserve the primary-agent mission'
 assert state['mission_anchor'] == 'Fix login redirect callback behavior.', 'explicit handoff startup should use the handoff mission as canonical mission_anchor'
 assert state['advisory_startup_brief']['source'] == 'primary_agent_handoff', 'explicit handoff startup should preserve the advisory intake source'
-assert state['advisory_startup_brief']['risks'] == ['Stale auth discussion could broaden the startup brief if the handoff is ignored.'], 'explicit handoff startup should preserve handoff risks'
+assert state['advisory_startup_brief']['risks'] == ['Stale auth discussion could broaden the startup brief if the handoff is ignored.'], 'explicit startup-plan preview should preserve startup-plan risks'
 assert 'First slice goal: Land the redirect callback fix and its regression coverage.' in state['advisory_startup_brief']['notes'], 'explicit handoff startup should preserve first_slice_goal in advisory notes'
 assert 'First slice non-goals: Do not refactor the broader auth flow.' in state['advisory_startup_brief']['notes'], 'explicit handoff startup should preserve first_slice_non_goals in advisory notes'
 assert 'Implementation surfaces: src/auth/redirect.ts | tests/auth/redirect.spec.ts' in state['advisory_startup_brief']['notes'], 'explicit handoff startup should preserve implementation_surfaces in advisory notes'
@@ -1306,7 +1306,7 @@ assert 'Primary-agent /cook handoff rationale: The implementation plan is concre
 PY
 
 # Fresh but non-startable explicit handoff: /cook should fail closed instead of falling back
-# to a broad recent-discussion startup brief when the explicit capsule is still too vague.
+# to a broad recent-discussion startup plan when the explicit capsule is still too vague.
 HANDOFF_ROOT_VAGUE="$TMPDIR/handoff-root-vague"
 mkdir -p "$HANDOFF_ROOT_VAGUE"
 cd "$HANDOFF_ROOT_VAGUE"
@@ -1373,13 +1373,12 @@ output = Path(sys.argv[2]).read_text() + Path(sys.argv[3]).read_text()
 
 assert not snapshot.exists(), 'fresh non-startable handoff should not emit a startup proposal snapshot'
 assert not Path('.agent').exists(), 'fresh non-startable handoff should fail closed without writing canonical state'
-assert 'fresh explicit primary-agent handoff exists' in output, 'fresh non-startable handoff should explain that the explicit capsule blocked startup'
+assert 'fresh explicit primary-agent startup plan exists' in output, 'fresh non-startable handoff should explain that the explicit capsule blocked startup'
 assert 'acceptance is not anchored to concrete repo changes or verification' in output, 'fresh non-startable handoff should explain the workflow-only acceptance failure'
-assert 'implementation_surfaces is empty' in output, 'fresh non-startable handoff should explain the missing implementation_surfaces requirement'
-assert 'verification_commands is empty' in output, 'fresh non-startable handoff should explain the missing verification_commands requirement'
+assert 'verification intent' in output, 'fresh non-startable handoff should explain the plan-level verification requirement'
 PY
 
-# Fresh explicit handoff with complete first-slice fields but vague acceptance: /cook should still fail closed
+# Fresh explicit startup-plan preview with sequencing hints but vague acceptance: /cook should still fail closed
 # with the dedicated explicit-handoff message instead of bootstrapping canonical state.
 HANDOFF_ROOT_VAGUE_ACCEPTANCE="$TMPDIR/handoff-root-vague-acceptance"
 mkdir -p "$HANDOFF_ROOT_VAGUE_ACCEPTANCE"
@@ -1451,13 +1450,13 @@ from pathlib import Path
 snapshot = Path(sys.argv[1])
 output = Path(sys.argv[2]).read_text() + Path(sys.argv[3]).read_text()
 
-assert not snapshot.exists(), 'fresh explicit handoff with vague acceptance should not emit a startup proposal snapshot'
-assert not Path('.agent').exists(), 'fresh explicit handoff with vague acceptance should fail closed without writing canonical state'
-assert 'fresh explicit primary-agent handoff exists' in output, 'fresh explicit handoff with vague acceptance should use the dedicated explicit-handoff fail-closed message'
-assert 'acceptance is not anchored to concrete repo changes or verification' in output, 'fresh explicit handoff with vague acceptance should explain the vague acceptance failure'
+assert not snapshot.exists(), 'fresh explicit startup-plan preview with vague acceptance should not emit a startup proposal snapshot'
+assert not Path('.agent').exists(), 'fresh explicit startup-plan preview with vague acceptance should fail closed without writing canonical state'
+assert 'fresh explicit primary-agent startup plan exists' in output, 'fresh explicit startup-plan preview with vague acceptance should use the dedicated explicit-startup-plan fail-closed message'
+assert 'acceptance is not anchored to concrete repo changes or verification' in output, 'fresh explicit startup-plan preview with vague acceptance should explain the vague acceptance failure'
 PY
 
-# Done workflow + fresh handoff: the fresh explicit handoff should override done-state suppression and start the new round.
+# Done workflow + fresh startup-plan preview: the fresh explicit startup-plan preview should override done-state suppression and start the new round.
 HANDOFF_ROOT_DONE="$TMPDIR/handoff-root-done"
 mkdir -p "$HANDOFF_ROOT_DONE"
 cd "$HANDOFF_ROOT_DONE"
@@ -1626,7 +1625,7 @@ output = Path(sys.argv[2]).read_text() + Path(sys.argv[3]).read_text()
 
 assert not snapshot.exists(), 'stale handoff should not emit a startup proposal snapshot'
 assert not Path('.agent').exists(), 'stale handoff should fail closed without writing canonical state'
-assert 'primary-agent handoff step could not prepare a concrete startup handoff' in output, 'stale handoff should fail closed when the synthesized handoff step produces nothing'
+assert 'startup-plan step could not prepare a concrete workflow startup plan' in output, 'stale handoff should fail closed when the synthesized startup-plan step produces nothing'
 PY
 
 # Negative handoff rationale: a non-startable capsule must not become the startup mission.

package/scripts/refocus-test.sh

@@ -114,10 +114,10 @@ capsule = {
     ],
     "risks": [],
     "notes": [
-        "Use explicit primary-agent handoff startup for the refocus regression fixture."
+        "Use an explicit primary-agent startup-plan preview for the refocus regression fixture."
     ],
     "handoff_kind": "implementation_workflow_handoff",
-    "first_slice_goal": "Bootstrap the refocus regression fixture from a fresh explicit handoff.",
+    "first_slice_goal": "Bootstrap the refocus regression fixture from a fresh explicit startup-plan preview.",
     "first_slice_non_goals": [],
     "implementation_surfaces": [
         "scripts/refocus-test.sh"
@@ -128,7 +128,7 @@ capsule = {
     "why_this_slice_first": "The refocus regression fixture needs canonical state before active-workflow routing can be exercised.",
     "task_type": "completion-workflow",
     "evaluation_profile": "completion-rubric-v1",
-    "why_cook_now": "The active-workflow refocus regression needs a fresh explicit startup boundary."
+    "why_cook_now": "The active-workflow refocus regression needs a fresh explicit startup-plan preview."
 }
 messages = [
     {"role": "user", "content": "Prepare the refocus regression fixture and tell me when it is ready for /cook."},
@@ -215,7 +215,7 @@ tracked = [
 current_state = json.loads(before['state.json'])
 assert current_state['mission_anchor'] == initial_mission, 'active /cook inline-args rejection should start from the current mission anchor'
 assert not routing.exists(), 'active /cook inline-args rejection should not run active-workflow routing'
-assert not proposal.exists(), 'active /cook inline-args rejection should not open final startup-brief confirmation'
+assert not proposal.exists(), 'active /cook inline-args rejection should not open final startup-plan confirmation'
 assert not chooser.exists(), 'active /cook inline-args rejection should not open the existing-workflow chooser'
 assert '/cook no longer accepts inline arguments.' in output, 'active /cook inline-args rejection should explain the bare-only entry contract'
 after = {path.name: path.read_text() for path in tracked}
@@ -243,7 +243,7 @@ capsule = {
     ],
     "risks": [],
     "notes": [
-        "Use a fresh explicit primary-agent handoff for the active-workflow replacement."
+        "Use a fresh explicit primary-agent startup-plan preview for the active-workflow replacement."
     ],
     "handoff_kind": "implementation_workflow_handoff",
     "first_slice_goal": "Replace the initial smoke-test workflow with the widget mission.",
@@ -254,14 +254,14 @@ capsule = {
     "verification_commands": [
         "npm run refocus-test"
     ],
-    "why_this_slice_first": "The fresh explicit handoff is the only supported replacement entry while a workflow is active.",
+    "why_this_slice_first": "The fresh explicit startup-plan preview is the only supported replacement entry while a workflow is active.",
     "task_type": "completion-workflow",
     "evaluation_profile": "completion-rubric-v1",
     "why_cook_now": "A different active workflow is ready and explicitly handed off by the primary agent."
 }
 messages = [
     {"role": "user", "content": "The smoke-test workflow is active, but a different replacement workflow may now be ready."},
-    {"role": "assistant", "content": "Use this fresh explicit handoff if you want /cook to replace the active workflow.\n\n```cook_handoff\n" + json.dumps(capsule, ensure_ascii=False, indent=2) + "\n```"},
+    {"role": "assistant", "content": "Use this fresh explicit startup-plan preview if you want /cook to replace the active workflow.\n\n```cook_handoff\n" + json.dumps(capsule, ensure_ascii=False, indent=2) + "\n```"},
 ]
 print(json.dumps(messages, ensure_ascii=False))
 PY
@@ -296,7 +296,7 @@ assert profile['evaluation_profile'] == expected_eval_profile, 'profile.json eva
 assert state['mission_anchor'] == new_anchor, 'state.json mission_anchor mismatch after refocus'
 assert state['task_type'] == expected_task_type, 'state.json task_type mismatch after refocus'
 assert state['evaluation_profile'] == expected_eval_profile, 'state.json evaluation_profile mismatch after refocus'
-assert state['advisory_startup_brief']['mission'] == new_anchor, 'refocus should preserve the confirmed startup brief as advisory intake'
+assert state['advisory_startup_brief']['mission'] == new_anchor, 'refocus should preserve the confirmed startup plan as advisory intake'
 assert plan['mission_anchor'] == new_anchor, 'plan.json mission_anchor mismatch after refocus'
 assert plan['task_type'] == expected_task_type, 'plan.json task_type mismatch after refocus'
 assert plan['evaluation_profile'] == expected_eval_profile, 'plan.json evaluation_profile mismatch after refocus'
@@ -312,7 +312,7 @@ assert active['status'] == 'idle', 'active-slice.json status should reset to idl
 assert routing['mode'] == 'bare', 'supported refocus should use bare active-workflow routing mode'
 assert 'explicitGoal' not in routing, 'supported bare refocus should not expose removed explicit-goal shim fields'
 assert 'explicitGoalProvided' not in routing, 'supported bare refocus should not expose removed explicit-goal shim fields'
-assert routing['action'] == 'refocus', 'supported bare /cook should classify as refocus when a fresh explicit handoff proposes a different mission'
+assert routing['action'] == 'refocus', 'supported bare /cook should classify as refocus when a fresh explicit startup-plan preview proposes a different mission'
 assert routing['reason'] == 'fresh_explicit_handoff', 'supported bare /cook should record the explicit-handoff replacement reason'
 assert routing['proposedMissionAnchor'] == new_anchor, 'explicit handoff routing snapshot should expose the replacement mission anchor'
 assert routing['proposalSource'] == 'handoff_capsule', 'explicit handoff routing snapshot should preserve the handoff source'
@@ -331,7 +331,7 @@ if [[ "$INITIAL_MISSION" == "$UPDATED_MISSION" ]]; then
   exit 1
 fi
 
-# Fresh explicit handoff replacements must still reach the chooser and final Start/Cancel gate while the
+# Fresh explicit startup-plan preview replacements must still reach the chooser and final Start/Cancel gate while the
 # workflow is active.
 BARE_REFOCUS_MISSION='Exercise explicit active-workflow replacement coverage.'
 BARE_REFOCUS_MESSAGES="$(python3 - <<'PY'
@@ -354,7 +354,7 @@ capsule = {
     ],
     "risks": [],
     "notes": [
-        "This replacement should come only from the fresh explicit handoff, not recent discussion inference."
+        "This replacement should come only from the fresh explicit startup-plan preview, not recent discussion inference."
     ],
     "handoff_kind": "implementation_workflow_handoff",
     "first_slice_goal": "Exercise the active-workflow explicit-handoff replacement path.",
@@ -365,14 +365,14 @@ capsule = {
     "verification_commands": [
         "npm run refocus-test"
     ],
-    "why_this_slice_first": "The active workflow should only replace from a fresh explicit handoff.",
+    "why_this_slice_first": "The active workflow should only replace from a fresh explicit startup-plan preview.",
     "task_type": "completion-workflow",
     "evaluation_profile": "completion-rubric-v1",
     "why_cook_now": "The primary agent explicitly handed off a replacement workflow while the current one is active."
 }
 messages = [
     {"role": "user", "content": "The current workflow is active, but there is a fresh explicit replacement handoff ready."},
-    {"role": "assistant", "content": "Use this fresh explicit handoff if you want /cook to replace the active workflow.\n\n```cook_handoff\n" + json.dumps(capsule, ensure_ascii=False, indent=2) + "\n```"},
+    {"role": "assistant", "content": "Use this fresh explicit startup-plan preview if you want /cook to replace the active workflow.\n\n```cook_handoff\n" + json.dumps(capsule, ensure_ascii=False, indent=2) + "\n```"},
 ]
 print(json.dumps(messages, ensure_ascii=False))
 PY
@@ -417,7 +417,7 @@ assert routing['proposedMissionAnchor'] == replacement_mission, 'explicit-handof
 assert routing['proposalSource'] == 'handoff_capsule', 'explicit-handoff routing should preserve the handoff source'
 assert chooser['title'].startswith('Existing completion workflow found'), 'bare chooser snapshot should describe the existing-workflow prompt'
 assert chooser['choices'][0].startswith('Continue current workflow'), 'bare chooser should keep the continue option'
-assert chooser['choices'][1].startswith('Start new workflow from explicit primary-agent handoff'), 'bare chooser should offer the explicit-handoff replacement option'
+assert chooser['choices'][1].startswith('Start new workflow from explicit primary-agent startup plan'), 'bare chooser should offer the explicit-startup-plan replacement option'
 assert 'Start/Cancel confirmation' in chooser['choices'][1], 'bare chooser should mention the approval-only replacement confirmation'
 assert chooser['choices'][2].startswith('Cancel'), 'bare chooser should keep the cancel option'
 assert 'Discuss changes in the main chat and rerun /cook.' in output, 'bare chooser cancel should redirect users back to the main chat and rerun /cook'
@@ -504,7 +504,7 @@ assert profile['evaluation_profile'] == expected_eval_profile, 'profile.json eva
 assert state['mission_anchor'] == new_anchor, 'state.json mission_anchor mismatch after bare refocus'
 assert state['task_type'] == expected_task_type, 'state.json task_type mismatch after bare refocus'
 assert state['evaluation_profile'] == expected_eval_profile, 'state.json evaluation_profile mismatch after bare refocus'
-assert state['advisory_startup_brief']['mission'] == new_anchor, 'bare refocus should preserve the confirmed startup brief as advisory intake'
+assert state['advisory_startup_brief']['mission'] == new_anchor, 'bare refocus should preserve the confirmed startup plan as advisory intake'
 assert plan['mission_anchor'] == new_anchor, 'plan.json mission_anchor mismatch after bare refocus'
 assert plan['task_type'] == expected_task_type, 'plan.json task_type mismatch after bare refocus'
 assert plan['evaluation_profile'] == expected_eval_profile, 'plan.json evaluation_profile mismatch after bare refocus'
@@ -540,7 +540,7 @@ capsule = {
         "Do not rewrite canonical state before the final Start confirmation."
     ],
     "acceptance": [
-        "Replace the active workflow using the synthesized primary-agent handoff.",
+        "Replace the active workflow using the synthesized primary-agent startup plan.",
         "Keep deterministic coverage for same-entry active replacement."
     ],
     "risks": [],
@@ -556,7 +556,7 @@ capsule = {
     "verification_commands": [
         "npm run refocus-test"
     ],
-    "why_this_slice_first": "Active replacement should work when the primary-agent handoff is synthesized in the same /cook entry.",
+    "why_this_slice_first": "Active replacement should work when the primary-agent startup plan is synthesized in the same /cook entry.",
     "task_type": "completion-workflow",
     "evaluation_profile": "completion-rubric-v1",
     "why_cook_now": "The user explicitly chose workflow mode and the replacement handoff can be synthesized immediately."

package/scripts/release-check.sh

@@ -5,33 +5,33 @@ ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
 cd "$ROOT"
 export PI_COMPLETION_RUNNING_RELEASE_CHECK=1
 
-echo "[release-check] running control-plane validation, tracked .agent contract coverage, slice-surface parity, explicit-/cook parity, startup/refocus/context regressions, canonical evidence artifact, active-slice contract, observability, legacy cleanup, evaluator calibration, and rubric contract coverage"
+echo "[release-check] running control-plane validation, tracked .agent contract coverage, slice-surface parity, /cook startup-plan parity, startup/refocus/context regressions, canonical evidence artifact, active-slice contract, observability, legacy cleanup, evaluator calibration, and rubric contract coverage"
 bash .agent/verify_completion_control_plane.sh
 git ls-files --error-unmatch .agent/README.md .agent/mission.md .agent/profile.json .agent/verify_completion_stop.sh .agent/verify_completion_control_plane.sh >/dev/null
 
-echo "[release-check] verifying public /cook parity and primary-agent-handoff docs/help"
+echo "[release-check] verifying public /cook parity and startup-plan docs/help"
 python3 - <<'PY'
 from pathlib import Path
 
 checks = {
     "README.md": [
         "You can still implement directly in ordinary chat when you do not need workflow state.",
-        "When you explicitly run `/cook`, it first checks for a fresh explicit primary-agent handoff.",
-        "If one is missing, it calls a same-entry primary-agent handoff synthesis step from the current task context, then asks you to **Start** or **Cancel** before rewriting canonical workflow state.",
-        "Explicit `/cook` capsules are still valid startup intake, but they are no longer the only path because `/cook` can synthesize the primary-agent handoff in the same entry when needed.",
+        "When you explicitly run `/cook`, it first checks for a fresh explicit primary-agent startup-plan preview.",
+        "After **Start**, the approved startup plan is written into `.agent/startup-plan.json` / `.agent/startup-plan.md`, and `completion-regrounder` uses it to derive canonical slices from current repo truth.",
+        "Explicit `/cook` capsules are still valid startup intake, but they are no longer the only path because `/cook` can synthesize the primary-agent startup plan in the same entry when needed.",
     ],
     "CHANGELOG.md": [
-        "changed `/cook` entry again so it now calls a same-entry primary-agent handoff synthesis step when no fresh explicit handoff exists, then proceeds directly to Start / Cancel without requiring a second `/cook` run",
-        "kept `/cook` from guessing startup purely from recent discussion by requiring that same-entry synthesis step to produce explicit primary-agent handoff data before workflow state can start",
+        "rewrote `/cook` startup around an approved startup plan that is captured under `.agent/startup-plan.json` / `.agent/startup-plan.md` after Start instead of leaving startup intent only as advisory intake in `state.json`",
+        "kept `/cook` confirm-first while handing the approved startup plan to `completion-regrounder`, which now derives canonical slices from repo truth instead of treating startup intake like an implementation-ready first-slice contract",
     ],
     "extensions/completion/prompt-surfaces.ts": [
-        '"If the user explicitly runs /cook, the extension should call a primary-agent handoff synthesis step from the current task context, then show Start/Cancel confirmation without making the user rerun /cook."',
-        '"Do not expect /cook to infer or guess startup intent from recent discussion alone; /cook should use explicit primary-agent handoff data, whether it already exists or is synthesized in the same /cook entry."',
+        '"If the user explicitly runs /cook, the extension should call a primary-agent startup-plan synthesis step from the current task context, show Start/Cancel confirmation in the same /cook entry, and only write the approved plan into .agent after Start."',
+        '"When /cook starts, the approved startup plan should be written into .agent and then handed to completion-regrounder so canonical slices can be derived from repo truth."',
         '"In ordinary chat, do not load or follow completion-protocol, and do not call completion_role."',
     ],
     "extensions/completion/index.ts": [
-        '"/cook failed closed because the primary-agent handoff step could not prepare a concrete startup handoff from the current task context. Clarify the mission, first slice, or verification intent in the main chat, then rerun /cook."',
-        'description: "/cook workflow: start or replace workflow only from an explicit primary-agent handoff, or resume the current workflow from canonical state"',
+        '"/cook failed closed because the startup-plan step could not prepare a concrete workflow startup plan from the current task context. Clarify the mission, scope, acceptance, or verification intent in the main chat, then rerun /cook."',
+        'description: "/cook workflow: capture the approved startup plan into .agent, let completion-regrounder split canonical slices, or resume the current workflow from canonical state"',
         '"Do not call completion_role from ordinary chat; it is reserved for explicit /cook workflow driver turns."',
     ],
     "extensions/completion/policy-guards.ts": [