@glrs-dev/harness-plugin-opencode 2.4.1 → 2.7.0

package/dist/agents/prompts/research.md

@@ -24,22 +24,13 @@ Every cognitive task is a subagent. You launch subagents and pass their outputs
 
 ## How to Invoke Research Agents
 
-The four research agents are available:
+Dispatch research subagents via the task tool:
 
-1. **`@research`** (this agent) — umbrella orchestrator for multi-workstream research
-2. **`@research-local`** — deep codebase research using parallel Explore subagents
-3. **`@research-web`** — multi-agent web research with skeleton-file pattern
-4. **`@research-auto`** — autonomous experimentation with `.lab/` directory
+- **`@research-local`** — deep codebase research using parallel Explore subagents
+- **`@research-web`** — multi-agent web research with skeleton-file pattern
+- **`@research-auto`** — autonomous experimentation with `.lab/` directory
 
-**To dispatch a research subagent:** Use the task tool with the agent name and pass the sub-question as the prompt:
-
-```
-task tool:
-agent: "research-web"
-prompt: "Research the competitive landscape for X. Focus on: {specific angle}."
-```
-
-The research agents are thin shims that load their matching bundled skill and follow it end-to-end. Trust the brief — the task-tool arguments ARE the research query.
+Each is a thin shim that loads its matching bundled skill. The task-tool arguments ARE the research query.
 
 ## 7-Phase Flow
 

package/dist/agents/prompts/scoper.md

@@ -73,7 +73,12 @@ After the user approves the summary, use Serena MCP tools and file-reading tools
 Resolve the plan directory:
 
 ```bash
-PLAN_DIR="$(the inline bash snippet below (git rev-parse --git-common-dir))"
+PLAN_BASE="${GLORIOUS_PLAN_DIR:-$HOME/.glorious/opencode}"
+GIT_COMMON="$(git rev-parse --git-common-dir)"
+[[ "$GIT_COMMON" != /* ]] && GIT_COMMON="$PWD/$GIT_COMMON"
+REPO_FOLDER="$(basename "$(dirname "$GIT_COMMON")")"
+PLAN_DIR="$PLAN_BASE/$REPO_FOLDER/plans"
+mkdir -p "$PLAN_DIR"
 ```
 
 Write `$PLAN_DIR/<slug>/scope.md` (create the slug directory if needed). Use this structure:
@@ -122,7 +127,7 @@ If you have been asked 8 questions and the wizard sends: "You have asked enough
 - **Always present a scope summary for user approval before writing scope.md.** Never skip the approval gate.
 - **Do NOT call the `question` tool.** Emit questions as plain assistant text per the strict contract.
 - Every response is EXACTLY a question (≤200 chars, ends with `?`), a scope summary (starts with `SCOPE_SUMMARY:`), or the SCOPE_COMPLETE sentinel. Nothing else.
-- Write scope.md to the plan directory resolved via `the inline bash snippet below (git rev-parse --git-common-dir)`. Do not write to any other path.
+- Write scope.md to the plan directory resolved via the bash snippet in Phase 4. Do not write to any other path.
 - The `SCOPE_COMPLETE:` sentinel must be the entire content of your response, with the absolute path.
 - Do not begin implementation. Do not write code. Do not modify any file except scope.md.
 

package/dist/autopilot/strategies/default.md

@@ -0,0 +1,29 @@
+You are generating a YAML spec file from a markdown plan phase, enriched with codebase context.
+
+Read the markdown plan content below and write `${specPath}` (relative to the plan directory: ${planDir}) using the write/edit tool.
+
+The output file should follow this schema:
+
+${schemaExample}
+
+For each acceptance-criteria item in the plan:
+1. Extract `id`, `intent`, `files`, `tests`, `verify` from the markdown.
+2. Set `checked: false` for all items.
+3. Add enrichment fields by reading the actual codebase:
+   - **mirror**: Find the most similar existing file in the codebase and set `mirror: <path>`. This is the pattern-match target the executor will follow.
+   - **context**: For each file being MODIFIED (not NEW), read the relevant function/section and add 10-20 lines of the current code. For NEW files, add the key function signatures the file should export.
+   - **conventions**: List project-specific patterns: import style (named vs default), export pattern, test framework (vitest/jest/bun:test), naming conventions, error handling pattern.
+
+Rules:
+- Read actual files from the codebase to get accurate code pointers. Do not hallucinate file contents.
+- Be concise — 10-20 lines of context per file, not the whole file.
+- Only add enrichment fields you can verify from the codebase.
+
+Here is the plan file to convert:
+
+### {{file}}
+```markdown
+{{content}}
+```
+
+Write the file `${planDir}/${specPath}` using the write/edit tool, then respond with "SPEC_COMPLETE" when done.

package/dist/cli-exports.d.ts

@@ -0,0 +1,49 @@
+import * as cmd_ts_dist_cjs_runner_js from 'cmd-ts/dist/cjs/runner.js';
+import * as cmd_ts_dist_cjs_helpdoc_js from 'cmd-ts/dist/cjs/helpdoc.js';
+import * as cmd_ts_dist_cjs_argparser_js from 'cmd-ts/dist/cjs/argparser.js';
+
+interface InstallOptions {
+    dryRun?: boolean;
+    pin?: boolean;
+    nonInteractive?: boolean;
+}
+declare function install(opts?: InstallOptions): Promise<void>;
+
+/**
+ * `bunx @glrs-dev/harness-plugin-opencode uninstall`
+ *
+ * Removes "@glrs-dev/harness-plugin-opencode" from the user's opencode.json plugin
+ * array. Writes a .bak backup before mutation. Does NOT touch skills (they
+ * live in node_modules, removed by `bun remove`). Does NOT touch ~/.claude/.
+ */
+interface UninstallOptions {
+    dryRun?: boolean;
+}
+declare function uninstall(opts?: UninstallOptions): void;
+
+/**
+ * `bunx @glrs-dev/harness-plugin-opencode doctor`
+ *
+ * Checks the installation health and reports per-check green/yellow/red.
+ */
+declare function doctor(): void;
+
+/**
+ * `glrs oc configure` — Interactive configuration editor.
+ *
+ * Shows the current opencode.json config as a navigable menu.
+ * The user selects a setting to change, picks from available options
+ * (no free-text for model selection), and saves.
+ *
+ * Unlike `install`, this command:
+ *   - Never re-prompts for settings you don't want to change
+ *   - Shows model choices from the Models.dev API (not free-text)
+ *   - Supports changing a single tier without touching others
+ */
+declare const configureCmd: Partial<cmd_ts_dist_cjs_argparser_js.Register> & {
+    parse(context: cmd_ts_dist_cjs_argparser_js.ParseContext): Promise<cmd_ts_dist_cjs_argparser_js.ParsingResult<{}>>;
+} & cmd_ts_dist_cjs_helpdoc_js.PrintHelp & cmd_ts_dist_cjs_helpdoc_js.ProvidesHelp & cmd_ts_dist_cjs_helpdoc_js.Named & Partial<cmd_ts_dist_cjs_helpdoc_js.Versioned> & cmd_ts_dist_cjs_argparser_js.Register & cmd_ts_dist_cjs_runner_js.Handling<{}, Promise<void>> & {
+    run(context: cmd_ts_dist_cjs_argparser_js.ParseContext): Promise<cmd_ts_dist_cjs_argparser_js.ParsingResult<Promise<void>>>;
+} & Partial<cmd_ts_dist_cjs_helpdoc_js.Versioned & cmd_ts_dist_cjs_helpdoc_js.Descriptive & cmd_ts_dist_cjs_helpdoc_js.Aliased>;
+
+export { type InstallOptions, type UninstallOptions, configureCmd, doctor, install, uninstall };

package/dist/{cli.js → cli-exports.js}

@@ -1,4 +1,3 @@
-#!/usr/bin/env bun
 import {
   getOpenCodeCachePackageDir,
   inspectCachePin,
@@ -11,16 +10,6 @@ import {
   promptMulti
 } from "./chunk-GILWWWMB.js";
 
-// src/cli.ts
-import {
-  binary,
-  command as command2,
-  flag,
-  positional,
-  subcommands,
-  run
-} from "cmd-ts";
-
 // src/cli/install.ts
 import * as fs2 from "fs";
 import * as path2 from "path";
@@ -977,17 +966,17 @@ function getOpencodeConfigPath2() {
 function uninstall(opts = {}) {
   const { dryRun = false } = opts;
   const configPath = getOpencodeConfigPath2();
-  const c4 = {
+  const c3 = {
     reset: "\x1B[0m",
     green: "\x1B[32m",
     yellow: "\x1B[33m",
     blue: "\x1B[34m"
   };
-  const ok3 = (msg) => console.log(`${c4.green}\u2713${c4.reset} ${msg}`);
-  const info3 = (msg) => console.log(`${c4.blue}\u2022${c4.reset} ${msg}`);
-  const warn2 = (msg) => console.log(`${c4.yellow}!${c4.reset} ${msg}`);
+  const ok3 = (msg) => console.log(`${c3.green}\u2713${c3.reset} ${msg}`);
+  const info3 = (msg) => console.log(`${c3.blue}\u2022${c3.reset} ${msg}`);
+  const warn2 = (msg) => console.log(`${c3.yellow}!${c3.reset} ${msg}`);
   console.log(`
-${c4.blue}Uninstalling ${PLUGIN_NAME2}${c4.reset}
+${c3.blue}Uninstalling ${PLUGIN_NAME2}${c3.reset}
 `);
   if (!fs3.existsSync(configPath)) {
     warn2(`No opencode.json found at ${configPath} \u2014 nothing to do`);
@@ -1057,9 +1046,9 @@ function getOpencodeConfigPath3() {
   const configHome = process.env["XDG_CONFIG_HOME"] ?? path4.join(os3.homedir(), ".config");
   return path4.join(configHome, "opencode", "opencode.json");
 }
-function cmd(command3) {
+function cmd(command2) {
   try {
-    return execSync(command3, { encoding: "utf8", stdio: ["pipe", "pipe", "pipe"] }).trim();
+    return execSync(command2, { encoding: "utf8", stdio: ["pipe", "pipe", "pipe"] }).trim();
   } catch {
     return null;
   }
@@ -1068,18 +1057,18 @@ function which(bin) {
   return cmd(`which ${bin}`) !== null;
 }
 function doctor() {
-  const c4 = {
+  const c3 = {
     reset: "\x1B[0m",
     green: "\x1B[32m",
     yellow: "\x1B[33m",
     red: "\x1B[31m",
     bold: "\x1B[1m"
   };
-  const ok3 = (msg) => console.log(`${c4.green}\u2713${c4.reset} ${msg}`);
-  const warn2 = (msg) => console.log(`${c4.yellow}!${c4.reset} ${msg}`);
-  const fail = (msg) => console.log(`${c4.red}\u2717${c4.reset} ${msg}`);
+  const ok3 = (msg) => console.log(`${c3.green}\u2713${c3.reset} ${msg}`);
+  const warn2 = (msg) => console.log(`${c3.yellow}!${c3.reset} ${msg}`);
+  const fail = (msg) => console.log(`${c3.red}\u2717${c3.reset} ${msg}`);
   console.log(`
-${c4.bold}Doctor \u2014 ${PLUGIN_NAME3}${c4.reset}
+${c3.bold}Doctor \u2014 ${PLUGIN_NAME3}${c3.reset}
 `);
   const ocVersion = cmd("opencode --version 2>/dev/null | head -1");
   if (ocVersion) {
@@ -1150,15 +1139,15 @@ ${c4.bold}Doctor \u2014 ${PLUGIN_NAME3}${c4.reset}
           for (const entry of invalid) {
             fail(`invalid model override at ${entry.keyPath}: "${entry.value}"`);
             if (entry.reason) {
-              console.log(`    ${c4.yellow}reason:${c4.reset} ${entry.reason}`);
+              console.log(`    ${c3.yellow}reason:${c3.reset} ${entry.reason}`);
             }
             if (entry.suggestion) {
               console.log(
-                `    ${c4.yellow}fix:${c4.reset}    remove this key, or replace with \`${entry.suggestion}\``
+                `    ${c3.yellow}fix:${c3.reset}    remove this key, or replace with \`${entry.suggestion}\``
               );
             } else {
               console.log(
-                `    ${c4.yellow}fix:${c4.reset}    remove this key, or run \`bunx ${PLUGIN_NAME3} install\` to pick a current preset`
+                `    ${c3.yellow}fix:${c3.reset}    remove this key, or run \`bunx ${PLUGIN_NAME3} install\` to pick a current preset`
               );
             }
           }
@@ -1384,7 +1373,7 @@ var configureCmd = command({
     const configPath = getOpencodeConfigPath4();
     const config = readConfig(configPath);
     if (!config) {
-      console.log(`No config found at ${configPath}. Run ${c2.green}glrs oc install${c2.reset} first.`);
+      console.log(`No config found at ${configPath}. Run ${c2.green}glrs harness install${c2.reset} first.`);
       process.exit(1);
     }
     const opts = extractPluginOptions2(config);
@@ -1447,259 +1436,9 @@ ${c2.bold}Done.${c2.reset} Restart opencode to pick up changes.
     }
   }
 });
-
-// src/cli/cli-update.ts
-import * as fs6 from "fs";
-import * as path6 from "path";
-import * as os5 from "os";
-import { spawn } from "child_process";
-import { fileURLToPath as fileURLToPath2 } from "url";
-var PACKAGE_NAME = "@glrs-dev/harness-plugin-opencode";
-var CHECK_INTERVAL_MS = 24 * 60 * 60 * 1e3;
-var c3 = {
-  reset: "\x1B[0m",
-  green: "\x1B[32m",
-  yellow: "\x1B[33m",
-  blue: "\x1B[34m",
-  dim: "\x1B[2m",
-  bold: "\x1B[1m"
+export {
+  configureCmd,
+  doctor,
+  install,
+  uninstall
 };
-function parseSemver(v) {
-  const m = /^(\d+)\.(\d+)\.(\d+)/.exec(v);
-  if (!m) return null;
-  return { major: +m[1], minor: +m[2], patch: +m[3] };
-}
-function isNewer(current, latest) {
-  if (latest.major !== current.major) return latest.major > current.major;
-  if (latest.minor !== current.minor) return latest.minor > current.minor;
-  return latest.patch > current.patch;
-}
-function isMajorBump(current, latest) {
-  return latest.major > current.major;
-}
-function getStateFilePath() {
-  const cacheHome = process.env["XDG_CACHE_HOME"] ?? path6.join(os5.homedir(), ".cache");
-  return path6.join(cacheHome, "harness-opencode", "cli-update.json");
-}
-function readState() {
-  try {
-    const raw = fs6.readFileSync(getStateFilePath(), "utf8");
-    return JSON.parse(raw);
-  } catch {
-    return null;
-  }
-}
-function writeState(state) {
-  try {
-    const statePath = getStateFilePath();
-    fs6.mkdirSync(path6.dirname(statePath), { recursive: true });
-    fs6.writeFileSync(statePath, JSON.stringify(state));
-  } catch {
-  }
-}
-function readInstalledVersion() {
-  const here = path6.dirname(fileURLToPath2(import.meta.url));
-  const candidates = [
-    path6.join(here, "..", "package.json"),
-    path6.join(here, "..", "..", "package.json"),
-    path6.join(here, "package.json")
-  ];
-  for (const candidate of candidates) {
-    try {
-      const raw = fs6.readFileSync(candidate, "utf8");
-      const parsed = JSON.parse(raw);
-      if (parsed.name === PACKAGE_NAME && typeof parsed.version === "string") {
-        return parsed.version;
-      }
-    } catch {
-    }
-  }
-  return "0.0.0";
-}
-async function fetchLatestVersion() {
-  try {
-    const controller = new AbortController();
-    const timer = setTimeout(() => controller.abort(), 3e3);
-    const res = await fetch(
-      `https://registry.npmjs.org/${PACKAGE_NAME}/latest`,
-      { signal: controller.signal }
-    );
-    clearTimeout(timer);
-    if (!res.ok) return null;
-    const data = await res.json();
-    return data.version ?? null;
-  } catch {
-    return null;
-  }
-}
-function spawnBackgroundUpdate() {
-  try {
-    const child = spawn("bun", ["update", "-g", PACKAGE_NAME], {
-      detached: true,
-      stdio: "ignore"
-    });
-    child.unref();
-  } catch {
-  }
-}
-function startUpdateCheck() {
-  if (process.env["HARNESS_OPENCODE_UPDATE_CHECK"] === "0") {
-    return () => {
-    };
-  }
-  const currentVersionStr = readInstalledVersion();
-  const current = parseSemver(currentVersionStr);
-  if (!current) return () => {
-  };
-  const state = readState();
-  if (state && Date.now() - state.last_check_ts < CHECK_INTERVAL_MS) {
-    if (state.latest_version) {
-      const cached = parseSemver(state.latest_version);
-      if (cached && isNewer(current, cached) && isMajorBump(current, cached)) {
-        return () => printMajorNotice(currentVersionStr, state.latest_version);
-      }
-    }
-    return () => {
-    };
-  }
-  let action = null;
-  fetchLatestVersion().then((latestStr) => {
-    writeState({
-      last_check_ts: Date.now(),
-      latest_version: latestStr ?? void 0
-    });
-    if (!latestStr) return;
-    const latest = parseSemver(latestStr);
-    if (!latest || !isNewer(current, latest)) return;
-    if (isMajorBump(current, latest)) {
-      action = () => printMajorNotice(currentVersionStr, latestStr);
-    } else {
-      action = () => {
-        process.stderr.write(
-          `
-${c3.blue}\u2022${c3.reset} Updating ${PACKAGE_NAME} ${c3.dim}${currentVersionStr}${c3.reset} \u2192 ${c3.green}${latestStr}${c3.reset} in the background...
-`
-        );
-        spawnBackgroundUpdate();
-      };
-    }
-  }).catch(() => {
-  });
-  return () => {
-    if (action) action();
-  };
-}
-function printMajorNotice(current, latest) {
-  process.stderr.write(
-    `
-${c3.yellow}${c3.bold}Major update available:${c3.reset} ${current} \u2192 ${c3.green}${latest}${c3.reset}
-${c3.dim}Review the changelog before upgrading:${c3.reset}
-  bun update -g ${PACKAGE_NAME}
-`
-  );
-}
-
-// src/cli.ts
-{
-  const dispatched = process.env["GLRS_CLI_DISPATCHED"];
-  if (!dispatched || dispatched === "") {
-    const argv1 = process.argv[1] ?? "harness-opencode";
-    const invoke = argv1.replace(/\\/g, "/").split("/").pop() ?? "harness-opencode";
-    process.stderr.write(`[${invoke}] This binary is deprecated when invoked standalone.
-`);
-    process.stderr.write(`[${invoke}] Install @glrs-dev/cli and use 'glrs oc' instead:
-`);
-    process.stderr.write(`[${invoke}]   npm i -g @glrs-dev/cli
-`);
-    process.stderr.write(`[${invoke}]   glrs oc <args>
-`);
-    process.stderr.write(`[${invoke}] Docs: https://glrs.dev/install
-`);
-    process.exit(1);
-  }
-}
-if (!process.versions.bun) {
-  const [majorStr = "0", minorStr = "0"] = (process.versions.node ?? "0.0").split(".");
-  const major = Number(majorStr);
-  const minor = Number(minorStr);
-  if (major < 20 || major === 20 && minor < 10) {
-    process.stderr.write(
-      `harness-opencode requires Node.js >= 20.10 (you are on ${process.versions.node}).
-Upgrade Node or run via a compatible Bun runtime. See the "engines" field in package.json.
-`
-    );
-    process.exit(1);
-  }
-}
-var VERSION = "0.1.0";
-var installCmd = command2({
-  name: "install",
-  description: 'Add "@glrs-dev/harness-plugin-opencode" to your opencode.json plugin array.',
-  args: {
-    dryRun: flag({
-      long: "dry-run",
-      description: "Preview changes without writing."
-    }),
-    pin: flag({
-      long: "pin",
-      description: "Pin to the current exact version (e.g. @0.1.0)."
-    })
-  },
-  handler: async ({ dryRun, pin }) => {
-    await install({ dryRun, pin });
-  }
-});
-var uninstallCmd = command2({
-  name: "uninstall",
-  description: 'Remove "@glrs-dev/harness-plugin-opencode" from your opencode.json plugin array.',
-  args: {
-    dryRun: flag({
-      long: "dry-run",
-      description: "Preview changes without writing."
-    })
-  },
-  handler: ({ dryRun }) => {
-    uninstall({ dryRun });
-  }
-});
-var doctorCmd = command2({
-  name: "doctor",
-  description: "Check installation health (OpenCode CLI, plugin registration, MCP backends).",
-  args: {},
-  handler: () => {
-    doctor();
-  }
-});
-var installPluginCmd = command2({
-  name: "install-plugin",
-  description: 'Add "@glrs-dev/harness-plugin-opencode" to your opencode.json plugin array.',
-  args: {
-    dryRun: flag({
-      long: "dry-run",
-      description: "Preview changes without writing."
-    }),
-    pin: flag({
-      long: "pin",
-      description: "Pin to the current exact version (e.g. @0.1.0)."
-    })
-  },
-  handler: async ({ dryRun, pin }) => {
-    await install({ dryRun, pin });
-  }
-});
-var cli = subcommands({
-  name: "glrs-oc",
-  description: "OpenCode agent harness CLI.",
-  version: VERSION,
-  cmds: {
-    "install-plugin": installPluginCmd,
-    install: installCmd,
-    uninstall: uninstallCmd,
-    configure: configureCmd,
-    doctor: doctorCmd
-    // Note: `loop` and `autopilot` commands have moved to @glrs-dev/cli.
-  }
-});
-var printUpdate = startUpdateCheck();
-process.on("exit", printUpdate);
-void run(binary(cli), process.argv);