opencode-swarm 7.158.1 → 7.159.0

package/dist/cli/{index-4wy9kzjg.js → index-8kfbdrxa.js}

@@ -1,10 +1,10 @@
 // @bun
 import {
   handleGuardrailExplain
-} from "./index-nphnjeh8.js";
+} from "./index-8jnzp5ct.js";
 import {
   handleGuardrailLog
-} from "./index-xzhk2hav.js";
+} from "./index-9vt2hknx.js";
 import {
   COMMAND_REGISTRY,
   SWARM_COMMAND_TOOL_ALLOWLIST,
@@ -94,53 +94,53 @@ import {
   handleWriteRetroCommand,
   normalizeSwarmCommandInput,
   resolveCommand
-} from "./index-ac8rwjsg.js";
+} from "./index-3e8600a7.js";
 import"./index-z54qw70y.js";
-import"./index-ff8xjr1c.js";
-import"./index-86vvhe8m.js";
-import"./index-7qvfkgyk.js";
+import"./index-04yrxg0z.js";
+import"./index-6e6qxf5q.js";
+import"./index-k4arrwrz.js";
 import"./index-7s1hmrfh.js";
 import"./index-txdagbh7.js";
 import"./index-134d35c1.js";
 import"./index-nj6rmyeh.js";
-import"./index-tc14d2zy.js";
-import"./index-azx50qge.js";
-import"./index-mfv7mfgg.js";
+import"./index-fcp41snp.js";
+import"./index-k48kgm6z.js";
+import"./index-xmz69g65.js";
 import"./index-70ha9e09.js";
 import"./index-c8s9a3zh.js";
 import"./index-9ss2m4rs.js";
 import"./index-mc9qgkwd.js";
 import"./index-zsrtt42s.js";
-import"./index-hrrzxz3q.js";
+import"./index-1sdb57jv.js";
 import"./index-3f7hqtgg.js";
 import"./index-8fqb0ynp.js";
-import"./index-tppnfxkm.js";
+import"./index-vywbn766.js";
 import"./index-pfnj5pvs.js";
 import"./index-rtry5xyf.js";
-import"./index-2j07670d.js";
-import"./index-t8g88esk.js";
-import"./index-zy60xd05.js";
+import"./index-we3nf5as.js";
+import"./index-pvzaryhr.js";
+import"./index-e2s08v0q.js";
 import"./index-ddszzne4.js";
-import"./index-dr2tfawg.js";
-import"./index-203fqkqk.js";
+import"./index-ynjy98vv.js";
+import"./index-b82tq895.js";
 import"./index-nwkr6tvv.js";
 import"./index-556ja8an.js";
 import"./index-4fwbbad3.js";
 import"./index-b43rt5ph.js";
 import"./index-q7sjgr1y.js";
-import"./index-xscjecyq.js";
-import"./index-5erwyk1b.js";
-import"./index-6x9jq0cd.js";
+import"./index-erdsawqz.js";
+import"./index-35grv4jg.js";
+import"./index-hte1e31d.js";
 import"./index-gprxjmm7.js";
 import"./index-n832052r.js";
 import"./index-dtn0pne5.js";
 import"./index-z6xqpmqg.js";
 import"./index-r3mvsbtq.js";
-import"./index-jz216dhj.js";
+import"./index-tcbjjppb.js";
 import {
   init_schema,
   stripKnownSwarmPrefix
-} from "./index-mt6qjp4c.js";
+} from "./index-b1tenv2s.js";
 import"./index-9e6fdz2h.js";
 import"./index-4rhhvd1a.js";
 import {

package/dist/cli/{index-xzhk2hav.js → index-9vt2hknx.js}

@@ -4,7 +4,7 @@ import {
   readShellAuditTail,
   redactPath,
   redactShellCommand
-} from "./index-ff8xjr1c.js";
+} from "./index-04yrxg0z.js";
 
 // src/services/guardrail-log-service.ts
 var BLOCK_TYPES = new Set([

package/dist/cli/{index-mt6qjp4c.js → index-b1tenv2s.js}

@@ -21,7 +21,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "opencode-swarm",
-    version: "7.158.1",
+    version: "7.159.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",
@@ -105,18 +105,20 @@ var init_package = __esm(() => {
       ".opencode/skills/orchestrating-subagents",
       ".opencode/skills/durable-session-state",
       "tests/fixtures/memory-recall",
+      "opencode-swarm.schema.json",
       "README.md",
       "LICENSE"
     ],
     scripts: {
       clean: `bun -e "require('fs').rmSync('dist',{recursive:true,force:true})"`,
-      build: "bun run clean && bun run scripts/copy-grammars.ts && bun build src/index.ts --outdir dist --target node --format esm --external web-tree-sitter --minify-whitespace --minify-syntax && bun build src/cli/index.ts --outdir dist/cli --target bun --format esm --external bash-parser --splitting && bun run scripts/copy-grammars.ts --to-dist && tsc --emitDeclarationOnly",
+      build: "bun run clean && bun run scripts/generate-config-schema.ts && bun run scripts/copy-grammars.ts && bun build src/index.ts --outdir dist --target node --format esm --external web-tree-sitter --minify-whitespace --minify-syntax && bun build src/cli/index.ts --outdir dist/cli --target bun --format esm --external bash-parser --splitting && bun run scripts/copy-grammars.ts --to-dist && tsc --emitDeclarationOnly",
       typecheck: "tsc --noEmit",
       test: "bun test",
       lint: "biome lint .",
       "lint:ci": "biome ci .",
       "test:unit:ci": "bun scripts/ci/run-unit-tests-local.ts",
       "drift:check": "bun run scripts/drift-check.ts",
+      "schema:generate": "bun run scripts/generate-config-schema.ts",
       "check:runtime-src-refs": "bun run scripts/check-runtime-src-refs.ts",
       "drift:fix": "bun run scripts/drift-check.ts --fix --confirm",
       "skills:sync": "bun run scripts/sync-qa-gate-skills.ts",
@@ -1652,14 +1654,15 @@ var init_schema = __esm(() => {
     circuit_open_duration_ms: exports_external.number().int().min(1000).max(1800000).default(60000)
   }).strict();
   PluginConfigSchema = exports_external.object({
-    config_format_version: exports_external.number().int().min(0).default(1),
-    agents: exports_external.record(exports_external.string(), AgentOverrideConfigSchema).optional(),
+    $schema: exports_external.string().optional().catch(undefined).describe("JSON Schema URL for editor validation/autocomplete of this file (issue #1663). Ignored at runtime; malformed values are ignored too."),
+    config_format_version: exports_external.number().int().min(0).default(1).describe("Config format version for the migration table. Increment when fields are deprecated. Distinct from knowledge.schema_version."),
+    agents: exports_external.record(exports_external.string(), AgentOverrideConfigSchema).optional().describe('Per-agent overrides keyed by agent name for the default swarm (e.g. "architect", "coder"). Multi-swarm setups configure agents under swarms.<id>.agents instead.'),
     default_agent: exports_external.string().optional().transform((v) => {
       if (v === undefined)
         return;
       const trimmed = v.trim();
       return trimmed === "" ? undefined : trimmed;
-    }),
+    }).describe('Agent set as the primary mode. Omitted: every generated *_architect is primary. Exact generated name (e.g. "local_architect"): only that agent. Base role name (e.g. "coder"): every generated agent with that base role. Unknown strings warn once and fall back to architect primaries.'),
     auto_select_architect: exports_external.union([exports_external.boolean(), exports_external.string()]).optional().transform((v) => {
       if (v === undefined)
         return;
@@ -1667,77 +1670,77 @@ var init_schema = __esm(() => {
         return v;
       const trimmed = v.trim();
       return trimmed === "" ? false : trimmed;
-    }),
-    swarms: exports_external.record(exports_external.string().regex(/^[^_]+$/, "Swarm ID must not contain underscores"), SwarmConfigSchema).optional(),
-    max_iterations: exports_external.number().min(1).max(10).default(5),
-    pipeline: PipelineConfigSchema.optional(),
-    phase_complete: PhaseCompleteConfigSchema.optional(),
-    qa_retry_limit: exports_external.number().min(1).max(10).default(3),
-    execution_mode: exports_external.enum(["strict", "balanced", "fast"]).default("balanced"),
-    inject_phase_reminders: exports_external.boolean().default(true),
-    hooks: HooksConfigSchema.optional(),
-    pr_review_resilience: PrReviewResilienceConfigSchema.optional(),
-    gates: GateConfigSchema.optional(),
-    context_budget: ContextBudgetConfigSchema.optional(),
-    pricing: PricingConfigSchema.optional(),
-    guardrails: GuardrailsConfigSchema.optional(),
-    watchdog: WatchdogConfigSchema.optional(),
-    self_review: SelfReviewConfigSchema.optional(),
-    auto_review: AutoReviewConfigSchema.optional(),
-    tool_filter: ToolFilterConfigSchema.optional(),
-    authority: AuthorityConfigSchema.optional(),
-    plan_cursor: PlanCursorConfigSchema.optional(),
-    context_map: ContextMapConfigSchema.optional(),
-    repo_graph: RepoGraphConfigSchema.prefault({}),
-    evidence: EvidenceConfigSchema.optional(),
-    summaries: SummaryConfigSchema.optional(),
-    review_passes: ReviewPassesConfigSchema.optional(),
-    adversarial_detection: AdversarialDetectionConfigSchema.optional(),
-    adversarial_testing: AdversarialTestingConfigSchema.optional(),
-    integration_analysis: IntegrationAnalysisConfigSchema.optional(),
-    docs: DocsConfigSchema.optional(),
-    design_docs: DesignDocsConfigSchema.optional(),
-    git: GitConfigSchema.optional(),
-    ui_review: UIReviewConfigSchema.optional(),
-    compaction_advisory: CompactionAdvisoryConfigSchema.optional(),
-    lint: LintConfigSchema.optional(),
-    secretscan: SecretscanConfigSchema.optional(),
-    checkpoint: CheckpointConfigSchema.optional(),
-    apply_patch: ApplyPatchConfigSchema.optional(),
-    automation: AutomationConfigSchema.optional(),
-    knowledge: KnowledgeConfigSchema.optional(),
-    memory: MemoryConfigSchema.optional(),
-    learning: LearningConfigSchema.optional(),
-    consensus: ConsensusConfigSchema.optional(),
-    curator: CuratorConfigSchema.optional(),
-    architectural_supervision: ArchitecturalSupervisionConfigSchema.optional(),
-    knowledge_application: KnowledgeApplicationConfigSchema.optional(),
-    skillPropagation: SkillPropagationConfigSchema.optional(),
-    skill_improver: SkillImproverConfigSchema.optional(),
-    harness_evolution: HarnessEvolutionConfigSchema.optional(),
-    spec_writer: SpecWriterConfigSchema.optional(),
+    }).describe('Auto-select the swarm architect for new sessions instead of OpenCode built-ins. Omitted or false: manual selection (omitted behaves as false). true: enable auto-select and disable built-in build/plan agents. "<architect_name>" (e.g. "mega_architect"): enable targeting one architect in multi-swarm setups.'),
+    swarms: exports_external.record(exports_external.string().regex(/^[^_]+$/, "Swarm ID must not contain underscores"), SwarmConfigSchema).optional().describe('Multiple swarms keyed by swarm ID (no underscores allowed). The first swarm, or one named "default", provides the primary architect.'),
+    max_iterations: exports_external.number().min(1).max(10).default(5).describe("Maximum pipeline iterations per task (1-10)."),
+    pipeline: PipelineConfigSchema.optional().describe("Pipeline stage/model settings."),
+    phase_complete: PhaseCompleteConfigSchema.optional().describe("Phase-completion gate settings."),
+    qa_retry_limit: exports_external.number().min(1).max(10).default(3).describe("Maximum QA retry rounds per task (1-10)."),
+    execution_mode: exports_external.enum(["strict", "balanced", "fast"]).default("balanced").describe('Performance mode controlling optional hook execution overhead: "strict", "balanced", or "fast".'),
+    inject_phase_reminders: exports_external.boolean().default(true).describe("Inject phase reminder directives during execution."),
+    hooks: HooksConfigSchema.optional().describe("Hook subsystem toggles and settings."),
+    pr_review_resilience: PrReviewResilienceConfigSchema.optional().describe("PR review base-wave staged canary/fanout resilience settings."),
+    gates: GateConfigSchema.optional().describe("Quality gate configuration (v6.9 anti-slop features)."),
+    context_budget: ContextBudgetConfigSchema.optional().describe("Context budget thresholds."),
+    pricing: PricingConfigSchema.optional().describe("Token/cost estimation fallback table. Provider-reported cost wins when present; entries only estimate from usage tokens when reports omit cost."),
+    guardrails: GuardrailsConfigSchema.optional().describe("Loop containment and safety guardrails: tool-call caps, denial tracking, destructive-command blocking, shell audit."),
+    watchdog: WatchdogConfigSchema.optional().describe("Scope-guard and delegation-ledger watchdog settings."),
+    self_review: SelfReviewConfigSchema.optional().describe("Advisory self-review after coder delegation."),
+    auto_review: AutoReviewConfigSchema.optional().describe("Opt-in execution-diff review by the reviewer model in a fresh ephemeral session at task/phase boundaries."),
+    tool_filter: ToolFilterConfigSchema.optional().describe("Controls which tools each agent is allowed to use."),
+    authority: AuthorityConfigSchema.optional().describe("Per-agent file write authority rules."),
+    plan_cursor: PlanCursorConfigSchema.optional().describe("Compressed plan summary injection settings."),
+    context_map: ContextMapConfigSchema.optional().describe("Context Map (issue #1104, FR-006) \u2014 opt-in."),
+    repo_graph: RepoGraphConfigSchema.prefault({}).describe("Repository dependency-graph settings (builder excludes, incremental refresh). Nested defaults materialize when the whole section is omitted."),
+    evidence: EvidenceConfigSchema.optional().describe("Evidence retention and storage settings."),
+    summaries: SummaryConfigSchema.optional().describe("Summary generation settings."),
+    review_passes: ReviewPassesConfigSchema.optional().describe("Dual-pass security review settings."),
+    adversarial_detection: AdversarialDetectionConfigSchema.optional().describe("Same-model adversarial checker detection settings."),
+    adversarial_testing: AdversarialTestingConfigSchema.optional().describe("Cross-model adversarial testing settings."),
+    integration_analysis: IntegrationAnalysisConfigSchema.optional().describe("Integration analysis settings."),
+    docs: DocsConfigSchema.optional().describe("Documentation synthesizer (docs agent) settings."),
+    design_docs: DesignDocsConfigSchema.optional().describe("Structured design-doc generation (issue #1080, docs_design agent) \u2014 opt-in."),
+    git: GitConfigSchema.optional().describe("Git executable resolution override (issue #2236 hardening)."),
+    ui_review: UIReviewConfigSchema.optional().describe("UI/UX review (designer agent) settings."),
+    compaction_advisory: CompactionAdvisoryConfigSchema.optional().describe("Compaction advisory settings."),
+    lint: LintConfigSchema.optional().describe("Lint gate settings."),
+    secretscan: SecretscanConfigSchema.optional().describe("Secret scanning settings."),
+    checkpoint: CheckpointConfigSchema.optional().describe("Checkpoint settings."),
+    apply_patch: ApplyPatchConfigSchema.optional().describe("Apply-patch opt-in fuzzy matching fallback (issue #1718)."),
+    automation: AutomationConfigSchema.optional().describe("Background automation mode and per-feature toggles (v6.7 background-first rollout)."),
+    knowledge: KnowledgeConfigSchema.optional().describe("Two-tier cross-project knowledge base (v6.17)."),
+    memory: MemoryConfigSchema.optional().describe("Swarm memory substrate \u2014 disabled by default so existing flows are unchanged."),
+    learning: LearningConfigSchema.optional().describe("Learning subsystem: real-time admission, PRM persistence, dedup sweep (issue #1821)."),
+    consensus: ConsensusConfigSchema.optional().describe("Consensus mining over completed run evidence (issue #1821)."),
+    curator: CuratorConfigSchema.optional().describe("Phase context consolidation and drift detection."),
+    architectural_supervision: ArchitecturalSupervisionConfigSchema.optional().describe("Hierarchical summary review (issue #893)."),
+    knowledge_application: KnowledgeApplicationConfigSchema.optional().describe("Knowledge-application contract (v2): warn or enforce modes, ack tracking."),
+    skillPropagation: SkillPropagationConfigSchema.optional().describe("Skill propagation gate/injection settings."),
+    skill_improver: SkillImproverConfigSchema.optional().describe("Low-frequency, expensive-model skill improvement loop (issue #629, v2)."),
+    harness_evolution: HarnessEvolutionConfigSchema.optional().describe("Declarative, non-executing HarnessOpt mutation policy (issue #1825)."),
+    spec_writer: SpecWriterConfigSchema.optional().describe("Spec writer agent (v2) \u2014 independent model for .swarm/spec.md authorship."),
     tool_output: exports_external.object({
       truncation_enabled: exports_external.boolean().default(true),
       max_lines: exports_external.number().min(10).max(500).default(150),
       per_tool: exports_external.record(exports_external.string(), exports_external.number()).optional(),
       truncation_tools: exports_external.array(exports_external.string()).optional().describe("Tools to apply output truncation to. Defaults to diff, symbols, bash, shell, test_runner, lint, pre_check_batch, complexity_hotspots, pkg_audit, sbom_generate, schema_drift.")
-    }).optional(),
-    slop_detector: SlopDetectorConfigSchema.optional(),
+    }).optional().describe("Tool output truncation settings (enable/disable, max lines, per-tool overrides)."),
+    slop_detector: SlopDetectorConfigSchema.optional().describe("Slop detector settings (v6.29)."),
     todo_gate: exports_external.object({
       enabled: exports_external.boolean().default(true),
       max_high_priority: exports_external.number().int().min(-1).default(0).describe("Max new high-priority TODOs (FIXME/HACK/XXX) before warning. 0 = warn on any. Set to -1 to disable."),
       block_on_threshold: exports_external.boolean().default(false).describe("If true, block phase completion when threshold exceeded. Default: advisory only.")
-    }).optional(),
-    incremental_verify: IncrementalVerifyConfigSchema.optional(),
-    compaction_service: CompactionConfigSchema.optional(),
-    prm: PrmConfigSchema.optional(),
-    council: CouncilConfigSchema.optional(),
-    parallelization: ParallelizationConfigSchema.optional(),
-    worktree: WorktreeIsolationConfigSchema.optional(),
-    turbo: TurboConfigSchema.optional(),
-    turbo_mode: exports_external.boolean().default(false).optional(),
-    quiet: exports_external.boolean().default(true).optional(),
-    version_check: exports_external.boolean().default(true).optional(),
+    }).optional().describe("TODO gate (v6.32): warn or block on new high-priority TODOs (FIXME/HACK/XXX)."),
+    incremental_verify: IncrementalVerifyConfigSchema.optional().describe("Incremental verification settings (v6.29)."),
+    compaction_service: CompactionConfigSchema.optional().describe("Compaction service settings (v6.29)."),
+    prm: PrmConfigSchema.optional().describe("PRM (Process Remediation Manager) settings."),
+    council: CouncilConfigSchema.optional().describe("Work Complete Council \u2014 parallel four-member verification gate, off by default."),
+    parallelization: ParallelizationConfigSchema.optional().describe("Parallelization (PR 1 dark foundation) \u2014 disabled by default; no production code path branches on enabled=true yet."),
+    worktree: WorktreeIsolationConfigSchema.optional().describe("Worktree isolation policy for parallel coder dispatch lanes (general surface; Lean Turbo keeps its legacy per-mode fields)."),
+    turbo: TurboConfigSchema.optional().describe("Turbo execution strategy block (Phase 1). Absent means current behavior unchanged."),
+    turbo_mode: exports_external.boolean().default(false).optional().describe("Bypass reviewer/test gates for rapid iteration (v6.40)."),
+    quiet: exports_external.boolean().default(true).optional().describe("Suppress non-critical startup warnings (default true keeps the TUI clean). Set false to restore verbose warnings for debugging."),
+    version_check: exports_external.boolean().default(true).optional().describe("Background staleness check against npm, throttled to once per 24h (issue #675). Set false to fully disable the network call."),
     full_auto: exports_external.object({
       enabled: exports_external.boolean().default(false),
       locked: exports_external.boolean().default(false),
@@ -1896,11 +1899,11 @@ var init_schema = __esm(() => {
         total_timeout_ms: 120000,
         cleanup_timeout_ms: 2000
       }
-    })),
-    pr_monitor: PrMonitorConfigSchema.optional(),
-    external_skills: ExternalSkillsConfigSchema.optional(),
-    skills: SkillsConfigSchema.optional(),
-    skill_opt: SkillOptConfigSchema.optional()
+    })).describe("Full-auto autonomous orchestration with critic oversight: permission policy, denial accounting, oversight cadence triggers (v2 preserves v1 fields so existing configs load unchanged)."),
+    pr_monitor: PrMonitorConfigSchema.optional().describe("GitHub PR subscription and polling (FR-001) \u2014 disabled by default; opt-in for real-time PR status updates."),
+    external_skills: ExternalSkillsConfigSchema.optional().describe("External skills: candidate model, discovery, and quarantine store (FR-001) \u2014 all subsystems opt-in."),
+    skills: SkillsConfigSchema.optional().describe("Opt-in gate for the 7 skill_* management tools (FR-004). Default false: the tools are absent from the architect tool surface."),
+    skill_opt: SkillOptConfigSchema.optional().describe("Governed skill optimizer (issue #1822). Disabled by default; /swarm skill-opt run requires enabled: true. All other subcommands are proposal-only/read-only by default.")
   });
 });
 

package/dist/cli/{index-203fqkqk.js → index-b82tq895.js}

@@ -4,7 +4,7 @@ import {
   PlanSchema,
   TaskStatusSchema,
   init_loader
-} from "./index-jz216dhj.js";
+} from "./index-tcbjjppb.js";
 import {
   assertProjectRoot,
   withEvidenceLock

package/dist/cli/{index-zy60xd05.js → index-e2s08v0q.js}

@@ -3096,7 +3096,7 @@ async function reconcileLegacyCoderSettlements(directory, maxRecords, onReconcil
   const candidates = readDelegations(directory).filter((record) => record.normalizedAgent === "coder" && Boolean(record.legacyCoderSettlementTransfer) && Boolean(record.terminalResult)).slice(0, maxRecords);
   if (candidates.length === 0)
     return 0;
-  const { transferCoderSettlementToBackground } = await import("./coder-settlement-nrtcjr0h.js");
+  const { transferCoderSettlementToBackground } = await import("./coder-settlement-66mqw0xt.js");
   let transferred = 0;
   for (const record of candidates) {
     try {

package/dist/cli/{index-xscjecyq.js → index-erdsawqz.js}

@@ -713,7 +713,7 @@ async function applyConfidenceFloorAction(directory, touched, options) {
   const {
     readAuthoritativeKnowledgeCounterRollups,
     effectiveRetrievalOutcomes
-  } = await import("./knowledge-events-vcbece74.js");
+  } = await import("./knowledge-events-bwx99mxc.js");
   const rollups = await readAuthoritativeKnowledgeCounterRollups(directory);
   const flagIds = new Set;
   for (const e of atFloor) {
@@ -780,11 +780,11 @@ async function applyConfidenceFloorAction(directory, touched, options) {
     });
   }
   if (action === "quarantine" && toQuarantine.length > 0) {
-    const { quarantineEntry } = await import("./knowledge-validator-nwjnjgf5.js");
-    const { KnowledgeConfigSchema } = await import("./schema-8a7fyp87.js");
+    const { quarantineEntry } = await import("./knowledge-validator-yxcadg1p.js");
+    const { KnowledgeConfigSchema } = await import("./schema-0b0dqn28.js");
     let config;
     try {
-      const { loadPluginConfigWithMeta } = await import("./index-ygxb3jw4.js");
+      const { loadPluginConfigWithMeta } = await import("./index-ghjs1n7k.js");
       const { config: loadedConfig } = loadPluginConfigWithMeta(directory);
       config = KnowledgeConfigSchema.parse(loadedConfig.knowledge ?? {});
     } catch {

package/dist/cli/{index-tc14d2zy.js → index-fcp41snp.js}

@@ -2,7 +2,7 @@
 import {
   ALLOWED_SKILL_PATH_PREFIXES,
   validateSkillPath
-} from "./index-tppnfxkm.js";
+} from "./index-vywbn766.js";
 import {
   withTimeoutSignal
 } from "./index-q7sjgr1y.js";
@@ -12,11 +12,11 @@ import {
   resolveHiveKnowledgePath,
   resolveSwarmKnowledgePath,
   transactKnowledge
-} from "./index-xscjecyq.js";
+} from "./index-erdsawqz.js";
 import {
   effectiveRetrievalOutcomes,
   readAuthoritativeKnowledgeCounterRollups
-} from "./index-5erwyk1b.js";
+} from "./index-35grv4jg.js";
 import {
   advisoryWarn,
   init_warning_buffer

package/dist/cli/{index-ygxb3jw4.js → index-ghjs1n7k.js}

@@ -2,7 +2,7 @@
 import {
   _internals,
   resolveWorktreeIsolationConfig
-} from "./index-6x9jq0cd.js";
+} from "./index-hte1e31d.js";
 import {
   ApprovalEvidenceSchema,
   BaseEvidenceSchema,
@@ -42,7 +42,7 @@ import {
   loadPluginConfig,
   loadPluginConfigWithMeta,
   loadPluginConfigWithMetaAsync
-} from "./index-jz216dhj.js";
+} from "./index-tcbjjppb.js";
 import {
   AUTO_REVIEW_V8_BURN_IN_DECISION,
   AgentOverrideConfigSchema,
@@ -64,7 +64,7 @@ import {
   TurboConfigSchema,
   WorktreeIsolationConfigSchema,
   resolveAutoReviewConfig
-} from "./index-mt6qjp4c.js";
+} from "./index-b1tenv2s.js";
 import"./index-9e6fdz2h.js";
 import"./index-4rhhvd1a.js";
 import {

package/dist/cli/{index-6x9jq0cd.js → index-hte1e31d.js}

@@ -2,10 +2,10 @@
 import {
   init_loader,
   loadPluginConfigWithMeta
-} from "./index-jz216dhj.js";
+} from "./index-tcbjjppb.js";
 import {
   init_schema
-} from "./index-mt6qjp4c.js";
+} from "./index-b1tenv2s.js";
 import {
   DEFAULT_WORKTREE_ISOLATION_CONFIG,
   init_constants

package/dist/cli/{index-azx50qge.js → index-k48kgm6z.js}

@@ -6,12 +6,12 @@ import {
   resolveSwarmKnowledgePath,
   transactKnowledge,
   wordBigrams
-} from "./index-xscjecyq.js";
+} from "./index-erdsawqz.js";
 import {
   queryHistoricalOutcomes,
   readKnowledgeEvents,
   recordKnowledgeEvent
-} from "./index-5erwyk1b.js";
+} from "./index-35grv4jg.js";
 import {
   init_knowledge_types,
   isActiveStatus
@@ -224,11 +224,11 @@ async function maybeQuarantineOnContradiction(directory, entryId, threshold, win
         alreadyInactive: true
       };
     }
-    const { quarantineEntry } = await import("./knowledge-validator-nwjnjgf5.js");
+    const { quarantineEntry } = await import("./knowledge-validator-yxcadg1p.js");
     let policyConfig;
     try {
-      const { KnowledgeConfigSchema } = await import("./schema-8a7fyp87.js");
-      const { loadPluginConfigWithMeta } = await import("./index-ygxb3jw4.js");
+      const { KnowledgeConfigSchema } = await import("./schema-0b0dqn28.js");
+      const { loadPluginConfigWithMeta } = await import("./index-ghjs1n7k.js");
       const { config: loadedConfig } = loadPluginConfigWithMeta(directory);
       policyConfig = KnowledgeConfigSchema.parse(loadedConfig.knowledge ?? {});
     } catch {

package/dist/cli/{index-7qvfkgyk.js → index-k4arrwrz.js}

@@ -23,7 +23,7 @@ import {
   readTaskEvidence,
   readTaskEvidenceRaw,
   sanitizeTaskId
-} from "./index-2j07670d.js";
+} from "./index-we3nf5as.js";
 import {
   LedgerStaleWriterError,
   appendLedgerEvent,
@@ -43,7 +43,7 @@ import {
   replayFromLedgerWithStatus,
   takeSnapshotEvent,
   takeSnapshotWithRetry
-} from "./index-203fqkqk.js";
+} from "./index-b82tq895.js";
 import {
   appendCoreEventSync
 } from "./index-nwkr6tvv.js";
@@ -70,7 +70,7 @@ import {
 } from "./index-r3mvsbtq.js";
 import {
   PlanSchema
-} from "./index-jz216dhj.js";
+} from "./index-tcbjjppb.js";
 import {
   GIT_BINARY_ENV_VAR,
   describeGitResolution,

package/dist/cli/{index-t8g88esk.js → index-pvzaryhr.js}

@@ -92,7 +92,7 @@ var _internals = {
     symlinkSync: fs.symlinkSync
   },
   writeScopeToDisk: async (directory, taskId, files) => {
-    const { writeScopeToDisk: realWrite } = await import("./scope-persistence-prdxtcr3.js");
+    const { writeScopeToDisk: realWrite } = await import("./scope-persistence-199f7yqc.js");
     return realWrite(directory, taskId, files);
   },
   writeLaneProfileToDisk: async (_worktreePath, _laneIndex, _envOverrides) => {

package/dist/cli/{index-jz216dhj.js → index-tcbjjppb.js}

@@ -6,7 +6,7 @@ import {
   PluginConfigSchema,
   init_schema,
   resolveExternalSkillsConfig
-} from "./index-mt6qjp4c.js";
+} from "./index-b1tenv2s.js";
 import {
   GIT_BINARY_ENV_VAR,
   init_git_executable
@@ -244,6 +244,7 @@ __export(exports_loader, {
   getSafeDefaultConfigLoadResult: () => getSafeDefaultConfigLoadResult,
   formatZodIssues: () => formatZodIssues,
   deepMerge: () => deepMerge,
+  _internals: () => _internals,
   MAX_MERGE_DEPTH: () => MAX_MERGE_DEPTH,
   MAX_CONFIG_FILE_BYTES: () => MAX_CONFIG_FILE_BYTES
 });
@@ -308,6 +309,15 @@ function migratePresetsConfig(raw) {
       return migrated;
     }
   }
+  const dormantLegacyKeys = ["preset", "presets", "swarm_mode"].filter((key) => (key in raw));
+  if (dormantLegacyKeys.length > 0 && raw.agents) {
+    const cleaned = { ...raw };
+    for (const key of dormantLegacyKeys) {
+      delete cleaned[key];
+    }
+    advisoryWarn(`[opencode-swarm] Ignored legacy v6.12 config key(s): ${dormantLegacyKeys.join(", ")}. The agents block takes precedence \u2014 consider removing them from your opencode-swarm.json.`);
+    return cleaned;
+  }
   return raw;
 }
 function sanitizeExternalSkillsConfig(raw) {
@@ -483,6 +493,15 @@ function buildConfigWithMeta(rawUserConfig, rawProjectConfig, loadedFromFile, co
   mergedRaw = migratePresetsConfig(mergedRaw);
   const { result: sanitized, strippedKeys: gatesStripped } = sanitizeSectionConfigs(mergedRaw);
   mergedRaw = sanitized;
+  const knownTopLevel = new Set(Object.keys(PluginConfigSchema.shape));
+  const unknownTopLevel = Object.keys(mergedRaw).filter((key) => !knownTopLevel.has(key));
+  if (unknownTopLevel.length > 0) {
+    const signature = unknownTopLevel.join("\x00");
+    if (signature !== lastUnknownTopLevelSig) {
+      lastUnknownTopLevelSig = signature;
+      advisoryWarn(`[opencode-swarm] Ignored ${unknownTopLevel.length} unknown top-level config key(s): ${unknownTopLevel.join(", ")}. These keys have no effect \u2014 see docs/configuration.md (Top-level configuration keys) for the valid key list.`);
+    }
+  }
   const secure = (cfg) => loadedFromFile && configHadErrors ? PluginConfigSchema.parse({
     ...cfg,
     guardrails: { enabled: true }
@@ -713,7 +732,7 @@ function loadAgentPrompt(agentName) {
   }
   return result;
 }
-var CONFIG_FILENAME = "opencode-swarm.json", PROMPTS_DIR_NAME = "opencode-swarm", MAX_CONFIG_FILE_BYTES = 102400;
+var CONFIG_FILENAME = "opencode-swarm.json", PROMPTS_DIR_NAME = "opencode-swarm", MAX_CONFIG_FILE_BYTES = 102400, lastUnknownTopLevelSig = null, _internals;
 var init_loader = __esm(() => {
   init_warning_buffer();
   init_git_executable();
@@ -721,6 +740,11 @@ var init_loader = __esm(() => {
   init_schema();
   init_merge();
   init_merge();
+  _internals = {
+    resetUnknownTopLevelKeyWarning() {
+      lastUnknownTopLevelSig = null;
+    }
+  };
 });
 
 // src/config/plan-schema.ts

package/dist/cli/{index-tppnfxkm.js → index-vywbn766.js}

@@ -9,7 +9,7 @@ import {
   resolveSwarmKnowledgePath,
   resolveSwarmRejectedPath,
   transactKnowledge
-} from "./index-xscjecyq.js";
+} from "./index-erdsawqz.js";
 import {
   resolveKnowledgeStoreDir
 } from "./index-5zgf140g.js";

package/dist/cli/{index-2j07670d.js → index-we3nf5as.js}

@@ -2,7 +2,7 @@
 import {
   autoCommitDirty,
   cleanUntrackedFiles
-} from "./index-t8g88esk.js";
+} from "./index-pvzaryhr.js";
 import {
   isPathWithinDeclaredScope,
   unsafePathTextReason

package/dist/cli/{index-mfv7mfgg.js → index-xmz69g65.js}

@@ -2,7 +2,7 @@
 import {
   readKnowledge,
   transactKnowledge
-} from "./index-xscjecyq.js";
+} from "./index-erdsawqz.js";
 import {
   init_git_executable,
   resolveGitExecutableAsync

package/dist/cli/{index-dr2tfawg.js → index-ynjy98vv.js}

@@ -2,7 +2,7 @@
 import {
   computePlanStructureHash,
   derivePlanId
-} from "./index-203fqkqk.js";
+} from "./index-b82tq895.js";
 import {
   appendCoreEventSync
 } from "./index-nwkr6tvv.js";
@@ -11,7 +11,7 @@ import {
 } from "./index-556ja8an.js";
 import {
   PlanSchema
-} from "./index-jz216dhj.js";
+} from "./index-tcbjjppb.js";
 import {
   atomicWriteSwarmFile,
   atomicWriteSwarmFileSync