@glrs-dev/harness-plugin-opencode 2.2.0 → 2.3.0

package/dist/index.js

@@ -59,6 +59,7 @@ function readPrompt(name) {
   throw new Error(`Could not find prompt file: ${name}`);
 }
 var primePrompt = readPrompt("prime.md");
+var scoperPrompt = readPrompt("scoper.md");
 var planPrompt = readPrompt("plan.md");
 var buildPrompt = readPrompt("build.md");
 var buildOpenPrompt = readPrompt("build.open.md");
@@ -78,6 +79,7 @@ var researchPrompt = readPrompt("research.md");
 var researchWebPrompt = readPrompt("research-web.md");
 var researchLocalPrompt = readPrompt("research-local.md");
 var researchAutoPrompt = readPrompt("research-auto.md");
+var debrieferPrompt = readPrompt("debriefer.md");
 var EXECUTOR_VARIANT_AGENTS = {
   build: { reasoning: buildPrompt, strict: buildOpenPrompt },
   "spec-reviewer": { reasoning: specReviewerPrompt, strict: specReviewerOpenPrompt },
@@ -214,7 +216,7 @@ var CORE_BASH_ALLOW_LIST = {
   "eslint *": "allow",
   "prettier *": "allow",
   "biome *": "allow",
-  // Our own CLI — the plan agent and assessor both call plan-check/plan-dir.
+  // Our own CLI (install, doctor, autopilot, etc.) — reviewer/build invocations.
   "bunx @glrs-dev/harness-plugin-opencode *": "allow",
   "glrs-oc *": "allow",
   // GitHub CLI — read-only gh calls are fine; destructive `gh pr merge`
@@ -269,21 +271,33 @@ var PRIME_PERMISSIONS = {
   playwright: "allow",
   linear: "allow"
 };
+var SCOPER_PERMISSIONS = {
+  ...PRIME_PERMISSIONS
+};
+var SCOPER_DISABLED_TOOLS = {
+  question: false
+};
+var AUTOPILOT_PRIME_DISABLED_TOOLS = {
+  question: false
+};
 var PLAN_PERMISSIONS = {
   edit: "allow",
-  // Plan agent is read-only aside from writing under the plan dir — but
-  // it does need to RESOLVE the plan dir via the `plan-dir` CLI
-  // subcommand (returns an absolute path derived from the worktree's
-  // repo-folder key; see src/plan-paths.ts and src/cli.ts). The object-
-  // form denies bash broadly and re-allows only `bunx
-  // @glrs-dev/harness-plugin-opencode plan-dir[...]`. No other bash invocation
-  // is permitted, so the read-only-aside-from-plans invariant holds.
+  write: "allow",
+  // Plan agent is read-only aside from writing under the plan dir. It
+  // resolves the plan dir inline (see src/agents/prompts/plan.md
+  // `## 4. Write the plan`): `$HOME/.glorious/opencode/<repo-folder>/plans/`,
+  // where `<repo-folder>` comes from
+  // `basename(dirname(git rev-parse --git-common-dir))`. The object-form
+  // denies bash broadly and re-allows only the four commands that snippet
+  // needs. Everything else remains denied, preserving the "plan writes only
+  // plan files" invariant (the write-scope constraint is prompt-enforced,
+  // not permission-enforced).
   bash: {
     "*": "deny",
-    "bunx @glrs-dev/harness-plugin-opencode plan-dir": "allow",
-    "bunx @glrs-dev/harness-plugin-opencode plan-dir *": "allow",
-    "glrs-oc plan-dir": "allow",
-    "glrs-oc plan-dir *": "allow"
+    "git rev-parse --git-common-dir": "allow",
+    "basename *": "allow",
+    "dirname *": "allow",
+    "mkdir -p *": "allow"
   },
   webfetch: "allow",
   ast_grep: "deny",
@@ -500,8 +514,39 @@ var RESEARCH_PERMISSIONS = {
   playwright: "allow",
   linear: "allow"
 };
+var DEBRIEFER_PERMISSIONS = {
+  edit: "deny",
+  bash: {
+    "*": "deny",
+    "git log *": "allow",
+    "git diff *": "allow",
+    "git show *": "allow",
+    "git status *": "allow",
+    "git rev-parse *": "allow",
+    "git branch *": "allow",
+    "cat *": "allow",
+    "head *": "allow",
+    "tail *": "allow",
+    "ls *": "allow",
+    "wc *": "allow"
+  },
+  webfetch: "deny",
+  ast_grep: "deny",
+  tsc_check: "deny",
+  eslint_check: "deny",
+  todo_scan: "deny",
+  comment_check: "deny",
+  question: "deny",
+  serena: "deny",
+  memory: "deny",
+  git: "allow",
+  playwright: "deny",
+  linear: "deny"
+};
 var AGENT_TIERS = {
   prime: "deep",
+  scoper: "deep",
+  "autopilot-prime": "deep",
   plan: "deep",
   "architecture-advisor": "deep",
   "plan-reviewer": "deep",
@@ -517,6 +562,7 @@ var AGENT_TIERS = {
   "docs-maintainer": "mid",
   "lib-reader": "mid",
   "agents-md-writer": "mid",
+  debriefer: "mid",
   "code-searcher": "fast"
 };
 function createAgents() {
@@ -529,11 +575,31 @@ function createAgents() {
       temperature: 0.2,
       permission: PRIME_PERMISSIONS
     }),
+    scoper: agentFromPrompt(scoperPrompt, {
+      description: "Interactive scoping agent. Runs an inquirer-driven wizard loop \u2014 asks short questions via assistant text, collects answers via inquirer, then writes scope.md. Use at the start of a new feature to align on intent, constraints, and acceptance criteria before planning.",
+      mode: "primary",
+      model: "anthropic/claude-opus-4-7",
+      temperature: 0.3,
+      permission: SCOPER_PERMISSIONS,
+      tools: SCOPER_DISABLED_TOOLS
+    }),
+    "autopilot-prime": agentFromPrompt(primePrompt, {
+      description: "PRIME for unattended autopilot sessions. Identical to `prime` except the `question` tool is disabled \u2014 autopilot has no user to answer interactive prompts, and a blocking question deadlocks the session. Not user-selectable; invoked by the Ralph loop.",
+      mode: "subagent",
+      model: "anthropic/claude-opus-4-7",
+      temperature: 0.2,
+      permission: PRIME_PERMISSIONS,
+      tools: AUTOPILOT_PRIME_DISABLED_TOOLS
+    }),
     plan: agentFromPrompt(planPrompt, {
-      description: "Interactive planner. Orchestrates gap analysis and adversarial review. Produces a written plan in the repo-shared plan directory (resolve via `bunx @glrs-dev/harness-plugin-opencode plan-dir`).",
+      description: "Interactive planner. Orchestrates gap analysis and adversarial review. Produces a written plan in the repo-shared plan directory (`~/.glorious/opencode/<repo-folder>/plans/`, resolved inline via `git rev-parse --git-common-dir`).",
       mode: "all",
       model: "anthropic/claude-opus-4-7",
       temperature: 0.3,
+      // @plan dispatches @gap-analyzer, @code-searcher, and @plan-reviewer
+      // as subagents. OpenCode strips the `task` tool from subagent contexts
+      // by default; explicit opt-in re-enables it.
+      tools: { task: true },
       permission: PLAN_PERMISSIONS
     }),
     build: agentFromPrompt(buildPrompt, {
@@ -580,6 +646,8 @@ function createAgents() {
       mode: "all",
       model: "anthropic/claude-opus-4-7",
       temperature: 0.3,
+      // @research dispatches @research-web, @research-local, @research-auto.
+      tools: { task: true },
       permission: RESEARCH_PERMISSIONS
     }),
     // Research subagents — thin shims that load the bundled skills.
@@ -591,6 +659,8 @@ function createAgents() {
       mode: "subagent",
       model: "anthropic/claude-opus-4-7",
       temperature: 0.3,
+      // @research-web dispatches its own parallel workstream agents.
+      tools: { task: true },
       permission: RESEARCH_PERMISSIONS
     }),
     "research-local": agentFromPrompt(researchLocalPrompt, {
@@ -598,6 +668,8 @@ function createAgents() {
       mode: "subagent",
       model: "anthropic/claude-opus-4-7",
       temperature: 0.3,
+      // @research-local dispatches parallel Explore subagents.
+      tools: { task: true },
       permission: RESEARCH_PERMISSIONS
     }),
     "research-auto": agentFromPrompt(researchAutoPrompt, {
@@ -606,6 +678,10 @@ function createAgents() {
       model: "anthropic/claude-opus-4-7",
       temperature: 0.3,
       permission: RESEARCH_PERMISSIONS
+    }),
+    // Debriefer — post-run summary agent for the autopilot CLI
+    debriefer: agentFromPrompt(debrieferPrompt, {
+      permission: DEBRIEFER_PERMISSIONS
     })
   };
 }
@@ -2025,7 +2101,7 @@ import { join as join9 } from "path";
 var APP_KEY = "A-US-3617699429";
 var ENDPOINT = "https://us.aptabase.com/api/v0/event";
 var PKG_NAME = "@glrs-dev/harness-plugin-opencode";
-var PKG_VERSION = true ? "2.2.0" : "dev";
+var PKG_VERSION = true ? "2.3.0" : "dev";
 var DISABLED = process.env.HARNESS_OPENCODE_TELEMETRY === "0" || process.env.HARNESS_OPENCODE_TELEMETRY === "false" || process.env.DO_NOT_TRACK === "1" || process.env.CI === "true";
 var SESSION_ID = randomUUID();
 function getInstallId() {

package/dist/loop-session-J35NILUZ.js

@@ -0,0 +1,30 @@
+import {
+  runRalphLoop
+} from "./chunk-NIFAVPNN.js";
+import "./chunk-MJSMBY2Y.js";
+import "./chunk-GCWHRUOK.js";
+
+// src/autopilot/loop-session.ts
+import * as fs from "fs";
+import * as path from "path";
+async function runLoopSession(opts) {
+  const _runRalphLoop = opts._deps?.runRalphLoop ?? runRalphLoop;
+  const isDirectory = opts._deps?.isDirectory ? opts._deps.isDirectory(opts.planPath) : (() => {
+    try {
+      return fs.statSync(opts.planPath).isDirectory();
+    } catch {
+      return false;
+    }
+  })();
+  let prompt;
+  if (isDirectory) {
+    const mainMd = path.join(opts.planPath, "main.md");
+    prompt = `Work the plan at ${mainMd}. Find the first unchecked phase in ## Phases and complete all its items. Continue until all phases are checked and all main.md items are checked. Mark items done as they complete.`;
+  } else {
+    prompt = `Work the plan at ${opts.planPath}. Complete all items in ## Acceptance criteria. Mark items done as they complete.`;
+  }
+  return _runRalphLoop({ prompt, cwd: opts.cwd });
+}
+export {
+  runLoopSession
+};

package/dist/opencode-server-KPCDFYAX.js

@@ -0,0 +1,22 @@
+import {
+  DEFAULT_STARTUP_TIMEOUT_MS,
+  createSession,
+  execFileP,
+  getLastAssistantMessage,
+  getSessionCost,
+  selfTest,
+  sendAndWait,
+  startServer,
+  waitForIdle
+} from "./chunk-GCWHRUOK.js";
+export {
+  DEFAULT_STARTUP_TIMEOUT_MS,
+  createSession,
+  execFileP,
+  getLastAssistantMessage,
+  getSessionCost,
+  selfTest,
+  sendAndWait,
+  startServer,
+  waitForIdle
+};

package/dist/plan-parser-TMHEKT22.js

@@ -0,0 +1,6 @@
+import {
+  parsePlanState
+} from "./chunk-MJSMBY2Y.js";
+export {
+  parsePlanState
+};

package/dist/plan-session-7VS32P52.js

@@ -0,0 +1,117 @@
+import {
+  createSession,
+  sendAndWait,
+  startServer
+} from "./chunk-GCWHRUOK.js";
+
+// src/autopilot/plan-session.ts
+import * as fs from "fs";
+import * as path from "path";
+var DEFAULT_PLAN_TIMEOUT_MS = 10 * 60 * 1e3;
+async function runPlanSession(opts) {
+  const timeoutMs = opts.timeoutMs ?? DEFAULT_PLAN_TIMEOUT_MS;
+  const _startServer = opts._deps?.startServer ?? startServer;
+  const _createSession = opts._deps?.createSession ?? createSession;
+  const _sendAndWait = opts._deps?.sendAndWait ?? sendAndWait;
+  const _existsSync = opts._deps?.existsSync ?? fs.existsSync;
+  const server = await _startServer({ cwd: opts.planDir });
+  try {
+    const sessionId = await _createSession(server.client, {
+      cwd: opts.planDir,
+      agentName: "plan"
+    });
+    const multiFileDir = path.join(opts.planDir, opts.slug);
+    const multiFileMain = path.join(multiFileDir, "main.md");
+    const singleFilePlan = path.join(opts.planDir, `${opts.slug}.md`);
+    const prompt = `Read the scope at ${opts.scopePath} and produce a plan. Use slug ${opts.slug} for the plan file(s). If the scope warrants multiple phases, produce a multi-file plan at ${multiFileDir}/main.md + phase_N.md files. Otherwise produce a single-file plan at ${singleFilePlan}.`;
+    const result = await _sendAndWait(server.client, {
+      sessionId,
+      message: prompt,
+      agentName: "plan",
+      stallMs: timeoutMs,
+      autoRejectPermissions: true,
+      serverUrl: server.url
+    });
+    if (result.kind === "abort") {
+      throw new Error(
+        `Plan session aborted (timeout after ${timeoutMs}ms).`
+      );
+    }
+    if (result.kind === "stall") {
+      throw new Error(
+        `Plan session stalled for ${result.stallMs}ms with no idle signal.`
+      );
+    }
+    if (result.kind === "error") {
+      throw new Error(`Plan session error: ${result.message}`);
+    }
+    if (result.kind === "question_rejected") {
+      process.stderr.write(
+        `
+  \u26A0 @plan tried to ask a question (rejected). Checking if plan was written anyway...
+`
+      );
+    }
+    if (_existsSync(multiFileMain)) {
+      return { planPath: multiFileDir };
+    }
+    if (_existsSync(singleFilePlan)) {
+      return { planPath: singleFilePlan };
+    }
+    process.stderr.write(
+      `
+  \u26A0 @plan didn't write a plan file. Re-sending with explicit instructions...
+`
+    );
+    const retryPrompt = `You did not write a plan file. Write the plan NOW. Read the scope at ${opts.scopePath}. Write the plan to ${singleFilePlan} (single-file) or ${multiFileDir}/main.md (multi-file). Do NOT ask questions. Just write the plan.`;
+    const retryResult = await _sendAndWait(server.client, {
+      sessionId,
+      message: retryPrompt,
+      agentName: "plan",
+      stallMs: timeoutMs,
+      autoRejectPermissions: true,
+      serverUrl: server.url
+    });
+    if (retryResult.kind !== "idle" && retryResult.kind !== "question_rejected") {
+      throw new Error(`@plan retry failed: ${retryResult.kind}`);
+    }
+    if (_existsSync(multiFileMain)) {
+      return { planPath: multiFileDir };
+    }
+    if (_existsSync(singleFilePlan)) {
+      return { planPath: singleFilePlan };
+    }
+    process.stderr.write(
+      `
+  \u26A0 @plan still didn't write a plan. Constructing minimal plan from scope.
+`
+    );
+    const scopeContent = fs.existsSync(opts.scopePath) ? fs.readFileSync(opts.scopePath, "utf-8") : `# Plan
+
+Scope file not found at ${opts.scopePath}.`;
+    const minimalPlan = [
+      `# Plan (auto-generated from scope)`,
+      "",
+      "This plan was auto-generated because @plan did not produce a plan file.",
+      "Review and refine before executing.",
+      "",
+      scopeContent,
+      "",
+      "## Acceptance criteria",
+      "",
+      "- [ ] Review and refine this auto-generated plan",
+      "",
+      "## File-level changes",
+      "",
+      "- To be determined after plan review."
+    ].join("\n");
+    fs.mkdirSync(path.dirname(singleFilePlan), { recursive: true });
+    fs.writeFileSync(singleFilePlan, minimalPlan);
+    return { planPath: singleFilePlan };
+  } finally {
+    await server.shutdown();
+  }
+}
+export {
+  runPlanSession
+};