opencode-swarm 7.0.3 → 7.1.1

package/README.md

@@ -2,7 +2,9 @@
 
 <div align="center">
 
-**Your AI writes the code. Swarm makes sure it actually works.**
+# Your AI writes the code. Swarm proves it works.
+
+**Closing the trust gap between "the model said it's done" and "this actually works in production."**
 
 [![npm version](https://img.shields.io/npm/v/opencode-swarm?color=brightgreen&label=npm)](https://www.npmjs.com/package/opencode-swarm)
 [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
@@ -14,7 +16,7 @@
 
 ---
 
-OpenCode Swarm is a plugin for [OpenCode](https://opencode.ai) that turns a single AI coding session into an **architect-led team of 17 specialized agents**. One agent writes the code. A different agent reviews it. Another writes and runs tests. Another checks security. **Nothing ships until every required gate passes.**
+OpenCode Swarm is a plugin for [OpenCode](https://opencode.ai) that turns a single AI coding session into an **architect-led team of specialized core, optional, and conditional agents** — see `/swarm agents` for the live roster. One agent writes the code. A different agent reviews it. Another writes and runs tests. Another checks security. **Nothing ships until every required gate passes.**
 
 ```bash
 bunx opencode-swarm install
@@ -22,13 +24,15 @@ bunx opencode-swarm install
 
 > This single command installs the package, registers it as an OpenCode plugin, disables conflicting default agents, and creates a ready-to-edit config at `~/.config/opencode/opencode-swarm.json`. Requires [Bun](https://bun.sh) (`bun --version` to check). If you must use npm: `npm install -g opencode-swarm && opencode-swarm install`.
 
+> ⚠️ **You must select the Swarm architect mode/agent in OpenCode after install.** The default OpenCode `Build` and `Plan` modes **bypass this plugin entirely** — none of the gates, reviewers, or test agents below run. Open the OpenCode mode/agent picker and choose the Swarm architect once; it then coordinates every other agent automatically. If you ever see Swarm "do nothing," this is almost always the cause.
+
 ### Why Swarm?
 
 Most AI coding tools let one model write code and ask that same model whether the code is good. That misses too much. Swarm separates planning, implementation, review, testing, and documentation into specialized internal roles — and enforces gated execution so agents never mutate the codebase in parallel.
 
 ### Key Features
 
-- 🏗️ **18 specialized agents (9 core + 5 optional + 4 conditional)** — architect, coder, reviewer, test_engineer, critic, explorer, sme, docs, designer, critic_oversight, critic_sounding_board, critic_drift_verifier, critic_hallucination_verifier, curator_init, curator_phase, council_generalist, council_skeptic, council_domain_expert
+- 🏗️ **Specialized core, optional, and conditional agents** — architect, coder, reviewer, test_engineer, critic, explorer, sme, docs, designer, critic_oversight, critic_sounding_board, critic_drift_verifier, critic_hallucination_verifier, curator_init, curator_phase, council_generalist, council_skeptic, council_domain_expert. Run `/swarm agents` for the live roster — that is the source of truth, not this list.
 - 🔒 **Gated pipeline** — code never ships without reviewer + test engineer approval
 - 🔄 **Phase completion gates** — completion-verify and drift verifier gates enforced before phase completion
 - 🔁 **Resumable sessions** — all state saved to `.swarm/`; pick up any project any day
@@ -37,7 +41,20 @@ Most AI coding tools let one model write code and ask that same model whether th
 - 🆓 **Free tier** — works with OpenCode Zen's free model roster
 - ⚙️ **Fully configurable** — override any agent's model, disable agents, tune guardrails
 
-> **You select a Swarm architect once in the OpenCode GUI.** The architect coordinates all other agents automatically — you never manually switch between internal roles. If you use the default OpenCode `Build` / `Plan` modes, the plugin is bypassed entirely.
+> **You select a Swarm architect once in the OpenCode GUI.** The architect coordinates all other agents automatically — you never manually switch between internal roles. If you use the default OpenCode `Build` / `Plan` modes, the plugin is bypassed entirely (see the install warning above).
+
+---
+
+## What Swarm Catches
+
+Concrete classes of failure that Swarm gates exist to stop — every item ties to an agent or pipeline gate that already runs in this repo:
+
+- **Hallucinated APIs and citations** — `critic_hallucination_verifier` verifies referenced APIs and citations against real sources before they reach the codebase.
+- **Missing tests and regressions** — `test_engineer` writes and runs tests on every task; the architect runs a regression sweep across the graph after each task (pipeline step `5l`).
+- **Unsafe secret and logging patterns** — `secretscan` and `sast_scan` (63+ rules across 9 languages, offline) run as part of the per-task `pre_check_batch`.
+- **Plan and spec drift** — `critic_drift_verifier` is a blocking phase-completion gate; `curator_phase` also flags workflow drift across phases.
+- **Placeholders and TODO stubs** — `placeholder_scan` runs in the per-task pipeline (step `5d`) and rejects code that ships incomplete stubs.
+- **Untrusted plans** — `critic` reviews the plan before any code is written; `completion-verify` is a deterministic phase-close gate that checks plan task identifiers actually exist in source files.
 
 ---
 
@@ -107,6 +124,62 @@ The 15-minute guide covers:
 
 ---
 
+## 30-Second Demo
+
+No animated GIF is shipped in the repo — instead, here is the exact terminal session you can record yourself with `asciinema rec demo.cast` (or any screen recorder). Every command below is real and runs against this repo as published.
+
+**Recording script (copy/paste-able, ~30 seconds):**
+
+```bash
+# 1. Install the plugin (5s)
+bunx opencode-swarm install
+
+# 2. Open opencode and select the Swarm architect mode/agent in the picker
+#    (this step is manual in the OpenCode UI — without it, the plugin is bypassed)
+opencode
+
+# 3. Inside the OpenCode session, verify Swarm is live (5s)
+/swarm diagnose
+/swarm agents
+
+# 4. Kick off a task — the architect plans, then gates fire automatically (15s)
+Build me a JWT auth helper with tests.
+
+# 5. Watch the gates land in real time (5s)
+/swarm status
+/swarm evidence
+```
+
+**ASCII storyboard** of what a viewer should see:
+
+```
+┌──────────────────────────────────────────────────────────────┐
+│ $ bunx opencode-swarm install                                │
+│ ✓ installed opencode-swarm                                   │
+│ ✓ wrote ~/.config/opencode/opencode-swarm.json               │
+│                                                              │
+│ $ opencode                                                   │
+│ [mode picker] → select: Swarm Architect                      │
+│                                                              │
+│ > /swarm diagnose                                            │
+│ ✓ plugin loaded   ✓ agents registered   ✓ gates armed        │
+│                                                              │
+│ > Build me a JWT auth helper with tests.                     │
+│ [architect]  PLAN → critic gate → APPROVED                   │
+│ [coder]      task 1.1 implementing…                          │
+│ [reviewer]   correctness OK                                  │
+│ [test_eng.]  3 tests written, 3 pass                         │
+│ [architect]  regression sweep clean → phase_complete         │
+│                                                              │
+│ > /swarm evidence                                            │
+│ task 1.1: review ✓  tests ✓  sast ✓  secrets ✓  drift ✓      │
+└──────────────────────────────────────────────────────────────┘
+```
+
+Each row corresponds to a real gate documented further down this README — none are simulated.
+
+---
+
 ## Upgrading
 
 **OpenCode caches plugins indefinitely.** A normal OpenCode restart does **not**
@@ -154,7 +227,7 @@ See [docs/commands.md](docs/commands.md) for the full reference (41 commands).
 
 ## The Agents
 
-Swarm has 17 specialized agents (9 core + 5 optional + 3 conditional). You don't manually switch between them — the architect coordinates automatically.
+Swarm registers a roster of specialized core, optional, and conditional agents. The exact count shifts as agents are added or feature-flagged, so treat `/swarm agents` as the live source of truth — that command lists what is actually registered in your session. You don't manually switch between them — the architect coordinates automatically.
 
 | Agent | Role | Badge |
 |---|---|---|
@@ -239,7 +312,7 @@ graph TB
 
 | Feature | Swarm | oh-my-opencode | get-shit-done |
 |---|:-:|:-:|:-:|
-| Multiple specialized agents | ✅ 17 agents | ❌ | ❌ |
+| Multiple specialized agents | ✅ Core + optional + conditional roster (`/swarm agents`) | ❌ | ❌ |
 | Plan reviewed before coding | ✅ | ❌ | ❌ |
 | Every task reviewed + tested | ✅ | ❌ | ❌ |
 | Different model for review vs. code | ✅ | ❌ | ❌ |

package/dist/agents/coder.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/agents/reviewer.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/cli/index.js

@@ -33,8 +33,11 @@ var __require = import.meta.require;
 var init_errors = () => {};
 
 // src/utils/logger.ts
+function isDebug() {
+  return process.env.OPENCODE_SWARM_DEBUG === "1";
+}
 function log(message, data) {
-  if (!DEBUG)
+  if (!isDebug())
     return;
   const timestamp = new Date().toISOString();
   if (data !== undefined) {
@@ -44,7 +47,7 @@ function log(message, data) {
   }
 }
 function warn(message, data) {
-  if (!DEBUG)
+  if (!isDebug())
     return;
   const timestamp = new Date().toISOString();
   if (data !== undefined) {
@@ -53,10 +56,6 @@ function warn(message, data) {
     console.warn(`[opencode-swarm ${timestamp}] WARN: ${message}`);
   }
 }
-var DEBUG;
-var init_logger = __esm(() => {
-  DEBUG = process.env.OPENCODE_SWARM_DEBUG === "1";
-});
 
 // src/utils/merge.ts
 function deepMergeInternal(base, override, depth) {
@@ -96,7 +95,6 @@ function simpleGlobToRegex(pattern, flags = "i") {
 // src/utils/index.ts
 var init_utils = __esm(() => {
   init_errors();
-  init_logger();
 });
 
 // src/utils/bun-compat.ts
@@ -18911,7 +18909,7 @@ import * as path35 from "path";
 // package.json
 var package_default = {
   name: "opencode-swarm",
-  version: "7.0.3",
+  version: "7.1.1",
   description: "Architect-centric agentic swarm plugin for OpenCode - hub-and-spoke orchestration with SME consultation, code generation, and QA review",
   main: "dist/index.js",
   types: "dist/index.d.ts",
@@ -20505,7 +20503,6 @@ function getEffectiveGates(profile, sessionOverrides) {
 
 // src/hooks/delegation-gate.ts
 init_telemetry();
-init_logger();
 
 // node_modules/quick-lru/index.js
 class QuickLRU extends Map {
@@ -20980,7 +20977,6 @@ function clearAllScopes(directory) {
 init_telemetry();
 init_utils();
 init_bun_compat();
-init_logger();
 
 // src/hooks/conflict-resolution.ts
 init_telemetry();
@@ -34277,7 +34273,6 @@ import path13 from "path";
 init_manager2();
 
 // src/git/branch.ts
-init_logger();
 import * as child_process2 from "child_process";
 var GIT_TIMEOUT_MS2 = 30000;
 function gitExec2(args, cwd) {
@@ -34518,7 +34513,6 @@ function resetToRemoteBranch(cwd, options) {
     };
   }
 }
-
 // src/hooks/knowledge-store.ts
 var import_proper_lockfile3 = __toESM(require_proper_lockfile(), 1);
 import { existsSync as existsSync7 } from "fs";
@@ -34928,12 +34922,12 @@ function validateLesson(candidate, existingLessons, meta3) {
 }
 async function quarantineEntry(directory, entryId, reason, reportedBy) {
   if (!directory || directory.includes("..")) {
-    console.warn("[knowledge-validator] quarantineEntry: directory traversal attempt blocked");
+    warn("[knowledge-validator] quarantineEntry: directory traversal attempt blocked");
     return;
   }
   if (!entryId || entryId.includes("\x00") || entryId.includes(`
 `)) {
-    console.warn("[knowledge-validator] quarantineEntry: invalid entryId rejected");
+    warn("[knowledge-validator] quarantineEntry: invalid entryId rejected");
     return;
   }
   const validReportedBy = ["architect", "user", "auto"];
@@ -34993,12 +34987,12 @@ async function quarantineEntry(directory, entryId, reason, reportedBy) {
 }
 async function restoreEntry(directory, entryId) {
   if (!directory || directory.includes("..")) {
-    console.warn("[knowledge-validator] restoreEntry: directory traversal attempt blocked");
+    warn("[knowledge-validator] restoreEntry: directory traversal attempt blocked");
     return;
   }
   if (!entryId || entryId.includes("\x00") || entryId.includes(`
 `)) {
-    console.warn("[knowledge-validator] restoreEntry: invalid entryId rejected");
+    warn("[knowledge-validator] restoreEntry: invalid entryId rejected");
     return;
   }
   const knowledgePath = path11.join(directory, ".swarm", "knowledge.jsonl");
@@ -36257,7 +36251,6 @@ function getGlobalEventBus() {
 // src/hooks/curator.ts
 init_manager();
 init_bun_compat();
-init_logger();
 init_utils2();
 
 // src/hooks/hive-promoter.ts
@@ -40358,7 +40351,6 @@ ${USAGE2}`;
 import { join as join22 } from "path";
 
 // src/hooks/knowledge-migrator.ts
-init_logger();
 import { randomUUID as randomUUID2 } from "crypto";
 import { existsSync as existsSync13, readFileSync as readFileSync10 } from "fs";
 import { mkdir as mkdir4, readFile as readFile5, writeFile as writeFile5 } from "fs/promises";

package/dist/index.js

@@ -33,7 +33,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "opencode-swarm",
-    version: "7.0.3",
+    version: "7.1.1",
     description: "Architect-centric agentic swarm plugin for OpenCode - hub-and-spoke orchestration with SME consultation, code generation, and QA review",
     main: "dist/index.js",
     types: "dist/index.d.ts",
@@ -15873,8 +15873,11 @@ var init_errors3 = __esm(() => {
 });
 
 // src/utils/logger.ts
+function isDebug() {
+  return process.env.OPENCODE_SWARM_DEBUG === "1";
+}
 function log(message, data) {
-  if (!DEBUG)
+  if (!isDebug())
     return;
   const timestamp = new Date().toISOString();
   if (data !== undefined) {
@@ -15884,7 +15887,7 @@ function log(message, data) {
   }
 }
 function warn(message, data) {
-  if (!DEBUG)
+  if (!isDebug())
     return;
   const timestamp = new Date().toISOString();
   if (data !== undefined) {
@@ -15901,10 +15904,6 @@ function error48(message, data) {
     console.error(`[opencode-swarm ${timestamp}] ERROR: ${message}`);
   }
 }
-var DEBUG;
-var init_logger = __esm(() => {
-  DEBUG = process.env.OPENCODE_SWARM_DEBUG === "1";
-});
 
 // src/utils/regex.ts
 function escapeRegex2(s) {
@@ -15918,7 +15917,6 @@ function simpleGlobToRegex(pattern, flags2 = "i") {
 // src/utils/index.ts
 var init_utils = __esm(() => {
   init_errors3();
-  init_logger();
 });
 
 // src/utils/bun-compat.ts
@@ -25138,7 +25136,6 @@ var init_guardrails = __esm(() => {
   init_telemetry();
   init_utils();
   init_bun_compat();
-  init_logger();
   init_conflict_resolution();
   init_delegation_gate();
   init_loop_detector();
@@ -26098,7 +26095,6 @@ var init_delegation_gate = __esm(() => {
   init_schema();
   init_state();
   init_telemetry();
-  init_logger();
   init_guardrails();
   init_normalize_tool_name();
   init_utils2();
@@ -40586,9 +40582,7 @@ function resetToRemoteBranch(cwd, options) {
   }
 }
 var GIT_TIMEOUT_MS2 = 30000;
-var init_branch = __esm(() => {
-  init_logger();
-});
+var init_branch = () => {};
 
 // src/hooks/knowledge-store.ts
 import { existsSync as existsSync9 } from "node:fs";
@@ -40915,7 +40909,7 @@ async function recordLessonsShown(directory, lessonIds, currentPhase) {
     await mkdir4(path16.dirname(shownFile), { recursive: true });
     await writeFile4(shownFile, JSON.stringify(shownData, null, 2), "utf-8");
   } catch {
-    console.warn("[swarm] Knowledge: failed to record shown lessons");
+    warn("[swarm] Knowledge: failed to record shown lessons");
   }
 }
 async function readMergedKnowledge(directory, config3, context) {
@@ -41065,7 +41059,7 @@ async function updateRetrievalOutcome(directory, phaseInfo, phaseSucceeded) {
     delete shownData[phaseInfo];
     await writeFile4(shownFile, JSON.stringify(shownData, null, 2), "utf-8");
   } catch {
-    console.warn("[swarm] Knowledge: failed to update retrieval outcomes");
+    warn("[swarm] Knowledge: failed to update retrieval outcomes");
   }
 }
 var JACCARD_THRESHOLD = 0.6, HIVE_TIER_BOOST = 0.05, SAME_PROJECT_PENALTY = -0.05;
@@ -41216,12 +41210,12 @@ function validateLesson(candidate, existingLessons, meta3) {
 }
 async function quarantineEntry(directory, entryId, reason, reportedBy) {
   if (!directory || directory.includes("..")) {
-    console.warn("[knowledge-validator] quarantineEntry: directory traversal attempt blocked");
+    warn("[knowledge-validator] quarantineEntry: directory traversal attempt blocked");
     return;
   }
   if (!entryId || entryId.includes("\x00") || entryId.includes(`
 `)) {
-    console.warn("[knowledge-validator] quarantineEntry: invalid entryId rejected");
+    warn("[knowledge-validator] quarantineEntry: invalid entryId rejected");
     return;
   }
   const validReportedBy = ["architect", "user", "auto"];
@@ -41281,12 +41275,12 @@ async function quarantineEntry(directory, entryId, reason, reportedBy) {
 }
 async function restoreEntry(directory, entryId) {
   if (!directory || directory.includes("..")) {
-    console.warn("[knowledge-validator] restoreEntry: directory traversal attempt blocked");
+    warn("[knowledge-validator] restoreEntry: directory traversal attempt blocked");
     return;
   }
   if (!entryId || entryId.includes("\x00") || entryId.includes(`
 `)) {
-    console.warn("[knowledge-validator] restoreEntry: invalid entryId rejected");
+    warn("[knowledge-validator] restoreEntry: invalid entryId rejected");
     return;
   }
   const knowledgePath = path17.join(directory, ".swarm", "knowledge.jsonl");
@@ -43245,9 +43239,7 @@ async function readCuratorSummary(directory) {
     }
     return parsed;
   } catch {
-    if (process.env.DEBUG_SWARM) {
-      console.warn("Failed to parse curator-summary.json: invalid JSON");
-    }
+    warn("Failed to parse curator-summary.json: invalid JSON");
     return null;
   }
 }
@@ -43280,9 +43272,7 @@ function filterPhaseEvents(eventsJsonl, phase, sinceTimestamp) {
         }
       }
     } catch {
-      if (process.env.DEBUG_SWARM) {
-        console.warn("filterPhaseEvents: skipping malformed line");
-      }
+      warn("filterPhaseEvents: skipping malformed line");
     }
   }
   return filtered;
@@ -43831,7 +43821,6 @@ var init_curator = __esm(() => {
   init_event_bus();
   init_manager();
   init_bun_compat();
-  init_logger();
   init_knowledge_store();
   init_knowledge_validator();
   init_utils2();
@@ -49256,7 +49245,6 @@ async function writeSentinel(sentinelPath, migrated, dropped) {
   await writeFile6(sentinelPath, JSON.stringify(sentinel, null, 2), "utf-8");
 }
 var init_knowledge_migrator = __esm(() => {
-  init_logger();
   init_knowledge_store();
   init_knowledge_validator();
 });
@@ -56210,6 +56198,7 @@ VERIFICATION PROTOCOL: After the coder reports DONE, and before running Stage B
 
 ── STAGE B: AGENT REVIEW GATES ──
 {{AGENT_PREFIX}}reviewer → security reviewer (conditional) → {{AGENT_PREFIX}}test_engineer verification → {{AGENT_PREFIX}}test_engineer adversarial → coverage check
+The reviewer's verdict MUST include a REUSE_RE_VERIFICATION field — do NOT accept an APPROVED verdict without it. Validate the field value against context: if the coder's EXPORTS_ADDED was non-empty, REUSE_RE_VERIFICATION must be VERIFIED or DUPLICATION_DETECTED (not SKIPPED). If EXPORTS_ADDED was "none", REUSE_RE_VERIFICATION must be SKIPPED.
 Stage B runs by default for TIER 1-3 classifications. Stage A passing does not satisfy Stage B.
 Stage B is where logic errors, security flaws, edge cases, and behavioral bugs are caught.
 You MUST delegate to each Stage B agent and wait for their response.
@@ -56307,6 +56296,7 @@ ANTI-RATIONALIZATION GATE — gates are mandatory for ALL changes, no exceptions
   ✗ "just a rename" → Renames break callers. Reviewer is required.
   ✗ "pre_check_batch will catch any issues" → pre_check_batch catches lint/SAST/secrets. It does NOT catch logic errors or edge cases.
   ✗ "authors are blind to their own mistakes" is WHY the reviewer exists — your certainty about correctness is irrelevant.
+  ✗ "Reviewer APPROVED so I'll skip checking the REUSE_RE_VERIFICATION field" → RIGHT: "I verified that the reviewer's verdict includes REUSE_RE_VERIFICATION before accepting the APPROVED"
 <!-- BEHAVIORAL_GUIDANCE_END -->
 
   8. **COVERAGE CHECK**: After adversarial tests pass, check if test_engineer reports coverage < 70%. If so, delegate {{AGENT_PREFIX}}test_engineer for an additional test pass targeting uncovered paths. This is a soft guideline; use judgment for trivial tasks.
@@ -57252,6 +57242,7 @@ This step supplements (not replaces) the existing regression-sweep and test-drif
   [TOOL] build_check: PASS / SKIPPED — value: ___
   [TOOL] pre_check_batch: PASS (lint:check ✓ secretscan ✓ sast_scan ✓ quality_budget ✓) — value: ___
   [GATE] reviewer: APPROVED — value: ___
+  [GATE] reuse_re_verification: VERIFIED / SKIPPED / DUPLICATION_DETECTED — value: ___
   [GATE] security-reviewer: APPROVED / SKIPPED — value: ___
   [GATE] test_engineer-verification: PASS — value: ___
   [GATE] regression-sweep: PASS / SKIPPED — value: ___
@@ -57467,6 +57458,42 @@ RIGHT: [search first, then] import { saveEvidence } from '../evidence/manager' (
 
 If available_symbols was provided in your scope declaration, you MUST only call functions from that list when importing from existing project modules. Do not invent function names that are not in the list.
 
+## REUSE SCAN PROTOCOL (MANDATORY)
+Before writing ANY new function, utility, class, hook, helper, or type:
+
+1. SCAN: Use the search tool to check for conceptually similar implementations in:
+   - src/utils/
+   - src/hooks/
+   - src/tools/
+   - src/services/
+   - Any directory named lib/, shared/, helpers/, or common/
+
+   Search queries must be SEMANTIC, not just literal. For a "path normalizer" function,
+   search for: normalize path, resolve path, join path, cross-platform path — not just
+   the exact function name you are about to write.
+
+2. READ: If any candidate result exists, read that file. Determine if it:
+   - Already implements the behavior you need (REUSE IT — do not reimplement)
+   - Partially implements it (EXTEND IT — do not duplicate)
+   - Is unrelated (PROCEED to write new code)
+
+3. REPORT: In your completion output, include a REUSE_SCAN field:
+   REUSE_SCAN: [EXISTING_REUSED | EXTENDED | NO_MATCH_FOUND | SCAN_NOT_APPLICABLE]
+   With a one-line explanation for each new function/class you wrote.
+
+AUTOMATIC REJECTION CONDITIONS:
+- If you write a function that already exists under a different name in the project
+- If you write a utility that duplicates behavior in an existing file you did not read
+- If REUSE_SCAN is missing from your completion output when new functions were created
+
+SCAN_NOT_APPLICABLE is only valid when:
+- The task is modifying an existing function (not creating new ones)
+- The task is purely adding types with no behavioral logic
+- The task explicitly states "create new, no reuse" with architect justification
+
+The Reviewer WILL independently re-run this scan. Omitting it does not save time —
+it guarantees rejection.
+
  ## DEFENSIVE CODING RULES
 - NEVER use \`any\` type in TypeScript — always use specific types
 - NEVER leave empty catch blocks — at minimum log the error
@@ -57530,6 +57557,7 @@ EXPORTS_ADDED: [new exported functions/types/classes, or "none"]
 EXPORTS_REMOVED: [removed exports, or "none"]
 EXPORTS_MODIFIED: [exports with changed signatures, or "none"]
 DEPS_ADDED: [new external package imports, or "none"]
+REUSE_SCAN: [EXISTING_REUSED | EXTENDED | NO_MATCH_FOUND | SCAN_NOT_APPLICABLE] — [explanation per new function]
 BLOCKED: [what went wrong]
 NEED: [what additional context or change would fix it]
 
@@ -57545,6 +57573,7 @@ Output only one of these structured templates:
   EXPORTS_REMOVED: [removed exports, or "none"]
   EXPORTS_MODIFIED: [exports with changed signatures, or "none"]
   DEPS_ADDED: [new external package imports, or "none"]
+  REUSE_SCAN: [EXISTING_REUSED | EXTENDED | NO_MATCH_FOUND | SCAN_NOT_APPLICABLE] — [explanation per new function]
   SELF-AUDIT: [print the checklist below with [x]/[ ] status for every line]
 - Blocked task:
   BLOCKED: [what went wrong]
@@ -57583,6 +57612,7 @@ Before you report task completion, verify:
 [ ] I did not use vague identifier names (result, data, temp, value, item, info, stuff, obj, ret, val)
 [ ] I did not write empty or tautological comments (e.g., "// sets the value", "// constructor", "// handle error")
 [ ] I did not leave placeholder JSDoc/docstring @param descriptions blank or copy-paste identical descriptions across functions
+[ ] I ran a reuse scan for every new function/class I created and included REUSE_SCAN in my output
 If ANY box is unchecked, fix it before reporting completion.
 Print this checklist with your completion report.
 
@@ -58731,6 +58761,32 @@ DO (explicitly):
 - VERIFY platform compatibility: path.join() used for all paths, no hardcoded separators
 - For confirmed issues requiring a concrete fix: use suggest_patch to produce a structured patch artifact for the coder
 
+## REUSE RE-VERIFICATION (MANDATORY FOR NEW EXPORTS)
+
+When EXPORTS_ADDED is non-empty in the coder's completion report:
+
+1. For EACH new export listed, independently run the search tool using semantic queries
+   against src/utils/, src/hooks/, src/tools/, src/services/, and any lib/shared/ directories.
+
+   2. Use AT LEAST 3 different search queries per new export — varying the concept, not just
+   the exact name. If the coder named their function \`normalizePath\`, also search for:
+   \`resolve path\`, \`join path segments\`, \`cross-platform path\`, and similar synonyms.
+
+3. If you find a pre-existing function/class that implements the same behavior:
+   - Report as DUPLICATION_DETECTED: [new export name] duplicates [existing path:line]
+   - REJECT immediately — this is a Tier 1 CORRECTNESS failure
+   - Do NOT proceed to Tier 2 or Tier 3
+
+4. If no match is found after semantic search: report REUSE_RE_VERIFICATION: VERIFIED — NO_DUPLICATE_FOUND
+
+5. Cross-check the coder's REUSE_SCAN report against your own findings:
+   - If coder reported EXISTING_REUSED or EXTENDED but you find a true duplicate: REJECT
+   - If coder reported SCAN_NOT_APPLICABLE while EXPORTS_ADDED is non-empty: REJECT — coder created new exports but claimed no scan was needed (contradiction)
+   - If coder reported NO_MATCH_FOUND and you also find none: REUSE_RE_VERIFICATION: VERIFIED — NO_DUPLICATE_FOUND
+
+If EXPORTS_ADDED is "none", this section is skipped. Note that you skipped it:
+REUSE_RE_VERIFICATION: SKIPPED (no new exports)
+
 ## REVIEW REASONING
 For each changed function or method, answer these before formulating issues:
 1. PRECONDITIONS: What must be true for this code to work correctly?
@@ -58793,7 +58849,9 @@ Code style, naming, duplication, test coverage, documentation completeness. This
 
 VERDICT FORMAT:
 APPROVED: Tier 1 PASS, Tier 2 PASS [, Tier 3 notes if any]
+REUSE_RE_VERIFICATION: [VERIFIED | SKIPPED]
 REJECTED: Tier [1|2] FAIL — [first error description] — [specific fix instruction]
+REUSE_RE_VERIFICATION: [DUPLICATION_DETECTED | SKIPPED]
 
 Do NOT approve with caveats. "APPROVED but fix X later" is not valid. Either it passes or it doesn't.
 
@@ -58813,6 +58871,7 @@ PROCESSING: If GATES is provided and includes passing results for lint, SAST, pl
 Begin directly with VERDICT. Do NOT prepend "Here's my review..." or any conversational preamble.
 
 VERDICT: APPROVED | REJECTED
+REUSE_RE_VERIFICATION: [VERIFIED | DUPLICATION_DETECTED | SKIPPED] — DUPLICATION_DETECTED is only valid when VERDICT is REJECTED
 RISK: LOW | MEDIUM | HIGH | CRITICAL
 ISSUES: list with line numbers, grouped by CHECK dimension
 FIXES: required changes if rejected
@@ -60375,7 +60434,6 @@ var init_preflight_integration = __esm(() => {
   init_status_artifact();
   init_trigger();
   init_preflight_service();
-  init_logger();
 });
 
 // node_modules/web-tree-sitter/tree-sitter.js
@@ -64422,7 +64480,6 @@ function buildDriftInjectionText(report, maxChars) {
 var DRIFT_REPORT_PREFIX = "drift-report-phase-";
 var init_curator_drift = __esm(() => {
   init_event_bus();
-  init_logger();
   init_utils2();
 });
 
@@ -65650,7 +65707,6 @@ init_schema();
 init_file_locks();
 init_state();
 init_telemetry();
-init_logger();
 init_utils2();
 import * as fs33 from "node:fs";
 var END_OF_SENTENCE_QUESTION_PATTERN = /\?\s*$/;
@@ -66442,7 +66498,6 @@ import * as path52 from "node:path";
 
 // src/tools/repo-graph.ts
 init_utils2();
-init_logger();
 init_path_security();
 import * as fsSync3 from "node:fs";
 import { constants as constants4, existsSync as existsSync28, realpathSync as realpathSync6 } from "node:fs";
@@ -67574,9 +67629,7 @@ async function updateGraphForFiles(workspaceRoot, filePaths, options) {
   await saveGraph(workspaceRoot, graph);
   return graph;
 }
-
 // src/hooks/repo-graph-builder.ts
-init_logger();
 var SUPPORTED_EXTENSIONS2 = [
   ".ts",
   ".tsx",
@@ -70697,15 +70750,15 @@ function createSystemEnhancerHook(config3, directory) {
                 const existingLessons = new Set(existingEntries.map((e) => e.lesson));
                 const newEntries = knowledgeEntries.filter((e) => !existingLessons.has(e.lesson));
                 if (newEntries.length === 0) {
-                  console.warn(`[system-enhancer] No new knowledge entries (all duplicates)`);
+                  warn(`[system-enhancer] No new knowledge entries (all duplicates)`);
                 } else {
                   for (const entry of newEntries) {
                     await appendKnowledge(knowledgePath, entry);
                   }
-                  console.warn(`[system-enhancer] Created ${newEntries.length} new knowledge entries (${knowledgeEntries.length - newEntries.length} duplicates skipped)`);
+                  warn(`[system-enhancer] Created ${newEntries.length} new knowledge entries (${knowledgeEntries.length - newEntries.length} duplicates skipped)`);
                 }
               } catch (e) {
-                console.warn(`[system-enhancer] Failed to create knowledge entries: ${e}`);
+                warn(`[system-enhancer] Failed to create knowledge entries: ${e}`);
               }
             }
           }
@@ -72406,7 +72459,7 @@ function createKnowledgeInjectorHook(directory, config3) {
     const headroomChars = MODEL_LIMIT_CHARS - existingChars;
     const MIN_INJECT_CHARS = config3.context_budget_threshold ?? 300;
     if (headroomChars < MIN_INJECT_CHARS) {
-      console.warn(`[knowledge-injector] Skipping: only ${headroomChars} chars of headroom remain (existing: ${existingChars}, limit: ${MODEL_LIMIT_CHARS})`);
+      warn(`[knowledge-injector] Skipping: only ${headroomChars} chars of headroom remain (existing: ${existingChars}, limit: ${MODEL_LIMIT_CHARS})`);
       return;
     }
     const maxInjectChars = config3.inject_char_budget ?? 2000;
@@ -72784,6 +72837,50 @@ function checkStaleImports(content, threshold) {
     detail: `${staleImports.length} unused import identifier(s): ${staleImports.slice(0, 3).join(", ")}${staleImports.length > 3 ? "..." : ""}. Remove stale imports.`
   };
 }
+function checkDuplicateUtility(content, projectDir, startTime, targetFile) {
+  const exportMatches = content.matchAll(/^\+(?:export)\s+(?:function|class|const|type|interface)\s+(\w{3,})/gm);
+  const newExports = [];
+  for (const match of exportMatches) {
+    if (match[1])
+      newExports.push(match[1]);
+  }
+  if (newExports.length === 0)
+    return null;
+  const deadline = startTime + 480;
+  const utilityDirs = [
+    "src/utils/",
+    "src/hooks/",
+    "src/tools/",
+    "src/services/"
+  ];
+  for (const utilDir of utilityDirs) {
+    if (Date.now() > deadline)
+      break;
+    const utilPath = path66.join(projectDir, utilDir);
+    if (!fs47.existsSync(utilPath))
+      continue;
+    const files = walkFiles(utilPath, [".ts", ".tsx", ".js", ".jsx"], deadline);
+    for (const file3 of files) {
+      if (Date.now() > deadline)
+        break;
+      if (targetFile && path66.resolve(file3) === path66.resolve(targetFile))
+        continue;
+      try {
+        const text = fs47.readFileSync(file3, "utf-8");
+        for (const name2 of newExports) {
+          const exportPattern = new RegExp(`\\bexport\\s+(?:function|class|const|type|interface)\\s+${name2}\\b`);
+          if (exportPattern.test(text)) {
+            return {
+              type: "duplicate_utility",
+              detail: `New export "${name2}" already exists in ${utilDir}. Reuse the existing utility instead of duplicating it.`
+            };
+          }
+        }
+      } catch {}
+    }
+  }
+  return null;
+}
 function createSlopDetectorHook(config3, projectDir, injectSystemMessage) {
   return {
     toolAfter: async (input, output) => {
@@ -72805,6 +72902,7 @@ function createSlopDetectorHook(config3, projectDir, injectSystemMessage) {
       })();
       if (!content || content.length < 10)
         return;
+      const targetFilePath = typeof args2?.filePath === "string" ? args2.filePath : undefined;
       const taskDescription = typeof args2?.description === "string" ? args2.description : typeof args2?.task === "string" ? args2.task : "";
       const startTime = Date.now();
       const findings = [];
@@ -72825,6 +72923,11 @@ function createSlopDetectorHook(config3, projectDir, injectSystemMessage) {
           if (dead)
             findings.push(dead);
         } catch {}
+        try {
+          const dupUtil = checkDuplicateUtility(content, projectDir, startTime, targetFilePath);
+          if (dupUtil)
+            findings.push(dupUtil);
+        } catch {}
       }
       try {
         const stale = checkStaleImports(content, config3.importHygieneThreshold ?? 2);
@@ -78136,7 +78239,7 @@ init_create_tool();
 var GITINGEST_TIMEOUT_MS = 1e4;
 var GITINGEST_MAX_RESPONSE_BYTES = 5242880;
 var GITINGEST_MAX_RETRIES = 2;
-var delay = (ms) => new Promise((resolve29) => setTimeout(resolve29, ms));
+var delay = (ms) => new Promise((resolve30) => setTimeout(resolve30, ms));
 async function fetchGitingest(args2) {
   for (let attempt = 0;attempt <= GITINGEST_MAX_RETRIES; attempt++) {
     try {
@@ -80219,7 +80322,7 @@ async function runNpmAudit(directory) {
       stderr: "pipe",
       cwd: directory
     });
-    const timeoutPromise = new Promise((resolve30) => setTimeout(() => resolve30("timeout"), AUDIT_TIMEOUT_MS));
+    const timeoutPromise = new Promise((resolve31) => setTimeout(() => resolve31("timeout"), AUDIT_TIMEOUT_MS));
     const result = await Promise.race([
       Promise.all([proc.stdout.text(), proc.stderr.text()]).then(([stdout2, stderr2]) => ({ stdout: stdout2, stderr: stderr2 })),
       timeoutPromise
@@ -80339,7 +80442,7 @@ async function runPipAudit(directory) {
       stderr: "pipe",
       cwd: directory
     });
-    const timeoutPromise = new Promise((resolve30) => setTimeout(() => resolve30("timeout"), AUDIT_TIMEOUT_MS));
+    const timeoutPromise = new Promise((resolve31) => setTimeout(() => resolve31("timeout"), AUDIT_TIMEOUT_MS));
     const result = await Promise.race([
       Promise.all([proc.stdout.text(), proc.stderr.text()]).then(([stdout2, stderr2]) => ({ stdout: stdout2, stderr: stderr2 })),
       timeoutPromise
@@ -80467,7 +80570,7 @@ async function runCargoAudit(directory) {
       stderr: "pipe",
       cwd: directory
     });
-    const timeoutPromise = new Promise((resolve30) => setTimeout(() => resolve30("timeout"), AUDIT_TIMEOUT_MS));
+    const timeoutPromise = new Promise((resolve31) => setTimeout(() => resolve31("timeout"), AUDIT_TIMEOUT_MS));
     const result = await Promise.race([
       Promise.all([proc.stdout.text(), proc.stderr.text()]).then(([stdout2, stderr]) => ({ stdout: stdout2, stderr })),
       timeoutPromise
@@ -80591,7 +80694,7 @@ async function runGoAudit(directory) {
       stderr: "pipe",
       cwd: directory
     });
-    const timeoutPromise = new Promise((resolve30) => setTimeout(() => resolve30("timeout"), AUDIT_TIMEOUT_MS));
+    const timeoutPromise = new Promise((resolve31) => setTimeout(() => resolve31("timeout"), AUDIT_TIMEOUT_MS));
     const result = await Promise.race([
       Promise.all([proc.stdout.text(), proc.stderr.text()]).then(([stdout2, stderr]) => ({ stdout: stdout2, stderr })),
       timeoutPromise
@@ -80724,7 +80827,7 @@ async function runDotnetAudit(directory) {
       stderr: "pipe",
       cwd: directory
     });
-    const timeoutPromise = new Promise((resolve30) => setTimeout(() => resolve30("timeout"), AUDIT_TIMEOUT_MS));
+    const timeoutPromise = new Promise((resolve31) => setTimeout(() => resolve31("timeout"), AUDIT_TIMEOUT_MS));
     const result = await Promise.race([
       Promise.all([proc.stdout.text(), proc.stderr.text()]).then(([stdout2, stderr]) => ({ stdout: stdout2, stderr })),
       timeoutPromise
@@ -80840,7 +80943,7 @@ async function runBundleAudit(directory) {
       stderr: "pipe",
       cwd: directory
     });
-    const timeoutPromise = new Promise((resolve30) => setTimeout(() => resolve30("timeout"), AUDIT_TIMEOUT_MS));
+    const timeoutPromise = new Promise((resolve31) => setTimeout(() => resolve31("timeout"), AUDIT_TIMEOUT_MS));
     const result = await Promise.race([
       Promise.all([proc.stdout.text(), proc.stderr.text()]).then(([stdout2, stderr]) => ({ stdout: stdout2, stderr })),
       timeoutPromise
@@ -80985,7 +81088,7 @@ async function runDartAudit(directory) {
       stderr: "pipe",
       cwd: directory
     });
-    const timeoutPromise = new Promise((resolve30) => setTimeout(() => resolve30("timeout"), AUDIT_TIMEOUT_MS));
+    const timeoutPromise = new Promise((resolve31) => setTimeout(() => resolve31("timeout"), AUDIT_TIMEOUT_MS));
     const result = await Promise.race([
       Promise.all([proc.stdout.text(), proc.stderr.text()]).then(([stdout2, stderr]) => ({ stdout: stdout2, stderr })),
       timeoutPromise
@@ -81100,7 +81203,7 @@ async function runComposerAudit(directory) {
       stderr: "pipe",
       cwd: directory
     });
-    const timeoutPromise = new Promise((resolve30) => setTimeout(() => resolve30("timeout"), AUDIT_TIMEOUT_MS));
+    const timeoutPromise = new Promise((resolve31) => setTimeout(() => resolve31("timeout"), AUDIT_TIMEOUT_MS));
     const result = await Promise.race([
       Promise.all([proc.stdout.text(), proc.stderr.text()]).then(([stdout2, stderr]) => ({ stdout: stdout2, stderr })),
       timeoutPromise
@@ -82740,7 +82843,7 @@ function mapSemgrepSeverity(severity) {
   }
 }
 async function executeWithTimeout(command, args2, options) {
-  return new Promise((resolve31) => {
+  return new Promise((resolve32) => {
     const child = child_process9.spawn(command, args2, {
       shell: false,
       cwd: options.cwd
@@ -82749,7 +82852,7 @@ async function executeWithTimeout(command, args2, options) {
     let stderr = "";
     const timeout = setTimeout(() => {
       child.kill("SIGTERM");
-      resolve31({
+      resolve32({
         stdout,
         stderr: "Process timed out",
         exitCode: 124
@@ -82763,7 +82866,7 @@ async function executeWithTimeout(command, args2, options) {
     });
     child.on("close", (code) => {
       clearTimeout(timeout);
-      resolve31({
+      resolve32({
         stdout,
         stderr,
         exitCode: code ?? 0
@@ -82771,7 +82874,7 @@ async function executeWithTimeout(command, args2, options) {
     });
     child.on("error", (err2) => {
       clearTimeout(timeout);
-      resolve31({
+      resolve32({
         stdout,
         stderr: err2.message,
         exitCode: 1
@@ -82956,7 +83059,7 @@ async function acquireLock(lockPath) {
       };
     } catch {
       if (attempt < LOCK_RETRY_DELAYS_MS.length) {
-        await new Promise((resolve32) => setTimeout(resolve32, LOCK_RETRY_DELAYS_MS[attempt]));
+        await new Promise((resolve33) => setTimeout(resolve33, LOCK_RETRY_DELAYS_MS[attempt]));
       }
     }
   }
@@ -86782,7 +86885,7 @@ async function ripgrepSearch(opts) {
       stderr: "pipe",
       cwd: opts.workspace
     });
-    const timeout = new Promise((resolve38) => setTimeout(() => resolve38("timeout"), REGEX_TIMEOUT_MS));
+    const timeout = new Promise((resolve39) => setTimeout(() => resolve39("timeout"), REGEX_TIMEOUT_MS));
     const exitPromise = proc.exited;
     const result = await Promise.race([exitPromise, timeout]);
     if (result === "timeout") {

package/package.json

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