pluidr 0.6.1 → 0.7.0

package/README.md

@@ -10,13 +10,13 @@
 
 ## What is Pluidr?
 
-Pluidr installs a **17-agent pipeline** into OpenCode — structured around **3 primary agents**, each with their own exclusive subagents, scoped permissions, and enforced workflow rules. No shared subagents. No ad-hoc delegation.
+Pluidr installs **3 primary agents + 14 subagents** into OpenCode — each primary agent owns its exclusive subagents, scoped permissions, and enforced workflow rules. No shared subagents. No ad-hoc delegation.
 
-| Primary Agent | Purpose | Subagents |
-|---|---|---|
-| **Composer** | Feature work — Explore → Plan → Build | Researcher, Plan-Writer, Plan-Checker, Coder, Tester, Reviewer, Compose-Reporter |
-| **Debugger** | Bug investigation — Investigate → Fix → Report | Inspector, Fixer, Debug-Reporter |
-| **Prober** | Security audit — Trace → Patch → Audit | Tracer, Patcher, Auditor, Probe-Reporter |
+| Primary Agent | Model Tier | Purpose | Subagents |
+|---|---|---|---|
+| **Composer** | 🧠 Reasoning | Feature work — Explore → Plan → Build | Researcher, Plan-Writer, Plan-Checker, Coder, Tester, Reviewer, Compose-Reporter |
+| **Debugger** | 🧠 Reasoning | Bug investigation — Investigate → Fix → Report | Inspector, Fixer, Debug-Reporter |
+| **Prober** | 🧠 Reasoning | Security audit — Trace → Patch → Audit | Tracer, Patcher, Auditor, Probe-Reporter |
 
 ---
 
@@ -231,22 +231,22 @@ You trigger a security audit
 
 Each subagent belongs to exactly one primary agent and cannot be invoked by anyone else:
 
-| Primary | Phase | Subagent | Role |
-|---------|-------|----------|------|
-| Composer | EXPLORE | Researcher | Fact-finding: confirmed_facts / inferred_facts / unknowns / risks |
-| Composer | PLAN | Plan-Writer | **Formatter** — writes PRD to `docs/plans/`, missing input = TBD |
-| Composer | PLAN | Plan-Checker | **Gate** — PASS/FAIL + gap list only, no suggestions |
-| Composer | BUILD | Coder | Implements code from PRD |
-| Composer | BUILD | Tester | PASS/FAIL/BLOCKED + coverage gaps only |
-| Composer | BUILD | Reviewer | **Gate** — PASS/FAIL + gap list only, no suggestions |
-| Composer | BUILD | Compose-Reporter | **Formatter** — completion report to `docs/reports/` |
-| Debugger | DEBUG | Inspector | Brooks-Lint RCA (Iron Law + 6 decay risks + 4 review modes) |
-| Debugger | DEBUG | Fixer | Minimal, root-cause-targeted fix |
-| Debugger | DEBUG | Debug-Reporter | **Formatter** — Iron Law diagnosis report to `docs/reports/` |
-| Prober | TRACE | Tracer | WSTG recon + vuln path tracing, no remedies |
-| Prober | PATCH | Patcher | Minimal, security-targeted fix (Ponytail, max 10 lines) |
-| Prober | AUDIT | Auditor | **Gate** — PASS/FAIL + Gap List + BLOAT List only |
-| Prober | AUDIT | Probe-Reporter | **Formatter** — security audit report to `docs/reports/` |
+| Primary | Phase | Subagent | Model Tier | Role |
+|---------|-------|----------|------------|------|
+| Composer | EXPLORE | Researcher | 🧠 Reasoning | Fact-finding: confirmed_facts / inferred_facts / unknowns / risks |
+| Composer | PLAN | Plan-Writer | ⚡ Fast | **Formatter** — writes PRD to `docs/plans/`, missing input = TBD |
+| Composer | PLAN | Plan-Checker | 🧠 Reasoning | **Gate** — PASS/FAIL + gap list only, no suggestions |
+| Composer | BUILD | Coder | ⚡ Fast | Implements code from PRD |
+| Composer | BUILD | Tester | 🎯 Precision | PASS/FAIL/BLOCKED + coverage gaps only |
+| Composer | BUILD | Reviewer | 🎯 Precision | **Gate** — PASS/FAIL + gap list only, no suggestions |
+| Composer | BUILD | Compose-Reporter | ⚡ Fast | **Formatter** — completion report to `docs/reports/` |
+| Debugger | INVESTIGATE | Inspector | 🧠 Reasoning | Brooks-Lint RCA (Iron Law + 6 decay risks + 4 review modes) |
+| Debugger | FIX | Fixer | ⚡ Fast | Minimal, root-cause-targeted fix |
+| Debugger | REPORT | Debug-Reporter | ⚡ Fast | **Formatter** — Iron Law diagnosis report to `docs/reports/` |
+| Prober | TRACE | Tracer | 🎯 Precision | WSTG recon + vuln path tracing, no remedies |
+| Prober | PATCH | Patcher | ⚡ Fast | Minimal, security-targeted fix (Ponytail, max 10 lines) |
+| Prober | AUDIT | Auditor | 🎯 Precision | **Gate** — PASS/FAIL + Gap List + BLOAT List only |
+| Prober | AUDIT | Probe-Reporter | ⚡ Fast | **Formatter** — security audit report to `docs/reports/` |
 
 ---
 
@@ -301,9 +301,17 @@ npx pluidr init
 
 ## Usage
 
+### `pluidr`
+
+The everyday command. Runs three steps in sequence:
+
+1. **Update check** — compares local version against npm registry; prompts to `npm install -g pluidr` if a new version is available
+2. **Doctor check** — verifies installation health; prompts to repair with `pluidr init` if any checks fail
+3. **Launch** — spawns `opencode`
+
 ### `pluidr init`
 
-Prompts you to select models for two agent tiers (reasoning-heavy and fast), then:
+Prompts you to select models for three agent tiers (reasoning, precision, and fast), then:
 
 - Asks whether to install the pluidr-squeeze plugin (can decline)
 - Builds a complete `opencode.jsonc` config with the chosen models injected into the right agents
@@ -328,7 +336,7 @@ Exits with code `0` if all pass, `1` if any fail.
 
 ### `pluidr update`
 
-Re-runs the setup wizard. Warns if existing config is found and asks for confirmation before overwriting.
+Checks the npm registry for a newer version of pluidr and prompts to install it.
 
 ### `pluidr uninstall`
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pluidr",
-  "version": "0.6.1",
+  "version": "0.7.0",
   "description": "Opinionated Engineering Workflow for OpenCode — Explore, Plan, Build, Debug, and Security-Audit.",
   "keywords": [
     "opencode",

package/src/cli/commands/doctor.js

@@ -1,15 +1,12 @@
 import { existsSync, readFileSync, readdirSync } from "node:fs"
-import { join, dirname } from "node:path"
-import { fileURLToPath } from "node:url"
-import { execFileSync } from "node:child_process"
+import { join } from "node:path"
 import { getConfigDir, getConfigPath, getPromptsDir } from "../../core/paths.js"
 import { findSqueezePath } from "../../core/squeezeInstaller.js"
 
-const __dirname = dirname(fileURLToPath(import.meta.url))
 const EXPECTED_PROMPT_COUNT = 18
 const PLUGIN_FILES = ["pluidr-flow.js", "pluidr-squeeze.js"]
 
-export async function runDoctor() {
+export function collectChecks() {
   const configDir = getConfigDir()
   const configPath = getConfigPath()
   const promptsDir = getPromptsDir()
@@ -79,8 +76,13 @@ export async function runDoctor() {
   }
   checks.push({ component: "config JSON validity", pass: configValid })
 
-  // Print summary table
+  return checks
+}
+
+export async function runDoctor() {
+  const checks = collectChecks()
   const allPass = checks.every((c) => c.pass)
+
   console.log("\nPluidr Doctor — Installation Health Check\n")
   for (const c of checks) {
     const icon = c.pass ? "\u2713" : "\u2717"

package/src/cli/commands/init.js

@@ -25,7 +25,7 @@ export async function runInit() {
     initialValue: true,
   })
 
-  const installSqueezePlugin = isCancel(squeezeAnswer) ? true : squeezeAnswer
+  const installSqueezePlugin = isCancel(squeezeAnswer) ? false : squeezeAnswer
 
   backupExistingConfig()
 

package/src/cli/commands/launch.js

@@ -0,0 +1,44 @@
+import { spawn } from "node:child_process"
+import { confirm, isCancel } from "@clack/prompts"
+import { checkAndPromptUpdate } from "../../core/versionCheck.js"
+import { version } from "../../core/version.js"
+import { collectChecks } from "./doctor.js"
+import { runInit } from "./init.js"
+
+export async function runLaunch() {
+  // 1. Update check
+  await checkAndPromptUpdate(version)
+
+  // 2. Doctor check
+  process.stdout.write("Running doctor...         ")
+  const checks = collectChecks()
+  const allPass = checks.every((c) => c.pass)
+
+  if (allPass) {
+    console.log("✓ All checks passed")
+  } else {
+    const failed = checks.filter((c) => !c.pass)
+    console.log(`✗ ${failed.length} check${failed.length > 1 ? "s" : ""} failed`)
+    for (const c of failed) {
+      const detail = c.detail ? ` (${c.detail})` : ""
+      console.log(`  ✗ ${c.component}${detail}`)
+    }
+
+    const answer = await confirm({ message: "Repair with pluidr init?", initialValue: true })
+    if (!isCancel(answer) && answer) {
+      await runInit()
+    }
+  }
+
+  // 3. Launch opencode
+  console.log("Launching opencode...")
+  const child = spawn("opencode", [], { stdio: "inherit" })
+  child.on("error", (err) => {
+    if (err.code === "ENOENT") {
+      console.error("Error: opencode not found on PATH. Install it from https://opencode.ai")
+    } else {
+      console.error(`Error launching opencode: ${err.message}`)
+    }
+    process.exit(1)
+  })
+}

package/src/cli/commands/uninstall.js

@@ -1,5 +1,5 @@
 import { existsSync, copyFileSync, rmSync, readdirSync } from "node:fs"
-import { join, dirname } from "node:path"
+import { join } from "node:path"
 import { getConfigDir, getConfigPath } from "../../core/paths.js"
 
 function findLatestBackup() {
@@ -27,11 +27,7 @@ export async function runUninstall() {
 
   // Restore latest backup
   const latestBackup = findLatestBackup()
-  if (latestBackup && existsSync(configPath)) {
-    copyFileSync(latestBackup, configPath)
-    summary.restored = latestBackup
-  } else if (latestBackup) {
-    // Config doesn't exist but backup does — restore anyway
+  if (latestBackup) {
     copyFileSync(latestBackup, configPath)
     summary.restored = latestBackup
   }

package/src/cli/commands/update.js

@@ -1,22 +1,6 @@
-import { existsSync } from "node:fs"
-import { confirm, isCancel } from "@clack/prompts"
-import { getConfigPath } from "../../core/paths.js"
-import { runInit } from "./init.js"
+import { checkAndPromptUpdate } from "../../core/versionCheck.js"
+import { version } from "../../core/version.js"
 
 export async function runUpdate() {
-  const configPath = getConfigPath()
-
-  if (existsSync(configPath)) {
-    const answer = await confirm({
-      message: "Existing Pluidr config found. Overwrite? (Y/n)",
-      initialValue: true,
-    })
-
-    if (isCancel(answer) || !answer) {
-      console.log("Update cancelled.")
-      return
-    }
-  }
-
-  await runInit()
+  await checkAndPromptUpdate(version)
 }

package/src/cli/index.js

@@ -5,30 +5,33 @@ import { runInit } from "./commands/init.js"
 import { runUninstall } from "./commands/uninstall.js"
 import { runUpdate } from "./commands/update.js"
 import { runDoctor } from "./commands/doctor.js"
+import { runLaunch } from "./commands/launch.js"
+import { version } from "../core/version.js"
 
-const __dirname = dirname(fileURLToPath(import.meta.url))
-const pkg = JSON.parse(readFileSync(resolve(__dirname, "../../package.json"), "utf-8"))
+const HELP = `Usage: pluidr [command]
 
-const HELP = `Usage: pluidr <command>
-
-Commands:
-  init          Set up OpenCode with Pluidr's 12-agent pipeline
-  uninstall     Remove Pluidr artifacts and restore previous config
-  update        Re-run setup (overwrites current config)
-  doctor        Verify installation health
-  --version, -v  Print version number
-  --help, -h     Show this help message`
+  pluidr              Check for updates, run doctor, launch opencode
+  pluidr init         Set up OpenCode with Pluidr's 17-agent pipeline
+  pluidr update       Check for pluidr updates
+  pluidr doctor       Verify installation health
+  pluidr uninstall    Remove Pluidr artifacts and restore previous config
+  --version, -v       Print version number
+  --help, -h          Show this help message`
 
 export function run(argv) {
   const cmd = argv[2]
 
+  if (!cmd) {
+    return runLaunch()
+  }
+
   if (cmd === "--help" || cmd === "-h") {
     console.log(HELP)
     return
   }
 
   if (cmd === "--version" || cmd === "-v") {
-    console.log(pkg.version)
+    console.log(version)
     return
   }
 
@@ -48,6 +51,7 @@ export function run(argv) {
     return runDoctor()
   }
 
+  console.error(`Unknown command: ${cmd}\n`)
   console.log(HELP)
   process.exit(1)
 }

package/src/cli/wizard/selectModelTier.js

@@ -1,8 +1,9 @@
 import { select, text, isCancel } from "@clack/prompts"
 
 const TIER_LABELS = {
-  reasoningHeavy: "Model for reasoning task",
-  fast: "Model for fast/cheap task",
+  reasoning: "Model for reasoning task (orchestrators + deep analysis)",
+  precision: "Model for precision task (quality gates + verification)",
+  fast: "Model for fast/cheap task (builders + formatters)",
 }
 
 export async function selectModelTier(modelDefaults) {

package/src/core/backup.js

@@ -20,7 +20,9 @@ function rotateBackups(configPath) {
       .filter((f) => f.startsWith(baseName + "."))
       .map((f) => join(dir, f))
       .sort()
-  } catch { /* dir doesn't exist yet */ }
+  } catch (err) {
+    if (err.code !== "ENOENT") throw err
+  }
 
   while (backups.length >= MAX_BACKUPS) {
     const oldest = backups.shift()

package/src/core/configBuilder.test.js

@@ -12,15 +12,21 @@ describe("configBuilder", () => {
     const configJson = {
       agent: {
         composer: {},
+        reviewer: {},
         coder: {},
       },
     }
     const defaultsJson = {
-      reasoningHeavy: {
+      reasoning: {
         provider: "test",
         model: "big-model",
         agents: ["composer"],
       },
+      precision: {
+        provider: "test",
+        model: "mid-model",
+        agents: ["reviewer"],
+      },
       fast: {
         provider: "test",
         model: "small-model",
@@ -33,15 +39,55 @@ describe("configBuilder", () => {
 
     const result = buildConfig(
       {
-        reasoningHeavy: "test/big-model",
+        reasoning: "test/big-model",
+        precision: "test/mid-model",
         fast: "test/small-model",
       },
       tmpDir,
     )
 
     assert.strictEqual(result.agent.composer.model, "test/big-model")
+    assert.strictEqual(result.agent.reviewer.model, "test/mid-model")
     assert.strictEqual(result.agent.coder.model, "test/small-model")
 
     rmSync(tmpDir, { recursive: true })
   })
+
+  it("throws an error if a defaulted agent is missing from config template", () => {
+    const tmpDir = mkdtempSync(join(tmpdir(), "configbuilder-test-err-"))
+
+    const configJson = {
+      agent: {
+        // missing 'composer'
+        coder: {},
+      },
+    }
+    const defaultsJson = {
+      reasoning: {
+        provider: "test",
+        model: "big-model",
+        agents: ["composer"],
+      },
+      fast: {
+        provider: "test",
+        model: "small-model",
+        agents: ["coder"],
+      },
+    }
+
+    writeFileSync(join(tmpDir, "opencode.config.json"), JSON.stringify(configJson), "utf-8")
+    writeFileSync(join(tmpDir, "model-defaults.json"), JSON.stringify(defaultsJson), "utf-8")
+
+    assert.throws(() => {
+      buildConfig(
+        {
+          reasoning: "test/big-model",
+          fast: "test/small-model",
+        },
+        tmpDir,
+      )
+    }, /Template validation failed: agent\(s\) not found/)
+
+    rmSync(tmpDir, { recursive: true })
+  })
 })

package/src/core/version.js

@@ -0,0 +1,8 @@
+import { readFileSync } from "node:fs"
+import { resolve, dirname } from "node:path"
+import { fileURLToPath } from "node:url"
+
+const __dirname = dirname(fileURLToPath(import.meta.url))
+export const version = JSON.parse(
+  readFileSync(resolve(__dirname, "../../package.json"), "utf-8")
+).version

package/src/core/versionCheck.js

@@ -0,0 +1,35 @@
+import { execFileSync } from "node:child_process"
+import { confirm, isCancel } from "@clack/prompts"
+
+export function fetchLatestVersion() {
+  try {
+    return execFileSync("npm", ["view", "pluidr", "version"], { stdio: "pipe" })
+      .toString()
+      .trim()
+  } catch {
+    return null
+  }
+}
+
+export async function checkAndPromptUpdate(currentVersion) {
+  process.stdout.write("Checking for updates...   ")
+
+  const latest = fetchLatestVersion()
+  if (!latest) {
+    console.log("⚠ Could not reach npm registry — skipping")
+    return false
+  }
+
+  if (latest === currentVersion) {
+    console.log(`✓ Up to date (${currentVersion})`)
+    return false
+  }
+
+  console.log(`⚠ pluidr ${latest} available  (you have ${currentVersion})`)
+
+  const answer = await confirm({ message: "Update now?", initialValue: true })
+  if (isCancel(answer) || !answer) return false
+
+  execFileSync("npm", ["install", "-g", "pluidr"], { stdio: "inherit" })
+  return true
+}

package/src/core/versionCheck.test.js

@@ -0,0 +1,24 @@
+import { describe, it } from "node:test"
+import assert from "node:assert"
+import { execFileSync } from "node:child_process"
+import { fetchLatestVersion } from "./versionCheck.js"
+
+describe("fetchLatestVersion", () => {
+  it("returns a string or null", () => {
+    // Either reaches npm registry (string) or fails gracefully (null)
+    const result = fetchLatestVersion()
+    assert.ok(result === null || typeof result === "string")
+  })
+
+  it("returns null when npm command throws", () => {
+    // Verify the try/catch in fetchLatestVersion swallows errors
+    let caught = null
+    try {
+      execFileSync("npm", ["view", "__nonexistent_pkg_xyz_pluidr__", "version"], { stdio: "pipe" })
+    } catch (err) {
+      caught = err
+    }
+    // npm throws on unknown package — fetchLatestVersion handles this and returns null
+    assert.ok(caught instanceof Error, "npm should throw for unknown package")
+  })
+})

package/src/templates/model-defaults.json

@@ -1,14 +1,14 @@
 {
-  "reasoningHeavy": {
+  "reasoning": {
     "provider": "opencode",
     "model": "big-pickle",
     "agents": [
       "composer",
       "debugger",
+      "prober",
       "researcher",
       "plan-checker",
-      "inspector",
-      "prober"
+      "inspector"
     ],
 
     "recommended": [
@@ -23,20 +23,38 @@
       { "value": "openai/gpt-5.5", "label": "openai/gpt-5.5" }
     ]
   },
+  "precision": {
+    "provider": "opencode",
+    "model": "big-pickle",
+    "agents": [
+      "tester",
+      "reviewer",
+      "auditor",
+      "tracer"
+    ],
+
+    "recommended": [
+      {
+        "value": "opencode/big-pickle",
+        "label": "default (opencode/big-pickle)"
+      },
+      {
+        "value": "anthropic/claude-sonnet-4-5",
+        "label": "anthropic/claude-sonnet-4-5"
+      },
+      { "value": "openai/gpt-5.1", "label": "openai/gpt-5.1" }
+    ]
+  },
   "fast": {
     "provider": "opencode",
     "model": "deepseek-v4-flash-free",
     "agents": [
       "coder",
-      "tester",
-      "reviewer",
-      "compose-reporter",
       "fixer",
+      "patcher",
       "plan-writer",
+      "compose-reporter",
       "debug-reporter",
-      "tracer",
-      "patcher",
-      "auditor",
       "probe-reporter"
     ],