opencode-swarm 7.88.4 → 7.90.0

package/dist/cli/{index-d4hpgf63.js → index-prppjv2q.js}

@@ -12,7 +12,7 @@ import {
   detectPosixWrites,
   detectWindowsWrites,
   resolveWriteTargets
-} from "./index-hs2knbfq.js";
+} from "./index-mz2z7jtn.js";
 import {
   checkFileAuthority,
   classifyFile,

package/dist/cli/{index-5p1gvn98.js → index-q3265fxa.js}

@@ -1,7 +1,7 @@
 // @bun
 import {
   handleGuardrailExplain
-} from "./index-d4hpgf63.js";
+} from "./index-prppjv2q.js";
 import {
   handleGuardrailLog
 } from "./index-gg589mfw.js";
@@ -51,6 +51,7 @@ import {
   handleKnowledgeRetryHardeningCommand,
   handleKnowledgeUnactionableCommand,
   handleLearningCommand,
+  handleLinkCommand,
   handleMemoryCommand,
   handleMemoryExportCommand,
   handleMemoryImportCommand,
@@ -73,14 +74,15 @@ import {
   handleStatusCommand,
   handleSyncPlanCommand,
   handleTurboCommand,
+  handleUnlinkCommand,
   handleWriteRetroCommand,
   normalizeSwarmCommandInput,
   resolveCommand
-} from "./index-hs2knbfq.js";
+} from "./index-mz2z7jtn.js";
 import"./index-6tnmt41c.js";
 import"./index-bm4f0nme.js";
-import"./index-rh53rrpt.js";
-import"./index-e8pk68cc.js";
+import"./index-1ccnwh54.js";
+import"./index-axwxkbdd.js";
 import"./index-bywt2171.js";
 import {
   AGENT_TOOL_MAP,
@@ -337,6 +339,7 @@ export {
   resolveCommand,
   normalizeSwarmCommandInput,
   handleWriteRetroCommand,
+  handleUnlinkCommand,
   handleTurboCommand,
   handleSyncPlanCommand,
   handleStatusCommand,
@@ -359,6 +362,7 @@ export {
   handleMemoryImportCommand,
   handleMemoryExportCommand,
   handleMemoryCommand,
+  handleLinkCommand,
   handleLearningCommand,
   handleKnowledgeUnactionableCommand,
   handleKnowledgeRetryHardeningCommand,

package/dist/cli/index.js

@@ -7,11 +7,11 @@ import {
   getPluginLockFilePaths,
   package_default,
   resolveCommand
-} from "./index-hs2knbfq.js";
+} from "./index-mz2z7jtn.js";
 import"./index-6tnmt41c.js";
 import"./index-bm4f0nme.js";
-import"./index-rh53rrpt.js";
-import"./index-e8pk68cc.js";
+import"./index-1ccnwh54.js";
+import"./index-axwxkbdd.js";
 import"./index-bywt2171.js";
 import {
   DEFAULT_AGENT_CONFIGS

package/dist/cli/{knowledge-store-n4x6zyk7.js → knowledge-store-gsy6p46z.js}

@@ -31,7 +31,7 @@ import {
   transactFile,
   transactKnowledge,
   wordBigrams
-} from "./index-e8pk68cc.js";
+} from "./index-axwxkbdd.js";
 import"./index-fjwwrwr5.js";
 import"./index-jtqkh8jf.js";
 import"./index-bcp79s17.js";

package/dist/cli/{skill-generator-s0spm65v.js → skill-generator-1hzfyhth.js}

@@ -22,8 +22,8 @@ import {
   retireSkill,
   sanitizeSlug,
   selectCandidateEntries
-} from "./index-rh53rrpt.js";
-import"./index-e8pk68cc.js";
+} from "./index-1ccnwh54.js";
+import"./index-axwxkbdd.js";
 import"./index-fjwwrwr5.js";
 import"./index-jtqkh8jf.js";
 import"./index-zgwm4ryv.js";

package/dist/commands/index.d.ts

@@ -32,6 +32,7 @@ export { handleHandoffCommand } from './handoff';
 export { handleHistoryCommand } from './history';
 export { handleKnowledgeListCommand, handleKnowledgeMigrateCommand, handleKnowledgeQuarantineCommand, handleKnowledgeRestoreCommand, handleKnowledgeRetryHardeningCommand, handleKnowledgeUnactionableCommand, } from './knowledge';
 export { handleLearningCommand } from './learning';
+export { handleLinkCommand } from './link';
 export { handleMemoryCommand, handleMemoryExportCommand, handleMemoryImportCommand, handleMemoryMigrateCommand, handleMemoryStatusCommand, } from './memory';
 export { handlePlanCommand } from './plan';
 export { handlePreflightCommand } from './preflight';
@@ -51,6 +52,7 @@ export { handleStatusCommand } from './status';
 export { handleSyncPlanCommand } from './sync-plan';
 export { classifySwarmCommandChatFallbackUse, classifySwarmCommandToolUse, SWARM_COMMAND_TOOL_ALLOWLIST, SWARM_COMMAND_TOOL_COMMANDS, } from './tool-policy.js';
 export { handleTurboCommand } from './turbo';
+export { handleUnlinkCommand } from './unlink';
 export { handleWriteRetroCommand } from './write-retro';
 export declare function buildHelpText(): string;
 /**

package/dist/commands/link.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Handles the `/swarm link` command.
+ *
+ * Ties this worktree's swarm knowledge store to a shared "link" store so that
+ * several swarms working on the same project (typically separate git worktrees)
+ * — or on deliberately "similar" projects — pool their lessons instead of each
+ * keeping an isolated `.swarm/knowledge.jsonl`.
+ *
+ * Usage:
+ * - /swarm link                — link using the project hash (ties all worktrees
+ *                                of the same repo to one shared store).
+ * - /swarm link <name>         — link using an explicit shared name (use the same
+ *                                name in each worktree/repo to tie them together).
+ * - /swarm link status         — show the current link state for this worktree.
+ *
+ * On link, this worktree's existing local lessons are merged (deduplicated) into
+ * the shared store so nothing already learned is lost.
+ */
+export declare function handleLinkCommand(directory: string, args: string[]): Promise<string>;

package/dist/commands/registry.d.ts

@@ -609,6 +609,29 @@ export declare const COMMAND_REGISTRY: {
         readonly category: "config";
         readonly toolPolicy: "none";
     };
+    readonly link: {
+        readonly handler: (ctx: CommandContext) => Promise<string>;
+        readonly description: "Tie this worktree to a shared swarm knowledge store [name]";
+        readonly details: "Links the current worktree to a shared knowledge store so multiple swarms working on the same project (e.g. separate git worktrees) pool their lessons instead of each keeping an isolated .swarm/knowledge.jsonl. With no name, ties all worktrees of the same repo via the project hash; with a name, ties any worktrees/repos that use the same name. Existing local lessons are merged (deduped) into the shared store. Use `/swarm link status` to inspect.";
+        readonly args: "[<name> | status]";
+        readonly category: "utility";
+        readonly toolPolicy: "none";
+    };
+    readonly 'link status': {
+        readonly handler: (ctx: CommandContext) => Promise<string>;
+        readonly description: "Show whether this worktree shares knowledge via a link";
+        readonly subcommandOf: "link";
+        readonly category: "utility";
+        readonly toolPolicy: "none";
+    };
+    readonly unlink: {
+        readonly handler: (ctx: CommandContext) => Promise<string>;
+        readonly description: "Stop sharing swarm knowledge for this worktree [--no-copy]";
+        readonly details: "Unlinks the current worktree from its shared knowledge store and returns it to a local .swarm/knowledge.jsonl. By default the shared lessons are copied back into the local store (deduped) so nothing is lost; pass --no-copy to skip the copy-back.";
+        readonly args: "[--no-copy]";
+        readonly category: "utility";
+        readonly toolPolicy: "none";
+    };
     readonly promote: {
         readonly handler: (ctx: CommandContext) => Promise<string>;
         readonly description: "Manually promote lesson to hive knowledge";

package/dist/commands/unlink.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Handles the `/swarm unlink` command.
+ *
+ * Stops sharing this worktree's swarm knowledge with its link store and returns
+ * it to a local `.swarm/knowledge.jsonl`. By default the shared lessons are
+ * copied back into the local store (deduplicated) so the worktree keeps the
+ * pooled knowledge it had access to; pass `--no-copy` to skip the copy-back.
+ *
+ * Usage:
+ * - /swarm unlink              — unlink and copy shared lessons back to local.
+ * - /swarm unlink --no-copy    — unlink without copying shared lessons back.
+ */
+export declare function handleUnlinkCommand(directory: string, args: string[]): Promise<string>;

package/dist/config/bundled-skills.d.ts

@@ -1,4 +1,4 @@
-export declare const BUNDLED_PROJECT_SKILLS: readonly ["brainstorm", "specify", "clarify-spec", "resume", "clarify", "discover", "consult", "pre-phase-briefing", "council", "deep-dive", "deep-research", "codebase-review-swarm", "design-docs", "swarm-pr-review", "swarm-pr-feedback", "issue-ingest", "plan", "critic-gate", "execute", "phase-wrap", "loop"];
+export declare const BUNDLED_PROJECT_SKILLS: readonly ["brainstorm", "specify", "clarify-spec", "resume", "clarify", "discover", "consult", "pre-phase-briefing", "council", "deep-dive", "deep-research", "codebase-review-swarm", "design-docs", "swarm-pr-review", "swarm-pr-feedback", "issue-ingest", "plan", "critic-gate", "execute", "phase-wrap", "loop", "writing-tests", "running-tests", "engineering-conventions", "commit-pr"];
 interface CopyState {
     files: number;
     bytes: number;

package/dist/config/skill-mirrors.d.ts

@@ -0,0 +1,87 @@
+/**
+ * Single source of truth for skill mirror contracts between the OpenCode-side
+ * (`.opencode/skills/`) and Claude-side (`.claude/skills/`) skill trees, plus
+ * Codex/GitHub adapter shims (`.agents/skills/`, `.github/skills/`).
+ *
+ * Consumed by:
+ *  - tests/unit/skills/skill-mirrors.test.ts (architect MODE mirror regression)
+ *  - scripts/drift-check.ts (issue #1497 CI drift detector)
+ *
+ * Keeping the lists here — rather than inline in the test — means the drift
+ * checker and the regression test cannot themselves drift apart.
+ */
+/**
+ * Architect MODE skills whose `.opencode` and `.claude` mirrors must be
+ * byte-identical. `.opencode` is the operative protocol loaded by
+ * `src/agents/architect.ts` MODE stubs; the `.claude` mirror must match so
+ * Claude Code and OpenCode sessions cannot diverge silently. Tuple shape is
+ * `[slug, opencodePath, claudePath]`.
+ */
+export declare const MIRRORED_ARCHITECT_MODE_SKILLS: readonly [readonly ["brainstorm", ".opencode/skills/brainstorm/SKILL.md", ".claude/skills/brainstorm/SKILL.md"], readonly ["specify", ".opencode/skills/specify/SKILL.md", ".claude/skills/specify/SKILL.md"], readonly ["clarify-spec", ".opencode/skills/clarify-spec/SKILL.md", ".claude/skills/clarify-spec/SKILL.md"], readonly ["resume", ".opencode/skills/resume/SKILL.md", ".claude/skills/resume/SKILL.md"], readonly ["clarify", ".opencode/skills/clarify/SKILL.md", ".claude/skills/clarify/SKILL.md"], readonly ["discover", ".opencode/skills/discover/SKILL.md", ".claude/skills/discover/SKILL.md"], readonly ["consult", ".opencode/skills/consult/SKILL.md", ".claude/skills/consult/SKILL.md"], readonly ["pre-phase-briefing", ".opencode/skills/pre-phase-briefing/SKILL.md", ".claude/skills/pre-phase-briefing/SKILL.md"], readonly ["council", ".opencode/skills/council/SKILL.md", ".claude/skills/council/SKILL.md"], readonly ["deep-dive", ".opencode/skills/deep-dive/SKILL.md", ".claude/skills/deep-dive/SKILL.md"], readonly ["deep-research", ".opencode/skills/deep-research/SKILL.md", ".claude/skills/deep-research/SKILL.md"], readonly ["issue-ingest", ".opencode/skills/issue-ingest/SKILL.md", ".claude/skills/issue-ingest/SKILL.md"], readonly ["plan", ".opencode/skills/plan/SKILL.md", ".claude/skills/plan/SKILL.md"], readonly ["critic-gate", ".opencode/skills/critic-gate/SKILL.md", ".claude/skills/critic-gate/SKILL.md"], readonly ["execute", ".opencode/skills/execute/SKILL.md", ".claude/skills/execute/SKILL.md"], readonly ["phase-wrap", ".opencode/skills/phase-wrap/SKILL.md", ".claude/skills/phase-wrap/SKILL.md"], readonly ["design-docs", ".opencode/skills/design-docs/SKILL.md", ".claude/skills/design-docs/SKILL.md"]];
+/**
+ * Architect MODE skills where `.opencode` is the full operative protocol and
+ * `.claude` is an intentionally different surface. Both must exist; byte
+ * identity is not required, but the divergence is documented here.
+ */
+export declare const DIVERGENT_ARCHITECT_MODE_SKILLS: Array<{
+    slug: string;
+    opencodePath: string;
+    claudePath: string;
+    reason: string;
+}>;
+/**
+ * Architect MODE skills whose `.opencode` SKILL.md is canonical and whose
+ * `.claude`/`.agents` surfaces are thin adapter shims that delegate back to the
+ * canonical `.opencode` skill.
+ *
+ * `expectedCanonicalRef` is the relative path that each adapter SKILL.md must
+ * contain as a reference back to the canonical `.opencode` skill. All adapter
+ * shims live exactly three directory levels deep (`.{runtime}/skills/{slug}/`),
+ * so `../../../` always resolves to the repo root from any adapter path. If
+ * the directory structure changes (e.g., skills are reorganised to a flat
+ * layout), update `expectedCanonicalRef` entries accordingly.
+ */
+export declare const ADAPTER_ARCHITECT_MODE_SKILLS: Array<{
+    slug: string;
+    canonicalPath: string;
+    adapterPaths: string[];
+    expectedCanonicalRef: string;
+}>;
+/**
+ * Architect MODE skills whose `.opencode` protocol is intentionally NOT mirrored
+ * to `.claude` (e.g. a `.claude` mirror would shadow a Claude Code built-in
+ * skill of the same name, or the mode is only reachable through the OpenCode
+ * plugin runtime).
+ */
+export declare const OPENCODE_ONLY_ARCHITECT_MODE_SKILLS: Array<{
+    slug: string;
+    opencodePath: string;
+    reason: string;
+}>;
+/**
+ * Skill mirror contracts for skill pairs that are NOT architect MODE skills but
+ * still exist across the `.opencode`/`.claude` trees. The drift checker
+ * (scripts/drift-check.ts) classifies every cross-tree skill pair; without an
+ * entry here a both-tree pair is reported as "unclassified" so a human decides
+ * its contract. See issue #1497.
+ *
+ * `kind`:
+ *  - `identical`: `.opencode` and `.claude` SKILL.md must be byte-identical.
+ *    `canonical` records which side wins when they drift (fix direction only;
+ *    detection is symmetric).
+ *  - `divergent`: both must exist; content intentionally differs per runtime.
+ *  - `opencode-only`: `.opencode` exists; no `.claude` mirror expected.
+ */
+export declare const ADDITIONAL_SKILL_MIRROR_CONTRACTS: Array<{
+    slug: string;
+    kind: 'identical' | 'divergent' | 'opencode-only';
+    canonical?: '.claude' | '.opencode';
+    reason: string;
+}>;
+/**
+ * Top-level entries under `.opencode/skills/` that are not bundled skills and
+ * must be ignored by the drift checker. `generated/` holds user-generated
+ * skills produced at runtime (src/services/skill-generator.ts) and has no
+ * direct SKILL.md.
+ */
+export declare const NON_SKILL_OPENCODE_DIRS: Set<string>;

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 {