Vibe

# Complexity Analysis (Step 2)

**Filter by language present in the change set first.** Run only the
analyzers whose language actually appears in the diff. A docs/shell/BATS-only
epic must NOT trigger `gocyclo` against the entire `cli/` tree (it has hung
in past runs); a Python-free epic must NOT trigger `radon`.

```bash
# Detect which languages are present in the diff (or in <path> for full audits).
# Use `git diff --name-only <base>...HEAD` for a PR; fall back to listing
# files under <path> when no diff base is available.
mkdir -p .agents/council
HAS_GO=false; HAS_PY=false
DIFF_FILES="$(git diff --name-only "${BASE:-HEAD~1}"...HEAD 2>/dev/null || find <path> -type f)"
echo "$DIFF_FILES" | grep -q '\.go$'  && HAS_GO=true
echo "$DIFF_FILES" | grep -q '\.py$'  && HAS_PY=true
echo "$(date -Iseconds) preflight: HAS_GO=$HAS_GO HAS_PY=$HAS_PY" >> .agents/council/preflight.log
```

**For Python (only when `HAS_PY=true`):**
```bash
if [ "$HAS_PY" = "true" ]; then
  echo "$(date -Iseconds) preflight: checking radon" >> .agents/council/preflight.log
  if ! which radon >> .agents/council/preflight.log 2>&1; then
    echo "⚠️ COMPLEXITY SKIPPED: radon not installed (pip install radon)"
  else
    radon cc <path> -a -s 2>/dev/null | head -30
    radon mi <path> -s 2>/dev/null | head -30
  fi
else
  echo "ℹ️ COMPLEXITY SKIPPED: no .py files in diff"
fi
```

**For Go (only when `HAS_GO=true`):**
```bash
if [ "$HAS_GO" = "true" ]; then
  echo "$(date -Iseconds) preflight: checking gocyclo" >> .agents/council/preflight.log
  if ! which gocyclo >> .agents/council/preflight.log 2>&1; then
    echo "⚠️ COMPLEXITY SKIPPED: gocyclo not installed (go install github.com/fzipp/gocyclo/cmd/gocyclo@latest)"
  else
    gocyclo -over 10 <path> 2>/dev/null | head -30
  fi
else
  echo "ℹ️ COMPLEXITY SKIPPED: no .go files in diff"
fi
```

**For other languages:** Skip complexity with explicit note: "⚠️ COMPLEXITY SKIPPED: No analyzer for <language>"

**Interpret results:**

| Score | Rating | Action |
|-------|--------|--------|
| A (1-5) | Simple | Good |
| B (6-10) | Moderate | OK |
| C (11-20) | Complex | Flag for council |
| D (21-30) | Very complex | Recommend refactor |
| F (31+) | Untestable | Must refactor |

**Include complexity findings in council context.**


# Deep Audit Protocol

> Used by `/vibe --deep`, `/vibe --sweep`, and `/post-mortem` (unless `--skip-sweep`).

Two-phase architecture: cheap per-file explorer sweep (discovery) followed by council judges (adjudication). All reporting caps removed.

```
Files -> chunk into batches of 3-5
  -> [up to 8 Explore agents in parallel, 8-category checklist per file] -> raw findings
  -> sweep manifest (ALL findings merged)
  -> [council judges] adjudicate + add cross-cutting findings -> ALL findings reported
```

---

## Phase 1: Explorer Sweep

### File Chunking Rules

Sort target files by line count (largest first), then chunk:

| File Size | Batch Size | Rationale |
|-----------|-----------|-----------|
| <= 100 lines | 5 per batch | Small files — explorers can handle many |
| 101–300 lines | 3 per batch | Medium files — moderate depth needed |
| > 300 lines | 1 per batch (solo) | Large files — full attention required |

**Max 8 batches.** If chunking produces more than 8 batches, merge the smallest batches until you have 8. If fewer than 8 batches, use fewer explorers.

### Explorer Prompt Template

Each explorer receives this prompt with its assigned file batch:

```
You are a Deep Audit Explorer. Your job is DISCOVERY — find every concrete issue in
the assigned files. You are NOT a judge; you do not decide severity thresholds or
ship-readiness. Find problems. Be thorough. Be specific.

## Assigned Files

{FILE_LIST}

## Mandatory 8-Category Checklist

For EACH file, you MUST check all 8 categories. Do not skip any category for any file.

1. **Resource Leaks** — Unclosed files/connections/handles, missing defer/finally/cleanup,
   goroutine leaks, listener leaks, temp file accumulation
2. **S