opencode-swarm 7.5.3 → 7.7.0

package/dist/index.js

@@ -33,7 +33,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "opencode-swarm",
-    version: "7.5.3",
+    version: "7.7.0",
     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",
@@ -164,7 +164,8 @@ var init_tool_names = __esm(() => {
     "get_qa_gate_profile",
     "set_qa_gates",
     "web_search",
-    "convene_general_council"
+    "convene_general_council",
+    "write_final_council_evidence"
   ];
   TOOL_NAME_SET = new Set(TOOL_NAMES);
 });
@@ -464,7 +465,8 @@ var init_constants = __esm(() => {
       "get_qa_gate_profile",
       "set_qa_gates",
       "convene_general_council",
-      "web_search"
+      "web_search",
+      "write_final_council_evidence"
     ],
     explorer: [
       "complexity_hotspots",
@@ -518,6 +520,7 @@ var init_constants = __esm(() => {
       "imports",
       "retrieve_summary",
       "schema_drift",
+      "search",
       "symbols",
       "knowledge_recall"
     ],
@@ -603,6 +606,7 @@ var init_constants = __esm(() => {
       "imports",
       "retrieve_summary",
       "schema_drift",
+      "search",
       "symbols",
       "todo_extract",
       "knowledge_recall"
@@ -610,6 +614,7 @@ var init_constants = __esm(() => {
     designer: [
       "extract_code_blocks",
       "retrieve_summary",
+      "search",
       "symbols",
       "knowledge_recall"
     ],
@@ -659,6 +664,7 @@ var init_constants = __esm(() => {
     write_retro: "document phase retrospectives via phase_complete workflow, capture lessons learned",
     write_drift_evidence: "write drift verification evidence for a completed phase",
     write_hallucination_evidence: "write hallucination verification evidence for a completed phase",
+    write_final_council_evidence: "write final council evidence for project completion",
     declare_scope: "declare file scope for next coder delegation",
     phase_complete: "mark a phase as complete and track dispatched agents",
     save_plan: "save a structured implementation plan",
@@ -687,8 +693,8 @@ var init_constants = __esm(() => {
     lint_spec: "validate .swarm/spec.md format and required fields",
     get_approved_plan: "retrieve the last critic-approved immutable plan snapshot for baseline drift comparison",
     repo_map: "query the repo code graph: importers, dependencies, blast radius, and localization context for structural awareness before refactoring",
-    get_qa_gate_profile: "retrieve the QA gate profile for the current plan: gates (reviewer, test_engineer, sme_enabled, critic_pre_plan, sast_enabled, council_mode, hallucination_guard, mutation_test, council_general_review, drift_check), lock state, and profile hash. Read-only.",
-    set_qa_gates: "configure the QA gate profile for the current plan. Architect-only. Ratchet-tighter only — rejected once the profile is locked after critic approval. Supports: reviewer, test_engineer, sme_enabled, critic_pre_plan, sast_enabled, council_mode, hallucination_guard, mutation_test, council_general_review, drift_check.",
+    get_qa_gate_profile: "retrieve the QA gate profile for the current plan: gates (reviewer, test_engineer, sme_enabled, critic_pre_plan, sast_enabled, council_mode, hallucination_guard, mutation_test, council_general_review, drift_check, final_council), lock state, and profile hash. Read-only.",
+    set_qa_gates: "configure the QA gate profile for the current plan. Architect-only. Ratchet-tighter only — rejected once the profile is locked after critic approval. Supports: reviewer, test_engineer, sme_enabled, critic_pre_plan, sast_enabled, council_mode, hallucination_guard, mutation_test, council_general_review, drift_check, final_council.",
     req_coverage: "query requirement coverage status for tracked functional requirements"
   };
   for (const [agentName, tools] of Object.entries(AGENT_TOOL_MAP)) {
@@ -15484,12 +15490,7 @@ var init_schema = __esm(() => {
     maxConcurrentTasks: exports_external.number().int().min(1).max(64).default(1),
     evidenceLockTimeoutMs: exports_external.number().int().min(1000).max(300000).default(60000),
     max_coders: exports_external.number().int().min(1).max(16).default(3),
-    max_reviewers: exports_external.number().int().min(1).max(16).default(2),
-    stageB: exports_external.object({
-      parallel: exports_external.object({
-        enabled: exports_external.boolean().default(false)
-      }).default({ enabled: false })
-    }).default({ parallel: { enabled: false } })
+    max_reviewers: exports_external.number().int().min(1).max(16).default(2)
   });
   PluginConfigSchema = exports_external.object({
     agents: exports_external.record(exports_external.string(), AgentOverrideConfigSchema).optional(),
@@ -16748,6 +16749,11 @@ var init_spec_hash = __esm(() => {
   };
 });
 
+// src/plan/utils.ts
+function derivePlanId(plan) {
+  return `${plan.swarm}-${plan.title}`.replace(/[^a-zA-Z0-9-_]/g, "_");
+}
+
 // src/plan/ledger.ts
 import * as crypto2 from "node:crypto";
 import * as fs4 from "node:fs";
@@ -16936,7 +16942,7 @@ async function takeSnapshotEvent(directory, plan, options) {
   if (options?.approvalMetadata) {
     snapshotPayload.approval = options.approvalMetadata;
   }
-  const planId = `${plan.swarm}-${plan.title}`.replace(/[^a-zA-Z0-9-_]/g, "_");
+  const planId = derivePlanId(plan);
   return appendLedgerEvent(directory, {
     event_type: "snapshot",
     source: options?.source ?? "takeSnapshotEvent",
@@ -17131,7 +17137,7 @@ async function loadLastApprovedPlan(directory, expectedPlanId) {
       continue;
     }
     if (expectedPlanId !== undefined) {
-      const payloadPlanId = `${payload.plan.swarm}-${payload.plan.title}`.replace(/[^a-zA-Z0-9-_]/g, "_");
+      const payloadPlanId = derivePlanId(payload.plan);
       if (payloadPlanId !== expectedPlanId) {
         continue;
       }
@@ -17332,7 +17338,7 @@ async function loadPlan(directory) {
           if (!startupLedgerCheckedWorkspaces.has(resolvedWorkspace)) {
             startupLedgerCheckedWorkspaces.add(resolvedWorkspace);
             if (ledgerHash !== "" && planHash !== ledgerHash) {
-              const currentPlanId = `${validated.swarm}-${validated.title}`.replace(/[^a-zA-Z0-9-_]/g, "_");
+              const currentPlanId = derivePlanId(validated);
               const ledgerEvents = await readLedgerEvents(directory);
               const firstEvent = ledgerEvents.length > 0 ? ledgerEvents[0] : null;
               if (firstEvent && firstEvent.plan_id !== currentPlanId) {
@@ -17415,7 +17421,7 @@ async function loadPlan(directory) {
         try {
           const rawParsed = JSON.parse(planJsonContent);
           if (typeof rawParsed?.swarm === "string" && typeof rawParsed?.title === "string") {
-            rawPlanId = `${rawParsed.swarm}-${rawParsed.title}`.replace(/[^a-zA-Z0-9-_]/g, "_");
+            rawPlanId = derivePlanId(rawParsed);
           }
         } catch {}
         if (await ledgerExists(directory)) {
@@ -17541,7 +17547,7 @@ async function savePlan(directory, plan, options) {
     }
   }
   const currentPlan = await _internals6.loadPlanJsonOnly(directory);
-  const planId = `${validated.swarm}-${validated.title}`.replace(/[^a-zA-Z0-9-_]/g, "_");
+  const planId = derivePlanId(validated);
   const planHashForInit = computePlanHash(validated);
   if (!await ledgerExists(directory)) {
     try {
@@ -17642,7 +17648,7 @@ async function savePlan(directory, plan, options) {
           const oldTask = oldTaskMap.get(task.id);
           if (oldTask && oldTask.status !== task.status) {
             const eventInput = {
-              plan_id: `${validated.swarm}-${validated.title}`.replace(/[^a-zA-Z0-9-_]/g, "_"),
+              plan_id: derivePlanId(validated),
               event_type: "task_status_changed",
               task_id: task.id,
               phase_id: phase.id,
@@ -20545,7 +20551,8 @@ var init_qa_gate_profile = __esm(() => {
     sast_enabled: true,
     mutation_test: false,
     council_general_review: false,
-    drift_check: true
+    drift_check: true,
+    final_council: false
   };
 });
 
@@ -25817,7 +25824,7 @@ function createDelegationGateHook(config2, directory) {
           hasReviewer = true;
         if (targetAgent === "test_engineer")
           hasTestEngineer = true;
-        const stageBParallelEnabled = config2.parallelization?.stageB?.parallel?.enabled === true;
+        const stageBParallelEnabled = true;
         if (stageBParallelEnabled) {
           if ((targetAgent === "reviewer" || targetAgent === "test_engineer") && session.taskWorkflowStates) {
             const stageBEligibleStates = [
@@ -25843,6 +25850,20 @@ function createDelegationGateHook(config2, directory) {
                 } catch (err2) {
                   warn(`[delegation-gate] toolAfter stage-b-parallel: could not advance ${taskId} (${eligibleState}) → tests_run: ${err2 instanceof Error ? err2.message : String(err2)}`);
                 }
+              } else {
+                try {
+                  if (targetAgent === "reviewer" && (eligibleState === "coder_delegated" || eligibleState === "pre_check_passed")) {
+                    advanceTaskState(session, taskId, "reviewer_run", {
+                      telemetrySessionId: input.sessionID
+                    });
+                  } else if (targetAgent === "test_engineer" && eligibleState === "reviewer_run") {
+                    advanceTaskState(session, taskId, "tests_run", {
+                      telemetrySessionId: input.sessionID
+                    });
+                  }
+                } catch (err2) {
+                  warn(`[delegation-gate] toolAfter stage-b-parallel intermediate: could not advance ${taskId} (${eligibleState}) after ${targetAgent}: ${err2 instanceof Error ? err2.message : String(err2)}`);
+                }
               }
             }
             const seedTaskId = getSeedTaskId(session);
@@ -25872,74 +25893,17 @@ function createDelegationGateHook(config2, directory) {
                   } catch (err2) {
                     warn(`[delegation-gate] toolAfter cross-session stage-b-parallel: could not advance ${seedTaskId} (${seedEligibleState}) → tests_run: ${err2 instanceof Error ? err2.message : String(err2)}`);
                   }
-                }
-              }
-            }
-          }
-        } else {
-          if (targetAgent === "reviewer" && session.taskWorkflowStates) {
-            for (const [taskId, state] of session.taskWorkflowStates) {
-              if (state === "coder_delegated" || state === "pre_check_passed") {
-                try {
-                  advanceTaskState(session, taskId, "reviewer_run", {
-                    telemetrySessionId: input.sessionID
-                  });
-                } catch (err2) {
-                  warn(`[delegation-gate] toolAfter: could not advance ${taskId} (${state}) → reviewer_run: ${err2 instanceof Error ? err2.message : String(err2)}`);
-                }
-              }
-            }
-          }
-          if (targetAgent === "test_engineer" && session.taskWorkflowStates) {
-            for (const [taskId, state] of session.taskWorkflowStates) {
-              if (state === "reviewer_run") {
-                try {
-                  advanceTaskState(session, taskId, "tests_run", {
-                    telemetrySessionId: input.sessionID
-                  });
-                } catch (err2) {
-                  warn(`[delegation-gate] toolAfter: could not advance ${taskId} (${state}) → tests_run: ${err2 instanceof Error ? err2.message : String(err2)}`);
-                }
-              }
-            }
-          }
-          if (targetAgent === "reviewer" || targetAgent === "test_engineer") {
-            for (const [, otherSession] of swarmState.agentSessions) {
-              if (otherSession === session)
-                continue;
-              if (!otherSession.taskWorkflowStates)
-                continue;
-              if (targetAgent === "reviewer") {
-                const seedTaskId = getSeedTaskId(session);
-                if (seedTaskId && !otherSession.taskWorkflowStates.has(seedTaskId)) {
-                  otherSession.taskWorkflowStates.set(seedTaskId, "coder_delegated");
-                }
-                for (const [taskId, state] of otherSession.taskWorkflowStates) {
-                  if (state === "coder_delegated" || state === "pre_check_passed") {
-                    try {
-                      advanceTaskState(otherSession, taskId, "reviewer_run", {
-                        emitTelemetry: false
-                      });
-                    } catch (err2) {
-                      warn(`[delegation-gate] toolAfter cross-session: could not advance ${taskId} (${state}) → reviewer_run: ${err2 instanceof Error ? err2.message : String(err2)}`);
-                    }
-                  }
-                }
-              }
-              if (targetAgent === "test_engineer") {
-                const seedTaskId = getSeedTaskId(session);
-                if (seedTaskId && !otherSession.taskWorkflowStates.has(seedTaskId)) {
-                  otherSession.taskWorkflowStates.set(seedTaskId, "reviewer_run");
-                }
-                for (const [taskId, state] of otherSession.taskWorkflowStates) {
-                  if (state === "reviewer_run") {
-                    try {
-                      advanceTaskState(otherSession, taskId, "tests_run", {
+                } else {
+                  try {
+                    if (targetAgent === "reviewer" && (seedEligibleState === "coder_delegated" || seedEligibleState === "pre_check_passed")) {
+                      advanceTaskState(otherSession, seedTaskId, "reviewer_run", { emitTelemetry: false });
+                    } else if (targetAgent === "test_engineer" && seedEligibleState === "reviewer_run") {
+                      advanceTaskState(otherSession, seedTaskId, "tests_run", {
                         emitTelemetry: false
                       });
-                    } catch (err2) {
-                      warn(`[delegation-gate] toolAfter cross-session: could not advance ${taskId} (${state}) → tests_run: ${err2 instanceof Error ? err2.message : String(err2)}`);
                     }
+                  } catch (err2) {
+                    warn(`[delegation-gate] toolAfter cross-session stage-b-parallel intermediate: could not advance ${seedTaskId} (${seedEligibleState}) after ${targetAgent}: ${err2 instanceof Error ? err2.message : String(err2)}`);
                   }
                 }
               }
@@ -25950,7 +25914,7 @@ function createDelegationGateHook(config2, directory) {
       if (typeof subagentType === "string") {
         try {
           const rawTaskId = directArgs?.task_id;
-          const evidenceTaskId = typeof rawTaskId === "string" && rawTaskId.length <= 20 && /^\d+\.\d+$/.test(rawTaskId.trim()) ? rawTaskId.trim() : await getEvidenceTaskId(session, directory);
+          const evidenceTaskId = typeof rawTaskId === "string" && rawTaskId.length <= 20 && isStrictTaskId(rawTaskId.trim()) ? rawTaskId.trim() : await getEvidenceTaskId(session, directory);
           if (evidenceTaskId) {
             const turbo = hasActiveTurboMode(input.sessionID);
             const gateAgents = [
@@ -26073,7 +26037,7 @@ function createDelegationGateHook(config2, directory) {
         }
         try {
           const rawTaskId = directArgs?.task_id;
-          const evidenceTaskId = typeof rawTaskId === "string" && rawTaskId.length <= 20 && /^\d+\.\d+$/.test(rawTaskId.trim()) ? rawTaskId.trim() : await getEvidenceTaskId(session, directory);
+          const evidenceTaskId = typeof rawTaskId === "string" && rawTaskId.length <= 20 && isStrictTaskId(rawTaskId.trim()) ? rawTaskId.trim() : await getEvidenceTaskId(session, directory);
           if (evidenceTaskId) {
             const turbo = hasActiveTurboMode(input.sessionID);
             if (hasReviewer) {
@@ -26319,6 +26283,7 @@ var init_delegation_gate = __esm(() => {
   init_state();
   init_telemetry();
   init_logger();
+  init_task_id();
   init_guardrails();
   init_normalize_tool_name();
   init_utils2();
@@ -26474,7 +26439,7 @@ function startAgentSession(sessionId, agentName, staleDurationMs = 7200000, dire
   if (directory) {
     let rehydrationPromise;
     rehydrationPromise = _internals9.rehydrateSessionFromDisk(directory, sessionState).catch((err2) => {
-      console.warn("[state] Rehydration failed:", err2 instanceof Error ? err2.message : String(err2));
+      warn("[state] Rehydration failed:", err2 instanceof Error ? err2.message : String(err2));
     }).finally(() => {
       swarmState.pendingRehydrations.delete(rehydrationPromise);
     });
@@ -26760,7 +26725,7 @@ async function advanceTaskStateAndPersist(session, taskId, newState, directory,
   try {
     await updateTaskStatus(directory, taskId, planStatus);
   } catch (err2) {
-    console.warn(`[advanceTaskStateAndPersist] persist ${taskId} → ${planStatus} failed (in-memory state still advanced): ${err2 instanceof Error ? err2.message : String(err2)}`);
+    warn(`[advanceTaskStateAndPersist] persist ${taskId} → ${planStatus} failed (in-memory state still advanced): ${err2 instanceof Error ? err2.message : String(err2)}`);
   }
 }
 function getTaskState(session, taskId) {
@@ -26793,9 +26758,6 @@ function hasBothStageBCompletions(session, taskId) {
     return false;
   return completions.has("reviewer") && completions.has("test_engineer");
 }
-function derivePlanIdFromPlan(plan) {
-  return `${plan.swarm}-${plan.title}`.replace(/[^a-zA-Z0-9-_]/g, "_");
-}
 async function isCouncilGateActive(directory, council) {
   const enabled = council?.enabled === true;
   let plan = null;
@@ -26807,7 +26769,7 @@ async function isCouncilGateActive(directory, council) {
   if (!plan) {
     return false;
   }
-  const planId = derivePlanIdFromPlan(plan);
+  const planId = derivePlanId(plan);
   let profile = null;
   try {
     profile = getProfile(directory, planId);
@@ -26815,7 +26777,7 @@ async function isCouncilGateActive(directory, council) {
     const msg = err2 instanceof Error ? err2.message : String(err2);
     const isBenign = msg.includes("SQLITE_CANTOPEN") || msg.includes("ENOENT");
     if (!isBenign) {
-      console.warn(`[isCouncilGateActive] getProfile threw unexpectedly for plan ${planId}: ${msg}. Treating council as inactive.`);
+      warn(`[isCouncilGateActive] getProfile threw unexpectedly for plan ${planId}: ${msg}. Treating council as inactive.`);
     }
     profile = null;
   }
@@ -26828,7 +26790,7 @@ async function isCouncilGateActive(directory, council) {
   }
   if (enabled !== councilMode && !_councilDisagreementWarned.has(planId)) {
     _councilDisagreementWarned.add(planId);
-    console.warn(`[delegation-gate] Council mode mismatch for plan ${planId}: ` + `pluginConfig.council.enabled=${enabled}, QaGates.council_mode=${councilMode}. ` + "Falling back to Stage B (non-council) advancement.");
+    warn(`[delegation-gate] Council mode mismatch for plan ${planId}: ` + `pluginConfig.council.enabled=${enabled}, QaGates.council_mode=${councilMode}. ` + "Falling back to Stage B (non-council) advancement.");
   }
   return false;
 }
@@ -27038,6 +27000,7 @@ var init_state = __esm(() => {
   init_delegation_gate();
   init_manager();
   init_telemetry();
+  init_logger();
   _councilDisagreementWarned = new Set;
   _toolAggregates = new Map;
   defaultRunContext = new AgentRunContext("default", _toolAggregates);
@@ -53952,9 +53915,6 @@ var init_promote = __esm(() => {
 });
 
 // src/commands/qa-gates.ts
-function derivePlanId(plan) {
-  return `${plan.swarm}-${plan.title}`.replace(/[^a-zA-Z0-9-_]/g, "_");
-}
 function isGateName(name2) {
   return ALL_GATE_NAMES.includes(name2);
 }
@@ -54080,7 +54040,8 @@ var init_qa_gates = __esm(() => {
     "sast_enabled",
     "mutation_test",
     "council_general_review",
-    "drift_check"
+    "drift_check",
+    "final_council"
   ];
 });
 
@@ -55144,7 +55105,7 @@ async function handleRollbackCommand(directory, args2) {
     if (fs27.existsSync(planJsonPath)) {
       const planRaw = fs27.readFileSync(planJsonPath, "utf-8");
       const plan = PlanSchema.parse(JSON.parse(planRaw));
-      const planId = `${plan.swarm}-${plan.title}`.replace(/[^a-zA-Z0-9-_]/g, "_");
+      const planId = derivePlanId(plan);
       const planHash = computePlanHash(plan);
       await initLedger(directory, planId, planHash, plan);
       await appendLedgerEvent(directory, {
@@ -56676,7 +56637,7 @@ function buildQaGateSelectionDialogue(modeLabel) {
   const leadIn = modeLabel === "BRAINSTORM" ? "Now ask the user which QA gates to enable for this plan — do not select on their behalf." : modeLabel === "SPECIFY" ? "Ask the user which QA gates to enable for this plan before suggesting the next step." : "No pending gate selection found in `.swarm/context.md`. Ask the user inline now.";
   return `${leadIn}
 
-Present the ten gates with their defaults (DEFAULT_QA_GATES) as a single user-facing question. Offer the user a one-shot choice: accept defaults, or customize. The ten gates are:
+Present the eleven gates with their defaults (DEFAULT_QA_GATES) as a single user-facing question. Offer the user a one-shot choice: accept defaults, or customize. The eleven gates are:
 - reviewer (default: ON) — code review of coder output
 - test_engineer (default: ON) — test verification of coder output
 - sme_enabled (default: ON) — SME consultation during planning/clarification
@@ -56687,8 +56648,20 @@ Present the ten gates with their defaults (DEFAULT_QA_GATES) as a single user-fa
 - mutation_test (default: OFF) — when enabled, runs mutation testing on source files touched this phase via generate_mutants + mutation_test + write_mutation_evidence at PHASE-WRAP; FAIL verdict blocks phase_complete; WARN is non-blocking (recommended for projects with coverage gaps or safety-critical code)
 - council_general_review (default: OFF) — when enabled, MODE: SPECIFY runs convene_general_council on the draft spec before the critic-gate; the architect runs a curated web_search pass, dispatches council_generalist / council_skeptic / council_domain_expert in parallel with a shared RESEARCH CONTEXT block, deliberates on disagreements, and synthesizes the result directly into the spec (recommended for novel architecture, unclear best practices, or high-risk design decisions). Requires council.general.enabled: true and a configured search API key.
 - drift_check (default: ON) — when enabled, mandatory per-phase drift verification via critic_drift_verifier at PHASE-WRAP; compares implemented changes against spec.md intent; hard-blocks phase_complete when spec.md exists and drift evidence is missing or REJECTED; advisory-only when no spec.md exists (recommended for all projects with a specification)
+- final_council (default: OFF) — when enabled, after all phases complete the architect convenes a holistic general council review of the entire body of work before project close. Requires council.general.enabled: true in plugin config. Recommended for multi-phase projects with high architectural complexity.
+
+One question, one message, defaults pre-stated. Wait for the user's answer.
 
-One question, one message, defaults pre-stated. Wait for the user's answer.`;
+If the user answered the gate question, immediately follow up with ONE more question: "How many coders should run in parallel? (default: 1, range: 1-4)" — if the user says a number > 1, also write a \`## Pending Parallelization Config\` section to \`.swarm/context.md\` alongside the gate selection:
+\`\`\`
+## Pending Parallelization Config
+- parallelization_enabled: true
+- max_concurrent_tasks: <user's number>
+- council_parallel: false
+- locked: true
+- recorded_at: <ISO timestamp>
+\`\`\`
+If the user accepts the default (1), skip writing this section entirely — serial execution is the default and needs no config.`;
 }
 function buildAvailableToolsList(council) {
   const tools = AGENT_TOOL_MAP.architect ?? [];
@@ -57252,6 +57225,63 @@ SECURITY_KEYWORDS: password, secret, token, credential, auth, login, encryption,
 {{AGENT_PREFIX}}docs - Documentation updates (README, API docs, guides — NOT .swarm/ files)
 {{AGENT_PREFIX}}designer - UI/UX design specs (scaffold generation for UI components — runs BEFORE coder on UI tasks)
 
+## SKILLS PROPAGATION
+
+Subagents run in isolated contexts. Any project-specific skill constraints loaded into your session (e.g. \`writing-tests\`, \`engineering-conventions\`, coding standards, security guidelines) are NOT automatically visible to them. Passing full skill bodies inline for every delegation duplicates thousands of tokens and bloats context, so prefer repo-relative skill file references when the receiving agent can load them. Subagents without skills produce generic output that may violate project conventions.
+
+### Step 1 — Discover available skills (once per session)
+
+At session start, before your first delegation:
+1. Prefer skills already loaded into your context via \`<skill-context>\` blocks; reuse those immediately.
+2. When you need to inspect on-disk skills, use the \`search\` tool with \`include\` patterns like \`.opencode/skills/*/SKILL.md,.claude/skills/*/SKILL.md\` and frontmatter queries such as \`^name:\` / \`^description:\` so you only read the YAML lines you need.
+3. Write a brief skill index to \`.swarm/context.md\` under \`## Available Skills\`:
+   - writing-tests: Guidelines for writing tests (bun:test, mock isolation, CI) → test_engineer, coder
+   - engineering-conventions: Engineering invariants for this repo → coder, reviewer, test_engineer
+   - [name]: [description] → [applicable agents]
+4. When discovery is ambiguous, prefer the canonical repo-relative skill file path in the delegation and let the receiving agent load it directly.
+
+### Step 2 — Route skills to agents
+
+Include a skill in a delegation when ANY of the following match:
+
+| Skill description / name contains…               | Pass to agents…                       |
+|---------------------------------------------------|---------------------------------------|
+| "test", "testing", "test files", "writing tests"  | test_engineer, coder                  |
+| "engineering", "conventions", "invariants", "rules" | coder, reviewer, test_engineer      |
+| "code", "implementation", "coding standards"      | coder, reviewer                       |
+| "review", "security audit", "security guidelines" | reviewer                              |
+| "documentation", "docs", "writing docs"           | docs                                  |
+| "architecture", "design patterns", "ui"           | designer, sme                         |
+| domain-specific (database, cloud, mobile, etc.)   | sme                                   |
+
+When uncertain: pass the skill. Subagents ignore irrelevant content. A missing applicable skill degrades output quality.
+
+### Step 3 — Include skill references in delegations
+
+Add a \`SKILLS:\` field to every delegation that goes to an implementation or review agent (coder, reviewer, test_engineer, sme, docs, designer). Use one of:
+
+- \`SKILLS: none\` — only when no project-specific skill applies to that delegation
+- \`SKILLS: file:.claude/skills/writing-tests/SKILL.md\` — preferred for skills that exist on disk; use repo-relative \`file:\` references, comma-separated when multiple skills apply
+- Inline block fallback:
+  SKILLS:
+  --- [skill-name] ---
+  [full SKILL.md body content pasted here]
+  --- [skill-name-2] ---
+  [full SKILL.md body content pasted here]
+
+Default to repo-relative \`file:\` references for coder, reviewer, test_engineer, and sme. Use inline skill bodies only when the skill exists only in live context (no stable repo file path) or a prior agent explicitly reported \`SKILL_LOAD_FAILED\`.
+
+**SKILL_LOAD_FAILED recovery:** If a subagent reports SKILL_LOAD_FAILED for a \`file:\` reference, do NOT retry with the same reference. Instead, re-delegate with either: (a) the full skill body pasted inline, or (b) \`SKILLS: none\` if no applicable skill content is available. Never re-use a file: reference that has already failed.
+
+**Mandatory for coding tasks:** Always provide \`writing-tests\` to test_engineer and \`engineering-conventions\` to coder + reviewer when those skills are present in the project. Prefer \`file:\` references when the files exist.
+
+### ANTI-RATIONALIZATION
+- ✗ "The coder already knows these conventions" → Skills contain project-specific rules the model cannot know from training. Always pass.
+- ✗ "It's a simple task, skills aren't needed" → A short \`file:\` reference is cheap. Missing skill constraints cause convention drift. Always pass.
+- ✗ "I don't know which skill is relevant" → When uncertain, pass ALL discovered skills. Subagents discard inapplicable content.
+- ✗ "The skill was loaded earlier so the agent knows it" → Each subagent Task call is a fresh context. Skills do NOT persist across Task boundaries.
+- ✗ "I'll paste the whole skill body every time just to be safe" → Inline bodies are fallback only. Prefer \`file:\` references to avoid unnecessary context bloat.
+
 ## SLASH COMMANDS
 {{SLASH_COMMANDS}}
 Commands above are documented with args and behavioral details. Run commands via /swarm <command> [args].
@@ -57265,15 +57295,13 @@ Available Tools: {{AVAILABLE_TOOLS}}
 
 Delegations are performed ONLY by calling the **Task** tool. Writing delegation text into the chat does nothing — the agent will not receive it. Every delegation below is the content you pass to the Task tool, not text you output to the conversation.
 
-All delegations MUST use this exact structure (MANDATORY — malformed delegations will be rejected):
+All delegations MUST follow the receiving agent's INPUT FORMAT exactly. Do NOT invent fields, omit required fields, or force one agent's schema onto another. Every delegation MUST begin with the agent name, include \`TASK:\`, and include \`SKILLS:\` when that agent prompt supports skills.
 Do NOT add conversational preamble before the agent prefix. Begin directly with the agent name.
 
 {{AGENT_PREFIX}}[agent]
 TASK: [single objective]
-FILE: [path] (if applicable)
-INPUT: [what to analyze/use]
-OUTPUT: [expected deliverable format]
-CONSTRAINT: [what NOT to do]
+[agent-specific fields required by that agent's INPUT FORMAT]
+SKILLS: [either "none", repo-relative file: references, or inline skill bodies — see SKILLS PROPAGATION; use "none" only when no project-specific skill applies]
 
 Examples:
 
@@ -57281,6 +57309,7 @@ Examples:
 TASK: Analyze codebase for auth implementation
 INPUT: Focus on src/auth/, src/middleware/
 OUTPUT: Structure, frameworks, key files, relevant domains
+SKILLS: none
 
 {{AGENT_PREFIX}}sme
 TASK: Review auth token patterns
@@ -57288,12 +57317,14 @@ DOMAIN: security
 INPUT: src/auth/login.ts uses JWT with RS256
 OUTPUT: Security considerations, recommended patterns
 CONSTRAINT: Focus on auth only, not general code style
+SKILLS: none
 
 {{AGENT_PREFIX}}sme
 TASK: Advise on state management approach
 DOMAIN: ios
 INPUT: Building a SwiftUI app with offline-first sync
 OUTPUT: Recommended patterns, frameworks, gotchas
+SKILLS: none
 
 PRE-STEP (required): call \`declare_scope({ taskId, files })\` BEFORE writing any {{AGENT_PREFIX}}coder delegation. See Rule 1a.
 
@@ -57303,6 +57334,7 @@ FILE: src/auth/login.ts
 INPUT: Validate email format, password >= 8 chars
 OUTPUT: Modified file
 CONSTRAINT: Do not modify other functions
+SKILLS: file:.claude/skills/engineering-conventions/SKILL.md
 
 {{AGENT_PREFIX}}reviewer
 TASK: Review login validation
@@ -57310,17 +57342,20 @@ FILE: src/auth/login.ts
 CHECK: [security, correctness, edge-cases]
 GATES: lint=PASS, sast_scan=PASS, secretscan=PASS
 OUTPUT: VERDICT + RISK + ISSUES
+SKILLS: file:.claude/skills/engineering-conventions/SKILL.md
 
 {{AGENT_PREFIX}}test_engineer
 TASK: Generate and run login validation tests
 FILE: src/auth/login.ts
 OUTPUT: Test file at src/auth/login.test.ts + VERDICT: PASS/FAIL with failure details
+SKILLS: file:.claude/skills/writing-tests/SKILL.md
 
 {{AGENT_PREFIX}}critic
 TASK: Review plan for user authentication feature
 PLAN: [paste the plan.md content]
 CONTEXT: [codebase summary from explorer]
 OUTPUT: VERDICT + CONFIDENCE + ISSUES + SUMMARY
+SKILLS: none
 
 {{AGENT_PREFIX}}reviewer
 TASK: Security-only review of login validation
@@ -57328,18 +57363,21 @@ FILE: src/auth/login.ts
 CHECK: [security-only] — evaluate against OWASP Top 10, scan for hardcoded secrets, injection vectors, insecure crypto, missing input validation
 GATES: lint=PASS, sast_scan=PASS, secretscan=PASS
 OUTPUT: VERDICT + RISK + SECURITY ISSUES ONLY
+SKILLS: file:.claude/skills/engineering-conventions/SKILL.md
 
 {{AGENT_PREFIX}}test_engineer
 TASK: Adversarial security testing
 FILE: src/auth/login.ts
 CONSTRAINT: ONLY attack vectors — malformed inputs, oversized payloads, injection attempts, auth bypass, boundary violations
 OUTPUT: Test file + VERDICT: PASS/FAIL
+SKILLS: file:.claude/skills/writing-tests/SKILL.md
 
 {{AGENT_PREFIX}}explorer
 TASK: Integration impact analysis
 INPUT: Contract changes detected: [list from diff tool]
 OUTPUT: BREAKING_CHANGES + COMPATIBLE_CHANGES + CONSUMERS_AFFECTED + COMPATIBILITY SIGNALS: [COMPATIBLE | INCOMPATIBLE | UNCERTAIN] + MIGRATION_SURFACE: [yes — list of affected call signatures | no]
 CONSTRAINT: Read-only. use search to find imports/usages of changed exports.
+SKILLS: none
 
 {{AGENT_PREFIX}}docs
 TASK: Update documentation for Phase 2 changes
@@ -57350,6 +57388,7 @@ CHANGES SUMMARY:
   - Added UserSession interface with refreshToken field
 DOC FILES: README.md, docs/api.md, docs/installation.md
 OUTPUT: Updated doc files + SUMMARY
+SKILLS: none
 
 {{AGENT_PREFIX}}designer
 TASK: Design specification for user settings page
@@ -57357,6 +57396,7 @@ CONTEXT: Users need to update profile info, change password, manage notification
 FRAMEWORK: React (TSX)
 EXISTING PATTERNS: All forms use react-hook-form, validation with zod, toast notifications for success/error
 OUTPUT: Code scaffold for src/pages/Settings.tsx with component tree, typed props, layout, and accessibility
+SKILLS: none
 
 ## WORKFLOW
 
@@ -57458,6 +57498,7 @@ Do NOT call \`set_qa_gates\` yet — \`plan.json\` does not exist at this point.
 - mutation_test: <true|false>
 - council_general_review: <true|false>
 - drift_check: <true|false>
+- final_council: <true|false>
 - recorded_at: <ISO timestamp>
 \`\`\`
 MODE: PLAN applies these after \`save_plan\` succeeds via \`set_qa_gates\`.
@@ -57536,6 +57577,7 @@ Do NOT call \`set_qa_gates\` yet — \`plan.json\` does not exist at this point.
 - mutation_test: <true|false>
 - council_general_review: <true|false>
 - drift_check: <true|false>
+- final_council: <true|false>
 - recorded_at: <ISO timestamp>
 \`\`\`
 MODE: PLAN will read this section after \`save_plan\` succeeds and persist via \`set_qa_gates\`.
@@ -57918,6 +57960,7 @@ save_plan({
 **POST-SAVE_PLAN: APPLY QA GATE SELECTION.**
 After \`save_plan\` succeeds, read \`.swarm/context.md\`:
 - If a \`## Pending QA Gate Selection\` section exists: parse the gate values, call \`set_qa_gates\` with those flags, confirm with the user ("QA gates applied: <list>"), then remove the section from context.md.
+- If a \`## Pending Parallelization Config\` section also exists: parse the values and call \`save_plan\` again with \`execution_profile\` set to \`{ parallelization_enabled: <parsed>, max_concurrent_tasks: <parsed>, council_parallel: false, locked: true }\`. Then remove the section from context.md. If the plan already had \`execution_profile.locked: true\`, skip this step — the profile is already locked and immutable.
 - If no pending section exists: {{QA_GATE_DIALOGUE_PLAN}}
 <!-- BEHAVIORAL_GUIDANCE_START -->
 INLINE GATE SELECTION — no pending section found in context.md. You MUST ask now.
@@ -58272,6 +58315,19 @@ The tool will automatically write the retrospective to \`.swarm/evidence/retro-{
    - \`.swarm/evidence/{phase}/mutation-gate.json\` exists with verdict 'pass' or 'warn' (written by YOU via the \`write_mutation_evidence\` tool after step 5.56) — ONLY required when \`mutation_test\` is enabled in the QA gate profile
    If any required file is missing, run the missing gate first. Turbo mode skips all gates automatically.
    NOTE: Steps 5.5, 5.55, and 5.56 are enforced by runtime hooks. If \`hallucination_guard\` is enabled and you skip the critic_hallucination_verifier delegation (or fail to call \`write_hallucination_evidence\`), phase_complete will be BLOCKED by the plugin. Similarly, if \`mutation_test\` is enabled and you skip step 5.56 (or fail to call \`write_mutation_evidence\`), phase_complete will be BLOCKED. These are not suggestions — they are hard enforcement mechanisms.
+5.7. **Final Council (conditional on QA gate — last phase only)**: Check whether \`final_council\` is enabled in the effective QA gate profile (visible via \`get_qa_gate_profile\`). If disabled, skip silently and proceed to step 6.
+   If enabled AND this is the LAST phase in the plan (all other phases have status 'complete' and no more phases remain):
+    1. Verify \`council.general.enabled: true\` in plugin config. If not enabled, warn the user: "final_council gate is enabled but General Council is not configured. Skipping final council." Then proceed to step 6. Check that \`convene_general_council\` is available in your tool list. If the tool is unavailable (filtered by config), warn the user and skip.
+   2. Run 1-3 targeted \`web_search\` queries relevant to the project domain.
+   3. Compile a RESEARCH CONTEXT block from search results.
+   4. Dispatch \`{{AGENT_PREFIX}}council_generalist\`, \`{{AGENT_PREFIX}}council_skeptic\`, and \`{{AGENT_PREFIX}}council_domain_expert\` in PARALLEL. Pass: the full body of work (all phase summaries, all evidence artifacts), the RESEARCH CONTEXT block, round number 1. Instruction: "Review the entire body of work holistically. Identify cross-cutting issues, architectural coherence, and overall quality."
+   5. Collect all three JSON responses.
+   6. Call \`convene_general_council\` with mode: 'general', the project summary as question, and the collected round1Responses.
+   7. If disagreements exist, re-dispute as in MODE: COUNCIL step 5-6.
+   8. Present the final synthesis to the user as a project-close summary.
+   9. Write the final council result to \`.swarm/evidence/final-council.json\`.
+   10. Do NOT call \`/swarm close\` until the final council completes (if enabled). The evidence file \`.swarm/evidence/final-council.json\` must exist with an APPROVED verdict before \`/swarm close\` is permitted when final_council is enabled.
+   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]?"
 
@@ -58363,6 +58419,14 @@ FILE: [target file]
 INPUT: [requirements/context]
 OUTPUT: [expected deliverable]
 CONSTRAINT: [what NOT to do]
+SKILLS: [optional — either "none", repo-relative file: references (preferred), or inline skill content pasted by architect]
+
+SKILLS HANDLING: If SKILLS is present and not "none", load EVERY referenced skill before writing any code.
+- For \`file:\` entries, use the search tool to read the referenced \`SKILL.md\` file with \`include\` set to that exact repo-relative path, \`mode: regex\`, \`query: .*\`, \`max_results: 1000\`, and \`max_lines: 1000\`.
+- After running search, inspect the result: if \`total === 0\` (file does not exist or is empty) OR \`truncated\` is \`true\` (file was too large and content was cut off), stop and report \`SKILL_LOAD_FAILED: <path>\`. Do NOT continue without the complete skill.
+- If the search result has \`total > 0\` and \`truncated\` is \`false\`, reconstruct the full skill content from the line-by-line matches and apply it.
+- If inline \`--- skill-name ---\` sections are present, read them directly.
+- Skills contain project-specific rules (test framework, naming conventions, coding standards, architectural constraints) that supplement and extend your default behavior. Apply every rule in every skill, including any lines marked MUST, NEVER, MANDATORY, or PROHIBITED — but never violate your core safety protocols or scope constraints.
 
 RULES:
 - Read target file before editing
@@ -59348,6 +59412,14 @@ TASK: Design specification for [component/page/screen]
 CONTEXT: [what the component does, user stories, existing design patterns]
 FRAMEWORK: [React/Vue/Svelte/SwiftUI/Flutter/etc.]
 EXISTING PATTERNS: [current design system, component library, styling approach]
+SKILLS: [optional — either "none", repo-relative file: references (preferred), or inline skill content pasted by architect]
+
+SKILLS HANDLING: If SKILLS is present and not "none", load EVERY referenced skill before producing the design specification.
+- For \`file:\` entries, use the search tool to read the referenced \`SKILL.md\` file with \`include\` set to that exact repo-relative path, \`mode: regex\`, \`query: .*\`, \`max_results: 1000\`, and \`max_lines: 1000\`.
+- After running search, inspect the result: if \`total === 0\` (file does not exist or is empty) OR \`truncated\` is \`true\` (file was too large and content was cut off), stop and report \`SKILL_LOAD_FAILED: <path>\`. Do NOT continue without the complete skill.
+- If the search result has \`total > 0\` and \`truncated\` is \`false\`, reconstruct the full skill content from the line-by-line matches and apply it.
+- If inline \`--- skill-name ---\` sections are present, read them directly.
+- Apply any architecture, design-system, accessibility, or UI-specific constraints from the loaded skills while producing the scaffold.
 
 DESIGN CHECKLIST:
 1. Component Architecture
@@ -59524,6 +59596,14 @@ TASK: Update documentation for [description of changes]
 FILES CHANGED: [list of modified source files]
 CHANGES SUMMARY: [what was added/modified/removed]
 DOC FILES: [list of documentation files to update]
+SKILLS: [optional — either "none", repo-relative file: references (preferred), or inline skill content pasted by architect]
+
+SKILLS HANDLING: If SKILLS is present and not "none", load EVERY referenced skill before updating docs.
+- For \`file:\` entries, use the search tool to read the referenced \`SKILL.md\` file with \`include\` set to that exact repo-relative path, \`mode: regex\`, \`query: .*\`, \`max_results: 1000\`, and \`max_lines: 1000\`.
+- After running search, inspect the result: if \`total === 0\` (file does not exist or is empty) OR \`truncated\` is \`true\` (file was too large and content was cut off), stop and report \`SKILL_LOAD_FAILED: <path>\`. Do NOT continue without the complete skill.
+- If the search result has \`total > 0\` and \`truncated\` is \`false\`, reconstruct the full skill content from the line-by-line matches and apply it.
+- If inline \`--- skill-name ---\` sections are present, read them directly.
+- Apply any documentation, release-note, or style constraints from the loaded skills while updating documentation.
 
 SCOPE:
 - README.md (project description, usage, examples)
@@ -59823,6 +59903,14 @@ DIFF: [changed files/functions, or "infer from FILE" if omitted]
 AFFECTS: [callers/consumers/dependents to inspect, or "infer from diff"]
 CHECK: [list of dimensions to evaluate]
 GATES: [pre-completed gate results (lint, SAST, secretscan, etc.), or "none" if unavailable]
+SKILLS: [optional — either "none", repo-relative file: references (preferred), or inline skill content pasted by architect]
+
+SKILLS HANDLING: If SKILLS is present and not "none", load EVERY referenced skill before beginning your review.
+- For \`file:\` entries, use the search tool to read the referenced \`SKILL.md\` file with \`include\` set to that exact repo-relative path, \`mode: regex\`, \`query: .*\`, \`max_results: 1000\`, and \`max_lines: 1000\`.
+- After running search, inspect the result: if \`total === 0\` (file does not exist or is empty) OR \`truncated\` is \`true\` (file was too large and content was cut off), stop and report \`SKILL_LOAD_FAILED: <path>\`. Do NOT continue without the complete skill.
+- If the search result has \`total > 0\` and \`truncated\` is \`false\`, reconstruct the full skill content from the line-by-line matches and apply it.
+- If inline \`--- skill-name ---\` sections are present, read them directly.
+- Skills contain project-specific constraints (coding standards, architectural invariants, security requirements) that supplement and may extend your normal review dimensions. Flag any violation of a skill rule at the same severity as a logic error.
 
 PROCESSING: If GATES is provided and includes passing results for lint, SAST, placeholder-scan, or secret-scan: skip the corresponding Tier 2 checks that those gates already cover. Focus Tier 2 time on checks NOT covered by automated gates.
 
@@ -59930,6 +60018,14 @@ Match response length to confidence and complexity. HIGH confidence on simple lo
 TASK: [what guidance is needed]
 DOMAIN: [the domain - e.g., security, ios, android, rust, kubernetes]
 INPUT: [context/requirements]
+SKILLS: [optional — either "none", repo-relative file: references (preferred), or inline skill content pasted by architect]
+
+SKILLS HANDLING: If SKILLS is present and not "none", load EVERY referenced skill before formulating your recommendation.
+- For \`file:\` entries, use the search tool to read the referenced \`SKILL.md\` file with \`include\` set to that exact repo-relative path, \`mode: regex\`, \`query: .*\`, \`max_results: 1000\`, and \`max_lines: 1000\`.
+- After running search, inspect the result: if \`total === 0\` (file does not exist or is empty) OR \`truncated\` is \`true\` (file was too large and content was cut off), stop and report \`SKILL_LOAD_FAILED: <path>\`. Do NOT continue without the complete skill.
+- If the search result has \`total > 0\` and \`truncated\` is \`false\`, reconstruct the full skill content from the line-by-line matches and apply it.
+- If inline \`--- skill-name ---\` sections are present, read them directly.
+- Skills may contain project-specific constraints relevant to your domain (e.g. security rules, platform requirements, coding standards). Where skills add constraints to your recommendation, list them explicitly in your APPROACH and GOTCHAS.
 
 ## OUTPUT FORMAT (MANDATORY — deviations will be rejected)
 Begin directly with CONFIDENCE. Do NOT prepend "Here's my research..." or any conversational preamble.
@@ -60049,6 +60145,14 @@ INPUT FORMAT:
 TASK: Generate tests for [description]
 FILE: [source file path]
 OUTPUT: [test file path]
+SKILLS: [optional — either "none", repo-relative file: references (preferred), or inline skill content pasted by architect]
+
+SKILLS HANDLING: If SKILLS is present and not "none", load EVERY referenced skill before writing any test code.
+- For \`file:\` entries, use the search tool to read the referenced \`SKILL.md\` file with \`include\` set to that exact repo-relative path, \`mode: regex\`, \`query: .*\`, \`max_results: 1000\`, and \`max_lines: 1000\`.
+- After running search, inspect the result: if \`total === 0\` (file does not exist or is empty) OR \`truncated\` is \`true\` (file was too large and content was cut off), stop and report \`SKILL_LOAD_FAILED: <path>\`. Do NOT continue without the complete skill.
+- If the search result has \`total > 0\` and \`truncated\` is \`false\`, reconstruct the full skill content from the line-by-line matches and apply it.
+- If inline \`--- skill-name ---\` sections are present, read them directly.
+- Skills override your default framework choices, mock patterns, file placement conventions, and CI rules. Apply every MUST, NEVER, MANDATORY, and PROHIBITED rule precisely.
 
 COVERAGE:
 - Happy path: normal inputs
@@ -65543,7 +65647,7 @@ var init_curator_drift = __esm(() => {
 init_package();
 init_agents2();
 init_critic();
-import * as path115 from "node:path";
+import * as path116 from "node:path";
 
 // src/background/index.ts
 init_event_bus();
@@ -78736,7 +78840,7 @@ var diff = createSwarmTool({
             encoding: "utf-8",
             timeout: 3000,
             cwd: directory,
-            stdio: "pipe"
+            stdio: ["ignore", "pipe", "pipe"]
           });
           return true;
         } catch (e) {
@@ -78750,9 +78854,9 @@ var diff = createSwarmTool({
       }, getContentFromRef = function(refPath) {
         return child_process7.execFileSync("git", ["show", refPath], {
           encoding: "utf-8",
-          timeout: 5000,
+          timeout: 15000,
           cwd: directory,
-          stdio: "pipe"
+          stdio: ["ignore", "pipe", "pipe"]
         });
       };
       if (!directory || typeof directory !== "string" || directory.trim() === "") {
@@ -78803,13 +78907,15 @@ var diff = createSwarmTool({
         encoding: "utf-8",
         timeout: DIFF_TIMEOUT_MS,
         maxBuffer: MAX_BUFFER_BYTES,
-        cwd: directory
+        cwd: directory,
+        stdio: ["ignore", "pipe", "pipe"]
       });
       const fullDiffOutput = child_process7.execFileSync("git", fullDiffArgs, {
         encoding: "utf-8",
         timeout: DIFF_TIMEOUT_MS,
         maxBuffer: MAX_BUFFER_BYTES,
-        cwd: directory
+        cwd: directory,
+        stdio: ["ignore", "pipe", "pipe"]
       });
       const files = [];
       const numstatLines = numstatOutput.split(`
@@ -79578,9 +79684,6 @@ function summarizePlan(plan) {
     }))
   };
 }
-function derivePlanId2(plan) {
-  return `${plan.swarm}-${plan.title}`.replace(/[^a-zA-Z0-9-_]/g, "_");
-}
 async function executeGetApprovedPlan(args2, directory) {
   const currentPlan = await loadPlanJsonOnly(directory);
   if (!currentPlan) {
@@ -79599,7 +79702,7 @@ async function executeGetApprovedPlan(args2, directory) {
       reason: "no_approved_snapshot"
     };
   }
-  const expectedPlanId = derivePlanId2(currentPlan);
+  const expectedPlanId = derivePlanId(currentPlan);
   const profile = getProfile(directory, expectedPlanId);
   const qaProfileHash = profile ? computeProfileHash(profile) : null;
   const approved = await loadLastApprovedPlan(directory, expectedPlanId);
@@ -79658,9 +79761,6 @@ var get_approved_plan = createSwarmTool({
 init_qa_gate_profile();
 init_manager();
 init_create_tool();
-function derivePlanId3(plan) {
-  return `${plan.swarm}-${plan.title}`.replace(/[^a-zA-Z0-9-_]/g, "_");
-}
 async function executeGetQaGateProfile(_args, directory) {
   const plan = await loadPlanJsonOnly(directory);
   if (!plan) {
@@ -79669,7 +79769,7 @@ async function executeGetQaGateProfile(_args, directory) {
       reason: "plan_json_unavailable"
     };
   }
-  const planId = derivePlanId3(plan);
+  const planId = derivePlanId(plan);
   const profile = getProfile(directory, planId);
   if (!profile) {
     return {
@@ -80841,7 +80941,7 @@ async function executePhaseComplete(args2, workingDirectory, directory) {
     }, null, 2);
   }
   if (hasActiveTurboMode(sessionID)) {
-    console.warn(`[phase_complete] Turbo mode active — skipping completion-verify, drift-verifier, hallucination-guard, mutation-gate, and phase-council gates for phase ${phase}`);
+    console.warn(`[phase_complete] Turbo mode active — skipping completion-verify, drift-verifier, hallucination-guard, mutation-gate, phase-council, and final-council gates for phase ${phase}`);
   } else {
     try {
       const completionResultRaw = await executeCompletionVerify({ phase }, dir);
@@ -80870,7 +80970,7 @@ async function executePhaseComplete(args2, workingDirectory, directory) {
       driftHasSpecMd = fs69.existsSync(specMdPath);
       const gatePlan = await loadPlan(dir);
       if (gatePlan) {
-        const gatePlanId = `${gatePlan.swarm}-${gatePlan.title}`.replace(/[^a-zA-Z0-9-_]/g, "_");
+        const gatePlanId = derivePlanId(gatePlan);
         const gateProfile = getProfile(dir, gatePlanId);
         if (gateProfile) {
           const gateSession = sessionID ? swarmState.agentSessions.get(sessionID) : undefined;
@@ -80999,7 +81099,7 @@ async function executePhaseComplete(args2, workingDirectory, directory) {
     try {
       const plan = await loadPlan(dir);
       if (plan) {
-        const planId = `${plan.swarm}-${plan.title}`.replace(/[^a-zA-Z0-9-_]/g, "_");
+        const planId = derivePlanId(plan);
         const profile = getProfile(dir, planId);
         if (profile) {
           const session2 = sessionID ? swarmState.agentSessions.get(sessionID) : undefined;
@@ -81071,7 +81171,7 @@ async function executePhaseComplete(args2, workingDirectory, directory) {
     try {
       const plan = await loadPlan(dir);
       if (plan) {
-        const planId = `${plan.swarm}-${plan.title}`.replace(/[^a-zA-Z0-9-_]/g, "_");
+        const planId = derivePlanId(plan);
         const profile = getProfile(dir, planId);
         if (profile) {
           const session2 = sessionID ? swarmState.agentSessions.get(sessionID) : undefined;
@@ -81144,7 +81244,7 @@ async function executePhaseComplete(args2, workingDirectory, directory) {
     try {
       const plan = await loadPlan(dir);
       if (plan) {
-        const planId = `${plan.swarm}-${plan.title}`.replace(/[^a-zA-Z0-9-_]/g, "_");
+        const planId = derivePlanId(plan);
         const profile = getProfile(dir, planId);
         if (profile) {
           const session2 = sessionID ? swarmState.agentSessions.get(sessionID) : undefined;
@@ -81345,6 +81445,127 @@ Advisory notes: ${advisoryNotes.join("; ")}` : "";
       }
     }
   }
+  if (!hasActiveTurboMode(sessionID)) {
+    let finalCouncilEnabled = false;
+    try {
+      const plan = await loadPlan(dir);
+      if (plan) {
+        const lastPhaseId = plan.phases[plan.phases.length - 1]?.id;
+        if (lastPhaseId !== undefined && phase === lastPhaseId) {
+          const planId = derivePlanId(plan);
+          const profile = getProfile(dir, planId);
+          if (profile) {
+            const session2 = sessionID ? swarmState.agentSessions.get(sessionID) : undefined;
+            const overrides = session2?.qaGateSessionOverrides ?? {};
+            const effective = getEffectiveGates(profile, overrides);
+            if (effective.final_council === true) {
+              finalCouncilEnabled = true;
+              const fcPath = path90.join(dir, ".swarm", "evidence", "final-council.json");
+              let fcVerdictFound = false;
+              let _fcVerdict;
+              try {
+                const fcContent = fs69.readFileSync(fcPath, "utf-8");
+                const fcBundle = JSON.parse(fcContent);
+                for (const entry of fcBundle.entries ?? []) {
+                  if (typeof entry.type === "string" && entry.type === "final-council" && typeof entry.verdict === "string") {
+                    fcVerdictFound = true;
+                    _fcVerdict = entry.verdict;
+                    if (plan) {
+                      const currentPlanId = derivePlanId(plan);
+                      if (entry.plan_id && entry.plan_id !== currentPlanId) {
+                        return JSON.stringify({
+                          success: false,
+                          phase,
+                          status: "blocked",
+                          reason: "final_council_plan_mismatch",
+                          message: `Final council evidence belongs to a different plan (evidence: ${entry.plan_id}, current: ${currentPlanId}). Re-run the final council.`,
+                          agentsDispatched,
+                          agentsMissing: [],
+                          warnings: []
+                        }, null, 2);
+                      }
+                      if (!entry.plan_id) {
+                        return JSON.stringify({
+                          success: false,
+                          phase,
+                          status: "blocked",
+                          reason: "FINAL_COUNCIL_PLAN_ID_REQUIRED",
+                          message: `Phase ${phase} (last phase) cannot be completed: final council evidence is missing plan_id binding. Re-run the final council to generate evidence with plan identity.`,
+                          agentsDispatched,
+                          agentsMissing: [],
+                          warnings: []
+                        }, null, 2);
+                      }
+                    }
+                    if (entry.verdict === "rejected" || entry.verdict === "REJECTED") {
+                      return JSON.stringify({
+                        success: false,
+                        phase,
+                        status: "blocked",
+                        reason: "FINAL_COUNCIL_REJECTED",
+                        message: `Phase ${phase} (last phase) cannot be completed: final council returned verdict 'REJECTED'. Address the required fixes before completing the project.`,
+                        agentsDispatched,
+                        agentsMissing: [],
+                        warnings: []
+                      }, null, 2);
+                    }
+                    if (entry.verdict !== "approved" && entry.verdict !== "APPROVED") {
+                      return JSON.stringify({
+                        success: false,
+                        phase,
+                        status: "blocked",
+                        reason: "FINAL_COUNCIL_INVALID_VERDICT",
+                        message: `Phase ${phase} (last phase) cannot be completed: final council evidence contains unrecognized verdict '${entry.verdict}'. Expected 'approved'.`,
+                        agentsDispatched,
+                        agentsMissing: [],
+                        warnings: []
+                      }, null, 2);
+                    }
+                  }
+                }
+              } catch (readErr) {
+                if (readErr.code !== "ENOENT") {
+                  safeWarn(`[phase_complete] Final council evidence unreadable:`, readErr);
+                }
+                fcVerdictFound = false;
+              }
+              if (!fcVerdictFound) {
+                return JSON.stringify({
+                  success: false,
+                  phase,
+                  status: "blocked",
+                  reason: "FINAL_COUNCIL_REQUIRED",
+                  final_council_required: true,
+                  message: `Phase ${phase} (last phase) cannot be completed: final_council is enabled and final council evidence not found at .swarm/evidence/final-council.json. Convene a final holistic council (use convene_general_council with mode 'general') and call write_final_council_evidence to persist the verdict before completing the project.`,
+                  agentsDispatched,
+                  agentsMissing: [],
+                  warnings: [
+                    `Final council required — convene a holistic project review using convene_general_council, then call write_final_council_evidence to persist the verdict.`
+                  ]
+                }, null, 2);
+              }
+            }
+          }
+        }
+      }
+    } catch (fcError) {
+      if (finalCouncilEnabled) {
+        warnings.push(`FINAL_COUNCIL_ERROR: ${String(fcError)}`);
+        return JSON.stringify({
+          success: false,
+          phase,
+          status: "blocked",
+          reason: "FINAL_COUNCIL_ERROR",
+          message: `Phase ${phase} (last phase) cannot be completed: final council gate encountered an error. Error: ${String(fcError)}`,
+          agentsDispatched,
+          agentsMissing: [],
+          warnings: [`FINAL_COUNCIL_ERROR: ${String(fcError)}`]
+        }, null, 2);
+      } else {
+        safeWarn(`[phase_complete] Final council gate error (non-blocking):`, fcError);
+      }
+    }
+  }
   let knowledgeConfig;
   try {
     knowledgeConfig = KnowledgeConfigSchema.parse(config3.knowledge ?? {});
@@ -86681,7 +86902,10 @@ async function executeSavePlan(args2, fallbackDir) {
     } catch {}
     const hasPendingSection = contextContent.includes("## Pending QA Gate Selection");
     if (!hasPendingSection) {
-      const candidatePlanId = `${args2.swarm_id}-${args2.title}`.replace(/[^a-zA-Z0-9-_]/g, "_");
+      const candidatePlanId = derivePlanId({
+        swarm: args2.swarm_id,
+        title: args2.title
+      });
       let existingProfile = null;
       try {
         existingProfile = getProfile(targetWorkspace, candidatePlanId);
@@ -86802,7 +87026,7 @@ async function executeSavePlan(args2, fallbackDir) {
         await takeSnapshotEvent(dir, savedPlan).catch(() => {});
       }
       if (resolvedProfile !== undefined && savedPlan) {
-        const planId = `${plan.swarm}-${plan.title}`.replace(/[^a-zA-Z0-9-_]/g, "_");
+        const planId = derivePlanId(plan);
         const planHashAfter = computePlanHash(savedPlan);
         const profileChanged = JSON.stringify(resolvedProfile) !== JSON.stringify(preservedExecutionProfile);
         if (profileChanged) {
@@ -88684,9 +88908,6 @@ init_zod();
 init_qa_gate_profile();
 init_manager();
 init_create_tool();
-function derivePlanId4(plan) {
-  return `${plan.swarm}-${plan.title}`.replace(/[^a-zA-Z0-9-_]/g, "_");
-}
 async function executeSetQaGates(args2, directory) {
   const plan = await loadPlanJsonOnly(directory);
   if (!plan) {
@@ -88696,7 +88917,7 @@ async function executeSetQaGates(args2, directory) {
       message: "Cannot configure QA gates: plan.json is missing or invalid. " + "Create a plan first (e.g. via /swarm specify or save_plan)."
     };
   }
-  const planId = derivePlanId4(plan);
+  const planId = derivePlanId(plan);
   getOrCreateProfile(directory, planId, args2.project_type);
   const partial3 = {};
   for (const key of [
@@ -88709,7 +88930,8 @@ async function executeSetQaGates(args2, directory) {
     "sast_enabled",
     "mutation_test",
     "council_general_review",
-    "drift_check"
+    "drift_check",
+    "final_council"
   ]) {
     if (args2[key] !== undefined)
       partial3[key] = args2[key];
@@ -88757,6 +88979,7 @@ var set_qa_gates = createSwarmTool({
     mutation_test: exports_external.boolean().optional().describe("Enable the mutation-testing gate (default: off). Requires mutation " + "tests to achieve a passing kill rate before phase completion; " + "WARN verdict allows advancement, FAIL blocks."),
     council_general_review: exports_external.boolean().optional().describe("Enable the council_general_review gate (default: off). When on, " + "MODE: SPECIFY runs convene_general_council on the draft spec " + "before the critic-gate, folding multi-model deliberation into " + "the spec. Requires council.general.enabled and a search API key."),
     drift_check: exports_external.boolean().optional().describe("Enable drift verification gate (default: on). Blocks phase_complete " + "until drift-verifier.json has an approved verdict. When disabled, " + "drift verification is skipped entirely."),
+    final_council: exports_external.boolean().optional().describe("Enable the final_council gate (default: off). When on, " + "after all phases complete the architect runs a holistic " + "general council review against the entire body of work. " + "Requires council.general.enabled: true in plugin config."),
     project_type: exports_external.string().optional().describe('Project type label (e.g. "ts", "python"). Only applied when the profile is being created for the first time.')
   },
   execute: async (args2, directory) => {
@@ -90855,6 +91078,7 @@ function checkReviewerGate(taskId, workingDirectory, stageBParallelEnabled = fal
       } catch {}
     }
     const resolvedDir = workingDirectory ?? process.cwd();
+    let evidenceIncompleteReason = null;
     try {
       const evidence = readTaskEvidenceRaw(resolvedDir, taskId);
       if (evidence === null) {} else if (evidence.required_gates && Array.isArray(evidence.required_gates) && evidence.gates) {
@@ -90863,11 +91087,7 @@ function checkReviewerGate(taskId, workingDirectory, stageBParallelEnabled = fal
           return { blocked: false, reason: "" };
         }
         const missingGates = evidence.required_gates.filter((gate) => evidence.gates[gate] == null);
-        telemetry.gateFailed("", "qa_gate", taskId, `Missing gates: [${missingGates.join(", ")}]`);
-        return {
-          blocked: true,
-          reason: `Task ${taskId} is missing required gates: [${missingGates.join(", ")}]. ` + `Required: [${evidence.required_gates.join(", ")}]. ` + `Completed: [${Object.keys(evidence.gates).join(", ")}]. ` + `Delegate the missing gate agents before marking task as completed.`
-        };
+        evidenceIncompleteReason = `Task ${taskId} is missing required gates: [${missingGates.join(", ")}]. ` + `Required: [${evidence.required_gates.join(", ")}]. ` + `Completed: [${Object.keys(evidence.gates).join(", ")}]. ` + `Delegate the missing gate agents before marking task as completed.`;
       }
     } catch (error93) {
       console.warn(`[gate-evidence] Evidence file for task ${taskId} is corrupt or unreadable:`, error93 instanceof Error ? error93.message : String(error93));
@@ -90957,23 +91177,18 @@ function checkReviewerGate(taskId, workingDirectory, stageBParallelEnabled = fal
       }
     }
     const currentStateStr = stateEntries.length > 0 ? stateEntries.join(", ") : "no active sessions";
-    telemetry.gateFailed("", "qa_gate", taskId, `Missing state: tests_run or complete`);
+    const finalReason = evidenceIncompleteReason ?? `Task ${taskId} has not passed QA gates. Current state by session: [${currentStateStr}]. Missing required state: tests_run or complete in at least one valid session. Do not write directly to plan files — use update_task_status after running the reviewer and test_engineer agents.`;
+    telemetry.gateFailed("", "qa_gate", taskId, evidenceIncompleteReason ? `Missing gates: evidence incomplete` : `Missing state: tests_run or complete`);
     return {
       blocked: true,
-      reason: `Task ${taskId} has not passed QA gates. Current state by session: [${currentStateStr}]. Missing required state: tests_run or complete in at least one valid session. Do not write directly to plan files — use update_task_status after running the reviewer and test_engineer agents.`
+      reason: finalReason
     };
   } catch {
     return { blocked: false, reason: "" };
   }
 }
 async function checkReviewerGateWithScope(taskId, workingDirectory) {
-  let stageBParallelEnabled = false;
-  if (workingDirectory) {
-    try {
-      const cfg = await loadPluginConfig(workingDirectory);
-      stageBParallelEnabled = cfg.parallelization?.stageB?.parallel?.enabled === true;
-    } catch {}
-  }
+  const stageBParallelEnabled = true;
   const result = checkReviewerGate(taskId, workingDirectory, stageBParallelEnabled);
   const scopeWarning = await validateDiffScope(taskId, workingDirectory).catch(() => null);
   if (!scopeWarning)
@@ -91480,9 +91695,6 @@ init_manager();
 init_create_tool();
 import fs89 from "node:fs";
 import path112 from "node:path";
-function derivePlanId5(plan) {
-  return `${plan.swarm}-${plan.title}`.replace(/[^a-zA-Z0-9-_]/g, "_");
-}
 function normalizeVerdict(verdict) {
   switch (verdict) {
     case "APPROVED":
@@ -91569,7 +91781,7 @@ async function executeWriteDriftEvidence(args2, directory) {
             timestamp: snapshotEvent.timestamp
           };
           try {
-            const planId = derivePlanId5(currentPlan);
+            const planId = derivePlanId(currentPlan);
             const locked = lockProfile(directory, planId, snapshotEvent.seq);
             qaProfileLocked = {
               plan_id: planId,
@@ -91636,9 +91848,10 @@ var write_drift_evidence = createSwarmTool({
     }
   }
 });
-// src/tools/write-hallucination-evidence.ts
+// src/tools/write-final-council-evidence.ts
 init_zod();
 init_utils2();
+init_manager();
 init_create_tool();
 import fs90 from "node:fs";
 import path113 from "node:path";
@@ -91652,7 +91865,7 @@ function normalizeVerdict2(verdict) {
       throw new Error(`Invalid verdict: must be 'APPROVED' or 'NEEDS_REVISION', got '${verdict}'`);
   }
 }
-async function executeWriteHallucinationEvidence(args2, directory) {
+async function executeWriteFinalCouncilEvidence(args2, directory) {
   const phase = args2.phase;
   if (!Number.isInteger(phase) || phase < 1) {
     return JSON.stringify({
@@ -91678,18 +91891,21 @@ async function executeWriteHallucinationEvidence(args2, directory) {
     }, null, 2);
   }
   const normalizedVerdict = normalizeVerdict2(args2.verdict);
+  const plan = await loadPlan(directory);
+  const planId = plan ? derivePlanId(plan) : "unknown";
   const evidenceEntry = {
-    type: "hallucination-verification",
+    type: "final-council",
+    phase,
+    plan_id: planId,
     verdict: normalizedVerdict,
     summary: summary.trim(),
-    timestamp: new Date().toISOString(),
-    findings: args2.findings
+    timestamp: new Date().toISOString()
   };
   const evidenceContent = {
     entries: [evidenceEntry]
   };
-  const filename = "hallucination-guard.json";
-  const relativePath = path113.join("evidence", String(phase), filename);
+  const filename = "final-council.json";
+  const relativePath = path113.join("evidence", filename);
   let validatedPath;
   try {
     validatedPath = validateSwarmPath(directory, relativePath);
@@ -91706,6 +91922,115 @@ async function executeWriteHallucinationEvidence(args2, directory) {
     const tempPath = path113.join(evidenceDir, `.${filename}.tmp`);
     await fs90.promises.writeFile(tempPath, JSON.stringify(evidenceContent, null, 2), "utf-8");
     await fs90.promises.rename(tempPath, validatedPath);
+    return JSON.stringify({
+      success: true,
+      phase,
+      verdict: normalizedVerdict,
+      message: `Final council evidence written to .swarm/evidence/final-council.json`
+    }, null, 2);
+  } catch (error93) {
+    return JSON.stringify({
+      success: false,
+      phase,
+      message: error93 instanceof Error ? error93.message : String(error93)
+    }, null, 2);
+  }
+}
+var write_final_council_evidence = createSwarmTool({
+  description: "Write final council evidence for a completed project. Accepts phase, verdict (APPROVED/NEEDS_REVISION), summary, and writes structured evidence to .swarm/evidence/final-council.json. Normalizes verdict to lowercase. Use this after convening a final holistic council to persist the verdict.",
+  args: {
+    phase: exports_external.number().int().min(1).describe("The phase number for the final council verdict (e.g., 1, 2, 3)"),
+    verdict: exports_external.enum(["APPROVED", "NEEDS_REVISION"]).describe("Verdict of the final council: 'APPROVED' or 'NEEDS_REVISION'"),
+    summary: exports_external.string().describe("Human-readable summary of the final council verdict")
+  },
+  execute: async (args2, directory) => {
+    const rawPhase = args2.phase !== undefined ? Number(args2.phase) : 0;
+    try {
+      const writeFinalCouncilEvidenceArgs = {
+        phase: Number(args2.phase),
+        verdict: String(args2.verdict),
+        summary: String(args2.summary ?? "")
+      };
+      return await executeWriteFinalCouncilEvidence(writeFinalCouncilEvidenceArgs, directory);
+    } catch (error93) {
+      return JSON.stringify({
+        success: false,
+        phase: rawPhase,
+        message: error93 instanceof Error ? error93.message : "Unknown error"
+      }, null, 2);
+    }
+  }
+});
+// src/tools/write-hallucination-evidence.ts
+init_zod();
+init_utils2();
+init_create_tool();
+import fs91 from "node:fs";
+import path114 from "node:path";
+function normalizeVerdict3(verdict) {
+  switch (verdict) {
+    case "APPROVED":
+      return "approved";
+    case "NEEDS_REVISION":
+      return "rejected";
+    default:
+      throw new Error(`Invalid verdict: must be 'APPROVED' or 'NEEDS_REVISION', got '${verdict}'`);
+  }
+}
+async function executeWriteHallucinationEvidence(args2, directory) {
+  const phase = args2.phase;
+  if (!Number.isInteger(phase) || phase < 1) {
+    return JSON.stringify({
+      success: false,
+      phase,
+      message: "Invalid phase: must be a positive integer"
+    }, null, 2);
+  }
+  const validVerdicts = ["APPROVED", "NEEDS_REVISION"];
+  if (!validVerdicts.includes(args2.verdict)) {
+    return JSON.stringify({
+      success: false,
+      phase,
+      message: "Invalid verdict: must be 'APPROVED' or 'NEEDS_REVISION'"
+    }, null, 2);
+  }
+  const summary = args2.summary;
+  if (typeof summary !== "string" || summary.trim().length === 0) {
+    return JSON.stringify({
+      success: false,
+      phase,
+      message: "Invalid summary: must be a non-empty string"
+    }, null, 2);
+  }
+  const normalizedVerdict = normalizeVerdict3(args2.verdict);
+  const evidenceEntry = {
+    type: "hallucination-verification",
+    verdict: normalizedVerdict,
+    summary: summary.trim(),
+    timestamp: new Date().toISOString(),
+    findings: args2.findings
+  };
+  const evidenceContent = {
+    entries: [evidenceEntry]
+  };
+  const filename = "hallucination-guard.json";
+  const relativePath = path114.join("evidence", String(phase), filename);
+  let validatedPath;
+  try {
+    validatedPath = validateSwarmPath(directory, relativePath);
+  } catch (error93) {
+    return JSON.stringify({
+      success: false,
+      phase,
+      message: error93 instanceof Error ? error93.message : "Failed to validate path"
+    }, null, 2);
+  }
+  const evidenceDir = path114.dirname(validatedPath);
+  try {
+    await fs91.promises.mkdir(evidenceDir, { recursive: true });
+    const tempPath = path114.join(evidenceDir, `.${filename}.tmp`);
+    await fs91.promises.writeFile(tempPath, JSON.stringify(evidenceContent, null, 2), "utf-8");
+    await fs91.promises.rename(tempPath, validatedPath);
     return JSON.stringify({
       success: true,
       phase,
@@ -91751,9 +92076,9 @@ var write_hallucination_evidence = createSwarmTool({
 init_zod();
 init_utils2();
 init_create_tool();
-import fs91 from "node:fs";
-import path114 from "node:path";
-function normalizeVerdict3(verdict) {
+import fs92 from "node:fs";
+import path115 from "node:path";
+function normalizeVerdict4(verdict) {
   switch (verdict) {
     case "PASS":
       return "pass";
@@ -91810,7 +92135,7 @@ async function executeWriteMutationEvidence(args2, directory) {
       message: "Invalid summary: must be a non-empty string"
     }, null, 2);
   }
-  const normalizedVerdict = normalizeVerdict3(args2.verdict);
+  const normalizedVerdict = normalizeVerdict4(args2.verdict);
   const evidenceEntry = {
     type: "mutation-gate",
     verdict: normalizedVerdict,
@@ -91826,7 +92151,7 @@ async function executeWriteMutationEvidence(args2, directory) {
     entries: [evidenceEntry]
   };
   const filename = "mutation-gate.json";
-  const relativePath = path114.join("evidence", String(phase), filename);
+  const relativePath = path115.join("evidence", String(phase), filename);
   let validatedPath;
   try {
     validatedPath = validateSwarmPath(directory, relativePath);
@@ -91837,12 +92162,12 @@ async function executeWriteMutationEvidence(args2, directory) {
       message: error93 instanceof Error ? error93.message : "Failed to validate path"
     }, null, 2);
   }
-  const evidenceDir = path114.dirname(validatedPath);
+  const evidenceDir = path115.dirname(validatedPath);
   try {
-    await fs91.promises.mkdir(evidenceDir, { recursive: true });
-    const tempPath = path114.join(evidenceDir, `.${filename}.tmp`);
-    await fs91.promises.writeFile(tempPath, JSON.stringify(evidenceContent, null, 2), "utf-8");
-    await fs91.promises.rename(tempPath, validatedPath);
+    await fs92.promises.mkdir(evidenceDir, { recursive: true });
+    const tempPath = path115.join(evidenceDir, `.${filename}.tmp`);
+    await fs92.promises.writeFile(tempPath, JSON.stringify(evidenceContent, null, 2), "utf-8");
+    await fs92.promises.rename(tempPath, validatedPath);
     return JSON.stringify({
       success: true,
       phase,
@@ -92134,7 +92459,7 @@ async function initializeOpenCodeSwarm(ctx) {
     const { PreflightTriggerManager: PTM } = await Promise.resolve().then(() => (init_trigger(), exports_trigger));
     preflightTriggerManager = new PTM(automationConfig);
     const { AutomationStatusArtifact: ASA } = await Promise.resolve().then(() => (init_status_artifact(), exports_status_artifact));
-    const swarmDir = path115.resolve(ctx.directory, ".swarm");
+    const swarmDir = path116.resolve(ctx.directory, ".swarm");
     statusArtifact = new ASA(swarmDir);
     statusArtifact.updateConfig(automationConfig.mode, automationConfig.capabilities);
     if (automationConfig.capabilities?.evidence_auto_summaries === true) {
@@ -92293,6 +92618,7 @@ async function initializeOpenCodeSwarm(ctx) {
       write_drift_evidence,
       write_hallucination_evidence,
       write_mutation_evidence,
+      write_final_council_evidence,
       declare_scope
     },
     config: async (opencodeConfig) => {