opencode-swarm 6.86.10 → 6.86.12

package/dist/cli/index.js

@@ -18580,7 +18580,7 @@ import * as path33 from "path";
 // package.json
 var package_default = {
   name: "opencode-swarm",
-  version: "6.86.10",
+  version: "6.86.12",
   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",
@@ -19091,13 +19091,6 @@ var AgentOverrideConfigSchema = exports_external.object({
   temperature: exports_external.number().min(0).max(2).optional(),
   disabled: exports_external.boolean().optional(),
   fallback_models: exports_external.array(exports_external.string()).max(3).optional()
-}).refine((data) => {
-  if (data.model && !data.fallback_models) {
-    console.warn(`[opencode-swarm] WARNING: Agent configured with custom model "${data.model}" but no fallback_models. This means if the custom model fails, there is no fallback protection. Consider adding fallback_models for reliability.`);
-  }
-  return true;
-}, {
-  message: "Agent configuration warning: Custom model without fallback protection"
 });
 var SwarmConfigSchema = exports_external.object({
   name: exports_external.string().optional(),
@@ -39487,6 +39480,9 @@ async function handleHistoryCommand(directory, _args) {
   const historyData = await getHistoryData(directory);
   return formatHistoryMarkdown(historyData);
 }
+// src/commands/knowledge.ts
+import { join as join21 } from "path";
+
 // src/hooks/knowledge-migrator.ts
 init_logger();
 import { randomUUID as randomUUID2 } from "crypto";
@@ -39717,34 +39713,65 @@ async function writeSentinel(sentinelPath, migrated, dropped) {
 }
 
 // src/commands/knowledge.ts
+function resolveEntryByPrefix(entries, inputId) {
+  const exact = entries.find((e) => e.id === inputId);
+  if (exact)
+    return { entry: exact };
+  const matches = entries.filter((e) => e.id.startsWith(inputId));
+  if (matches.length === 0) {
+    return { error: `No entry found matching '${inputId}'.` };
+  }
+  if (matches.length === 1) {
+    return { entry: matches[0] };
+  }
+  const candidates = matches.map((e) => e.id).join(`
+  `);
+  return {
+    error: `Ambiguous prefix '${inputId}' matches ${matches.length} entries:
+  ${candidates}`
+  };
+}
 async function handleKnowledgeQuarantineCommand(directory, args) {
-  const entryId = args[0];
-  if (!entryId) {
+  const inputId = args[0];
+  if (!inputId) {
     return "Usage: /swarm knowledge quarantine <id> [reason]";
   }
-  if (!/^[a-zA-Z0-9_-]{1,64}$/.test(entryId)) {
+  if (!/^[a-zA-Z0-9_-]{1,64}$/.test(inputId)) {
     return "Invalid entry ID. IDs must be 1-64 characters: letters, digits, hyphens, underscores only.";
   }
   const reason = args.slice(1).join(" ") || "Quarantined via /swarm knowledge quarantine command";
   try {
-    await quarantineEntry(directory, entryId, reason, "user");
-    return `\u2705 Entry ${entryId} quarantined successfully.`;
+    const entries = await readKnowledge(resolveSwarmKnowledgePath(directory));
+    const resolved = resolveEntryByPrefix(entries, inputId);
+    if ("error" in resolved) {
+      return `\u274C ${resolved.error}`;
+    }
+    const fullId = resolved.entry.id;
+    await quarantineEntry(directory, fullId, reason, "user");
+    return `\u2705 Entry ${fullId} quarantined successfully.`;
   } catch (error93) {
     console.warn("[knowledge-command] quarantineEntry error:", error93 instanceof Error ? error93.message : String(error93));
     return `\u274C Failed to quarantine entry. Check the entry ID and try again.`;
   }
 }
 async function handleKnowledgeRestoreCommand(directory, args) {
-  const entryId = args[0];
-  if (!entryId) {
+  const inputId = args[0];
+  if (!inputId) {
     return "Usage: /swarm knowledge restore <id>";
   }
-  if (!/^[a-zA-Z0-9_-]{1,64}$/.test(entryId)) {
+  if (!/^[a-zA-Z0-9_-]{1,64}$/.test(inputId)) {
     return "Invalid entry ID. IDs must be 1-64 characters: letters, digits, hyphens, underscores only.";
   }
   try {
-    await restoreEntry(directory, entryId);
-    return `\u2705 Entry ${entryId} restored successfully.`;
+    const quarantinePath = join21(directory, ".swarm", "knowledge-quarantined.jsonl");
+    const entries = await readKnowledge(quarantinePath);
+    const resolved = resolveEntryByPrefix(entries, inputId);
+    if ("error" in resolved) {
+      return `\u274C ${resolved.error}`;
+    }
+    const fullId = resolved.entry.id;
+    await restoreEntry(directory, fullId);
+    return `\u2705 Entry ${fullId} restored successfully.`;
   } catch (error93) {
     console.warn("[knowledge-command] restoreEntry error:", error93 instanceof Error ? error93.message : String(error93));
     return `\u274C Failed to restore entry. Check the entry ID and try again.`;
@@ -39782,16 +39809,16 @@ async function handleKnowledgeListCommand(directory, _args) {
     const lines = [
       `## Knowledge Entries (${entries.length} total)`,
       "",
-      "| ID | Category | Confidence | Lesson (truncated) |",
-      "|------|----------|------------|---------------------|"
+      "| ID (prefix) | Category | Confidence | Lesson (truncated) |",
+      "|--------------|----------|------------|---------------------|"
     ];
     for (const entry of entries) {
       const truncatedLesson = entry.lesson.length > 60 ? `${entry.lesson.slice(0, 57)}...` : entry.lesson;
       const confidencePct = Math.round(entry.confidence * 100);
-      lines.push(`| ${entry.id.slice(0, 8)}... | ${entry.category} | ${confidencePct}% | ${truncatedLesson} |`);
+      lines.push(`| ${entry.id.slice(0, 12)}\u2026 | ${entry.category} | ${confidencePct}% | ${truncatedLesson} |`);
     }
     lines.push("");
-    lines.push("Use `/swarm knowledge quarantine <id>` to hide an entry.");
+    lines.push("Use `/swarm knowledge quarantine <id-prefix>` to hide an entry. Prefix matching is supported \u2014 the 12-character prefix shown is unique in most stores.");
     return lines.join(`
 `);
   } catch (error93) {

package/dist/commands/knowledge.d.ts

@@ -1,11 +1,13 @@
 /**
  * Handles /swarm knowledge quarantine <id> [reason] command.
  * Moves a knowledge entry to quarantine with optional reason.
+ * Accepts a full ID or a unique prefix.
  */
 export declare function handleKnowledgeQuarantineCommand(directory: string, args: string[]): Promise<string>;
 /**
  * Handles /swarm knowledge restore <id> command.
  * Restores a quarantined knowledge entry.
+ * Accepts a full ID or a unique prefix.
  */
 export declare function handleKnowledgeRestoreCommand(directory: string, args: string[]): Promise<string>;
 /**

package/dist/index.js

@@ -33,7 +33,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "opencode-swarm",
-    version: "6.86.10",
+    version: "6.86.12",
     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",
@@ -14798,13 +14798,6 @@ var init_schema = __esm(() => {
     temperature: exports_external.number().min(0).max(2).optional(),
     disabled: exports_external.boolean().optional(),
     fallback_models: exports_external.array(exports_external.string()).max(3).optional()
-  }).refine((data) => {
-    if (data.model && !data.fallback_models) {
-      console.warn(`[opencode-swarm] WARNING: Agent configured with custom model "${data.model}" but no fallback_models. This means if the custom model fails, there is no fallback protection. Consider adding fallback_models for reliability.`);
-    }
-    return true;
-  }, {
-    message: "Agent configuration warning: Custom model without fallback protection"
   });
   SwarmConfigSchema = exports_external.object({
     name: exports_external.string().optional(),
@@ -48403,34 +48396,66 @@ var init_knowledge_migrator = __esm(() => {
 });
 
 // src/commands/knowledge.ts
+import { join as join28 } from "node:path";
+function resolveEntryByPrefix(entries, inputId) {
+  const exact = entries.find((e) => e.id === inputId);
+  if (exact)
+    return { entry: exact };
+  const matches = entries.filter((e) => e.id.startsWith(inputId));
+  if (matches.length === 0) {
+    return { error: `No entry found matching '${inputId}'.` };
+  }
+  if (matches.length === 1) {
+    return { entry: matches[0] };
+  }
+  const candidates = matches.map((e) => e.id).join(`
+  `);
+  return {
+    error: `Ambiguous prefix '${inputId}' matches ${matches.length} entries:
+  ${candidates}`
+  };
+}
 async function handleKnowledgeQuarantineCommand(directory, args2) {
-  const entryId = args2[0];
-  if (!entryId) {
+  const inputId = args2[0];
+  if (!inputId) {
     return "Usage: /swarm knowledge quarantine <id> [reason]";
   }
-  if (!/^[a-zA-Z0-9_-]{1,64}$/.test(entryId)) {
+  if (!/^[a-zA-Z0-9_-]{1,64}$/.test(inputId)) {
     return "Invalid entry ID. IDs must be 1-64 characters: letters, digits, hyphens, underscores only.";
   }
   const reason = args2.slice(1).join(" ") || "Quarantined via /swarm knowledge quarantine command";
   try {
-    await quarantineEntry(directory, entryId, reason, "user");
-    return `✅ Entry ${entryId} quarantined successfully.`;
+    const entries = await readKnowledge(resolveSwarmKnowledgePath(directory));
+    const resolved = resolveEntryByPrefix(entries, inputId);
+    if ("error" in resolved) {
+      return `❌ ${resolved.error}`;
+    }
+    const fullId = resolved.entry.id;
+    await quarantineEntry(directory, fullId, reason, "user");
+    return `✅ Entry ${fullId} quarantined successfully.`;
   } catch (error93) {
     console.warn("[knowledge-command] quarantineEntry error:", error93 instanceof Error ? error93.message : String(error93));
     return `❌ Failed to quarantine entry. Check the entry ID and try again.`;
   }
 }
 async function handleKnowledgeRestoreCommand(directory, args2) {
-  const entryId = args2[0];
-  if (!entryId) {
+  const inputId = args2[0];
+  if (!inputId) {
     return "Usage: /swarm knowledge restore <id>";
   }
-  if (!/^[a-zA-Z0-9_-]{1,64}$/.test(entryId)) {
+  if (!/^[a-zA-Z0-9_-]{1,64}$/.test(inputId)) {
     return "Invalid entry ID. IDs must be 1-64 characters: letters, digits, hyphens, underscores only.";
   }
   try {
-    await restoreEntry(directory, entryId);
-    return `✅ Entry ${entryId} restored successfully.`;
+    const quarantinePath = join28(directory, ".swarm", "knowledge-quarantined.jsonl");
+    const entries = await readKnowledge(quarantinePath);
+    const resolved = resolveEntryByPrefix(entries, inputId);
+    if ("error" in resolved) {
+      return `❌ ${resolved.error}`;
+    }
+    const fullId = resolved.entry.id;
+    await restoreEntry(directory, fullId);
+    return `✅ Entry ${fullId} restored successfully.`;
   } catch (error93) {
     console.warn("[knowledge-command] restoreEntry error:", error93 instanceof Error ? error93.message : String(error93));
     return `❌ Failed to restore entry. Check the entry ID and try again.`;
@@ -48468,16 +48493,16 @@ async function handleKnowledgeListCommand(directory, _args) {
     const lines = [
       `## Knowledge Entries (${entries.length} total)`,
       "",
-      "| ID | Category | Confidence | Lesson (truncated) |",
-      "|------|----------|------------|---------------------|"
+      "| ID (prefix) | Category | Confidence | Lesson (truncated) |",
+      "|--------------|----------|------------|---------------------|"
     ];
     for (const entry of entries) {
       const truncatedLesson = entry.lesson.length > 60 ? `${entry.lesson.slice(0, 57)}...` : entry.lesson;
       const confidencePct = Math.round(entry.confidence * 100);
-      lines.push(`| ${entry.id.slice(0, 8)}... | ${entry.category} | ${confidencePct}% | ${truncatedLesson} |`);
+      lines.push(`| ${entry.id.slice(0, 12)}… | ${entry.category} | ${confidencePct}% | ${truncatedLesson} |`);
     }
     lines.push("");
-    lines.push("Use `/swarm knowledge quarantine <id>` to hide an entry.");
+    lines.push("Use `/swarm knowledge quarantine <id-prefix>` to hide an entry. Prefix matching is supported — the 12-character prefix shown is unique in most stores.");
     return lines.join(`
 `);
   } catch (error93) {
@@ -63848,7 +63873,7 @@ ${content.substring(endIndex + 1)}`;
 init_manager();
 init_utils2();
 import * as fs31 from "node:fs";
-import { join as join41 } from "node:path";
+import { join as join42 } from "node:path";
 function createCompactionCustomizerHook(config3, directory) {
   const enabled = config3.hooks?.compaction !== false;
   if (!enabled) {
@@ -63893,7 +63918,7 @@ function createCompactionCustomizerHook(config3, directory) {
         }
       }
       try {
-        const summariesDir = join41(directory, ".swarm", "summaries");
+        const summariesDir = join42(directory, ".swarm", "summaries");
         const files = await fs31.promises.readdir(summariesDir);
         if (files.length > 0) {
           const count = files.length;
@@ -74626,7 +74651,7 @@ import {
   readFileSync as readFileSync36,
   writeFileSync as writeFileSync11
 } from "node:fs";
-import { join as join65 } from "node:path";
+import { join as join66 } from "node:path";
 var EVIDENCE_DIR2 = ".swarm/evidence";
 var VALID_TASK_ID = /^\d+\.\d+(\.\d+)*$/;
 var COUNCIL_GATE_NAME = "council";
@@ -74660,9 +74685,9 @@ function writeCouncilEvidence(workingDir, synthesis) {
   if (!VALID_TASK_ID.test(synthesis.taskId)) {
     throw new Error(`writeCouncilEvidence: invalid taskId "${synthesis.taskId}" — must match N.M or N.M.P format`);
   }
-  const dir = join65(workingDir, EVIDENCE_DIR2);
+  const dir = join66(workingDir, EVIDENCE_DIR2);
   mkdirSync18(dir, { recursive: true });
-  const filePath = join65(dir, `${synthesis.taskId}.json`);
+  const filePath = join66(dir, `${synthesis.taskId}.json`);
   const existingRoot = Object.create(null);
   if (existsSync37(filePath)) {
     try {
@@ -74696,7 +74721,7 @@ function writeCouncilEvidence(workingDir, synthesis) {
     updated.required_gates = [];
   writeFileSync11(filePath, JSON.stringify(updated, null, 2));
   try {
-    const councilDir = join65(workingDir, ".swarm", "council");
+    const councilDir = join66(workingDir, ".swarm", "council");
     mkdirSync18(councilDir, { recursive: true });
     const auditLine = JSON.stringify({
       round: synthesis.roundNumber,
@@ -74704,7 +74729,7 @@ function writeCouncilEvidence(workingDir, synthesis) {
       timestamp: synthesis.timestamp,
       vetoedBy: synthesis.vetoedBy
     });
-    appendFileSync6(join65(councilDir, `${synthesis.taskId}.rounds.jsonl`), `${auditLine}
+    appendFileSync6(join66(councilDir, `${synthesis.taskId}.rounds.jsonl`), `${auditLine}
 `);
   } catch (auditError) {
     console.warn(`writeCouncilEvidence: failed to append round-history audit log: ${auditError instanceof Error ? auditError.message : String(auditError)}`);
@@ -74837,20 +74862,20 @@ function buildUnifiedFeedback(taskId, verdict, vetoedBy, requiredFixes, advisory
 
 // src/council/criteria-store.ts
 import { existsSync as existsSync38, mkdirSync as mkdirSync19, readFileSync as readFileSync37, writeFileSync as writeFileSync12 } from "node:fs";
-import { join as join66 } from "node:path";
+import { join as join67 } from "node:path";
 var COUNCIL_DIR = ".swarm/council";
 function writeCriteria(workingDir, taskId, criteria) {
-  const dir = join66(workingDir, COUNCIL_DIR);
+  const dir = join67(workingDir, COUNCIL_DIR);
   mkdirSync19(dir, { recursive: true });
   const payload = {
     taskId,
     criteria,
     declaredAt: new Date().toISOString()
   };
-  writeFileSync12(join66(dir, `${safeId(taskId)}.json`), JSON.stringify(payload, null, 2));
+  writeFileSync12(join67(dir, `${safeId(taskId)}.json`), JSON.stringify(payload, null, 2));
 }
 function readCriteria(workingDir, taskId) {
-  const filePath = join66(workingDir, COUNCIL_DIR, `${safeId(taskId)}.json`);
+  const filePath = join67(workingDir, COUNCIL_DIR, `${safeId(taskId)}.json`);
   if (!existsSync38(filePath))
     return null;
   try {
@@ -77395,6 +77420,7 @@ var VALID_CATEGORIES2 = [
   "debugging",
   "performance",
   "integration",
+  "todo",
   "other"
 ];
 var knowledge_add = createSwarmTool({
@@ -77539,6 +77565,7 @@ var VALID_CATEGORIES3 = [
   "debugging",
   "performance",
   "integration",
+  "todo",
   "other"
 ];
 var VALID_STATUSES = ["candidate", "established", "promoted"];
@@ -88776,6 +88803,34 @@ async function initializeOpenCodeSwarm(ctx) {
       }
     }
   }
+  {
+    const noFallback = [];
+    const hasNoFallback = (cfg) => cfg.model && (!cfg.fallback_models || cfg.fallback_models.length === 0);
+    if (config3.agents) {
+      for (const [name2, cfg] of Object.entries(config3.agents)) {
+        if (hasNoFallback(cfg))
+          noFallback.push(`${name2}(${cfg.model})`);
+      }
+    }
+    if (config3.swarms) {
+      for (const [swarmId, swarm] of Object.entries(config3.swarms)) {
+        if (swarm.agents) {
+          for (const [name2, cfg] of Object.entries(swarm.agents)) {
+            if (hasNoFallback(cfg))
+              noFallback.push(`${swarmId}/${name2}(${cfg.model})`);
+          }
+        }
+      }
+    }
+    if (noFallback.length > 0) {
+      const msg = `[opencode-swarm] WARNING: ${noFallback.length} agent(s) use a custom model without fallback_models: ` + noFallback.join(", ") + '. Add "fallback_models": ["model-a"] to each agent config for reliability.';
+      if (!config3.quiet) {
+        console.warn(msg);
+      } else {
+        addDeferredWarning(msg);
+      }
+    }
+  }
   swarmState.fullAutoEnabledInConfig = config3.full_auto?.enabled === true;
   swarmState.opencodeClient = ctx.client;
   await loadSnapshot(ctx.directory);

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "opencode-swarm",
-	"version": "6.86.10",
+	"version": "6.86.12",
 	"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",