opencode-swarm 7.148.0 → 7.148.1

package/dist/observability/catalog.d.ts

@@ -1,7 +1,7 @@
 /**
  * The event catalog (issue #2029).
  *
- * Exactly 46 entries, matching the `TelemetryEvent` union at
+ * Exactly 47 entries, matching the `TelemetryEvent` union at
  * `src/telemetry.ts:15-109`. Thirty-eight predate the #2029 contract; the 39th is
  * `agent_conflict_detected` (previously emitted through a force-cast past the
  * type system), the 40th is `close_archive_result` (issue #2030 — the
@@ -10,9 +10,11 @@
  * The 42nd is the human-only `knowledge_maintenance` quarantine audit
  * (issue #2033), the 43rd is the aggregate `context_pruned` transcript
  * mutation audit, the 44th is the bounded `residue_health` atomic-write
- * residue audit (issue #2035), and the 46th is the bounded
+ * residue audit (issue #2035), the 46th is the bounded
  * `context_telemetry_health` storage audit for the issue-#2037
- * `.swarm/context-telemetry.jsonl` store. These late additions are instances of
+ * `.swarm/context-telemetry.jsonl` store, and the 47th is the counts-only
+ * `skill_usage_health` storage audit for the issue-#2038
+ * `.swarm/skill-usage.jsonl` store and its authoritative pending sidecar. These late additions are instances of
  * the defect class this contract exists to close: an event kind entering the
  * stream with no registration.
  *
@@ -67,7 +69,7 @@ export interface CatalogEntry {
     /**
      * Whether an event of this kind must carry `trace.parentSpanId`.
      *
-     * `false` for all 46 entries today, and that is a truthful statement about
+     * `false` for all 47 entries today, and that is a truthful statement about
      * the current system rather than a placeholder: no producer supplies a
      * parent span, so `createObservation` never sets one. Setting this to `true`
      * for a kind whose producer cannot supply a parent would make every

package/dist/telemetry.d.ts

@@ -32,7 +32,7 @@ export type TelemetryEvent = 'session_started' | 'session_ended' | 'agent_activa
  * `prm_hard_stop` TRIGGER emitted by `src/prm/escalation.ts`. A trigger with
  * no matching delivery means the containment never reached the agent.
  */
- | 'prm_hard_stop_delivered' | 'agent_conflict_detected' | 'close_archive_result' | 'knowledge_receipt_transition' | 'knowledge_maintenance' | 'residue_health' | 'context_telemetry_health';
+ | 'prm_hard_stop_delivered' | 'agent_conflict_detected' | 'close_archive_result' | 'knowledge_receipt_transition' | 'knowledge_maintenance' | 'residue_health' | 'context_telemetry_health' | 'skill_usage_health';
 /** Stable classification for how a reviewer-gate decision was established. */
 export type ReviewerGateEvidenceKind = 'genuine' | 'fallback' | 'data_quality' | 'block';
 /**
@@ -257,6 +257,40 @@ export declare const telemetry: {
         bytes: number;
         limit_bytes: number;
     }): void;
+    /**
+     * Skill-usage health (issue #2038). Emitted on compaction, migration,
+     * consumption, and pressure events for skill-usage tracking. Bounded
+     * payload: accepted/compacted/dropped/corrupt/retained counts, retry and
+     * curator figures, oldest/newest timestamps, and byte figures. Counts
+     * ONLY — no skill path, no per-skill identifier, no content, matching the
+     * observability contract's no-content-in-metrics rule. The adversarial
+     * case is thousands of distinct skill IDs, so a per-skill label would be
+     * an unbounded label set.
+     */
+    skillUsageHealth(data: {
+        trigger: "compaction" | "migration" | "consumption" | "pressure";
+        accepted: number;
+        compacted: number;
+        dropped: number;
+        skills_dropped: number;
+        corrupt: number;
+        pending_retained: number;
+        uncertain_retained: number;
+        uncertain_expired: number;
+        pending_evicted: number;
+        no_source_knowledge: number;
+        no_matching_knowledge: number;
+        bump_retry: number;
+        bump_unrecoverable: number;
+        bump_applied_zero: number;
+        pressure: number;
+        curator_skipped: number;
+        bytes: number;
+        limit_bytes: number;
+        oldest_timestamp: string | null;
+        newest_timestamp: string | null;
+        coverage: boolean;
+    }): void;
     /**
      * Issue #2063 C2 — the PRM hard-stop DENIAL was actually delivered to the
      * agent (thrown by the guardrails `toolBefore` consumer). `prm_hard_stop`

package/package.json

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