opencode-swarm 7.144.0 → 7.144.2

package/dist/state.d.ts

@@ -80,6 +80,27 @@ export interface TaskWorkflowCacheEntry {
  * never evicted to make room.
  */
 export declare const MAX_TRACKED_TASK_FILE_ATTRIBUTIONS = 128;
+/** Typed per-file capture failure retained on a generation (issue #2100). */
+export interface ReviewerScopeCaptureFailure {
+    file: string;
+    code: string;
+    retryable: boolean;
+    attempts: number;
+    at: number;
+}
+/**
+ * Merge-back provenance for lane-captured generations. `verified` records the
+ * primary-checkout match that makes the generation reviewable from the primary
+ * root; the failure arm retains an actionable typed reason instead of
+ * relabeling the generation as generic reviewer-stale.
+ */
+export type ReviewerScopeMergebackState = {
+    verifiedAt: number;
+    primaryWorkspaceIdentity: string;
+} | {
+    failedAt: number;
+    reason: string;
+};
 /** Exact lifecycle state for one coder generation and its paired reviewer. */
 export interface ReviewerScopeGeneration {
     taskId: string;
@@ -87,14 +108,21 @@ export interface ReviewerScopeGeneration {
     generation: number;
     sessionIncarnation: string;
     background: boolean;
+    /** Canonical root every capture/equality site must use (lane or primary). */
+    captureDirectory: string;
+    /** Canonical workspace identity of `captureDirectory` (issue #2100 root correctness). */
+    workspaceIdentity: string;
     declaredFiles: string[];
     modifiedFiles: string[];
     modifiedFileFingerprints: import('./hooks/reviewer-scope-file-fingerprint.js').ReviewerScopeFileFingerprint[];
-    status: 'collecting' | 'ready' | 'claimed';
+    /** Last typed capture failure per file; cleared when that file later captures. */
+    captureFailures: ReviewerScopeCaptureFailure[];
+    status: 'collecting' | 'ready' | 'claimed' | 'no_change' | 'mergeback_pending' | 'mergeback_mismatch';
     createdAt: number;
     readyAt?: number;
     reviewerCallID?: string;
     reviewerDispatchScope?: ReviewerScopeDispatchSnapshot;
+    mergeback?: ReviewerScopeMergebackState;
 }
 export interface ReviewerScopeDispatchSnapshot {
     hash: string;
@@ -121,6 +149,8 @@ export interface ReviewerScopeOwnershipTombstone extends ReviewerScopeGeneration
     parentSessionID: string;
     taskId: string;
     background: true;
+    captureDirectory: string;
+    workspaceIdentity: string;
     declaredFiles: string[];
     modifiedFiles: string[];
     modifiedFileFingerprints: import('./hooks/reviewer-scope-file-fingerprint.js').ReviewerScopeFileFingerprint[];
@@ -742,6 +772,10 @@ export declare function startReviewerScopeGeneration(input: {
     coderCallID: string;
     background?: boolean;
     declaredFiles?: string[];
+    /** Canonical root post-write capture must read from (lane or primary). */
+    captureDirectory: string;
+    /** Canonical workspace identity of `captureDirectory` (scope-binding identity). */
+    workspaceIdentity: string;
     createdAt?: number;
 }): ReviewerScopeGeneration | null;
 /** Route one child-observed write to its exact parent/task/coder generation. */
@@ -755,6 +789,7 @@ export declare function recordReviewerScopeGenerationFile(input: {
 /**
  * Record the bounded post-write state only after a guarded child write returns
  * successfully. Pre-write routing in modifiedFiles remains authorization metadata.
+ * A successful capture clears any retained typed failure for that file.
  */
 export declare function recordReviewerScopeGenerationFileFingerprint(input: {
     parentSessionID: string;
@@ -762,12 +797,71 @@ export declare function recordReviewerScopeGenerationFileFingerprint(input: {
     coderCallID: string;
     fingerprint: import('./hooks/reviewer-scope-file-fingerprint.js').ReviewerScopeFileFingerprint;
 }): boolean;
-/** Mark the exact coder call terminal; background running placeholders do not call this. */
+/**
+ * Retain the LAST typed capture failure per file (upsert by file, bounded at
+ * the generation file cap). Failures are diagnostic recovery metadata — they
+ * never invalidate a generation by themselves.
+ */
+export declare function recordReviewerScopeGenerationCaptureFailure(input: {
+    parentSessionID: string;
+    taskId: string;
+    coderCallID: string;
+    file: string;
+    code: string;
+    retryable: boolean;
+    at?: number;
+}): boolean;
+/**
+ * Mark the exact coder call terminal. Transactional publication (issue #2100
+ * contract E): `ready` is published only when every observed file has exactly
+ * one exact fingerprint — a half-populated fingerprint array is never exposed
+ * as reviewable. Incomplete generations stay `collecting` (recoverable).
+ */
 export declare function markReviewerScopeGenerationReady(input: {
     parentSessionID: string;
     taskId: string;
     coderCallID: string;
     readyAt?: number;
+    /** Canonical identity of the primary checkout; a lane-rooted generation is not reviewable from it until merge-back verification repoints the root. */
+    primaryWorkspaceIdentity?: string;
+}): boolean;
+/** Truthful no-change terminal: zero observed writes, verified zero diff (issue #2100 contract F). */
+export declare function markReviewerScopeGenerationNoChange(input: {
+    parentSessionID: string;
+    taskId: string;
+    coderCallID: string;
+    at?: number;
+}): boolean;
+/**
+ * A lane-captured generation awaits merge-back verification before it is
+ * reviewable from the primary root. Conflicts/deferred merges retain the
+ * generation here — they are never relabeled as generic reviewer-stale.
+ */
+export declare function markReviewerScopeGenerationMergebackPending(input: {
+    parentSessionID: string;
+    taskId?: string;
+    coderCallID: string;
+    at?: number;
+}): boolean;
+/**
+ * Pure state transition for merge-back settlement: a verified primary match
+ * publishes `ready`; a typed reason retains the generation as
+ * `mergeback_mismatch` for an actionable architect retry.
+ */
+export declare function settleReviewerScopeMergeback(input: {
+    parentSessionID: string;
+    taskId?: string;
+    coderCallID: string;
+    outcome: {
+        verified: true;
+        primaryWorkspaceIdentity: string;
+        primaryDirectory: string;
+        at?: number;
+    } | {
+        verified: false;
+        reason: string;
+        at?: number;
+    };
 }): boolean;
 /** Read one exact coder generation for terminal guardrail/evidence checks. */
 export declare function getReviewerScopeGenerationForCoderCall(input: {
@@ -782,6 +876,17 @@ export declare function peekReadyReviewerScopeGeneration(input: {
     taskId: string;
     now?: number;
 }): ReviewerScopeGeneration | null;
+/**
+ * Inspect the single generation for a task in a NON-reviewable status
+ * (`no_change` | `mergeback_pending` | `mergeback_mismatch`) so lifecycle
+ * denials can name the exact typed recovery action instead of generic stale.
+ */
+export declare function peekReviewerScopeGenerationByStatus(input: {
+    parentSessionID: string;
+    taskId: string;
+    status: 'no_change' | 'mergeback_pending' | 'mergeback_mismatch';
+    now?: number;
+}): ReviewerScopeGeneration | null;
 /**
  * Claim the only ready generation for an exact task after every blocking
  * reviewer before-hook has passed. Ambiguity fails closed to no receipt.

package/dist/tools/index.d.ts

@@ -79,6 +79,7 @@ export { run_stale_reconciliation } from './stale-reconciliation';
 export { submit_phase_council_verdicts } from './submit-phase-council-verdicts';
 export { summarize_work } from './summarize-work';
 export { createSwarmCommandTool, swarm_command } from './swarm-command';
+export { swarm_memory_outcome } from './swarm-memory-outcome';
 export { swarm_memory_propose } from './swarm-memory-propose';
 export { swarm_memory_recall } from './swarm-memory-recall';
 export { write_architecture_supervisor_evidence } from './write-architecture-supervisor-evidence';

package/dist/tools/manifest.d.ts

@@ -122,6 +122,7 @@ export declare const TOOL_MANIFEST: {
     knowledge_archive: () => ToolDefinition;
     swarm_memory_recall: () => ToolDefinition;
     swarm_memory_propose: () => ToolDefinition;
+    swarm_memory_outcome: () => ToolDefinition;
     swarm_command: () => ToolDefinition;
     dispatch_lanes: () => ToolDefinition;
     dispatch_lanes_async: () => ToolDefinition;

package/dist/tools/swarm-memory-outcome.d.ts

@@ -0,0 +1,11 @@
+import { loadPluginConfigWithMeta } from '../config';
+import { createMemoryGateway, recordOutcomeWithReflection } from '../memory';
+import { getAgentSession } from '../state';
+import { createSwarmTool } from './create-tool';
+export declare const swarm_memory_outcome: ReturnType<typeof createSwarmTool>;
+export declare const _internals: {
+    loadPluginConfigWithMeta: typeof loadPluginConfigWithMeta;
+    createMemoryGateway: typeof createMemoryGateway;
+    getAgentSession: typeof getAgentSession;
+    recordOutcomeWithReflection: typeof recordOutcomeWithReflection;
+};

package/dist/tools/tool-metadata.d.ts

@@ -516,6 +516,10 @@ export declare const TOOL_METADATA: {
         description: string;
         agents: never[];
     };
+    swarm_memory_outcome: {
+        description: string;
+        agents: never[];
+    };
     swarm_command: {
         description: string;
         agents: ("reviewer" | "critic" | "critic_finding_validator" | "explorer" | "coder" | "test_engineer" | "architect" | "sme" | "researcher" | "docs" | "docs_design" | "designer")[];

package/package.json

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