jdi-cli 0.1.0

package/bin/jdi-doctor.sh

@@ -0,0 +1,400 @@
+#!/usr/bin/env bash
+# jdi-doctor: diagnostica ambiente JDI.
+# Uso: ./bin/jdi-doctor.sh [--verbose]
+#
+# Checa:
+#  - dependencias bash (git, awk, sed, find)
+#  - runtimes detectados (claude, copilot, antigravity)
+#  - ctx7 (opcional)
+#  - estrutura .jdi/ no projeto atual
+#  - git hooks ativos (.githooks/)
+#  - source of truth (core/) se rodando do repo JDI
+#  - runtimes/ buildados
+#  - install no projeto atual
+#
+# Saida: relatorio com OK / WARN / FAIL por check.
+# Exit 0 se tudo OK ou so WARN. Exit 1 se algum FAIL.
+
+set -uo pipefail
+
+VERBOSE="${1:-}"
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+JDI_ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
+PROJECT_DIR="$PWD"
+
+# Cores (sem cor se nao for tty)
+if [[ -t 1 ]]; then
+  GRN=$'\033[32m'; YLW=$'\033[33m'; RED=$'\033[31m'; DIM=$'\033[2m'; RST=$'\033[0m'
+else
+  GRN=""; YLW=""; RED=""; DIM=""; RST=""
+fi
+
+FAILS=0
+WARNS=0
+
+ok()   { echo "  ${GRN}OK${RST}    $1"; }
+warn() { echo "  ${YLW}WARN${RST}  $1"; ((WARNS++)) || true; }
+fail() { echo "  ${RED}FAIL${RST}  $1"; ((FAILS++)) || true; }
+note() { [[ "$VERBOSE" == "--verbose" ]] && echo "  ${DIM}note  $1${RST}" || true; }
+section() { echo; echo "${1}"; }
+
+# ---------------------------------------------------------------------------
+section "1. Dependencias bash"
+
+for cmd in git awk sed find grep; do
+  if command -v "$cmd" &>/dev/null; then
+    ok "$cmd disponivel ($(command -v "$cmd"))"
+  else
+    fail "$cmd ausente. Instale (Linux/Mac nativo. Windows: Git Bash ou WSL)."
+  fi
+done
+
+# ---------------------------------------------------------------------------
+section "2. Runtimes"
+
+CLAUDE_OK=false
+if command -v claude &>/dev/null; then
+  ok "claude CLI: $(command -v claude)"
+  CLAUDE_OK=true
+elif [[ -d "$HOME/.claude" ]]; then
+  warn "~/.claude/ existe mas claude CLI nao esta no PATH"
+  CLAUDE_OK=true
+else
+  warn "Claude Code nao detectado (sem CLI nem ~/.claude/)"
+fi
+
+COPILOT_OK=false
+if command -v code &>/dev/null; then
+  if code --list-extensions 2>/dev/null | grep -qi "github.copilot"; then
+    ok "VS Code + extensao Copilot detectados"
+    COPILOT_OK=true
+  else
+    warn "VS Code presente mas extensao Copilot nao instalada"
+  fi
+elif command -v gh &>/dev/null && gh extension list 2>/dev/null | grep -qi copilot; then
+  ok "gh CLI com extensao copilot"
+  COPILOT_OK=true
+else
+  warn "Copilot nao detectado (sem VS Code ou sem extensao)"
+fi
+
+ANTIGRAVITY_OK=false
+if command -v antigravity &>/dev/null; then
+  ok "antigravity CLI: $(command -v antigravity)"
+  ANTIGRAVITY_OK=true
+elif [[ -d "$HOME/.gemini/antigravity" ]]; then
+  ok "~/.gemini/antigravity/ existe"
+  ANTIGRAVITY_OK=true
+else
+  warn "Antigravity nao detectado"
+fi
+
+OPENCODE_OK=false
+if command -v opencode &>/dev/null; then
+  ok "opencode CLI: $(command -v opencode)"
+  OPENCODE_OK=true
+elif [[ -d "$HOME/.config/opencode" ]]; then
+  ok "~/.config/opencode/ existe"
+  OPENCODE_OK=true
+else
+  warn "OpenCode nao detectado (sem CLI nem ~/.config/opencode/)"
+fi
+
+if ! $CLAUDE_OK && ! $COPILOT_OK && ! $ANTIGRAVITY_OK && ! $OPENCODE_OK; then
+  fail "Nenhum runtime detectado. JDI nao serve pra nada sem runtime."
+fi
+
+# ---------------------------------------------------------------------------
+section "3. Tooling opcional"
+
+if command -v ctx7 &>/dev/null; then
+  ok "ctx7 disponivel ($(command -v ctx7))"
+elif command -v npx &>/dev/null; then
+  warn "ctx7 ausente. Recomendado pra docs de libs. Instale: npm i -g ctx7"
+else
+  warn "ctx7 e npx ausentes. Researcher fica limitado a WebSearch."
+fi
+
+if command -v gh &>/dev/null; then
+  ok "gh CLI disponivel (necessario pra /jdi-ship abrir PR)"
+else
+  warn "gh CLI ausente. /jdi-ship nao consegue criar PR. Install: cli.github.com"
+fi
+
+if command -v jq &>/dev/null; then
+  ok "jq disponivel"
+else
+  note "jq ausente (opcional, scripts JDI usam awk em vez)"
+fi
+
+# ---------------------------------------------------------------------------
+section "4. Repo JDI (source of truth)"
+
+if [[ -d "$JDI_ROOT/core/agents" && -d "$JDI_ROOT/core/commands" ]]; then
+  AGENTS_COUNT=$(find "$JDI_ROOT/core/agents" -name "*.md" 2>/dev/null | wc -l | tr -d ' ')
+  COMMANDS_COUNT=$(find "$JDI_ROOT/core/commands" -name "*.md" 2>/dev/null | wc -l | tr -d ' ')
+  ok "core/ encontrado ($AGENTS_COUNT agents, $COMMANDS_COUNT commands)"
+
+  if [[ "$AGENTS_COUNT" -lt 1 ]]; then
+    fail "core/agents/ vazio. Repo do JDI nao esta integro."
+  fi
+else
+  fail "core/ ausente em $JDI_ROOT. Esse script roda do repo do JDI?"
+fi
+
+if [[ -x "$JDI_ROOT/bin/jdi-build.sh" ]]; then
+  ok "jdi-build.sh executavel"
+else
+  warn "jdi-build.sh nao executavel. Rode: chmod +x bin/jdi-build.sh"
+fi
+
+if [[ -x "$JDI_ROOT/bin/jdi-install.sh" ]]; then
+  ok "jdi-install.sh executavel"
+else
+  warn "jdi-install.sh nao executavel. Rode: chmod +x bin/jdi-install.sh"
+fi
+
+# ---------------------------------------------------------------------------
+section "5. Adapters buildados (runtimes/)"
+
+for rt in claude copilot antigravity opencode; do
+  if [[ -d "$JDI_ROOT/runtimes/$rt" ]]; then
+    case "$rt" in
+      claude)      count=$(find "$JDI_ROOT/runtimes/claude/agents" -name "*.md" 2>/dev/null | wc -l | tr -d ' ') ;;
+      copilot)     count=$(find "$JDI_ROOT/runtimes/copilot/agents" -name "*.agent.md" 2>/dev/null | wc -l | tr -d ' ') ;;
+      antigravity) count=$(find "$JDI_ROOT/runtimes/antigravity/skills" -name "SKILL.md" 2>/dev/null | wc -l | tr -d ' ') ;;
+      opencode)    count=$(find "$JDI_ROOT/runtimes/opencode/agents" -name "*.md" 2>/dev/null | wc -l | tr -d ' ') ;;
+    esac
+
+    if [[ "$count" -gt 0 ]]; then
+      ok "runtimes/$rt buildado ($count agents/skills)"
+    else
+      warn "runtimes/$rt vazio. Rode: ./bin/jdi-build.sh"
+    fi
+  else
+    warn "runtimes/$rt ausente. Rode: ./bin/jdi-build.sh"
+  fi
+done
+
+# ---------------------------------------------------------------------------
+section "6. Projeto atual ($PROJECT_DIR)"
+
+if [[ "$PROJECT_DIR" == "$JDI_ROOT" ]]; then
+  note "Voce esta no proprio repo do JDI. Rode jdi-doctor de dentro do seu projeto pra checar install."
+fi
+
+if [[ -d "$PROJECT_DIR/.jdi" ]]; then
+  ok "projeto eh JDI (.jdi/ existe)"
+
+  for f in PROJECT.md ROADMAP.md STATE.md; do
+    if [[ -f "$PROJECT_DIR/.jdi/$f" ]]; then
+      ok ".jdi/$f presente"
+    else
+      warn ".jdi/$f ausente. /jdi-new nao completou ou foi removido."
+    fi
+  done
+
+  for f in DECISIONS.md specialists.md reviewers.md registry.md todos.md; do
+    [[ -f "$PROJECT_DIR/.jdi/$f" ]] && ok ".jdi/$f presente" || note ".jdi/$f ausente (criado on-demand)"
+  done
+
+  if [[ -d "$PROJECT_DIR/.jdi/agents" ]]; then
+    spec_count=$(find "$PROJECT_DIR/.jdi/agents" -name "jdi-doer-*.md" -o -name "jdi-reviewer-*.md" 2>/dev/null | wc -l | tr -d ' ')
+    if [[ "$spec_count" -gt 0 ]]; then
+      ok ".jdi/agents/ com $spec_count specialist(s) per-project"
+    else
+      note ".jdi/agents/ vazio (rode /jdi-bootstrap pra criar specialists)"
+    fi
+  fi
+
+  if [[ -d "$PROJECT_DIR/.jdi/phases" ]]; then
+    PHASE_COUNT=$(find "$PROJECT_DIR/.jdi/phases" -maxdepth 1 -mindepth 1 -type d 2>/dev/null | wc -l | tr -d ' ')
+    ok ".jdi/phases/ com $PHASE_COUNT phase(s)"
+  fi
+else
+  warn ".jdi/ ausente. Rode /jdi-new ou esta fora de um projeto JDI."
+fi
+
+# ---------------------------------------------------------------------------
+section "7. Runtime instalado no projeto"
+
+INSTALL_FOUND=false
+
+if [[ -d "$PROJECT_DIR/.claude/agents" ]]; then
+  count=$(find "$PROJECT_DIR/.claude/agents" -name "jdi-*.md" 2>/dev/null | wc -l | tr -d ' ')
+  if [[ "$count" -gt 0 ]]; then
+    ok ".claude/agents/ com $count agents JDI"
+    INSTALL_FOUND=true
+  else
+    warn ".claude/agents/ existe mas sem agents JDI. Rode jdi-install.sh"
+  fi
+fi
+
+if [[ -d "$PROJECT_DIR/.github/agents" ]]; then
+  count=$(find "$PROJECT_DIR/.github/agents" -name "jdi-*.agent.md" 2>/dev/null | wc -l | tr -d ' ')
+  if [[ "$count" -gt 0 ]]; then
+    ok ".github/agents/ com $count agents JDI"
+    INSTALL_FOUND=true
+  fi
+fi
+
+if [[ -d "$PROJECT_DIR/.gemini/antigravity/skills" ]]; then
+  count=$(find "$PROJECT_DIR/.gemini/antigravity/skills" -name "SKILL.md" 2>/dev/null | wc -l | tr -d ' ')
+  if [[ "$count" -gt 0 ]]; then
+    ok ".gemini/antigravity/skills/ com $count skills JDI"
+    INSTALL_FOUND=true
+  fi
+fi
+
+if [[ -d "$PROJECT_DIR/.opencode/agents" ]]; then
+  count=$(find "$PROJECT_DIR/.opencode/agents" -name "jdi-*.md" 2>/dev/null | wc -l | tr -d ' ')
+  if [[ "$count" -gt 0 ]]; then
+    ok ".opencode/agents/ com $count agents JDI"
+    INSTALL_FOUND=true
+  fi
+fi
+
+if [[ -d "$HOME/.claude/agents" ]]; then
+  count=$(find "$HOME/.claude/agents" -name "jdi-*.md" 2>/dev/null | wc -l | tr -d ' ')
+  [[ "$count" -gt 0 ]] && ok "~/.claude/agents/ com $count agents JDI (scope user)" && INSTALL_FOUND=true
+fi
+
+if [[ -d "$HOME/.config/opencode/agents" ]]; then
+  count=$(find "$HOME/.config/opencode/agents" -name "jdi-*.md" 2>/dev/null | wc -l | tr -d ' ')
+  [[ "$count" -gt 0 ]] && ok "~/.config/opencode/agents/ com $count agents JDI (scope user)" && INSTALL_FOUND=true
+fi
+
+if ! $INSTALL_FOUND; then
+  if [[ -d "$PROJECT_DIR/.jdi" ]]; then
+    fail "Projeto eh JDI mas nenhum runtime instalado. Rode: $JDI_ROOT/bin/jdi-install.sh <runtime>"
+  fi
+fi
+
+# ---------------------------------------------------------------------------
+section "8. Git hooks"
+
+if [[ -f "$PROJECT_DIR/.githooks/pre-commit" ]]; then
+  if [[ -x "$PROJECT_DIR/.githooks/pre-commit" ]]; then
+    ok ".githooks/pre-commit existe e executavel"
+  else
+    warn ".githooks/pre-commit nao executavel. Rode: chmod +x .githooks/pre-commit"
+  fi
+
+  HOOKS_PATH=$(git -C "$PROJECT_DIR" config core.hooksPath 2>/dev/null || echo "")
+  if [[ "$HOOKS_PATH" == ".githooks" || "$HOOKS_PATH" == "$PROJECT_DIR/.githooks" ]]; then
+    ok "git core.hooksPath aponta pra .githooks"
+  else
+    warn "git core.hooksPath nao configurado. Rode: git config core.hooksPath .githooks"
+  fi
+elif [[ -d "$PROJECT_DIR/.jdi" ]]; then
+  warn ".githooks/ ausente em projeto JDI. Rode jdi-install.sh pra instalar."
+fi
+
+# ---------------------------------------------------------------------------
+section "9. Repo git limpo (recomendado pra /jdi-create)"
+
+if git -C "$PROJECT_DIR" rev-parse --git-dir &>/dev/null; then
+  if git -C "$PROJECT_DIR" diff-index --quiet HEAD -- 2>/dev/null; then
+    ok "working tree limpo"
+  else
+    note "working tree com mudancas (ok pra /jdi-do, mas commit antes de /jdi-create)"
+  fi
+else
+  warn "Diretorio nao eh repo git. /jdi-new e atomic commits nao funcionam sem git."
+fi
+
+# ---------------------------------------------------------------------------
+section "10. Playwright + MCP (optional)"
+
+if [ -f "$PROJECT_DIR/package.json" ] && grep -q '"@playwright/test"' "$PROJECT_DIR/package.json" 2>/dev/null; then
+  ok "@playwright/test in package.json"
+else
+  note "@playwright/test not installed (run: npx jdi-cli install-playwright)"
+fi
+
+if [ -f "$PROJECT_DIR/.claude/settings.local.json" ]; then
+  if grep -q '"playwright"' "$PROJECT_DIR/.claude/settings.local.json" 2>/dev/null; then
+    ok "Claude Code MCP playwright configured"
+  else
+    note "Claude Code settings.local.json present but no MCP playwright entry"
+  fi
+fi
+
+if [ -f "$PROJECT_DIR/.opencode/opencode.jsonc" ]; then
+  if grep -q '"playwright"' "$PROJECT_DIR/.opencode/opencode.jsonc" 2>/dev/null; then
+    ok "OpenCode MCP playwright configured"
+  else
+    note "OpenCode opencode.jsonc present but no MCP playwright entry"
+  fi
+fi
+
+if [ -f "$PROJECT_DIR/.vscode/mcp.json" ]; then
+  if grep -q '"playwright"' "$PROJECT_DIR/.vscode/mcp.json" 2>/dev/null; then
+    ok "Copilot (VS Code) MCP playwright configured"
+  else
+    note ".vscode/mcp.json present but no playwright entry"
+  fi
+fi
+
+if [ -f "$HOME/.gemini/settings.json" ] && grep -q '"playwright"' "$HOME/.gemini/settings.json" 2>/dev/null; then
+  ok "Antigravity MCP playwright configured (user scope)"
+elif [ -f "$PROJECT_DIR/.gemini/settings.json" ] && grep -q '"playwright"' "$PROJECT_DIR/.gemini/settings.json" 2>/dev/null; then
+  ok "Antigravity MCP playwright configured (project scope)"
+fi
+
+# ---------------------------------------------------------------------------
+section "12. Specialists (single vs multi-stack)"
+
+SPEC_PATH="$PROJECT_DIR/.jdi/specialists.md"
+REV_PATH="$PROJECT_DIR/.jdi/reviewers.md"
+
+if [ -f "$SPEC_PATH" ]; then
+  DOERS=$(grep -oE 'jdi-doer-[a-z0-9-]+' "$SPEC_PATH" | sort -u)
+  DOER_COUNT=$(echo "$DOERS" | grep -c .)
+  if [ "$DOER_COUNT" -eq 0 ]; then
+    note "specialists.md exists but no doer registered"
+  elif [ "$DOER_COUNT" -eq 1 ]; then
+    ok "Single-stack: $DOERS"
+  else
+    ok "Multi-stack: $DOER_COUNT doer specialists"
+    echo "$DOERS" | while read d; do note "  - $d"; done
+  fi
+else
+  note ".jdi/specialists.md missing (run /jdi-bootstrap)"
+fi
+
+if [ -f "$REV_PATH" ]; then
+  REVS=$(grep -oE 'jdi-reviewer-[a-z0-9-]+' "$REV_PATH" | sort -u | wc -l)
+  if [ "$REVS" -gt 1 ]; then
+    note "  Reviewer chain length: $REVS (multi-stack /jdi-verify)"
+  fi
+fi
+
+# ---------------------------------------------------------------------------
+section "11. Caveman plugin (optional)"
+
+CAVEMAN_USER="$HOME/.claude/plugins/caveman"
+CAVEMAN_PROJECT="$PROJECT_DIR/.claude/plugins/caveman"
+
+if [ -d "$CAVEMAN_USER" ]; then
+  ok "Caveman installed (user scope: $CAVEMAN_USER)"
+elif [ -d "$CAVEMAN_PROJECT" ]; then
+  ok "Caveman installed (project scope: $CAVEMAN_PROJECT)"
+else
+  note "Caveman plugin not installed (run: npx jdi-cli install-caveman)"
+fi
+
+# ---------------------------------------------------------------------------
+section "Resumo"
+
+if [[ "$FAILS" -gt 0 ]]; then
+  echo "  ${RED}${FAILS} FAIL${RST}, ${YLW}${WARNS} WARN${RST}"
+  echo "  -> Resolva os FAIL antes de usar JDI."
+  exit 1
+elif [[ "$WARNS" -gt 0 ]]; then
+  echo "  ${YLW}${WARNS} WARN${RST} (JDI funciona mas com limitacoes)"
+  exit 0
+else
+  echo "  ${GRN}Tudo OK${RST}. JDI pronto pra rodar."
+  exit 0
+fi

package/bin/jdi-install-caveman.ps1

@@ -0,0 +1,97 @@
+<#
+.SYNOPSIS
+  jdi-install-caveman (Windows): clones caveman plugin into Claude Code plugins dir.
+
+.DESCRIPTION
+  Optional install. Caveman is an ultra-compressed communication mode plugin for
+  Claude Code (skills, commands, hooks). Default repo:
+  https://github.com/JuliusBrussee/caveman
+
+  Idempotent: if target dir exists, asks overwrite/keep/cancel.
+
+.PARAMETER Repo
+  Git URL of the caveman plugin. Default: https://github.com/JuliusBrussee/caveman.git
+
+.PARAMETER Scope
+  user (default)   -> ~/.claude/plugins/caveman/
+  project          -> ./.claude/plugins/caveman/
+
+.PARAMETER Force
+  Overwrite existing install without prompting.
+
+.EXAMPLE
+  .\bin\jdi-install-caveman.ps1
+  .\bin\jdi-install-caveman.ps1 -Scope project
+  .\bin\jdi-install-caveman.ps1 -Repo https://github.com/forked/caveman.git -Force
+#>
+[CmdletBinding()]
+param(
+  [string]$Repo = 'https://github.com/JuliusBrussee/caveman.git',
+  [ValidateSet('user','project')]
+  [string]$Scope = 'user',
+  [switch]$Force
+)
+
+$ErrorActionPreference = 'Stop'
+$ProjectDir = (Get-Location).Path
+$UserHome = if ($env:HOME) { $env:HOME } else { $env:USERPROFILE }
+
+$baseDir = if ($Scope -eq 'user') { Join-Path $UserHome '.claude\plugins' } else { Join-Path $ProjectDir '.claude\plugins' }
+$target = Join-Path $baseDir 'caveman'
+
+Write-Host ''
+Write-Host '=== JDI: Install Caveman plugin ==='
+Write-Host ''
+Write-Host "  Repo:   $Repo"
+Write-Host "  Scope:  $Scope"
+Write-Host "  Target: $target"
+Write-Host ''
+
+if (-not (Get-Command git -ErrorAction SilentlyContinue)) {
+  Write-Error "git not in PATH. Install git and retry."
+  exit 1
+}
+
+if (Test-Path $target) {
+  if (-not $Force) {
+    Write-Host "  Target exists."
+    $answer = Read-Host "  Overwrite? (y/N)"
+    if ($answer -notmatch '^[yY]') {
+      Write-Host "  Skipped."
+      exit 0
+    }
+  }
+  Write-Host "  Removing old install..."
+  Remove-Item -Recurse -Force $target
+}
+
+New-Item -ItemType Directory -Force -Path $baseDir | Out-Null
+
+Write-Host "  Cloning..."
+& git clone --depth 1 $Repo $target 2>&1 | ForEach-Object { Write-Host "    $_" }
+
+if ($LASTEXITCODE -ne 0) {
+  Write-Error "git clone failed (exit $LASTEXITCODE)."
+  exit $LASTEXITCODE
+}
+
+# Verify it looks like a Claude Code plugin
+$looksValid = (Test-Path (Join-Path $target 'plugin.json')) -or
+              (Test-Path (Join-Path $target '.claude-plugin')) -or
+              (Test-Path (Join-Path $target 'skills')) -or
+              (Test-Path (Join-Path $target 'commands')) -or
+              (Test-Path (Join-Path $target 'agents'))
+
+if (-not $looksValid) {
+  Write-Warning "  Cloned repo does not look like a Claude Code plugin (no plugin.json / skills/ / commands/ / agents/)."
+  Write-Warning "  Keeping clone but verify manually: $target"
+}
+
+Write-Host ''
+Write-Host "Caveman installed at: $target"
+Write-Host ''
+Write-Host "Next steps:"
+Write-Host "  1. Restart Claude Code (or run /plugin reload)"
+Write-Host "  2. Verify with: /caveman-help"
+Write-Host "  3. Toggle mode: /caveman lite|full|ultra"
+Write-Host ''

package/bin/jdi-install-caveman.sh

@@ -0,0 +1,99 @@
+#!/usr/bin/env bash
+# jdi-install-caveman (POSIX): clones caveman plugin into Claude Code plugins dir.
+#
+# Optional install. Default repo: https://github.com/JuliusBrussee/caveman
+# Idempotent: if target dir exists, asks overwrite/keep/cancel.
+#
+# Usage:
+#   ./bin/jdi-install-caveman.sh
+#   ./bin/jdi-install-caveman.sh --scope project
+#   ./bin/jdi-install-caveman.sh --repo https://github.com/forked/caveman.git --force
+#
+# Flags:
+#   --repo <url>    Git URL (default: https://github.com/JuliusBrussee/caveman.git)
+#   --scope <s>     user (default) -> ~/.claude/plugins/caveman/
+#                   project        -> ./.claude/plugins/caveman/
+#   --force         Overwrite existing install without prompt
+
+set -euo pipefail
+
+REPO='https://github.com/JuliusBrussee/caveman.git'
+SCOPE=user
+FORCE=0
+PROJECT_DIR="$(pwd)"
+USER_HOME="${HOME:-$USERPROFILE}"
+
+while [ $# -gt 0 ]; do
+  case "$1" in
+    --repo)  REPO="$2"; shift 2 ;;
+    --scope) SCOPE="$2"; shift 2 ;;
+    --force) FORCE=1; shift ;;
+    *) echo "Unknown flag: $1"; exit 1 ;;
+  esac
+done
+
+case "$SCOPE" in
+  user|project) ;;
+  *) echo "Invalid --scope. Use: user | project"; exit 1 ;;
+esac
+
+if [ "$SCOPE" = "user" ]; then
+  BASE_DIR="$USER_HOME/.claude/plugins"
+else
+  BASE_DIR="$PROJECT_DIR/.claude/plugins"
+fi
+TARGET="$BASE_DIR/caveman"
+
+echo ""
+echo "=== JDI: Install Caveman plugin ==="
+echo ""
+echo "  Repo:   $REPO"
+echo "  Scope:  $SCOPE"
+echo "  Target: $TARGET"
+echo ""
+
+if ! command -v git >/dev/null 2>&1; then
+  echo "git not in PATH. Install git and retry."
+  exit 1
+fi
+
+if [ -d "$TARGET" ]; then
+  if [ "$FORCE" != "1" ]; then
+    echo "  Target exists."
+    read -p "  Overwrite? (y/N) " ans
+    case "$ans" in
+      [yY]*) ;;
+      *) echo "  Skipped."; exit 0 ;;
+    esac
+  fi
+  echo "  Removing old install..."
+  rm -rf "$TARGET"
+fi
+
+mkdir -p "$BASE_DIR"
+
+echo "  Cloning..."
+git clone --depth 1 "$REPO" "$TARGET" 2>&1 | sed 's/^/    /'
+
+if [ $? -ne 0 ]; then
+  echo "git clone failed."
+  exit 1
+fi
+
+# Verify plugin shape
+if [ -f "$TARGET/plugin.json" ] || [ -d "$TARGET/.claude-plugin" ] \
+   || [ -d "$TARGET/skills" ] || [ -d "$TARGET/commands" ] || [ -d "$TARGET/agents" ]; then
+  : # valid
+else
+  echo "  [warn] Cloned repo does not look like a Claude Code plugin."
+  echo "  [warn] Keeping clone but verify manually: $TARGET"
+fi
+
+echo ""
+echo "Caveman installed at: $TARGET"
+echo ""
+echo "Next steps:"
+echo "  1. Restart Claude Code (or run /plugin reload)"
+echo "  2. Verify with: /caveman-help"
+echo "  3. Toggle mode: /caveman lite|full|ultra"
+echo ""