opencode-swarm 7.77.7 → 7.78.0

package/dist/cli/index.js

@@ -52,7 +52,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "opencode-swarm",
-    version: "7.77.7",
+    version: "7.78.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",

package/dist/hooks/knowledge-events.d.ts

@@ -150,6 +150,7 @@ export declare const RECEIPT_EVENT_TYPES: ReadonlySet<string>;
 export declare function resolveKnowledgeEventsPath(directory: string): string;
 /** Returns `.swarm/knowledge-counter-baseline.json` for folded event counters. */
 export declare function resolveKnowledgeCounterBaselinePath(directory: string): string;
+export declare function resolveHiveEventsPath(): string;
 /** Returns `.swarm/knowledge-application.jsonl` for legacy v2 audit records. */
 export declare function resolveLegacyApplicationLogPath(directory: string): string;
 /** Generate a fresh trace id. One per retrieval; receipts reference it. */
@@ -169,12 +170,29 @@ export declare function appendKnowledgeEvent(directory: string, event: Knowledge
  * execution). Never throws; logs a warning and returns null on failure.
  */
 export declare function recordKnowledgeEvent(directory: string, event: KnowledgeEventInput): Promise<KnowledgeEvent | null>;
+/**
+ * Append one event to the shared, cross-project hive events log. Use for audit
+ * tombstones of mutations to the hive store so any project can read why a hive
+ * entry was archived/quarantined/purged. Throws on I/O failure; hot paths should
+ * prefer {@link recordHiveKnowledgeEvent}.
+ */
+export declare function appendHiveKnowledgeEvent(event: KnowledgeEventInput): Promise<KnowledgeEvent>;
+/**
+ * Fail-open variant of {@link appendHiveKnowledgeEvent} for hot paths. Never
+ * throws; logs a warning and returns null on failure.
+ */
+export declare function recordHiveKnowledgeEvent(event: KnowledgeEventInput): Promise<KnowledgeEvent | null>;
 /**
  * Read all events from the log. Skips corrupted JSONL lines (logging a warning
  * for each) and returns an empty array when the file does not exist — mirrors
  * `readKnowledge` in knowledge-store.ts.
  */
 export declare function readKnowledgeEvents(directory: string): Promise<KnowledgeEvent[]>;
+/**
+ * Read all events from the shared, cross-project hive events log. Skips
+ * corrupted JSONL lines and returns an empty array when the file does not exist.
+ */
+export declare function readHiveKnowledgeEvents(): Promise<KnowledgeEvent[]>;
 /**
  * Read legacy knowledge-application audit records. Corrupt lines are skipped so
  * stale telemetry cannot break search, promotion, or manual recall.
@@ -292,5 +310,9 @@ export declare const _internals: {
     applyKnowledgeVerdictFeedback: typeof applyKnowledgeVerdictFeedback;
     newTraceId: typeof newTraceId;
     newEventId: typeof newEventId;
+    resolveHiveEventsPath: typeof resolveHiveEventsPath;
+    appendHiveKnowledgeEvent: typeof appendHiveKnowledgeEvent;
+    recordHiveKnowledgeEvent: typeof recordHiveKnowledgeEvent;
+    readHiveKnowledgeEvents: typeof readHiveKnowledgeEvents;
 };
 export {};

package/dist/hooks/knowledge-store.d.ts

@@ -6,6 +6,7 @@ export declare function resolveSwarmRejectedPath(directory: string): string;
 export declare function resolveSwarmRetractionsPath(directory: string): string;
 export declare function resolveHiveKnowledgePath(): string;
 export declare function resolveHiveRejectedPath(): string;
+export declare function resolveHiveEventsPath(): string;
 export declare function readKnowledge<T>(filePath: string): Promise<T[]>;
 export declare function normalizeEntry<T>(raw: T): T;
 export declare function readRejectedLessons(directory: string): Promise<RejectedLesson[]>;
@@ -73,6 +74,7 @@ export declare const _internals: {
     resolveSwarmRejectedPath: typeof resolveSwarmRejectedPath;
     resolveHiveKnowledgePath: typeof resolveHiveKnowledgePath;
     resolveHiveRejectedPath: typeof resolveHiveRejectedPath;
+    resolveHiveEventsPath: typeof resolveHiveEventsPath;
     readKnowledge: typeof readKnowledge;
     readRejectedLessons: typeof readRejectedLessons;
     appendKnowledge: typeof appendKnowledge;

package/dist/index.js

@@ -69,7 +69,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "opencode-swarm",
-    version: "7.77.7",
+    version: "7.78.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",
@@ -59678,6 +59678,7 @@ __export(exports_knowledge_store, {
   resolveSwarmKnowledgePath: () => resolveSwarmKnowledgePath,
   resolveHiveRejectedPath: () => resolveHiveRejectedPath,
   resolveHiveKnowledgePath: () => resolveHiveKnowledgePath,
+  resolveHiveEventsPath: () => resolveHiveEventsPath,
   readRetractionRecords: () => readRetractionRecords,
   readRejectedLessons: () => readRejectedLessons,
   readKnowledge: () => readKnowledge,
@@ -59739,6 +59740,10 @@ function resolveHiveRejectedPath() {
   const hivePath = resolveHiveKnowledgePath();
   return path31.join(path31.dirname(hivePath), "shared-learnings-rejected.jsonl");
 }
+function resolveHiveEventsPath() {
+  const hivePath = resolveHiveKnowledgePath();
+  return path31.join(path31.dirname(hivePath), "shared-knowledge-events.jsonl");
+}
 async function readKnowledge(filePath) {
   if (!existsSync13(filePath))
     return [];
@@ -60181,6 +60186,7 @@ var init_knowledge_store = __esm(() => {
     resolveSwarmRejectedPath,
     resolveHiveKnowledgePath,
     resolveHiveRejectedPath,
+    resolveHiveEventsPath,
     readKnowledge,
     readRejectedLessons,
     appendKnowledge,
@@ -60208,11 +60214,14 @@ __export(exports_knowledge_events, {
   resolveLegacyApplicationLogPath: () => resolveLegacyApplicationLogPath,
   resolveKnowledgeEventsPath: () => resolveKnowledgeEventsPath,
   resolveKnowledgeCounterBaselinePath: () => resolveKnowledgeCounterBaselinePath,
+  resolveHiveEventsPath: () => resolveHiveEventsPath2,
   recordKnowledgeEvent: () => recordKnowledgeEvent,
+  recordHiveKnowledgeEvent: () => recordHiveKnowledgeEvent,
   recomputeCounters: () => recomputeCounters,
   readLegacyApplicationRecords: () => readLegacyApplicationRecords,
   readKnowledgeEvents: () => readKnowledgeEvents,
   readKnowledgeCounterRollups: () => readKnowledgeCounterRollups,
+  readHiveKnowledgeEvents: () => readHiveKnowledgeEvents,
   newTraceId: () => newTraceId,
   newEventId: () => newEventId,
   effectiveRetrievalOutcomes: () => effectiveRetrievalOutcomes,
@@ -60220,6 +60229,7 @@ __export(exports_knowledge_events, {
   countEntryViolationsInWindow: () => countEntryViolationsInWindow,
   applyKnowledgeVerdictFeedback: () => applyKnowledgeVerdictFeedback,
   appendKnowledgeEvent: () => appendKnowledgeEvent,
+  appendHiveKnowledgeEvent: () => appendHiveKnowledgeEvent,
   _internals: () => _internals24,
   RECEIPT_EVENT_TYPES: () => RECEIPT_EVENT_TYPES,
   MAX_VIOLATION_TIMESTAMPS: () => MAX_VIOLATION_TIMESTAMPS,
@@ -60229,6 +60239,7 @@ __export(exports_knowledge_events, {
 import { randomUUID as randomUUID2 } from "node:crypto";
 import { existsSync as existsSync14 } from "node:fs";
 import { appendFile as appendFile4, mkdir as mkdir5, readFile as readFile5, stat as stat4 } from "node:fs/promises";
+import * as os10 from "node:os";
 import * as path32 from "node:path";
 function resolveKnowledgeEventsPath(directory) {
   return path32.join(directory, ".swarm", "knowledge-events.jsonl");
@@ -60236,6 +60247,19 @@ function resolveKnowledgeEventsPath(directory) {
 function resolveKnowledgeCounterBaselinePath(directory) {
   return path32.join(directory, ".swarm", "knowledge-counter-baseline.json");
 }
+function resolveHiveEventsPath2() {
+  const platform = process.platform;
+  const home = process.env.HOME || os10.homedir();
+  let dir;
+  if (platform === "win32") {
+    dir = path32.join(process.env.LOCALAPPDATA || path32.join(home, "AppData", "Local"), "opencode-swarm", "Data");
+  } else if (platform === "darwin") {
+    dir = path32.join(home, "Library", "Application Support", "opencode-swarm");
+  } else {
+    dir = path32.join(process.env.XDG_DATA_HOME || path32.join(home, ".local", "share"), "opencode-swarm");
+  }
+  return path32.join(dir, "shared-knowledge-events.jsonl");
+}
 function resolveLegacyApplicationLogPath(directory) {
   return path32.join(directory, ".swarm", "knowledge-application.jsonl");
 }
@@ -60294,6 +60318,45 @@ async function recordKnowledgeEvent(directory, event) {
     return null;
   }
 }
+async function appendHiveKnowledgeEvent(event) {
+  const populated = withDefaults(event);
+  const filePath = resolveHiveEventsPath2();
+  const dirPath = path32.dirname(filePath);
+  await mkdir5(dirPath, { recursive: true });
+  let release;
+  try {
+    release = await import_proper_lockfile4.default.lock(dirPath, {
+      retries: { retries: 200, minTimeout: 10, maxTimeout: 100 }
+    });
+    await appendFile4(filePath, `${JSON.stringify(populated)}
+`, "utf-8");
+    try {
+      const content = await readFile5(filePath, "utf-8");
+      const lines = content.split(`
+`).filter((line) => line.trim().length > 0);
+      if (lines.length > MAX_EVENT_LOG_ENTRIES) {
+        const trimmed = lines.slice(lines.length - MAX_EVENT_LOG_ENTRIES);
+        await atomicWriteFile(filePath, `${trimmed.join(`
+`)}
+`);
+      }
+    } catch (err2) {
+      warn(`[knowledge-events] hive cap trim failed (non-fatal): ${err2 instanceof Error ? err2.message : String(err2)}`);
+    }
+  } finally {
+    if (release)
+      await release().catch(() => {});
+  }
+  return populated;
+}
+async function recordHiveKnowledgeEvent(event) {
+  try {
+    return await appendHiveKnowledgeEvent(event);
+  } catch (err2) {
+    warn(`[knowledge-events] recordHiveKnowledgeEvent failed: ${err2 instanceof Error ? err2.message : String(err2)}`);
+    return null;
+  }
+}
 async function readKnowledgeEvents(directory) {
   const filePath = resolveKnowledgeEventsPath(directory);
   if (!existsSync14(filePath))
@@ -60302,6 +60365,14 @@ async function readKnowledgeEvents(directory) {
   return parseEventLines(content.split(`
 `), filePath);
 }
+async function readHiveKnowledgeEvents() {
+  const filePath = resolveHiveEventsPath2();
+  if (!existsSync14(filePath))
+    return [];
+  const content = await readFile5(filePath, "utf-8");
+  return parseEventLines(content.split(`
+`), filePath);
+}
 async function readLegacyApplicationRecords(directory) {
   const filePath = resolveLegacyApplicationLogPath(directory);
   if (!existsSync14(filePath))
@@ -60704,7 +60775,11 @@ var init_knowledge_events = __esm(() => {
     recomputeCounters,
     applyKnowledgeVerdictFeedback,
     newTraceId,
-    newEventId
+    newEventId,
+    resolveHiveEventsPath: resolveHiveEventsPath2,
+    appendHiveKnowledgeEvent,
+    recordHiveKnowledgeEvent,
+    readHiveKnowledgeEvents
   };
 });
 
@@ -70219,10 +70294,10 @@ var init_concurrency = __esm(() => {
 });
 
 // src/commands/config.ts
-import * as os10 from "node:os";
+import * as os11 from "node:os";
 import * as path50 from "node:path";
 function getUserConfigDir2() {
-  return process.env.XDG_CONFIG_HOME || path50.join(os10.homedir(), ".config");
+  return process.env.XDG_CONFIG_HOME || path50.join(os11.homedir(), ".config");
 }
 async function handleConfigCommand(directory, _args) {
   const config3 = loadPluginConfig(directory);
@@ -71358,13 +71433,13 @@ var init_design_docs = __esm(() => {
 });
 
 // src/config/cache-paths.ts
-import * as os11 from "node:os";
+import * as os12 from "node:os";
 import * as path54 from "node:path";
 function getPluginConfigDir() {
-  return path54.join(process.env.XDG_CONFIG_HOME || path54.join(os11.homedir(), ".config"), "opencode");
+  return path54.join(process.env.XDG_CONFIG_HOME || path54.join(os12.homedir(), ".config"), "opencode");
 }
 function getPluginCachePaths() {
-  const cacheBase = process.env.XDG_CACHE_HOME || path54.join(os11.homedir(), ".cache");
+  const cacheBase = process.env.XDG_CACHE_HOME || path54.join(os12.homedir(), ".cache");
   const configDir = getPluginConfigDir();
   const paths = [
     path54.join(cacheBase, "opencode", "node_modules", "opencode-swarm"),
@@ -71372,12 +71447,12 @@ function getPluginCachePaths() {
     path54.join(configDir, "node_modules", "opencode-swarm")
   ];
   if (process.platform === "darwin") {
-    const libCaches = path54.join(os11.homedir(), "Library", "Caches");
+    const libCaches = path54.join(os12.homedir(), "Library", "Caches");
     paths.push(path54.join(libCaches, "opencode", "node_modules", "opencode-swarm"), path54.join(libCaches, "opencode", "packages", "opencode-swarm@latest"));
   }
   if (process.platform === "win32") {
-    const localAppData = process.env.LOCALAPPDATA || path54.join(os11.homedir(), "AppData", "Local");
-    const appData = process.env.APPDATA || path54.join(os11.homedir(), "AppData", "Roaming");
+    const localAppData = process.env.LOCALAPPDATA || path54.join(os12.homedir(), "AppData", "Local");
+    const appData = process.env.APPDATA || path54.join(os12.homedir(), "AppData", "Roaming");
     paths.push(path54.join(localAppData, "opencode", "node_modules", "opencode-swarm"), path54.join(localAppData, "opencode", "packages", "opencode-swarm@latest"), path54.join(appData, "opencode", "node_modules", "opencode-swarm"));
   }
   return paths;
@@ -71500,11 +71575,11 @@ var init_gate_bridge = __esm(() => {
 
 // src/services/version-check.ts
 import { existsSync as existsSync28, mkdirSync as mkdirSync16, readFileSync as readFileSync13, writeFileSync as writeFileSync9 } from "node:fs";
-import { homedir as homedir6 } from "node:os";
+import { homedir as homedir7 } from "node:os";
 import { join as join43 } from "node:path";
 function cacheDir() {
   const xdg = process.env.XDG_CACHE_HOME;
-  const base = xdg && xdg.length > 0 ? xdg : join43(homedir6(), ".cache");
+  const base = xdg && xdg.length > 0 ? xdg : join43(homedir7(), ".cache");
   return join43(base, "opencode-swarm");
 }
 function cacheFile() {
@@ -72660,7 +72735,7 @@ __export(exports_config_doctor, {
 });
 import * as crypto5 from "node:crypto";
 import * as fs24 from "node:fs";
-import * as os12 from "node:os";
+import * as os13 from "node:os";
 import * as path56 from "node:path";
 function levenshteinDistance(a, b) {
   const al = a.length;
@@ -72694,7 +72769,7 @@ function emitObjectTypeMismatch(key, value, findings) {
   }
 }
 function getUserConfigDir3() {
-  return process.env.XDG_CONFIG_HOME || path56.join(os12.homedir(), ".config");
+  return process.env.XDG_CONFIG_HOME || path56.join(os13.homedir(), ".config");
 }
 function getConfigPaths(directory) {
   const userConfigPath = path56.join(getUserConfigDir3(), "opencode", "opencode-swarm.json");
@@ -77779,7 +77854,7 @@ var KNOWLEDGE_SCHEMA_VERSION = 2;
 import { randomUUID as randomUUID6 } from "node:crypto";
 import { existsSync as existsSync34, readFileSync as readFileSync18 } from "node:fs";
 import { mkdir as mkdir16, readFile as readFile18, writeFile as writeFile14 } from "node:fs/promises";
-import * as os13 from "node:os";
+import * as os14 from "node:os";
 import * as path60 from "node:path";
 async function migrateKnowledgeToExternal(_directory, _config) {
   return {
@@ -78131,7 +78206,7 @@ async function writeSentinel(sentinelPath, migrated, dropped) {
 }
 function resolveLegacyHiveKnowledgePath() {
   const platform = process.platform;
-  const home = process.env.HOME || os13.homedir();
+  const home = process.env.HOME || os14.homedir();
   let dataDir;
   if (platform === "win32") {
     dataDir = path60.join(process.env.LOCALAPPDATA || path60.join(home, "AppData", "Local"), "opencode-swarm", "Data");
@@ -81404,7 +81479,7 @@ var init_gateway = __esm(() => {
 
 // src/memory/evaluation.ts
 import * as fs27 from "node:fs/promises";
-import * as os14 from "node:os";
+import * as os15 from "node:os";
 import * as path65 from "node:path";
 async function evaluateMemoryRecallFixtures(options) {
   const fixtureDirectory = path65.resolve(options.fixtureDirectory);
@@ -81416,7 +81491,7 @@ async function evaluateMemoryRecallFixtures(options) {
   for (const fixture of fixtures) {
     const materialized = materializeFixture(fixture);
     for (const providerName of providers) {
-      const tempRoot = await fs27.realpath(await fs27.mkdtemp(path65.join(os14.tmpdir(), "swarm-memory-eval-")));
+      const tempRoot = await fs27.realpath(await fs27.mkdtemp(path65.join(os15.tmpdir(), "swarm-memory-eval-")));
       const provider = createEvaluationProvider(providerName, tempRoot);
       try {
         await provider.initialize?.();
@@ -108163,7 +108238,7 @@ init_path_security();
 import * as fsSync7 from "node:fs";
 import { existsSync as existsSync63, realpathSync as realpathSync13 } from "node:fs";
 import * as fsPromises5 from "node:fs/promises";
-import * as os15 from "node:os";
+import * as os16 from "node:os";
 import * as path108 from "node:path";
 
 // src/tools/symbols.ts
@@ -109466,8 +109541,8 @@ function isRefusedWorkspaceRoot(target) {
       refused.add(path108.resolve(p));
     }
   };
-  add2(os15.homedir());
-  add2(os15.tmpdir());
+  add2(os16.homedir());
+  add2(os16.tmpdir());
   add2("/");
   add2("/Users");
   add2("/home");
@@ -129002,7 +129077,7 @@ var knowledge_archive = createSwarmTool({
     if (!found) {
       return JSON.stringify({ success: false, message: "entry not found" });
     }
-    await recordKnowledgeEvent(directory, {
+    const tombstone = {
       type: "archived",
       entry_id: id,
       tier,
@@ -129011,7 +129086,12 @@ var knowledge_archive = createSwarmTool({
       mode,
       evidence,
       previous_status: previousStatus
-    });
+    };
+    if (tier === "hive") {
+      await recordHiveKnowledgeEvent(tombstone);
+    } else {
+      await recordKnowledgeEvent(directory, tombstone);
+    }
     return JSON.stringify({
       success: true,
       id,

package/dist/tools/knowledge-archive.d.ts

@@ -10,6 +10,10 @@
  *  - 'archive'    (default): set status='archived' — TTL-exempt, hidden from recall.
  *  - 'quarantine':           set status='quarantined' — suspected-bad, hidden from recall.
  *  - 'purge':                hard-delete the JSONL line. Requires allow_purge:true.
+ *
+ * Tiers:
+ *  - 'swarm' (default): archives a project-local swarm entry.
+ *  - 'hive':            archives a shared hive entry (cross-project knowledge).
  */
 import { createSwarmTool } from './create-tool.js';
 export declare const knowledge_archive: ReturnType<typeof createSwarmTool>;

package/package.json

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