jdi-cli 0.1.0

package/runtimes/opencode/commands/jdi-plan.md

@@ -0,0 +1,73 @@
+---
+name: jdi-plan
+description: Generates phase PLAN.md. Decomposes into tasks with files_modified, acceptance, parallelism waves.
+argument_hint: "<phase_number> [--review]"
+runtime_intent:
+  invokes_agent: jdi-planner
+runtime_overrides:
+  claude:
+    allowed-tools: [Read, Write, Bash, Grep, Glob, AskUserQuestion, Agent]
+  copilot:
+    tools: [read, write, grep, glob]
+  opencode:
+    agent: jdi-planner
+    subtask: true
+    model: anthropic/claude-sonnet-4-20250514
+  antigravity:
+    triggers:
+      - "/jdi-plan"
+      - "plan phase {N}"
+---
+
+<objective>
+Generates PLAN.md for the given phase. Decomposes into tasks (max 8), groups into parallelism waves, maps files_modified and acceptance.
+</objective>
+
+<arguments>
+- `phase_number` (required): phase number, e.g. `1`, `2`
+- `--review` (optional): show preview and ask for approval before saving
+</arguments>
+
+<process>
+
+### Step 1: Validation
+```bash
+test -d .jdi/ || { echo "Not a JDI project. Run /jdi-new."; exit 1; }
+test -f .jdi/PROJECT.md || { echo "PROJECT.md missing."; exit 1; }
+```
+
+Verify phase CONTEXT.md exists:
+```bash
+ls .jdi/phases/{NN}*/CONTEXT.md 2>/dev/null || { echo "CONTEXT.md missing. Run /jdi-discuss {N}"; exit 1; }
+
+# Context budget warm-up (does not block)
+JDI_LIB="$(dirname "$(command -v jdi 2>/dev/null || echo /usr/local/bin/jdi)")/../lib"
+if [ -f "$JDI_LIB/jdi-monitor.sh" ]; then
+  bash "$JDI_LIB/jdi-monitor.sh" .jdi/PROJECT.md .jdi/DECISIONS.md .jdi/phases/{NN}*/CONTEXT.md || true
+fi
+# Windows: pwsh -File "$JDI_LIB/jdi-monitor.ps1" -Paths @(...)
+```
+
+### Step 2: Spawn planner
+Invoke `jdi-planner` with phase_number. Wait.
+
+### Step 3: Verify
+```bash
+test -f .jdi/phases/{NN}*/PLAN.md || { echo "PLAN.md not created"; exit 1; }
+```
+
+### Step 4: Confirm
+Show plan summary + suggest `/jdi-do {N}`.
+
+</process>
+
+<gates>
+- pre: `.jdi/PROJECT.md` + `.jdi/phases/{NN-slug}/CONTEXT.md` exist
+- post: PLAN.md created + STATE.md updated + commit
+</gates>
+
+<errors>
+- CONTEXT.md missing -> suggest `/jdi-discuss {N}`
+- Phase does not exist in ROADMAP -> error
+- Planner cancelled -> exit clean
+</errors>

package/runtimes/opencode/commands/jdi-ship.md

@@ -0,0 +1,146 @@
+---
+name: jdi-ship
+description: Finalizes phase after verify. Updates ROADMAP.md, marks phase as done, advances pointer to next.
+argument_hint: "<phase_number>"
+runtime_intent:
+  invokes_agent: none
+runtime_overrides:
+  claude:
+    allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, AskUserQuestion]
+  copilot:
+    tools: [read, write, edit, grep, glob, terminal]
+  opencode:
+    subtask: true
+  antigravity:
+    triggers:
+      - "/jdi-ship"
+      - "finalize phase {N}"
+---
+
+<objective>
+Finalizes phase after /jdi-verify approves. Updates ROADMAP.md (phase: done), advances STATE to next phase, final commit.
+</objective>
+
+<arguments>
+- `phase_number` (required)
+</arguments>
+
+<process>
+
+### Step 1: Validation
+```bash
+test -d .jdi/ || { echo "Not a JDI project."; exit 1; }
+
+# Verify REVIEW.md exists
+ls .jdi/phases/{NN}*/REVIEW.md 2>/dev/null || {
+  echo "REVIEW.md missing. /jdi-verify {N}."
+  exit 1
+}
+
+# Read verdict
+VERDICT=$(grep -oE 'Verdict:\*\* (APPROVED|APPROVED_WITH_WARNINGS|BLOCKED)' .jdi/phases/{NN}*/REVIEW.md | awk '{print $2}')
+
+if [ "$VERDICT" = "BLOCKED" ]; then
+  echo "Phase {N} BLOCKED. Fix before ship."
+  exit 1
+fi
+```
+
+### Step 2: Confirm with user (only if WITH_WARNINGS)
+
+If `VERDICT=APPROVED_WITH_WARNINGS`:
+```
+Phase {N} has uncorrected warnings. Ship anyway?
+- Yes, ship (warnings remain in REVIEW.md)
+- No, fix first
+```
+
+If "No" -> exit clean.
+
+### Step 3: Update ROADMAP.md
+
+Edit `.jdi/ROADMAP.md`:
+- Phase {N}: `status: done`
+- Phase {N+1}: `status: ready` (if exists)
+
+If no phase {N+1}:
+```
+All phases complete.
+Project delivered.
+```
+
+### Step 4: Update STATE.md
+
+```markdown
+current_phase: {N+1 or done}
+phase_status: ready (if {N+1} exists) or complete
+next_step: /jdi-discuss {N+1} or done
+```
+
+### Step 5: Archive old phases (compaction)
+
+Read `archive_after` from `.jdi/config.json` (default 5). If current phase advances to `N+1`, and a phase exists with number `<= (N+1) - archive_after`, move to `.jdi/archive/`.
+
+```bash
+ARCHIVE_AFTER=5
+if [ -f .jdi/config.json ]; then
+  if command -v jq >/dev/null 2>&1; then
+    ARCHIVE_AFTER=$(jq -r '.compaction.archive_after // 5' .jdi/config.json)
+  fi
+fi
+
+NEXT=$((N + 1))
+THRESHOLD=$((NEXT - ARCHIVE_AFTER))
+
+if [ "$THRESHOLD" -ge 1 ]; then
+  mkdir -p .jdi/archive
+  test -f .jdi/archive/index.md || echo "# Archive index" > .jdi/archive/index.md
+
+  for dir in .jdi/phases/*/; do
+    NN=$(basename "$dir" | grep -oE '^[0-9]+' || true)
+    [ -z "$NN" ] && continue
+    NN_NUM=$((10#$NN))  # force decimal
+    if [ "$NN_NUM" -le "$THRESHOLD" ]; then
+      VERDICT_OLD=$(grep -oE 'Verdict:\*\* (APPROVED|APPROVED_WITH_WARNINGS|BLOCKED)' "$dir/REVIEW.md" 2>/dev/null | awk '{print $2}' || echo "UNKNOWN")
+      mv "$dir" .jdi/archive/
+      echo "- $(basename "$dir"): ${VERDICT_OLD} (archived $(date -u +%F))" >> .jdi/archive/index.md
+    fi
+  done
+fi
+# Windows: equivalent in PowerShell — Move-Item + Add-Content
+```
+
+Archived phases remain accessible via `.jdi/archive/` but exit the default read-path. Read-depth rule (`ARCHITECTURE.md > Read-depth scaling`) treats archive as `<= current - 2`.
+
+### Step 6: Final commit
+
+```bash
+git add .jdi/ROADMAP.md .jdi/STATE.md .jdi/archive/ 2>/dev/null
+git commit -m "feat({NN-slug}): ship phase {N} ({VERDICT})"
+```
+
+Optional tag (if PROJECT.md has `tag_phases: true`):
+```bash
+git tag "phase-{N}-{slug}"
+```
+
+### Step 7: Confirm
+
+```
+Phase {N} shipped.
+{if more phases:} Next: /jdi-discuss {N+1}
+{if last:} Project delivered. Tag: phase-{N}-{slug}
+```
+
+</process>
+
+<gates>
+- pre: REVIEW.md exists + verdict != BLOCKED
+- post: ROADMAP.md + STATE.md updated + old phases archived (if applicable) + commit (+ optional tag)
+</gates>
+
+<errors>
+- REVIEW missing -> /jdi-verify
+- Verdict BLOCKED -> abort
+- Already shipped -> abort with warning
+</errors>

package/runtimes/opencode/commands/jdi-verify.md

@@ -0,0 +1,159 @@
+---
+name: jdi-verify
+description: Runs phase quality gates via reviewer specialist. Build, tests, coverage, lint, security checks. Verdict APPROVED / APPROVED_WITH_WARNINGS / BLOCKED.
+argument_hint: "<phase_number>"
+runtime_intent:
+  invokes_agent: dynamic
+runtime_overrides:
+  claude:
+    allowed-tools: [Read, Bash, Grep, Glob, Agent]
+  copilot:
+    tools: [read, grep, glob, terminal]
+  opencode:
+    subtask: true
+    model: anthropic/claude-sonnet-4-20250514
+  antigravity:
+    triggers:
+      - "/jdi-verify"
+      - "verify phase {N}"
+---
+
+<objective>
+Verifies the phase was delivered correctly. Runs gates defined in the project's reviewer specialist. Verdict blocks or releases the ship.
+</objective>
+
+<arguments>
+- `phase_number` (required)
+</arguments>
+
+<process>
+
+### Step 1: Validation
+```bash
+test -d .jdi/ || { echo "Not a JDI project."; exit 1; }
+
+# Verify reviewer exists
+ls .jdi/agents/jdi-reviewer-*.md 2>/dev/null | head -1 || {
+  echo "Reviewer missing. /jdi-bootstrap."
+  exit 1
+}
+
+# Verify phase was executed
+ls .jdi/phases/{NN}*/SUMMARY.md 2>/dev/null || {
+  echo "Phase {N} not executed. /jdi-do {N}."
+  exit 1
+}
+
+# Context budget warm-up (does not block)
+JDI_LIB="$(dirname "$(command -v jdi 2>/dev/null || echo /usr/local/bin/jdi)")/../lib"
+if [ -f "$JDI_LIB/jdi-monitor.sh" ]; then
+  bash "$JDI_LIB/jdi-monitor.sh" .jdi/PROJECT.md .jdi/DECISIONS.md .jdi/phases/{NN}*/PLAN.md .jdi/phases/{NN}*/SUMMARY.md || true
+fi
+# Windows: pwsh -File "$JDI_LIB/jdi-monitor.ps1" -Paths @(...)
+```
+
+### Step 2: Resolve reviewer specialist(s)
+
+```bash
+REVIEWERS=$(grep -oE 'jdi-reviewer-[a-z0-9-]+' .jdi/reviewers.md | sort -u)
+REVIEWER_COUNT=$(echo "$REVIEWERS" | wc -l)
+echo "Reviewers registered: $REVIEWER_COUNT"
+```
+
+**Single-stack** (`REVIEWER_COUNT == 1`): one reviewer, normal flow.
+**Multi-stack** (`REVIEWER_COUNT > 1`): chain reviewers in registry order. Each writes its own REVIEW segment; aggregate verdict = worst-case (1 BLOCK = overall BLOCK).
+
+### Step 3: Spawn reviewer(s)
+
+**Single-stack:**
+```
+Agent(
+  subagent_type="${REVIEWERS}",
+  description="Verify phase {N}",
+  prompt="phase={N}, mode=verify"
+)
+```
+
+**Multi-stack:** spawn each reviewer in sequence (NOT parallel — build/test commands may conflict on ports, locks, output dirs):
+
+```
+for REVIEWER in $REVIEWERS:
+  Agent(
+    subagent_type="$REVIEWER",
+    description="Verify phase {N} ({REVIEWER})",
+    prompt="phase={N}, mode=verify, reviewer_segment=${REVIEWER}"
+  )
+  # Each reviewer appends to .jdi/phases/{NN-slug}/REVIEW.md under section
+  # "## Reviewer: {REVIEWER}" with its own gate results and verdict
+```
+
+Each reviewer scopes its gates to its `file_glob` (from frontmatter `scope.file_glob`). Coverage threshold enforced only on files matching the glob.
+
+Reviewers are read-only. Wait for completion before next.
+
+### Step 4: Read aggregate verdict
+
+```bash
+test -f .jdi/phases/{NN}*/REVIEW.md || { echo "REVIEW.md not created"; exit 1; }
+
+# Collect all per-reviewer verdicts
+VERDICTS=$(grep -oE 'Verdict:\*\* (APPROVED|APPROVED_WITH_WARNINGS|BLOCKED)' .jdi/phases/{NN}*/REVIEW.md | awk '{print $2}')
+
+# Worst-case wins: BLOCK > WARNINGS > APPROVED
+if echo "$VERDICTS" | grep -q BLOCKED; then
+  VERDICT=BLOCKED
+elif echo "$VERDICTS" | grep -q APPROVED_WITH_WARNINGS; then
+  VERDICT=APPROVED_WITH_WARNINGS
+else
+  VERDICT=APPROVED
+fi
+
+# For single-stack, this collapses to the single reviewer's verdict — backward compatible.
+```
+
+### Step 5: Update STATE
+
+```markdown
+current_phase: {N}
+phase_status: {verified|blocked}
+phase_verdict: {APPROVED|APPROVED_WITH_WARNINGS|BLOCKED}
+next_step: {if APPROVED or WITH_WARNINGS: /jdi-ship {N}; if BLOCKED: fix and /jdi-do {N} again}
+```
+
+```bash
+git add .jdi/phases/{NN-slug}/REVIEW.md .jdi/STATE.md
+git commit -m "docs({NN-slug}): verify phase ({VERDICT})"
+```
+
+### Step 6: Confirm
+
+**APPROVED:**
+```
+Phase {N}: APPROVED. Next: /jdi-ship {N}
+```
+
+**APPROVED_WITH_WARNINGS:**
+```
+Phase {N}: APPROVED_WITH_WARNINGS ({count} warnings).
+REVIEW.md: .jdi/phases/{NN-slug}/REVIEW.md
+Next: /jdi-ship {N} (or fix first)
+```
+
+**BLOCKED:**
+```
+Phase {N}: BLOCKED ({count} blockers). REVIEW.md: .jdi/phases/{NN-slug}/REVIEW.md
+Fix → /jdi-do {N} → /jdi-verify {N}
+```
+
+</process>
+
+<gates>
+- pre: SUMMARY.md exists + reviewer registered in .jdi/reviewers.md
+- post: REVIEW.md created + STATE updated
+</gates>
+
+<errors>
+- Reviewer missing -> /jdi-bootstrap
+- SUMMARY missing -> /jdi-do
+- Reviewer fails -> show error, keep state, suggest retry
+</errors>

package/runtimes/opencode/opencode.example.jsonc

@@ -0,0 +1,169 @@
+// OpenCode config — JDI managed (autonomous mode)
+//
+// Manual edits abaixo desta linha sao preservados quando /jdi-bootstrap rodar
+// de novo (provider e agent.jdi-* sao gerenciados pelo JDI; outros campos sao seus).
+//
+// Schema reference: https://opencode.ai/docs/config
+//
+// JDI default = AUTONOMOUS: comandos seguros (ls, cat, mkdir, git seguros,
+// build/test toolchain) sao auto-permitidos. Comandos perigosos (rm -rf, git push,
+// reset --hard, sudo, curl) ainda pedem confirmacao.
+//
+// Pra paranoid mode (pede permissao em tudo), troca todas linhas "allow" por "ask".
+// Pra YOLO mode (sem nada de seguranca), troca pra "*": "allow" — NAO RECOMENDADO.
+{
+  "$schema": "https://opencode.ai/config.json",
+  // Custom instructions: arquivos carregados como contexto extra alem do AGENTS.md.
+  // Descomente se quiser que TODO prompt do agent default carregue PROJECT.md:
+  // "instructions": [".jdi/PROJECT.md", ".jdi/DECISIONS.md"],
+  "permission": {
+    "edit": "allow",
+    "webfetch": "ask",
+    "bash": {
+      // === Read-only / inspecao — allow ===
+      "ls*": "allow",
+      "dir*": "allow",
+      "cat*": "allow",
+      "type*": "allow",
+      "pwd": "allow",
+      "echo*": "allow",
+      "Get-ChildItem*": "allow",
+      "Get-Content*": "allow",
+      "Get-Location": "allow",
+      "Test-Path*": "allow",
+      "Select-String*": "allow",
+      "head*": "allow",
+      "tail*": "allow",
+      "grep*": "allow",
+      "rg*": "allow",
+      "find*": "allow",
+      "which*": "allow",
+      "where*": "allow",
+      // === Filesystem write seguro — allow ===
+      "mkdir*": "allow",
+      "New-Item*": "allow",
+      "touch*": "allow",
+      "Set-Content*": "allow",
+      "Add-Content*": "allow",
+      "Out-File*": "allow",
+      "cp*": "allow",
+      "Copy-Item*": "allow",
+      "mv*": "allow",
+      "Move-Item*": "allow",
+      "Rename-Item*": "allow",
+      // === Git seguro — allow ===
+      "git status*": "allow",
+      "git log*": "allow",
+      "git diff*": "allow",
+      "git add*": "allow",
+      "git commit*": "allow",
+      "git tag*": "allow",
+      "git branch*": "allow",
+      "git checkout*": "allow",
+      "git switch*": "allow",
+      "git config*": "allow",
+      "git rev-parse*": "allow",
+      "git symbolic-ref*": "allow",
+      "git init*": "allow",
+      "git stash*": "allow",
+      "git fetch*": "allow",
+      "git pull --ff-only*": "allow",
+      "git restore*": "allow",
+      "git show*": "allow",
+      "git remote -v*": "allow",
+      "git ls-files*": "allow",
+      // === Build/test toolchain — allow ===
+      "dotnet build*": "allow",
+      "dotnet test*": "allow",
+      "dotnet format*": "allow",
+      "dotnet ef*": "allow",
+      "dotnet run*": "allow",
+      "dotnet new*": "allow",
+      "dotnet add*": "allow",
+      "dotnet restore*": "allow",
+      "pnpm *": "allow",
+      "npm run*": "allow",
+      "npm test*": "allow",
+      "npm install*": "allow",
+      "npm ci*": "allow",
+      "npx *": "allow",
+      "yarn *": "allow",
+      "vitest*": "allow",
+      "jest*": "allow",
+      "playwright*": "allow",
+      "pytest*": "allow",
+      "poetry *": "allow",
+      "uv *": "allow",
+      "pip install*": "allow",
+      "cargo build*": "allow",
+      "cargo test*": "allow",
+      "cargo check*": "allow",
+      "cargo clippy*": "allow",
+      "cargo fmt*": "allow",
+      "go build*": "allow",
+      "go test*": "allow",
+      "go run*": "allow",
+      "go fmt*": "allow",
+      "make*": "allow",
+      // === Container/orquestracao seguro — allow ===
+      "docker ps*": "allow",
+      "docker images*": "allow",
+      "docker logs*": "allow",
+      "docker compose ps*": "allow",
+      "docker compose logs*": "allow",
+      "kubectl get*": "allow",
+      "kubectl describe*": "allow",
+      "kubectl logs*": "allow",
+      // === Perigosos — ask ===
+      // "git push*": "ask",
+      // "git push --force*": "ask",
+      // "git reset --hard*": "ask",
+      // "git rebase*": "ask",
+      // "git revert*": "ask",
+      // "git merge*": "ask",
+      // "git clean*": "ask",
+      // "rm -rf*": "ask",
+      // "rmdir*": "ask",
+      // "Remove-Item*": "ask",
+      // "del *": "ask",
+      // "chmod*": "ask",
+      // "chown*": "ask",
+      // "sudo*": "ask",
+      // "curl*": "ask",
+      // "wget*": "ask",
+      // "Invoke-WebRequest*": "ask",
+      // "Invoke-RestMethod*": "ask",
+      // "docker run*": "ask",
+      // "docker rm*": "ask",
+      // "docker rmi*": "ask",
+      // "docker volume rm*": "ask",
+      // "docker compose down*": "ask",
+      // "kubectl delete*": "ask",
+      // "kubectl apply*": "ask",
+      // "Set-ExecutionPolicy*": "ask",
+      // === Catch-all — ask ===
+      "*": "allow"
+    }
+  }
+  // ---- INJETADO PELO /jdi-bootstrap (se llm_config customizado em PROJECT.md) ----
+  //
+  // Exemplo Ollama:
+  // "provider": {
+  //   "ollama": {
+  //     "npm": "@ai-sdk/openai-compatible",
+  //     "name": "Ollama",
+  //     "options": { "baseURL": "http://localhost:11434/v1" },
+  //     "models": {
+  //       "glm-5.1:cloud": { "name": "GLM 5.1 Cloud", "tools": true }
+  //     }
+  //   }
+  // },
+  // "model": "ollama/glm-5.1:cloud",
+  // "agent": {
+  //   "jdi-doer-{slug}": { "model": "ollama/glm-5.1:cloud" },
+  //   "jdi-reviewer-{slug}": { "model": "ollama/glm-5.1:cloud" }
+  // }
+  // Custom commands sao auto-descobertos em .opencode/commands/*.md
+  // Custom agents sao auto-descobertos em .opencode/agents/*.md
+  // Custom skills sao auto-descobertos em .opencode/skills/<name>/SKILL.md
+}