complete-milestonelisted

<purpose> Milestone lifecycle exit point. Performs a comprehensive readiness audit before closing, archives all phase artifacts and requirements, updates project-level tracking files, creates a git release tag, and offers to start the next milestone. Hard gate: all phases in the milestone must be complete (have SUMMARY.md) before close proceeds. </purpose> <process> ## 0. Parse Arguments From `$ARGUMENTS`: - `--milestone <version>` → version to close (e.g., `v1.0`). If omitted, detect from STATE.md. - `--force` → skip readiness gate (emergency close, documents deferred items). - `--no-tag` → skip git tag creation. Display: ``` ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ MaxVision ► COMPLETE MILESTONE ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━��━━━━━━━━━━━━━━ ``` ## 1. Detect Milestone Version ```bash set -euo pipefail MILESTONE_VERSION=$(maxvision-sdk query state.get milestone_version 2>/dev/null || grep -m1 "^## Current Milestone" .maxvision/PROJECT.md | sed 's/.*v\([0-9.]*\).*/v\1/') MILESTONE_NAME=$(maxvision-sdk query state.get milestone_name 2>/dev/null || echo "") ``` If `--milestone <version>` provided, use that instead. Confirm with user. ## 1.5 Milestone Audit Check (optional but recommended) Before performing the open-artifact audit, check whether a dedicated milestone audit has been run: ```bash set -euo pipefail MILESTONE_AUDIT_FILE=".maxvision/${MILESTONE_VERSION}-MILESTONE-AUDIT.md" ls -la "$MILESTONE_AUDIT_FILE" 2>/dev/null || true ``` - **If