opencode-swarm 7.158.0 → 7.159.0

package/dist/cli/{index-a1884hh4.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-jb1a5dzh.js");
+    const { writeScopeToDisk: realWrite } = await import("./scope-persistence-199f7yqc.js");
     return realWrite(directory, taskId, files);
   },
   writeLaneProfileToDisk: async (_worktreePath, _laneIndex, _envOverrides) => {

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

@@ -6,7 +6,7 @@ import {
   PluginConfigSchema,
   init_schema,
   resolveExternalSkillsConfig
-} from "./index-f776m4r5.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-dmfbmnp7.js → index-vywbn766.js}

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

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

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

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

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

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

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

package/dist/cli/index.js

@@ -11,53 +11,53 @@ import {
   readCachePackageVersion,
   resolveCommand,
   safeRealpathSync
-} from "./index-rac2gkvr.js";
+} from "./index-3e8600a7.js";
 import"./index-z54qw70y.js";
-import"./index-rc93mm6e.js";
-import"./index-rd324153.js";
-import"./index-bv24pbaj.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-y3hdwh66.js";
-import"./index-vwx0by4y.js";
-import"./index-5tchehv7.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-x4ftmdha.js";
+import"./index-mc9qgkwd.js";
 import"./index-zsrtt42s.js";
-import"./index-c57cyrwn.js";
+import"./index-1sdb57jv.js";
 import"./index-3f7hqtgg.js";
 import"./index-8fqb0ynp.js";
-import"./index-dmfbmnp7.js";
+import"./index-vywbn766.js";
 import"./index-pfnj5pvs.js";
 import"./index-rtry5xyf.js";
-import"./index-fwe1wh6r.js";
-import"./index-a1884hh4.js";
-import"./index-yfbp4q09.js";
+import"./index-we3nf5as.js";
+import"./index-pvzaryhr.js";
+import"./index-e2s08v0q.js";
 import"./index-ddszzne4.js";
-import"./index-nvta6kcv.js";
-import"./index-6xxpwk5x.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-x71shq8j.js";
-import"./index-f036tggv.js";
-import"./index-gm10kvne.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-663wnh64.js";
+import"./index-tcbjjppb.js";
 import {
   init_package,
   package_default
-} from "./index-f776m4r5.js";
+} from "./index-b1tenv2s.js";
 import"./index-9e6fdz2h.js";
 import"./index-4rhhvd1a.js";
 import {
@@ -85,6 +85,13 @@ import * as os from "os";
 import * as path from "path";
 import { fileURLToPath } from "url";
 init_constants();
+
+// src/config/project-init.ts
+init_package();
+init_constants();
+var CONFIG_SCHEMA_REF = `https://unpkg.com/opencode-swarm@${package_default.version}/opencode-swarm.schema.json`;
+
+// src/cli/index.ts
 var { version } = package_default;
 var PACKAGE_ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..", "..");
 var CONFIG_DIR = getPluginConfigDir();
@@ -203,21 +210,6 @@ function saveJson(filepath, data) {
   fs.writeFileSync(filepath, `${JSON.stringify(data, null, 2)}
 `, "utf-8");
 }
-function writeProjectConfigIfMissing(cwd) {
-  try {
-    const opencodeDir = path.join(cwd, ".opencode");
-    const projectConfigPath = path.join(opencodeDir, "opencode-swarm.json");
-    if (fs.existsSync(projectConfigPath)) {
-      return;
-    }
-    ensureDir(opencodeDir);
-    saveJson(projectConfigPath, { agents: {} });
-    console.log("\u2713 Created project config at:", projectConfigPath);
-  } catch (error) {
-    console.warn("\u26A0 Could not create project config \u2014 installation will continue:");
-    console.warn(`  ${error instanceof Error ? error.message : String(error)}`);
-  }
-}
 async function install() {
   console.log(`\uD83D\uDC1D Installing OpenCode Swarm...
 `);
@@ -272,6 +264,7 @@ async function install() {
   }
   if (!fs.existsSync(PLUGIN_CONFIG_PATH)) {
     const defaultConfig = {
+      $schema: CONFIG_SCHEMA_REF,
       agents: { ...DEFAULT_AGENT_CONFIGS },
       max_iterations: 5
     };
@@ -280,7 +273,6 @@ async function install() {
   } else {
     console.log("\u2713 Plugin config already exists at:", PLUGIN_CONFIG_PATH);
   }
-  writeProjectConfigIfMissing(process.cwd());
   console.log(`
 \uD83D\uDCC1 Configuration files:`);
   console.log(`   OpenCode config: ${OPENCODE_CONFIG_PATH}`);

package/dist/cli/{knowledge-escalator-22zaj224.js → knowledge-escalator-x85t1e66.js}

@@ -9,17 +9,17 @@ import {
   maybeEscalateOnViolation,
   maybeQuarantineOnContradiction,
   readRecentEscalations
-} from "./index-vwx0by4y.js";
-import"./index-x71shq8j.js";
-import"./index-f036tggv.js";
-import"./index-gm10kvne.js";
+} from "./index-k48kgm6z.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-663wnh64.js";
-import"./index-f776m4r5.js";
+import"./index-tcbjjppb.js";
+import"./index-b1tenv2s.js";
 import"./index-9e6fdz2h.js";
 import"./index-4rhhvd1a.js";
 import"./index-yt75r1er.js";

package/dist/cli/{knowledge-events-xbx1k408.js → knowledge-events-bwx99mxc.js}

@@ -29,15 +29,15 @@ import {
   resolveKnowledgeCounterBaselinePath,
   resolveKnowledgeEventsPath,
   resolveLegacyApplicationLogPath
-} from "./index-f036tggv.js";
-import"./index-gm10kvne.js";
+} from "./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-663wnh64.js";
-import"./index-f776m4r5.js";
+import"./index-tcbjjppb.js";
+import"./index-b1tenv2s.js";
 import"./index-9e6fdz2h.js";
 import"./index-4rhhvd1a.js";
 import"./index-yt75r1er.js";

package/dist/cli/{knowledge-store-fnm8xh9c.js → knowledge-store-21m81zsa.js}

@@ -42,7 +42,7 @@ import {
   transactKnowledge,
   transactKnowledgeWithCas,
   wordBigrams
-} from "./index-x71shq8j.js";
+} from "./index-erdsawqz.js";
 import {
   resolveHiveDataDir
 } from "./index-ae75rja9.js";

package/dist/cli/{knowledge-validator-t2jztjy1.js → knowledge-validator-yxcadg1p.js}

@@ -23,10 +23,10 @@ import {
   validateLesson,
   validateSkillCandidatePath,
   validateSkillPath
-} from "./index-dmfbmnp7.js";
+} from "./index-vywbn766.js";
 import"./index-pfnj5pvs.js";
 import"./index-rtry5xyf.js";
-import"./index-x71shq8j.js";
+import"./index-erdsawqz.js";
 import"./index-ae75rja9.js";
 import"./index-5zgf140g.js";
 import"./index-h52hs4e9.js";

package/dist/cli/{pending-delegations-29rtv1gb.js → pending-delegations-b8qka5nf.js}

@@ -64,7 +64,7 @@ import {
   sweepStaleDelegations,
   updateCoderSettlement,
   writeDelegationFallback
-} from "./index-yfbp4q09.js";
+} from "./index-e2s08v0q.js";
 import"./index-ddszzne4.js";
 import"./index-dtn0pne5.js";
 import"./index-z6xqpmqg.js";

package/dist/cli/{pr-review-reentry-authorization-25dep81m.js → pr-review-reentry-authorization-wv3ck5kh.js}

@@ -3,43 +3,43 @@ import {
   PrReviewRunIdSchema,
   prWorkflowSessionFileStem,
   readPrReviewReentryBindingContext
-} from "./index-rac2gkvr.js";
+} from "./index-3e8600a7.js";
 import"./index-z54qw70y.js";
-import"./index-rc93mm6e.js";
-import"./index-rd324153.js";
-import"./index-bv24pbaj.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-y3hdwh66.js";
-import"./index-vwx0by4y.js";
-import"./index-5tchehv7.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-x4ftmdha.js";
+import"./index-mc9qgkwd.js";
 import"./index-zsrtt42s.js";
-import"./index-c57cyrwn.js";
+import"./index-1sdb57jv.js";
 import"./index-3f7hqtgg.js";
 import"./index-8fqb0ynp.js";
-import"./index-dmfbmnp7.js";
+import"./index-vywbn766.js";
 import"./index-pfnj5pvs.js";
 import"./index-rtry5xyf.js";
-import"./index-fwe1wh6r.js";
-import"./index-a1884hh4.js";
-import"./index-yfbp4q09.js";
+import"./index-we3nf5as.js";
+import"./index-pvzaryhr.js";
+import"./index-e2s08v0q.js";
 import"./index-ddszzne4.js";
-import"./index-nvta6kcv.js";
-import"./index-6xxpwk5x.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-x71shq8j.js";
-import"./index-f036tggv.js";
-import"./index-gm10kvne.js";
+import"./index-erdsawqz.js";
+import"./index-35grv4jg.js";
+import"./index-hte1e31d.js";
 import"./index-gprxjmm7.js";
 import"./index-n832052r.js";
 import {
@@ -47,8 +47,8 @@ import {
 } from "./index-dtn0pne5.js";
 import"./index-z6xqpmqg.js";
 import"./index-r3mvsbtq.js";
-import"./index-663wnh64.js";
-import"./index-f776m4r5.js";
+import"./index-tcbjjppb.js";
+import"./index-b1tenv2s.js";
 import"./index-9e6fdz2h.js";
 import"./index-4rhhvd1a.js";
 import"./index-yt75r1er.js";

package/dist/cli/{pr-subscriptions-cgac3ydd.js → pr-subscriptions-j9j70bmd.js}

@@ -14,7 +14,7 @@ import {
   sweepStale,
   unsubscribe,
   updateSnapshot
-} from "./index-x4ftmdha.js";
+} from "./index-mc9qgkwd.js";
 import"./index-dtn0pne5.js";
 import"./index-z6xqpmqg.js";
 import"./index-r3mvsbtq.js";

package/dist/cli/{scan-cursor-8acs9kwe.js → scan-cursor-m3w0tapb.js}

@@ -4,8 +4,8 @@ import {
   alreadyCuratedThisGeneration,
   claimNextScanBatch,
   getScanStatus
-} from "./index-5tchehv7.js";
-import"./index-x71shq8j.js";
+} from "./index-xmz69g65.js";
+import"./index-erdsawqz.js";
 import"./index-9e6fdz2h.js";
 import"./index-4rhhvd1a.js";
 import"./index-ae75rja9.js";

package/dist/cli/{schema-rjhassd0.js → schema-0b0dqn28.js}

@@ -101,7 +101,7 @@ import {
   resolveGeneratedAgentRole,
   resolveGuardrailsConfig,
   stripKnownSwarmPrefix
-} from "./index-f776m4r5.js";
+} from "./index-b1tenv2s.js";
 import"./index-yt75r1er.js";
 import"./index-zjygnfay.js";
 import"./index-bk5tah7q.js";

package/dist/cli/{scope-persistence-jb1a5dzh.js → scope-persistence-199f7yqc.js}

@@ -23,12 +23,12 @@ import {
   tombstoneScopeBinding,
   writeScopeBindingToDisk,
   writeScopeToDisk
-} from "./index-nvta6kcv.js";
-import"./index-6xxpwk5x.js";
+} from "./index-ynjy98vv.js";
+import"./index-b82tq895.js";
 import"./index-nwkr6tvv.js";
 import"./index-556ja8an.js";
-import"./index-663wnh64.js";
-import"./index-f776m4r5.js";
+import"./index-tcbjjppb.js";
+import"./index-b1tenv2s.js";
 import"./index-9e6fdz2h.js";
 import"./index-4rhhvd1a.js";
 import"./index-yt75r1er.js";

package/dist/cli/{skill-generator-frgppk1w.js → skill-generator-a2ekcbe2.js}

@@ -33,21 +33,21 @@ import {
   sanitizeSlug,
   selectCandidateEntries,
   writeEvalStub
-} from "./index-y3hdwh66.js";
-import"./index-dmfbmnp7.js";
+} from "./index-fcp41snp.js";
+import"./index-vywbn766.js";
 import"./index-pfnj5pvs.js";
 import"./index-rtry5xyf.js";
 import"./index-q7sjgr1y.js";
-import"./index-x71shq8j.js";
-import"./index-f036tggv.js";
-import"./index-gm10kvne.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-663wnh64.js";
-import"./index-f776m4r5.js";
+import"./index-tcbjjppb.js";
+import"./index-b1tenv2s.js";
 import"./index-9e6fdz2h.js";
 import"./index-4rhhvd1a.js";
 import"./index-yt75r1er.js";

package/dist/cli/{worktree-collision-ownership-f5sj6ffa.js → worktree-collision-ownership-5qaab3q7.js}

@@ -10,7 +10,7 @@ import {
 import {
   scanDelegationFallbacksForRecovery,
   scanDelegationsForRecovery
-} from "./index-yfbp4q09.js";
+} from "./index-e2s08v0q.js";
 import"./index-ddszzne4.js";
 import"./index-dtn0pne5.js";
 import"./index-z6xqpmqg.js";

package/dist/cli/{worktree-isolation-5b0w6bha.js → worktree-isolation-esesc842.js}

@@ -21,52 +21,52 @@ import {
   sanitizeWorktreeTaskId,
   standardWorktreeByCallID,
   standardWorktreeSerializationSessions
-} from "./index-rac2gkvr.js";
+} from "./index-3e8600a7.js";
 import"./index-z54qw70y.js";
-import"./index-rc93mm6e.js";
-import"./index-rd324153.js";
-import"./index-bv24pbaj.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-y3hdwh66.js";
-import"./index-vwx0by4y.js";
-import"./index-5tchehv7.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-x4ftmdha.js";
+import"./index-mc9qgkwd.js";
 import"./index-zsrtt42s.js";
-import"./index-c57cyrwn.js";
+import"./index-1sdb57jv.js";
 import"./index-3f7hqtgg.js";
 import"./index-8fqb0ynp.js";
-import"./index-dmfbmnp7.js";
+import"./index-vywbn766.js";
 import"./index-pfnj5pvs.js";
 import"./index-rtry5xyf.js";
-import"./index-fwe1wh6r.js";
-import"./index-a1884hh4.js";
-import"./index-yfbp4q09.js";
+import"./index-we3nf5as.js";
+import"./index-pvzaryhr.js";
+import"./index-e2s08v0q.js";
 import"./index-ddszzne4.js";
-import"./index-nvta6kcv.js";
-import"./index-6xxpwk5x.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-x71shq8j.js";
-import"./index-f036tggv.js";
+import"./index-erdsawqz.js";
+import"./index-35grv4jg.js";
 import {
   resolveWorktreeIsolationConfig
-} from "./index-gm10kvne.js";
+} from "./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-663wnh64.js";
-import"./index-f776m4r5.js";
+import"./index-tcbjjppb.js";
+import"./index-b1tenv2s.js";
 import"./index-9e6fdz2h.js";
 import"./index-4rhhvd1a.js";
 import"./index-yt75r1er.js";

package/dist/commands/close.d.ts

@@ -146,6 +146,7 @@ export interface CloseStageContext {
     archiveSuffix: string;
     args: string[];
 }
+declare function archiveCloseSummary(ctx: Pick<CloseStageContext, 'archiveStageFailed' | 'archiveDir' | 'warnings'>, closeSummaryPath: string, summaryWritten: boolean): Promise<void>;
 declare function countSessionKnowledgeEntries(entries: CloseKnowledgeEntry[], sessionStart: string | undefined, fallbackCount: number): number;
 /**
  * Backward-compatible wrapper that returns only the copied count.
@@ -296,6 +297,7 @@ export declare const _internals: {
     runFinalizeRewardSweep: typeof runFinalizeRewardSweep;
     acquireFinalizeLock: typeof acquireFinalizeLock;
     runArchiveStage: typeof runArchiveStage;
+    archiveCloseSummary: typeof archiveCloseSummary;
     runArchiveEvidenceRetention: typeof runArchiveEvidenceRetention;
     runCleanStage: typeof runCleanStage;
     runAlignStage: typeof runAlignStage;

package/dist/config/loader.d.ts

@@ -1,6 +1,9 @@
 import type { z } from 'zod';
 import { type PluginConfig } from './schema';
 export declare const MAX_CONFIG_FILE_BYTES = 102400;
+export declare const _internals: {
+    resetUnknownTopLevelKeyWarning(): void;
+};
 export { deepMerge, MAX_MERGE_DEPTH } from '../utils/merge';
 /**
  * Flatten a ZodError into a compact, single-line, human-readable summary that

package/dist/config/project-init.d.ts

@@ -1,12 +1,16 @@
 /**
- * Creates .opencode/opencode-swarm.json in the given directory if it does not
- * already exist. Uses an atomic exclusive write (flag 'wx') so concurrent
- * plugin loads never double-write or corrupt the file.
- *
- * Non-fatal: any fs error (permissions, disk full, etc.) is swallowed so the
- * plugin continues with its default or global config.
+ * Absolute `$schema` reference written into config files this plugin authors
+ * (issue #1663) so editors get validation/autocomplete from the shipped
+ * opencode-swarm.schema.json. Version-pinned on purpose: the schema validating
+ * a config file should be the one shipped by the plugin version that authored
+ * it, and unpkg serves every published version. A relative path is unusable
+ * because these config files live in the user's project/home directory,
+ * outside the installed package. This is a DIFFERENT convention from the
+ * unversioned canonical URL (CONFIG_SCHEMA_CANONICAL_URL in
+ * scripts/generate-config-schema.ts) used as the artifact's `$id` and in
+ * docs — both resolve to the same file in every published package.
  */
-export declare function writeProjectConfigIfNew(directory: string, _quiet?: boolean): void;
+export declare const CONFIG_SCHEMA_REF: string;
 /**
  * Writes .swarm/config.example.json on first plugin init for a given project.
  * Creates .swarm/ if it does not yet exist. Non-fatal: all errors are silently

package/dist/config/schema.d.ts

@@ -1804,6 +1804,7 @@ export declare const PrReviewResilienceConfigSchema: z.ZodObject<{
     circuit_open_duration_ms: z.ZodDefault<z.ZodNumber>;
 }, z.core.$strict>;
 export declare const PluginConfigSchema: z.ZodObject<{
+    $schema: z.ZodCatch<z.ZodOptional<z.ZodString>>;
     config_format_version: z.ZodDefault<z.ZodNumber>;
     agents: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
         model: z.ZodOptional<z.ZodString>;