Map Check

WORKFLOW_STATUS=$(jq -r '.workflow_status // ""' "$STATE_FILE")
CURRENT_ST=$(jq -r '.current_subtask_id // ""' "$STATE_FILE")
CURRENT_PHASE=$(jq -r '.current_step_phase // ""' "$STATE_FILE")
PENDING_COUNT=$(jq -r '.pending_steps | length' "$STATE_FILE")
SUBTASK_INDEX=$(jq -r '.subtask_index // 0' "$STATE_FILE")
SUBTASK_TOTAL=$(jq -r '.subtask_sequence | length' "$STATE_FILE")

if [[ "$WORKFLOW_STATUS" != "WORKFLOW_COMPLETE" ]]; then
  echo "Workflow incomplete: status=$WORKFLOW_STATUS, current=$CURRENT_ST ($CURRENT_PHASE), subtask $((SUBTASK_INDEX + 1)) of $SUBTASK_TOTAL"
  if [[ "$PENDING_COUNT" -gt 0 ]]; then
    echo "Pending workflow phases for $CURRENT_ST:"
    jq -r '.pending_steps[]' "$STATE_FILE"
  fi
fi

spawn_agent(
  agent_type="final-verifier",
  task_name="verify_all_subtasks_complete",
  message="""
Verify all subtasks from the plan are complete.

Read these artifacts from disk:
- .map/<branch>/task_plan_<branch>.md
- .map/<branch>/step_state.json
- .map/<branch>/artifact_manifest.json
- verification/test/check artifacts present in the manifest

Source authority: source files, tests, schemas, and configs beat transcripts, summaries, commit messages, and stale docs. If a plan or transcript claim disagrees with source, report drift and trust source.

Dismissal verdict gate: any `false_positive`, `covered`, `out_of_scope`, `pre_existing`, `no_tests_needed`, `safe_to_skip`, or `not_applicable` claim requires `path:line` source evidence, a quote, and confidence. Without source evidence, output `needs_investigation`.

For each subtask, check:
1. acceptance criteria met
2. code changes align with the subtask description
3. tests cover the implementation
4. no obvious regressions introduced

Output APPROVED or REJECTED with specific findings.
"""
)

TEST_CMD="${TEST_CMD:-pytest}"
LOG_FILE=".map/${BRANCH}/tests.log"
mkdir -p ".map/${BRANCH}"
set +e
$TEST_CMD >"$LOG_FILE" 2>&1
TEST_EXIT=$?
set -e
python3 .map/scripts/diagnostics.py parse --tool tests --log "$LOG_FILE" --command "$TEST_CMD" --exit-code "$TEST_EXIT"

git status --short

python3 .map/scripts/diagnostics.py summarize \
  --tool tests \
  --command "$TEST_CMD" \
  --exit-code "$TEST_EXIT" \
  --summary "Pytest run for branch verification" \
  --known-issues ".map/${BRANCH}/known-issues.json" \
  --notes "Capture deviations, flaky behavior, or environment quirks here"

python3 .map/scripts/map_step_runner.py ensure_known_issues_file
python3 .map/scripts/map_step_runner.py add_known_issue "Flaky integration test in CI" accepted "Non-blocking for local verification; tracked for follow-up"

RUN_HEALTH_STATUS="${RUN_HEALTH_STATUS:?set from final verification result}"
python3 .map/scripts/map_step_runner.py write_run_health_report \
  map-check \
  "$RUN_HEALTH_STATUS"

python3 .map/scripts/map_step_runner.py write_verification_summary "READY FOR REVIEW" "<task title>" "- pytest ...,- ruff ..." "- key findings" "- open PR"

python3 .map/scripts/map_step_runner.py write_stage_gate \
  verification \
  ready \
  verification-summary.md \
  "Verification passed and branch is ready for review"

python3 .map/scripts/map_step_runner.py ensure_active_issues_file
python3 .map/scripts/map_step_runner.py replace_active_issues \
  verification \
  verification-summary.md \
  "- [list unresolved verification issues here, or '(None)']"

BUNDLE=$(python3 .map/scripts/map_step_runner.py build_handoff_bundle)
SUMMARY=$(printf '%s' "$BUNDLE" | jq -r '.summary')
VALIDATION=$(printf '%s' "$BUNDLE" | jq -r '.validation')
RISKS=$(printf '%s' "$BUNDLE" | jq -r '.risks_follow_up')
python3 .map/scripts/map_step_runner.py write_pr_draft "$SUMMARY" "$VALIDATION" "$RISKS"

python3 .map/scripts/map_step_runner.py write_learning_handoff \
  map-check \
  "<task title>" \
  "READY FOR REVIEW|NEEDS WORK" \
  "<run $map-review next, or rework and rerun $map-check>" \
  "<optional verification note>"

# Verification Summary

Status: READY FOR REVIEW | NEEDS WORK | BLOCKED

## Checks Run
- <command>: pass/fail

## Findings
- <file/step>: <issue or evidence>

## Next Action
- <exact handoff command or review readiness statement>