mindsystem-cc 3.20.0 → 3.21.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

package/scripts/gather-milestone-stats.sh

@@ -1,179 +0,0 @@
-#!/bin/bash
-#
-# gather-milestone-stats.sh
-# Gathers milestone readiness status and statistics from the filesystem
-# and git history. Outputs structured text for the LLM to present.
-#
-# Usage: ./scripts/gather-milestone-stats.sh <start_phase> <end_phase>
-# Example: ./scripts/gather-milestone-stats.sh 1 6
-
-set -e
-
-# --- Validation ---
-if [ -z "$1" ] || [ -z "$2" ]; then
-  echo "Error: Two arguments required"
-  echo "Usage: $0 <start_phase> <end_phase>"
-  exit 1
-fi
-
-START="$1"
-END="$2"
-
-if ! [[ "$START" =~ ^[0-9]+$ ]] || ! [[ "$END" =~ ^[0-9]+$ ]]; then
-  echo "Error: Both arguments must be numeric"
-  echo "Usage: $0 <start_phase> <end_phase>"
-  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
-
-# --- 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" '{
-    val = $1 + 0
-    if (val >= s && val <= e + 0.999) exit 0
-    else exit 1
-  }'
-}
-
-# ============================================================
-# READINESS
-# ============================================================
-echo "=== Readiness ==="
-echo ""
-
-PHASE_COUNT=0
-PLAN_COUNT=0
-COMPLETE=0
-INCOMPLETE_LIST=""
-PHASE_DETAILS=""
-
-for dir in "$PHASES_DIR"/*/; do
-  [ -d "$dir" ] || continue
-  dirname=$(basename "$dir")
-  phase_num="${dirname%%-*}"
-  phase_name="${dirname#*-}"
-
-  if in_range "$phase_num"; then
-    PHASE_COUNT=$((PHASE_COUNT + 1))
-    phase_plans=0
-    phase_complete=0
-
-    for plan in "$dir"/*-PLAN.md; do
-      [ -f "$plan" ] || continue
-      PLAN_COUNT=$((PLAN_COUNT + 1))
-      phase_plans=$((phase_plans + 1))
-      plan_base=$(basename "$plan" -PLAN.md)
-      summary="$dir/${plan_base}-SUMMARY.md"
-      if [ -f "$summary" ]; then
-        COMPLETE=$((COMPLETE + 1))
-        phase_complete=$((phase_complete + 1))
-      else
-        INCOMPLETE_LIST+="  $(basename "$dir")/$(basename "$plan")"$'\n'
-      fi
-    done
-
-    PHASE_DETAILS+="- Phase $phase_num: $phase_name ($phase_complete/$phase_plans plans)"$'\n'
-  fi
-done
-
-echo "Phases: $PHASE_COUNT (range $START-$END)"
-echo "Plans: $PLAN_COUNT total, $COMPLETE complete"
-echo ""
-echo "$PHASE_DETAILS"
-
-if [ "$COMPLETE" -eq "$PLAN_COUNT" ] && [ "$PLAN_COUNT" -gt 0 ]; then
-  echo "Status: READY"
-else
-  INCOMPLETE=$((PLAN_COUNT - COMPLETE))
-  echo "Incomplete ($INCOMPLETE):"
-  echo "$INCOMPLETE_LIST"
-  echo "Status: NOT READY"
-fi
-
-# ============================================================
-# GIT STATS
-# ============================================================
-echo ""
-echo "=== Git Stats ==="
-echo ""
-
-# Collect commits matching Mindsystem phase convention: feat(XX-YY), fix(XX-YY), etc.
-ALL_COMMITS=""
-for i in $(seq "$START" "$END"); do
-  phase=$(printf "%02d" "$i")
-  commits=$(git log --all --format="%H %ai %s" --grep="($phase-" 2>/dev/null || true)
-  if [ -n "$commits" ]; then
-    ALL_COMMITS+="$commits"$'\n'
-  fi
-done
-
-# Also capture decimal phase commits (e.g., 02.1 inserted phases)
-for dir in "$PHASES_DIR"/*/; do
-  [ -d "$dir" ] || continue
-  dirname=$(basename "$dir")
-  phase_num="${dirname%%-*}"
-  case "$phase_num" in
-    *.*) # Decimal phase — not captured by seq
-      if in_range "$phase_num"; then
-        commits=$(git log --all --format="%H %ai %s" --grep="($phase_num-" 2>/dev/null || true)
-        if [ -n "$commits" ]; then
-          ALL_COMMITS+="$commits"$'\n'
-        fi
-      fi
-      ;;
-  esac
-done
-
-# Remove empty lines, deduplicate, sort by date
-ALL_COMMITS=$(echo "$ALL_COMMITS" | grep -v '^$' | sort -u -k2,3)
-
-if [ -n "$ALL_COMMITS" ]; then
-  COMMIT_COUNT=$(echo "$ALL_COMMITS" | wc -l | tr -d ' ')
-  FIRST_LINE=$(echo "$ALL_COMMITS" | head -1)
-  LAST_LINE=$(echo "$ALL_COMMITS" | tail -1)
-  FIRST_HASH=$(echo "$FIRST_LINE" | awk '{print $1}')
-  LAST_HASH=$(echo "$LAST_LINE" | awk '{print $1}')
-  FIRST_DATE=$(echo "$FIRST_LINE" | awk '{print $2}')
-  LAST_DATE=$(echo "$LAST_LINE" | awk '{print $2}')
-  FIRST_MSG=$(echo "$FIRST_LINE" | cut -d' ' -f4-)
-  LAST_MSG=$(echo "$LAST_LINE" | cut -d' ' -f4-)
-
-  # Calculate days
-  DAYS=$(python3 -c "from datetime import date; print((date.fromisoformat('$LAST_DATE') - date.fromisoformat('$FIRST_DATE')).days)" 2>/dev/null || echo "?")
-
-  echo "Commits: $COMMIT_COUNT"
-  echo "Git range: ${FIRST_HASH:0:7}..${LAST_HASH:0:7}"
-  echo "First: $FIRST_DATE — $FIRST_MSG"
-  echo "Last:  $LAST_DATE — $LAST_MSG"
-  echo "Timeline: $DAYS days ($FIRST_DATE → $LAST_DATE)"
-
-  # Diff stats for the range
-  DIFFSTAT=$(git diff --shortstat "${FIRST_HASH}^..${LAST_HASH}" 2>/dev/null || true)
-  if [ -n "$DIFFSTAT" ]; then
-    echo "Changes:$DIFFSTAT"
-  fi
-else
-  echo "No commits found matching phase patterns (expected 'feat(XX-YY): ...')"
-  echo "Determine git range manually from git log"
-fi
-
-echo ""
-exit 0

package/scripts/generate-adhoc-patch.sh

@@ -1,79 +0,0 @@
-#!/bin/bash
-#
-# generate-adhoc-patch.sh
-# Generates a patch file from an adhoc commit, excluding documentation and generated files.
-#
-# Usage: ./scripts/generate-adhoc-patch.sh <commit-hash> <output-path>
-# Example: ./scripts/generate-adhoc-patch.sh abc123f .planning/adhoc/2026-01-26-fix-bug.patch
-
-set -e
-
-# --- Configuration ---
-# Same exclusions as generate-phase-patch.sh
-EXCLUSIONS=(
-  # Documentation
-  '.planning'
-
-  # Flutter/Dart generated
-  '*.g.dart'
-  '*.freezed.dart'
-  '*.gr.dart'
-  'generated'
-  '.dart_tool'
-
-  # Next.js/TypeScript generated
-  'node_modules'
-  '.next'
-  'dist'
-  'build'
-  '*.d.ts'
-  '.turbo'
-
-  # Common build artifacts
-  '*.lock'
-)
-
-# --- Parse arguments ---
-COMMIT_HASH="$1"
-OUTPUT_PATH="$2"
-
-# --- Validation ---
-if [ -z "$COMMIT_HASH" ] || [ -z "$OUTPUT_PATH" ]; then
-  echo "Error: Commit hash and output path required"
-  echo "Usage: $0 <commit-hash> <output-path>"
-  exit 1
-fi
-
-# --- Find 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
-cd "$GIT_ROOT"
-
-# --- Verify commit exists ---
-if ! git rev-parse "$COMMIT_HASH" >/dev/null 2>&1; then
-  echo "Error: Commit $COMMIT_HASH not found"
-  exit 1
-fi
-
-# --- Build exclusion arguments ---
-EXCLUDE_ARGS=""
-for pattern in "${EXCLUSIONS[@]}"; do
-  EXCLUDE_ARGS="$EXCLUDE_ARGS ':!$pattern'"
-done
-
-# --- Generate diff from parent commit to specified commit ---
-eval "git diff \"${COMMIT_HASH}^\" \"$COMMIT_HASH\" -- . $EXCLUDE_ARGS" > "$OUTPUT_PATH"
-
-# --- Check result ---
-if [ ! -s "$OUTPUT_PATH" ]; then
-  rm -f "$OUTPUT_PATH"
-  echo "No implementation changes outside excluded patterns"
-  echo "Patch skipped"
-  exit 0
-fi
-
-PATCH_LINES=$(wc -l < "$OUTPUT_PATH" | tr -d ' ')
-echo "Generated: $OUTPUT_PATH ($PATCH_LINES lines)"