opencode-swarm 7.88.3 → 7.89.0

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

@@ -146,12 +146,12 @@ export type KnowledgeEventInput = KnowledgeEvent extends infer T ? T extends Kno
 } : never : never;
 /** Receipt event verbs that reference a single knowledge_id. */
 export declare const RECEIPT_EVENT_TYPES: ReadonlySet<string>;
-/** Returns `.swarm/knowledge-events.jsonl` for the given project directory. */
+/** Returns the knowledge-events.jsonl path (link-aware via resolveKnowledgeStoreDir). */
 export declare function resolveKnowledgeEventsPath(directory: string): string;
-/** Returns `.swarm/knowledge-counter-baseline.json` for folded event counters. */
+/** Returns the knowledge-counter-baseline.json path (link-aware). */
 export declare function resolveKnowledgeCounterBaselinePath(directory: string): string;
 export declare function resolveHiveEventsPath(): string;
-/** Returns `.swarm/knowledge-application.jsonl` for legacy v2 audit records. */
+/** Returns the knowledge-application.jsonl path for legacy v2 audit records (link-aware). */
 export declare function resolveLegacyApplicationLogPath(directory: string): string;
 /** Generate a fresh trace id. One per retrieval; receipts reference it. */
 export declare function newTraceId(): string;

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

@@ -0,0 +1,82 @@
+/**
+ * Knowledge "link" resolution for the opencode-swarm knowledge system.
+ *
+ * Problem: the swarm knowledge tier is rooted at `<directory>/.swarm/`, where
+ * `directory` is `ctx.directory`. When several swarms run in separate git
+ * worktrees of the same repository, each worktree has its own `.swarm/` and
+ * therefore its own isolated knowledge store — lessons one swarm learns are
+ * invisible to the others. The hive tier is the opposite extreme: global to
+ * EVERY project on the machine.
+ *
+ * A "link" ties multiple worktrees (or several deliberately "similar" repos)
+ * to one shared knowledge store that sits between the per-worktree swarm tier
+ * and the global hive tier. Membership is declared by an opt-in pointer file at
+ * `<directory>/.swarm/link.json`. When that pointer is active, the swarm
+ * knowledge *family* (store, events, rejected, retractions, counters,
+ * quarantine, unactionable) redirects from `<directory>/.swarm` to a shared
+ * link directory in the platform data dir — co-located with the hive store.
+ *
+ * Intentionally NOT redirected (stays per-worktree): `.knowledge-shown.json`
+ * (phase-keyed, session-local outcome bookkeeping), `plan.json`, evidence, and
+ * session state. Only id-keyed / append-only knowledge data is pooled.
+ *
+ * This module is self-contained (node builtins + the atomic-write helper only)
+ * so it can be imported by knowledge-store.ts, knowledge-events.ts, and
+ * knowledge-validator.ts without coupling to the heavily test-mocked store
+ * module and without import cycles.
+ */
+/** On-disk pointer at `<directory>/.swarm/link.json`. */
+export interface LinkPointer {
+    version: 1;
+    /** Path-safe identifier of the shared store (projectHash or sanitized name). */
+    linkId: string;
+    /** Human-friendly name when the link was created from an explicit name. */
+    name?: string;
+    /** ISO 8601 creation timestamp. */
+    createdAt: string;
+    /** How the link was established. */
+    source: 'manual' | 'auto';
+}
+export declare const LINK_POINTER_FILENAME = "link.json";
+/** Root directory under which all shared link stores live: `<dataDir>/links`. */
+export declare function resolveLinkBaseDir(): string;
+/** Directory of the shared knowledge family for a given link id. */
+export declare function resolveLinkDir(linkId: string): string;
+/**
+ * Coerce an arbitrary user-supplied name into a single, path-safe directory
+ * segment. Returns null when nothing usable remains (caller falls back to the
+ * project hash). Lowercased for case-insensitive stability across worktrees.
+ */
+export declare function sanitizeLinkId(name: string): string | null;
+/** Read and validate the link pointer for a worktree. Null if absent/invalid. */
+export declare function readLinkPointer(directory: string): LinkPointer | null;
+/** Write the link pointer atomically and invalidate the resolution cache. */
+export declare function writeLinkPointer(directory: string, pointer: LinkPointer): Promise<void>;
+/** Remove the link pointer (idempotent) and invalidate the resolution cache. */
+export declare function removeLinkPointer(directory: string): Promise<void>;
+/**
+ * Resolve the directory that holds the swarm knowledge family for `directory`.
+ *
+ * Returns the shared link directory when an active pointer is present, otherwise
+ * the local `<directory>/.swarm`. Fail-open: any read/parse error degrades to the
+ * local directory, so a corrupt pointer never strands knowledge. Synchronous and
+ * cached so the hot retrieval path pays at most one tiny file read per TTL window.
+ *
+ * NOTE: when unlinked, the return value is byte-identical to the legacy
+ * `path.join(directory, '.swarm')`, so existing callers/tests are unaffected.
+ */
+export declare function resolveKnowledgeStoreDir(directory: string): string;
+/** Drop cached resolution(s). Pass a directory to invalidate one, omit for all. */
+export declare function invalidateKnowledgeStoreDirCache(directory?: string): void;
+/** True when the worktree currently redirects to a shared link store. */
+export declare function isLinked(directory: string): boolean;
+export declare const _internals: {
+    resolveKnowledgeStoreDir: typeof resolveKnowledgeStoreDir;
+    readLinkPointer: typeof readLinkPointer;
+    writeLinkPointer: typeof writeLinkPointer;
+    removeLinkPointer: typeof removeLinkPointer;
+    invalidateKnowledgeStoreDirCache: typeof invalidateKnowledgeStoreDirCache;
+    resolveLinkDir: typeof resolveLinkDir;
+    resolveLinkBaseDir: typeof resolveLinkBaseDir;
+    sanitizeLinkId: typeof sanitizeLinkId;
+};

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

@@ -68,7 +68,7 @@ export interface ActionabilityResult {
  * quarantined rather than activated.
  */
 export declare function validateActionability(entry: Pick<KnowledgeEntryBase, 'forbidden_actions' | 'required_actions' | 'verification_checks' | 'verification_predicate' | 'applies_to_tools' | 'applies_to_agents'>): ActionabilityResult;
-/** Returns `.swarm/knowledge-unactionable.jsonl` for the given directory. */
+/** Returns the knowledge-unactionable.jsonl path for the given directory (link-aware). */
 export declare function resolveUnactionablePath(directory: string): string;
 /** One quarantined-unactionable record. */
 export interface UnactionableRecord extends KnowledgeEntryBase {