pluidr 0.7.1 → 0.7.2

package/package.json

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

package/src/cli/commands/doctor.js

@@ -1,11 +1,18 @@
 import { existsSync, readFileSync, readdirSync } from "node:fs"
 import { join } from "node:path"
-import { getConfigDir, getConfigPath, getPromptsDir } from "../../core/paths.js"
+import { getConfigDir, getConfigPath, getPromptsDir, getThemesDir } from "../../core/paths.js"
 import { findSqueezePath } from "../../core/squeezeInstaller.js"
 
 const EXPECTED_PROMPT_COUNT = 18
 const PLUGIN_FILES = ["pluidr-flow.js", "pluidr-squeeze.js"]
 
+export function cleanJsonc(content) {
+  return content.replace(
+    /\\"|"(?:\\"|[^"])*"|(\/\/.*|\/\*[\s\S]*?\*\/)|(,\s*(?=[\]}]))/g,
+    (m, g1, g2) => g1 ? "" : g2 ? "" : m
+  )
+}
+
 export function collectChecks() {
   const configDir = getConfigDir()
   const configPath = getConfigPath()
@@ -13,6 +20,7 @@ export function collectChecks() {
   const pluginsDir = join(configDir, "plugins")
   const packageJsonPath = join(configDir, "package.json")
   const binDir = join(configDir, "bin")
+  const themesDir = getThemesDir()
 
   const checks = []
 
@@ -39,6 +47,10 @@ export function collectChecks() {
   }
   checks.push({ component: "plugin files", pass: pluginsFound === PLUGIN_FILES.length, detail: `${pluginsFound}/${PLUGIN_FILES.length}` })
 
+  // 3b. Custom theme exists
+  const themeExists = existsSync(join(themesDir, "pluidr-contrast.json"))
+  checks.push({ component: "pluidr-contrast theme file", pass: themeExists })
+
   // 4. package.json with @opencode-ai/plugin dependency
   let pkgValid = false
   if (existsSync(packageJsonPath)) {
@@ -67,7 +79,7 @@ export function collectChecks() {
   if (configExists) {
     try {
       const content = readFileSync(configPath, "utf-8")
-      const cleaned = content.replace(/\\"|"(?:\\"|[^"])*"|(\/\/.*|\/\*[\s\S]*?\*\/)/g, (m, g) => g ? "" : m)
+      const cleaned = cleanJsonc(content)
       JSON.parse(cleaned)
       configValid = true
     } catch {

package/src/cli/commands/init.js

@@ -1,4 +1,4 @@
-import { readFileSync } from "node:fs"
+import { readFileSync, writeFileSync } from "node:fs"
 import { resolve, dirname } from "node:path"
 import { fileURLToPath } from "node:url"
 import { confirm, isCancel } from "@clack/prompts"
@@ -8,8 +8,10 @@ import { buildConfig } from "../../core/configBuilder.js"
 import { writeConfig } from "../../core/configWriter.js"
 import { writeAgentPrompts } from "../../core/agentPromptWriter.js"
 import { writePluginBundle, writePluginPackageJson } from "../../core/pluginWriter.js"
+import { writeThemes } from "../../core/themeWriter.js"
+import { writeTuiConfig } from "../../core/tuiConfigWriter.js"
 import { installSqueeze } from "../../core/squeezeInstaller.js"
-import { getConfigPath } from "../../core/paths.js"
+import { getConfigPath, getConfigDir } from "../../core/paths.js"
 
 const __dirname = dirname(fileURLToPath(import.meta.url))
 const TEMPLATES_DIR = resolve(__dirname, "../../templates")
@@ -32,6 +34,8 @@ export async function runInit() {
   const configObject = buildConfig(tierChoices, TEMPLATES_DIR)
   writeConfig(configObject)
   writeAgentPrompts(TEMPLATES_DIR)
+  writeThemes(TEMPLATES_DIR)
+  writeTuiConfig("pluidr-contrast")
   writePluginBundle()
   writePluginPackageJson()
   if (installSqueezePlugin) {

package/src/cli/commands/launch.js

@@ -31,7 +31,7 @@ export async function runLaunch() {
   }
 
   // 3. Launch opencode
-  console.log("Launching opencode...")
+  console.log("Launching pluidr...")
   const child = process.platform === "win32"
     ? spawn("opencode", { stdio: "inherit", shell: true })
     : spawn("opencode", [], { stdio: "inherit" })

package/src/cli/commands/uninstall.js

@@ -16,6 +16,20 @@ function findLatestBackup() {
   return backups.length > 0 ? join(dir, backups[0]) : null
 }
 
+function findLatestTuiBackup() {
+  const dir = getConfigDir()
+  let backups = []
+  try {
+    backups = readdirSync(dir)
+      .filter((f) => f.startsWith("tui.json.bak."))
+      .sort()
+      .reverse()
+  } catch {
+    return null
+  }
+  return backups.length > 0 ? join(dir, backups[0]) : null
+}
+
 export async function runUninstall() {
   const configDir = getConfigDir()
   const configPath = getConfigPath()
@@ -32,6 +46,14 @@ export async function runUninstall() {
     summary.restored = latestBackup
   }
 
+  const latestTuiBackup = findLatestTuiBackup()
+  const tuiConfigPath = join(configDir, "tui.json")
+  if (latestTuiBackup) {
+    copyFileSync(latestTuiBackup, tuiConfigPath)
+  }
+
+  const themesDir = join(configDir, "themes")
+
   // Remove Pluidr-installed artifacts
   if (existsSync(promptsDir)) {
     rmSync(promptsDir, { recursive: true, force: true })
@@ -45,6 +67,11 @@ export async function runUninstall() {
     rmSync(binDir, { recursive: true, force: true })
     summary.removed.push("bin/")
   }
+  const customThemePath = join(themesDir, "pluidr-contrast.json")
+  if (existsSync(customThemePath)) {
+    rmSync(customThemePath, { force: true })
+    summary.removed.push("themes/pluidr-contrast.json")
+  }
 
   // Print summary
   console.log("Uninstall complete:")

package/src/core/backup.js

@@ -1,6 +1,6 @@
 import { existsSync, copyFileSync, readdirSync, unlinkSync } from "node:fs"
 import { join, dirname } from "node:path"
-import { getConfigPath } from "./paths.js"
+import { getConfigPath, getTuiConfigPath } from "./paths.js"
 
 const MAX_BACKUPS = 5
 
@@ -32,9 +32,15 @@ function rotateBackups(configPath) {
 
 export function backupExistingConfig(configPath) {
   const resolvedPath = configPath || getConfigPath()
-  if (!existsSync(resolvedPath)) return
+  if (existsSync(resolvedPath)) {
+    rotateBackups(resolvedPath)
+    const backupPath = `${resolvedPath}.bak.${timestamp()}`
+    copyFileSync(resolvedPath, backupPath)
+  }
 
-  rotateBackups(resolvedPath)
-  const backupPath = `${resolvedPath}.bak.${timestamp()}`
-  copyFileSync(resolvedPath, backupPath)
+  const tuiPath = getTuiConfigPath()
+  if (existsSync(tuiPath)) {
+    const backupTuiPath = `${tuiPath}.bak.${timestamp()}`
+    copyFileSync(tuiPath, backupTuiPath)
+  }
 }

package/src/core/paths.js

@@ -5,5 +5,7 @@ const BASE = join(homedir(), ".config", "opencode")
 
 export const getConfigDir = () => BASE
 export const getConfigPath = () => join(BASE, "opencode.jsonc")
+export const getTuiConfigPath = () => join(BASE, "tui.json")
 export const getPromptsDir = () => join(BASE, "prompts")
+export const getThemesDir = () => join(BASE, "themes")
 // ponytail: getBackupPath removed (YAGNI)

package/src/core/paths.test.js

@@ -2,7 +2,7 @@ import { describe, it } from "node:test"
 import assert from "node:assert"
 import { homedir } from "node:os"
 import { join } from "node:path"
-import { getConfigDir, getConfigPath, getPromptsDir } from "./paths.js"
+import { getConfigDir, getConfigPath, getTuiConfigPath, getPromptsDir, getThemesDir } from "./paths.js"
 
 const BASE = join(homedir(), ".config", "opencode")
 
@@ -15,7 +15,15 @@ describe("paths", () => {
     assert.strictEqual(getConfigPath(), join(BASE, "opencode.jsonc"))
   })
 
+  it("getTuiConfigPath returns tui.json path", () => {
+    assert.strictEqual(getTuiConfigPath(), join(BASE, "tui.json"))
+  })
+
   it("getPromptsDir returns prompts path", () => {
     assert.strictEqual(getPromptsDir(), join(BASE, "prompts"))
   })
+
+  it("getThemesDir returns themes path", () => {
+    assert.strictEqual(getThemesDir(), join(BASE, "themes"))
+  })
 })

package/src/core/squeezeInstaller.js

@@ -26,7 +26,7 @@ export function platformAsset() {
 }
 
 export function validatePath(path) {
-  if (!/^[a-zA-Z0-9_\-\.\:\/\\]+$/.test(path)) {
+  if (!/^[a-zA-Z0-9_\-\.\:\/\\ ]+$/.test(path)) {
     throw new Error(`Invalid path: "${path}" contains unsafe characters`)
   }
 }
@@ -53,10 +53,7 @@ function extract(archivePath, destDir) {
     execFileSync("powershell", [
       "-NoProfile",
       "-Command",
-      "Expand-Archive",
-      "-LiteralPath", archivePath,
-      "-DestinationPath", destDir,
-      "-Force"
+      `Expand-Archive -LiteralPath '${archivePath}' -DestinationPath '${destDir}' -Force`
     ], { stdio: "ignore" })
   } else {
     execFileSync("tar", ["-xzf", archivePath, "-C", destDir], { stdio: "ignore" })

package/src/core/squeezeInstaller.test.js

@@ -41,6 +41,10 @@ describe("validatePath", () => {
     assert.doesNotThrow(() => validatePath("C:\\Users\\test"))
   })
 
+  it("accepts paths with spaces", () => {
+    assert.doesNotThrow(() => validatePath("C:\\Users\\John Doe\\.config"))
+  })
+
   it("accepts paths with dots and dashes", () => {
     assert.doesNotThrow(() => validatePath("./dir/file-name.ext"))
   })

package/src/core/themeWriter.js

@@ -0,0 +1,12 @@
+import { mkdirSync, copyFileSync } from "node:fs"
+import { resolve } from "node:path"
+import { getThemesDir } from "./paths.js"
+
+export function writeThemes(templatesDir, destDir) {
+  const sourcePath = resolve(templatesDir, "themes", "pluidr-contrast.json")
+  const targetDir = destDir || getThemesDir()
+  const destPath = resolve(targetDir, "pluidr-contrast.json")
+
+  mkdirSync(targetDir, { recursive: true })
+  copyFileSync(sourcePath, destPath)
+}

package/src/core/themeWriter.test.js

@@ -0,0 +1,29 @@
+import { describe, it, after } from "node:test"
+import assert from "node:assert"
+import { existsSync, mkdtempSync, readFileSync, rmSync, mkdirSync, writeFileSync } from "node:fs"
+import { join } from "node:path"
+import { tmpdir } from "node:os"
+import { writeThemes } from "./themeWriter.js"
+
+describe("themeWriter", () => {
+  const destDir = mkdtempSync(join(tmpdir(), "pluidr-theme-dest-"))
+
+  after(() => {
+    if (existsSync(destDir)) rmSync(destDir, { recursive: true })
+  })
+
+  it("copies theme file to destination directory", () => {
+    const tmpSrcDir = mkdtempSync(join(tmpdir(), "pluidr-theme-src-"))
+    const srcThemesDir = join(tmpSrcDir, "themes")
+    mkdirSync(srcThemesDir, { recursive: true })
+    writeFileSync(join(srcThemesDir, "pluidr-contrast.json"), "mock-theme-content", "utf-8")
+
+    writeThemes(tmpSrcDir, destDir)
+
+    const destPath = join(destDir, "pluidr-contrast.json")
+    assert.ok(existsSync(destPath), "theme file should be copied")
+    assert.strictEqual(readFileSync(destPath, "utf-8"), "mock-theme-content")
+
+    rmSync(tmpSrcDir, { recursive: true })
+  })
+})

package/src/core/tuiConfigWriter.js

@@ -0,0 +1,22 @@
+import { readFileSync, writeFileSync, existsSync } from "node:fs"
+import { getTuiConfigPath } from "./paths.js"
+
+export function writeTuiConfig(themeName, customPath) {
+  const path = customPath || getTuiConfigPath()
+  let config = {
+    "$schema": "https://opencode.ai/tui.json"
+  }
+
+  if (existsSync(path)) {
+    try {
+      const content = readFileSync(path, "utf-8")
+      config = JSON.parse(content)
+    } catch {
+      // If parsing fails, fall back to default structure
+    }
+  }
+
+  config.theme = themeName
+
+  writeFileSync(path, JSON.stringify(config, null, 2), "utf-8")
+}

package/src/core/tuiConfigWriter.test.js

@@ -0,0 +1,38 @@
+import { describe, it, after } from "node:test"
+import assert from "node:assert"
+import { existsSync, mkdtempSync, readFileSync, rmSync, writeFileSync } from "node:fs"
+import { join } from "node:path"
+import { tmpdir } from "node:os"
+import { writeTuiConfig } from "./tuiConfigWriter.js"
+
+describe("tuiConfigWriter", () => {
+  const destDir = mkdtempSync(join(tmpdir(), "pluidr-tui-dest-"))
+  const tuiPath = join(destDir, "tui.json")
+
+  after(() => {
+    if (existsSync(destDir)) rmSync(destDir, { recursive: true })
+  })
+
+  it("writes new tui.json with theme name if it does not exist", () => {
+    writeTuiConfig("pluidr-contrast", tuiPath)
+
+    assert.ok(existsSync(tuiPath))
+    const parsed = JSON.parse(readFileSync(tuiPath, "utf-8"))
+    assert.strictEqual(parsed.theme, "pluidr-contrast")
+    assert.strictEqual(parsed["$schema"], "https://opencode.ai/tui.json")
+  })
+
+  it("updates existing tui.json theme name while preserving other fields", () => {
+    writeFileSync(tuiPath, JSON.stringify({
+      "$schema": "https://opencode.ai/tui.json",
+      "theme": "ayu-dark",
+      "font": "monolisa"
+    }, null, 2), "utf-8")
+
+    writeTuiConfig("pluidr-contrast", tuiPath)
+
+    const parsed = JSON.parse(readFileSync(tuiPath, "utf-8"))
+    assert.strictEqual(parsed.theme, "pluidr-contrast")
+    assert.strictEqual(parsed.font, "monolisa")
+  })
+})

package/src/templates/agent-prompts/composer.txt

@@ -394,8 +394,7 @@ elsewhere. Do not accept a report that is not in `docs/reports/`.
 - **Regression Awareness** — When re-triggering coder after a FAIL, pass the
   gap list in full so coder doesn't fix one thing and break something
   already confirmed as PASS.
-- **Clarification** — If anything is ambiguous at any phase, ask the user
-  using multiple-choice options (2-4 short choices per question).
+- **Clarification** — If anything is ambiguous at any phase, avoid excessive questioning. For minor details, make a reasonable, safe engineering assumption based on existing codebase conventions and document it. Only prompt the user using multiple-choice options (2-3 short choices per question, and list your recommended option first prefixed with '(Recommended)') if there is a critical blocking issue that directly impacts the design direction or has high regression risk.
 - **Front-End / UI Mockups** — If the user asks for a design, mockup, or anything related to the Front-End (FE), you must provide a detailed ASCII mockup of the UI structure in your output.
 
 ---

package/src/templates/agent-prompts/debugger.txt

@@ -132,6 +132,7 @@ just a technical restriction.
 - **Separation of Investigation/Fix/Report** — Do not mix investigation,
   implementation, and reporting in the same delegate call. Each subagent
   has one job; the Debugger orchestrates the sequence.
+- **Avoid Excessive Questioning** — Avoid excessive querying of the user for minor ambiguities. For small implementation details, make a reasonable, safe engineering assumption based on existing codebase conventions and proceed. Only prompt the user using multiple-choice options (2-3 short choices per question, and list your recommended option first prefixed with '(Recommended)') when a critical blocking issue directly prevents a safe diagnosis or fix.
 
 ## What you do NOT do
 

package/src/templates/agent-prompts/prober.txt

@@ -85,6 +85,10 @@ Do NOT remain in a completed state without offering next steps.
 - You do not patch without a GUARDRAIL GATE user confirmation after TRACE.
 - You do not loop more than 5 times on AUDIT before surfacing to the user.
 
+## Principles you apply
+
+- **Avoid Excessive Questioning** — Avoid excessive querying of the user for minor ambiguities. For small implementation details, make a reasonable, safe engineering assumption based on existing codebase conventions and proceed. Only prompt the user using the `question` tool with multiple-choice options (2-3 short choices per question, and list your recommended option first prefixed with '(Recommended)') for critical blocking decisions (such as the Guardrail Gate or a complete audit block).
+
 ## Conflict Resolution
 Refer to `hierarchy.txt` (loaded globally) — you do not resolve principle
 conflicts by your own judgment outside that hierarchy.

package/src/templates/opencode.config.json

@@ -1,5 +1,6 @@
 {
   "$schema": "https://opencode.ai/config.json",
+  "theme": "pluidr-contrast",
   "instructions": ["{file:./prompts/hierarchy.txt}"],
   "permission": {
     "read": {

package/src/templates/themes/pluidr-contrast.json

@@ -0,0 +1,177 @@
+{
+  "$schema": "https://opencode.ai/theme.json",
+  "theme": {
+    "primary": {
+      "dark": "#ff7039",
+      "light": "#ff7039"
+    },
+    "secondary": {
+      "dark": "#99f3ff",
+      "light": "#99f3ff"
+    },
+    "accent": {
+      "dark": "#ff7039",
+      "light": "#ff7039"
+    },
+    "error": {
+      "dark": "#fc5d7c",
+      "light": "#fc5d7c"
+    },
+    "warning": {
+      "dark": "#ff669c",
+      "light": "#ff669c"
+    },
+    "success": {
+      "dark": "#00cc76",
+      "light": "#00cc76"
+    },
+    "info": {
+      "dark": "#00b4cc",
+      "light": "#00b4cc"
+    },
+    "text": {
+      "dark": "#ffffff",
+      "light": "#ffffff"
+    },
+    "textMuted": {
+      "dark": "#888888",
+      "light": "#888888"
+    },
+    "background": {
+      "dark": "#000000",
+      "light": "#000000"
+    },
+    "backgroundPanel": {
+      "dark": "#000000",
+      "light": "#000000"
+    },
+    "backgroundElement": {
+      "dark": "#000000",
+      "light": "#000000"
+    },
+    "border": {
+      "dark": "#101520",
+      "light": "#101520"
+    },
+    "borderActive": {
+      "dark": "#ff7039",
+      "light": "#ff7039"
+    },
+    "borderSubtle": {
+      "dark": "#101520",
+      "light": "#101520"
+    },
+    "diffAdded": {
+      "dark": "#00cc76",
+      "light": "#00cc76"
+    },
+    "diffRemoved": {
+      "dark": "#fc5d7c",
+      "light": "#fc5d7c"
+    },
+    "diffContext": {
+      "dark": "#888888",
+      "light": "#888888"
+    },
+    "diffAddedBg": {
+      "dark": "#1a2618",
+      "light": "#1a2618"
+    },
+    "diffRemovedBg": {
+      "dark": "#2a1a1a",
+      "light": "#2a1a1a"
+    },
+    "diffContextBg": {
+      "dark": "#000000",
+      "light": "#000000"
+    },
+    "markdownText": {
+      "dark": "#ffffff",
+      "light": "#ffffff"
+    },
+    "markdownHeading": {
+      "dark": "#ff669c",
+      "light": "#ff669c"
+    },
+    "markdownLink": {
+      "dark": "#99f3ff",
+      "light": "#99f3ff"
+    },
+    "markdownLinkText": {
+      "dark": "#ff7039",
+      "light": "#ff7039"
+    },
+    "markdownCode": {
+      "dark": "#66ffbf",
+      "light": "#66ffbf"
+    },
+    "markdownBlockQuote": {
+      "dark": "#888888",
+      "light": "#888888"
+    },
+    "markdownStrong": {
+      "dark": "#ff7039",
+      "light": "#ff7039"
+    },
+    "syntaxComment": {
+      "dark": "#888888",
+      "light": "#888888"
+    },
+    "syntaxKeyword": {
+      "dark": "#ff669c",
+      "light": "#ff669c"
+    },
+    "syntaxFunction": {
+      "dark": "#00b4cc",
+      "light": "#00b4cc"
+    },
+    "syntaxVariable": {
+      "dark": "#ffb966",
+      "light": "#ffb966"
+    },
+    "syntaxString": {
+      "dark": "#66ffbf",
+      "light": "#66ffbf"
+    },
+    "syntaxNumber": {
+      "dark": "#a000ff",
+      "light": "#a000ff"
+    },
+    "syntaxType": {
+      "dark": "#99f3ff",
+      "light": "#99f3ff"
+    },
+    "syntaxOperator": {
+      "dark": "#ff669c",
+      "light": "#ff669c"
+    },
+    "syntaxPunctuation": {
+      "dark": "#ffffff",
+      "light": "#ffffff"
+    },
+    "inputBackground": {
+      "dark": "#000000",
+      "light": "#000000"
+    },
+    "InputBorder": {
+      "dark": "#101520",
+      "light": "#101520"
+    },
+    "InputBorderActive": {
+      "dark": "#ff7039",
+      "light": "#ff7039"
+    },
+    "inputPrompt": {
+      "dark": "#ff7039",
+      "light": "#ff7039"
+    },
+    "inputCursor": {
+      "dark": "#ff7039",
+      "light": "#ff7039"
+    },
+    "inputText": {
+      "dark": "#ffffff",
+      "light": "#ffffff"
+    }
+  }
+}