opencode-swarm 7.28.2 → 7.29.0

package/dist/index.js

@@ -48,7 +48,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "opencode-swarm",
-    version: "7.28.2",
+    version: "7.29.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",
@@ -16518,6 +16518,27 @@ function bunHash(input) {
   }
   return hash2;
 }
+function killProcessTreeImpl(pid, signal, directKill, wasDetached) {
+  if (typeof pid !== "number" || pid <= 0) {
+    directKill();
+    return;
+  }
+  if (process.platform === "win32") {
+    try {
+      nodeSpawnSync("taskkill", ["/PID", String(pid), "/T", "/F"]);
+    } catch {
+      directKill();
+    }
+    return;
+  }
+  if (wasDetached) {
+    try {
+      process.kill(-pid, signal ?? "SIGKILL");
+      return;
+    } catch {}
+  }
+  directKill();
+}
 function streamFromNode(pipe2) {
   const collected = new Promise((resolve) => {
     if (!pipe2) {
@@ -16640,20 +16661,34 @@ function bunSpawn(cmd, options) {
         return proc2.exitCode;
       },
       kill(sig) {
-        proc2.kill(sig);
+        if (options?.killProcessTree) {
+          killProcessTreeImpl(proc2.pid, sig, () => proc2.kill(sig), false);
+        } else {
+          proc2.kill(sig);
+        }
       }
     };
   }
   const [file2, ...args2] = cmd;
+  const detached = options?.killProcessTree === true;
   const proc = nodeSpawn(file2, args2, {
     cwd: options?.cwd,
     env: options?.env,
+    detached,
+    windowsHide: true,
     stdio: [
       mapStdio(options?.stdin),
       mapStdio(options?.stdout),
       mapStdio(options?.stderr)
     ]
   });
+  const killChild = (signal) => {
+    if (detached) {
+      killProcessTreeImpl(proc.pid, signal, () => proc.kill(signal), true);
+    } else {
+      proc.kill(signal);
+    }
+  };
   let timeoutHandle;
   const exited = new Promise((resolve) => {
     proc.on("exit", (code) => resolve(code ?? 0));
@@ -16661,7 +16696,7 @@ function bunSpawn(cmd, options) {
     if (options?.timeout && options.timeout > 0) {
       timeoutHandle = setTimeout(() => {
         try {
-          proc.kill("SIGKILL");
+          killChild("SIGKILL");
         } catch {}
       }, options.timeout);
       if (typeof timeoutHandle.unref === "function") {
@@ -16681,7 +16716,7 @@ function bunSpawn(cmd, options) {
     },
     kill(signal) {
       try {
-        proc.kill(signal);
+        killChild(signal);
       } catch {}
     }
   };
@@ -67348,7 +67383,7 @@ function defaultBuildTestCommand(profile, framework, files, dir = ".", opts = {}
   const coverage = opts.coverage ?? false;
   switch (framework) {
     case "bun": {
-      const args2 = ["bun", "test"];
+      const args2 = ["bun", "--smol", "test"];
       if (coverage)
         args2.push("--coverage");
       if (scope !== "all" && files.length > 0)
@@ -69781,7 +69816,7 @@ function getTargetedExecutionUnsupportedReason(framework) {
 function buildTestCommand2(framework, scope, files, coverage, baseDir) {
   switch (framework) {
     case "bun": {
-      const args2 = ["bun", "test"];
+      const args2 = ["bun", "--smol", "test"];
       if (coverage)
         args2.push("--coverage");
       if (scope !== "all" && files.length > 0) {
@@ -70318,17 +70353,24 @@ async function runTests(framework, scope, files, coverage, timeout_ms, cwd) {
     const proc = bunSpawn(command, {
       stdout: "pipe",
       stderr: "pipe",
-      cwd
+      stdin: "ignore",
+      cwd,
+      killProcessTree: true
+    });
+    let timeoutHandle;
+    const timeoutPromise = new Promise((resolve16) => {
+      timeoutHandle = setTimeout(() => {
+        proc.kill();
+        resolve16(-1);
+      }, timeout_ms);
     });
-    const timeoutPromise = new Promise((resolve16) => setTimeout(() => {
-      proc.kill();
-      resolve16(-1);
-    }, timeout_ms));
     const [exitCode, stdoutResult, stderrResult] = await Promise.all([
       Promise.race([proc.exited, timeoutPromise]),
       readBoundedStream(proc.stdout, MAX_OUTPUT_BYTES3),
       readBoundedStream(proc.stderr, MAX_OUTPUT_BYTES3)
     ]);
+    if (timeoutHandle !== undefined)
+      clearTimeout(timeoutHandle);
     const duration_ms = Date.now() - startTime;
     let output = stdoutResult.text;
     if (stderrResult.text) {
@@ -70631,7 +70673,6 @@ var init_test_runner = __esm(() => {
       files: exports_external.array(exports_external.string()).optional().describe('Specific files to test. For "convention", pass source files or direct test files. For "graph" and "impact", pass source files only.'),
       coverage: exports_external.boolean().optional().describe("Enable coverage reporting if supported"),
       timeout_ms: exports_external.number().optional().describe("Timeout in milliseconds (default 60000, max 300000)"),
-      allow_full_suite: exports_external.boolean().optional().describe('Explicit opt-in for scope "all". Required because full-suite output can destabilize SSE streaming.'),
       working_directory: exports_external.string().optional().describe("Explicit project root directory. When provided, tests run relative to this path instead of the plugin context directory. Use this when CWD differs from the actual project root.")
     },
     async execute(args2, directory) {
@@ -70705,7 +70746,8 @@ var init_test_runner = __esm(() => {
       }
       const scope = args2.scope || "all";
       if (scope === "all") {
-        if (!args2.allow_full_suite) {
+        const fullSuiteAllowed = process.env.SWARM_ALLOW_FULL_SUITE === "1" || process.env.SWARM_ALLOW_FULL_SUITE === "true";
+        if (!fullSuiteAllowed) {
           const errorResult = {
             success: false,
             framework: "none",
@@ -75902,58 +75944,31 @@ SECURITY_KEYWORDS: password, secret, token, credential, auth, login, encryption,
 
 ## SKILLS PROPAGATION
 
-Subagents run in isolated contexts. Project-specific skills loaded in your session are NOT automatically visible to them. Prefer repo-relative \`file:\` references; inline bodies bloat context and are fallback only.
-
-### Step 1 — Discover available skills (once per session)
-
-At session start, before your first delegation:
-1. Read contract files first: \`AGENTS.md\`, \`CLAUDE.md\`, \`CONTRIBUTING.md\`, \`TESTING.md\` when present. Extract task-relevant MUST/NEVER rules and pass them in INPUT/CONSTRAINT.
-2. Reuse \`<skill-context>\` skills when present.
-3. Otherwise use \`search\` with \`include\` patterns like \`.opencode/skills/*/SKILL.md,.claude/skills/*/SKILL.md\` and frontmatter queries \`^name:\` / \`^description:\`.
-4. Cache a short \`.swarm/context.md\` \`## Available Skills\` index. Include the repo-relative \`file:\` path and description so subagents can load on demand:
-   - writing-tests: Guidelines for writing tests (used: 12, compliance: 95%) → test_engineer, coder
-   - engineering-conventions: Engineering invariants (used: 8, compliance: 100%) → coder, reviewer, test_engineer
-   - [name]: [description] (used: N, compliance: N%) → [applicable agents]
-
-   Use \`.swarm/skill-usage.jsonl\` when present; otherwise weight skills equally.
+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. The hook system auto-injects relevant skills into delegation prompts.
 
-   If skill-usage.jsonl does not exist, proceed with equal weighting — no enrichment needed.
+### Step 1 — Skills are auto-discovered and scored
 
+The hook system discovers available skills and scores them by relevance to the task. The hook auto-injects them into the delegation prompt.
 
-### Step 2 — Route skills to agents
+### Step 2 — SKILLS: field is auto-populated
 
-Include a skill when its name/description matches:
+The hook auto-populates the \`SKILLS:\` field with top recommended skills (max 5, threshold 0.5). Explicit \`SKILLS: none\` is preserved.
 
-| Skill description / name contains…               | Pass to agents…                       |
-Route tests to test_engineer/coder; conventions to coder/reviewer/test_engineer; implementation to coder/reviewer; review/security to reviewer; docs to docs; architecture/ui/domain topics to designer or sme.
+### Step 3 — Skill references with context descriptions
 
-When uncertain, pass the skill. Missing applicable skills cause convention drift.
+When passing skill references, you may add brief context descriptions. The hook injects \`file:path (-- description)\` format.
 
-### Step 3 — Include skill references in delegations
+### Step 4 — Forward SKILLS_USED_BY_CODER to reviewer
 
-Add \`SKILLS:\` to every coder, reviewer, test_engineer, sme, docs, and designer delegation:
+When delegating to the reviewer after a coder task, include a \`SKILLS_USED_BY_CODER: [comma-separated list of skill paths from the coder delegation]\` field. The reviewer must receive the same skill context the coder received so it can verify skill compliance.
 
-- \`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
-- Descriptive multi-line catalog:
-  SKILLS:
-  - file:.claude/skills/writing-tests/SKILL.md - Guidelines for writing tests
-  - file:.claude/skills/engineering-conventions/SKILL.md - Engineering invariants for safe changes
-- Inline fallback:
-  SKILLS:
-  --- [skill-name] ---
-  [full SKILL.md body content pasted here]
+Example: If the coder received \`SKILLS: file:.claude/skills/writing-tests/SKILL.md\`, the reviewer delegation must include \`SKILLS_USED_BY_CODER: file:.claude/skills/writing-tests/SKILL.md\` in addition to the reviewer's own \`SKILLS:\` field.
 
-Default to repo-relative \`file:\` references. Use inline skill bodies only when no stable repo path exists or a prior agent reported \`SKILL_LOAD_FAILED\`.
+**Skill-to-agent routing:** Managed via \`.opencode/skill-routing.yaml\`. The hook reads this file at delegation time.
 
-**SKILL_LOAD_FAILED recovery:** do NOT retry with the same reference. Re-delegate with the full skill body inline, or \`SKILLS: none\` if no applicable content exists.
-
-**Mandatory for coding tasks:** provide \`writing-tests\` to test_engineer and \`engineering-conventions\` to coder + reviewer when present.
-
-### Step 4 — Forward skills to reviewer
-
-When delegating to reviewer after coder, include \`SKILLS_USED_BY_CODER: [comma-separated skill paths from coder]\` plus reviewer \`SKILLS:\` so compliance can be checked.
+**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.
 
 ## SWARM KNOWLEDGE DIRECTIVES (v2 acknowledgment contract)
 
@@ -75976,14 +75991,28 @@ You may also call the \`knowledge_ack\` tool to record an outcome explicitly whe
 
 ## SKILL IMPROVER (low-frequency, expensive-model adviser)
 
-Use \`skill_improver\` / \`skill_improve\` rarely for repeated review failures, ignored knowledge clusters, stale skills, or fresh spec drift. It is quota-bounded and proposal-only.
+The \`skill_improver\` agent and the \`skill_improve\` tool exist for rare, deep
+review of accumulated knowledge / skills / spec / architect prompt. They are
+quota-bounded (default 10 calls/day) and disabled by default. Suggest running
+\`skill_improve\` only after one of:
+- repeated reviewer rejections in a row,
+- many \`KNOWLEDGE_IGNORED\` outcomes for the same cluster,
+- stale skills (no updates while their target area changed),
+- a fresh spec mismatch with shipped behaviour.
 
 When \`skill_improver.require_user_approval\` is true (default), ASK the user
 before running. Default outputs are proposals only — they never modify source.
 
 ## SPEC WRITER
 
-For substantial spec authoring/revision, prefer \`spec_writer\`; it writes only via \`spec_write\`. Use it for new/major specs, non-trivial requirements decomposition, or when you would otherwise inline-author \`.swarm/spec.md\`. Handle small typos/cross-references inline.
+For substantial spec authoring or revision, prefer delegating to the
+\`spec_writer\` agent (independent model from architect). It writes only via
+the safe \`spec_write\` tool. Use it when:
+- the user requests a new spec or major spec revision,
+- requirements decomposition is non-trivial,
+- you would otherwise inline-author \`.swarm/spec.md\` yourself.
+
+Continue handling small touch-ups (typos, cross-references) inline.
 
 ### ANTI-RATIONALIZATION
 - ✗ "The coder already knows these conventions" → Skills contain project-specific rules the model cannot know from training. Always pass.
@@ -75996,7 +76025,7 @@ For substantial spec authoring/revision, prefer \`spec_writer\`; it writes only
 ## SLASH COMMANDS
 {{SLASH_COMMANDS}}
 Commands above are documented with args and behavioral details. Run commands via /swarm <command> [args].
-Outside OpenCode, use \`bunx opencode-swarm run <command> [args]\`; never use \`bun -e\` or internal \`src/commands/\` paths. Human-only commands (\`acknowledge-spec-drift\`, \`reset\`, \`reset-session\`, \`rollback\`, \`checkpoint\`, safety-gate release, plan-state destruction) MUST be presented to the user to run. Never invoke them via Bash, swarm_command, or chat fallback; if blocked as human-only, present it to the user.
+Outside OpenCode, invoke any plugin command via: \`bunx opencode-swarm run <command> [args]\` (e.g. \`bunx opencode-swarm run knowledge migrate\`). Do not use \`bun -e\` or look for \`src/commands/\` — those paths are internal to the plugin source and do not exist in user project directories. EXCEPTION — human-only commands (including but not limited to \`acknowledge-spec-drift\`, \`reset\`, \`reset-session\`, \`rollback\`, \`checkpoint\`, and any command that releases a runtime safety gate or destroys plan state): you MUST present these to the user and ask them to run the command themselves. Never invoke a human-only command via Bash, swarm_command, or chat fallback. The runtime guardrail will block such attempts; if a Bash call returns \`BLOCKED\` with a "human-only" message, do not retry under a different shell form — present the situation to the user instead.
 
 SMEs advise only. Reviewer and critic review only. None of them write code.
 
@@ -76004,15 +76033,15 @@ Available Tools: {{AVAILABLE_TOOLS}}
 
 ## DELEGATION FORMAT
 
-Delegations happen ONLY through the **Task** tool; chat text is not delivered to agents. Examples below are Task content.
+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.
 
-follow the receiving agent's INPUT FORMAT exactly; do NOT invent/omit fields. Begin with agent name, \`TASK:\`, and \`SKILLS:\` when supported.
+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]
 [agent-specific fields required by that agent's INPUT FORMAT]
-SKILLS: [either "none", repo-relative file references with descriptions, or inline skill bodies — see SKILLS PROPAGATION; use "none" only when no project-specific skill applies]
+SKILLS: [either "none", repo-relative file: references, or inline skill bodies — see SKILLS PROPAGATION; use "none" only when no project-specific skill applies]
 
 Examples:
 
@@ -76045,22 +76074,22 @@ 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 - safe code changes
+SKILLS: file:.claude/skills/engineering-conventions/SKILL.md
 
 {{AGENT_PREFIX}}reviewer
 TASK: Review login validation
 FILE: src/auth/login.ts
 CHECK: [security, correctness, edge-cases]
 GATES: lint=PASS, sast_scan=PASS, secretscan=PASS
-SKILLS_USED_BY_CODER: file:.claude/skills/engineering-conventions/SKILL.md - safe code changes
+SKILLS_USED_BY_CODER: file:.claude/skills/engineering-conventions/SKILL.md
 OUTPUT: VERDICT + RISK + ISSUES
-SKILLS: file:.claude/skills/engineering-conventions/SKILL.md - safe code changes
+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 - tests
+SKILLS: file:.claude/skills/writing-tests/SKILL.md
 
 {{AGENT_PREFIX}}critic
 TASK: Review plan for user authentication feature
@@ -76075,14 +76104,14 @@ 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 - safe code changes
+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 - tests
+SKILLS: file:.claude/skills/writing-tests/SKILL.md
 
 {{AGENT_PREFIX}}explorer
 TASK: Integration impact analysis
@@ -95075,6 +95104,9 @@ function utcDayKey(d = new Date) {
 function buildAckDedupKey(sessionId, id, result, now = new Date) {
   return `${sessionId}|${id}|${result}|${utcDayKey(now)}`;
 }
+function filterHighConfidenceKnowledge(entries, threshold = 0.8) {
+  return entries.filter((entry) => entry.confidence >= threshold);
+}
 
 // src/hooks/knowledge-application-gate.ts
 var HIGH_RISK_TOOLS = new Set([
@@ -95527,7 +95559,8 @@ function createKnowledgeInjectorHook(directory, config3) {
       currentPhase: phaseDescription
     };
     const entries = await readContextualKnowledge(directory, config3, retrievalCtx);
-    cachedShownIds = entries.map((e) => e.id);
+    const filteredEntries = filterHighConfidenceKnowledge(entries);
+    cachedShownIds = filteredEntries.map((e) => e.id);
     let freshPreamble = null;
     try {
       const driftReports = await readPriorDriftReports(directory);
@@ -95548,7 +95581,7 @@ function createKnowledgeInjectorHook(directory, config3) {
 ${freshPreamble}` : `<curator_briefing>${truncatedBriefing}</curator_briefing>`;
       }
     } catch {}
-    if (entries.length === 0) {
+    if (filteredEntries.length === 0) {
       if (freshPreamble === null)
         return;
       cachedInjectionText = freshPreamble;
@@ -95559,9 +95592,9 @@ ${freshPreamble}` : `<curator_briefing>${truncatedBriefing}</curator_briefing>`;
     const isFullBudget = effectiveBudget === maxInjectChars;
     const directiveBudget = Math.floor(effectiveBudget * 0.45);
     const lessonBudget = Math.floor(effectiveBudget * 0.3);
-    const directiveEntries = entries.filter((e) => e.triggers && e.triggers.length > 0 || e.required_actions && e.required_actions.length > 0 || e.forbidden_actions && e.forbidden_actions.length > 0 || e.directive_priority === "critical" || e.directive_priority === "high" || e.generated_skill_path);
+    const directiveEntries = filteredEntries.filter((e) => e.triggers && e.triggers.length > 0 || e.required_actions && e.required_actions.length > 0 || e.forbidden_actions && e.forbidden_actions.length > 0 || e.directive_priority === "critical" || e.directive_priority === "high" || e.generated_skill_path);
     const directiveBlock = buildDirectiveBlock(directiveEntries, directiveBudget, config3);
-    const lessonBlock = buildKnowledgeBlock(entries, lessonBudget, config3, projectName);
+    const lessonBlock = buildKnowledgeBlock(filteredEntries, lessonBudget, config3, projectName);
     const parts2 = [];
     let remaining = effectiveBudget;
     if (directiveBlock) {
@@ -95603,7 +95636,7 @@ ${freshPreamble}` : `<curator_briefing>${truncatedBriefing}</curator_briefing>`;
     injectKnowledgeMessage(output, cachedInjectionText);
     const sessionID = systemMsg?.info?.sessionID;
     if (sessionID) {
-      const criticalIds = entries.filter((e) => e.directive_priority === "critical" && e.status !== "archived").map((e) => e.id);
+      const criticalIds = filteredEntries.filter((e) => e.directive_priority === "critical" && e.status !== "archived").map((e) => e.id);
       if (criticalIds.length > 0) {
         setCriticalShownIds(sessionID, {
           ids: criticalIds,
@@ -96137,8 +96170,12 @@ function getSkillStats(skillPath, directory) {
   };
 }
 function formatSkillIndexWithContext(skills, directory) {
-  const allEntries = readSkillUsageEntries(directory);
-  const hasHistory = allEntries.length > 0;
+  const usageLogPath = path89.join(directory, ".swarm", "skill-usage.jsonl");
+  let hasHistory = false;
+  try {
+    const stat7 = fs62.statSync(usageLogPath);
+    hasHistory = stat7.size > 0;
+  } catch {}
   if (!hasHistory) {
     return skills.map((sp) => {
       const meta3 = _internals42.readSkillMetadata(sp, directory);
@@ -96168,6 +96205,121 @@ _internals42.computeRecencyScore = computeRecencyScore;
 _internals42.computeContextMatchScore = computeContextMatchScore;
 
 // src/hooks/skill-propagation-gate.ts
+function parseSimpleYaml(content) {
+  const lines = content.split(`
+`);
+  const result = {};
+  let _currentSection = null;
+  let currentSubSection = null;
+  let currentList = [];
+  let currentListItem = null;
+  for (const line of lines) {
+    if (!line.trim() || line.trim().startsWith("#"))
+      continue;
+    const indent = line.search(/\S/);
+    const trimmed = line.trim();
+    if (indent === 0 && trimmed.endsWith(":")) {
+      if (_currentSection && currentSubSection && currentList.length > 0) {
+        if (!result[_currentSection]) {
+          result[_currentSection] = {};
+        }
+        result[_currentSection][currentSubSection] = currentList;
+      } else if (currentSubSection && currentList.length > 0) {
+        result[currentSubSection] = currentList;
+      }
+      _currentSection = trimmed.slice(0, -1);
+      currentSubSection = null;
+      currentList = [];
+      currentListItem = null;
+      continue;
+    }
+    if (indent === 2 && trimmed.endsWith(":")) {
+      if (_currentSection && currentSubSection && currentList.length > 0) {
+        if (!result[_currentSection]) {
+          result[_currentSection] = {};
+        }
+        result[_currentSection][currentSubSection] = currentList;
+      } else if (currentSubSection && currentList.length > 0) {
+        result[currentSubSection] = currentList;
+      }
+      currentSubSection = trimmed.slice(0, -1);
+      currentList = [];
+      currentListItem = null;
+      continue;
+    }
+    if (trimmed.startsWith("- ")) {
+      currentListItem = null;
+      const rest = trimmed.slice(2);
+      if (rest.includes(":")) {
+        const colonIndex = rest.indexOf(":");
+        const key = rest.slice(0, colonIndex).trim();
+        const value = rest.slice(colonIndex + 1).trim();
+        currentListItem = { [key]: parseYamlValue(value) };
+      } else {
+        currentListItem = { path: trimmed.slice(2) };
+      }
+      currentList.push(currentListItem);
+      continue;
+    }
+    if (indent >= 4 && currentListItem) {
+      if (trimmed.includes(":")) {
+        const colonIndex = trimmed.indexOf(":");
+        const key = trimmed.slice(0, colonIndex).trim();
+        const value = trimmed.slice(colonIndex + 1).trim();
+        currentListItem[key] = parseYamlValue(value);
+      }
+    }
+  }
+  if (currentSubSection && currentList.length > 0) {
+    if (_currentSection) {
+      if (!result[_currentSection]) {
+        result[_currentSection] = {};
+      }
+      result[_currentSection][currentSubSection] = currentList;
+    } else {
+      result[currentSubSection] = currentList;
+    }
+  }
+  return result;
+}
+function parseYamlValue(value) {
+  const trimmed = value.trim();
+  if (trimmed.startsWith('"') && trimmed.endsWith('"') || trimmed.startsWith("'") && trimmed.endsWith("'")) {
+    return trimmed.slice(1, -1);
+  }
+  if (trimmed.startsWith("[") && trimmed.endsWith("]")) {
+    const inner = trimmed.slice(1, -1);
+    if (!inner.trim())
+      return [];
+    return inner.split(",").map((s) => s.trim().replace(/^["']|["']$/g, ""));
+  }
+  if (trimmed.toLowerCase() === "true")
+    return true;
+  if (trimmed.toLowerCase() === "false")
+    return false;
+  if (/^-?\d+(\.\d+)?$/.test(trimmed)) {
+    return trimmed.includes(".") ? parseFloat(trimmed) : parseInt(trimmed, 10);
+  }
+  return trimmed;
+}
+function loadRoutingSkills(directory, targetAgent) {
+  const routingPath = path90.join(directory, ".opencode", "skill-routing.yaml");
+  if (!_internals43.existsSync(routingPath))
+    return [];
+  try {
+    const content = _internals43.readFileSync(routingPath, "utf-8");
+    const config3 = parseSimpleYaml(content);
+    if (!config3?.routing)
+      return [];
+    const routing = config3.routing;
+    const routingEntries = routing[targetAgent];
+    if (!routingEntries || routingEntries.length === 0)
+      return [];
+    return routingEntries.map((entry) => entry.path);
+  } catch {
+    return [];
+  }
+}
 var SKILL_CAPABLE_AGENTS = new Set([
   "coder",
   "reviewer",
@@ -96200,11 +96352,12 @@ var _internals43 = {
   appendSkillUsageEntry,
   readSkillUsageEntries,
   readSkillUsageEntriesTail,
-  extractSkillsFieldFromPrompt: null,
   parseSkillPaths: null,
   extractTaskIdFromPrompt: null,
+  extractSkillsFieldFromPrompt: null,
   computeSkillRelevanceScore,
-  formatSkillIndexWithContext
+  formatSkillIndexWithContext,
+  loadRoutingSkills: null
 };
 function discoverAvailableSkills(directory) {
   const results = [];
@@ -96312,22 +96465,21 @@ function parseSkillPaths(fieldValue) {
   const trimmed = fieldValue.trim();
   if (trimmed.toLowerCase() === "none" || trimmed === "")
     return [];
-  const lines = trimmed.split(/\r?\n/);
-  const hasCatalogLines = lines.some((line) => /^(?:-|\*|\d+\.)\s+/.test(line.trim()));
-  const parts2 = hasCatalogLines ? lines : trimmed.split(",");
-  const paths = [];
-  for (const rawPart of parts2) {
-    const part = rawPart.trim().replace(/^(?:-|\*|\d+\.)\s+/, "").trim();
-    if (!part || part.toLowerCase() === "none")
-      continue;
-    const fileRef = part.match(/\bfile:[^\s,;)\]]+/);
-    if (fileRef) {
-      paths.push(fileRef[0].replace(/\\/g, "/"));
-      continue;
-    }
-    paths.push(part);
-  }
-  return [...new Set(paths)];
+  const commaParts = trimmed.split(",").map((s) => s.trim()).filter((s) => s.length > 0);
+  if (commaParts.length === 1 && commaParts[0].startsWith("- ")) {
+    const newlineParts = trimmed.split(`
+`).map((s) => s.trim()).filter((s) => s.startsWith("- ")).map((s) => s.slice(2).trim());
+    return newlineParts.map((s) => {
+      const parenIndex = s.indexOf("(--");
+      const pathOnly = parenIndex !== -1 ? s.slice(0, parenIndex).trim() : s;
+      const dashIndex = pathOnly.search(/\s+[-–—]\s+/);
+      return dashIndex !== -1 ? pathOnly.slice(0, dashIndex).trim() : pathOnly;
+    }).filter((s) => s.length > 0);
+  }
+  return commaParts.map((s) => {
+    const parenIndex = s.indexOf("(--");
+    return parenIndex !== -1 ? s.slice(0, parenIndex).trim() : s;
+  }).filter((s) => s.length > 0);
 }
 function extractTaskIdFromPrompt(prompt) {
   if (!prompt || typeof prompt !== "string")
@@ -96342,22 +96494,22 @@ function extractTaskIdFromPrompt(prompt) {
 }
 async function skillPropagationGateBefore(directory, input, config3) {
   if (!config3.enabled)
-    return { blocked: false, reason: null };
+    return { blocked: false, reason: null, recommendedSkills: undefined };
   const toolName = typeof input.tool === "string" ? input.tool : "";
   if (toolName !== "task" && toolName !== "Task")
-    return { blocked: false, reason: null };
+    return { blocked: false, reason: null, recommendedSkills: undefined };
   const agentRaw = typeof input.agent === "string" ? input.agent : "";
   if (!agentRaw)
-    return { blocked: false, reason: null };
+    return { blocked: false, reason: null, recommendedSkills: undefined };
   const baseAgent = stripKnownSwarmPrefix(agentRaw);
   if (baseAgent !== "architect")
-    return { blocked: false, reason: null };
+    return { blocked: false, reason: null, recommendedSkills: undefined };
   const parsed = _internals43.parseDelegationArgs(input.args);
   if (!parsed)
-    return { blocked: false, reason: null };
+    return { blocked: false, reason: null, recommendedSkills: undefined };
   const targetBase = stripKnownSwarmPrefix(parsed.targetAgent);
   if (!_internals43.SKILL_CAPABLE_AGENTS.has(targetBase))
-    return { blocked: false, reason: null };
+    return { blocked: false, reason: null, recommendedSkills: undefined };
   const sessionID = typeof input.sessionID === "string" ? input.sessionID : "unknown";
   const availableSkills = _internals43.discoverAvailableSkills(directory);
   const skillsValue = parsed.skillsField.trim();
@@ -96420,6 +96572,23 @@ async function skillPropagationGateBefore(directory, input, config3) {
       warn(`[skill-propagation-gate] skill scoring failed (non-blocking): ${err2 instanceof Error ? err2.message : String(err2)}`);
     }
   }
+  try {
+    const routingPaths = _internals43.loadRoutingSkills(directory, targetBase);
+    if (routingPaths.length > 0) {
+      const existingPaths = new Set(scored.map((s) => s.skillPath));
+      for (const routingPath of routingPaths) {
+        if (!existingPaths.has(routingPath)) {
+          scored.push({
+            skillPath: routingPath,
+            score: 0.9,
+            usageCount: 0
+          });
+          existingPaths.add(routingPath);
+        }
+      }
+      scored.sort((a, b) => b.score - a.score || b.usageCount - a.usageCount);
+    }
+  } catch {}
   if (availableSkills.length > 0) {
     try {
       let skillsForIndex = availableSkills;
@@ -96478,14 +96647,14 @@ ${newSection}`;
     const coderHadSkills = skillsValue.length > 0 && skillsValue.toLowerCase() !== "none";
     if (!hasSkillsUsedByCoder && coderHadSkills) {
       const message = `SKILLS_USED_BY_CODER warning: Delegating to reviewer without SKILLS_USED_BY_CODER field. ` + `Add SKILLS_USED_BY_CODER with the skills the coder received for this task.`;
-      return { blocked: false, reason: message };
+      return { blocked: false, reason: message, recommendedSkills: undefined };
     }
   }
   if (availableSkills.length === 0)
-    return { blocked: false, reason: null };
+    return { blocked: false, reason: null, recommendedSkills: undefined };
   const skillsLower = skillsValue.toLowerCase();
   if (skillsValue && skillsLower !== "none")
-    return { blocked: false, reason: null };
+    return { blocked: false, reason: null, recommendedSkills: scored };
   const skillNames = availableSkills.map((p) => {
     const parts2 = p.split("/");
     return parts2[parts2.length - 2] ?? p;
@@ -96505,9 +96674,9 @@ ${newSection}`;
   } catch {}
   if (config3.enforce) {
     const blockedMsg = `Blocked by skill propagation gate: Delegating to ${targetBase} without SKILLS field. ` + `Available skills: ${skillNames.join(", ")}. ` + `Add a SKILLS: field or set enforce: false in config.`;
-    return { blocked: true, reason: blockedMsg };
+    return { blocked: true, reason: blockedMsg, recommendedSkills: undefined };
   }
-  return { blocked: false, reason: warningMsg };
+  return { blocked: false, reason: warningMsg, recommendedSkills: undefined };
 }
 var COMPLIANCE_PATTERN = /SKILL_COMPLIANCE\s*:\s*(COMPLIANT|PARTIAL|VIOLATED)(?:\s*(?:—|-)\s*(.*))?\s*$/i;
 var CODER_SKILLS_PATTERN = /SKILLS_USED_BY_CODER\s*:\s*(.+)/i;
@@ -96616,10 +96785,8 @@ async function skillPropagationTransformScan(directory, output, sessionID) {
       continue;
     let currentTargetAgent = "";
     let skillsField = "";
-    const textLines = text.split(`
-`);
-    for (let lineIndex = 0;lineIndex < textLines.length; lineIndex++) {
-      const line = textLines[lineIndex] ?? "";
+    for (const line of text.split(`
+`)) {
       const trimmed = line.trim();
       if (trimmed.match(/TO\s+(coder|reviewer|test_engineer|sme|docs|designer)/i)) {
         const agentMatch = trimmed.match(/TO\s+(coder|reviewer|test_engineer|sme|docs|designer)/i);
@@ -96627,8 +96794,7 @@ async function skillPropagationTransformScan(directory, output, sessionID) {
           currentTargetAgent = agentMatch[1].toLowerCase();
       }
       if (trimmed.startsWith("SKILLS:")) {
-        skillsField = _internals43.extractSkillsFieldFromPrompt(textLines.slice(lineIndex).join(`
-`));
+        skillsField = trimmed.slice("SKILLS:".length).trim();
       }
       if (currentTargetAgent && skillsField && skillsField.toLowerCase() !== "none") {
         const skillPaths = _internals43.parseSkillPaths(skillsField);
@@ -96664,10 +96830,11 @@ _internals43.skillPropagationTransformScan = skillPropagationTransformScan;
 _internals43.writeWarnEvent = writeWarnEvent2;
 _internals43.discoverAvailableSkills = discoverAvailableSkills;
 _internals43.parseDelegationArgs = parseDelegationArgs;
-_internals43.extractSkillsFieldFromPrompt = extractSkillsFieldFromPrompt;
 _internals43.parseSkillPaths = parseSkillPaths;
 _internals43.extractTaskIdFromPrompt = extractTaskIdFromPrompt;
+_internals43.extractSkillsFieldFromPrompt = extractSkillsFieldFromPrompt;
 _internals43.formatSkillIndexWithContext = formatSkillIndexWithContext;
+_internals43.loadRoutingSkills = loadRoutingSkills;
 
 // src/hooks/slop-detector.ts
 import * as fs64 from "node:fs";
@@ -99949,7 +100116,7 @@ import {
   readFileSync as readFileSync44,
   writeFileSync as writeFileSync17
 } from "node:fs";
-import { join as join83 } from "node:path";
+import { join as join84 } from "node:path";
 var EVIDENCE_DIR2 = ".swarm/evidence";
 var VALID_TASK_ID = /^\d+\.\d+(\.\d+)*$/;
 var COUNCIL_GATE_NAME = "council";
@@ -99983,9 +100150,9 @@ function writeCouncilEvidence(workingDir, synthesis) {
   if (!VALID_TASK_ID.test(synthesis.taskId)) {
     throw new Error(`writeCouncilEvidence: invalid taskId "${synthesis.taskId}" — must match N.M or N.M.P format`);
   }
-  const dir = join83(workingDir, EVIDENCE_DIR2);
+  const dir = join84(workingDir, EVIDENCE_DIR2);
   mkdirSync25(dir, { recursive: true });
-  const filePath = join83(dir, `${synthesis.taskId}.json`);
+  const filePath = join84(dir, `${synthesis.taskId}.json`);
   const existingRoot = Object.create(null);
   if (existsSync53(filePath)) {
     try {
@@ -100019,7 +100186,7 @@ function writeCouncilEvidence(workingDir, synthesis) {
     updated.required_gates = [];
   writeFileSync17(filePath, JSON.stringify(updated, null, 2));
   try {
-    const councilDir = join83(workingDir, ".swarm", "council");
+    const councilDir = join84(workingDir, ".swarm", "council");
     mkdirSync25(councilDir, { recursive: true });
     const auditLine = JSON.stringify({
       round: synthesis.roundNumber,
@@ -100027,7 +100194,7 @@ function writeCouncilEvidence(workingDir, synthesis) {
       timestamp: synthesis.timestamp,
       vetoedBy: synthesis.vetoedBy
     });
-    appendFileSync12(join83(councilDir, `${synthesis.taskId}.rounds.jsonl`), `${auditLine}
+    appendFileSync12(join84(councilDir, `${synthesis.taskId}.rounds.jsonl`), `${auditLine}
 `);
   } catch (auditError) {
     console.warn(`writeCouncilEvidence: failed to append round-history audit log: ${auditError instanceof Error ? auditError.message : String(auditError)}`);
@@ -100350,20 +100517,20 @@ function buildFinalCouncilFeedback(projectSummary, verdict, vetoedBy, requiredFi
 
 // src/council/criteria-store.ts
 import { existsSync as existsSync54, mkdirSync as mkdirSync26, readFileSync as readFileSync45, writeFileSync as writeFileSync18 } from "node:fs";
-import { join as join84 } from "node:path";
+import { join as join85 } from "node:path";
 var COUNCIL_DIR = ".swarm/council";
 function writeCriteria(workingDir, taskId, criteria) {
-  const dir = join84(workingDir, COUNCIL_DIR);
+  const dir = join85(workingDir, COUNCIL_DIR);
   mkdirSync26(dir, { recursive: true });
   const payload = {
     taskId,
     criteria,
     declaredAt: new Date().toISOString()
   };
-  writeFileSync18(join84(dir, `${safeId(taskId)}.json`), JSON.stringify(payload, null, 2));
+  writeFileSync18(join85(dir, `${safeId(taskId)}.json`), JSON.stringify(payload, null, 2));
 }
 function readCriteria(workingDir, taskId) {
-  const filePath = join84(workingDir, COUNCIL_DIR, `${safeId(taskId)}.json`);
+  const filePath = join85(workingDir, COUNCIL_DIR, `${safeId(taskId)}.json`);
   if (!existsSync54(filePath))
     return null;
   try {
@@ -118885,6 +119052,73 @@ async function initializeOpenCodeSwarm(ctx) {
         skillSession.pendingAdvisoryMessages ??= [];
         skillSession.pendingAdvisoryMessages.push(skillResult.reason);
       }
+      if (skillResult.recommendedSkills && skillResult.recommendedSkills.length > 0) {
+        const argsRecord = input.args;
+        const promptRaw = argsRecord.prompt;
+        if (typeof promptRaw === "string") {
+          const parsedDelegation = parseDelegationArgs(input.args);
+          if (parsedDelegation) {
+            const existingSkills = parsedDelegation.skillsField.trim();
+            if (!existingSkills) {
+              const qualified = skillResult.recommendedSkills.filter((s) => s.score >= 0.5);
+              if (qualified.length === 0) {
+                argsRecord.prompt = `SKILLS: none
+
+${promptRaw}`;
+                console.warn("[skill-propagation-gate] No skills above threshold 0.5 — injected SKILLS: none");
+              } else {
+                const topSkills = qualified.slice(0, 5);
+                const SKILL_DESCRIPTIONS = {
+                  "writing-tests": "Guidelines for writing tests",
+                  "engineering-conventions": "Engineering invariants and conventions",
+                  "running-tests": "Safe test execution patterns",
+                  "commit-pr": "Commit and PR workflow",
+                  "swarm-implement": "Swarm implementation workflow",
+                  "issue-tracer": "Issue investigation workflow",
+                  "qa-sweep": "QA sweep workflow",
+                  "research-first": "Research-driven approach",
+                  "swarm-pr-review": "PR review workflow",
+                  "tech-debt-ci-review": "Tech debt and CI review",
+                  browse: "Fast web browsing",
+                  code: "Expert coding workflow",
+                  review: "Pre-landing PR review",
+                  "ci-failure-resolver": "CI/CD failure resolution"
+                };
+                const skillPaths = topSkills.map((s) => {
+                  const dirName = path144.basename(path144.dirname(s.skillPath));
+                  const desc = SKILL_DESCRIPTIONS[dirName] ?? dirName;
+                  return `file:${s.skillPath} (-- ${desc})`;
+                }).join(", ");
+                const skillsLine = `SKILLS: ${skillPaths}`;
+                const newPrompt = `${skillsLine}
+
+${promptRaw}`;
+                argsRecord.prompt = newPrompt;
+                const skillNames = topSkills.map((s) => `${path144.basename(s.skillPath)} (score: ${s.score.toFixed(2)})`).join(", ");
+                console.warn(`[skill-propagation-gate] Injected skills: ${skillNames}`);
+                for (const skill of topSkills) {
+                  try {
+                    appendSkillUsageEntry(ctx.directory, {
+                      skillPath: skill.skillPath,
+                      agentName: String(input.agent),
+                      taskID: "injection",
+                      timestamp: new Date().toISOString(),
+                      complianceVerdict: "not_checked",
+                      sessionID: input.sessionID
+                    });
+                  } catch {}
+                }
+                const targetAgent = parsedDelegation.targetAgent.toLowerCase();
+                if (targetAgent.includes("reviewer")) {
+                  const usedByCoderLine = `SKILLS_USED_BY_CODER: ${topSkills.map((s) => `file:${s.skillPath}`).join(", ")}`;
+                  argsRecord.prompt = `${newPrompt}
+${usedByCoderLine}`;
+                }
+              }
+            }
+          }
+        }
+      }
       if (swarmState.lastBudgetPct >= 50) {
         const pressureSession = ensureAgentSession(input.sessionID, swarmState.activeAgent.get(input.sessionID) ?? ORCHESTRATOR_NAME);
         if (!pressureSession.contextPressureWarningSent) {