first-plan-git-intelligence

Git Intelligence

Extração de sinal do git que humanos veem mas IA tipicamente ignora.

Engine acceleration (v0.3.0+)

Para hashing de arquivos do cache (08-meta/cache.json), preferir o binário first-plan-engine se disponível:

# Detectar engine (igual co-change-analysis)
ENGINE=""
for c in "${CLAUDE_PLUGIN_ROOT}/engine/bin/first-plan-engine" "${HOME}/.local/bin/first-plan-engine" "$(command -v first-plan-engine 2>/dev/null)"; do
  [ -x "$c" ] && ENGINE="$c" && break
done

if [ -n "$ENGINE" ]; then
  # xxh3 paralelo via rayon - 10x mais rapido que sha256 + bash loop
  find . -type f -not -path "./.git/*" -not -path "./node_modules/*" | \
    "$ENGINE" hash --paths-from-stdin --output-json .first-plan/cache/files.json
fi

JSON schema first-plan-hash-v1 em 08-meta/cache.json (ou similar).

Compression de output (v0.5.3+)

Comandos git log, git status, git diff podem gerar muito output em repos grandes. Use first-plan-engine compress (ver skill compression-aware) para reduzir tokens em 30-80%:

# Ao invés de:
git log --oneline -n 100

# Use:
first-plan-engine compress --tool git-log --json -- -n 100
# retorna JSON com .output já comprimido

Compressão automática quando engine disponível, fallback graceful sem ele.

---

Pré-requisito (fallback)

Projeto deve ser git repo. Se nao for, todas as seções correlatas em .first-plan/01-topology/activity.md, 01-topology/ownership.md, 07-state/in-flight.md ficam vazias com nota explicativa.

test -d .git || echo "Not a git repo"

Activity heatmap

Top arquivos por commits recentes

git log --since="90 days ago" --name-only --pretty=format: \
  | grep -v '^$' \
  | sort | uniq -c | sort -rn \
  | head -20

Output em .first-plan/01-topology/activity.md na seção "Top 20 arquivos".

Top pastas

git log --since="90 days ago" --name-only --pretty=format: \
  | grep -v '^$' \
  | xargs -I{} dirname {} \
  | sort | uniq -c | sort -rn \
  | head -20