opencode-swarm 7.153.2 → 7.154.0

package/dist/observability/catalog.d.ts

@@ -1,7 +1,7 @@
 /**
  * The event catalog (issue #2029).
  *
- * Exactly 50 entries, matching the `TelemetryEvent` union at
+ * Exactly 51 entries, matching the `TelemetryEvent` union at
  * `src/telemetry.ts:15-131`. 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
@@ -20,7 +20,10 @@
  * `shell_audit_health` storage audit for the issue-#2040
  * `.swarm/session/shell-audit.jsonl` security-audit store, and the 50th is
  * the bounded `trajectory_health` storage audit for the issue-#2041
- * `.swarm/trajectories/` PRM session store. These late additions are instances
+ * `.swarm/trajectories/` PRM session store, and the 51st is the bounded
+ * `pr_subscription_health` storage audit for the issue-#2042
+ * `.swarm/pr-monitor/` PR-monitor subscription checkpoint store. These late
+ * additions are instances
  * of the defect class this contract exists to close: an event kind entering
  * the stream with no registration.
  *
@@ -75,7 +78,7 @@ export interface CatalogEntry {
     /**
      * Whether an event of this kind must carry `trace.parentSpanId`.
      *
-     * `false` for all 50 entries today, and that is a truthful statement about
+     * `false` for all 51 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' | 'skill_usage_health' | 'core_events_health' | 'shell_audit_health' | 'trajectory_health';
+ | 'prm_hard_stop_delivered' | 'agent_conflict_detected' | 'close_archive_result' | 'knowledge_receipt_transition' | 'knowledge_maintenance' | 'residue_health' | 'context_telemetry_health' | 'skill_usage_health' | 'core_events_health' | 'shell_audit_health' | 'trajectory_health' | 'pr_subscription_health';
 /** Stable classification for how a reviewer-gate decision was established. */
 export type ReviewerGateEvidenceKind = 'genuine' | 'fallback' | 'data_quality' | 'block';
 /**
@@ -355,6 +355,26 @@ export declare const telemetry: {
         bytes: number;
         limit_bytes: number;
     }): void;
+    /**
+     * PR-monitor subscription store health (issue #2042): emitted on terminal
+     * compaction, legacy migration completion, legacy archive, and
+     * foreign/corrupt checkpoint recovery for the bounded `.swarm/pr-monitor/`
+     * checkpoint store. Counts ONLY — no correlationIds, no filesystem paths,
+     * no repo identities — matching the observability contract's
+     * no-content-in-metrics rule. `corrupt_count` discloses legacy lines
+     * skipped by the bounded fold; `dropped_audit_count` discloses audit-tail
+     * transitions dropped by the high/low-water rewrite.
+     */
+    prSubscriptionHealth(data: {
+        trigger: "compact" | "migrate-complete" | "archive" | "foreign-rebind" | "corrupt-quarantine";
+        active_count: number;
+        terminal_count: number;
+        compactions: number;
+        corrupt_count: number;
+        dropped_audit_count: number;
+        checkpoint_bytes: number;
+        limit_bytes: number;
+    }): 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.153.2",
+	"version": "7.154.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",

package/dist/cli/index-meg33yyv.js

@@ -1,247 +0,0 @@
-// @bun
-import {
-  validateSwarmPath
-} from "./index-4cgee5vh.js";
-import {
-  withEvidenceLock
-} from "./index-891g7hbf.js";
-import {
-  exports_external,
-  init_zod
-} from "./index-bpmtbmy9.js";
-import {
-  log
-} from "./index-zgwm4ryv.js";
-
-// src/background/pr-subscriptions.ts
-init_zod();
-import * as fs from "fs";
-import * as path from "path";
-var PR_SUBSCRIPTIONS_FILE = "pr-monitor/subscriptions.jsonl";
-var STORE_LOCK_AGENT = "pr-monitor";
-var STORE_LOCK_TASK = "pr-subscriptions";
-var onSubscriptionCreated = null;
-function setOnSubscriptionCreated(callback) {
-  onSubscriptionCreated = callback;
-}
-var RecordSchema = exports_external.object({
-  correlationId: exports_external.string().min(1),
-  sessionID: exports_external.string().min(1),
-  prNumber: exports_external.number().int().positive(),
-  repoFullName: exports_external.string().regex(/^[^/]+\/[^/]+$/, "Must be owner/repo format"),
-  prUrl: exports_external.string().min(1).regex(/^https:\/\/github\.com\/[^/]+\/[^/]+\/pull\/\d+$/, "Must be a valid GitHub PR URL"),
-  headRefOid: exports_external.string().optional(),
-  lastCheckedAt: exports_external.number(),
-  lastCommentId: exports_external.string().optional(),
-  lastCheckRunSet: exports_external.string().optional(),
-  mergeableState: exports_external.string().optional(),
-  mergeGroupRunStatus: exports_external.string().optional(),
-  mergeGroupRunConclusion: exports_external.string().optional(),
-  mergeGroupRunHtmlUrl: exports_external.string().optional(),
-  isWatching: exports_external.boolean(),
-  hasUnaddressedEvents: exports_external.boolean(),
-  status: exports_external.enum(["active", "removed", "expired"]),
-  createdAt: exports_external.number(),
-  updatedAt: exports_external.number(),
-  errorCount: exports_external.number().int().min(0),
-  customPollIntervalSeconds: exports_external.number().int().positive().optional(),
-  customFailureThreshold: exports_external.number().int().min(0).optional(),
-  customCooldownSeconds: exports_external.number().int().min(0).optional()
-}).strict();
-function storePath(directory) {
-  return validateSwarmPath(directory, PR_SUBSCRIPTIONS_FILE);
-}
-function ensureSwarmDir(directory) {
-  fs.mkdirSync(path.resolve(directory, ".swarm", "pr-monitor"), {
-    recursive: true
-  });
-}
-function buildCorrelationId(sessionID, repoFullName, prNumber) {
-  return `${sessionID}::${repoFullName}::${prNumber}`;
-}
-function readAllRecords(directory) {
-  let raw;
-  try {
-    raw = fs.readFileSync(storePath(directory), "utf-8");
-  } catch (err) {
-    if (err.code === "ENOENT")
-      return [];
-    log(`[pr-monitor] readAllRecords failed: ${err instanceof Error ? err.message : String(err)}`);
-    return [];
-  }
-  const folded = new Map;
-  for (const line of raw.split(`
-`)) {
-    const trimmed = line.trim();
-    if (trimmed.length === 0)
-      continue;
-    let parsedJson;
-    try {
-      parsedJson = JSON.parse(trimmed);
-    } catch {
-      continue;
-    }
-    const result = RecordSchema.safeParse(parsedJson);
-    if (!result.success)
-      continue;
-    folded.set(result.data.correlationId, result.data);
-  }
-  return [...folded.values()];
-}
-function appendRecord(directory, record) {
-  const result = RecordSchema.safeParse(record);
-  if (!result.success) {
-    throw new Error(`Invalid subscription record: ${result.error.message}`);
-  }
-  ensureSwarmDir(directory);
-  fs.appendFileSync(storePath(directory), `${JSON.stringify(record)}
-`, "utf-8");
-}
-async function subscribe(directory, input) {
-  if (!directory || directory.trim() === "") {
-    throw new Error("directory is required");
-  }
-  if (!input.sessionID || input.sessionID.trim() === "") {
-    throw new Error("sessionID is required and must be non-empty");
-  }
-  if (!input.repoFullName || input.repoFullName.trim() === "") {
-    throw new Error("repoFullName is required and must be non-empty");
-  }
-  if (!input.prUrl || input.prUrl.trim() === "") {
-    throw new Error("prUrl is required and must be non-empty");
-  }
-  if (!input.prNumber || !Number.isInteger(input.prNumber) || input.prNumber <= 0) {
-    throw new Error("prNumber is required and must be a positive integer");
-  }
-  const correlationId = buildCorrelationId(input.sessionID, input.repoFullName, input.prNumber);
-  const now = Date.now();
-  return withEvidenceLock(directory, PR_SUBSCRIPTIONS_FILE, STORE_LOCK_AGENT, STORE_LOCK_TASK, async () => {
-    const existing = readAllRecords(directory);
-    const match = existing.find((r) => r.correlationId === correlationId && r.status === "active");
-    if (match) {
-      onSubscriptionCreated?.(directory, match);
-      return match;
-    }
-    if (input.maxSubscriptions !== undefined && input.maxSubscriptions > 0) {
-      const activeCount = existing.filter((r) => r.status === "active").length;
-      if (activeCount >= input.maxSubscriptions) {
-        throw new Error(`PR subscription limit reached: ${activeCount}/${input.maxSubscriptions}`);
-      }
-    }
-    const record = {
-      correlationId,
-      sessionID: input.sessionID,
-      prNumber: input.prNumber,
-      repoFullName: input.repoFullName,
-      prUrl: input.prUrl,
-      lastCheckedAt: now,
-      isWatching: true,
-      hasUnaddressedEvents: false,
-      status: "active",
-      createdAt: now,
-      updatedAt: now,
-      errorCount: 0
-    };
-    appendRecord(directory, record);
-    onSubscriptionCreated?.(directory, record);
-    return record;
-  });
-}
-async function unsubscribe(directory, correlationId) {
-  if (!correlationId)
-    return null;
-  return withEvidenceLock(directory, PR_SUBSCRIPTIONS_FILE, STORE_LOCK_AGENT, STORE_LOCK_TASK, async () => {
-    const existing = readAllRecords(directory);
-    const match = existing.find((r) => r.correlationId === correlationId && r.status === "active");
-    if (!match)
-      return null;
-    const now = Date.now();
-    const removed = {
-      ...match,
-      status: "removed",
-      isWatching: false,
-      updatedAt: now
-    };
-    appendRecord(directory, removed);
-    return removed;
-  });
-}
-async function listActive(directory) {
-  return readAllRecords(directory).filter((r) => r.status === "active");
-}
-async function lookupByPr(directory, repoFullName, prNumber) {
-  for (const record of readAllRecords(directory)) {
-    if (record.status === "active" && record.repoFullName === repoFullName && record.prNumber === prNumber) {
-      return record;
-    }
-  }
-  return null;
-}
-async function updateSnapshot(directory, correlationId, updates) {
-  if (!correlationId)
-    return null;
-  return withEvidenceLock(directory, PR_SUBSCRIPTIONS_FILE, STORE_LOCK_AGENT, STORE_LOCK_TASK, async () => {
-    const existing = readAllRecords(directory);
-    const match = existing.find((r) => r.correlationId === correlationId && r.status === "active");
-    if (!match)
-      return null;
-    const updated = {
-      ...match,
-      ...updates,
-      correlationId,
-      sessionID: match.sessionID,
-      repoFullName: match.repoFullName,
-      prNumber: match.prNumber,
-      prUrl: match.prUrl,
-      createdAt: match.createdAt,
-      updatedAt: Date.now()
-    };
-    appendRecord(directory, updated);
-    return updated;
-  });
-}
-async function sweepStale(directory, ttlDays, mergedPrs) {
-  if (!ttlDays || ttlDays <= 0)
-    return 0;
-  const ttlMs = ttlDays * 86400000;
-  const now = Date.now();
-  try {
-    return await withEvidenceLock(directory, PR_SUBSCRIPTIONS_FILE, STORE_LOCK_AGENT, STORE_LOCK_TASK, async () => {
-      let swept = 0;
-      for (const record of readAllRecords(directory)) {
-        if (record.status !== "active")
-          continue;
-        const prKey = `${record.repoFullName}::${record.prNumber}`;
-        const isMerged = mergedPrs?.has(prKey) ?? false;
-        const isStale = now - record.updatedAt > ttlMs;
-        if (isMerged) {
-          appendRecord(directory, {
-            ...record,
-            status: "expired",
-            isWatching: false,
-            updatedAt: now
-          });
-          swept += 1;
-          log(`[pr-monitor] Swept subscription: merged/closed: ${prKey}`);
-          continue;
-        }
-        if (isStale && !record.hasUnaddressedEvents) {
-          appendRecord(directory, {
-            ...record,
-            status: "expired",
-            isWatching: false,
-            updatedAt: now
-          });
-          swept += 1;
-          log(`[pr-monitor] Swept subscription: stale (TTL ${ttlDays}d): ${prKey}`);
-        }
-      }
-      return swept;
-    });
-  } catch (err) {
-    log(`[pr-monitor] sweepStale failed: ${err instanceof Error ? err.message : String(err)}`);
-    return 0;
-  }
-}
-
-export { PR_SUBSCRIPTIONS_FILE, setOnSubscriptionCreated, buildCorrelationId, subscribe, unsubscribe, listActive, lookupByPr, updateSnapshot, sweepStale };