@glrs-dev/harness-plugin-opencode 1.1.0 → 2.0.0

package/dist/agents/prompts/pilot-scoper.md

@@ -0,0 +1,58 @@
+---
+name: pilot-scoper
+description: "Pilot v2 scoping agent. Interviews the user to understand their goal, explores the codebase, and produces a scope.json artifact with framing and acceptance criteria."
+mode: subagent
+model: anthropic/claude-sonnet-4-6
+---
+
+You are the **pilot-scoper** — the first phase of the SPEAR autonomous execution system.
+
+Your job: have a focused conversation with the user to understand what they want to build, explore the codebase to understand the context, and produce a `scope.json` artifact that the planner can use to decompose the work.
+
+## Your output
+
+You MUST produce a `scope.json` file at the path provided in your instructions. The schema:
+
+```json
+{
+  "goal": "One sentence: what are we building?",
+  "framing": "2-4 sentences: why this matters, what problem it solves, what success looks like",
+  "acceptance_criteria": [
+    {
+      "id": "AC-001",
+      "description": "Behavioral, verifiable statement of what must be true when done",
+      "verifiable": "shell | llm | manual"
+    }
+  ],
+  "non_goals": ["What we are explicitly NOT doing"],
+  "context": "Optional: key codebase patterns, constraints, or background the planner needs"
+}
+```
+
+## Conversation approach
+
+1. **Start by asking** what the user wants to build. One open question.
+2. **Explore the codebase** to understand the current state (read files, search patterns, check tests).
+3. **Ask clarifying questions** — but only the ones that would change the acceptance criteria. Don't ask about implementation details.
+4. **Draft acceptance criteria** — behavioral statements, not file-level tasks. Each AC should be independently verifiable.
+5. **Confirm with the user** — show the draft ACs and ask if they're complete and correct.
+6. **Write scope.json** — once the user approves.
+
+## Acceptance criteria rules
+
+- Each AC describes an observable behavior, not an implementation step.
+- Good: "The dark mode toggle persists across page reloads"
+- Bad: "Add localStorage.setItem to the toggle handler"
+- Each AC should be verifiable by a shell command, an LLM review, or manual inspection.
+- Aim for 3-8 ACs. More than 8 suggests the scope is too large.
+
+## Tools
+
+You have read-only access to the codebase. Use file reads, search, and git log to understand the current state. Do NOT make any edits.
+
+## STOP protocol
+
+If the user's goal is fundamentally unclear after 3 clarifying questions, output:
+```
+STOP: Cannot produce scope — goal is too ambiguous. Please provide more context about what you want to build.
+```

package/dist/{chunk-BWERBERN.js → chunk-6CZPRUMJ.js}

@@ -181,29 +181,6 @@ import * as fs2 from "fs";
 import * as path2 from "path";
 import * as os from "os";
 import { select, checkbox, confirm } from "@inquirer/prompts";
-var PLUGIN_NAME = "@glrs-dev/harness-plugin-opencode";
-function getOpencodeConfigPath() {
-  const configHome = process.env["XDG_CONFIG_HOME"] ?? path2.join(os.homedir(), ".config");
-  return path2.join(configHome, "opencode", "opencode.json");
-}
-function isPluginInstalled() {
-  const configPath = getOpencodeConfigPath();
-  if (!fs2.existsSync(configPath)) return false;
-  try {
-    const config = JSON.parse(fs2.readFileSync(configPath, "utf8"));
-    const plugins = Array.isArray(config.plugin) ? config.plugin : [];
-    return plugins.some((p) => {
-      const name = typeof p === "string" ? p : Array.isArray(p) ? p[0] : null;
-      return name === PLUGIN_NAME || String(name ?? "").startsWith(`${PLUGIN_NAME}@`);
-    });
-  } catch {
-    return false;
-  }
-}
-async function promptYesNo(question) {
-  if (!process.stdin.isTTY) return false;
-  return confirm({ message: question, default: false });
-}
 async function promptChoice(question, choices, defaultIndex = 0) {
   if (!process.stdin.isTTY) return defaultIndex;
   const answer = await select({
@@ -234,32 +211,6 @@ async function promptMulti(question, choices) {
   });
   return new Set(answers);
 }
-async function requirePlugin() {
-  if (isPluginInstalled()) return;
-  const c2 = {
-    reset: "\x1B[0m",
-    yellow: "\x1B[33m",
-    red: "\x1B[31m"
-  };
-  console.error(
-    `${c2.yellow}!${c2.reset} The OpenCode plugin is not installed. Pilot commands need the plugin to register the pilot-builder and pilot-planner agents.`
-  );
-  if (!process.stdin.isTTY) {
-    console.error(
-      `${c2.red}\u2717${c2.reset} Non-interactive terminal. Run: glrs-oc install-plugin`
-    );
-    process.exit(1);
-  }
-  const yes = await promptYesNo("Install the plugin now?");
-  if (!yes) {
-    console.error(
-      `${c2.red}\u2717${c2.reset} Plugin required. Run: glrs-oc install-plugin`
-    );
-    process.exit(1);
-  }
-  const { install: install2 } = await import("./install-5JKWK6Z4.js");
-  await install2({ nonInteractive: true });
-}
 
 // src/cli/models-dev.ts
 var MODELS_DEV_URL = "https://models.dev/api.json";
@@ -361,7 +312,7 @@ async function fetchModelsDevProviders() {
 }
 
 // src/cli/install.ts
-var PLUGIN_NAME2 = "@glrs-dev/harness-plugin-opencode";
+var PLUGIN_NAME = "@glrs-dev/harness-plugin-opencode";
 var c = {
   reset: "\x1B[0m",
   green: "\x1B[32m",
@@ -405,7 +356,7 @@ function extractPluginOptions(config) {
   const plugins = config.plugin;
   if (!Array.isArray(plugins)) return null;
   for (const entry of plugins) {
-    if (Array.isArray(entry) && entry.length >= 2 && (entry[0] === PLUGIN_NAME2 || String(entry[0]).startsWith(`${PLUGIN_NAME2}@`))) {
+    if (Array.isArray(entry) && entry.length >= 2 && (entry[0] === PLUGIN_NAME || String(entry[0]).startsWith(`${PLUGIN_NAME}@`))) {
       return entry[1];
     }
   }
@@ -421,17 +372,17 @@ function readPackageVersion() {
     try {
       const raw = fs3.readFileSync(candidate, "utf8");
       const parsed = JSON.parse(raw);
-      if (parsed.name === PLUGIN_NAME2 && typeof parsed.version === "string") {
+      if (parsed.name === PLUGIN_NAME && typeof parsed.version === "string") {
         return parsed.version;
       }
     } catch {
     }
   }
   throw new Error(
-    `Could not locate ${PLUGIN_NAME2}'s package.json to read version`
+    `Could not locate ${PLUGIN_NAME}'s package.json to read version`
   );
 }
-function getOpencodeConfigPath2() {
+function getOpencodeConfigPath() {
   const configHome = process.env["XDG_CONFIG_HOME"] ?? path3.join(os2.homedir(), ".config");
   return path3.join(configHome, "opencode", "opencode.json");
 }
@@ -488,11 +439,11 @@ function migrateHarnessKeyToPluginOptions(configPath) {
     const plugins = Array.isArray(config.plugin) ? config.plugin : [];
     const pluginIdx = plugins.findIndex((entry) => {
       const name = typeof entry === "string" ? entry : Array.isArray(entry) ? entry[0] : null;
-      return name === PLUGIN_NAME2 || String(name ?? "").startsWith(`${PLUGIN_NAME2}@`);
+      return name === PLUGIN_NAME || String(name ?? "").startsWith(`${PLUGIN_NAME}@`);
     });
     if (pluginIdx < 0) return;
     const current = plugins[pluginIdx];
-    const existingName = typeof current === "string" ? current : Array.isArray(current) ? current[0] : PLUGIN_NAME2;
+    const existingName = typeof current === "string" ? current : Array.isArray(current) ? current[0] : PLUGIN_NAME;
     const existingOpts = Array.isArray(current) && current.length >= 2 ? current[1] : {};
     const merged = { ...config.harness, ...existingOpts };
     plugins[pluginIdx] = [existingName, merged];
@@ -533,13 +484,13 @@ function writePluginOption(configPath, subKey, value, opts) {
     }
     const pluginIdx = config.plugin.findIndex((entry) => {
       const name = typeof entry === "string" ? entry : Array.isArray(entry) ? entry[0] : null;
-      return name === PLUGIN_NAME2 || String(name ?? "").startsWith(`${PLUGIN_NAME2}@`);
+      return name === PLUGIN_NAME || String(name ?? "").startsWith(`${PLUGIN_NAME}@`);
     });
     if (pluginIdx < 0) {
       return { changed: false };
     }
     const current = config.plugin[pluginIdx];
-    const existingName = typeof current === "string" ? current : Array.isArray(current) ? current[0] : PLUGIN_NAME2;
+    const existingName = typeof current === "string" ? current : Array.isArray(current) ? current[0] : PLUGIN_NAME;
     const existingOpts = Array.isArray(current) && current.length >= 2 ? current[1] : {};
     if (deepEqual(existingOpts[subKey], value)) {
       return { changed: false };
@@ -617,14 +568,14 @@ function writeMcpToggles(configPath, enabledSet, opts) {
 }
 async function install(opts = {}) {
   const { dryRun = false, pin = false, nonInteractive = false } = opts;
-  const configPath = getOpencodeConfigPath2();
-  const pluginEntry = pin ? `${PLUGIN_NAME2}@${readPackageVersion()}` : PLUGIN_NAME2;
+  const configPath = getOpencodeConfigPath();
+  const pluginEntry = pin ? `${PLUGIN_NAME}@${readPackageVersion()}` : PLUGIN_NAME;
   const interactive = !nonInteractive && process.stdin.isTTY === true;
   const existing = readExistingConfig(configPath);
   const hasPlugin = existing ? (Array.isArray(existing.plugin) ? existing.plugin : []).some(
     (p) => {
       const name = typeof p === "string" ? p : Array.isArray(p) ? p[0] : null;
-      return name === PLUGIN_NAME2 || String(name ?? "").startsWith(`${PLUGIN_NAME2}@`);
+      return name === PLUGIN_NAME || String(name ?? "").startsWith(`${PLUGIN_NAME}@`);
     }
   ) : false;
   const existingProvider = detectModelProvider(existing);
@@ -911,7 +862,6 @@ ${c.bold}Ready.${c.reset} Run ${c.green}opencode${c.reset} to start.
 }
 
 export {
-  requirePlugin,
   MODEL_PRESETS,
   writePluginOption,
   writeMcpToggles,

package/dist/chunk-DZG4D3OH.js

@@ -0,0 +1,54 @@
+// src/model-validator.ts
+var CATWALK_PROVIDER_PATTERN = /^(?:bedrock|vertex|vertexai)\//;
+var LEGACY_PRE_100_PATTERN = /^(bedrock|vertex|vertexai)\/claude-(opus|sonnet|haiku)(-\d+)?$/;
+var LEGACY_TO_MODELS_DEV = {
+  // --- Pre-PR-#100 Bedrock (no subpath) ---
+  "bedrock/claude-opus": "amazon-bedrock/global.anthropic.claude-opus-4-7",
+  "bedrock/claude-opus-4": "amazon-bedrock/global.anthropic.claude-opus-4-7",
+  "bedrock/claude-sonnet": "amazon-bedrock/global.anthropic.claude-sonnet-4-6",
+  "bedrock/claude-sonnet-4": "amazon-bedrock/global.anthropic.claude-sonnet-4-6",
+  "bedrock/claude-haiku": "amazon-bedrock/global.anthropic.claude-haiku-4-5-20251001-v1:0",
+  "bedrock/claude-haiku-4": "amazon-bedrock/global.anthropic.claude-haiku-4-5-20251001-v1:0",
+  // --- Pre-Models.dev Bedrock (had subpath, but wrong provider prefix) ---
+  "bedrock/anthropic.claude-opus-4-6": "amazon-bedrock/global.anthropic.claude-opus-4-7",
+  "bedrock/anthropic.claude-opus-4-7": "amazon-bedrock/global.anthropic.claude-opus-4-7",
+  "bedrock/anthropic.claude-sonnet-4-6": "amazon-bedrock/global.anthropic.claude-sonnet-4-6",
+  "bedrock/anthropic.claude-haiku-4-5-20251001-v1:0": "amazon-bedrock/global.anthropic.claude-haiku-4-5-20251001-v1:0",
+  // --- Pre-PR-#100 Vertex (no @date suffix) ---
+  "vertex/claude-opus": "google-vertex-anthropic/claude-opus-4-7@default",
+  "vertex/claude-opus-4": "google-vertex-anthropic/claude-opus-4-7@default",
+  "vertex/claude-sonnet": "google-vertex-anthropic/claude-sonnet-4-6@default",
+  "vertex/claude-sonnet-4": "google-vertex-anthropic/claude-sonnet-4-6@default",
+  "vertex/claude-haiku": "google-vertex-anthropic/claude-haiku-4-5@20251001",
+  "vertex/claude-haiku-4": "google-vertex-anthropic/claude-haiku-4-5@20251001",
+  "vertexai/claude-opus": "google-vertex-anthropic/claude-opus-4-7@default",
+  "vertexai/claude-opus-4": "google-vertex-anthropic/claude-opus-4-7@default",
+  "vertexai/claude-sonnet": "google-vertex-anthropic/claude-sonnet-4-6@default",
+  "vertexai/claude-sonnet-4": "google-vertex-anthropic/claude-sonnet-4-6@default",
+  "vertexai/claude-haiku": "google-vertex-anthropic/claude-haiku-4-5@20251001",
+  "vertexai/claude-haiku-4": "google-vertex-anthropic/claude-haiku-4-5@20251001",
+  // --- Pre-Models.dev Vertex (had @date suffix, wrong provider prefix) ---
+  "vertexai/claude-opus-4-6@20250610": "google-vertex-anthropic/claude-opus-4-6@default",
+  "vertexai/claude-opus-4-7@20250610": "google-vertex-anthropic/claude-opus-4-7@default",
+  "vertexai/claude-sonnet-4-6@20250725": "google-vertex-anthropic/claude-sonnet-4-6@default",
+  "vertexai/claude-haiku-4-5@20251001": "google-vertex-anthropic/claude-haiku-4-5@20251001"
+};
+function validateModelOverride(id) {
+  if (typeof id !== "string") return { valid: true };
+  if (id.length === 0) return { valid: true };
+  if (CATWALK_PROVIDER_PATTERN.test(id)) {
+    const suggestion = LEGACY_TO_MODELS_DEV[id] ?? "run `bunx @glrs-dev/harness-plugin-opencode install` to pick a current preset";
+    const reason = LEGACY_PRE_100_PATTERN.test(id) ? `"${id}" is a pre-PR-#100 model ID format that does not resolve in OpenCode. Bedrock IDs need the \`amazon-bedrock\` provider prefix (not \`bedrock\`); Vertex Claude IDs need the \`google-vertex-anthropic\` provider prefix (not \`vertex\` / \`vertexai\`).` : `"${id}" uses a provider prefix (\`${id.split("/")[0]}\`) that does not exist in OpenCode's runtime. AWS Bedrock's provider ID is \`amazon-bedrock\`; Vertex Claude's is \`google-vertex-anthropic\`.`;
+    return { valid: false, reason, suggestion };
+  }
+  return { valid: true };
+}
+function formatModelOverrideWarning(id, source, suggestion) {
+  const suggestionText = suggestion ? ` Suggested replacement: \`${suggestion}\`.` : "";
+  return `[@glrs-dev/harness-plugin-opencode] Warning: invalid model override "${id}" (from ${source}).${suggestionText} Run \`bunx @glrs-dev/harness-plugin-opencode doctor\` for details.`;
+}
+
+export {
+  validateModelOverride,
+  formatModelOverrideWarning
+};

package/dist/chunk-OYRKOEXK.js

@@ -0,0 +1,88 @@
+// src/pilot/paths.ts
+import { execFile } from "child_process";
+import * as fs from "fs/promises";
+import * as os from "os";
+import * as path from "path";
+function execFileP(file, args, opts = {}) {
+  const { cwd, timeoutMs = 5e3 } = opts;
+  return new Promise((resolve2, reject) => {
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), timeoutMs);
+    execFile(
+      file,
+      args,
+      { signal: controller.signal, cwd, encoding: "utf8" },
+      (err, stdout) => {
+        clearTimeout(timer);
+        if (err) {
+          reject(err);
+          return;
+        }
+        resolve2(stdout ?? "");
+      }
+    );
+  });
+}
+function expandTilde(p) {
+  if (p === "~") return os.homedir();
+  if (p.startsWith("~/")) return path.join(os.homedir(), p.slice(2));
+  return p;
+}
+async function getRepoFolder(cwd) {
+  let stdout;
+  try {
+    stdout = await execFileP("git", ["rev-parse", "--git-common-dir"], { cwd });
+  } catch (err) {
+    throw new Error(
+      `pilot paths: could not determine repo folder from ${JSON.stringify(cwd)}: ${err instanceof Error ? err.message : String(err)}`
+    );
+  }
+  const gitCommonDir = stdout.trim();
+  const abs = path.isAbsolute(gitCommonDir) ? gitCommonDir : path.resolve(cwd, gitCommonDir);
+  return path.basename(path.dirname(abs));
+}
+async function getPilotDir(cwd) {
+  const override = process.env["GLORIOUS_PILOT_DIR"];
+  if (override) {
+    const dir = expandTilde(override);
+    await fs.mkdir(dir, { recursive: true });
+    return dir;
+  }
+  const repoFolder = await getRepoFolder(cwd);
+  const base = path.join(os.homedir(), ".glorious", "opencode", repoFolder, "pilot");
+  await fs.mkdir(base, { recursive: true });
+  return base;
+}
+async function getStateDbPath(cwd) {
+  const base = await getPilotDir(cwd);
+  return path.join(base, "state.sqlite");
+}
+async function getCurrentScopePath(cwd) {
+  const base = await getPilotDir(cwd);
+  return path.join(base, "current-scope.json");
+}
+async function getScopeArtifactPath(cwd, workflowId) {
+  const base = await getPilotDir(cwd);
+  const dir = path.join(base, "scopes", workflowId);
+  await fs.mkdir(dir, { recursive: true });
+  return path.join(dir, "scope.json");
+}
+async function getPlanArtifactPath(cwd, workflowId) {
+  const base = await getPilotDir(cwd);
+  const dir = path.join(base, "scopes", workflowId);
+  await fs.mkdir(dir, { recursive: true });
+  return path.join(dir, "plan.json");
+}
+function getPilotConfigPath(cwd) {
+  return path.join(cwd, ".glrs", "pilot.json");
+}
+
+export {
+  getRepoFolder,
+  getPilotDir,
+  getStateDbPath,
+  getCurrentScopePath,
+  getScopeArtifactPath,
+  getPlanArtifactPath,
+  getPilotConfigPath
+};