opencode-swarm 7.146.2 → 7.146.4

package/dist/observability/catalog.d.ts

@@ -1,16 +1,18 @@
 /**
  * The event catalog (issue #2029).
  *
- * Exactly 45 entries, matching the `TelemetryEvent` union at
- * `src/telemetry.ts:15-92`. Thirty-eight predate the #2029 contract; the 39th is
+ * Exactly 46 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
  * structured close/archive result event), the 41st is the bounded diagnostic
  * projection of authoritative knowledge-receipt transitions (issue #2031).
  * The 42nd is the human-only `knowledge_maintenance` quarantine audit
  * (issue #2033), the 43rd is the aggregate `context_pruned` transcript
- * mutation audit, and the 44th is the bounded `residue_health` atomic-write
- * residue audit (issue #2035). These late additions are instances of
+ * mutation audit, the 44th is the bounded `residue_health` atomic-write
+ * residue audit (issue #2035), and 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
  * the defect class this contract exists to close: an event kind entering the
  * stream with no registration.
  *
@@ -65,7 +67,7 @@ export interface CatalogEntry {
     /**
      * Whether an event of this kind must carry `trace.parentSpanId`.
      *
-     * `false` for all 45 entries today, and that is a truthful statement about
+     * `false` for all 46 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';
+ | 'prm_hard_stop_delivered' | 'agent_conflict_detected' | 'close_archive_result' | 'knowledge_receipt_transition' | 'knowledge_maintenance' | 'residue_health' | 'context_telemetry_health';
 /** Stable classification for how a reviewer-gate decision was established. */
 export type ReviewerGateEvidenceKind = 'genuine' | 'fallback' | 'data_quality' | 'block';
 /**
@@ -236,6 +236,27 @@ export declare const telemetry: {
         oldest_age_ms: number;
         grammar_counts: Record<string, number>;
     }): void;
+    /**
+     * Context-map telemetry storage health (issue #2037). Emitted after a
+     * compaction or close cut for the bounded `.swarm/context-telemetry.jsonl`
+     * store. Bounded payload: accepted/compacted/retained/dropped/corrupt
+     * counts, oldest/newest timestamps, and byte figures. Counts ONLY — no
+     * capsule/query content and no filesystem paths, matching the observability
+     * contract's no-content-in-metrics rule. Enables PR 16 to alarm and PR 20 to
+     * report without leaking workspace layout or capsule contents.
+     */
+    contextTelemetryHealth(data: {
+        trigger: "compaction" | "close";
+        accepted_count: number;
+        compacted_count: number;
+        retained_count: number;
+        dropped_count: number;
+        corrupt_count: number;
+        oldest_timestamp: string | null;
+        newest_timestamp: string | null;
+        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/dist/tools/dispatch-lanes.d.ts

@@ -1,8 +1,8 @@
 import { z } from 'zod';
-import { type BackgroundDelegationRecord, type BackgroundDelegationWorkflowLaneRecovery } from '../background/pending-delegations.js';
+import { type BackgroundDelegationRecord, type BackgroundDelegationResult, type BackgroundDelegationWorkflowLaneRecovery } from '../background/pending-delegations.js';
 import { resolveExactMergeBaseAsync, resolvePrWorkflowRevisionDigestAsync } from '../background/workspace-snapshot.js';
 import { loadPluginConfig } from '../config/loader.js';
-import { type PrReviewDepthTier, validatePrWorkflowTransportRecovery } from '../hooks/pr-workflow-gate.js';
+import { type PrReviewDepthTier, type PrReviewVerdictCollectionReceipt, validatePrWorkflowTransportRecovery } from '../hooks/pr-workflow-gate.js';
 import { buildLaneOrientationBlock } from '../hooks/repo-graph-injection.js';
 import { createParallelDispatcher } from '../parallel/dispatcher/parallel-dispatcher.js';
 import { createSwarmTool } from './create-tool.js';
@@ -138,6 +138,8 @@ export interface DispatchLaneResult {
         kind: BackgroundDelegationWorkflowLaneRecovery['kind'];
         reason: string;
     }>;
+    accepted_review_item_ids?: string[];
+    rejected_review_item_ids?: string[];
     /**
      * Set to true when this lane's `output` preview was withheld because an
      * identical preview (same batch, lane, and result digest) was already
@@ -411,6 +413,11 @@ export declare const _test_exports: {
      */
     resetDeliveredLaneOutputs: () => void;
     recordToLaneResult: typeof recordToLaneResult;
+    appendPrReviewCollectionReceipt: typeof appendPrReviewCollectionReceipt;
+    parsePrReviewCollectionReceipt: typeof parsePrReviewCollectionReceipt;
+    resolvePrReviewReceiptFallbacks: typeof resolvePrReviewReceiptFallbacks;
+    resolvePrReviewReceiptFallbacksFromState: typeof resolvePrReviewReceiptFallbacksFromState;
+    consumePrReviewReceiptAppendFailureLog: typeof consumePrReviewReceiptAppendFailureLog;
     prReviewLaneResponseBudgetChars: typeof prReviewLaneResponseBudgetChars;
 };
 type ReadOnlyToolPermissions = Record<string, false> & {
@@ -426,6 +433,7 @@ export declare function executeDispatchLanes(args: unknown, directory: string, c
 export declare function executeDispatchLanesAsync(args: unknown, directory: string, context?: DispatchLanesExecutionContext): Promise<DispatchLanesAsyncResult>;
 export declare function executeCollectLaneResults(args: unknown, directory: string, context?: Pick<DispatchLanesExecutionContext, 'sessionID'>): Promise<CollectLaneResultsResult>;
 declare function isRetryableSessionCreateFailure(error: unknown): boolean;
+declare function consumePrReviewReceiptAppendFailureLog(loggedFailures: Set<string>, parentSessionId: string, correlationId: string): boolean;
 declare function extractAssistantTranscript(messages: Array<{
     info?: {
         role?: string;
@@ -452,14 +460,28 @@ declare function reserveCollectionLaneCallBudgets(deadline: number, remainingLan
     revisionDigestBudgetMs: number;
 };
 declare function nextCollectPollInterval(currentMs: number): number;
-declare function buildCollectResult(batchId: string, records: BackgroundDelegationRecord[], includePending: boolean, deliveryContext?: {
+declare function buildCollectResult(batchId: string, records: BackgroundDelegationRecord[], includePending: boolean, deliveryContext?: LaneResultDeliveryContext): CollectLaneResultsResult;
+interface LaneResultDeliveryContext {
     directory?: string;
     sessionID?: string;
-}): CollectLaneResultsResult;
-declare function recordToLaneResult(record: BackgroundDelegationRecord, batchId: string, deliveryContext?: {
-    directory?: string;
-    sessionID?: string;
-}): DispatchLaneResult;
+    reviewReceipts?: ReadonlyMap<string, PrReviewVerdictCollectionReceipt>;
+}
+declare function resolvePrReviewReceiptFallbacks(directory: string, sessionID: string | undefined, records: readonly BackgroundDelegationRecord[]): Promise<ReadonlyMap<string, PrReviewVerdictCollectionReceipt>>;
+interface PrReviewReceiptFallbackState {
+    prReviewValidationBatches?: Array<{
+        batchId: string;
+        phase: string;
+        lanes: Array<{
+            laneId: string;
+            workflowLane: string;
+            reviewItemIds?: string[];
+        }>;
+    }>;
+}
+declare function resolvePrReviewReceiptFallbacksFromState(records: readonly BackgroundDelegationRecord[], state: PrReviewReceiptFallbackState): ReadonlyMap<string, PrReviewVerdictCollectionReceipt>;
+declare function appendPrReviewCollectionReceipt(record: BackgroundDelegationRecord, result: BackgroundDelegationResult, receipt: PrReviewVerdictCollectionReceipt): BackgroundDelegationResult | null;
+declare function parsePrReviewCollectionReceipt(record: BackgroundDelegationRecord): PrReviewVerdictCollectionReceipt | null;
+declare function recordToLaneResult(record: BackgroundDelegationRecord, batchId: string, deliveryContext?: LaneResultDeliveryContext): DispatchLaneResult;
 declare function buildReadOnlyTools(): ReadOnlyToolPermissions;
 type ApplyCommonPromptResult = {
     ok: true;

package/dist/tools/phase-complete/gates/types.d.ts

@@ -50,4 +50,11 @@ export interface GateContext {
     autoReviewBlocked?: boolean;
     /** Machine-readable reason from the current review run, when blocked. */
     autoReviewBlockReason?: import('../../../review/engine').ReviewEngineResult['blockReason'];
+    /**
+     * Single clock captured once for the whole aggregate phase preflight
+     * (issue #2102 contract D). All freshness-sensitive gates must evaluate
+     * against this timestamp instead of calling Date.now()/new Date() so
+     * their verdicts stay mutually consistent across an age boundary.
+     */
+    preflightNowMs: number;
 }

package/dist/tools/write-final-council-evidence.d.ts

@@ -7,13 +7,7 @@ export declare const ArgsSchema: z.ZodObject<{
     projectSummary: z.ZodString;
     roundNumber: z.ZodOptional<z.ZodNumber>;
     verdicts: z.ZodArray<z.ZodObject<{
-        agent: z.ZodEnum<{
-            reviewer: "reviewer";
-            test_engineer: "test_engineer";
-            critic: "critic";
-            explorer: "explorer";
-            sme: "sme";
-        }>;
+        agent: z.ZodString;
         verdict: z.ZodEnum<{
             APPROVE: "APPROVE";
             CONCERNS: "CONCERNS";

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "opencode-swarm",
-	"version": "7.146.2",
+	"version": "7.146.4",
 	"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",
@@ -110,6 +110,7 @@
 		"check:events": "bun run scripts/check-event-contract.ts",
 		"check:retention": "bun run scripts/check-retention-registry.ts",
 		"check:test-file-cap": "bun run scripts/check-test-file-cap.ts",
+		"check:pending-fragment": "bun run scripts/check-pending-fragment.ts",
 		"check:gate-portability": "bun run scripts/check-gate-portability.ts",
 		"check:bare-spawn": "bun run scripts/check-bare-executable-spawn.ts",
 		"check:memory-recall": "bun run scripts/memory-recall-regression.ts"