@ikieaneh/opencode-kit 0.6.2 → 0.6.4

package/src/platform.sh

@@ -1,34 +0,0 @@
-#!/usr/bin/env bash
-# opencode-kit platform — cross-platform detection and helpers
-# Source this from any script: . "$(dirname "$0")/platform.sh"
-set -euo pipefail
-
-# --- OS Detection ---
-OS="unknown"
-case "$(uname -s)" in
-  Darwin) OS="macos" ;;
-  Linux)  OS="linux"  ;;
-  *)      OS="other"  ;;
-esac
-
-# --- Architecture ---
-ARCH="unknown"
-case "$(uname -m)" in
-  arm64|aarch64) ARCH="arm64" ;;
-  x86_64|amd64)  ARCH="amd64" ;;
-  *)             ARCH="other" ;;
-esac
-
-# --- Python command (python3 on macOS, python on some Linux) ---
-PYTHON_CMD=""
-if command -v python3 &>/dev/null; then
-  PYTHON_CMD="python3"
-elif command -v python &>/dev/null; then
-  PYTHON_CMD="python"
-fi
-
-# --- Bash compatibility ---
-BASH_VERSION=$(bash --version | head -1 | grep -oE '[0-9]+\.[0-9]+' | head -1 || echo "0")
-
-# --- Export ---
-export OS ARCH PYTHON_CMD BASH_VERSION

package/src/postflight.py

@@ -1,211 +0,0 @@
-#!/usr/bin/env python3
-"""postflight helper — batch all contract/telemetry/STATE.md operations in one call.
-
-Replaces 11 separate inline Python invocations from postflight.sh with a single
-script that handles: contract read/migration, phase telemetry, summary update,
-STATE.md generation, and contract file persistence.
-
-Usage:
-    postflight.py CONTRACT_FILE TELEMETRY_DIR STATE_FILE STATE_BACKUP_DIR TEMPLATE_FILE [NEW_STATE]
-
-Returns JSON to stdout with extracted values for shell-level echo/log messages.
-"""
-import json
-import os
-import sys
-import datetime
-
-
-def main() -> int:
-    # --- Parse arguments ---
-    contract_file = sys.argv[1] if len(sys.argv) > 1 else '.opencode/orchestration/contract.json'
-    telemetry_dir = sys.argv[2] if len(sys.argv) > 2 else '.opencode/telemetry'
-    state_file = sys.argv[3] if len(sys.argv) > 3 else 'STATE.md'
-    state_backup_dir = sys.argv[4] if len(sys.argv) > 4 else '.opencode/state'
-    template_file = sys.argv[5] if len(sys.argv) > 5 else '.opencode/templates/contract.json'
-    new_state = sys.argv[6] if len(sys.argv) > 6 else None
-
-    start_time_file = os.path.join(telemetry_dir, '.phase_start')
-    phases_file = os.path.join(telemetry_dir, 'phases.jsonl')
-    summary_file = os.path.join(telemetry_dir, 'summary.json')
-
-    now = datetime.datetime.now(datetime.UTC)
-    now_iso = now.strftime('%Y-%m-%dT%H:%M:%SZ')
-
-    # --- Load contract (file or template fallback) ---
-    contract = {}
-    if os.path.exists(contract_file):
-        with open(contract_file) as f:
-            contract = json.load(f)
-    elif os.path.exists(template_file):
-        with open(template_file) as f:
-            contract = json.load(f)
-
-    prev_state = contract.get('state', 'INIT')
-
-    # --- Update state if provided ---
-    if new_state:
-        contract['state'] = new_state
-
-    current_state = contract.get('state', 'UNKNOWN')
-
-    # --- Read start time and calculate phase elapsed ---
-    os.makedirs(telemetry_dir, exist_ok=True)
-    phase_elapsed_ms = 0
-    if os.path.exists(start_time_file):
-        with open(start_time_file) as f:
-            raw = f.read().strip()
-        if raw:
-            try:
-                start_ts = int(raw)
-                phase_elapsed_ms = int((now.timestamp() - start_ts) * 1000)
-            except ValueError:
-                pass
-        os.remove(start_time_file)
-
-    # --- Read last 'to' state from phases.jsonl for telemetry ---
-    last_to_state = 'INIT'
-    if os.path.exists(phases_file):
-        lines = [l.strip() for l in open(phases_file) if l.strip()]
-        if lines:
-            try:
-                last_to_state = json.loads(lines[-1]).get('to', 'INIT')
-            except json.JSONDecodeError:
-                pass
-
-    # --- Record phase telemetry ---
-    phase_entry = {
-        'ts': now_iso,
-        'from': last_to_state,
-        'to': current_state,
-        'elapsed_ms': phase_elapsed_ms,
-    }
-    with open(phases_file, 'a') as f:
-        f.write(json.dumps(phase_entry) + '\n')
-
-    # --- Contract migration (merge missing fields from template) ---
-    migrated = False
-    if os.path.exists(template_file):
-        with open(template_file) as f:
-            template = json.load(f)
-
-        old_ver = contract.get('contract_version', '0.0.0')
-        new_ver = template.get('contract_version', '0.5.2')
-
-        needs_migration = (
-            old_ver != new_ver
-            or not all(k in contract for k in ['state', 'requirements', 'governance', 'score'])
-        )
-
-        if needs_migration:
-            for key in template:
-                if key not in contract:
-                    contract[key] = template[key]
-            if 'extension_skills' not in contract.get('governance', {}):
-                contract.setdefault('governance', {})['extension_skills'] = []
-            contract['contract_version'] = new_ver
-            migrated = True
-
-    # --- Write contract to primary location ---
-    os.makedirs(os.path.dirname(contract_file) or '.', exist_ok=True)
-    with open(contract_file, 'w') as f:
-        json.dump(contract, f, indent=2)
-
-    # --- Backup contract to state backup dir ---
-    os.makedirs(state_backup_dir, exist_ok=True)
-    with open(os.path.join(state_backup_dir, 'contract.json'), 'w') as f:
-        json.dump(contract, f, indent=2)
-
-    # --- Update telemetry summary.json ---
-    total_ms = 0
-    phases = []
-    if os.path.exists(phases_file):
-        with open(phases_file) as f:
-            for line in f:
-                line = line.strip()
-                if not line:
-                    continue
-                try:
-                    entry = json.loads(line)
-                    total_ms += entry.get('elapsed_ms', 0)
-                    phases.append(entry.get('to', ''))
-                except json.JSONDecodeError:
-                    pass
-
-    summary = {
-        'phases_completed': phases,
-        'total_elapsed_ms': total_ms,
-        'total_elapsed_s': round(total_ms / 1000, 1),
-        'updated_at': now_iso,
-    }
-    with open(summary_file, 'w') as f:
-        json.dump(summary, f, indent=2)
-
-    # --- Extract values for STATE.md ---
-    retry = contract.get('retry', {})
-    score_obj = contract.get('score', {})
-    state_val = contract.get('state', 'UNKNOWN')
-    phase_val = retry.get('current_phase', 'none')
-    score_combined = str(score_obj.get('combined', '?'))
-
-    # Issues / blockers
-    issues = retry.get('issues', [])
-    issues_blockers = '\n'.join(f'- {i}' for i in issues) if issues else 'None'
-
-    # ADRs (last 3)
-    adr_log = contract.get('decisions', {}).get('adr_log', [])
-    if adr_log:
-        adr_lines = '\n'.join(
-            f'- {e.get("id", "?")}: {e.get("title", "")}' for e in adr_log[-3:]
-        )
-    else:
-        adr_lines = 'No ADRs recorded'
-
-    # Last completed phase
-    metrics_phases = contract.get('metrics', {}).get('phases_completed', [])
-    last_phase = metrics_phases[-1] if metrics_phases else 'INIT'
-
-    # --- Write STATE.md ---
-    state_md = (
-        '# Project State\n'
-        '\n'
-        '## Current Focus\n'
-        f'Agent orchestration — {state_val} (phase: {phase_val}). Score: {score_combined}.\n'
-        '\n'
-        '## Known Blockers\n'
-        f'{issues_blockers}\n'
-        '\n'
-        '## Active Decisions\n'
-        f'{adr_lines}\n'
-        '\n'
-        '## Recent Changes\n'
-        f'- Last state transition: {last_phase}\n'
-    )
-    state_dir = os.path.dirname(state_file)
-    if state_dir:
-        os.makedirs(state_dir, exist_ok=True)
-    with open(state_file, 'w') as f:
-        f.write(state_md)
-
-    # --- Output JSON summary for shell script consumption ---
-    output = {
-        'state': state_val,
-        'phase': phase_val,
-        'score': score_combined,
-        'prev_state': prev_state,
-        'current_state': current_state,
-        'phase_elapsed_ms': phase_elapsed_ms,
-        'phase_elapsed_s': round(phase_elapsed_ms / 1000, 1),
-        'migrated': migrated,
-        'contract_version': contract.get('contract_version', '?'),
-        'phases_count': len(phases),
-        'total_elapsed_s': summary['total_elapsed_s'],
-        'issues_count': len(issues),
-        'last_to_state': last_to_state,
-    }
-    print(json.dumps(output))
-    return 0
-
-
-if __name__ == '__main__':
-    sys.exit(main())

package/src/postflight.sh

@@ -1,82 +0,0 @@
-#!/usr/bin/env bash
-# opencode-kit postflight — persist contract + telemetry + update STATE.md
-# Run after every delegation or phase change.
-set -euo pipefail
-
-SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
-# shellcheck source=./platform.sh
-. "$SCRIPT_DIR/platform.sh"
-
-CONTRACT_KEY="orchestration-contract"
-CONTRACT_FILE=".opencode/orchestration/contract.json"
-STATE_FILE="STATE.md"
-TELEMETRY_DIR=".opencode/telemetry"
-STATE_BACKUP_DIR=".opencode/state"
-TEMPLATE_FILE=".opencode/templates/contract.json"
-
-mkdir -p "$TELEMETRY_DIR" "$STATE_BACKUP_DIR"
-
-echo "[opencode-kit] Post-flight: persisting state..."
-
-# --- Resolve contract: try lean-ctx first, fall back to file ---
-LEAN_CTX_CONTRACT=$(lean-ctx ctx_knowledge recall --query "$CONTRACT_KEY" 2>/dev/null || true)
-if [ -n "$LEAN_CTX_CONTRACT" ]; then
-  echo "$LEAN_CTX_CONTRACT" > "$CONTRACT_FILE"
-fi
-
-# --- Single Python call: batch all contract/telemetry/STATE.md operations ---
-PYTHON_OUTPUT=""
-STATE=""
-if [ -n "$PYTHON_CMD" ]; then
-  PYTHON_OUTPUT=$($PYTHON_CMD "$SCRIPT_DIR/postflight.py" \
-    "$CONTRACT_FILE" "$TELEMETRY_DIR" "$STATE_FILE" \
-    "$STATE_BACKUP_DIR" "$TEMPLATE_FILE" \
-  )
-
-  # Single Python parse call: extract all values as pipe-delimited string
-  IFS='|' read -r STATE PHASE SCORE PREV_STATE CURRENT_STATE ELAPSED_S MIGRATED CONTRACT_VER PHASES_COUNT TOTAL_ELAPSED_S LAST_TO_STATE <<< \
-    "$(echo "$PYTHON_OUTPUT" | $PYTHON_CMD -c "
-import sys, json
-d = json.load(sys.stdin)
-print('|'.join([str(d.get(k, '')) for k in [
-    'state', 'phase', 'score', 'prev_state', 'current_state',
-    'phase_elapsed_s', 'migrated', 'contract_version',
-    'phases_count', 'total_elapsed_s', 'last_to_state'
-]]))
-" 2>/dev/null || echo "UNKNOWN|none|?|INIT|UNKNOWN|0|false|?|0|0|INIT")"
-
-  # --- Echo status messages ---
-  echo "  📊 Telemetry: $PREV_STATE → $CURRENT_STATE (${ELAPSED_S}s)"
-
-  if [ "$MIGRATED" = "true" ]; then
-    echo "  🔄 Contract migrated to v${CONTRACT_VER}"
-  fi
-
-  echo "  📝 Contract state: $STATE (phase: $PHASE, score: $SCORE)"
-  echo "  ✅ STATE.md synced"
-
-  echo "  📈 Telemetry summary: ${PHASES_COUNT} phases, ${TOTAL_ELAPSED_S}s total"
-else
-  echo "  ⚠️  Python not available, skipping postflight processing"
-fi
-
-# --- Persist to lean-ctx ---
-if [ -n "$PYTHON_CMD" ] && [ -f "$CONTRACT_FILE" ]; then
-  CONTRACT_JSON=$(cat "$CONTRACT_FILE")
-  if lean-ctx ctx_knowledge remember \
-    category architecture \
-    key "$CONTRACT_KEY" \
-    value "$CONTRACT_JSON" 2>/dev/null; then
-    echo "  ✅ Contract persisted to lean-ctx"
-  fi
-fi
-
-# File fallback always written by Python script to $STATE_BACKUP_DIR/contract.json
-echo "  ✅ Contract persisted to file: $STATE_BACKUP_DIR/contract.json"
-
-# --- Save ctx_session ---
-lean-ctx ctx_session save 2>/dev/null && \
-  echo "  ✅ Session saved" || \
-  echo "  ⚠️  ctx_session save skipped (not available)"
-
-echo "[opencode-kit] ✅ Post-flight complete."

package/src/preflight.sh

@@ -1,138 +0,0 @@
-#!/usr/bin/env bash
-# ⛔ opencode-kit preflight — MANDATORY enforcement gate
-# Must run before any tool call. Exits with error if rules violated.
-set -euo pipefail
-
-SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
-# shellcheck source=./platform.sh
-. "$SCRIPT_DIR/platform.sh"
-
-CONTRACT_KEY="orchestration-contract"
-RULES_FILE=".opencode/rules/rules.json"
-CONTRACT_FILE=".opencode/orchestration/contract.json"
-
-RED='\033[0;31m'
-GREEN='\033[0;32m'
-YELLOW='\033[1;33m'
-NC='\033[0m'
-
-echo "[opencode-kit] ⛔ Pre-flight check..."
-
-# --- Check 1: contract.json exists on disk ---
-if [ ! -f "$CONTRACT_FILE" ]; then
-  echo -e "${RED}⛔ FAILED: $CONTRACT_FILE not found. Run 'opencode-kit init' first.${NC}"
-  exit 1
-fi
-echo "  ✅ contract.json exists"
-
-# --- Check 2: not on main ---
-BRANCH=$(git branch --show-current 2>/dev/null || echo "unknown")
-if [ "$BRANCH" = "main" ] || [ "$BRANCH" = "master" ]; then
-  echo -e "${RED}⛔ FAILED: On '$BRANCH' branch. Create a feature branch first.${NC}"
-  echo "  → git checkout -b feature/<YYYYMMDD>-<description>"
-  exit 1
-fi
-echo "  ✅ Branch: $BRANCH (safe)"
-
-# --- Check 3: MCP Availability (from rules.json) ---
-echo ""
-echo "  Checking MCP availability from rules.json..."
-
-MCP_FAIL=0
-
-if [ -n "$PYTHON_CMD" ] && [ -f "$RULES_FILE" ]; then
-  # Parse required_mcps from rules.json
-  $PYTHON_CMD -c "
-import json, sys, subprocess, os
-
-with open('$RULES_FILE') as f:
-    rules = json.load(f)
-
-mcps = rules.get('required_mcps', {})
-if not isinstance(mcps, dict) or 'description' in mcps:
-    # Skip the meta-description field
-    mcps = {k: v for k, v in mcps.items() if k != 'description' and isinstance(v, dict)}
-
-if not mcps:
-    print('  ℹ️  No required_mcps defined in rules.json — skipping MCP checks')
-    sys.exit(0)
-
-failures = []
-for name, cfg in mcps.items():
-    cli_check = cfg.get('check_cli', '')
-    tool_check = cfg.get('check_tool', '')
-    severity = cfg.get('severity', 'optional')
-    desc = cfg.get('description', name)
-
-    available = False
-    # Try CLI check first
-    if cli_check:
-        try:
-            result = subprocess.run(cli_check, shell=True, capture_output=True, timeout=5)
-            if result.returncode == 0:
-                available = True
-        except:
-            pass
-
-    # Try tool check as fallback
-    if not available and tool_check:
-        try:
-            result = subprocess.run(tool_check, shell=True, capture_output=True, timeout=5)
-            if result.returncode == 0:
-                available = True
-        except:
-            pass
-
-    if available:
-        print(f'  ✅ {name}: available — {desc}')
-    elif severity == 'required':
-        print(f'  ❌ {name}: NOT DETECTED — {desc}')
-        failures.append(name)
-    else:
-        print(f'  ⚠️  {name}: not detected — {desc} (optional)')
-
-if failures:
-    print('')
-    for name in failures:
-        print(f'  → Ensure {name} is configured in opencode.json MCP servers')
-    sys.exit(1)
-else:
-    sys.exit(0)
-" 2>&1 || MCP_FAIL=1
-fi
-
-echo ""
-
-# --- Check 4: rules.json exists ---
-if [ ! -f "$RULES_FILE" ]; then
-  echo -e "${YELLOW}⚠️  WARNING: $RULES_FILE not found. Rules enforcement disabled.${NC}"
-else
-  echo "  ✅ rules.json found"
-fi
-
-# --- Telemetry: record phase start ---
-mkdir -p .opencode/telemetry
-echo $(date +%s) > .opencode/telemetry/.phase_start
-
-# --- Check 5: contract state validation ---
-if [ -n "$PYTHON_CMD" ] && [ -f "$CONTRACT_FILE" ]; then
-  STATE=$($PYTHON_CMD -c "
-import json,sys
-try:
-  with open('$CONTRACT_FILE') as f: d=json.load(f)
-  print(d.get('state','UNKNOWN'))
-except: print('PARSE_ERROR')
-" 2>/dev/null)
-  if [ "$STATE" = "PARSE_ERROR" ] || [ "$STATE" = "UNKNOWN" ]; then
-    echo -e "${YELLOW}  ⚠️  Contract state: unknown — contract.json may be malformed${NC}"
-  else
-    echo "  ✅ Contract state: $STATE"
-  fi
-fi
-
-# --- Final verdict ---
-if [ "$MCP_FAIL" -eq 1 ]; then
-  echo -e "${YELLOW}[opencode-kit] ⛔ Pre-flight completed with WARNINGS. Missing MCPs may cause failures.${NC}"
-else
-  echo "[opencode-kit] ✅ Pre-flight passed. All MCPs available. Proceed."
-fi

package/src/status.sh

@@ -1,113 +0,0 @@
-#!/usr/bin/env bash
-# opencode-kit status — pretty terminal dashboard
-# Usage: bash src/status.sh
-set -euo pipefail
-
-SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
-# shellcheck source=./platform.sh
-. "$SCRIPT_DIR/platform.sh"
-
-CONTRACT_FILE=".opencode/orchestration/contract.json"
-RULES_FILE=".opencode/rules/rules.json"
-TELEMETRY_DIR=".opencode/telemetry"
-
-RED='\033[0;31m'
-GREEN='\033[0;32m'
-YELLOW='\033[1;33m'
-CYAN='\033[0;36m'
-BOLD='\033[1m'
-NC='\033[0m'
-
-echo ""
-echo -e "${CYAN}${BOLD}##══════════════════════════════════════════╗${NC}"
-echo -e "${CYAN}${BOLD}#        opencode-kit Dashboard            #${NC}"
-echo -e "${CYAN}${BOLD}##══════════════════════════════════════════╝${NC}"
-echo ""
-
-# === Contract State ===
-if [ -f "$CONTRACT_FILE" ] && [ -n "$PYTHON_CMD" ]; then
-  $PYTHON_CMD -c "
-import json
-with open('$CONTRACT_FILE') as f:
-    c = json.load(f)
-
-state = c.get('state', 'UNKNOWN')
-ver = c.get('contract_version', '?')
-goal = c.get('requirements', {}).get('goal', 'Not set')
-phases = c.get('metrics', {}).get('phases_completed', [])
-score = c.get('score', {}).get('combined', 0)
-verdict = c.get('score', {}).get('verdict', 'PENDING')
-adrs = len(c.get('decisions', {}).get('adr_log', []))
-ext_skills = c.get('governance', {}).get('extension_skills', [])
-
-# State color
-state_colors = {
-    'INIT': '\033[0;36m',
-    'PLAN': '\033[1;33m',
-    'PLAN_SCORED': '\033[1;33m',
-    'EXECUTE': '\033[0;32m',
-    'EXECUTE_SCORED': '\033[0;32m',
-    'REVIEW': '\033[0;34m',
-    'REVIEW_SCORED': '\033[0;34m',
-    'COMPLETE': '\033[0;32m',
-    'BLOCKED': '\033[0;31m',
-}
-color = state_colors.get(state, '\033[0m')
-nc = '\033[0m'
-
-print(f'  ${BOLD}Contract State:${NC} {color}{state}{nc}  (v{ver})')
-print(f'  ${BOLD}Goal:${NC}           {goal[:70]}...' if len(goal) > 70 else f'  ${BOLD}Goal:${NC}           {goal}')
-print(f'  ${BOLD}Score:${NC}          {score}/100 ({verdict})')
-print(f'  ${BOLD}Phases:${NC}         {len(phases)} completed: {\" → \".join(phases[-4:])}')
-print(f'  ${BOLD}ADRs:${NC}           {adrs} recorded')
-if ext_skills:
-    print(f'  ${BOLD}Extension Skills:${NC} {\", \".join(ext_skills)}')
-" 2>/dev/null || echo "  ⚠️  Could not parse contract"
-else
-  echo -e "  ${YELLOW}⚠️  No contract found${NC}"
-fi
-
-# === Telemetry ===
-echo ""
-echo -e "${BOLD}⏱  Telemetry${NC}"
-if [ -f "$TELEMETRY_DIR/summary.json" ] && [ -n "$PYTHON_CMD" ]; then
-  $PYTHON_CMD -c "
-import json
-with open('$TELEMETRY_DIR/summary.json') as f:
-    t = json.load(f)
-total_s = t.get('total_elapsed_s', 0)
-phases = t.get('phases_completed', [])
-print(f'  Total time:  {total_s}s across {len(phases)} phases')
-" 2>/dev/null
-else
-  echo -e "  ${YELLOW}No telemetry data yet${NC}"
-fi
-
-# === Rules ===
-echo ""
-echo -e "${BOLD}📋 Rules${NC}"
-if [ -f "$RULES_FILE" ] && [ -n "$PYTHON_CMD" ]; then
-  $PYTHON_CMD -c "
-import json
-with open('$RULES_FILE') as f:
-    r = json.load(f)
-rules = r.get('rules', [])
-critical = [x for x in rules if x.get('severity') == 'CRITICAL']
-high = [x for x in rules if x.get('severity') == 'HIGH']
-    mcps = list(r.get('required_mcps', {}).keys())
-    mcps = [m for m in mcps if m != 'description']
-print(f'  {len(critical)} CRITICAL rules, {len(high)} HIGH rules')
-if mcps:
-    print(f'  Required MCPs: {\", \".join(mcps)}')
-" 2>/dev/null
-else
-  echo -e "  ${YELLOW}No rules.json${NC}"
-fi
-
-# === Quick actions ===
-echo ""
-echo -e "${BOLD}⚡ Quick Actions${NC}"
-echo "  bash .opencode/src/doctor.sh    — Run diagnostics"
-echo "  bash .opencode/src/telemetry.sh  — View telemetry details"
-echo "  bash .opencode/src/adr.sh        — Record new ADR"
-echo ""

package/src/telemetry.sh

@@ -1,83 +0,0 @@
-#!/usr/bin/env bash
-# opencode-kit telemetry — view phase telemetry
-# Usage: bash src/telemetry.sh [--json|--summary|--phases]
-set -euo pipefail
-
-SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
-# shellcheck source=./platform.sh
-. "$SCRIPT_DIR/platform.sh"
-
-TELEMETRY_DIR=".opencode/telemetry"
-CONTRACT_FILE=".opencode/orchestration/contract.json"
-
-RED='\033[0;31m'
-GREEN='\033[0;32m'
-YELLOW='\033[1;33m'
-CYAN='\033[0;36m'
-NC='\033[0m'
-
-MODE="${1:-summary}"
-
-echo -e "${CYAN}[opencode-kit] 📊 Telemetry${NC}"
-echo ""
-
-case "$MODE" in
-  --json)
-    if [ -f "$TELEMETRY_DIR/summary.json" ]; then
-      cat "$TELEMETRY_DIR/summary.json"
-    else
-      echo -e "${YELLOW}No telemetry data yet. Run a phase first.${NC}"
-    fi
-    ;;
-  --phases)
-    if [ -f "$TELEMETRY_DIR/phases.jsonl" ]; then
-      echo "Phase transitions:"
-      $PYTHON_CMD -c "
-import sys, json
-for line in sys.stdin:
-    line = line.strip()
-    if not line:
-        continue
-    d = json.loads(line)
-    from_ = d.get('from', '?')
-    to_ = d.get('to', '?')
-    ms = d.get('elapsed_ms', 0)
-    print(f'  {from_:20s} → {to_:20s}  {ms/1000:5.1f}s')
-" < "$TELEMETRY_DIR/phases.jsonl" 2>/dev/null || echo -e "${YELLOW}Could not parse phase data${NC}"
-    else
-      echo -e "${YELLOW}No phase data yet.${NC}"
-    fi
-    ;;
-  --summary|*)
-    if [ -f "$TELEMETRY_DIR/summary.json" ]; then
-      read -r TOTAL_S PHASES < <(TELEMETRY_DIR="$TELEMETRY_DIR" $PYTHON_CMD -c "
-import json, os
-d = json.load(open(os.environ['TELEMETRY_DIR'] + '/summary.json'))
-print(d.get('total_elapsed_s', 0))
-print(len(d.get('phases_completed', [])))
-" 2>/dev/null || echo -e "0\n0")
-      echo "  Total elapsed: ${TOTAL_S}s"
-      echo "  Phases completed: $PHASES"
-      echo ""
-      echo "  Latest phases:"
-      tail -5 "$TELEMETRY_DIR/phases.jsonl" 2>/dev/null | $PYTHON_CMD -c "
-import sys, json
-for line in sys.stdin:
-    line = line.strip()
-    if not line:
-        continue
-    d = json.loads(line)
-    ts = d.get('ts', '?')
-    if ts != '?':
-        ts = ts.split('T')[1].split('.')[0] if 'T' in ts else ts
-    from_ = d.get('from', '?')
-    to_ = d.get('to', '?')
-    ms = d.get('elapsed_ms', 0)
-    print(f'    {ts}  {from_} → {to_}  ({ms//1000}s)')
-" 2>/dev/null || echo -e "${YELLOW}Could not parse phase data${NC}"
-    else
-      echo -e "${YELLOW}No telemetry data yet. Run a phase first.${NC}"
-      echo "  Phases are recorded automatically by postflight.sh"
-    fi
-    ;;
-esac