@cyperx/clawforge 1.2.0

package/bin/doctor.sh

@@ -0,0 +1,196 @@
+#!/usr/bin/env bash
+# doctor.sh — Diagnose and fix orphaned resources
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+source "${SCRIPT_DIR}/../lib/common.sh"
+
+usage() {
+  cat <<EOF
+Usage: clawforge doctor [options]
+
+Diagnose orphaned sessions, dangling worktrees, stale tasks, and disk usage.
+
+Options:
+  --fix       Auto-fix issues (kill orphans, remove dangling, archive stale)
+  --json      Output as JSON
+  --help      Show this help
+EOF
+}
+
+FIX=false JSON_OUTPUT=false
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --fix)   FIX=true; shift ;;
+    --json)  JSON_OUTPUT=true; shift ;;
+    --help|-h) usage; exit 0 ;;
+    *) log_error "Unknown option: $1"; usage; exit 1 ;;
+  esac
+done
+
+_ensure_registry
+ISSUES=0 FIXED=0
+
+check() {
+  local level="$1" msg="$2"
+  case "$level" in
+    OK)    echo "  ✅ $msg" ;;
+    WARN)  echo "  ⚠️  $msg"; ISSUES=$((ISSUES+1)) ;;
+    ERROR) echo "  ❌ $msg"; ISSUES=$((ISSUES+1)) ;;
+  esac
+}
+
+echo "🩺 ClawForge Doctor"
+echo ""
+
+# 1. Registry integrity
+echo "── Registry ──────────────────────────────"
+if [[ -f "$REGISTRY_FILE" ]]; then
+  if jq empty "$REGISTRY_FILE" 2>/dev/null; then
+    task_count=$(jq '.tasks | length' "$REGISTRY_FILE")
+    check OK "Registry valid ($task_count tasks)"
+  else
+    check ERROR "Registry JSON is malformed"
+    if $FIX; then
+      echo '{"tasks":[]}' > "$REGISTRY_FILE"
+      echo "    → Fixed: reset registry"
+      FIXED=$((FIXED+1))
+    fi
+  fi
+
+  # Duplicate IDs
+  dup_count=$(jq '[.tasks[].id] | group_by(.) | map(select(length > 1)) | length' "$REGISTRY_FILE" 2>/dev/null || echo 0)
+  if [[ "$dup_count" -gt 0 ]]; then
+    check WARN "Found $dup_count duplicate task IDs"
+  else
+    check OK "No duplicate IDs"
+  fi
+else
+  check WARN "No registry file found"
+fi
+
+# 2. Orphaned tmux sessions
+echo ""
+echo "── tmux Sessions ─────────────────────────"
+TMUX_SESSIONS=$(tmux list-sessions -F "#{session_name}" 2>/dev/null || true)
+REGISTERED_SESSIONS=$(jq -r '.tasks[].tmuxSession // empty' "$REGISTRY_FILE" 2>/dev/null | sort -u || true)
+ORPHANS=""
+
+if [[ -n "$TMUX_SESSIONS" ]]; then
+  while IFS= read -r sess; do
+    # Match clawforge-like session names
+    if [[ "$sess" =~ ^agent- ]] || [[ "$sess" =~ ^clawforge- ]] || [[ "$sess" =~ ^sprint ]] || [[ "$sess" =~ ^swarm ]]; then
+      if ! echo "$REGISTERED_SESSIONS" | grep -qxF "$sess"; then
+        check WARN "Orphaned tmux session: $sess"
+        ORPHANS="$ORPHANS $sess"
+        if $FIX; then
+          tmux kill-session -t "$sess" 2>/dev/null || true
+          echo "    → Fixed: killed $sess"
+          FIXED=$((FIXED+1))
+        fi
+      fi
+    fi
+  done <<< "$TMUX_SESSIONS"
+fi
+[[ -z "$ORPHANS" ]] && check OK "No orphaned tmux sessions"
+
+# 3. Dangling worktrees
+echo ""
+echo "── Worktrees ─────────────────────────────"
+DANGLING=0
+WORKTREES=$(jq -r '.tasks[] | select(.status == "done" or .status == "archived" or .status == "cancelled" or .status == "timeout") | .worktree // empty' "$REGISTRY_FILE" 2>/dev/null || true)
+
+if [[ -n "$WORKTREES" ]]; then
+  while IFS= read -r wt; do
+    [[ -z "$wt" ]] && continue
+    if [[ -d "$wt" ]]; then
+      check WARN "Dangling worktree (task complete): $wt"
+      DANGLING=$((DANGLING+1))
+      if $FIX; then
+        rm -rf "$wt" 2>/dev/null || true
+        echo "    → Fixed: removed $wt"
+        FIXED=$((FIXED+1))
+      fi
+    fi
+  done <<< "$WORKTREES"
+fi
+[[ $DANGLING -eq 0 ]] && check OK "No dangling worktrees"
+
+# 4. Stale tasks
+echo ""
+echo "── Stale Tasks ───────────────────────────"
+NOW_MS=$(epoch_ms)
+STALE_CUTOFF=$((NOW_MS - 7 * 86400 * 1000))  # 7 days
+STALE_TASKS=$(jq -r --argjson cutoff "$STALE_CUTOFF"   '.tasks[] | select(.status == "running" and (.startedAt // 0) < $cutoff) | .id'   "$REGISTRY_FILE" 2>/dev/null || true)
+STALE_COUNT=0
+
+if [[ -n "$STALE_TASKS" ]]; then
+  while IFS= read -r id; do
+    [[ -z "$id" ]] && continue
+    check WARN "Stale running task (>7 days): $id"
+    STALE_COUNT=$((STALE_COUNT+1))
+    if $FIX; then
+      registry_update "$id" "status" '"archived"'
+      echo "    → Fixed: archived $id"
+      FIXED=$((FIXED+1))
+    fi
+  done <<< "$STALE_TASKS"
+fi
+[[ $STALE_COUNT -eq 0 ]] && check OK "No stale tasks"
+
+# 5. Merged branches not cleaned
+echo ""
+echo "── Branches ──────────────────────────────"
+BRANCH_ISSUES=0
+TASK_BRANCHES=$(jq -r '.tasks[] | select(.status == "done" or .status == "archived") | .branch // empty' "$REGISTRY_FILE" 2>/dev/null || true)
+TASK_REPOS=$(jq -r '.tasks[] | select(.status == "done" or .status == "archived") | .repo // empty' "$REGISTRY_FILE" 2>/dev/null | sort -u || true)
+
+if [[ -n "$TASK_REPOS" ]]; then
+  while IFS= read -r repo; do
+    [[ -z "$repo" || ! -d "$repo" ]] && continue
+    MERGED=$(git -C "$repo" branch --merged 2>/dev/null | grep -E "sprint/|swarm/|quick/" | sed 's/^[* ]*//' || true)
+    if [[ -n "$MERGED" ]]; then
+      while IFS= read -r br; do
+        check WARN "Merged branch not deleted: $br (in $repo)"
+        BRANCH_ISSUES=$((BRANCH_ISSUES+1))
+        if $FIX; then
+          git -C "$repo" branch -d "$br" 2>/dev/null || true
+          echo "    → Fixed: deleted $br"
+          FIXED=$((FIXED+1))
+        fi
+      done <<< "$MERGED"
+    fi
+  done <<< "$TASK_REPOS"
+fi
+[[ $BRANCH_ISSUES -eq 0 ]] && check OK "No leftover merged branches"
+
+# 6. Disk space
+echo ""
+echo "── Disk Space ────────────────────────────"
+AVAIL_KB=$(df -k . 2>/dev/null | awk 'NR==2{print $4}')
+if [[ -n "$AVAIL_KB" ]]; then
+  AVAIL_GB=$((AVAIL_KB / 1048576))
+  if [[ $AVAIL_GB -lt 1 ]]; then
+    check ERROR "Critically low disk: ${AVAIL_GB}GB free"
+  elif [[ $AVAIL_GB -lt 5 ]]; then
+    check WARN "Low disk: ${AVAIL_GB}GB free"
+  else
+    check OK "Disk space: ${AVAIL_GB}GB free"
+  fi
+else
+  check OK "Disk check skipped (df unavailable)"
+fi
+
+# Summary
+echo ""
+echo "────────────────────────────────────────"
+if [[ $ISSUES -eq 0 ]]; then
+  echo "✅ All checks passed. System is healthy."
+else
+  echo "Found $ISSUES issue(s)."
+  if $FIX; then
+    echo "Fixed $FIXED issue(s)."
+  else
+    echo "Run 'clawforge doctor --fix' to auto-fix."
+  fi
+fi

package/bin/eval.sh

@@ -0,0 +1,217 @@
+#!/usr/bin/env bash
+# eval.sh — Lightweight evaluation logging + weekly summaries
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+source "${SCRIPT_DIR}/../lib/common.sh"
+
+EVAL_DIR="${CLAWFORGE_DIR}/evals"
+RUN_LOG_FILE="${EVAL_DIR}/run-log.jsonl"
+SCORECARD_FILE="${EVAL_DIR}/scorecard.md"
+
+usage() {
+  cat <<USAGE
+Usage: eval.sh <command> [options]
+
+Commands:
+  log        Append one run-eval entry to evals/run-log.jsonl
+  weekly     Print weekly summary from run-log.jsonl
+  compare    Compare two weekly summaries
+  paths      Show eval file paths
+
+log options:
+  --command <name>         Required (sprint|swarm|review|dashboard|memory|init|history)
+  --mode <name>            Required (e.g. quick, auto, multi-repo)
+  --repo <path/name>       Required
+  --status <ok|error|timeout|cancelled>  Required
+  --duration-ms <n>        Required
+  --retries <n>            Default: 0
+  --cost-usd <n>           Default: 0
+  --manual <n>             Manual interventions (default: 0)
+  --tests-passed <true|false>            Default: true
+  --review-comments <n>    Default: 0
+  --reopened <true|false>  Default: false
+  --reverted <true|false>  Default: false
+  --task <text>            Optional
+  --notes <text>           Optional
+
+weekly options:
+  --week <YYYY-WW>         Optional (default: current local week)
+
+compare options:
+  --week-a <YYYY-WW>       Required
+  --week-b <YYYY-WW>       Required
+USAGE
+}
+
+ensure_eval_files() {
+  mkdir -p "$EVAL_DIR"
+  [[ -f "$RUN_LOG_FILE" ]] || : > "$RUN_LOG_FILE"
+  [[ -f "$SCORECARD_FILE" ]] || {
+    cat > "$SCORECARD_FILE" <<'SC'
+# ClawForge Evaluation Scorecard
+
+See evals/run-log.jsonl for raw run entries.
+SC
+  }
+}
+
+current_week() {
+  date +"%G-%V"
+}
+
+week_for_ts() {
+  local ts="$1"
+  python3 - <<PY2
+import datetime
+ms=int("$ts")
+dt=datetime.datetime.fromtimestamp(ms/1000)
+print(dt.strftime("%G-%V"))
+PY2
+}
+
+cmd_log() {
+  local command="" mode="" repo="" status="" duration_ms=""
+  local retries=0 cost_usd=0 manual=0 tests_passed=true review_comments=0 reopened=false reverted=false
+  local task="" notes=""
+
+  while [[ $# -gt 0 ]]; do
+    case "$1" in
+      --command) command="$2"; shift 2 ;;
+      --mode) mode="$2"; shift 2 ;;
+      --repo) repo="$2"; shift 2 ;;
+      --status) status="$2"; shift 2 ;;
+      --duration-ms) duration_ms="$2"; shift 2 ;;
+      --retries) retries="$2"; shift 2 ;;
+      --cost-usd) cost_usd="$2"; shift 2 ;;
+      --manual) manual="$2"; shift 2 ;;
+      --tests-passed) tests_passed="$2"; shift 2 ;;
+      --review-comments) review_comments="$2"; shift 2 ;;
+      --reopened) reopened="$2"; shift 2 ;;
+      --reverted) reverted="$2"; shift 2 ;;
+      --task) task="$2"; shift 2 ;;
+      --notes) notes="$2"; shift 2 ;;
+      --help|-h) usage; exit 0 ;;
+      *) log_error "Unknown log option: $1"; usage; exit 1 ;;
+    esac
+  done
+
+  if [[ -z "$command" || -z "$mode" || -z "$repo" || -z "$status" || -z "$duration_ms" ]]; then
+    log_error "Missing required fields for eval log"
+    usage
+    exit 1
+  fi
+
+  ensure_eval_files
+  local now_iso now_ms run_id
+  now_iso=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
+  now_ms=$(epoch_ms)
+  run_id="run-${now_ms}"
+
+  jq -cn     --arg ts "$now_iso"     --arg runId "$run_id"     --arg command "$command"     --arg mode "$mode"     --arg repo "$repo"     --arg task "$task"     --arg status "$status"     --arg notes "$notes"     --argjson durationMs "$duration_ms"     --argjson retries "$retries"     --argjson costUsd "$cost_usd"     --argjson manualInterventions "$manual"     --argjson testsPassed "$tests_passed"     --argjson reviewComments "$review_comments"     --argjson reopened "$reopened"     --argjson reverted "$reverted"     '{
+      ts:$ts, runId:$runId, command:$command, mode:$mode, repo:$repo, task:$task,
+      status:$status, durationMs:$durationMs, retries:$retries, costUsd:$costUsd,
+      manualInterventions:$manualInterventions,
+      qualityOutcome:{testsPassed:$testsPassed, reviewComments:$reviewComments, reopened:$reopened, reverted:$reverted},
+      notes:$notes
+    }' >> "$RUN_LOG_FILE"
+
+  echo "Logged eval run: $run_id"
+}
+
+summary_for_week() {
+  local week="$1"
+  ensure_eval_files
+
+  jq -rc '. as $o | $o + {week:(($o.ts|fromdateiso8601)*1000)}' "$RUN_LOG_FILE" 2>/dev/null |   while IFS= read -r line; do
+    [[ -z "$line" ]] && continue
+    local ts_ms
+    ts_ms=$(echo "$line" | jq -r '.week')
+    local w
+    w=$(week_for_ts "$ts_ms")
+    if [[ "$w" == "$week" ]]; then
+      echo "$line" | jq -c 'del(.week)'
+    fi
+  done
+}
+
+print_summary() {
+  local week="$1"
+  local entries
+  entries=$(summary_for_week "$week" || true)
+  if [[ -z "$entries" ]]; then
+    echo "No eval entries for week $week"
+    return 0
+  fi
+
+  local total ok errors med_dur retries cost manual
+  total=$(echo "$entries" | wc -l | tr -d ' ')
+  ok=$(echo "$entries" | jq -r 'select(.status=="ok") | .runId' | wc -l | tr -d ' ')
+  errors=$((total - ok))
+  med_dur=$(echo "$entries" | jq -s 'map(.durationMs) | sort | .[(length/2|floor)]')
+  retries=$(echo "$entries" | jq -s 'map(.retries) | add')
+  cost=$(echo "$entries" | jq -s 'map(.costUsd) | add')
+  manual=$(echo "$entries" | jq -s 'map(.manualInterventions) | add')
+
+  echo "Week: $week"
+  echo "Runs: $total"
+  echo "Success: $ok/$total"
+  echo "Errors: $errors"
+  echo "Median duration ms: $med_dur"
+  echo "Total retries: $retries"
+  echo "Total cost usd: $cost"
+  echo "Manual interventions: $manual"
+
+  echo ""
+  echo "By command:"
+  echo "$entries" | jq -s -r 'group_by(.command)[] | "- \(.[0].command): \(length) runs, \([.[]|select(.status=="ok")]|length) ok"'
+}
+
+cmd_weekly() {
+  local week
+  week=$(current_week)
+  while [[ $# -gt 0 ]]; do
+    case "$1" in
+      --week) week="$2"; shift 2 ;;
+      --help|-h) usage; exit 0 ;;
+      *) log_error "Unknown weekly option: $1"; usage; exit 1 ;;
+    esac
+  done
+  print_summary "$week"
+}
+
+cmd_compare() {
+  local wa="" wb=""
+  while [[ $# -gt 0 ]]; do
+    case "$1" in
+      --week-a) wa="$2"; shift 2 ;;
+      --week-b) wb="$2"; shift 2 ;;
+      --help|-h) usage; exit 0 ;;
+      *) log_error "Unknown compare option: $1"; usage; exit 1 ;;
+    esac
+  done
+  if [[ -z "$wa" || -z "$wb" ]]; then
+    log_error "compare requires --week-a and --week-b"
+    usage
+    exit 1
+  fi
+
+  echo "=== Week A ($wa) ==="
+  print_summary "$wa"
+  echo ""
+  echo "=== Week B ($wb) ==="
+  print_summary "$wb"
+}
+
+case "${1:-}" in
+  log) shift; cmd_log "$@" ;;
+  weekly) shift; cmd_weekly "$@" ;;
+  compare) shift; cmd_compare "$@" ;;
+  paths)
+    ensure_eval_files
+    echo "run_log=$RUN_LOG_FILE"
+    echo "scorecard=$SCORECARD_FILE"
+    ;;
+  help|--help|-h|"") usage ;;
+  *) log_error "Unknown eval command: $1"; usage; exit 1 ;;
+esac

package/bin/history.sh

@@ -0,0 +1,91 @@
+#!/usr/bin/env bash
+# history.sh — Show completed task history
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+source "${SCRIPT_DIR}/../lib/common.sh"
+
+HISTORY_FILE="${CLAWFORGE_DIR}/registry/completed-tasks.jsonl"
+
+# ── Help ───────────────────────────────────────────────────────────────
+usage() {
+  cat <<EOF
+Usage: history.sh [options]
+
+Show completed task history.
+
+Options:
+  --repo <name>     Filter by repo name
+  --mode <mode>     Filter by mode (sprint, swarm, review)
+  --limit <n>       Number of entries to show (default: 10)
+  --all             Show all entries (no limit)
+  --help            Show this help
+EOF
+}
+
+# ── Parse args ────────────────────────────────────────────────────────
+REPO_FILTER="" MODE_FILTER="" LIMIT=10 SHOW_ALL=false
+
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --repo)    REPO_FILTER="$2"; shift 2 ;;
+    --mode)    MODE_FILTER="$2"; shift 2 ;;
+    --limit)   LIMIT="$2"; shift 2 ;;
+    --all)     SHOW_ALL=true; shift ;;
+    --help|-h) usage; exit 0 ;;
+    *)         log_error "Unknown option: $1"; usage; exit 1 ;;
+  esac
+done
+
+# ── Check file ────────────────────────────────────────────────────────
+if [[ ! -f "$HISTORY_FILE" ]] || [[ ! -s "$HISTORY_FILE" ]]; then
+  echo "No completed tasks yet."
+  echo "Tasks are recorded when cleaned via 'clawforge clean'."
+  exit 0
+fi
+
+# ── Build jq filter ──────────────────────────────────────────────────
+JQ_FILTER="."
+if [[ -n "$REPO_FILTER" ]]; then
+  JQ_FILTER="$JQ_FILTER | select(.repo | test(\"$REPO_FILTER\"; \"i\"))"
+fi
+if [[ -n "$MODE_FILTER" ]]; then
+  JQ_FILTER="$JQ_FILTER | select(.mode == \"$MODE_FILTER\")"
+fi
+
+# ── Collect and limit ────────────────────────────────────────────────
+ENTRIES=$(jq -c "$JQ_FILTER" "$HISTORY_FILE" 2>/dev/null || true)
+
+if [[ -z "$ENTRIES" ]]; then
+  echo "No matching tasks found."
+  exit 0
+fi
+
+if ! $SHOW_ALL; then
+  ENTRIES=$(echo "$ENTRIES" | tail -"$LIMIT")
+fi
+
+TOTAL=$(echo "$ENTRIES" | wc -l | tr -d ' ')
+
+# ── Print table ──────────────────────────────────────────────────────
+printf "%-12s %-8s %-40s %-8s %-8s %-8s %s\n" "Date" "Mode" "Task" "Status" "Dur" "Cost" "PR"
+printf "%-12s %-8s %-40s %-8s %-8s %-8s %s\n" "────────────" "────────" "────────────────────────────────────────" "────────" "────────" "────────" "──────"
+
+echo "$ENTRIES" | while IFS= read -r line; do
+  date=$(echo "$line" | jq -r '.completedAt // .cleanedAt // .timestamp // 0' | \
+    python3 -c "import sys,datetime; t=int(sys.stdin.read().strip()); print(datetime.datetime.fromtimestamp(t/1000).strftime('%Y-%m-%d') if t > 0 else '—')" 2>/dev/null || echo "—")
+  mode=$(echo "$line" | jq -r '.mode // "—"')
+  task=$(echo "$line" | jq -r '.description // "—"' | cut -c1-40)
+  status=$(echo "$line" | jq -r '.status // "—"')
+  dur_min=$(echo "$line" | jq -r '.duration_minutes // "—"')
+  [[ "$dur_min" != "—" && "$dur_min" != "0" && "$dur_min" != "null" ]] && dur="${dur_min}m" || dur="—"
+  cost=$(echo "$line" | jq -r '.cost // "—"')
+  [[ "$cost" == "null" ]] && cost="—"
+  pr=$(echo "$line" | jq -r '.pr // "—"')
+  [[ "$pr" == "null" ]] && pr="—"
+
+  printf "%-12s %-8s %-40s %-8s %-8s %-8s %s\n" "$date" "$mode" "$task" "$status" "$dur" "$cost" "$pr"
+done
+
+echo ""
+echo "Showing $TOTAL entries."

package/bin/init.sh

@@ -0,0 +1,182 @@
+#!/usr/bin/env bash
+# init.sh — Scan project and generate initial memory entries
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+source "${SCRIPT_DIR}/../lib/common.sh"
+
+MEMORY_BASE="$HOME/.clawforge/memory"
+
+# ── Help ───────────────────────────────────────────────────────────────
+usage() {
+  cat <<EOF
+Usage: init.sh [options]
+
+Scans the current directory for project structure and generates
+initial memory entries for agent context.
+
+Options:
+  --claude-md    Also create CLAUDE.md if missing
+  --help         Show this help
+EOF
+}
+
+# ── Parse args ────────────────────────────────────────────────────────
+CREATE_CLAUDE_MD=false
+
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --claude-md)  CREATE_CLAUDE_MD=true; shift ;;
+    --help|-h)    usage; exit 0 ;;
+    *)            log_error "Unknown option: $1"; usage; exit 1 ;;
+  esac
+done
+
+# ── Detect repo name ─────────────────────────────────────────────────
+REPO_NAME=$(basename "$(pwd)")
+REMOTE_URL=$(git config --get remote.origin.url 2>/dev/null || true)
+[[ -n "$REMOTE_URL" ]] && REPO_NAME=$(basename "$REMOTE_URL" .git)
+
+MEMORY_FILE="${MEMORY_BASE}/${REPO_NAME}.jsonl"
+mkdir -p "$MEMORY_BASE"
+
+# ── Helper: add memory ───────────────────────────────────────────────
+ENTRY_COUNT=0
+add_memory() {
+  local text="$1"
+  local tags="${2:-init}"
+  local tags_json
+  tags_json=$(echo "$tags" | tr ',' '\n' | jq -R . | jq -s .)
+  local entry
+  entry=$(jq -cn \
+    --arg id "init-$(date +%s)-${ENTRY_COUNT}" \
+    --arg text "$text" \
+    --argjson tags "$tags_json" \
+    --arg created "$(date -u +%Y-%m-%dT%H:%M:%SZ)" \
+    --arg source "init" \
+    '{id:$id, text:$text, tags:$tags, created:$created, source:$source}')
+  echo "$entry" >> "$MEMORY_FILE"
+  ENTRY_COUNT=$((ENTRY_COUNT + 1))
+  echo "  + $text"
+}
+
+echo "Scanning: $(pwd)"
+echo "Repo: $REPO_NAME"
+echo ""
+
+OBSERVATIONS=()
+
+# ── Language / package manager detection ─────────────────────────────
+if [[ -f "package.json" ]]; then
+  add_memory "Node.js project (package.json)" "lang,node"
+  # Check for specific package managers
+  if [[ -f "pnpm-lock.yaml" ]]; then
+    add_memory "Uses pnpm as package manager" "tooling,pnpm"
+  elif [[ -f "bun.lockb" ]] || [[ -f "bun.lock" ]]; then
+    add_memory "Uses bun as package manager" "tooling,bun"
+  elif [[ -f "yarn.lock" ]]; then
+    add_memory "Uses yarn as package manager" "tooling,yarn"
+  elif [[ -f "package-lock.json" ]]; then
+    add_memory "Uses npm as package manager" "tooling,npm"
+  fi
+  # Detect test runner from package.json
+  if jq -e '.scripts.test' package.json >/dev/null 2>&1; then
+    TEST_CMD=$(jq -r '.scripts.test' package.json)
+    if echo "$TEST_CMD" | grep -q "vitest"; then
+      add_memory "Uses vitest for testing" "testing,vitest"
+    elif echo "$TEST_CMD" | grep -q "jest"; then
+      add_memory "Uses jest for testing" "testing,jest"
+    elif echo "$TEST_CMD" | grep -q "mocha"; then
+      add_memory "Uses mocha for testing" "testing,mocha"
+    fi
+  fi
+  # Detect framework from dependencies
+  if jq -e '.dependencies.next // .devDependencies.next' package.json >/dev/null 2>&1; then
+    add_memory "Next.js framework detected" "framework,nextjs"
+  elif jq -e '.dependencies.react // .devDependencies.react' package.json >/dev/null 2>&1; then
+    add_memory "React project" "framework,react"
+  fi
+  if jq -e '.dependencies.express // .devDependencies.express' package.json >/dev/null 2>&1; then
+    add_memory "Uses Express.js" "framework,express"
+  fi
+  # Detect TypeScript
+  if [[ -f "tsconfig.json" ]]; then
+    add_memory "TypeScript project" "lang,typescript"
+  fi
+fi
+
+if [[ -f "go.mod" ]]; then
+  MODULE=$(head -1 go.mod | sed 's/^module //')
+  add_memory "Go project (module: $MODULE)" "lang,go"
+  if [[ -f "go.sum" ]]; then
+    add_memory "Go dependencies managed with go modules" "tooling,go"
+  fi
+fi
+
+if [[ -f "Cargo.toml" ]]; then
+  add_memory "Rust project (Cargo.toml)" "lang,rust"
+fi
+
+if [[ -f "pyproject.toml" ]]; then
+  add_memory "Python project (pyproject.toml)" "lang,python"
+  if grep -q "pytest" pyproject.toml 2>/dev/null; then
+    add_memory "Uses pytest for testing" "testing,pytest"
+  fi
+elif [[ -f "setup.py" ]] || [[ -f "setup.cfg" ]]; then
+  add_memory "Python project" "lang,python"
+elif [[ -f "requirements.txt" ]]; then
+  add_memory "Python project (requirements.txt)" "lang,python"
+fi
+
+# ── Build tools ──────────────────────────────────────────────────────
+if [[ -f "Makefile" ]]; then
+  add_memory "Has Makefile for build tasks" "tooling,make"
+fi
+
+if [[ -f "Dockerfile" ]] || [[ -f "docker-compose.yml" ]] || [[ -f "docker-compose.yaml" ]]; then
+  add_memory "Docker setup present" "tooling,docker"
+fi
+
+# ── CI detection ─────────────────────────────────────────────────────
+if [[ -d ".github/workflows" ]]; then
+  WF_COUNT=$(find .github/workflows -maxdepth 1 \( -name '*.yml' -o -name '*.yaml' \) 2>/dev/null | wc -l | tr -d ' ')
+  add_memory "GitHub Actions CI ($WF_COUNT workflow files)" "ci,github-actions"
+fi
+
+if [[ -f ".gitlab-ci.yml" ]]; then
+  add_memory "GitLab CI configured" "ci,gitlab"
+fi
+
+# ── Misc ─────────────────────────────────────────────────────────────
+if [[ -f "CLAUDE.md" ]]; then
+  add_memory "Has CLAUDE.md project instructions" "config"
+fi
+
+if [[ -f ".env.example" ]] || [[ -f ".env.local" ]]; then
+  add_memory "Uses environment variables (.env)" "config"
+fi
+
+# ── Optional: create CLAUDE.md ───────────────────────────────────────
+if $CREATE_CLAUDE_MD && [[ ! -f "CLAUDE.md" ]]; then
+  cat > CLAUDE.md <<'CLAUDEEOF'
+# Project Instructions
+
+## Overview
+<!-- Describe your project here -->
+
+## Development
+<!-- Build, test, and run commands -->
+
+## Conventions
+<!-- Code style, naming conventions, etc. -->
+CLAUDEEOF
+  echo ""
+  echo "Created CLAUDE.md (edit to add project instructions)"
+fi
+
+echo ""
+if [[ $ENTRY_COUNT -eq 0 ]]; then
+  echo "No project files detected. Memory file not created."
+else
+  echo "Wrote $ENTRY_COUNT memory entries to: $MEMORY_FILE"
+fi