pluidr 0.6.1 → 0.7.1

package/src/cli/index.js

@@ -1,53 +1,57 @@
-import { readFileSync } from "node:fs"
-import { resolve, dirname } from "node:path"
-import { fileURLToPath } from "node:url"
-import { runInit } from "./commands/init.js"
-import { runUninstall } from "./commands/uninstall.js"
-import { runUpdate } from "./commands/update.js"
-import { runDoctor } from "./commands/doctor.js"
-
-const __dirname = dirname(fileURLToPath(import.meta.url))
-const pkg = JSON.parse(readFileSync(resolve(__dirname, "../../package.json"), "utf-8"))
-
-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`
-
-export function run(argv) {
-  const cmd = argv[2]
-
-  if (cmd === "--help" || cmd === "-h") {
-    console.log(HELP)
-    return
-  }
-
-  if (cmd === "--version" || cmd === "-v") {
-    console.log(pkg.version)
-    return
-  }
-
-  if (cmd === "init") {
-    return runInit()
-  }
-
-  if (cmd === "uninstall") {
-    return runUninstall()
-  }
-
-  if (cmd === "update") {
-    return runUpdate()
-  }
-
-  if (cmd === "doctor") {
-    return runDoctor()
-  }
-
-  console.log(HELP)
-  process.exit(1)
-}
+import { readFileSync } from "node:fs"
+import { resolve, dirname } from "node:path"
+import { fileURLToPath } from "node:url"
+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 HELP = `Usage: pluidr [command]
+
+  pluidr              Launch OpenCode powered by Pluidr agents
+  pluidr init         Install and configure the Pluidr agent pipeline
+  pluidr update       Check and update the Pluidr system
+  pluidr doctor       Diagnose the integrity of the current installation
+  pluidr uninstall    Remove Pluidr artifacts and restore the previous config
+  --version, -v       Print the current 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(version)
+    return
+  }
+
+  if (cmd === "init") {
+    return runInit()
+  }
+
+  if (cmd === "uninstall") {
+    return runUninstall()
+  }
+
+  if (cmd === "update") {
+    return runUpdate()
+  }
+
+  if (cmd === "doctor") {
+    return runDoctor()
+  }
+
+  console.error(`Unknown command: ${cmd}\n`)
+  console.log(HELP)
+  process.exit(1)
+}

package/src/cli/wizard/selectModelTier.js

@@ -1,39 +1,40 @@
-import { select, text, isCancel } from "@clack/prompts"
-
-const TIER_LABELS = {
-  reasoningHeavy: "Model for reasoning task",
-  fast: "Model for fast/cheap task",
-}
-
-export async function selectModelTier(modelDefaults) {
-  const choices = {}
-  for (const [tierKey, tierInfo] of Object.entries(modelDefaults)) {
-    const defaultModel = `${tierInfo.provider}/${tierInfo.model}`
-    const label = TIER_LABELS[tierKey] ?? tierKey
-
-    const recommendedOptions = (tierInfo.recommended || []).map((r) => ({
-      value: r.value,
-      label: r.label,
-    }))
-
-    const options = [
-      ...recommendedOptions,
-      { value: "__custom__", label: "custom  (enter provider/model)" },
-    ]
-
-    const answer = await select({
-      message: label,
-      options,
-    })
-
-    if (isCancel(answer)) {
-      choices[tierKey] = defaultModel
-    } else if (answer === "__custom__") {
-      const customModel = await text({ message: "Enter model:" })
-      choices[tierKey] = isCancel(customModel) ? defaultModel : (customModel || defaultModel)
-    } else {
-      choices[tierKey] = answer
-    }
-  }
-  return choices
-}
+import { select, text, isCancel } from "@clack/prompts"
+
+const TIER_LABELS = {
+  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) {
+  const choices = {}
+  for (const [tierKey, tierInfo] of Object.entries(modelDefaults)) {
+    const defaultModel = `${tierInfo.provider}/${tierInfo.model}`
+    const label = TIER_LABELS[tierKey] ?? tierKey
+
+    const recommendedOptions = (tierInfo.recommended || []).map((r) => ({
+      value: r.value,
+      label: r.label,
+    }))
+
+    const options = [
+      ...recommendedOptions,
+      { value: "__custom__", label: "custom  (enter provider/model)" },
+    ]
+
+    const answer = await select({
+      message: label,
+      options,
+    })
+
+    if (isCancel(answer)) {
+      choices[tierKey] = defaultModel
+    } else if (answer === "__custom__") {
+      const customModel = await text({ message: "Enter model:" })
+      choices[tierKey] = isCancel(customModel) ? defaultModel : (customModel || defaultModel)
+    } else {
+      choices[tierKey] = answer
+    }
+  }
+  return choices
+}

package/src/core/agentPromptWriter.js

@@ -1,32 +1,32 @@
-import { mkdirSync, readdirSync, readFileSync, writeFileSync } from "node:fs"
-import { basename, extname, resolve } from "node:path"
-import { getPromptsDir } from "./paths.js"
-import IDENTITY_HEADER from "./identityHeader.js"
-
-// hierarchy.txt is a global reference document (referenced from
-// opencode.config.json's `instructions`), not an agent prompt. It must be
-// copied verbatim — no agent-identity header.
-const REFERENCE_FILES = new Set(["hierarchy"])
-
-export function writeAgentPrompts(templatesDir, destDir) {
-  const sourceDir = resolve(templatesDir, "agent-prompts")
-  if (!destDir) destDir = getPromptsDir()
-
-  mkdirSync(destDir, { recursive: true })
-
-  for (const file of readdirSync(sourceDir)) {
-    if (extname(file) !== ".txt") continue
-
-    const sourcePath = resolve(sourceDir, file)
-    const destPath = resolve(destDir, file)
-    const content = readFileSync(sourcePath, "utf-8")
-
-    const agentName = basename(file, ".txt")
-    if (REFERENCE_FILES.has(agentName)) {
-      writeFileSync(destPath, content, "utf-8")
-      continue
-    }
-
-    writeFileSync(destPath, IDENTITY_HEADER(agentName) + content, "utf-8")
-  }
-}
+import { mkdirSync, readdirSync, readFileSync, writeFileSync } from "node:fs"
+import { basename, extname, resolve } from "node:path"
+import { getPromptsDir } from "./paths.js"
+import IDENTITY_HEADER from "./identityHeader.js"
+
+// hierarchy.txt is a global reference document (referenced from
+// opencode.config.json's `instructions`), not an agent prompt. It must be
+// copied verbatim — no agent-identity header.
+const REFERENCE_FILES = new Set(["hierarchy"])
+
+export function writeAgentPrompts(templatesDir, destDir) {
+  const sourceDir = resolve(templatesDir, "agent-prompts")
+  if (!destDir) destDir = getPromptsDir()
+
+  mkdirSync(destDir, { recursive: true })
+
+  for (const file of readdirSync(sourceDir)) {
+    if (extname(file) !== ".txt") continue
+
+    const sourcePath = resolve(sourceDir, file)
+    const destPath = resolve(destDir, file)
+    const content = readFileSync(sourcePath, "utf-8")
+
+    const agentName = basename(file, ".txt")
+    if (REFERENCE_FILES.has(agentName)) {
+      writeFileSync(destPath, content, "utf-8")
+      continue
+    }
+
+    writeFileSync(destPath, IDENTITY_HEADER(agentName) + content, "utf-8")
+  }
+}

package/src/core/agentPromptWriter.test.js

@@ -1,56 +1,56 @@
-import { describe, it, after } from "node:test"
-import assert from "node:assert"
-import { existsSync, mkdtempSync, writeFileSync, readFileSync, rmSync, mkdirSync } from "node:fs"
-import { join } from "node:path"
-import { tmpdir } from "node:os"
-import { writeAgentPrompts } from "./agentPromptWriter.js"
-
-describe("agentPromptWriter", () => {
-  const destDir = mkdtempSync(join(tmpdir(), "pluidr-apw-dest-"))
-
-  after(() => {
-    // Clean up any files written during tests
-    if (existsSync(destDir)) rmSync(destDir, { recursive: true })
-  })
-
-  it("prepends identity header to agent prompts", () => {
-    const tmpDir = mkdtempSync(join(tmpdir(), "apw-source-"))
-    const agentPromptsDir = join(tmpDir, "agent-prompts")
-    mkdirSync(agentPromptsDir, { recursive: true })
-
-    writeFileSync(join(agentPromptsDir, "coder.txt"), "test instructions", "utf-8")
-    writeFileSync(join(agentPromptsDir, "compose-reporter.txt"), "write docs", "utf-8")
-
-    writeAgentPrompts(tmpDir, destDir)
-
-    const coderContent = readFileSync(join(destDir, "coder.txt"), "utf-8")
-    const composeReporterContent = readFileSync(join(destDir, "compose-reporter.txt"), "utf-8")
-
-    assert.ok(coderContent.startsWith('You are the "coder" agent.\n\n'),
-      "coder should have identity header")
-    assert.ok(composeReporterContent.startsWith('You are the "compose-reporter" agent.\n\n'),
-      "compose-reporter should have identity header")
-    assert.ok(coderContent.includes("test instructions"),
-      "original content preserved in coder")
-    assert.ok(composeReporterContent.includes("write docs"),
-      "original content preserved in compose-reporter")
-
-    rmSync(tmpDir, { recursive: true })
-  })
-
-  it("copies hierarchy.txt verbatim without identity header", () => {
-    const tmpDir = mkdtempSync(join(tmpdir(), "apw-source2-"))
-    const agentPromptsDir = join(tmpDir, "agent-prompts")
-    mkdirSync(agentPromptsDir, { recursive: true })
-
-    writeFileSync(join(agentPromptsDir, "hierarchy.txt"), "global reference rules", "utf-8")
-
-    writeAgentPrompts(tmpDir, destDir)
-
-    const hierarchyContent = readFileSync(join(destDir, "hierarchy.txt"), "utf-8")
-    assert.strictEqual(hierarchyContent, "global reference rules",
-      "hierarchy.txt should be copied verbatim without header")
-
-    rmSync(tmpDir, { recursive: true })
-  })
-})
+import { describe, it, after } from "node:test"
+import assert from "node:assert"
+import { existsSync, mkdtempSync, writeFileSync, readFileSync, rmSync, mkdirSync } from "node:fs"
+import { join } from "node:path"
+import { tmpdir } from "node:os"
+import { writeAgentPrompts } from "./agentPromptWriter.js"
+
+describe("agentPromptWriter", () => {
+  const destDir = mkdtempSync(join(tmpdir(), "pluidr-apw-dest-"))
+
+  after(() => {
+    // Clean up any files written during tests
+    if (existsSync(destDir)) rmSync(destDir, { recursive: true })
+  })
+
+  it("prepends identity header to agent prompts", () => {
+    const tmpDir = mkdtempSync(join(tmpdir(), "apw-source-"))
+    const agentPromptsDir = join(tmpDir, "agent-prompts")
+    mkdirSync(agentPromptsDir, { recursive: true })
+
+    writeFileSync(join(agentPromptsDir, "coder.txt"), "test instructions", "utf-8")
+    writeFileSync(join(agentPromptsDir, "compose-reporter.txt"), "write docs", "utf-8")
+
+    writeAgentPrompts(tmpDir, destDir)
+
+    const coderContent = readFileSync(join(destDir, "coder.txt"), "utf-8")
+    const composeReporterContent = readFileSync(join(destDir, "compose-reporter.txt"), "utf-8")
+
+    assert.ok(coderContent.startsWith('You are the "coder" agent.\n\n'),
+      "coder should have identity header")
+    assert.ok(composeReporterContent.startsWith('You are the "compose-reporter" agent.\n\n'),
+      "compose-reporter should have identity header")
+    assert.ok(coderContent.includes("test instructions"),
+      "original content preserved in coder")
+    assert.ok(composeReporterContent.includes("write docs"),
+      "original content preserved in compose-reporter")
+
+    rmSync(tmpDir, { recursive: true })
+  })
+
+  it("copies hierarchy.txt verbatim without identity header", () => {
+    const tmpDir = mkdtempSync(join(tmpdir(), "apw-source2-"))
+    const agentPromptsDir = join(tmpDir, "agent-prompts")
+    mkdirSync(agentPromptsDir, { recursive: true })
+
+    writeFileSync(join(agentPromptsDir, "hierarchy.txt"), "global reference rules", "utf-8")
+
+    writeAgentPrompts(tmpDir, destDir)
+
+    const hierarchyContent = readFileSync(join(destDir, "hierarchy.txt"), "utf-8")
+    assert.strictEqual(hierarchyContent, "global reference rules",
+      "hierarchy.txt should be copied verbatim without header")
+
+    rmSync(tmpDir, { recursive: true })
+  })
+})

package/src/core/backup.js

@@ -1,38 +1,40 @@
-import { existsSync, copyFileSync, readdirSync, unlinkSync } from "node:fs"
-import { join, dirname } from "node:path"
-import { getConfigPath } from "./paths.js"
-
-const MAX_BACKUPS = 5
-
-function timestamp() {
-  // ponytail: simplified formatting using native Date serialization
-  const s = new Date().toISOString().replace(/[-:]/g, "")
-  return `${s.slice(0, 8)}_${s.slice(9, 15)}`
-}
-
-function rotateBackups(configPath) {
-  const dir = dirname(configPath)
-  const baseName = "opencode.jsonc.bak"
-  let backups = []
-
-  try {
-    backups = readdirSync(dir)
-      .filter((f) => f.startsWith(baseName + "."))
-      .map((f) => join(dir, f))
-      .sort()
-  } catch { /* dir doesn't exist yet */ }
-
-  while (backups.length >= MAX_BACKUPS) {
-    const oldest = backups.shift()
-    try { unlinkSync(oldest) } catch {}
-  }
-}
-
-export function backupExistingConfig(configPath) {
-  const resolvedPath = configPath || getConfigPath()
-  if (!existsSync(resolvedPath)) return
-
-  rotateBackups(resolvedPath)
-  const backupPath = `${resolvedPath}.bak.${timestamp()}`
-  copyFileSync(resolvedPath, backupPath)
-}
+import { existsSync, copyFileSync, readdirSync, unlinkSync } from "node:fs"
+import { join, dirname } from "node:path"
+import { getConfigPath } from "./paths.js"
+
+const MAX_BACKUPS = 5
+
+function timestamp() {
+  // ponytail: simplified formatting using native Date serialization
+  const s = new Date().toISOString().replace(/[-:]/g, "")
+  return `${s.slice(0, 8)}_${s.slice(9, 15)}`
+}
+
+function rotateBackups(configPath) {
+  const dir = dirname(configPath)
+  const baseName = "opencode.jsonc.bak"
+  let backups = []
+
+  try {
+    backups = readdirSync(dir)
+      .filter((f) => f.startsWith(baseName + "."))
+      .map((f) => join(dir, f))
+      .sort()
+  } catch (err) {
+    if (err.code !== "ENOENT") throw err
+  }
+
+  while (backups.length >= MAX_BACKUPS) {
+    const oldest = backups.shift()
+    try { unlinkSync(oldest) } catch {}
+  }
+}
+
+export function backupExistingConfig(configPath) {
+  const resolvedPath = configPath || getConfigPath()
+  if (!existsSync(resolvedPath)) return
+
+  rotateBackups(resolvedPath)
+  const backupPath = `${resolvedPath}.bak.${timestamp()}`
+  copyFileSync(resolvedPath, backupPath)
+}

package/src/core/configBuilder.js

@@ -1,32 +1,32 @@
-import { readFileSync } from "node:fs"
-import { resolve } from "node:path"
-
-export function buildConfig(tierChoices, templatesDir) {
-  const configPath = resolve(templatesDir, "opencode.config.json")
-  const defaultsPath = resolve(templatesDir, "model-defaults.json")
-
-  const config = JSON.parse(readFileSync(configPath, "utf-8"))
-  const modelDefaults = JSON.parse(readFileSync(defaultsPath, "utf-8"))
-
-  // Validate: every agent in model-defaults must have a key in config.agent
-  const defaultedAgents = new Set(
-    Object.values(modelDefaults).flatMap((tier) => tier.agents),
-  )
-  const missingAgents = [...defaultedAgents].filter(
-    (name) => !(name in config.agent),
-  )
-  if (missingAgents.length > 0) {
-    throw new Error(
-      `Template validation failed: agent(s) not found in opencode.config.json: ${missingAgents.join(", ")}`,
-    )
-  }
-
-  for (const [tierKey, tier] of Object.entries(modelDefaults)) {
-    const model = tierChoices[tierKey]
-    for (const agentName of tier.agents) {
-      config.agent[agentName].model = model
-    }
-  }
-
-  return config
-}
+import { readFileSync } from "node:fs"
+import { resolve } from "node:path"
+
+export function buildConfig(tierChoices, templatesDir) {
+  const configPath = resolve(templatesDir, "opencode.config.json")
+  const defaultsPath = resolve(templatesDir, "model-defaults.json")
+
+  const config = JSON.parse(readFileSync(configPath, "utf-8"))
+  const modelDefaults = JSON.parse(readFileSync(defaultsPath, "utf-8"))
+
+  // Validate: every agent in model-defaults must have a key in config.agent
+  const defaultedAgents = new Set(
+    Object.values(modelDefaults).flatMap((tier) => tier.agents),
+  )
+  const missingAgents = [...defaultedAgents].filter(
+    (name) => !(name in config.agent),
+  )
+  if (missingAgents.length > 0) {
+    throw new Error(
+      `Template validation failed: agent(s) not found in opencode.config.json: ${missingAgents.join(", ")}`,
+    )
+  }
+
+  for (const [tierKey, tier] of Object.entries(modelDefaults)) {
+    const model = tierChoices[tierKey]
+    for (const agentName of tier.agents) {
+      config.agent[agentName].model = model
+    }
+  }
+
+  return config
+}

package/src/core/configBuilder.test.js

@@ -1,47 +1,93 @@
-import { describe, it } from "node:test"
-import assert from "node:assert"
-import { mkdtempSync, writeFileSync, rmSync } from "node:fs"
-import { join } from "node:path"
-import { tmpdir } from "node:os"
-import { buildConfig } from "./configBuilder.js"
-
-describe("configBuilder", () => {
-  it("injects models into agent config per tier", () => {
-    const tmpDir = mkdtempSync(join(tmpdir(), "configbuilder-test-"))
-
-    const configJson = {
-      agent: {
-        composer: {},
-        coder: {},
-      },
-    }
-    const defaultsJson = {
-      reasoningHeavy: {
-        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")
-
-    const result = buildConfig(
-      {
-        reasoningHeavy: "test/big-model",
-        fast: "test/small-model",
-      },
-      tmpDir,
-    )
-
-    assert.strictEqual(result.agent.composer.model, "test/big-model")
-    assert.strictEqual(result.agent.coder.model, "test/small-model")
-
-    rmSync(tmpDir, { recursive: true })
-  })
-})
+import { describe, it } from "node:test"
+import assert from "node:assert"
+import { mkdtempSync, writeFileSync, rmSync } from "node:fs"
+import { join } from "node:path"
+import { tmpdir } from "node:os"
+import { buildConfig } from "./configBuilder.js"
+
+describe("configBuilder", () => {
+  it("injects models into agent config per tier", () => {
+    const tmpDir = mkdtempSync(join(tmpdir(), "configbuilder-test-"))
+
+    const configJson = {
+      agent: {
+        composer: {},
+        reviewer: {},
+        coder: {},
+      },
+    }
+    const defaultsJson = {
+      reasoning: {
+        provider: "test",
+        model: "big-model",
+        agents: ["composer"],
+      },
+      precision: {
+        provider: "test",
+        model: "mid-model",
+        agents: ["reviewer"],
+      },
+      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")
+
+    const result = buildConfig(
+      {
+        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 })
+  })
+})