opencode-swarm 7.144.1 → 7.144.2

package/dist/hooks/reviewer-scope-file-fingerprint.d.ts

@@ -1,6 +1,33 @@
 import * as fs from 'node:fs';
-export declare const MAX_REVIEWER_SCOPE_FINGERPRINT_BYTES = 1048576;
-export declare const MAX_REVIEWER_SCOPE_FINGERPRINT_AGGREGATE_BYTES = 4194304;
+/**
+ * Exact reviewer-scope capture (v2, issue #2100).
+ *
+ * Every regular file is fingerprinted over its COMPLETE bytes with one fixed
+ * chunk buffer — there is no per-file or aggregate byte cap. File identity is
+ * never denied by size: resource pressure surfaces as the typed retryable
+ * `capture_deadline` (or a per-file race code), and only a successful capture
+ * can ever produce a digest. A partial, sampled, or capped digest cannot be
+ * represented by this module by construction.
+ */
+export type ReviewerScopeCaptureFailureCode = 'invalid_request' | 'outside_workspace' | 'symlink_or_reparse' | 'non_regular' | 'unreadable' | 'workspace_mismatch' | 'file_changed_during_capture' | 'capture_deadline';
+/** `binding_mismatch` and invalid generation identity are lifecycle-level typed errors (reviewer-scope-lifecycle), not per-file capture codes. */
+export declare const RETRYABLE_CAPTURE_FAILURE_CODES: ReadonlySet<ReviewerScopeCaptureFailureCode>;
+export type ReviewerScopeCaptureResult = {
+    kind: 'captured_file';
+    file: string;
+    size: number;
+    hash: string;
+} | {
+    kind: 'captured_deleted';
+    file: string;
+} | {
+    kind: 'capture_failed';
+    file: string;
+    code: ReviewerScopeCaptureFailureCode;
+    retryable: boolean;
+    detail?: string;
+};
+/** Stored success record persisted on generations and ownership tombstones. */
 export type ReviewerScopeFileFingerprint = {
     file: string;
     kind: 'file';
@@ -10,12 +37,37 @@ export type ReviewerScopeFileFingerprint = {
     file: string;
     kind: 'deleted';
 };
+/** Fixed streaming chunk — the only buffer a capture ever allocates. */
+export declare const REVIEWER_SCOPE_CAPTURE_CHUNK_BYTES = 262144;
+/** Bounded attempts for typed retryable capture failures at every call site. */
+export declare const REVIEWER_SCOPE_CAPTURE_ATTEMPTS = 3;
+/** Total deadline (ms) for one capture batch (guardrails batch, freshness check, manifest build). */
+export declare const REVIEWER_SCOPE_CAPTURE_BATCH_DEADLINE_MS = 10000;
 export declare const _internals: {
-    readFileSync: typeof fs.readFileSync;
+    open: typeof fs.openSync;
+    fstat: (fd: number, options: {
+        bigint: true;
+    }) => fs.BigIntStats;
+    read: typeof fs.readSync;
+    close: typeof fs.closeSync;
+    lstat: typeof fs.lstatSync;
+    stat: (path: fs.PathLike, options: {
+        bigint: true;
+    }) => fs.BigIntStats;
+    realpathSync: typeof fs.realpathSync;
+    now: () => number;
 };
 /**
- * Capture the exact post-write file state with a bounded read. Oversized,
- * non-regular, path-racing, and unreadable targets fail closed to null.
+ * Capture the exact current file state with a complete, bounded-memory SHA-256.
+ *
+ * Failure surfaces are typed: traversal/root escape, symlinks/reparse points,
+ * non-regular files, and unreadable targets fail closed as non-retryable codes;
+ * open/stat races and capture deadlines are retryable. Deletions under a
+ * contained (possibly removed) directory are `captured_deleted`.
  */
-export declare function captureReviewerScopeFileFingerprint(directory: string, file: string, maxBytes?: number): ReviewerScopeFileFingerprint | null;
+export declare function captureReviewerScopeFileFingerprint(directory: string, file: string, options?: {
+    deadlineAt?: number;
+}): ReviewerScopeCaptureResult;
+/** Convert a successful capture into the stored fingerprint record shape. */
+export declare function reviewerScopeCaptureToFingerprint(result: ReviewerScopeCaptureResult): ReviewerScopeFileFingerprint | null;
 export declare function reviewerScopeFileFingerprintsEqual(left: ReviewerScopeFileFingerprint, right: ReviewerScopeFileFingerprint): boolean;

package/dist/hooks/reviewer-scope-lifecycle.d.ts

@@ -1,4 +1,12 @@
-export type ReviewerScopeLifecycleTransition = 'coder_started' | 'coder_ready' | 'reviewer_claimed';
+import * as child_process from 'node:child_process';
+export type ReviewerScopeLifecycleTransition = 'coder_started' | 'coder_ready' | 'coder_no_change' | 'reviewer_claimed';
+/** Test-only dependency-injection seam for the no-change status probe. */
+export declare const _internals: {
+    spawn: typeof child_process.spawn;
+    backoffMs?: number;
+    /** Test-only deadline override for the bounded retry loop (ms). */
+    retryDeadlineMs?: number;
+};
 /** Run only after the complete blocking before-chain approved this Task call. */
 export declare function beginApprovedReviewerScopeLifecycle(input: {
     directory: string;

package/dist/hooks/reviewer-scope-mergeback.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Merge-back verification for lane-captured reviewer generations (issue #2100
+ * contract D).
+ *
+ * A lane generation is only reviewable from the primary checkout after every
+ * manifest file (including deletions) matches the lane manifest in the primary
+ * root. Verification re-captures each file from the PRIMARY directory with the
+ * shared exact-byte capture and compares against the generation's stored
+ * fingerprints. A conflict, deferred merge, or changed byte produces a typed
+ * retained state (`mergeback_mismatch`) — never a generic reviewer-stale
+ * relabel and never a discard.
+ */
+/**
+ * Best-effort synchronous verification. Never throws: an unexpected error is
+ * recorded as a typed mismatch so the generation stays actionable.
+ */
+export declare function verifyReviewerScopeGenerationMergeBack(input: {
+    parentSessionID: string;
+    taskId: string;
+    coderCallID: string;
+    primaryDirectory: string;
+    now?: number;
+}): void;

package/dist/index.d.ts

@@ -2,6 +2,7 @@ import type { Plugin } from '@opencode-ai/plugin';
 import { loadPluginConfigWithMetaAsync } from './config';
 import { resolveAutoReviewConfig } from './config/schema';
 import { createRepoGraphBuilderHook } from './hooks';
+import type { MemoryConfig as RuntimeMemoryConfig } from './memory/config.js';
 import { loadSnapshot } from './session/snapshot-reader.js';
 import { ensureSwarmGitExcluded } from './utils/gitignore-warning';
 /**
@@ -24,6 +25,7 @@ type PostResolutionTask = () => void | Promise<void>;
  * expensive filesystem work while `server()` remains unresolved (issue #704).
  */
 declare function schedulePostResolutionTasks(tasks: readonly PostResolutionTask[]): void;
+type RegenerateMemoryReflectionForInit = (directory: string, config: Partial<RuntimeMemoryConfig>) => Promise<unknown>;
 export declare function overrideIndexInternalsForTest(overrides: {
     createRepoGraphBuilderHook?: typeof createRepoGraphBuilderHook;
     schedulePostResolutionTasks?: typeof schedulePostResolutionTasks;
@@ -31,6 +33,7 @@ export declare function overrideIndexInternalsForTest(overrides: {
     loadSnapshot?: typeof loadSnapshot;
     ensureSwarmGitExcluded?: typeof ensureSwarmGitExcluded;
     resolveAutoReviewConfig?: typeof resolveAutoReviewConfig;
+    regenerateMemoryReflection?: RegenerateMemoryReflectionForInit;
 }): () => void;
 export declare function schedulePostResolutionTasksForTest(tasks: readonly PostResolutionTask[]): void;
 /**