opencode-swarm 7.89.0 → 7.90.1

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/index.js

@@ -69,7 +69,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "opencode-swarm",
-    version: "7.89.0",
+    version: "7.90.1",
     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",
@@ -130,6 +130,10 @@ var init_package = __esm(() => {
       ".opencode/skills/execute",
       ".opencode/skills/phase-wrap",
       ".opencode/skills/loop",
+      ".opencode/skills/writing-tests",
+      ".opencode/skills/running-tests",
+      ".opencode/skills/engineering-conventions",
+      ".opencode/skills/commit-pr",
       "tests/fixtures/memory-recall",
       "README.md",
       "LICENSE"
@@ -140,6 +144,7 @@ var init_package = __esm(() => {
       typecheck: "tsc --noEmit",
       test: "bun test",
       lint: "biome lint .",
+      "drift:check": "bun run scripts/drift-check.ts",
       format: "biome format . --write",
       check: "biome check --write .",
       dev: "bun run build && opencode",
@@ -17419,7 +17424,11 @@ var init_bundled_skills = __esm(() => {
     "critic-gate",
     "execute",
     "phase-wrap",
-    "loop"
+    "loop",
+    "writing-tests",
+    "running-tests",
+    "engineering-conventions",
+    "commit-pr"
   ];
   syncedProjectSkillTargets = new Set;
 });
@@ -18777,7 +18786,8 @@ __export(exports_telemetry, {
   initTelemetry: () => initTelemetry,
   emit: () => emit,
   addTelemetryListener: () => addTelemetryListener,
-  _internals: () => _internals5
+  _internals: () => _internals5,
+  ROTATION_CHECK_INTERVAL: () => ROTATION_CHECK_INTERVAL
 });
 import * as fs6 from "node:fs";
 import { createWriteStream } from "node:fs";
@@ -18787,6 +18797,7 @@ function resetTelemetryForTesting() {
   _disabled = false;
   _projectDirectory = null;
   _listeners.length = 0;
+  _emitCount = 0;
   if (_writeStream !== null) {
     _writeStream.end();
     _writeStream = null;
@@ -18834,6 +18845,11 @@ function emit(event, data) {
         listener(event, data);
       } catch {}
     }
+    _emitCount++;
+    if (_emitCount >= ROTATION_CHECK_INTERVAL) {
+      _emitCount = 0;
+      _internals5.rotateTelemetryIfNeeded();
+    }
   } catch {}
 }
 function addTelemetryListener(callback) {
@@ -18864,7 +18880,7 @@ function rotateTelemetryIfNeeded(maxBytes = 10 * 1024 * 1024) {
     }
   } catch {}
 }
-var _writeStream = null, _projectDirectory = null, _listeners, _disabled = false, telemetry, _internals5;
+var _writeStream = null, _projectDirectory = null, _listeners, _disabled = false, _emitCount = 0, ROTATION_CHECK_INTERVAL = 50, telemetry, _internals5;
 var init_telemetry = __esm(() => {
   _listeners = [];
   telemetry = {
@@ -18995,7 +19011,7 @@ var init_telemetry = __esm(() => {
       });
     }
   };
-  _internals5 = { telemetry, emit };
+  _internals5 = { telemetry, emit, rotateTelemetryIfNeeded };
 });
 
 // src/turbo/epic/state.ts

package/dist/telemetry.d.ts

@@ -1,5 +1,11 @@
 export type TelemetryEvent = 'session_started' | 'session_ended' | 'agent_activated' | 'delegation_begin' | 'delegation_end' | 'task_state_changed' | 'gate_passed' | 'gate_failed' | 'gate_parse_error' | 'phase_changed' | 'budget_updated' | 'model_fallback' | 'hard_limit_hit' | 'revision_limit_hit' | 'loop_detected' | 'scope_violation' | 'qa_skip_violation' | 'heartbeat' | 'turbo_mode_changed' | 'auto_oversight_escalation' | 'environment_detected' | 'evidence_lock_acquired' | 'evidence_lock_contended' | 'evidence_lock_stale_recovered' | 'plan_ledger_cas_retry' | 'plan_md_write_failed' | 'snapshot_failed' | 'prm_pattern_detected' | 'prm_course_correction_injected' | 'prm_escalation_triggered' | 'prm_hard_stop';
 export type TelemetryListener = (event: TelemetryEvent, data: Record<string, unknown>) => void;
+/**
+ * Number of emits between rotation checks. 50 keeps the overhead at one
+ * `statSync` per 50 telemetry writes (~once per few seconds in a busy
+ * session, roughly once per minute in a quiet one).
+ */
+export declare const ROTATION_CHECK_INTERVAL = 50;
 /** @internal - For testing only */
 export declare function resetTelemetryForTesting(): void;
 /**
@@ -69,4 +75,5 @@ export declare const telemetry: {
 export declare const _internals: {
     telemetry: typeof telemetry;
     emit: typeof emit;
+    rotateTelemetryIfNeeded: typeof rotateTelemetryIfNeeded;
 };

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "opencode-swarm",
-	"version": "7.89.0",
+	"version": "7.90.1",
 	"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",
@@ -61,6 +61,10 @@
 		".opencode/skills/execute",
 		".opencode/skills/phase-wrap",
 		".opencode/skills/loop",
+		".opencode/skills/writing-tests",
+		".opencode/skills/running-tests",
+		".opencode/skills/engineering-conventions",
+		".opencode/skills/commit-pr",
 		"tests/fixtures/memory-recall",
 		"README.md",
 		"LICENSE"
@@ -71,6 +75,7 @@
 		"typecheck": "tsc --noEmit",
 		"test": "bun test",
 		"lint": "biome lint .",
+		"drift:check": "bun run scripts/drift-check.ts",
 		"format": "biome format . --write",
 		"check": "biome check --write .",
 		"dev": "bun run build && opencode",