opencode-swarm 7.65.3 → 7.66.1

package/.opencode/skills/brainstorm/SKILL.md

@@ -78,6 +78,7 @@ Present the eleven gates with their defaults (DEFAULT_QA_GATES), parallel coder
 Additionally, present these two sub-items as part of the same exchange:
 - Parallel coders (default: 1, range: 1-4) -- how many coders should run in parallel.
 - Commit frequency (default: phase-level only) -- optional per-task checkpoint commit after each task completion.
+- auto_proceed (boolean, default: false) -- when true, auto-advance to the next phase without asking "Ready for Phase N+1?"; runtime toggle via /swarm auto-proceed on|off.
 
 The user answers all three (gates, parallel coders, commit frequency) in one exchange. Wait for the user's response.
 

package/.opencode/skills/phase-wrap/SKILL.md

@@ -117,7 +117,14 @@ The tool will automatically write the retrospective to \`.swarm/evidence/retro-{
    6. Do NOT call `phase_complete` or `/swarm close` until `.swarm/evidence/final-council.json` exists with an approved, plan-bound, quorumed final-council verdict. When `final_council` is enabled, `phase_complete` will block until that evidence exists.
    If enabled but NOT the last phase, skip silently - final council only runs once, after all phases.
 6. Summarize to user
-7. Ask: "Ready for Phase [N+1]?"
+7. Check the AUTO_PROCEED STATUS banner (injected into your context by the system-enhancer). The banner shows:
+   - `auto-proceed: <on|off>` — the current effective value
+   - `source: <session|plan-or-default>` — which side it came from
+   - `nudge: <true|false>` — whether the FR-004 first-boundary nudge has already been done
+   Then branch:
+   - If `auto-proceed: on`: call `phase_complete`, then advance to the first task of the next phase. Do NOT ask the user.
+   - If `auto-proceed: off` AND `nudge: false`: after the user confirms the phase transition, suggest enabling auto-proceed. Use the swarm_command tool to record the user's answer: `swarm_command({ command: "auto-proceed", args: ["on"] })` for yes, `swarm_command({ command: "auto-proceed", args: ["off"] })` for no. Either call sets nudge to true and prevents re-nudging.
+   - If `auto-proceed: off` AND `nudge: true`: Ask "Ready for Phase [N+1]?" and wait for user confirmation before proceeding.
 
 CATASTROPHIC VIOLATION CHECK — ask yourself at EVERY phase boundary (MODE: PHASE-WRAP):
 "Have I delegated to the active swarm's reviewer agent at least once this phase?"

package/.opencode/skills/specify/SKILL.md

@@ -49,6 +49,7 @@ Present the eleven gates with their defaults (DEFAULT_QA_GATES), parallel coder
 Additionally, present these two sub-items as part of the same exchange:
 - Parallel coders (default: 1, range: 1-4) -- how many coders should run in parallel.
 - Commit frequency (default: phase-level only) -- optional per-task checkpoint commit after each task completion.
+- auto_proceed (boolean, default: false) -- when true, auto-advance to the next phase without asking "Ready for Phase N+1?"; runtime toggle via /swarm auto-proceed on|off.
 
 The user answers all three (gates, parallel coders, commit frequency) in one exchange. Wait for the user's response.
 

package/.opencode/skills/swarm-pr-feedback/SKILL.md

@@ -5,6 +5,8 @@ description: >
   Use when addressing pasted PR feedback, GitHub review comments or threads,
   requested changes, CI/check failures, merge conflicts, stale PR branches, or
   PR follow-up work that must close all known issues without dropping findings.
+  Supports multi-round bot reviews (the repository's bot posts a new review
+  after every push) via the iterative pattern documented in the body.
 ---
 
 # Swarm PR Feedback
@@ -14,6 +16,51 @@ Use this skill to close known PR feedback. This is not a fresh broad PR review.
 feedback surfaces, verifies each claim, clusters related problems, fixes confirmed
 issues, validates the branch, and reports closure status for every item.
 
+## Multi-Round Bot Reviews (Iterative Pattern)
+
+The repository's bot reviewer (`hermes-pr-review` / Qwen3.6 + Gemma-4 dual-model)
+posts a new review comment after **every push** to the PR branch, not just the
+final state. Expect N rounds of review for N pushes, and budget for it.
+
+**Round N+1 deltas vs Round N:**
+- Fresh `FB-###` ledger IDs for new findings (do not reuse IDs from earlier rounds)
+- Findings from prior rounds that remain unfixed will reappear with the same evidence
+- Findings you marked DISPROVED with new evidence may reappear if the bot disagrees
+- New findings may be introduced that the prior round did not see (the bot's read scope
+  is the new commit, not the full diff history)
+
+**Operating principles for multi-round triage:**
+
+1. **Continue the ledger, do not start over.** Append to the same `FB-###` counter
+   across rounds. Track each finding's state per round (open, fixed, disproved,
+   awaiting-decision, repeated).
+2. **Carry forward unresolved items.** Findings you marked `PARTIAL` or `NEEDS_USER_DECISION`
+   in round N will still be open in round N+1. The closure ledger should show their
+   evolution (e.g., "PARTIAL round 1 → CONFIRMED round 2 after evidence collected").
+3. **Apply the 3-strikes-then-defense-in-depth rule.** When the same finding is
+   raised 3+ times across rounds, prefer to add the suggested code change with a
+   defense-in-depth rationale comment rather than continue to debate. One extra
+   condition is cheap; per-round debate is expensive. Document the parent-vs-inner
+   relationship inline so future readers see the rationale.
+4. **Verify bot fix-direction suggestions against actual file structure.** Bots
+   read files linearly and can miss parent-block guards. For any "add an X check"
+   suggestion, read the surrounding function/block to confirm the check is genuinely
+   missing or already exists at a higher scope.
+5. **Each round produces its own closure ledger as a PR comment.** Prefix with
+   "Round N" so the bot and reviewers can see progression. Maintain a running
+   summary table at the end of each comment showing totals across rounds
+   (confirmed+fixed / disproved / partial / awaiting-decision).
+6. **Stop the cycle deliberately.** If a finding is disproved with code evidence 3+
+   times and the bot keeps re-raising it, leave the comment, post the closure
+   ledger with the cumulative evidence, and surface the disagreement to the user
+   rather than continuing to push fixes. The user can resolve persistent
+   reviewer-AI disagreement.
+
+**Why this matters:** Without the multi-round pattern, each round looks like
+"start over, re-triage everything." With it, the rounds become incremental:
+each round's work is bounded by new findings + carried-forward items only.
+This matches how the bot actually behaves and avoids wasted cycles.
+
 ## Operating Stance
 
 Treat every review comment, CI failure, bot summary, PR body claim, and pasted note

package/README.md

@@ -134,6 +134,8 @@ Swarm has two independent mode systems:
 | **Lean Turbo** | High | Fast | Parallel lanes for non-conflicting tasks (up to `max_parallel_coders` coders) |
 | **Full-Auto** | Deterministic policy + critic oversight | Fast | Unattended multi-interaction runs |
 
+**Auto-proceed** — a session toggle (`/swarm auto-proceed [on|off]`) that skips the "Ready for Phase N+1?" prompt at phase boundaries. Defaults to `false`; set as a plan default via `execution_profile.auto_proceed` during QA GATE SELECTION. Session override always wins. Independent of Full-Auto.
+
 Full-Auto reduces approval friction by deterministically allowing safe operations (read-only tools, in-scope writes, safe shell) and routing every ambiguous or high-risk action (writes to plugin/build/guardrail paths, network, dependency changes, plan/phase mutations, subagent delegation) through the read-only `critic_oversight` agent before it executes. Denials are returned to the agent as structured signals so it can choose a safer path; repeated denials pause the run; phase completion requires an APPROVED oversight record. See [docs/modes.md](docs/modes.md#full-auto) for `mode`, `permission_policy`, `denials`, and `oversight` config keys, fail-closed semantics, and recovery from a paused run.
 
 **Project mode** — persistent via `execution_mode` config key:
@@ -144,7 +146,7 @@ Full-Auto reduces approval friction by deterministically allowing safe operation
 | `balanced` (default) | Standard hooks |
 | `fast` | Skips compaction service — for short sessions under context pressure |
 
-Switch session modes with `/swarm turbo [on|off]` or `/swarm full-auto [on|off]`. Set project mode in config. Lean Turbo is configured in `turbo.lean.*` in config and composes with all session modes. See [docs/modes.md](docs/modes.md).
+Switch session modes with `/swarm turbo [on|off]` or `/swarm full-auto [on|off]`. Control phase-boundary auto-proceed with `/swarm auto-proceed [on|off]`. Set project mode in config. Lean Turbo is configured in `turbo.lean.*` in config and composes with all session modes. See [docs/modes.md](docs/modes.md).
 
 ---
 

package/dist/cli/index.js

@@ -52,7 +52,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "opencode-swarm",
-    version: "7.65.3",
+    version: "7.66.1",
     description: "Architect-centric agentic swarm plugin for OpenCode - hub-and-spoke orchestration with SME consultation, code generation, and QA review",
     main: "dist/index.js",
     types: "dist/index.d.ts",
@@ -14700,7 +14700,8 @@ var init_plan_schema = __esm(() => {
     parallelization_enabled: exports_external.boolean().default(false),
     max_concurrent_tasks: exports_external.number().int().min(1).max(64).default(1),
     council_parallel: exports_external.boolean().default(false),
-    locked: exports_external.boolean().default(false)
+    locked: exports_external.boolean().default(false),
+    auto_proceed: exports_external.boolean().default(false)
   });
   TaskStatusSchema = exports_external.enum([
     "pending",
@@ -22753,6 +22754,45 @@ var init_state = __esm(() => {
   };
 });
 
+// src/commands/auto-proceed.ts
+async function handleAutoProceedCommand(_directory, args, sessionID) {
+  if (!sessionID || sessionID.trim() === "") {
+    return "Error: No active session context. Auto-proceed requires an active session. Use /swarm auto-proceed from within an OpenCode session, or start a session first.";
+  }
+  const session = getAgentSession(sessionID);
+  if (!session) {
+    return "Error: No active session. Auto-proceed requires an active session to operate.";
+  }
+  if (stripKnownSwarmPrefix(session.agentName) !== "architect") {
+    return `Error: Auto-proceed can only be toggled from the architect session. Currently active session is: ${session.agentName}`;
+  }
+  const arg = args[0]?.toLowerCase();
+  const wasUndefinedBefore = session.autoProceedOverride === undefined;
+  let newAutoProceedOverride;
+  if (arg === "on") {
+    newAutoProceedOverride = true;
+  } else if (arg === "off") {
+    newAutoProceedOverride = false;
+  } else if (arg === undefined) {
+    newAutoProceedOverride = !session.autoProceedOverride;
+  } else {
+    return 'Error: Invalid argument for /swarm auto-proceed. Valid options: "on", "off", or omit the argument to toggle.';
+  }
+  session.autoProceedOverride = newAutoProceedOverride;
+  if (arg === "on" || arg === "off" || arg === undefined && wasUndefinedBefore) {
+    session.autoProceedNudgeDone = true;
+  }
+  if (newAutoProceedOverride) {
+    return "Auto-proceed is now ON. Phase boundaries will advance automatically.";
+  } else {
+    return "Auto-proceed is now OFF. You will be asked before advancing to the next phase.";
+  }
+}
+var init_auto_proceed = __esm(() => {
+  init_schema();
+  init_state();
+});
+
 // src/commands/benchmark.ts
 async function handleBenchmarkCommand(directory, args) {
   let cumulative = args.includes("--cumulative");
@@ -48893,6 +48933,12 @@ function serializeAgentSession(s) {
     ...Object.keys(stageBCompletion).length > 0 && { stageBCompletion },
     ...s.maxConcurrencyOverride !== undefined && {
       maxConcurrencyOverride: s.maxConcurrencyOverride
+    },
+    ...s.autoProceedOverride !== undefined && {
+      autoProceedOverride: s.autoProceedOverride
+    },
+    ...s.autoProceedNudgeDone !== undefined && {
+      autoProceedNudgeDone: s.autoProceedNudgeDone
     }
   };
 }
@@ -56263,8 +56309,20 @@ import * as fs24 from "fs";
 import * as path50 from "path";
 function resolveWorkingDirectory(workingDirectory, fallbackDirectory) {
   if (workingDirectory == null || workingDirectory === "") {
+    if (typeof fallbackDirectory !== "string" || fallbackDirectory === "") {
+      return {
+        success: false,
+        message: "Invalid working_directory: no explicit working_directory was provided and fallbackDirectory is missing or not a string"
+      };
+    }
     return { success: true, directory: fallbackDirectory };
   }
+  if (typeof workingDirectory !== "string") {
+    return {
+      success: false,
+      message: "Invalid working_directory: path must be a string"
+    };
+  }
   if (workingDirectory.includes("\x00")) {
     return {
       success: false,
@@ -56280,14 +56338,14 @@ function resolveWorkingDirectory(workingDirectory, fallbackDirectory) {
       };
     }
   }
-  const normalizedDir = path50.normalize(workingDirectory);
-  const pathParts = normalizedDir.split(path50.sep);
-  if (pathParts.includes("..")) {
+  const rawPathParts = workingDirectory.split(path50.sep);
+  if (rawPathParts.includes("..")) {
     return {
       success: false,
       message: "Invalid working_directory: path traversal sequences (..) are not allowed"
     };
   }
+  const normalizedDir = path50.normalize(workingDirectory);
   const resolvedDir = path50.resolve(normalizedDir);
   let statResult;
   try {
@@ -56304,6 +56362,9 @@ function resolveWorkingDirectory(workingDirectory, fallbackDirectory) {
       message: `Invalid working_directory: path "${resolvedDir}" is not a directory`
     };
   }
+  if (typeof fallbackDirectory !== "string" || fallbackDirectory === "") {
+    return { success: true, directory: resolvedDir };
+  }
   const resolvedFallback = path50.resolve(fallbackDirectory);
   let fallbackExists = false;
   try {
@@ -56312,23 +56373,14 @@ function resolveWorkingDirectory(workingDirectory, fallbackDirectory) {
   } catch {
     fallbackExists = false;
   }
-  if (workingDirectory != null && workingDirectory !== "") {
-    if (fallbackExists) {
-      const isSubdirectory = resolvedDir.startsWith(resolvedFallback + path50.sep);
-      if (isSubdirectory) {
-        return {
-          success: false,
-          message: `Invalid working_directory: "${workingDirectory}" resolves to "${resolvedDir}" ` + `which is a subdirectory of fallback "${resolvedFallback}". ` + `Pass the project root path or omit working_directory entirely.`
-        };
-      }
+  if (fallbackExists) {
+    const isSubdirectory = resolvedDir.startsWith(resolvedFallback + path50.sep);
+    if (isSubdirectory) {
+      return {
+        success: false,
+        message: `Invalid working_directory: "${workingDirectory}" resolves to "${resolvedDir}" ` + `which is a subdirectory of fallback "${resolvedFallback}". ` + `Pass the project root path or omit working_directory entirely.`
+      };
     }
-    return { success: true, directory: resolvedDir };
-  }
-  if (resolvedDir !== resolvedFallback) {
-    return {
-      success: false,
-      message: `Invalid working_directory: path resolves to "${resolvedDir}" but fallbackDirectory ` + `"${resolvedFallback}" is not the project root. ` + `This may indicate CWD mismatch. Pass the project root path explicitly.`
-    };
   }
   return { success: true, directory: resolvedDir };
 }
@@ -61755,7 +61807,8 @@ var init_tool_policy = __esm(() => {
     "sdd validate",
     "sdd project",
     "sync-plan",
-    "export"
+    "export",
+    "auto-proceed"
   ];
   SWARM_COMMAND_TOOL_ALLOWLIST = new Set([
     "agents",
@@ -61784,7 +61837,8 @@ var init_tool_policy = __esm(() => {
     "sdd status",
     "sdd validate",
     "sync-plan",
-    "export"
+    "export",
+    "auto-proceed"
   ]);
   HUMAN_ONLY_SWARM_COMMANDS = new Set([
     "acknowledge-spec-drift",
@@ -61878,6 +61932,7 @@ __export(exports_commands, {
   handleCheckpointCommand: () => handleCheckpointCommand,
   handleBrainstormCommand: () => handleBrainstormCommand,
   handleBenchmarkCommand: () => handleBenchmarkCommand,
+  handleAutoProceedCommand: () => handleAutoProceedCommand,
   handleArchiveCommand: () => handleArchiveCommand,
   handleAnalyzeCommand: () => handleAnalyzeCommand,
   handleAgentsCommand: () => handleAgentsCommand,
@@ -62130,6 +62185,7 @@ var init_commands = __esm(() => {
   init_acknowledge_spec_drift();
   init_agents();
   init_archive();
+  init_auto_proceed();
   init_benchmark();
   init_checkpoint2();
   init_close();
@@ -62362,6 +62418,7 @@ var init_registry = __esm(() => {
   init_acknowledge_spec_drift();
   init_agents();
   init_archive();
+  init_auto_proceed();
   init_benchmark();
   init_checkpoint2();
   init_close();
@@ -62839,6 +62896,13 @@ Subcommands:
       details: 'Toggles Full-Auto Mode which enables autonomous execution without confirmation prompts. When enabled, the architect proceeds through implementation steps automatically. Session-scoped \u2014 resets on new session. Use "on" or "off" to set explicitly, or toggle with no argument.',
       category: "utility"
     },
+    "auto-proceed": {
+      handler: (ctx) => handleAutoProceedCommand(ctx.directory, ctx.args, ctx.sessionID),
+      description: "Toggle or set auto-proceed override for the active session",
+      args: "[on|off]",
+      category: "config",
+      details: 'Without argument, toggles auto-proceed mode. With "on" or "off", sets the state explicitly.'
+    },
     "write-retro": {
       handler: (ctx) => handleWriteRetroCommand(ctx.directory, ctx.args),
       description: "Write a retrospective evidence bundle for a completed phase <json>",

package/dist/commands/auto-proceed.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Handles the /swarm auto-proceed command.
+ * Sets or toggles the auto-proceed override for the active session.
+ *
+ * Unlike full-auto, this command has no config-level enablement requirement,
+ * no durable state, and no v2 oversight infrastructure.
+ *
+ * @param directory - Project directory (accepted for signature consistency with other command handlers; unused)
+ * @param args - Optional argument: "on" | "off" | undefined (toggle behavior)
+ * @param sessionID - Session ID for accessing active session state
+ * @returns Feedback message about auto-proceed override state
+ */
+export declare function handleAutoProceedCommand(_directory: string, args: string[], sessionID: string): Promise<string>;

package/dist/commands/index.d.ts

@@ -3,6 +3,7 @@ export { handleAcknowledgeSpecDriftCommand } from './acknowledge-spec-drift';
 export { handleAgentsCommand } from './agents';
 export { handleAnalyzeCommand } from './analyze';
 export { handleArchiveCommand } from './archive';
+export { handleAutoProceedCommand } from './auto-proceed';
 export { handleBenchmarkCommand } from './benchmark';
 export { handleBrainstormCommand } from './brainstorm';
 export { handleCheckpointCommand } from './checkpoint';

package/dist/commands/registry.d.ts

@@ -457,6 +457,13 @@ export declare const COMMAND_REGISTRY: {
         readonly details: "Toggles Full-Auto Mode which enables autonomous execution without confirmation prompts. When enabled, the architect proceeds through implementation steps automatically. Session-scoped — resets on new session. Use \"on\" or \"off\" to set explicitly, or toggle with no argument.";
         readonly category: "utility";
     };
+    readonly 'auto-proceed': {
+        readonly handler: (ctx: CommandContext) => Promise<string>;
+        readonly description: "Toggle or set auto-proceed override for the active session";
+        readonly args: "[on|off]";
+        readonly category: "config";
+        readonly details: "Without argument, toggles auto-proceed mode. With \"on\" or \"off\", sets the state explicitly.";
+    };
     readonly 'write-retro': {
         readonly handler: (ctx: CommandContext) => Promise<string>;
         readonly description: "Write a retrospective evidence bundle for a completed phase <json>";

package/dist/commands/tool-policy.d.ts

@@ -1,5 +1,5 @@
 import type { ResolvedSwarmCommand, SwarmCommandPolicyResult } from './command-dispatch.js';
-export declare const SWARM_COMMAND_TOOL_COMMANDS: readonly ["agents", "config", "config doctor", "doctor tools", "status", "show-plan", "help", "history", "evidence", "evidence summary", "retrieve", "diagnose", "preflight", "benchmark", "knowledge", "memory", "memory status", "memory pending", "memory recall-log", "memory compact", "memory stale", "memory export", "memory evaluate", "memory import", "memory migrate", "sdd", "sdd status", "sdd validate", "sdd project", "sync-plan", "export"];
+export declare const SWARM_COMMAND_TOOL_COMMANDS: readonly ["agents", "config", "config doctor", "doctor tools", "status", "show-plan", "help", "history", "evidence", "evidence summary", "retrieve", "diagnose", "preflight", "benchmark", "knowledge", "memory", "memory status", "memory pending", "memory recall-log", "memory compact", "memory stale", "memory export", "memory evaluate", "memory import", "memory migrate", "sdd", "sdd status", "sdd validate", "sdd project", "sync-plan", "export", "auto-proceed"];
 export type SwarmCommandToolInputCommand = (typeof SWARM_COMMAND_TOOL_COMMANDS)[number];
 export declare const SWARM_COMMAND_TOOL_ALLOWLIST: Set<string>;
 /**

package/dist/config/constants.d.ts

@@ -73,8 +73,10 @@ export declare const COMPACTION_DEFAULTS: {
 };
 export declare const TURBO_MODE_BANNER = "## \uD83D\uDE80 TURBO MODE ACTIVE\n\n**Speed optimization enabled for this session.**\n\nWhile Turbo Mode is active:\n- **Stage A gates** (lint, imports, pre_check_batch) are still REQUIRED for ALL tasks\n- **Tier 3 tasks** (security-sensitive files matching: architect*.ts, delegation*.ts, guardrails*.ts, adversarial*.ts, sanitiz*.ts, auth*, permission*, crypto*, secret*, security) still require FULL review (Stage B)\n- **Tier 0-2 tasks** can skip Stage B (reviewer, test_engineer) to speed up execution\n- **Phase completion gates** (completion-verify and drift verification gate) are automatically bypassed \u2014 phase_complete will succeed without drift verification evidence when turbo is active. Note: turbo bypass is session-scoped; one session's turbo does not affect other sessions.\n\nClassification still determines the pipeline:\n- TIER 0 (metadata): lint + diff only \u2014 no change\n- TIER 1 (docs): Stage A + reviewer \u2014 no change\n- TIER 2 (standard code): Stage A + reviewer + test_engineer \u2014 CAN SKIP Stage B with turboMode\n- TIER 3 (critical): Stage A + 2x reviewer + 2x test_engineer \u2014 Stage B REQUIRED (no turbo bypass)\n\nDo NOT skip Stage A gates. Do NOT skip Stage B for TIER 3.\n";
 export declare const FULL_AUTO_BANNER = "## \u26A1 FULL-AUTO MODE ACTIVE\n\nYou are operating without a human in the loop. All escalations route to the Autonomous Oversight Critic instead of a user.\n\nBehavioral changes:\n- TIER 3 escalations go to the critic, not a human. Frame your questions technically, not conversationally.\n- Phase completion approval comes from the critic. Ensure all evidence is written before requesting.\n- The critic defaults to REJECT. Do not attempt to pressure, negotiate, or shortcut. Complete the evidence trail.\n- If the critic returns ESCALATE_TO_HUMAN, the session will pause or terminate. Only the critic can trigger this.\n- Do NOT ask \"Ready for Phase N+1?\" \u2014 call phase_complete directly. The critic reviews automatically.\n";
+export declare const AUTO_PROCEED_BANNER = "## \u23ED\uFE0F AUTO-PROCEED STATUS\n\nAuto-proceed controls whether the architect advances to the next phase automatically (skipping the \"Ready for Phase N+1?\" confirmation).\n\nBehavioral rules:\n- Session override (set via /swarm auto-proceed on|off) wins over the plan default.\n- If neither is set, auto-proceed defaults to OFF and the architect asks before advancing.\n- Full-auto mode (critic oversight) is independent \u2014 it has its own auto-advance mechanism.\n- autoProceedNudgeDone prevents the FR-004 first-boundary nudge from re-firing in this session.\n\nTo toggle at runtime: call swarm_command({ command: \"auto-proceed\", args: [\"on\"|\"off\"] }) from the architect.\n";
 /**
  * Canonical default Lean Turbo configuration.
+
  *
  * This is the single source of truth for all LeanTurboConfig fields.
  * Consumers MUST reference this constant instead of hardcoding their own

package/dist/config/plan-schema.d.ts

@@ -4,6 +4,7 @@ export declare const ExecutionProfileSchema: z.ZodObject<{
     max_concurrent_tasks: z.ZodDefault<z.ZodNumber>;
     council_parallel: z.ZodDefault<z.ZodBoolean>;
     locked: z.ZodDefault<z.ZodBoolean>;
+    auto_proceed: z.ZodDefault<z.ZodBoolean>;
 }, z.core.$strip>;
 export type ExecutionProfile = z.infer<typeof ExecutionProfileSchema>;
 export declare const TaskStatusSchema: z.ZodEnum<{
@@ -166,6 +167,7 @@ export declare const PlanSchema: z.ZodObject<{
         max_concurrent_tasks: z.ZodDefault<z.ZodNumber>;
         council_parallel: z.ZodDefault<z.ZodBoolean>;
         locked: z.ZodDefault<z.ZodBoolean>;
+        auto_proceed: z.ZodDefault<z.ZodBoolean>;
     }, z.core.$strip>>;
 }, z.core.$strip>;
 export type Plan = z.infer<typeof PlanSchema>;

package/dist/index.js

@@ -69,7 +69,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "opencode-swarm",
-    version: "7.65.3",
+    version: "7.66.1",
     description: "Architect-centric agentic swarm plugin for OpenCode - hub-and-spoke orchestration with SME consultation, code generation, and QA review",
     main: "dist/index.js",
     types: "dist/index.d.ts",
@@ -851,6 +851,17 @@ Behavioral changes:
 - The critic defaults to REJECT. Do not attempt to pressure, negotiate, or shortcut. Complete the evidence trail.
 - If the critic returns ESCALATE_TO_HUMAN, the session will pause or terminate. Only the critic can trigger this.
 - Do NOT ask "Ready for Phase N+1?" — call phase_complete directly. The critic reviews automatically.
+`, AUTO_PROCEED_BANNER = `## ⏭️ AUTO-PROCEED STATUS
+
+Auto-proceed controls whether the architect advances to the next phase automatically (skipping the "Ready for Phase N+1?" confirmation).
+
+Behavioral rules:
+- Session override (set via /swarm auto-proceed on|off) wins over the plan default.
+- If neither is set, auto-proceed defaults to OFF and the architect asks before advancing.
+- Full-auto mode (critic oversight) is independent — it has its own auto-advance mechanism.
+- autoProceedNudgeDone prevents the FR-004 first-boundary nudge from re-firing in this session.
+
+To toggle at runtime: call swarm_command({ command: "auto-proceed", args: ["on"|"off"] }) from the architect.
 `, DEFAULT_LEAN_TURBO_CONFIG, DEFAULT_WORKTREE_ISOLATION_CONFIG, LEAN_TURBO_BANNER = `## \uD83D\uDEE4️ LEAN TURBO ACTIVE
 
 Lane-based parallel execution is enabled for this phase.
@@ -16568,7 +16579,8 @@ var init_plan_schema = __esm(() => {
     parallelization_enabled: exports_external.boolean().default(false),
     max_concurrent_tasks: exports_external.number().int().min(1).max(64).default(1),
     council_parallel: exports_external.boolean().default(false),
-    locked: exports_external.boolean().default(false)
+    locked: exports_external.boolean().default(false),
+    auto_proceed: exports_external.boolean().default(false)
   });
   TaskStatusSchema = exports_external.enum([
     "pending",
@@ -43164,6 +43176,7 @@ __export(exports_state, {
   getTaskState: () => getTaskState,
   getSessionEnvironment: () => getSessionEnvironment,
   getRunContext: () => getRunContext,
+  getResolvedAutoProceed: () => getResolvedAutoProceed,
   getAgentSession: () => getAgentSession,
   getActiveWindow: () => getActiveWindow,
   ensureSessionEnvironment: () => ensureSessionEnvironment,
@@ -43873,6 +43886,9 @@ function hasActiveLeanTurbo(sessionID) {
   }
   return false;
 }
+function getResolvedAutoProceed(session, planAutoProceed) {
+  return session.autoProceedOverride ?? planAutoProceed ?? false;
+}
 function setSessionEnvironment(sessionId, profile) {
   swarmState.environmentProfiles.set(sessionId, profile);
 }
@@ -43979,6 +43995,45 @@ var init_state = __esm(() => {
   };
 });
 
+// src/commands/auto-proceed.ts
+async function handleAutoProceedCommand(_directory, args2, sessionID) {
+  if (!sessionID || sessionID.trim() === "") {
+    return "Error: No active session context. Auto-proceed requires an active session. Use /swarm auto-proceed from within an OpenCode session, or start a session first.";
+  }
+  const session = getAgentSession(sessionID);
+  if (!session) {
+    return "Error: No active session. Auto-proceed requires an active session to operate.";
+  }
+  if (stripKnownSwarmPrefix(session.agentName) !== "architect") {
+    return `Error: Auto-proceed can only be toggled from the architect session. Currently active session is: ${session.agentName}`;
+  }
+  const arg = args2[0]?.toLowerCase();
+  const wasUndefinedBefore = session.autoProceedOverride === undefined;
+  let newAutoProceedOverride;
+  if (arg === "on") {
+    newAutoProceedOverride = true;
+  } else if (arg === "off") {
+    newAutoProceedOverride = false;
+  } else if (arg === undefined) {
+    newAutoProceedOverride = !session.autoProceedOverride;
+  } else {
+    return 'Error: Invalid argument for /swarm auto-proceed. Valid options: "on", "off", or omit the argument to toggle.';
+  }
+  session.autoProceedOverride = newAutoProceedOverride;
+  if (arg === "on" || arg === "off" || arg === undefined && wasUndefinedBefore) {
+    session.autoProceedNudgeDone = true;
+  }
+  if (newAutoProceedOverride) {
+    return "Auto-proceed is now ON. Phase boundaries will advance automatically.";
+  } else {
+    return "Auto-proceed is now OFF. You will be asked before advancing to the next phase.";
+  }
+}
+var init_auto_proceed = __esm(() => {
+  init_schema();
+  init_state();
+});
+
 // src/commands/benchmark.ts
 async function handleBenchmarkCommand(directory, args2) {
   let cumulative = args2.includes("--cumulative");
@@ -72140,6 +72195,12 @@ function serializeAgentSession(s) {
     ...Object.keys(stageBCompletion).length > 0 && { stageBCompletion },
     ...s.maxConcurrencyOverride !== undefined && {
       maxConcurrencyOverride: s.maxConcurrencyOverride
+    },
+    ...s.autoProceedOverride !== undefined && {
+      autoProceedOverride: s.autoProceedOverride
+    },
+    ...s.autoProceedNudgeDone !== undefined && {
+      autoProceedNudgeDone: s.autoProceedNudgeDone
     }
   };
 }
@@ -80553,8 +80614,20 @@ import * as fs35 from "node:fs";
 import * as path67 from "node:path";
 function resolveWorkingDirectory(workingDirectory, fallbackDirectory) {
   if (workingDirectory == null || workingDirectory === "") {
+    if (typeof fallbackDirectory !== "string" || fallbackDirectory === "") {
+      return {
+        success: false,
+        message: "Invalid working_directory: no explicit working_directory was provided and fallbackDirectory is missing or not a string"
+      };
+    }
     return { success: true, directory: fallbackDirectory };
   }
+  if (typeof workingDirectory !== "string") {
+    return {
+      success: false,
+      message: "Invalid working_directory: path must be a string"
+    };
+  }
   if (workingDirectory.includes("\x00")) {
     return {
       success: false,
@@ -80570,14 +80643,14 @@ function resolveWorkingDirectory(workingDirectory, fallbackDirectory) {
       };
     }
   }
-  const normalizedDir = path67.normalize(workingDirectory);
-  const pathParts = normalizedDir.split(path67.sep);
-  if (pathParts.includes("..")) {
+  const rawPathParts = workingDirectory.split(path67.sep);
+  if (rawPathParts.includes("..")) {
     return {
       success: false,
       message: "Invalid working_directory: path traversal sequences (..) are not allowed"
     };
   }
+  const normalizedDir = path67.normalize(workingDirectory);
   const resolvedDir = path67.resolve(normalizedDir);
   let statResult;
   try {
@@ -80594,6 +80667,9 @@ function resolveWorkingDirectory(workingDirectory, fallbackDirectory) {
       message: `Invalid working_directory: path "${resolvedDir}" is not a directory`
     };
   }
+  if (typeof fallbackDirectory !== "string" || fallbackDirectory === "") {
+    return { success: true, directory: resolvedDir };
+  }
   const resolvedFallback = path67.resolve(fallbackDirectory);
   let fallbackExists = false;
   try {
@@ -80602,23 +80678,14 @@ function resolveWorkingDirectory(workingDirectory, fallbackDirectory) {
   } catch {
     fallbackExists = false;
   }
-  if (workingDirectory != null && workingDirectory !== "") {
-    if (fallbackExists) {
-      const isSubdirectory = resolvedDir.startsWith(resolvedFallback + path67.sep);
-      if (isSubdirectory) {
-        return {
-          success: false,
-          message: `Invalid working_directory: "${workingDirectory}" resolves to "${resolvedDir}" ` + `which is a subdirectory of fallback "${resolvedFallback}". ` + `Pass the project root path or omit working_directory entirely.`
-        };
-      }
+  if (fallbackExists) {
+    const isSubdirectory = resolvedDir.startsWith(resolvedFallback + path67.sep);
+    if (isSubdirectory) {
+      return {
+        success: false,
+        message: `Invalid working_directory: "${workingDirectory}" resolves to "${resolvedDir}" ` + `which is a subdirectory of fallback "${resolvedFallback}". ` + `Pass the project root path or omit working_directory entirely.`
+      };
     }
-    return { success: true, directory: resolvedDir };
-  }
-  if (resolvedDir !== resolvedFallback) {
-    return {
-      success: false,
-      message: `Invalid working_directory: path resolves to "${resolvedDir}" but fallbackDirectory ` + `"${resolvedFallback}" is not the project root. ` + `This may indicate CWD mismatch. Pass the project root path explicitly.`
-    };
   }
   return { success: true, directory: resolvedDir };
 }
@@ -86457,7 +86524,8 @@ var init_tool_policy = __esm(() => {
     "sdd validate",
     "sdd project",
     "sync-plan",
-    "export"
+    "export",
+    "auto-proceed"
   ];
   SWARM_COMMAND_TOOL_ALLOWLIST = new Set([
     "agents",
@@ -86486,7 +86554,8 @@ var init_tool_policy = __esm(() => {
     "sdd status",
     "sdd validate",
     "sync-plan",
-    "export"
+    "export",
+    "auto-proceed"
   ]);
   HUMAN_ONLY_SWARM_COMMANDS = new Set([
     "acknowledge-spec-drift",
@@ -86580,6 +86649,7 @@ __export(exports_commands, {
   handleCheckpointCommand: () => handleCheckpointCommand,
   handleBrainstormCommand: () => handleBrainstormCommand,
   handleBenchmarkCommand: () => handleBenchmarkCommand,
+  handleAutoProceedCommand: () => handleAutoProceedCommand,
   handleArchiveCommand: () => handleArchiveCommand,
   handleAnalyzeCommand: () => handleAnalyzeCommand,
   handleAgentsCommand: () => handleAgentsCommand,
@@ -86832,6 +86902,7 @@ var init_commands = __esm(() => {
   init_acknowledge_spec_drift();
   init_agents();
   init_archive();
+  init_auto_proceed();
   init_benchmark();
   init_checkpoint2();
   init_close();
@@ -87064,6 +87135,7 @@ var init_registry = __esm(() => {
   init_acknowledge_spec_drift();
   init_agents();
   init_archive();
+  init_auto_proceed();
   init_benchmark();
   init_checkpoint2();
   init_close();
@@ -87541,6 +87613,13 @@ Subcommands:
       details: 'Toggles Full-Auto Mode which enables autonomous execution without confirmation prompts. When enabled, the architect proceeds through implementation steps automatically. Session-scoped — resets on new session. Use "on" or "off" to set explicitly, or toggle with no argument.',
       category: "utility"
     },
+    "auto-proceed": {
+      handler: (ctx) => handleAutoProceedCommand(ctx.directory, ctx.args, ctx.sessionID),
+      description: "Toggle or set auto-proceed override for the active session",
+      args: "[on|off]",
+      category: "config",
+      details: 'Without argument, toggles auto-proceed mode. With "on" or "off", sets the state explicitly.'
+    },
     "write-retro": {
       handler: (ctx) => handleWriteRetroCommand(ctx.directory, ctx.args),
       description: "Write a retrospective evidence bundle for a completed phase <json>",
@@ -89004,6 +89083,9 @@ INLINE GATE SELECTION -- no pending section found in context.md. You MUST ask no
 
 MANDATORY PAUSE: Present the gate question. Wait for the user's answer.
 Do NOT call \`set_qa_gates\` until the user has responded.
+
+Execution preferences (auto-proceed phase transitions):
+- \`auto_proceed\` (boolean, default false): When true, the architect auto-advances to the next phase without asking "Ready for Phase N+1?". Runtime toggle via /swarm auto-proceed on|off.
 <!-- BEHAVIORAL_GUIDANCE_END -->
 - Preserve task granularity, test task deduplication, phase count guidance, and TRACEABILITY CHECK rules from the loaded skill.
 
@@ -89049,6 +89131,17 @@ ACTION: Load skill file:.opencode/skills/phase-wrap/SKILL.md immediately. Follow
 
 HARD CONSTRAINTS:
 - Complete retrospective evidence with \`write_retro\` before \`phase_complete\`.
+- Before step 7 (phase transition): read the AUTO_PROCEED STATUS banner injected into your context. The banner tells you:
+  - auto-proceed state (on/off)
+  - source (session override vs plan-or-default)
+  - nudge flag (true if user has already been asked or has explicitly toggled)
+- If auto-proceed is ON (banner shows "on"): call \`phase_complete\`, then advance to the first task of the next phase. Do NOT ask the user.
+- If auto-proceed is OFF (banner shows "off") AND nudge flag is false: after the user confirms the phase transition, suggest enabling auto-proceed with: "Auto-proceed is currently disabled. Would you like me to automatically advance to future phases without asking?" Then:
+  - On YES: call \`swarm_command({ command: "auto-proceed", args: ["on"] })\` — this sets both override and nudge-done
+  - On NO: call \`swarm_command({ command: "auto-proceed", args: ["off"] })\` — this sets override=false and nudge-done=true
+- If auto-proceed is OFF AND nudge flag is true: just ask "Ready for Phase [N+1]?" as before.
+- SC-001: auto-proceed only skips the phase-transition confirmation. The architect MUST still stop for blocked tasks, user questions, clarification needs, and any decision requiring human input. This behavior is NOT affected by the auto_proceed setting.
+- Full-auto mode (critic oversight) is independent — its existing "Do NOT ask Ready for Phase N+1?" override continues to work. auto_proceed has no additional effect under full-auto.
 
 > **NOTE**: The \`critic_oversight\` agent (\`AUTONOMOUS_OVERSIGHT_PROMPT\`) is dispatched only via full-auto mode (\`src/full-auto/oversight.ts\`). It has no architect MODE dispatch path — it is **NOT** reachable from \`MODE: CRITIC-GATE\`, \`MODE: EXECUTE\`, or \`MODE: PHASE-WRAP\`. This is intentional: it serves as the sole quality gate in autonomous oversight mode.
 
@@ -97920,7 +98013,7 @@ var init_design_doc_drift = __esm(() => {
 var exports_project_context = {};
 __export(exports_project_context, {
   buildProjectContext: () => buildProjectContext,
-  _internals: () => _internals90,
+  _internals: () => _internals91,
   LANG_BACKEND_DETECTION_TIMEOUT_MS: () => LANG_BACKEND_DETECTION_TIMEOUT_MS
 });
 import * as fs135 from "node:fs";
@@ -98004,7 +98097,7 @@ function selectLintCommand(backend, directory) {
   return null;
 }
 async function buildProjectContext(directory) {
-  const backend = await _internals90.pickBackend(directory);
+  const backend = await _internals91.pickBackend(directory);
   if (!backend)
     return null;
   const ctx = emptyProjectContext();
@@ -98043,17 +98136,17 @@ async function buildProjectContext(directory) {
   if (backend.prompts.reviewerChecklist.length > 0) {
     ctx.REVIEWER_CHECKLIST = bulletList(backend.prompts.reviewerChecklist);
   }
-  const profiles = _internals90.pickedProfiles(directory);
+  const profiles = _internals91.pickedProfiles(directory);
   if (profiles.length > 1) {
     ctx.PROJECT_CONTEXT_SECONDARY_LANGUAGES = profiles.slice(1).map((p) => p.id).join(", ");
   }
   return ctx;
 }
-var LANG_BACKEND_DETECTION_TIMEOUT_MS = 300, _internals90;
+var LANG_BACKEND_DETECTION_TIMEOUT_MS = 300, _internals91;
 var init_project_context = __esm(() => {
   init_dispatch();
   init_framework_detector();
-  _internals90 = {
+  _internals91 = {
     pickBackend,
     pickedProfiles
   };
@@ -103238,6 +103331,7 @@ init_schema();
 init_manager2();
 init_detector();
 init_manager();
+init_state();
 import * as fs71 from "node:fs";
 import * as path114 from "node:path";
 
@@ -103531,7 +103625,6 @@ init_preflight_service();
 init_status_service();
 
 // src/hooks/system-enhancer.ts
-init_state();
 init_telemetry();
 init_utils();
 
@@ -106637,6 +106730,20 @@ ${lines.join(`
                 tryInject(LEAN_TURBO_BANNER);
               }
             }
+            const sessionIdAutoProceed = _input.sessionID;
+            if (sessionIdAutoProceed) {
+              const sessionAutoProceed = getAgentSession(sessionIdAutoProceed);
+              if (sessionAutoProceed && stripKnownSwarmPrefix(sessionAutoProceed.agentName) === "architect") {
+                const resolvedAutoProceed = getResolvedAutoProceed(sessionAutoProceed, plan2?.execution_profile?.auto_proceed);
+                const source = sessionAutoProceed.autoProceedOverride !== undefined ? "session" : "plan-or-default";
+                const banner = `${AUTO_PROCEED_BANNER}
+## ⏭️ AUTO_PROCEED STATUS:
+- auto-proceed: ${resolvedAutoProceed ? "on" : "off"}
+- source: ${source}
+- nudge: ${sessionAutoProceed.autoProceedNudgeDone ? "true" : "false"}`;
+                tryInject(banner);
+              }
+            }
             try {
               const currentPhaseNum = plan2?.current_phase ?? 1;
               const retroText = await buildRetroInjection(directory, currentPhaseNum, plan2?.title ?? undefined);
@@ -112462,7 +112569,9 @@ var TRANSIENT_SESSION_FIELDS = [
   { name: "model_fallback_index", resetValue: 0 },
   { name: "modelFallbackExhausted", resetValue: false },
   { name: "scopeViolationDetected", resetValue: false },
-  { name: "delegationActive", resetValue: false }
+  { name: "delegationActive", resetValue: false },
+  { name: "autoProceedOverride", resetValue: undefined },
+  { name: "autoProceedNudgeDone", resetValue: undefined }
 ];
 var VALID_TASK_WORKFLOW_STATES = [
   "idle",
@@ -112563,6 +112672,8 @@ function deserializeAgentSession(s) {
     fullAutoDeadlockCount: s.fullAutoDeadlockCount ?? 0,
     fullAutoLastQuestionHash: s.fullAutoLastQuestionHash ?? null,
     maxConcurrencyOverride: typeof s.maxConcurrencyOverride === "number" ? Math.min(64, Math.max(1, s.maxConcurrencyOverride)) : undefined,
+    autoProceedOverride: s.autoProceedOverride,
+    autoProceedNudgeDone: s.autoProceedNudgeDone,
     prmPatternCounts: new Map,
     prmEscalationLevel: 0,
     prmLastPatternDetected: null,
@@ -131215,7 +131326,7 @@ init_effective_spec();
 init_state();
 init_create_tool();
 function executionProfilesEqual(a, b) {
-  return a.parallelization_enabled === b.parallelization_enabled && a.max_concurrent_tasks === b.max_concurrent_tasks && a.council_parallel === b.council_parallel && a.locked === b.locked;
+  return a.parallelization_enabled === b.parallelization_enabled && a.max_concurrent_tasks === b.max_concurrent_tasks && a.council_parallel === b.council_parallel && a.locked === b.locked && a.auto_proceed === b.auto_proceed;
 }
 function detectPlaceholderContent(args2) {
   const issues = [];
@@ -131409,7 +131520,7 @@ async function executeSavePlan(args2, fallbackDir) {
               success: false,
               message: "Invalid execution_profile: schema validation failed",
               errors: requestedProfile.error.issues.map((i2) => `${i2.path.join(".")}: ${i2.message}`),
-              recovery_guidance: "Check execution_profile fields: parallelization_enabled (boolean), " + "max_concurrent_tasks (integer 1-64), council_parallel (boolean), locked (boolean)."
+              recovery_guidance: "Check execution_profile fields: parallelization_enabled (boolean), " + "max_concurrent_tasks (integer 1-64), council_parallel (boolean), locked (boolean), auto_proceed (boolean)."
             };
           }
           if (executionProfilesEqual(existing.execution_profile, requestedProfile.data)) {
@@ -131699,7 +131810,8 @@ var save_plan = createSwarmTool({
       parallelization_enabled: exports_external.boolean().optional().describe("When true, enables parallel task dispatch for this plan. Default false (serial)."),
       max_concurrent_tasks: exports_external.number().int().min(1).max(64).optional().describe("Maximum tasks that may run concurrently when parallelization is enabled. Default 1."),
       council_parallel: exports_external.boolean().optional().describe("When true, council review phases may run in parallel. Default false."),
-      locked: exports_external.boolean().optional().describe("When true, locks the profile — future save_plan calls that include " + "execution_profile will be rejected (fail-closed). " + "Unlock by resetting the plan (reset_statuses: true).")
+      locked: exports_external.boolean().optional().describe("When true, locks the profile — future save_plan calls that include " + "execution_profile will be rejected (fail-closed). " + "Unlock by resetting the plan (reset_statuses: true)."),
+      auto_proceed: exports_external.boolean().optional().describe("When true, the architect advances to the next phase automatically without asking for confirmation. Default false.")
     }).optional().describe("Architect-facing concurrency controls. Once locked, cannot be changed without resetting. " + "Omit to preserve the existing profile.")
   },
   execute: async (args2, _directory) => {
@@ -135859,6 +135971,11 @@ function verifyLeanTurboTaskCompletion(directory, taskId, sessionID) {
 init_task_id();
 init_create_tool();
 init_resolve_working_directory();
+var _internals89 = {
+  tryAcquireLock,
+  updateTaskStatus,
+  resolveWorkingDirectory
+};
 var VALID_STATUSES2 = [
   "pending",
   "in_progress",
@@ -135951,7 +136068,7 @@ function checkReviewerGate(taskId, workingDirectory, stageBParallelEnabled = fal
     }
     let resolvedDir;
     if (fallbackDir) {
-      const resolveResult = resolveWorkingDirectory(workingDirectory, fallbackDir);
+      const resolveResult = _internals89.resolveWorkingDirectory(workingDirectory, fallbackDir);
       if (resolveResult.success) {
         resolvedDir = resolveResult.directory;
       } else {
@@ -136298,14 +136415,7 @@ async function executeUpdateTaskStatus(args2, fallbackDir, ctx) {
     }
   }
   let directory;
-  if (!args2.working_directory && !fallbackDir) {
-    return {
-      success: false,
-      message: "No working_directory provided and fallbackDir is undefined",
-      errors: ["Cannot resolve directory for task status update"]
-    };
-  }
-  const resolveResult = resolveWorkingDirectory(args2.working_directory ?? fallbackDir, fallbackDir);
+  const resolveResult = _internals89.resolveWorkingDirectory(args2.working_directory, fallbackDir);
   if (!resolveResult.success) {
     return {
       success: false,
@@ -136398,7 +136508,7 @@ async function executeUpdateTaskStatus(args2, fallbackDir, ctx) {
   }
   let lockResult;
   try {
-    lockResult = await tryAcquireLock(directory, planFilePath, agentName, lockTaskId);
+    lockResult = await _internals89.tryAcquireLock(directory, planFilePath, agentName, lockTaskId);
   } catch (error93) {
     return {
       success: false,
@@ -136417,7 +136527,7 @@ async function executeUpdateTaskStatus(args2, fallbackDir, ctx) {
     };
   }
   try {
-    const updatedPlan = await updateTaskStatus(directory, args2.task_id, args2.status);
+    const updatedPlan = await _internals89.updateTaskStatus(directory, args2.task_id, args2.status);
     if (args2.status === "completed") {
       for (const [_sessionId, session] of swarmState.agentSessions) {
         if (!(session.taskWorkflowStates instanceof Map)) {
@@ -136841,7 +136951,7 @@ var web_search = createSwarmTool({
 });
 async function captureSearchEvidence(directory, query, results) {
   try {
-    const written = await _internals89.writeEvidenceDocuments(directory, results.map((result) => ({
+    const written = await _internals90.writeEvidenceDocuments(directory, results.map((result) => ({
       sourceType: "web_search",
       query,
       title: result.title,
@@ -136869,7 +136979,7 @@ async function captureSearchEvidence(directory, query, results) {
     };
   }
 }
-var _internals89 = {
+var _internals90 = {
   writeEvidenceDocuments
 };
 
@@ -138379,6 +138489,10 @@ async function initializeOpenCodeSwarm(ctx) {
           template: "/swarm full-auto $ARGUMENTS",
           description: "Toggle Full-Auto Mode for the active session [on|off]"
         },
+        "swarm-auto-proceed": {
+          template: "/swarm auto-proceed $ARGUMENTS",
+          description: "Toggle auto-proceed mode for automatic phase advancement"
+        },
         "swarm-write-retro": {
           template: "/swarm write-retro $ARGUMENTS",
           description: "Use /swarm write-retro to manually write a phase retrospective"

package/dist/session/snapshot-writer.d.ts

@@ -63,6 +63,10 @@ export interface SerializedAgentSession {
     stageBCompletion?: Record<string, string[]>;
     /** Session-scoped concurrency override for max_concurrent_tasks (Issue #761) */
     maxConcurrencyOverride?: number;
+    /** Session-level auto-proceed override (Phase 1) */
+    autoProceedOverride?: boolean;
+    /** Flag tracking whether the auto-proceed nudge has been shown (Phase 1) */
+    autoProceedNudgeDone?: boolean;
 }
 /**
  * Minimal interface for serialized InvocationWindow

package/dist/state.d.ts

@@ -175,6 +175,12 @@ export interface AgentSessionState {
      *  When set, overrides the plan's execution_profile.max_concurrent_tasks
      *  for delegation-gate guidance. Cleared on session reset. */
     maxConcurrencyOverride?: number;
+    /** Session-scoped override for execution_profile.auto_proceed.
+     *  When set, overrides the plan's auto_proceed for this session.
+     *  true = auto-advance, false = do not auto-advance. Cleared on session reset. */
+    autoProceedOverride?: boolean;
+    /** Tracks whether the FR-004 nudge ("would you like to auto-advance?") has already been shown this session. */
+    autoProceedNudgeDone?: boolean;
     /** Session-level QA gate overrides layered on top of the spec-level profile.
      *  Overrides can only enable gates (true); false values are ignored by
      *  getEffectiveGates. Cleared on session reset. Optional for backwards
@@ -594,6 +600,13 @@ export declare function hasActiveFullAuto(sessionID?: string): boolean;
  *          or if any session has that combination when no sessionID provided.
  */
 export declare function hasActiveLeanTurbo(sessionID?: string): boolean;
+/**
+ * Resolves the effective auto_proceed value for a session.
+ * Session override (autoProceedOverride) takes precedence over the plan default.
+ * Accepts `boolean | undefined` for the plan default so callers can pass
+ * `plan?.execution_profile?.auto_proceed` directly without a falsy fallback.
+ */
+export declare function getResolvedAutoProceed(session: AgentSessionState, planAutoProceed: boolean | undefined): boolean;
 export declare function setSessionEnvironment(sessionId: string, profile: EnvironmentProfile): void;
 export declare function getSessionEnvironment(sessionId: string): EnvironmentProfile | undefined;
 export declare function ensureSessionEnvironment(sessionId: string): EnvironmentProfile;

package/dist/tools/resolve-working-directory.d.ts

@@ -39,4 +39,4 @@ export interface ResolveError {
  * @param workingDirectory - Explicit working_directory from tool args (caller-controlled)
  * @param fallbackDirectory - Injected directory from createSwarmTool (ctx.directory ?? process.cwd())
  */
-export declare function resolveWorkingDirectory(workingDirectory: string | undefined | null, fallbackDirectory: string): ResolveResult | ResolveError;
+export declare function resolveWorkingDirectory(workingDirectory: string | undefined | null, fallbackDirectory?: string | null): ResolveResult | ResolveError;

package/dist/tools/save-plan.d.ts

@@ -75,6 +75,7 @@ export interface SavePlanArgs {
         max_concurrent_tasks?: number;
         council_parallel?: boolean;
         locked?: boolean;
+        auto_proceed?: boolean;
     };
 }
 /**
@@ -95,6 +96,7 @@ export interface SavePlanResult {
         max_concurrent_tasks: number;
         council_parallel: boolean;
         locked: boolean;
+        auto_proceed?: boolean;
     };
 }
 /**

package/dist/tools/update-task-status.d.ts

@@ -3,6 +3,19 @@
  * Allows agents to mark tasks as pending, in_progress, completed, or blocked.
  */
 import type { ToolContext, ToolDefinition } from '@opencode-ai/plugin/tool';
+import { tryAcquireLock } from '../parallel/file-locks.js';
+import { updateTaskStatus } from '../plan/manager';
+import { resolveWorkingDirectory } from './resolve-working-directory';
+/**
+ * Internal seams for test injection.
+ * Tests should save/restore these in beforeEach/afterEach rather than using
+ * module-scope vi.mock, which leaks across files in Bun's shared test runner.
+ */
+export declare const _internals: {
+    readonly tryAcquireLock: typeof tryAcquireLock;
+    readonly updateTaskStatus: typeof updateTaskStatus;
+    readonly resolveWorkingDirectory: typeof resolveWorkingDirectory;
+};
 /**
  * Arguments for the update_task_status tool
  */

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "opencode-swarm",
-	"version": "7.65.3",
+	"version": "7.66.1",
 	"description": "Architect-centric agentic swarm plugin for OpenCode - hub-and-spoke orchestration with SME consultation, code generation, and QA review",
 	"main": "dist/index.js",
 	"types": "dist/index.d.ts",