opencode-swarm 7.81.4 → 7.82.0

package/dist/background/completion-observer.d.ts

@@ -1,27 +1,14 @@
 /**
  * Background subagent completion observer/ingester.
  *
- * Registers as a swarm `event` hook to watch for the upstream background-completion signal:
- * a message part with `synthetic === true` whose text is a task envelope with
- * `state="completed"` or `state="error"`. When such a part correlates to a durable pending
- * background-delegation record, it is logged (debug-gated) as the empirical confirmation
- * instrument operators use to verify the runtime signal in a real environment.
- *
- * PR1 async advisory lanes ingest trusted terminal completions into the durable
- * background-delegation ledger only. This still NEVER advances workflow gates or records
- * gate evidence; gate-bearing execution is intentionally outside this advisory path.
- *
- * The `synthetic` flag is the trust gate (set by OpenCode, not the model/user). Non-synthetic
- * text that merely looks like an envelope is ignored. The observer is fail-open: any error is
- * swallowed so it can never block event delivery or plugin load (Invariant 1/10).
+ * Trusted synthetic background completions always settle the durable
+ * background-delegation ledger. Correctness-critical Stage B completions then
+ * pass through workspace freshness validation before gate evidence, receipts, or
+ * task workflow state can advance.
  */
 interface ObserverConfig {
     enabled: boolean;
 }
-/**
- * Build the background completion observer. Returns an `event` handler suitable for the
- * OpenCode plugin `event` hook. No-op (cheap early return) when the feature is disabled.
- */
 export declare function createBackgroundCompletionObserver(opts: {
     config: ObserverConfig;
     directory: string;

package/dist/background/pending-delegations.d.ts

@@ -12,8 +12,8 @@
  *
  * Scope: dispatch records `pending`/`running` snapshots, collection or trusted synthetic
  * completions record terminal snapshots, and the stale sweep records `stale` snapshots.
- * This store still has NO gate advancement and NO gate evidence side effect; it is an
- * advisory result ledger only.
+ * This store itself has no gate-advancement side effect. Stage B gate ingestion is a
+ * separate consumer of trusted terminal snapshots.
  *
  * Concurrency: all writes (append, sweep) run under a single project-scoped lock via
  * `withEvidenceLock`, so concurrent dispatches/sweeps cannot interleave appends. Reads are
@@ -23,7 +23,7 @@
  * `.swarm/` (Invariant 4).
  */
 export declare const BACKGROUND_DELEGATIONS_FILE = "background-delegations.jsonl";
-export type BackgroundDelegationStatus = 'pending' | 'running' | 'completed' | 'error' | 'cancelled' | 'stale' | 'consumed';
+export type BackgroundDelegationStatus = 'pending' | 'running' | 'ingestion_error' | 'completed' | 'error' | 'cancelled' | 'stale' | 'consumed';
 export interface BackgroundDelegationRecord {
     schemaVersion: 1 | 2;
     /** Subagent session id from the dispatch envelope — the correlation key. */
@@ -56,6 +56,7 @@ export interface BackgroundDelegationRecord {
     promptHash?: string;
     /** Project/root provenance captured at dispatch time. */
     workspace?: BackgroundWorkspaceSnapshot;
+    prompt?: BackgroundPromptSnapshot;
     generation?: number;
     result?: BackgroundDelegationResult;
     completedAt?: number;
@@ -67,6 +68,12 @@ export interface BackgroundWorkspaceSnapshot {
     prHeadSha: string | null;
     scope: string | null;
 }
+export interface BackgroundPromptSnapshot {
+    text: string;
+    chars: number;
+    truncated: boolean;
+    digest: string;
+}
 export interface BackgroundDelegationResult {
     text?: string;
     error?: string;
@@ -101,6 +108,7 @@ export interface RecordPendingInput {
     mode?: string;
     promptHash?: string;
     workspace?: BackgroundWorkspaceSnapshot;
+    prompt?: BackgroundPromptSnapshot;
     generation?: number;
 }
 /**
@@ -113,6 +121,7 @@ export interface RecordPendingInput {
 export declare function recordPendingDelegation(directory: string, input: RecordPendingInput, options?: {
     staleTimeoutMs?: number;
 }): Promise<BackgroundDelegationRecord | null>;
+export declare function buildPromptSnapshot(text: string, maxChars: number): BackgroundPromptSnapshot;
 export declare function appendDelegationTransition(directory: string, correlationId: string, transition: {
     status: BackgroundDelegationStatus;
     result?: BackgroundDelegationResult;

package/dist/background/stage-b-gates.d.ts

@@ -0,0 +1,18 @@
+import type { BackgroundDelegationRecord, BackgroundDelegationResult } from './pending-delegations.js';
+export interface StageBIngestionResult {
+    ok: boolean;
+    consumed: boolean;
+    stale?: boolean;
+    reason?: string;
+}
+export declare function isBackgroundGateBearingRecord(record: BackgroundDelegationRecord): boolean;
+export declare function validateStageBWorkspace(directory: string, record: BackgroundDelegationRecord): {
+    ok: boolean;
+    stale: boolean;
+    reason?: string;
+};
+export declare function ingestBackgroundStageBCompletion(args: {
+    directory: string;
+    record: BackgroundDelegationRecord;
+    result: BackgroundDelegationResult;
+}): Promise<StageBIngestionResult>;

package/dist/background/workspace-snapshot.d.ts

@@ -0,0 +1,31 @@
+import * as child_process from 'node:child_process';
+import type { BackgroundWorkspaceSnapshot } from './pending-delegations.js';
+type SpawnSync = typeof child_process.spawnSync;
+interface CaptureWorkspaceSnapshotOptions {
+    scope?: string | null;
+    prHeadSha?: string | null;
+    /**
+     * Re-resolve the current upstream ref for freshness validation. When the
+     * dispatch captured an explicit PR head SHA, ingestion must compare against a
+     * live local ref, not replay the stored metadata back into the snapshot.
+     */
+    resolveCurrentPrHeadSha?: boolean;
+}
+export declare function captureWorkspaceSnapshot(directory: string, optionsOrScope?: string | null | CaptureWorkspaceSnapshotOptions, prHeadShaArg?: string | null): BackgroundWorkspaceSnapshot;
+export declare function workspaceSnapshotMatches(expected: BackgroundWorkspaceSnapshot | undefined, current: BackgroundWorkspaceSnapshot): {
+    ok: true;
+} | {
+    ok: false;
+    reason: string;
+};
+export type WorkspaceFreshness = ReturnType<typeof workspaceSnapshotMatches>;
+export declare const compareWorkspaceSnapshot: typeof workspaceSnapshotMatches;
+export declare function compareWorkspaceSnapshots(expected: BackgroundWorkspaceSnapshot | undefined, current: BackgroundWorkspaceSnapshot): {
+    stale: boolean;
+    reason?: string;
+};
+export declare function digest(text: string): string;
+export declare const _internals: {
+    spawnSync: SpawnSync;
+};
+export {};

package/dist/cli/index.js

@@ -52,7 +52,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "opencode-swarm",
-    version: "7.81.4",
+    version: "7.82.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",
@@ -17771,7 +17771,7 @@ var init_tool_metadata = __esm(() => {
       agents: ["architect"]
     },
     collect_lane_results: {
-      description: "collect or poll results for a dispatch_lanes_async advisory batch without advancing workflow gates",
+      description: "collect or poll results for a dispatch_lanes_async batch; this is the required join barrier for advisory lane workflows and does not advance workflow gates",
       agents: ["architect"]
     },
     summarize_work: {

package/dist/hooks/review-receipt-collector.d.ts

@@ -48,6 +48,14 @@ export interface ReviewerReceiptInput {
 export interface ReviewerReceiptOutput {
     output?: unknown;
 }
+export interface ReviewerReceiptTranscriptInput {
+    targetAgent?: string;
+    prompt: string;
+    transcript: string;
+    sessionID?: string;
+    sessionId?: string;
+}
+export declare function collectReviewerReceiptFromTranscript(directory: string, input: ReviewerReceiptTranscriptInput): Promise<string | null>;
 /**
  * `tool.execute.after` collector. When a reviewer Task returns, parse its
  * verdict block and persist a durable review receipt. No-op for non-reviewer