@glrs-dev/cli 0.1.0 → 0.3.1

package/dist/vendor/harness-opencode/dist/{chunk-V3KJY6CN.js → chunk-WBBN7OVN.js}

@@ -3,7 +3,7 @@ import {
   inspectCachePin,
   readOurPackageVersion,
   refreshPluginCache
-} from "./chunk-UDB4NQ2R.js";
+} from "./chunk-VJUETC6A.js";
 
 // src/cli/install.ts
 import * as fs3 from "fs";
@@ -181,7 +181,7 @@ 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-opencode";
+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");
@@ -257,7 +257,7 @@ async function requirePlugin() {
     );
     process.exit(1);
   }
-  const { install: install2 } = await import("./install-GDCZ7VFK.js");
+  const { install: install2 } = await import("./install-X5KEANRB.js");
   await install2({ nonInteractive: true });
 }
 
@@ -361,7 +361,7 @@ async function fetchModelsDevProviders() {
 }
 
 // src/cli/install.ts
-var PLUGIN_NAME2 = "@glrs-dev/harness-opencode";
+var PLUGIN_NAME2 = "@glrs-dev/harness-plugin-opencode";
 var c = {
   reset: "\x1B[0m",
   green: "\x1B[32m",
@@ -505,6 +505,116 @@ function migrateHarnessKeyToPluginOptions(configPath) {
   } catch {
   }
 }
+function deepEqual(a, b) {
+  if (a === b) return true;
+  if (typeof a !== typeof b) return false;
+  if (a === null || b === null) return a === b;
+  if (typeof a !== "object") return false;
+  const aObj = a;
+  const bObj = b;
+  const aKeys = Object.keys(aObj);
+  const bKeys = Object.keys(bObj);
+  if (aKeys.length !== bKeys.length) return false;
+  for (const key of aKeys) {
+    if (!bKeys.includes(key)) return false;
+    if (!deepEqual(aObj[key], bObj[key])) return false;
+  }
+  return true;
+}
+function writePluginOption(configPath, subKey, value, opts) {
+  try {
+    if (!fs3.existsSync(configPath)) {
+      return { changed: false };
+    }
+    const raw = fs3.readFileSync(configPath, "utf8");
+    const config = JSON.parse(raw);
+    if (!Array.isArray(config.plugin)) {
+      return { changed: false };
+    }
+    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}@`);
+    });
+    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 existingOpts = Array.isArray(current) && current.length >= 2 ? current[1] : {};
+    if (deepEqual(existingOpts[subKey], value)) {
+      return { changed: false };
+    }
+    const newOpts = { ...existingOpts, [subKey]: value };
+    if (opts.dryRun) {
+      info(`[dry-run] Would reconfigure ${subKey} in plugin options`);
+      return { changed: true };
+    }
+    const bakPath = `${configPath}.bak.${Date.now()}-${process.pid}`;
+    fs3.copyFileSync(configPath, bakPath);
+    config.plugin[pluginIdx] = [existingName, newOpts];
+    fs3.writeFileSync(configPath, JSON.stringify(config, null, 2) + "\n");
+    ok(`Reconfigured ${subKey}`);
+    info(`Backup: ${bakPath}`);
+    return { changed: true, bakPath };
+  } catch {
+    return { changed: false };
+  }
+}
+function writeMcpToggles(configPath, enabledSet, opts) {
+  try {
+    if (!fs3.existsSync(configPath)) {
+      return { changed: false };
+    }
+    const raw = fs3.readFileSync(configPath, "utf8");
+    const config = JSON.parse(raw);
+    const toggleNames = new Set(MCP_TOGGLES.map((t) => t.name));
+    const existingMcp = config.mcp && typeof config.mcp === "object" ? { ...config.mcp } : {};
+    const newMcp = {};
+    let hasChanges = false;
+    for (const [key, val] of Object.entries(existingMcp)) {
+      if (!toggleNames.has(key)) {
+        newMcp[key] = val;
+      }
+    }
+    for (const toggleName of toggleNames) {
+      if (enabledSet.has(toggleName)) {
+        newMcp[toggleName] = { enabled: true };
+        if (!deepEqual(existingMcp[toggleName], { enabled: true })) {
+          hasChanges = true;
+        }
+      } else {
+        if (existingMcp[toggleName] !== void 0) {
+          hasChanges = true;
+        }
+      }
+    }
+    if (!hasChanges && Object.keys(newMcp).length === Object.keys(existingMcp).length) {
+      const allKeysMatch = Object.keys(newMcp).every(
+        (k) => deepEqual(newMcp[k], existingMcp[k])
+      );
+      if (allKeysMatch) {
+        return { changed: false };
+      }
+    }
+    if (opts.dryRun) {
+      info(`[dry-run] Would reconfigure MCP toggles`);
+      return { changed: true };
+    }
+    const bakPath = `${configPath}.bak.${Date.now()}-${process.pid}`;
+    fs3.copyFileSync(configPath, bakPath);
+    if (Object.keys(newMcp).length > 0) {
+      config.mcp = newMcp;
+    } else {
+      delete config.mcp;
+    }
+    fs3.writeFileSync(configPath, JSON.stringify(config, null, 2) + "\n");
+    ok("Reconfigured MCPs");
+    info(`Backup: ${bakPath}`);
+    return { changed: true, bakPath };
+  } catch {
+    return { changed: false };
+  }
+}
 async function install(opts = {}) {
   const { dryRun = false, pin = false, nonInteractive = false } = opts;
   const configPath = getOpencodeConfigPath2();
@@ -522,7 +632,7 @@ async function install(opts = {}) {
   const existingOpts = extractPluginOptions(existing);
   let hasModels = !!(existingOpts?.models ?? existing?.harness?.models);
   console.log(`
-${c.bold}${c.blue}@glrs-dev/harness-opencode${c.reset} setup
+${c.bold}${c.blue}@glrs-dev/harness-plugin-opencode${c.reset} setup
 `);
   if (hasPlugin) {
     ok("Plugin already registered");
@@ -533,6 +643,10 @@ ${c.bold}${c.blue}@glrs-dev/harness-opencode${c.reset} setup
   if (existingMcps.size > 0) {
     ok(`MCPs: ${[...existingMcps].join(", ")} enabled`);
   }
+  let reconfigureModels = false;
+  let reconfigureMcps = false;
+  let newModelsValue = null;
+  let newMcpEnabledSet = /* @__PURE__ */ new Set();
   if (hasPlugin && (existingProvider || hasModels)) {
     const unconfiguredMcps = MCP_TOGGLES.filter(
       (t) => !existingMcps.has(t.name) && !existing?.mcp?.[t.name]
@@ -544,8 +658,20 @@ ${c.bold}${c.blue}@glrs-dev/harness-opencode${c.reset} setup
         0
       );
       if (reconfigure === 1) {
+        reconfigureModels = true;
         hasModels = false;
-      } else if (unconfiguredMcps.length === 0) {
+      }
+      if (existingMcps.size > 0) {
+        const reconfigureMcpChoice = await promptChoice(
+          "  Reconfigure MCPs?",
+          ["No, keep current config", "Yes, reconfigure MCPs"],
+          0
+        );
+        if (reconfigureMcpChoice === 1) {
+          reconfigureMcps = true;
+        }
+      }
+      if (!reconfigureModels && !reconfigureMcps && unconfiguredMcps.length === 0) {
         console.log(`
 ${c.bold}Ready.${c.reset} Run ${c.green}opencode${c.reset} to start.
 `);
@@ -632,6 +758,11 @@ ${c.bold}Ready.${c.reset} Run ${c.green}opencode${c.reset} to start.
         mid: [preset.mid],
         fast: [preset.fast]
       };
+      newModelsValue = {
+        deep: [preset.deep],
+        mid: [preset.mid],
+        fast: [preset.fast]
+      };
       ok(`Models configured`);
     } else if (!pluginOpts._skipModels) {
       info("Enter model IDs in <provider>/<model-id> format (e.g. amazon-bedrock/global.anthropic.claude-opus-4-7)");
@@ -645,6 +776,11 @@ ${c.bold}Ready.${c.reset} Run ${c.green}opencode${c.reset} to start.
           mid: [midModel || deepModel],
           fast: [fastModel || midModel || deepModel]
         };
+        newModelsValue = {
+          deep: [deepModel],
+          mid: [midModel || deepModel],
+          fast: [fastModel || midModel || deepModel]
+        };
         ok("Models: custom");
       } else {
         ok("Models: OpenCode defaults");
@@ -653,6 +789,22 @@ ${c.bold}Ready.${c.reset} Run ${c.green}opencode${c.reset} to start.
     delete pluginOpts._skipModels;
     console.log();
   }
+  if (interactive && reconfigureMcps) {
+    console.log(`${c.dim}Reconfigure MCP servers${c.reset}`);
+    const currentEnabled = new Set(existingMcps);
+    const selected = await promptMulti(
+      "  Select MCPs to enable:",
+      MCP_TOGGLES.map((t) => ({ label: t.label, defaultOn: currentEnabled.has(t.name) }))
+    );
+    newMcpEnabledSet = new Set([...selected].map((i) => MCP_TOGGLES[i].name));
+    const names = [...newMcpEnabledSet].join(", ");
+    if (newMcpEnabledSet.size > 0) {
+      ok(`MCPs to enable: ${names}`);
+    } else {
+      ok("MCPs: all disabled");
+    }
+    console.log();
+  }
   const pluginValue = Object.keys(pluginOpts).length > 0 ? [pluginEntry, pluginOpts] : pluginEntry;
   const config = {
     $schema: "https://opencode.ai/config.json",
@@ -683,6 +835,12 @@ ${c.bold}Ready.${c.reset} Run ${c.green}opencode${c.reset} to start.
       console.log();
     }
   }
+  if (reconfigureModels && newModelsValue) {
+    writePluginOption(configPath, "models", newModelsValue, { dryRun });
+  }
+  if (reconfigureMcps) {
+    writeMcpToggles(configPath, newMcpEnabledSet, { dryRun });
+  }
   if (!fs3.existsSync(configPath)) {
     if (dryRun) {
       info(`[dry-run] Would create ${configPath}`);
@@ -727,5 +885,7 @@ ${c.bold}Ready.${c.reset} Run ${c.green}opencode${c.reset} to start.
 export {
   requirePlugin,
   MODEL_PRESETS,
+  writePluginOption,
+  writeMcpToggles,
   install
 };

package/dist/vendor/harness-opencode/dist/cli.js

@@ -2,12 +2,12 @@
 import {
   createAgents,
   validateModelOverride
-} from "./chunk-BDFZGIY7.js";
+} from "./chunk-CZMAJISX.js";
 import {
   install,
   requirePlugin
-} from "./chunk-V3KJY6CN.js";
-import "./chunk-UDB4NQ2R.js";
+} from "./chunk-WBBN7OVN.js";
+import "./chunk-VJUETC6A.js";
 
 // src/cli.ts
 import {
@@ -27,7 +27,7 @@ import {
 import * as fs from "fs";
 import * as path from "path";
 import * as os from "os";
-var PLUGIN_NAME = "@glrs-dev/harness-opencode";
+var PLUGIN_NAME = "@glrs-dev/harness-plugin-opencode";
 function getOpencodeConfigPath() {
   const configHome = process.env["XDG_CONFIG_HOME"] ?? path.join(os.homedir(), ".config");
   return path.join(configHome, "opencode", "opencode.json");
@@ -101,7 +101,7 @@ ${c2.blue}Uninstalling ${PLUGIN_NAME}${c2.reset}
   ok(`Removed "${PLUGIN_NAME}" from ${configPath}`);
   info(`Backup: ${bakPath}`);
   console.log(`
-To fully remove the package: bun remove @glrs-dev/harness-opencode
+To fully remove the package: bun remove @glrs-dev/harness-plugin-opencode
 `);
 }
 
@@ -110,7 +110,7 @@ import * as fs2 from "fs";
 import * as path2 from "path";
 import * as os2 from "os";
 import { execSync } from "child_process";
-var PLUGIN_NAME2 = "@glrs-dev/harness-opencode";
+var PLUGIN_NAME2 = "@glrs-dev/harness-plugin-opencode";
 function getOpencodeConfigPath2() {
   const configHome = process.env["XDG_CONFIG_HOME"] ?? path2.join(os2.homedir(), ".config");
   return path2.join(configHome, "opencode", "opencode.json");
@@ -514,6 +514,7 @@ var PlanSchema = z.object({
   branch_prefix: z.string().min(1).optional(),
   defaults: DefaultsSchema,
   milestones: z.array(MilestoneSchema).default([]),
+  setup: z.array(VerifyCommandSchema).default([]),
   tasks: z.array(TaskSchema).min(1, "plan must declare at least one task")
 }).strict();
 function parsePlan(input) {
@@ -1111,7 +1112,7 @@ async function runPlan(opts) {
   }
   process.stdout.write(
     `Plan ready at ${newest.path}
-Build with: bunx @glrs-dev/harness-opencode pilot build
+Build with: bunx @glrs-dev/harness-plugin-opencode pilot build
 `
   );
   return 0;
@@ -2224,7 +2225,8 @@ var WorktreePool = class {
         path: "",
         // filled by prepare
         prepared: false,
-        preserved: false
+        preserved: false,
+        setupCompleted: false
       };
       this.slots.set(n, stub);
       return stub;
@@ -2442,7 +2444,7 @@ function kickoffPrompt(task, ctx) {
   sections.push(
     `# Pilot task: ${task.id} \u2014 ${task.title}`,
     ``,
-    `You are running unattended as the **pilot-builder** agent under the pilot subsystem of \`@glrs-dev/harness-opencode\`. This is task **${task.id}** of the plan **"${ctx.planName}"**` + (ctx.milestone ? ` (milestone: **${ctx.milestone}**)` : "") + `.`,
+    `You are running unattended as the **pilot-builder** agent under the pilot subsystem of \`@glrs-dev/harness-plugin-opencode\`. This is task **${task.id}** of the plan **"${ctx.planName}"**` + (ctx.milestone ? ` (milestone: **${ctx.milestone}**)` : "") + `.`,
     ``,
     `## Workspace`,
     ``,
@@ -2862,6 +2864,8 @@ async function runWorker(deps) {
   const attempted = [];
   const maxAttempts = deps.maxAttempts ?? 3;
   const stallMs = deps.stallMs ?? 60 * 60 * 1e3;
+  let setupAborted = false;
+  const depsWithAbort = deps;
   while (true) {
     if (deps.abortSignal?.aborted) {
       return { aborted: true, attempted };
@@ -2871,7 +2875,10 @@ async function runWorker(deps) {
       return { aborted: false, attempted };
     }
     attempted.push(pick.task.id);
-    await runOneTask(deps, pick.task, { maxAttempts, stallMs });
+    await runOneTask(depsWithAbort, pick.task, { maxAttempts, stallMs });
+    if (depsWithAbort.setupAborted) {
+      return { aborted: false, attempted };
+    }
     const row = getTask(deps.db, deps.runId, pick.task.id);
     if (row && (row.status === "failed" || row.status === "aborted")) {
       const blocked = deps.scheduler.cascadeFail(
@@ -2957,6 +2964,78 @@ async function runOneTask(deps, task, opts) {
     });
     return;
   }
+  const setupCommands = deps.plan.setup ?? [];
+  if (setupCommands.length > 0 && !slot.setupCompleted) {
+    const setupStart = Date.now();
+    appendEvent(deps.db, {
+      runId: deps.runId,
+      taskId: task.id,
+      kind: "slot.setup.started",
+      payload: {
+        slotIndex: slot.index,
+        commands: deps.plan.setup,
+        taskId: task.id
+      }
+    });
+    const setupResult = await runVerify(setupCommands, {
+      cwd: prepared.path,
+      abortSignal: deps.abortSignal,
+      onLine: deps.onVerifyLine
+    });
+    if (!setupResult.ok) {
+      const durationMs = Date.now() - setupStart;
+      const failure = setupResult.failure;
+      const reason2 = `setup failed: ${failure.command} \u2192 exit ${failure.exitCode}`;
+      appendEvent(deps.db, {
+        runId: deps.runId,
+        taskId: task.id,
+        kind: "slot.setup.failed",
+        payload: {
+          slotIndex: slot.index,
+          command: failure.command,
+          exitCode: failure.exitCode,
+          output: failure.output.slice(0, 4096),
+          // truncate
+          durationMs
+        }
+      });
+      deps.pool.preserveOnFailure(slot);
+      markFailedSafe(deps.db, deps.runId, task.id, reason2);
+      const blocked = new Set(
+        deps.scheduler.cascadeFail(task.id, reason2)
+      );
+      for (const row of listTasks(deps.db, deps.runId)) {
+        if (row.task_id === task.id) continue;
+        if (blocked.has(row.task_id)) continue;
+        if (row.status !== "pending" && row.status !== "ready") continue;
+        try {
+          markBlocked(deps.db, deps.runId, row.task_id, reason2);
+          blocked.add(row.task_id);
+        } catch {
+        }
+      }
+      for (const blockedId of blocked) {
+        appendEvent(deps.db, {
+          runId: deps.runId,
+          taskId: blockedId,
+          kind: "task.blocked",
+          payload: { reason: reason2, failedDep: task.id }
+        });
+      }
+      deps.setupAborted = true;
+      return;
+    }
+    slot.setupCompleted = true;
+    appendEvent(deps.db, {
+      runId: deps.runId,
+      taskId: task.id,
+      kind: "slot.setup.completed",
+      payload: {
+        slotIndex: slot.index,
+        durationMs: Date.now() - setupStart
+      }
+    });
+  }
   let sessionId;
   try {
     const created = await deps.client.session.create({
@@ -3831,7 +3910,7 @@ function startStreamingLogger(args) {
         );
         if (id !== null) {
           writeRaw(
-            `  run \`bunx @glrs-dev/harness-opencode pilot logs ${id} --run ${runId}\` for full logs`
+            `  run \`bunx @glrs-dev/harness-plugin-opencode pilot logs ${id} --run ${runId}\` for full logs`
           );
         }
         break;
@@ -3846,7 +3925,7 @@ function startStreamingLogger(args) {
         write(`task.stopped ${id ?? "?"} ${suffix}`);
         if (id !== null) {
           writeRaw(
-            `  run \`bunx @glrs-dev/harness-opencode pilot logs ${id} --run ${runId}\` for full logs`
+            `  run \`bunx @glrs-dev/harness-plugin-opencode pilot logs ${id} --run ${runId}\` for full logs`
           );
         }
         break;
@@ -3974,8 +4053,8 @@ Failed tasks (${failed.length}):
   process.stdout.write(
     `  plan: ${planPath}
   run dir: ${runDir}
-  status: bunx @glrs-dev/harness-opencode pilot status --run ${runId}
-  logs:   bunx @glrs-dev/harness-opencode pilot logs --run ${runId} <task-id>
+  status: bunx @glrs-dev/harness-plugin-opencode pilot status --run ${runId}
+  logs:   bunx @glrs-dev/harness-plugin-opencode pilot logs --run ${runId} <task-id>
 `
   );
 }
@@ -4793,7 +4872,7 @@ import * as path12 from "path";
 import * as os5 from "os";
 import { spawn as spawn3 } from "child_process";
 import { fileURLToPath as fileURLToPath2 } from "url";
-var PACKAGE_NAME = "@glrs-dev/harness-opencode";
+var PACKAGE_NAME = "@glrs-dev/harness-plugin-opencode";
 var CHECK_INTERVAL_MS = 24 * 60 * 60 * 1e3;
 var c = {
   reset: "\x1B[0m",
@@ -4973,7 +5052,7 @@ Upgrade Node or run via a compatible Bun runtime. See the "engines" field in pac
 var VERSION = "0.1.0";
 var installCmd = command11({
   name: "install",
-  description: 'Add "@glrs-dev/harness-opencode" to your opencode.json plugin array.',
+  description: 'Add "@glrs-dev/harness-plugin-opencode" to your opencode.json plugin array.',
   args: {
     dryRun: flag8({
       long: "dry-run",
@@ -4990,7 +5069,7 @@ var installCmd = command11({
 });
 var uninstallCmd = command11({
   name: "uninstall",
-  description: 'Remove "@glrs-dev/harness-opencode" from your opencode.json plugin array.',
+  description: 'Remove "@glrs-dev/harness-plugin-opencode" from your opencode.json plugin array.',
   args: {
     dryRun: flag8({
       long: "dry-run",
@@ -5062,7 +5141,7 @@ var planDirCmd2 = command11({
 });
 var installPluginCmd = command11({
   name: "install-plugin",
-  description: 'Add "@glrs-dev/harness-opencode" to your opencode.json plugin array.',
+  description: 'Add "@glrs-dev/harness-plugin-opencode" to your opencode.json plugin array.',
   args: {
     dryRun: flag8({
       long: "dry-run",

package/dist/vendor/harness-opencode/dist/index.d.ts

@@ -1,7 +1,7 @@
 import { Plugin } from '@opencode-ai/plugin';
 
 /**
- * @glrs-dev/harness-opencode — OpenCode plugin entry point.
+ * @glrs-dev/harness-plugin-opencode — OpenCode plugin entry point.
  *
  * Registers agents, commands, MCPs, tools, and skills at runtime via the
  * OpenCode plugin `config` hook. Zero filesystem writes to user space.

package/dist/vendor/harness-opencode/dist/index.js

@@ -3,12 +3,12 @@ import {
   createAgents,
   formatModelOverrideWarning,
   validateModelOverride
-} from "./chunk-BDFZGIY7.js";
+} from "./chunk-CZMAJISX.js";
 import {
   PACKAGE_NAME,
   readOurPackageVersion,
   refreshPluginCache
-} from "./chunk-UDB4NQ2R.js";
+} from "./chunk-VJUETC6A.js";
 
 // src/config-hook.ts
 import * as fs from "fs";
@@ -85,7 +85,7 @@ function createMcpConfig() {
     // Use node's require.resolve to find the bundled launcher inside the
     // installed package, then exec it. Works because the MCP command runs
     // in a CJS-compatible shell context.
-    `exec bash "$(node -e 'process.stdout.write(require.resolve("@glrs-dev/harness-opencode/dist/bin/memory-mcp-launcher.sh"))')"`
+    `exec bash "$(node -e 'process.stdout.write(require.resolve("@glrs-dev/harness-plugin-opencode/dist/bin/memory-mcp-launcher.sh"))')"`
   ];
   return {
     serena: {
@@ -1849,8 +1849,8 @@ import { mkdirSync as mkdirSync3, readFileSync as readFileSync3, writeFileSync a
 import { join as join8 } from "path";
 var APP_KEY = "A-US-3617699429";
 var ENDPOINT = "https://us.aptabase.com/api/v0/event";
-var PKG_NAME = "@glrs-dev/harness-opencode";
-var PKG_VERSION = true ? "1.0.0" : "dev";
+var PKG_NAME = "@glrs-dev/harness-plugin-opencode";
+var PKG_VERSION = true ? "0.3.1" : "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/vendor/harness-opencode/dist/install-X5KEANRB.js

@@ -0,0 +1,13 @@
+import {
+  MODEL_PRESETS,
+  install,
+  writeMcpToggles,
+  writePluginOption
+} from "./chunk-WBBN7OVN.js";
+import "./chunk-VJUETC6A.js";
+export {
+  MODEL_PRESETS,
+  install,
+  writeMcpToggles,
+  writePluginOption
+};

package/dist/vendor/harness-opencode/dist/skills/pilot-planning/SKILL.md

@@ -11,7 +11,7 @@ A good plan trades a planning-session's worth of patient thought for hours of un
 
 ## Workflow
 
-Apply these eight rules in order. Each rule has its own file in `rules/` for the full text:
+Apply these ten rules in order. Each rule has its own file in `rules/` for the full text:
 
 1. [`first-principles.md`](rules/first-principles.md) — Frame the task FROM the user's intent, not from a templated checklist. Ask "what does the user actually want done?" before "what files might change?"
 
@@ -29,11 +29,15 @@ Apply these eight rules in order. Each rule has its own file in `rules/` for the
 
 8. [`task-context.md`](rules/task-context.md) — Every non-trivial task carries a `context:` block. Thin plans fail because the builder works each task from scratch with no carry-over; rich context pre-loads what the builder needs to work confidently. Cover outcome, rationale, code pointers, acceptance.
 
+9. [`setup-authoring.md`](rules/setup-authoring.md) — Detect → propose → confirm the top-level `setup:` block. Covers package manager install, docker-compose services, and migration tooling detection.
+
+10. [`qa-expectations.md`](rules/qa-expectations.md) — Detect → propose → confirm per-surface verify patterns for UI, API, DB, integration, browser-based component, and CLI surfaces.
+
 ## After applying the rules
 
-1. Save the YAML to the path returned by `bunx @glrs-dev/harness-opencode pilot plan-dir`.
-2. Run `bunx @glrs-dev/harness-opencode pilot validate <path>` and fix every error / warning.
-3. Hand off to the user with: `Plan saved to <path>. Next: bunx @glrs-dev/harness-opencode pilot build`.
+1. Save the YAML to the path returned by `bunx @glrs-dev/harness-plugin-opencode pilot plan-dir`.
+2. Run `bunx @glrs-dev/harness-plugin-opencode pilot validate <path>` and fix every error / warning.
+3. Hand off to the user with: `Plan saved to <path>. Next: bunx @glrs-dev/harness-plugin-opencode pilot build`.
 
 Do NOT summarize the plan in chat. The user can read the YAML.