@linimin/pi-letscook 0.1.26

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@linimin/pi-letscook",
+  "version": "0.1.26",
+  "description": "Pi package for long-running completion workflows with canonical .agent state, role-based subagents, continuity, and verification helpers.",
+  "license": "MIT",
+  "private": false,
+  "keywords": ["pi-package", "pi", "workflow", "completion", "agent", "subagent"],
+  "files": [
+    "extensions",
+    "skills",
+    "agents",
+    "scripts",
+    "README.md",
+    "CHANGELOG.md",
+    "PUBLISHING.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "smoke-test": "bash ./scripts/smoke-test.sh",
+    "refocus-test": "bash ./scripts/refocus-test.sh",
+    "context-proposal-test": "bash ./scripts/context-proposal-test.sh",
+    "observability-status-test": "bash ./scripts/observability-status-test.sh",
+    "release-check": "bash ./scripts/release-check.sh"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "peerDependencies": {
+    "@mariozechner/pi-ai": "*",
+    "@mariozechner/pi-coding-agent": "*",
+    "@mariozechner/pi-tui": "*",
+    "typebox": "*"
+  },
+  "pi": {
+    "extensions": ["./extensions/completion"],
+    "skills": ["./skills"]
+  }
+}

package/scripts/context-proposal-test.sh

@@ -0,0 +1,235 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+PKG_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+TMPDIR="$(mktemp -d)"
+trap 'rm -rf "$TMPDIR"' EXIT
+
+write_session() {
+  local session_path="$1"
+  local cwd="$2"
+  local text="$3"
+  python3 - "$session_path" "$cwd" "$text" <<'PY'
+import json
+import sys
+from pathlib import Path
+
+session_path = Path(sys.argv[1])
+cwd = sys.argv[2]
+text = sys.argv[3]
+session_path.parent.mkdir(parents=True, exist_ok=True)
+entries = [
+    {
+        "type": "session",
+        "version": 3,
+        "id": "11111111-1111-4111-8111-111111111111",
+        "timestamp": "2026-01-01T00:00:00.000Z",
+        "cwd": cwd,
+    },
+    {
+        "type": "message",
+        "id": "a1b2c3d4",
+        "parentId": None,
+        "timestamp": "2026-01-01T00:00:01.000Z",
+        "message": {
+            "role": "user",
+            "content": text,
+            "timestamp": 1767225601000,
+        },
+    },
+]
+with session_path.open('w', encoding='utf-8') as fh:
+    for entry in entries:
+        fh.write(json.dumps(entry, ensure_ascii=False) + "\n")
+PY
+}
+
+mark_done() {
+  python3 - <<'PY'
+import json
+from pathlib import Path
+
+state_path = Path('.agent/state.json')
+plan_path = Path('.agent/plan.json')
+active_path = Path('.agent/active-slice.json')
+
+state = json.loads(state_path.read_text())
+state.update({
+    'current_phase': 'done',
+    'continuation_policy': 'done',
+    'continuation_reason': 'Previous workflow completed.',
+    'project_done': True,
+    'requires_reground': False,
+    'next_mandatory_action': None,
+    'next_mandatory_role': None,
+    'remaining_stop_judges': 0,
+    'last_reground_at': '2026-01-01T00:10:00.000Z',
+    'contract_status': 'satisfied',
+})
+state_path.write_text(json.dumps(state, indent=2) + '\n')
+
+plan = json.loads(plan_path.read_text())
+plan.update({
+    'plan_basis': 'completed_round_fixture',
+    'candidate_slices': [],
+})
+plan_path.write_text(json.dumps(plan, indent=2) + '\n')
+
+active = json.loads(active_path.read_text())
+active.update({
+    'status': 'idle',
+    'slice_id': None,
+    'goal': None,
+    'contract_ids': [],
+    'acceptance_criteria': [],
+    'priority': None,
+    'why_now': None,
+    'blocked_on': [],
+    'locked_notes': [],
+    'must_fix_findings': [],
+    'basis_commit': None,
+    'remaining_contract_ids_before': [],
+    'release_blocker_count_before': None,
+    'high_value_gap_count_before': None,
+})
+active_path.write_text(json.dumps(active, indent=2) + '\n')
+PY
+}
+
+ROOT="$TMPDIR/repo"
+mkdir -p "$ROOT"
+cd "$ROOT"
+git init -q
+
+# No workflow yet: /cook with no goal should infer from recent discussion.
+SESSION_ONE="$TMPDIR/session-one.jsonl"
+DISCUSSION_ONE=$'Mission: Remove the completion status line while keeping the completion widget.\nScope:\n- Keep the non-running completion widget.\n- Suppress the widget while a completion role is active.\nConstraints:\n- Do not reintroduce any other completion status surface.\nAcceptance:\n- Update README to match the shipped behavior.\n- Keep observability regression coverage truthful.'
+write_session "$SESSION_ONE" "$ROOT" "$DISCUSSION_ONE"
+
+PI_COMPLETION_CONTEXT_PROPOSAL_ACTION=accept \
+PI_COMPLETION_SKIP_DRIVER_KICKOFF=1 \
+pi --session "$SESSION_ONE" -e "$PKG_ROOT" -p "/cook" >/tmp/pi-completion-context-proposal-bootstrap.out 2>/tmp/pi-completion-context-proposal-bootstrap.err
+
+python3 - <<'PY'
+import json
+from pathlib import Path
+
+mission = 'Remove the completion status line while keeping the completion widget.'
+mission_text = Path('.agent/mission.md').read_text()
+state = json.loads(Path('.agent/state.json').read_text())
+plan = json.loads(Path('.agent/plan.json').read_text())
+active = json.loads(Path('.agent/active-slice.json').read_text())
+
+assert mission in mission_text, '.agent/mission.md did not record the context-derived mission anchor'
+assert state['mission_anchor'] == mission, 'state.json mission_anchor mismatch after context-derived bootstrap'
+assert plan['mission_anchor'] == mission, 'plan.json mission_anchor mismatch after context-derived bootstrap'
+assert active['mission_anchor'] == mission, 'active-slice.json mission_anchor mismatch after context-derived bootstrap'
+assert state['current_phase'] == 'reground', 'state.json current_phase should start at reground after context-derived bootstrap'
+assert state['next_mandatory_role'] == 'completion-regrounder', 'next_mandatory_role should start at completion-regrounder after context-derived bootstrap'
+PY
+
+# Completed workflow: /cook with no goal should infer the next round from recent discussion.
+mark_done
+
+SESSION_TWO="$TMPDIR/session-two.jsonl"
+DISCUSSION_TWO=$'Mission: Ship the next workflow round for richer context-derived /cook startup.\nScope:\n- Start a new workflow round from recent discussion after the previous one is done.\n- Keep using canonical .agent state after confirmation.\nConstraints:\n- Do not resume the completed workflow when the new round is clearly different.\nAcceptance:\n- Reset canonical state back to reground for the new mission.\n- Preserve the tracked completion control-plane files.'
+write_session "$SESSION_TWO" "$ROOT" "$DISCUSSION_TWO"
+
+PI_COMPLETION_CONTEXT_PROPOSAL_ACTION=accept \
+PI_COMPLETION_SKIP_DRIVER_KICKOFF=1 \
+pi --session "$SESSION_TWO" -e "$PKG_ROOT" -p "/cook" >/tmp/pi-completion-context-proposal-next-round.out 2>/tmp/pi-completion-context-proposal-next-round.err
+
+python3 - <<'PY'
+import json
+from pathlib import Path
+
+mission = 'Ship the next workflow round for richer context-derived /cook startup.'
+mission_text = Path('.agent/mission.md').read_text()
+state = json.loads(Path('.agent/state.json').read_text())
+plan = json.loads(Path('.agent/plan.json').read_text())
+active = json.loads(Path('.agent/active-slice.json').read_text())
+
+assert mission in mission_text, '.agent/mission.md did not update to the next-round context-derived mission anchor'
+assert state['mission_anchor'] == mission, 'state.json mission_anchor mismatch after starting the next workflow round'
+assert plan['mission_anchor'] == mission, 'plan.json mission_anchor mismatch after starting the next workflow round'
+assert active['mission_anchor'] == mission, 'active-slice.json mission_anchor mismatch after starting the next workflow round'
+assert state['current_phase'] == 'reground', 'state.json current_phase should reset to reground for the next workflow round'
+assert state['continuation_policy'] == 'continue', 'continuation_policy should reset to continue for the next workflow round'
+assert state['requires_reground'] is True, 'requires_reground should reset to true for the next workflow round'
+assert state['project_done'] is False, 'project_done should reset to false for the next workflow round'
+assert state['next_mandatory_role'] == 'completion-regrounder', 'next_mandatory_role should reset to completion-regrounder for the next workflow round'
+assert state['continuation_reason'].startswith('User refocused workflow via /cook:'), 'continuation_reason should record the next-round refocus'
+assert plan['plan_basis'] == 'user_refocus', 'plan_basis should reset to user_refocus for the next workflow round'
+assert active['status'] == 'idle', 'active-slice should reset to idle for the next workflow round'
+PY
+
+# Active workflow: /cook <goal> plus refocus should use the explicit goal as the mission anchor,
+# while still allowing recent discussion to enrich the proposal before confirmation.
+SESSION_THREE="$TMPDIR/session-three.jsonl"
+DISCUSSION_THREE=$'Scope:\n- Preserve the richer proposal structure from discussion.\nConstraints:\n- Keep explicit goals as the mission anchor when they conflict with earlier text.\nAcceptance:\n- Refresh canonical state from the replacement mission.'
+write_session "$SESSION_THREE" "$ROOT" "$DISCUSSION_THREE"
+
+PI_COMPLETION_EXISTING_WORKFLOW_ACTION=refocus \
+PI_COMPLETION_CONTEXT_PROPOSAL_ACTION=accept \
+PI_COMPLETION_SKIP_DRIVER_KICKOFF=1 \
+pi --session "$SESSION_THREE" -e "$PKG_ROOT" -p "/cook Explicit replacement mission for the active workflow" >/tmp/pi-completion-context-proposal-active-goal.out 2>/tmp/pi-completion-context-proposal-active-goal.err
+
+python3 - <<'PY'
+import json
+from pathlib import Path
+
+mission = 'Explicit replacement mission for the active workflow.'
+mission_text = Path('.agent/mission.md').read_text()
+state = json.loads(Path('.agent/state.json').read_text())
+plan = json.loads(Path('.agent/plan.json').read_text())
+active = json.loads(Path('.agent/active-slice.json').read_text())
+
+assert mission in mission_text, '.agent/mission.md did not update to the explicit replacement mission anchor'
+assert state['mission_anchor'] == mission, 'state.json mission_anchor mismatch after explicit-goal replacement'
+assert plan['mission_anchor'] == mission, 'plan.json mission_anchor mismatch after explicit-goal replacement'
+assert active['mission_anchor'] == mission, 'active-slice.json mission_anchor mismatch after explicit-goal replacement'
+assert state['current_phase'] == 'reground', 'current_phase should reset to reground after explicit-goal replacement'
+assert state['continuation_policy'] == 'continue', 'continuation_policy should stay continue after explicit-goal replacement'
+assert state['next_mandatory_role'] == 'completion-regrounder', 'next role should reset to completion-regrounder after explicit-goal replacement'
+assert state['continuation_reason'].startswith('User refocused workflow via /cook:'), 'continuation_reason should record the explicit-goal replacement'
+assert plan['plan_basis'] == 'user_refocus', 'plan_basis should be user_refocus after explicit-goal replacement'
+assert active['status'] == 'idle', 'active slice should reset to idle after explicit-goal replacement'
+PY
+
+# Completed workflow again: /cook <goal> should start the next round directly from the explicit goal
+# without requiring existing-workflow continue/refocus confirmation.
+mark_done
+
+SESSION_FOUR="$TMPDIR/session-four.jsonl"
+DISCUSSION_FOUR=$'Mission: This older discussion should not override the explicit next-round goal.\nScope:\n- Reuse discussion details only as supplemental proposal context.\nAcceptance:\n- Start the next round from the explicit goal.'
+write_session "$SESSION_FOUR" "$ROOT" "$DISCUSSION_FOUR"
+
+PI_COMPLETION_CONTEXT_PROPOSAL_ACTION=accept \
+PI_COMPLETION_SKIP_DRIVER_KICKOFF=1 \
+pi --session "$SESSION_FOUR" -e "$PKG_ROOT" -p "/cook Explicit goal for the next completed-workflow round" >/tmp/pi-completion-context-proposal-done-goal.out 2>/tmp/pi-completion-context-proposal-done-goal.err
+
+python3 - <<'PY'
+import json
+from pathlib import Path
+
+mission = 'Explicit goal for the next completed-workflow round.'
+mission_text = Path('.agent/mission.md').read_text()
+state = json.loads(Path('.agent/state.json').read_text())
+plan = json.loads(Path('.agent/plan.json').read_text())
+active = json.loads(Path('.agent/active-slice.json').read_text())
+
+assert mission in mission_text, '.agent/mission.md did not update to the explicit next-round mission anchor'
+assert state['mission_anchor'] == mission, 'state.json mission_anchor mismatch after explicit-goal next-round start'
+assert plan['mission_anchor'] == mission, 'plan.json mission_anchor mismatch after explicit-goal next-round start'
+assert active['mission_anchor'] == mission, 'active-slice.json mission_anchor mismatch after explicit-goal next-round start'
+assert state['current_phase'] == 'reground', 'current_phase should reset to reground after explicit-goal next-round start'
+assert state['continuation_policy'] == 'continue', 'continuation_policy should reset to continue after explicit-goal next-round start'
+assert state['project_done'] is False, 'project_done should reset to false after explicit-goal next-round start'
+assert state['requires_reground'] is True, 'requires_reground should reset to true after explicit-goal next-round start'
+assert state['next_mandatory_role'] == 'completion-regrounder', 'next role should reset to completion-regrounder after explicit-goal next-round start'
+assert state['continuation_reason'].startswith('User refocused workflow via /cook:'), 'continuation_reason should record the explicit-goal next-round start'
+assert plan['plan_basis'] == 'user_refocus', 'plan_basis should be user_refocus after explicit-goal next-round start'
+assert active['status'] == 'idle', 'active slice should reset to idle after explicit-goal next-round start'
+PY
+
+echo "context proposal test passed: $ROOT"

package/scripts/observability-status-test.sh

@@ -0,0 +1,237 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+PKG_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+TMPDIR="$(mktemp -d)"
+trap 'rm -rf "$TMPDIR"' EXIT
+
+assert_status_json() {
+  local json_path="$1"
+  local mode="$2"
+  python3 - "$json_path" "$mode" <<'PY'
+import json
+import sys
+from pathlib import Path
+
+json_path = Path(sys.argv[1])
+mode = sys.argv[2]
+assert json_path.exists(), f"missing status probe output: {json_path}"
+data = json.loads(json_path.read_text())
+
+if mode == 'none':
+    assert data['snapshotPresent'] is False, data
+    assert not data.get('statusText'), data
+    assert data['widgetLines'] == [], data
+elif mode == 'static':
+    assert data['snapshotPresent'] is True, data
+    assert data['currentPhase'] == 'implement', data
+    assert data['sliceId'] == 'fixture-status-surface', data
+    assert data['nextMandatoryRole'] == 'completion-implementer', data
+    assert data['remainingContractCount'] == 2, data
+    assert data['releaseBlockerCount'] == 1, data
+    assert data['highValueGapCount'] == 4, data
+    assert data['remainingStopJudgeCount'] == 2, data
+    assert not data.get('statusText'), data
+    widget = data['widgetLines']
+    assert 'phase: implement' in widget, widget
+    assert 'slice: fixture-status-surface' in widget, widget
+    assert 'next: completion-implementer' in widget, widget
+    assert 'remaining: 2 contracts · 1 blocker · 4 gaps · 2 stop judges' in widget, widget
+elif mode == 'live':
+    assert data['snapshotPresent'] is True, data
+    assert data['activeRole'] == 'completion-implementer', data
+    assert data['livePreview'] == 'Loading canonical completion state', data
+    assert data['liveState'] == 'active', data
+    assert data['liveToolActivity'] == 'read .agent/state.json', data
+    assert data['liveAssistantSummary'] == 'Loading canonical completion state', data
+    assert data['liveProgress'] == 'Loading canonical completion state', data
+    assert data['liveRationale'] == 'verifying selected slice handoff', data
+    assert data['liveNextStep'] == 'inspect extensions/completion/index.ts', data
+    assert data['liveVerifying'] == 'canonical slice handoff matches plan', data
+    assert data['liveStateDeltas'] == [
+        'tool activity separated from role judgment',
+        'waiting threshold uses updatedAt timestamps',
+    ], data
+    assert not data.get('statusText'), data
+    widget = data['widgetLines']
+    assert widget == [], widget
+    live_details = data['liveDetailsLines']
+    assert live_details[0] == 'running completion role completion-implementer', live_details
+    assert 'tool: read .agent/state.json' in live_details, live_details
+elif mode == 'waiting':
+    assert data['liveState'] == 'waiting', data
+    assert data['liveIdleMs'] == 20000, data
+    assert not data.get('statusText'), data
+    widget = data['widgetLines']
+    assert widget == [], widget
+elif mode == 'stalled':
+    assert data['liveState'] == 'stalled', data
+    assert data['liveIdleMs'] == 46000, data
+    assert not data.get('statusText'), data
+    widget = data['widgetLines']
+    assert widget == [], widget
+else:
+    raise AssertionError(f'unknown assertion mode: {mode}')
+PY
+}
+
+NO_SNAPSHOT_ROOT="$TMPDIR/no-snapshot"
+mkdir -p "$NO_SNAPSHOT_ROOT"
+cd "$NO_SNAPSHOT_ROOT"
+git init -q
+NO_SNAPSHOT_JSON="$TMPDIR/no-snapshot-status.json"
+PI_COMPLETION_SKIP_DRIVER_KICKOFF=1 \
+PI_COMPLETION_STATUS_SNAPSHOT_FILE="$NO_SNAPSHOT_JSON" \
+pi -e "$PKG_ROOT" -p "/cook" >"$TMPDIR/pi-completion-status-none.out" 2>"$TMPDIR/pi-completion-status-none.err" || true
+assert_status_json "$NO_SNAPSHOT_JSON" none
+
+FIXTURE_ROOT="$TMPDIR/fixture"
+mkdir -p "$FIXTURE_ROOT/.agent"
+cd "$FIXTURE_ROOT"
+git init -q
+
+cat > .agent/profile.json <<'JSON'
+{
+  "schema_version": 1,
+  "protocol_id": "completion",
+  "project_name": "status-surface-fixture",
+  "required_stop_judges": 3,
+  "priority_policy_id": "completion-default",
+  "docs_surfaces": ["README.md"]
+}
+JSON
+
+cat > .agent/state.json <<'JSON'
+{
+  "schema_version": 1,
+  "mission_anchor": "Verify persistent completion observability status surfaces.",
+  "current_phase": "implement",
+  "continuation_policy": "continue",
+  "continuation_reason": "Status surface regression fixture.",
+  "project_done": false,
+  "requires_reground": false,
+  "slices_since_last_reground": 0,
+  "remaining_release_blockers": 1,
+  "remaining_high_value_gaps": 4,
+  "unsatisfied_contract_ids": ["OBS-STATUS-SURFACE", "OBS-ACTIVITY-SEPARATION"],
+  "release_blocker_ids": ["RB-STATUS-FIXTURE"],
+  "next_mandatory_action": "Implement selected slice fixture-status-surface.",
+  "next_mandatory_role": "completion-implementer",
+  "remaining_stop_judges": 2,
+  "last_reground_at": "2026-04-30T00:00:00Z",
+  "last_auditor_verdict": null,
+  "contract_status": "gaps_identified",
+  "latest_completed_slice": null,
+  "latest_verified_slice": null
+}
+JSON
+
+cat > .agent/plan.json <<'JSON'
+{
+  "schema_version": 1,
+  "mission_anchor": "Verify persistent completion observability status surfaces.",
+  "last_reground_at": "2026-04-30T00:00:00Z",
+  "plan_basis": "observability_status_fixture",
+  "candidate_slices": [
+    {
+      "slice_id": "fixture-status-surface",
+      "goal": "Render the remaining completion widget surface from canonical state.",
+      "acceptance_criteria": [
+        "No completion status text is rendered.",
+        "Persistent widget lines are rendered when no role is running."
+      ],
+      "contract_ids": ["OBS-STATUS-SURFACE"],
+      "priority": 100,
+      "status": "selected",
+      "why_now": "Fixture for observability status regression coverage.",
+      "blocked_on": [],
+      "evidence": []
+    }
+  ]
+}
+JSON
+
+cat > .agent/active-slice.json <<'JSON'
+{
+  "schema_version": 1,
+  "mission_anchor": "Verify persistent completion observability status surfaces.",
+  "status": "selected",
+  "slice_id": "fixture-status-surface",
+  "goal": "Render the remaining completion widget surface from canonical state.",
+  "contract_ids": ["OBS-STATUS-SURFACE"],
+  "acceptance_criteria": [
+    "No completion status text is rendered.",
+    "Persistent widget lines are rendered when no role is running."
+  ],
+  "blocked_on": [],
+  "locked_notes": [],
+  "must_fix_findings": [],
+  "basis_commit": "fixturebasis",
+  "remaining_contract_ids_before": ["OBS-STATUS-SURFACE", "OBS-ACTIVITY-SEPARATION"],
+  "release_blocker_count_before": 1,
+  "high_value_gap_count_before": 4,
+  "priority": 100,
+  "why_now": "Fixture for observability status regression coverage."
+}
+JSON
+
+STATIC_JSON="$TMPDIR/static-status.json"
+PI_COMPLETION_SKIP_DRIVER_KICKOFF=1 \
+PI_COMPLETION_STATUS_SNAPSHOT_FILE="$STATIC_JSON" \
+pi -e "$PKG_ROOT" -p "/cook" >"$TMPDIR/pi-completion-status-static.out" 2>"$TMPDIR/pi-completion-status-static.err"
+assert_status_json "$STATIC_JSON" static
+
+LIVE_ROLE_EVENT_STREAM_JSON="$(cat <<'JSON'
+{
+  "role": "completion-implementer",
+  "startedAt": 1000,
+  "events": [
+    {
+      "type": "tool_execution_start",
+      "toolName": "read",
+      "args": {"path": ".agent/state.json"},
+      "at": 2000
+    },
+    {
+      "type": "message_update",
+      "message": {
+        "role": "assistant",
+        "content": [
+          {
+            "type": "text",
+            "text": "PROGRESS: Loading canonical completion state\nRATIONALE: verifying selected slice handoff\nNEXT: inspect extensions/completion/index.ts\nVERIFYING: canonical slice handoff matches plan\nSTATE-DELTA: tool activity separated from role judgment\nSTATE-DELTA: waiting threshold uses updatedAt timestamps"
+          }
+        ]
+      },
+      "at": 2000
+    }
+  ]
+}
+JSON
+)"
+
+LIVE_JSON="$TMPDIR/live-status.json"
+PI_COMPLETION_SKIP_DRIVER_KICKOFF=1 \
+PI_COMPLETION_STATUS_SNAPSHOT_FILE="$LIVE_JSON" \
+PI_COMPLETION_TEST_NOW=2500 \
+PI_COMPLETION_TEST_ROLE_EVENT_STREAM_JSON="$LIVE_ROLE_EVENT_STREAM_JSON" \
+pi -e "$PKG_ROOT" -p "/cook" >"$TMPDIR/pi-completion-status-live.out" 2>"$TMPDIR/pi-completion-status-live.err"
+assert_status_json "$LIVE_JSON" live
+
+WAITING_JSON="$TMPDIR/waiting-status.json"
+PI_COMPLETION_SKIP_DRIVER_KICKOFF=1 \
+PI_COMPLETION_STATUS_SNAPSHOT_FILE="$WAITING_JSON" \
+PI_COMPLETION_TEST_NOW=22000 \
+PI_COMPLETION_TEST_ROLE_EVENT_STREAM_JSON="$LIVE_ROLE_EVENT_STREAM_JSON" \
+pi -e "$PKG_ROOT" -p "/cook" >"$TMPDIR/pi-completion-status-waiting.out" 2>"$TMPDIR/pi-completion-status-waiting.err"
+assert_status_json "$WAITING_JSON" waiting
+
+STALLED_JSON="$TMPDIR/stalled-status.json"
+PI_COMPLETION_SKIP_DRIVER_KICKOFF=1 \
+PI_COMPLETION_STATUS_SNAPSHOT_FILE="$STALLED_JSON" \
+PI_COMPLETION_TEST_NOW=48000 \
+PI_COMPLETION_TEST_ROLE_EVENT_STREAM_JSON="$LIVE_ROLE_EVENT_STREAM_JSON" \
+pi -e "$PKG_ROOT" -p "/cook" >"$TMPDIR/pi-completion-status-stalled.out" 2>"$TMPDIR/pi-completion-status-stalled.err"
+assert_status_json "$STALLED_JSON" stalled
+
+echo "observability status test passed: $TMPDIR"

package/scripts/refocus-test.sh

@@ -0,0 +1,77 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+PKG_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+TMPDIR="$(mktemp -d)"
+trap 'rm -rf "$TMPDIR"' EXIT
+
+cd "$TMPDIR"
+git init -q
+
+pi -e "$PKG_ROOT" -p "/cook smoke-test mission" >/tmp/pi-completion-refocus-bootstrap.out 2>/tmp/pi-completion-refocus-bootstrap.err &
+PI_PID=$!
+for _ in $(seq 1 60); do
+  if [[ -f .agent/profile.json && -f .agent/state.json && -f .agent/plan.json && -f .agent/active-slice.json ]]; then
+    break
+  fi
+  sleep 1
+done
+if [[ ! -f .agent/profile.json || ! -f .agent/state.json || ! -f .agent/plan.json || ! -f .agent/active-slice.json ]]; then
+  echo "completion bootstrap did not materialize canonical files in time" >&2
+  cat /tmp/pi-completion-refocus-bootstrap.err >&2 || true
+  kill "$PI_PID" >/dev/null 2>&1 || true
+  wait "$PI_PID" >/dev/null 2>&1 || true
+  exit 1
+fi
+kill "$PI_PID" >/dev/null 2>&1 || true
+wait "$PI_PID" >/dev/null 2>&1 || true
+
+INITIAL_MISSION="$(python3 - <<'PY'
+import json
+from pathlib import Path
+state = json.loads(Path('.agent/state.json').read_text())
+print(state['mission_anchor'])
+PY
+)"
+
+PI_COMPLETION_EXISTING_WORKFLOW_ACTION=refocus \
+PI_COMPLETION_SKIP_DRIVER_KICKOFF=1 \
+pi -e "$PKG_ROOT" -p "/cook refocused smoke-test mission with tests and docs" \
+  >/tmp/pi-completion-refocus.out 2>/tmp/pi-completion-refocus.err
+
+python3 - <<'PY'
+import json
+from pathlib import Path
+
+new_anchor = 'refocused smoke-test mission with tests and docs parity.'
+mission_text = Path('.agent/mission.md').read_text()
+state = json.loads(Path('.agent/state.json').read_text())
+plan = json.loads(Path('.agent/plan.json').read_text())
+active = json.loads(Path('.agent/active-slice.json').read_text())
+
+assert new_anchor in mission_text, '.agent/mission.md did not update to the refocused mission anchor'
+assert state['mission_anchor'] == new_anchor, 'state.json mission_anchor mismatch after refocus'
+assert plan['mission_anchor'] == new_anchor, 'plan.json mission_anchor mismatch after refocus'
+assert active['mission_anchor'] == new_anchor, 'active-slice.json mission_anchor mismatch after refocus'
+assert state['current_phase'] == 'reground', 'state.json current_phase should reset to reground after refocus'
+assert state['requires_reground'] is True, 'state.json requires_reground should be true after refocus'
+assert state['next_mandatory_role'] == 'completion-regrounder', 'next_mandatory_role should reset to completion-regrounder'
+assert state['continuation_reason'].startswith('User refocused workflow via /cook:'), 'continuation_reason should record the refocus'
+assert plan['plan_basis'] == 'user_refocus', 'plan.json plan_basis should be user_refocus after refocus'
+assert active['status'] == 'idle', 'active-slice.json status should reset to idle after refocus'
+PY
+
+UPDATED_MISSION="$(python3 - <<'PY'
+import json
+from pathlib import Path
+state = json.loads(Path('.agent/state.json').read_text())
+print(state['mission_anchor'])
+PY
+)"
+
+if [[ "$INITIAL_MISSION" == "$UPDATED_MISSION" ]]; then
+  echo "expected mission anchor to change during refocus" >&2
+  exit 1
+fi
+
+echo "refocus test passed: $TMPDIR"

package/scripts/release-check.sh

@@ -0,0 +1,13 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+cd "$ROOT"
+
+npm run smoke-test
+npm run refocus-test
+npm run context-proposal-test
+npm run observability-status-test
+npm pack --dry-run >/dev/null
+
+echo "release check passed"