mpga-ship

ship

Trigger: All tasks verified and ready to commit. Time to SHIP. The most satisfying moment in software development. All tests pass — very successful! Make Project Great Again.

Protocol

Phase 1 — Parallel pre-ship checks (Ship Gate)

Run ALL of the following checks simultaneously. Every check must pass before proceeding. If ANY check fails, report which ones failed and STOP — do not commit broken code.

Run these in parallel (all at once, not sequentially):

1. Tests pass — run the full test suite:

   pytest
   

2. Ruff passes — zero lint errors across the full project:

   .venv/bin/ruff check .
   

   If ruff is not installed, treat this check as passed.

3. Evidence drift check — no stale evidence links:

   mpga drift --quick
   

4. visual regression clean — UI tasks only:

   • Run the visual-tester gate when the completed work touched UI files
   • Non-UI tasks skip this check entirely

5. ui-audit passed — UI tasks only:

   • Run mpga-ui-audit or confirm the latest ui-auditor pass
   • Non-UI tasks skip this check entirely

6. No uncommitted scope changes — scope files must be clean:

   git diff --name-only -- 'MPGA/scopes/' 'mpga-plugin/cli/MPGA/scopes/'
   

   If this returns any files, the check FAILS. Scope docs must be committed or staged before shipping.

Ship Gate decision:

• ALL checks pass → proceed to Phase 2
• ANY check fails → print a summary table of pass/fail results for each check, then STOP

Example gate output:

Ship Gate Results:
  [PASS] Tests pass (pytest)
  [PASS] Ruff clean (ruff check .)
  [FAIL] Evidence drift — 3 stale links found
  [PASS] visual regression clean (UI task only)
  [PASS] ui-audit passed (UI task only)
  [PASS] No uncommitted scope changes

BLOCKED: 1 check failed. Fix issues before shipping.

Phase 2 — Update scope evidence

1. Check task cards for evidence_produced fields
2. Add any missing evidence links to scope docs — COMPLETE documentation
3. Run evidence verification to confirm:

   mpga evidence verify