mindsystem-cc 3.20.0 → 3.22.0

package/scripts/archive-milestone-phases.sh

@@ -1,138 +0,0 @@
-#!/bin/bash
-#
-# archive-milestone-phases.sh
-# Consolidates phase summaries, deletes raw artifacts, and moves phase
-# directories to the milestone archive.
-#
-# Usage: ./scripts/archive-milestone-phases.sh <start_phase> <end_phase> <version>
-# Example: ./scripts/archive-milestone-phases.sh 1 6 v1.0
-
-set -e
-
-# --- Validation ---
-if [ -z "$1" ] || [ -z "$2" ] || [ -z "$3" ]; then
-  echo "Error: Three arguments required"
-  echo "Usage: $0 <start_phase> <end_phase> <version>"
-  exit 1
-fi
-
-START="$1"
-END="$2"
-VERSION="$3"
-
-if ! [[ "$START" =~ ^[0-9]+$ ]] || ! [[ "$END" =~ ^[0-9]+$ ]]; then
-  echo "Error: start_phase and end_phase must be numeric"
-  echo "Usage: $0 <start_phase> <end_phase> <version>"
-  exit 1
-fi
-
-if [ "$START" -gt "$END" ]; then
-  echo "Error: Start phase ($START) cannot exceed end phase ($END)"
-  exit 1
-fi
-
-# --- Find .planning from git root ---
-GIT_ROOT=$(git rev-parse --show-toplevel 2>/dev/null)
-if [ -z "$GIT_ROOT" ]; then
-  echo "Error: Not in a git repository"
-  exit 1
-fi
-
-PHASES_DIR="$GIT_ROOT/.planning/phases"
-if [ ! -d "$PHASES_DIR" ]; then
-  echo "Error: Phases directory not found at $PHASES_DIR"
-  exit 1
-fi
-
-MILESTONE_DIR="$GIT_ROOT/.planning/milestones/$VERSION"
-if [ ! -d "$MILESTONE_DIR" ]; then
-  echo "Error: Milestone directory not found at $MILESTONE_DIR"
-  echo "Run archive_milestone step first to create it"
-  exit 1
-fi
-
-# --- Helper: check if phase number is in range (supports decimals like 02.1) ---
-in_range() {
-  local phase_num="$1"
-  echo "$phase_num" | awk -v s="$START" -v e="$END" '{
-    # Strip leading zeros for comparison
-    val = $1 + 0
-    if (val >= s && val <= e + 0.999) exit 0
-    else exit 1
-  }'
-}
-
-# --- Stage 1: Consolidate summaries ---
-SUMMARIES_FILE="$MILESTONE_DIR/PHASE-SUMMARIES.md"
-SUMMARY_COUNT=0
-
-echo "# Phase Summaries: $VERSION" > "$SUMMARIES_FILE"
-echo "" >> "$SUMMARIES_FILE"
-
-for dir in "$PHASES_DIR"/*/; do
-  [ -d "$dir" ] || continue
-  dirname=$(basename "$dir")
-  phase_num="${dirname%%-*}"
-  phase_name="${dirname#*-}"
-
-  if in_range "$phase_num"; then
-    has_summaries=false
-    for f in "$dir"/*-SUMMARY.md; do
-      [ -f "$f" ] || continue
-      if [ "$has_summaries" = false ]; then
-        echo "## Phase $phase_num: $phase_name" >> "$SUMMARIES_FILE"
-        echo "" >> "$SUMMARIES_FILE"
-        has_summaries=true
-      fi
-      plan_file=$(basename "$f")
-      plan_id="${plan_file%-SUMMARY.md}"
-      echo "### $plan_id" >> "$SUMMARIES_FILE"
-      echo "" >> "$SUMMARIES_FILE"
-      cat "$f" >> "$SUMMARIES_FILE"
-      echo "" >> "$SUMMARIES_FILE"
-      SUMMARY_COUNT=$((SUMMARY_COUNT + 1))
-    done
-  fi
-done
-
-echo "Stage 1: Consolidated $SUMMARY_COUNT summaries to PHASE-SUMMARIES.md"
-
-# --- Stage 2: Delete artifacts ---
-DELETED=0
-for dir in "$PHASES_DIR"/*/; do
-  [ -d "$dir" ] || continue
-  dirname=$(basename "$dir")
-  phase_num="${dirname%%-*}"
-
-  if in_range "$phase_num"; then
-    for f in "$dir"/*-CONTEXT.md "$dir"/*-DESIGN.md "$dir"/*-RESEARCH.md \
-             "$dir"/*-SUMMARY.md "$dir"/*-UAT.md "$dir"/*-VERIFICATION.md \
-             "$dir"/*-EXECUTION-ORDER.md; do
-      if [ -f "$f" ]; then
-        rm -f "$f"
-        DELETED=$((DELETED + 1))
-      fi
-    done
-  fi
-done
-
-echo "Stage 2: Deleted $DELETED artifact files"
-
-# --- Stage 3: Move phase directories ---
-mkdir -p "$MILESTONE_DIR/phases"
-MOVED=0
-for dir in "$PHASES_DIR"/*/; do
-  [ -d "$dir" ] || continue
-  dirname=$(basename "$dir")
-  phase_num="${dirname%%-*}"
-
-  if in_range "$phase_num"; then
-    mv "$dir" "$MILESTONE_DIR/phases/$dirname"
-    MOVED=$((MOVED + 1))
-  fi
-done
-
-echo "Stage 3: Moved $MOVED phase directories to milestones/$VERSION/phases/"
-echo ""
-echo "Archive complete: $SUMMARY_COUNT summaries, $DELETED artifacts deleted, $MOVED dirs moved"
-exit 0

package/scripts/doctor-scan.sh

@@ -1,402 +0,0 @@
-#!/bin/bash
-#
-# doctor-scan.sh
-# Single-pass diagnostic scan of the .planning/ tree.
-# Reports on 6 health check categories with structured output.
-#
-# Usage: ./scripts/doctor-scan.sh
-#
-# Exit codes:
-#   0 — all checks pass
-#   1 — one or more checks failed
-#   2 — .planning/ or config.json missing (cannot scan)
-
-set -e
-
-# --- Find .planning from git root ---
-GIT_ROOT=$(git rev-parse --show-toplevel 2>/dev/null)
-if [ -z "$GIT_ROOT" ]; then
-  echo "Error: Not in a git repository"
-  exit 2
-fi
-
-PLANNING="$GIT_ROOT/.planning"
-if [ ! -d "$PLANNING" ]; then
-  echo "Error: No .planning/ directory found"
-  exit 2
-fi
-
-CONFIG="$PLANNING/config.json"
-if [ ! -f "$CONFIG" ]; then
-  echo "Error: No config.json found at $CONFIG"
-  exit 2
-fi
-
-MILESTONES_FILE="$PLANNING/MILESTONES.md"
-PHASES_DIR="$PLANNING/phases"
-MILESTONES_DIR="$PLANNING/milestones"
-KNOWLEDGE_DIR="$PLANNING/knowledge"
-
-PASS_COUNT=0
-FAIL_COUNT=0
-SKIP_COUNT=0
-FAILED_CHECKS=""
-
-# --- Helper: record check result ---
-record_result() {
-  local status="$1"
-  local name="$2"
-  case "$status" in
-    PASS) PASS_COUNT=$((PASS_COUNT + 1)) ;;
-    FAIL) FAIL_COUNT=$((FAIL_COUNT + 1)); FAILED_CHECKS="$FAILED_CHECKS $name" ;;
-    SKIP) SKIP_COUNT=$((SKIP_COUNT + 1)) ;;
-  esac
-}
-
-# --- Helper: parse phase numbers from a "Phases completed" line ---
-# Outputs one phase number per line. Handles:
-#   - Range format: "1-6" → 1 2 3 4 5 6
-#   - Comma-separated: "8, 8.3, 9, 10" → 8 8.3 9 10
-#   - Mixed (multiple milestone entries each handled independently)
-parse_phase_numbers() {
-  local line="$1"
-  local range
-  range=$(echo "$line" | grep -o '[0-9]\+-[0-9]\+' || true)
-  if [ -n "$range" ]; then
-    local range_start range_end
-    range_start=$(echo "$range" | cut -d'-' -f1)
-    range_end=$(echo "$range" | cut -d'-' -f2)
-    seq "$range_start" "$range_end"
-  else
-    echo "$line" | sed 's/.*://' | grep -oE '[0-9]+(\.[0-9]+)?' || true
-  fi
-}
-
-# --- Helper: format phase number as zero-padded directory prefix ---
-# Integer (9) → "09", Decimal (8.3) → "08.3"
-format_phase_prefix() {
-  local phase="$1"
-  if echo "$phase" | grep -q '\.'; then
-    local int_part dec_part
-    int_part=$(echo "$phase" | cut -d'.' -f1)
-    dec_part=$(echo "$phase" | cut -d'.' -f2)
-    printf "%02d.%s" "$int_part" "$dec_part"
-  else
-    printf "%02d" "$phase"
-  fi
-}
-
-# ============================================================
-# CHECK 1: Subsystem Vocabulary
-# ============================================================
-echo "=== Subsystem Vocabulary ==="
-
-SUBSYSTEM_COUNT=$(jq -r '.subsystems // [] | length' "$CONFIG" 2>/dev/null || echo "0")
-
-if [ "$SUBSYSTEM_COUNT" -eq 0 ]; then
-  echo "Status: FAIL"
-  echo "No subsystems array in config.json (or empty)"
-  record_result "FAIL" "Subsystem Vocabulary"
-else
-  echo "Subsystems: $SUBSYSTEM_COUNT configured"
-  jq -r '.subsystems[]' "$CONFIG" 2>/dev/null | sed 's/^/  - /'
-
-  # Run artifact scan to check for mismatches
-  SCAN_SCRIPT="$(dirname "$0")/scan-artifact-subsystems.sh"
-  if [ -x "$SCAN_SCRIPT" ]; then
-    CANONICAL=$(jq -r '.subsystems[]' "$CONFIG" 2>/dev/null)
-    ARTIFACT_VALUES=$("$SCAN_SCRIPT" --values-only 2>/dev/null | grep -v '^===' | sort -u)
-    MISMATCHES=""
-    while IFS= read -r val; do
-      [ -z "$val" ] && continue
-      if ! echo "$CANONICAL" | grep -qx "$val"; then
-        MISMATCHES="$MISMATCHES $val"
-      fi
-    done <<< "$ARTIFACT_VALUES"
-
-    if [ -n "$MISMATCHES" ]; then
-      echo "Status: FAIL"
-      echo "Artifact values not in canonical list:$MISMATCHES"
-      record_result "FAIL" "Subsystem Vocabulary"
-    else
-      ARTIFACT_COUNT=$("$SCAN_SCRIPT" --values-only 2>/dev/null | grep -v '^===' | wc -l | tr -d ' ')
-      echo "Artifacts scanned: $ARTIFACT_COUNT (all OK)"
-      echo "Status: PASS"
-      record_result "PASS" "Subsystem Vocabulary"
-    fi
-  else
-    echo "Status: PASS"
-    echo "(scan-artifact-subsystems.sh not found — skipped artifact validation)"
-    record_result "PASS" "Subsystem Vocabulary"
-  fi
-fi
-echo ""
-
-# ============================================================
-# CHECK 2: Milestone Directory Structure
-# ============================================================
-echo "=== Milestone Directory Structure ==="
-
-if [ ! -d "$MILESTONES_DIR" ]; then
-  # No milestones directory at all — check if MILESTONES.md has entries
-  if [ -f "$MILESTONES_FILE" ] && grep -q "^## " "$MILESTONES_FILE" 2>/dev/null; then
-    echo "Status: FAIL"
-    echo "MILESTONES.md has entries but no milestones/ directory"
-    record_result "FAIL" "Milestone Directory Structure"
-  else
-    echo "Status: SKIP"
-    echo "No completed milestones"
-    record_result "SKIP" "Milestone Directory Structure"
-  fi
-else
-  # Look for flat files matching v*-*.md directly in milestones/
-  FLAT_FILES=""
-  FLAT_COUNT=0
-  for f in "$MILESTONES_DIR"/v*-*.md; do
-    [ -f "$f" ] || continue
-    FLAT_FILES="$FLAT_FILES  $(basename "$f")"$'\n'
-    FLAT_COUNT=$((FLAT_COUNT + 1))
-  done
-
-  if [ "$FLAT_COUNT" -gt 0 ]; then
-    echo "Status: FAIL"
-    echo "Found $FLAT_COUNT flat file(s) in milestones/ (old format):"
-    echo "$FLAT_FILES"
-    # Check if corresponding versioned directories exist
-    for f in "$MILESTONES_DIR"/v*-*.md; do
-      [ -f "$f" ] || continue
-      fname=$(basename "$f")
-      # Extract version prefix: v0.1-ROADMAP.md -> v0.1
-      version=$(echo "$fname" | sed 's/^\(v[0-9.]*\)-.*/\1/')
-      if [ -d "$MILESTONES_DIR/$version" ]; then
-        echo "  $fname → directory $version/ exists (can restructure)"
-      else
-        echo "  $fname → directory $version/ missing (need to create)"
-      fi
-    done
-    record_result "FAIL" "Milestone Directory Structure"
-  else
-    # Count versioned directories
-    DIR_COUNT=0
-    for d in "$MILESTONES_DIR"/v*/; do
-      [ -d "$d" ] || continue
-      DIR_COUNT=$((DIR_COUNT + 1))
-    done
-
-    if [ "$DIR_COUNT" -eq 0 ]; then
-      echo "Status: SKIP"
-      echo "No completed milestones"
-      record_result "SKIP" "Milestone Directory Structure"
-    else
-      echo "Status: PASS"
-      echo "$DIR_COUNT versioned milestone directories"
-      record_result "PASS" "Milestone Directory Structure"
-    fi
-  fi
-fi
-echo ""
-
-# ============================================================
-# CHECK 3: Phase Archival
-# ============================================================
-echo "=== Phase Archival ==="
-
-if [ ! -f "$MILESTONES_FILE" ] || ! grep -q "Phases completed" "$MILESTONES_FILE" 2>/dev/null; then
-  echo "Status: SKIP"
-  echo "No completed milestones with phase ranges in MILESTONES.md"
-  record_result "SKIP" "Phase Archival"
-else
-  ORPHAN_COUNT=0
-  ORPHAN_LIST=""
-
-  # Parse each milestone's completed phases from MILESTONES.md
-  while IFS= read -r line; do
-    while IFS= read -r phase_num; do
-      [ -z "$phase_num" ] && continue
-      prefix=$(format_phase_prefix "$phase_num")
-      for dir in "$PHASES_DIR"/${prefix}-*/; do
-        [ -d "$dir" ] || continue
-        dirname=$(basename "$dir")
-        ORPHAN_COUNT=$((ORPHAN_COUNT + 1))
-        ORPHAN_LIST="$ORPHAN_LIST  $dirname (should be archived)"$'\n'
-      done
-    done < <(parse_phase_numbers "$line")
-  done < <(grep "Phases completed" "$MILESTONES_FILE")
-
-  if [ "$ORPHAN_COUNT" -gt 0 ]; then
-    echo "Status: FAIL"
-    echo "Found $ORPHAN_COUNT orphaned phase directories from completed milestones:"
-    echo "$ORPHAN_LIST"
-    record_result "FAIL" "Phase Archival"
-  else
-    echo "Status: PASS"
-    echo "All completed milestone phases are archived"
-    record_result "PASS" "Phase Archival"
-  fi
-fi
-echo ""
-
-# ============================================================
-# CHECK 4: Knowledge Files
-# ============================================================
-echo "=== Knowledge Files ==="
-
-if [ "$SUBSYSTEM_COUNT" -eq 0 ]; then
-  echo "Status: SKIP"
-  echo "No subsystems configured — knowledge check requires subsystem vocabulary"
-  record_result "SKIP" "Knowledge Files"
-elif [ ! -d "$KNOWLEDGE_DIR" ]; then
-  echo "Status: FAIL"
-  echo "Knowledge directory missing: .planning/knowledge/"
-  echo "Expected files for $SUBSYSTEM_COUNT subsystems"
-  record_result "FAIL" "Knowledge Files"
-else
-  MISSING_KNOWLEDGE=""
-  MISSING_COUNT=0
-  PRESENT_COUNT=0
-  while IFS= read -r subsystem; do
-    [ -z "$subsystem" ] && continue
-    if [ -f "$KNOWLEDGE_DIR/$subsystem.md" ]; then
-      PRESENT_COUNT=$((PRESENT_COUNT + 1))
-    else
-      MISSING_COUNT=$((MISSING_COUNT + 1))
-      MISSING_KNOWLEDGE="$MISSING_KNOWLEDGE  $subsystem.md"$'\n'
-    fi
-  done < <(jq -r '.subsystems[]' "$CONFIG" 2>/dev/null)
-
-  # Check for orphaned knowledge files (not in subsystem list)
-  ORPHAN_KNOWLEDGE=""
-  ORPHAN_K_COUNT=0
-  for f in "$KNOWLEDGE_DIR"/*.md; do
-    [ -f "$f" ] || continue
-    fname=$(basename "$f" .md)
-    if ! jq -r '.subsystems[]' "$CONFIG" 2>/dev/null | grep -qx "$fname"; then
-      ORPHAN_K_COUNT=$((ORPHAN_K_COUNT + 1))
-      ORPHAN_KNOWLEDGE="$ORPHAN_KNOWLEDGE  $fname.md (not in subsystems list)"$'\n'
-    fi
-  done
-
-  if [ "$MISSING_COUNT" -gt 0 ] || [ "$ORPHAN_K_COUNT" -gt 0 ]; then
-    echo "Status: FAIL"
-    echo "Coverage: $PRESENT_COUNT/$SUBSYSTEM_COUNT subsystems have knowledge files"
-    if [ "$MISSING_COUNT" -gt 0 ]; then
-      echo "Missing:"
-      echo "$MISSING_KNOWLEDGE"
-    fi
-    if [ "$ORPHAN_K_COUNT" -gt 0 ]; then
-      echo "Orphaned:"
-      echo "$ORPHAN_KNOWLEDGE"
-    fi
-    record_result "FAIL" "Knowledge Files"
-  else
-    echo "Status: PASS"
-    echo "All $SUBSYSTEM_COUNT subsystems have knowledge files"
-    record_result "PASS" "Knowledge Files"
-  fi
-fi
-echo ""
-
-# ============================================================
-# CHECK 5: Phase Summaries
-# ============================================================
-echo "=== Phase Summaries ==="
-
-if [ ! -d "$MILESTONES_DIR" ]; then
-  echo "Status: SKIP"
-  echo "No milestones directory"
-  record_result "SKIP" "Phase Summaries"
-else
-  MISSING_SUMMARIES=""
-  MISSING_S_COUNT=0
-  CHECKED=0
-
-  for d in "$MILESTONES_DIR"/v*/; do
-    [ -d "$d" ] || continue
-    CHECKED=$((CHECKED + 1))
-    version=$(basename "$d")
-    if [ ! -f "$d/PHASE-SUMMARIES.md" ]; then
-      MISSING_S_COUNT=$((MISSING_S_COUNT + 1))
-      MISSING_SUMMARIES="$MISSING_SUMMARIES  $version/PHASE-SUMMARIES.md"$'\n'
-    fi
-  done
-
-  if [ "$CHECKED" -eq 0 ]; then
-    echo "Status: SKIP"
-    echo "No versioned milestone directories"
-    record_result "SKIP" "Phase Summaries"
-  elif [ "$MISSING_S_COUNT" -gt 0 ]; then
-    echo "Status: FAIL"
-    echo "Missing PHASE-SUMMARIES.md in $MISSING_S_COUNT milestone(s):"
-    echo "$MISSING_SUMMARIES"
-    record_result "FAIL" "Phase Summaries"
-  else
-    echo "Status: PASS"
-    echo "All $CHECKED milestones have PHASE-SUMMARIES.md"
-    record_result "PASS" "Phase Summaries"
-  fi
-fi
-echo ""
-
-# ============================================================
-# CHECK 6: PLAN Cleanup
-# ============================================================
-echo "=== PLAN Cleanup ==="
-
-if [ ! -f "$MILESTONES_FILE" ] || ! grep -q "Phases completed" "$MILESTONES_FILE" 2>/dev/null; then
-  echo "Status: SKIP"
-  echo "No completed milestones — active phase PLANs are expected"
-  record_result "SKIP" "PLAN Cleanup"
-else
-  LEFTOVER_PLANS=""
-  LEFTOVER_COUNT=0
-
-  # Check phases/ for PLANs belonging to completed milestones
-  while IFS= read -r line; do
-    while IFS= read -r phase_num; do
-      [ -z "$phase_num" ] && continue
-      prefix=$(format_phase_prefix "$phase_num")
-      for plan in "$PHASES_DIR"/${prefix}-*/*-PLAN.md; do
-        [ -f "$plan" ] || continue
-        LEFTOVER_COUNT=$((LEFTOVER_COUNT + 1))
-        LEFTOVER_PLANS="$LEFTOVER_PLANS  $(echo "$plan" | sed "s|$GIT_ROOT/.planning/||")"$'\n'
-      done
-    done < <(parse_phase_numbers "$line")
-  done < <(grep "Phases completed" "$MILESTONES_FILE")
-
-  # Check archived milestone phase directories for leftover PLANs
-  for d in "$MILESTONES_DIR"/v*/phases/*/; do
-    [ -d "$d" ] || continue
-    for plan in "$d"*-PLAN.md; do
-      [ -f "$plan" ] || continue
-      LEFTOVER_COUNT=$((LEFTOVER_COUNT + 1))
-      LEFTOVER_PLANS="$LEFTOVER_PLANS  $(echo "$plan" | sed "s|$GIT_ROOT/.planning/||")"$'\n'
-    done
-  done
-
-  if [ "$LEFTOVER_COUNT" -gt 0 ]; then
-    echo "Status: FAIL"
-    echo "Found $LEFTOVER_COUNT leftover PLAN file(s) in completed phases:"
-    echo "$LEFTOVER_PLANS"
-    record_result "FAIL" "PLAN Cleanup"
-  else
-    echo "Status: PASS"
-    echo "No leftover PLAN files in completed phases"
-    record_result "PASS" "PLAN Cleanup"
-  fi
-fi
-echo ""
-
-# ============================================================
-# SUMMARY
-# ============================================================
-TOTAL=$((PASS_COUNT + FAIL_COUNT + SKIP_COUNT))
-echo "=== Summary ==="
-echo "Checks: $TOTAL total, $PASS_COUNT passed, $FAIL_COUNT failed, $SKIP_COUNT skipped"
-
-if [ "$FAIL_COUNT" -gt 0 ]; then
-  echo "Issues:$FAILED_CHECKS"
-  exit 1
-else
-  echo "All checks passed"
-  exit 0
-fi