opencode-swarm 7.117.0 → 7.118.0

package/dist/knowledge/hive-paths.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Centralized hive (cross-project) storage path resolution.
+ *
+ * Problem (issue #1847 §1): the platform-specific branch that derives the hive
+ * data directory was duplicated across `src/hooks/knowledge-store.ts`
+ * (`resolveHiveKnowledgePath`/`resolveHiveRejectedPath`/`resolveHiveEventsPath`)
+ * and `src/hooks/knowledge-events.ts` (`resolveHiveEventsPath`). Each duplication
+ * is a drift vector — the audit-event path and the store path could diverge.
+ *
+ * This module is the single source of truth for hive path resolution. Both
+ * hooks re-export from here so the store, the rejected log, and the audit-event
+ * log always share one directory.
+ *
+ * Subprocess contract (AGENTS.md invariant 3): this module performs NO
+ * subprocess calls and holds NO module-level mutable state (invariant 8). It
+ * reads `process.env.HOME`/`LOCALAPPDATA`/`XDG_DATA_HOME` live on each call so
+ * tests can redirect the hive directory via `process.env.HOME` without a cache.
+ *
+ * It is NOT imported on the plugin-init path (invariant 1); hive writes happen
+ * only on the `/swarm promote`/close/curate/postmortem lazy paths, never on
+ * `server()` resolution.
+ */
+/**
+ * Resolve the platform-specific hive data directory (the directory that holds
+ * `shared-learnings.jsonl`, `shared-learnings-rejected.jsonl`, and
+ * `shared-knowledge-events.jsonl`). Reads `process.env.HOME` live each call —
+ * Bun caches `os.homedir()`, so changing `$HOME` after the first cached call
+ * is only observed by reading the env var first.
+ */
+export declare function resolveHiveDataDir(): string;
+/** Path to the hive knowledge store (`shared-learnings.jsonl`). */
+export declare function resolveHiveKnowledgePath(): string;
+/** Path to the hive rejected-lessons log (`shared-learnings-rejected.jsonl`). */
+export declare function resolveHiveRejectedPath(): string;
+/**
+ * Path to the shared, cross-project hive knowledge-events log
+ * (`shared-knowledge-events.jsonl`). Lives alongside the hive store so the
+ * store and its audit history share one scope and one directory lock.
+ */
+export declare function resolveHiveEventsPath(): string;
+/**
+ * Test-only DI seam (AGENTS.md invariant 7). Tests redirect the hive directory
+ * by overriding `resolveHiveDataDir` here rather than `mock.module`-ing each
+ * consumer, which leaks across test files in Bun's shared runner.
+ */
+export declare const _internals: {
+    resolveHiveDataDir: typeof resolveHiveDataDir;
+    resolveHiveKnowledgePath: typeof resolveHiveKnowledgePath;
+    resolveHiveRejectedPath: typeof resolveHiveRejectedPath;
+    resolveHiveEventsPath: typeof resolveHiveEventsPath;
+};

package/dist/services/knowledge-diagnostics.d.ts

@@ -73,6 +73,24 @@ export interface KnowledgeDebugMeta {
          */
         local_orphaned: boolean;
     };
+    /**
+     * Hive promotion health (issue #1847). Surfaces lineage presence and any
+     * manual-override promotions so an operator can audit forced entries.
+     */
+    hive: {
+        /** Hive entries carrying a #1847 lineage block. */
+        entries_with_lineage: number;
+        /** Hive entries promoted via an audited --force override (AC9 visibility). */
+        override_promotions: number;
+        /** Up to 20 most-recent override entries (id, failed gates, reason). */
+        override_entries: Array<{
+            id: string;
+            lesson_excerpt: string;
+            override_failed_gates?: string[];
+            reason?: string;
+            promotion_event_id?: string;
+        }>;
+    };
 }
 /**
  * Compute the debug-metadata block for the knowledge system. Best-effort: never

package/package.json

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