opencode-swarm 7.144.0 → 7.144.2

package/dist/cli/{index-e70d3xr7.js → index-tg9fn2dy.js}

@@ -1,10 +1,10 @@
 // @bun
 import {
   handleGuardrailExplain
-} from "./index-rd2082y4.js";
+} from "./index-jsfghpy2.js";
 import {
   handleGuardrailLog
-} from "./index-6p09gyra.js";
+} from "./index-hqvt3mhk.js";
 import {
   COMMAND_REGISTRY,
   SWARM_COMMAND_TOOL_ALLOWLIST,
@@ -84,57 +84,57 @@ import {
   handleWriteRetroCommand,
   normalizeSwarmCommandInput,
   resolveCommand
-} from "./index-j1scj25g.js";
-import"./index-d45yrzkg.js";
-import"./index-evvbmbbv.js";
-import"./index-3v3dxf75.js";
+} from "./index-nretd4qn.js";
+import"./index-g2ajae1z.js";
+import"./index-jb4tchvy.js";
+import"./index-qpt8ahph.js";
 import"./index-134d35c1.js";
 import"./index-b6e016tv.js";
 import"./index-4q9vfav6.js";
 import"./index-k92cagmt.js";
 import"./index-y8552snf.js";
-import"./index-mw6p3nt6.js";
-import"./index-xmzmeknp.js";
+import"./index-m6wv2qdr.js";
+import"./index-70ha9e09.js";
 import"./index-c8s9a3zh.js";
 import"./index-9ss2m4rs.js";
-import"./index-jvbfrwt2.js";
+import"./index-d55crzd4.js";
 import"./index-74hpm6sh.js";
-import"./index-269b52r3.js";
-import"./index-vb9cpaz4.js";
-import"./index-zv4pwyas.js";
-import"./index-0ck3e366.js";
+import"./index-7ca3a6gj.js";
+import"./index-av0f6mm0.js";
+import"./index-zr370283.js";
+import"./index-g1c5fgaw.js";
 import"./index-556ja8an.js";
 import"./index-gdd4jt6b.js";
 import"./index-zsrtt42s.js";
 import"./index-k3cxyk66.js";
 import"./index-4fda8kkw.js";
-import"./index-tfkfyshg.js";
+import"./index-dhh2j2nd.js";
 import"./index-8fwhhayc.js";
 import"./index-q1exe2b3.js";
 import"./index-7sy3aa9m.js";
-import"./index-4905hd2m.js";
-import"./index-ez18gjk2.js";
-import"./index-1pr8x10a.js";
+import"./index-wx8zdh4a.js";
+import"./index-p3tnmkvc.js";
+import"./index-dg2w0wr4.js";
 import"./index-gprxjmm7.js";
 import"./index-n832052r.js";
-import"./index-d45d4zyq.js";
+import"./index-y95nwsge.js";
 import {
   init_schema,
   stripKnownSwarmPrefix
-} from "./index-3q9w6e6v.js";
+} from "./index-h3z64mhz.js";
 import"./index-rn0eq85g.js";
 import"./index-4rhhvd1a.js";
 import {
   AGENT_TOOL_MAP,
   ORCHESTRATOR_NAME,
   init_constants
-} from "./index-jqsfsqbx.js";
+} from "./index-whezv7vc.js";
 import"./index-z6xqpmqg.js";
 import"./index-zjygnfay.js";
-import"./index-ewzmjm7m.js";
+import"./index-ne8cfgw5.js";
 import"./index-tq5s07ta.js";
 import"./index-rtry5xyf.js";
-import"./index-jqabjy7t.js";
+import"./index-ckrasab9.js";
 import"./index-ae75rja9.js";
 import"./index-w7x7qxz2.js";
 import"./index-erfnw81g.js";

package/dist/cli/{index-jqsfsqbx.js → index-whezv7vc.js}

@@ -749,6 +749,10 @@ var init_tool_metadata = __esm(() => {
       description: "create a pending Swarm memory proposal; does not write durable memory directly",
       agents: []
     },
+    swarm_memory_outcome: {
+      description: "record useful, dead-end, or corrected outcomes and, when enabled, synchronously refresh deterministic memory lessons",
+      agents: []
+    },
     swarm_command: {
       description: "run supported /swarm commands through the canonical command registry",
       agents: [

package/dist/cli/{index-4905hd2m.js → index-wx8zdh4a.js}

@@ -15,5 +15,10 @@ async function withTimeout(promise, ms, timeoutError) {
       clearTimeout(timer);
   }
 }
+function yieldToEventLoop() {
+  return new Promise((resolve) => {
+    setTimeout(resolve, 0);
+  });
+}
 
-export { withTimeout };
+export { withTimeout, yieldToEventLoop };

package/dist/cli/{index-d45d4zyq.js → index-y95nwsge.js}

@@ -6,7 +6,7 @@ import {
   PluginConfigSchema,
   init_schema,
   resolveExternalSkillsConfig
-} from "./index-3q9w6e6v.js";
+} from "./index-h3z64mhz.js";
 import {
   advisoryWarn,
   init_warning_buffer

package/dist/cli/{index-zv4pwyas.js → index-zr370283.js}

@@ -2,13 +2,13 @@
 import {
   computePlanStructureHash,
   derivePlanId
-} from "./index-0ck3e366.js";
+} from "./index-g1c5fgaw.js";
 import {
   unsafePathTextReason
 } from "./index-556ja8an.js";
 import {
   PlanSchema
-} from "./index-d45d4zyq.js";
+} from "./index-y95nwsge.js";
 import {
   assertProjectRoot
 } from "./index-k31en0ja.js";
@@ -1757,4 +1757,4 @@ function resolveScopeWithFallbacks(input) {
   return null;
 }
 
-export { MAX_PENDING_SCOPE_BINDINGS, clearScopeBindings, writeScopeToDisk, writeScopeBindingToDisk, persistAndRegisterScopeBinding, readScopeBindingFromDisk, resolveScopeBindingFromDisk, clearScopeBindingFromDisk, tombstoneScopeBinding, refreshScopeBindingLease, claimScopeBindingForChildDurably, replaceExistingScopeDeclaration, flushScopeBindingMaintenance, pruneScopeBindingTombstones, resolveAuthorizedScopeBinding, resolveAuthorizedScopeBindingDetailed, resolveAuthorizedScopeBindingForSession, resolveAuthorizedScopeBindingForSessionDetailed, resolveAuthorizedPrFeedbackScopeBindingFromDisk, _scopePersistenceInternals, readScopeFromDisk, readPlanScope, clearScopeForTask, clearAllScopes, resolveScopeWithFallbacks };
+export { MAX_PENDING_SCOPE_BINDINGS, canonicalWorkspaceIdentity, clearScopeBindings, writeScopeToDisk, writeScopeBindingToDisk, persistAndRegisterScopeBinding, readScopeBindingFromDisk, resolveScopeBindingFromDisk, clearScopeBindingFromDisk, tombstoneScopeBinding, refreshScopeBindingLease, claimScopeBindingForChildDurably, replaceExistingScopeDeclaration, flushScopeBindingMaintenance, pruneScopeBindingTombstones, resolveAuthorizedScopeBinding, resolveAuthorizedScopeBindingDetailed, resolveAuthorizedScopeBindingForSession, resolveAuthorizedScopeBindingForSessionDetailed, resolveAuthorizedPrFeedbackScopeBindingFromDisk, _scopePersistenceInternals, readScopeFromDisk, readPlanScope, clearScopeForTask, clearAllScopes, resolveScopeWithFallbacks };

package/dist/cli/index.js

@@ -6,57 +6,58 @@ import {
   getPluginCachePaths,
   getPluginConfigDir,
   getPluginLockFilePaths,
-  resolveCommand
-} from "./index-j1scj25g.js";
-import"./index-d45yrzkg.js";
-import"./index-evvbmbbv.js";
-import"./index-3v3dxf75.js";
+  resolveCommand,
+  safeRealpathSync
+} from "./index-nretd4qn.js";
+import"./index-g2ajae1z.js";
+import"./index-jb4tchvy.js";
+import"./index-qpt8ahph.js";
 import"./index-134d35c1.js";
 import"./index-b6e016tv.js";
 import"./index-4q9vfav6.js";
 import"./index-k92cagmt.js";
 import"./index-y8552snf.js";
-import"./index-mw6p3nt6.js";
-import"./index-xmzmeknp.js";
+import"./index-m6wv2qdr.js";
+import"./index-70ha9e09.js";
 import"./index-c8s9a3zh.js";
 import"./index-9ss2m4rs.js";
-import"./index-jvbfrwt2.js";
+import"./index-d55crzd4.js";
 import"./index-74hpm6sh.js";
-import"./index-269b52r3.js";
-import"./index-vb9cpaz4.js";
-import"./index-zv4pwyas.js";
-import"./index-0ck3e366.js";
+import"./index-7ca3a6gj.js";
+import"./index-av0f6mm0.js";
+import"./index-zr370283.js";
+import"./index-g1c5fgaw.js";
 import"./index-556ja8an.js";
 import"./index-gdd4jt6b.js";
 import"./index-zsrtt42s.js";
 import"./index-k3cxyk66.js";
 import"./index-4fda8kkw.js";
-import"./index-tfkfyshg.js";
+import"./index-dhh2j2nd.js";
 import"./index-8fwhhayc.js";
 import"./index-q1exe2b3.js";
 import"./index-7sy3aa9m.js";
-import"./index-4905hd2m.js";
-import"./index-ez18gjk2.js";
-import"./index-1pr8x10a.js";
+import"./index-wx8zdh4a.js";
+import"./index-p3tnmkvc.js";
+import"./index-dg2w0wr4.js";
 import"./index-gprxjmm7.js";
 import"./index-n832052r.js";
-import"./index-d45d4zyq.js";
+import"./index-y95nwsge.js";
 import {
   init_package,
   package_default
-} from "./index-3q9w6e6v.js";
+} from "./index-h3z64mhz.js";
 import"./index-rn0eq85g.js";
 import"./index-4rhhvd1a.js";
 import {
   DEFAULT_AGENT_CONFIGS,
   init_constants
-} from "./index-jqsfsqbx.js";
+} from "./index-whezv7vc.js";
 import"./index-z6xqpmqg.js";
 import"./index-zjygnfay.js";
-import"./index-ewzmjm7m.js";
+import"./index-ne8cfgw5.js";
 import"./index-tq5s07ta.js";
 import"./index-rtry5xyf.js";
-import"./index-jqabjy7t.js";
+import"./index-ckrasab9.js";
 import"./index-ae75rja9.js";
 import"./index-w7x7qxz2.js";
 import"./index-erfnw81g.js";
@@ -77,21 +78,6 @@ import * as os from "os";
 import * as path from "path";
 import { fileURLToPath } from "url";
 init_constants();
-
-// src/tools/repo-graph/safe-realpath.ts
-import { realpathSync } from "fs";
-function safeRealpathSync(targetPath, fallback, realpathResolver = realpathSync) {
-  try {
-    return realpathResolver(targetPath);
-  } catch (error) {
-    if (error instanceof Error && error.code === "ENOENT") {
-      return fallback;
-    }
-    return null;
-  }
-}
-
-// src/cli/index.ts
 var { version } = package_default;
 var PACKAGE_ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..", "..");
 var CONFIG_DIR = getPluginConfigDir();

package/dist/cli/{knowledge-escalator-rmy3jcx4.js → knowledge-escalator-cg19dhe5.js}

@@ -9,19 +9,19 @@ import {
   maybeEscalateOnViolation,
   maybeQuarantineOnContradiction,
   readRecentEscalations
-} from "./index-vb9cpaz4.js";
-import"./index-ez18gjk2.js";
-import"./index-1pr8x10a.js";
+} from "./index-av0f6mm0.js";
+import"./index-p3tnmkvc.js";
+import"./index-dg2w0wr4.js";
 import"./index-gprxjmm7.js";
 import"./index-n832052r.js";
-import"./index-d45d4zyq.js";
-import"./index-3q9w6e6v.js";
+import"./index-y95nwsge.js";
+import"./index-h3z64mhz.js";
 import"./index-rn0eq85g.js";
 import"./index-4rhhvd1a.js";
-import"./index-jqsfsqbx.js";
+import"./index-whezv7vc.js";
 import"./index-z6xqpmqg.js";
 import"./index-zjygnfay.js";
-import"./index-jqabjy7t.js";
+import"./index-ckrasab9.js";
 import"./index-ae75rja9.js";
 import"./index-w7x7qxz2.js";
 import"./index-erfnw81g.js";

package/dist/cli/{knowledge-events-1tqpbwvj.js → knowledge-events-yzvysaqd.js}

@@ -29,15 +29,15 @@ import {
   resolveKnowledgeCounterBaselinePath,
   resolveKnowledgeEventsPath,
   resolveLegacyApplicationLogPath
-} from "./index-ez18gjk2.js";
-import"./index-1pr8x10a.js";
+} from "./index-p3tnmkvc.js";
+import"./index-dg2w0wr4.js";
 import"./index-gprxjmm7.js";
 import"./index-n832052r.js";
-import"./index-d45d4zyq.js";
-import"./index-3q9w6e6v.js";
+import"./index-y95nwsge.js";
+import"./index-h3z64mhz.js";
 import"./index-rn0eq85g.js";
 import"./index-4rhhvd1a.js";
-import"./index-jqsfsqbx.js";
+import"./index-whezv7vc.js";
 import"./index-z6xqpmqg.js";
 import"./index-zjygnfay.js";
 import"./index-ae75rja9.js";

package/dist/cli/{knowledge-store-389ck792.js → knowledge-store-6f77xpmm.js}

@@ -41,7 +41,7 @@ import {
   transactKnowledge,
   transactKnowledgeWithCas,
   wordBigrams
-} from "./index-jqabjy7t.js";
+} from "./index-ckrasab9.js";
 import {
   resolveHiveDataDir
 } from "./index-ae75rja9.js";

package/dist/cli/{knowledge-validator-kvtk6633.js → knowledge-validator-4b28zdxa.js}

@@ -23,10 +23,10 @@ import {
   validateLesson,
   validateSkillCandidatePath,
   validateSkillPath
-} from "./index-ewzmjm7m.js";
+} from "./index-ne8cfgw5.js";
 import"./index-tq5s07ta.js";
 import"./index-rtry5xyf.js";
-import"./index-jqabjy7t.js";
+import"./index-ckrasab9.js";
 import"./index-ae75rja9.js";
 import"./index-w7x7qxz2.js";
 import"./index-erfnw81g.js";

package/dist/cli/{runtime-te94z1zb.js → runtime-x10qb3z1.js}

@@ -8,8 +8,9 @@ import {
   loadGrammar,
   parserCache,
   resolveGrammarsDir
-} from "./index-5n69863d.js";
-import"./index-4905hd2m.js";
+} from "./index-ddpkwdcb.js";
+import"./index-7ryh498h.js";
+import"./index-wx8zdh4a.js";
 import"./index-a76rekgs.js";
 export {
   resolveGrammarsDir,

package/dist/cli/{scan-cursor-ahgm4f5p.js → scan-cursor-nqbb1xt6.js}

@@ -4,8 +4,8 @@ import {
   alreadyCuratedThisGeneration,
   claimNextScanBatch,
   getScanStatus
-} from "./index-mw6p3nt6.js";
-import"./index-jqabjy7t.js";
+} from "./index-m6wv2qdr.js";
+import"./index-ckrasab9.js";
 import"./index-ae75rja9.js";
 import"./index-w7x7qxz2.js";
 import"./index-erfnw81g.js";

package/dist/cli/{schema-epdq7ykx.js → schema-jj2pb6zp.js}

@@ -96,8 +96,8 @@ import {
   resolveGeneratedAgentRole,
   resolveGuardrailsConfig,
   stripKnownSwarmPrefix
-} from "./index-3q9w6e6v.js";
-import"./index-jqsfsqbx.js";
+} from "./index-h3z64mhz.js";
+import"./index-whezv7vc.js";
 import"./index-zjygnfay.js";
 import"./index-bk5tah7q.js";
 import"./index-bpmtbmy9.js";

package/dist/cli/{scope-persistence-37s9n40v.js → scope-persistence-63nasq0z.js}

@@ -23,13 +23,13 @@ import {
   tombstoneScopeBinding,
   writeScopeBindingToDisk,
   writeScopeToDisk
-} from "./index-zv4pwyas.js";
-import"./index-0ck3e366.js";
+} from "./index-zr370283.js";
+import"./index-g1c5fgaw.js";
 import"./index-556ja8an.js";
-import"./index-d45d4zyq.js";
-import"./index-3q9w6e6v.js";
+import"./index-y95nwsge.js";
+import"./index-h3z64mhz.js";
 import"./index-4rhhvd1a.js";
-import"./index-jqsfsqbx.js";
+import"./index-whezv7vc.js";
 import"./index-zjygnfay.js";
 import"./index-bk5tah7q.js";
 import"./index-k31en0ja.js";

package/dist/cli/{skill-generator-4d2t5gem.js → skill-generator-nsymtdqm.js}

@@ -33,22 +33,22 @@ import {
   sanitizeSlug,
   selectCandidateEntries,
   writeEvalStub
-} from "./index-269b52r3.js";
-import"./index-ez18gjk2.js";
-import"./index-1pr8x10a.js";
+} from "./index-7ca3a6gj.js";
+import"./index-p3tnmkvc.js";
+import"./index-dg2w0wr4.js";
 import"./index-gprxjmm7.js";
 import"./index-n832052r.js";
-import"./index-d45d4zyq.js";
-import"./index-3q9w6e6v.js";
+import"./index-y95nwsge.js";
+import"./index-h3z64mhz.js";
 import"./index-rn0eq85g.js";
 import"./index-4rhhvd1a.js";
-import"./index-jqsfsqbx.js";
+import"./index-whezv7vc.js";
 import"./index-z6xqpmqg.js";
 import"./index-zjygnfay.js";
-import"./index-ewzmjm7m.js";
+import"./index-ne8cfgw5.js";
 import"./index-tq5s07ta.js";
 import"./index-rtry5xyf.js";
-import"./index-jqabjy7t.js";
+import"./index-ckrasab9.js";
 import"./index-ae75rja9.js";
 import"./index-w7x7qxz2.js";
 import"./index-erfnw81g.js";

package/dist/cli/tree-sitter-431q1bka.js

@@ -0,0 +1,26 @@
+// @bun
+import {
+  CaptureQuantifier,
+  LANGUAGE_VERSION,
+  Language,
+  LookaheadIterator,
+  MIN_COMPATIBLE_VERSION,
+  Node,
+  Parser,
+  Query,
+  Tree,
+  TreeCursor
+} from "./index-7ryh498h.js";
+import"./index-a76rekgs.js";
+export {
+  TreeCursor,
+  Tree,
+  Query,
+  Parser,
+  Node,
+  MIN_COMPATIBLE_VERSION,
+  LookaheadIterator,
+  Language,
+  LANGUAGE_VERSION,
+  CaptureQuantifier
+};

package/dist/cli/{worktree-isolation-4628yaka.js → worktree-isolation-g54kxw6x.js}

@@ -20,52 +20,52 @@ import {
   sanitizeWorktreeTaskId,
   standardWorktreeByCallID,
   standardWorktreeSerializationSessions
-} from "./index-j1scj25g.js";
-import"./index-d45yrzkg.js";
-import"./index-evvbmbbv.js";
-import"./index-3v3dxf75.js";
+} from "./index-nretd4qn.js";
+import"./index-g2ajae1z.js";
+import"./index-jb4tchvy.js";
+import"./index-qpt8ahph.js";
 import"./index-134d35c1.js";
 import"./index-b6e016tv.js";
 import"./index-4q9vfav6.js";
 import"./index-k92cagmt.js";
 import"./index-y8552snf.js";
-import"./index-mw6p3nt6.js";
-import"./index-xmzmeknp.js";
+import"./index-m6wv2qdr.js";
+import"./index-70ha9e09.js";
 import"./index-c8s9a3zh.js";
 import"./index-9ss2m4rs.js";
-import"./index-jvbfrwt2.js";
+import"./index-d55crzd4.js";
 import"./index-74hpm6sh.js";
-import"./index-269b52r3.js";
-import"./index-vb9cpaz4.js";
-import"./index-zv4pwyas.js";
-import"./index-0ck3e366.js";
+import"./index-7ca3a6gj.js";
+import"./index-av0f6mm0.js";
+import"./index-zr370283.js";
+import"./index-g1c5fgaw.js";
 import"./index-556ja8an.js";
 import"./index-gdd4jt6b.js";
 import"./index-zsrtt42s.js";
 import"./index-k3cxyk66.js";
 import"./index-4fda8kkw.js";
-import"./index-tfkfyshg.js";
+import"./index-dhh2j2nd.js";
 import"./index-8fwhhayc.js";
 import"./index-q1exe2b3.js";
 import"./index-7sy3aa9m.js";
-import"./index-4905hd2m.js";
-import"./index-ez18gjk2.js";
+import"./index-wx8zdh4a.js";
+import"./index-p3tnmkvc.js";
 import {
   resolveWorktreeIsolationConfig
-} from "./index-1pr8x10a.js";
+} from "./index-dg2w0wr4.js";
 import"./index-gprxjmm7.js";
 import"./index-n832052r.js";
-import"./index-d45d4zyq.js";
-import"./index-3q9w6e6v.js";
+import"./index-y95nwsge.js";
+import"./index-h3z64mhz.js";
 import"./index-rn0eq85g.js";
 import"./index-4rhhvd1a.js";
-import"./index-jqsfsqbx.js";
+import"./index-whezv7vc.js";
 import"./index-z6xqpmqg.js";
 import"./index-zjygnfay.js";
-import"./index-ewzmjm7m.js";
+import"./index-ne8cfgw5.js";
 import"./index-tq5s07ta.js";
 import"./index-rtry5xyf.js";
-import"./index-jqabjy7t.js";
+import"./index-ckrasab9.js";
 import"./index-ae75rja9.js";
 import"./index-w7x7qxz2.js";
 import"./index-erfnw81g.js";

package/dist/config/constants.d.ts

@@ -5,7 +5,7 @@ export type { AgentName, PipelineAgentName, QAAgentName } from './agent-names';
 export { ALL_AGENT_NAMES, ALL_SUBAGENT_NAMES, ORCHESTRATOR_NAME, PIPELINE_AGENTS, QA_AGENTS, } from './agent-names';
 export declare const OPENCODE_NATIVE_AGENTS: Set<"plan" | "summary" | "compaction" | "title" | "build" | "general" | "explore">;
 export declare const CLAUDE_CODE_NATIVE_COMMANDS: ReadonlySet<string>;
-export declare const MEMORY_TOOL_NAMES: readonly ["swarm_memory_recall", "swarm_memory_propose"];
+export declare const MEMORY_TOOL_NAMES: readonly ["swarm_memory_recall", "swarm_memory_propose", "swarm_memory_outcome"];
 export declare const MEMORY_AGENT_TOOL_MAP: Partial<Record<AgentName, ToolName[]>>;
 export declare const EXTERNAL_SKILL_TOOL_NAMES: readonly ["external_skill_discover", "external_skill_list", "external_skill_inspect", "external_skill_promote", "external_skill_reject", "external_skill_delete", "external_skill_revoke"];
 export declare const EXTERNAL_SKILL_AGENT_TOOL_MAP: Partial<Record<AgentName, ToolName[]>>;

package/dist/config/schema.d.ts

@@ -816,6 +816,10 @@ export declare const MemoryConfigSchema: z.ZodObject<{
             tokenBudget: z.ZodDefault<z.ZodNumber>;
         }, z.core.$strip>>;
     }, z.core.$strip>>;
+    reflection: z.ZodDefault<z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        halfLifeDays: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>>;
     learning: z.ZodDefault<z.ZodObject<{
         learningRate: z.ZodDefault<z.ZodNumber>;
         propagationFactor: z.ZodDefault<z.ZodNumber>;
@@ -2199,6 +2203,10 @@ export declare const PluginConfigSchema: z.ZodObject<{
                 tokenBudget: z.ZodDefault<z.ZodNumber>;
             }, z.core.$strip>>;
         }, z.core.$strip>>;
+        reflection: z.ZodDefault<z.ZodObject<{
+            enabled: z.ZodDefault<z.ZodBoolean>;
+            halfLifeDays: z.ZodDefault<z.ZodNumber>;
+        }, z.core.$strip>>;
         learning: z.ZodDefault<z.ZodObject<{
             learningRate: z.ZodDefault<z.ZodNumber>;
             propagationFactor: z.ZodDefault<z.ZodNumber>;

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

@@ -1,25 +1,38 @@
 /**
- * Canonical scope construction for Stage-B reviewer receipts.
+ * Canonical scope construction for Stage-B reviewer receipts (v2, issue #2100).
  *
  * The architect-authored reviewer prompt is not authoritative scope: it can
  * omit files that the coder actually changed. Guardrails records every
- * write-tool target in `modifiedFilesThisCoderTask`, so receipts fingerprint a
- * bounded manifest of repository HEAD, those paths, and their current byte
- * content instead. A base change therefore invalidates the receipt even when
- * the working-file bytes happen to remain identical.
+ * write-tool target on the coder generation, so receipts fingerprint an exact
+ * manifest of repository HEAD, the canonical workspace identity, those paths,
+ * and their complete current bytes (streamed SHA-256 — no byte caps). A base
+ * change therefore invalidates the receipt even when the working-file bytes
+ * happen to remain identical.
  *
- * Any missing session state, unsafe path, symlink/reparse point, concurrent
- * mutation, or size overflow fails toward no receipt. A durable receipt must
- * never claim a scope the harness could not reconstruct exactly.
+ * The inline payload budget (`maxBytes`) selects a per-file DELIVERY MODE only
+ * — it never decides which files enter the manifest and never changes the
+ * manifest digest. Unsafe paths, symlink/reparse points, non-regular files,
+ * and concurrent mutation fail toward typed results; transient classes
+ * (HEAD timeout/race, capture races, capture deadline) are retryable.
  */
 import * as child_process from 'node:child_process';
 import * as fs from 'node:fs';
-export declare const REVIEWER_TASK_SCOPE_DESCRIPTION = "reviewer-task-files-v1";
+export declare const REVIEWER_TASK_SCOPE_DESCRIPTION = "reviewer-task-files-v2";
+export declare const REVIEWER_TASK_SCOPE_HEADER = "opencode-swarm-reviewer-task-scope-v2";
+export interface ReviewerTaskScopeDeliveryEntry {
+    path: string;
+    mode: 'inline' | 'manual';
+}
 export interface ReviewerTaskScope {
     content: string;
-    description: typeof REVIEWER_TASK_SCOPE_DESCRIPTION;
+    /** Manifest version discriminator — `reviewer-task-files-v2` for live builds; legacy v1 values only reach us from persisted data. */
+    description: string;
     files: string[];
     headSha: string;
+    /** Canonical workspace identity the manifest bytes were captured from. */
+    workspaceIdentity: string;
+    /** Per-file delivery mode — advisory prompt metadata, never part of the digest. */
+    delivery: ReviewerTaskScopeDeliveryEntry[];
     taskId?: string;
     coderCallID?: string;
     generation?: number;
@@ -41,6 +54,17 @@ export interface ResolveReviewerTaskScopeOptions {
     /** Injectable clock used only for deterministic expiry tests. */
     now?: number;
 }
+export type ReviewerScopeBuildFailureCode = 'no_files' | 'too_many_files' | 'invalid_budget' | 'invalid_path' | 'workspace_unresolvable' | 'head_timeout' | 'head_changed' | 'outside_workspace' | 'symlink_or_reparse' | 'non_regular' | 'unreadable' | 'file_changed_during_capture' | 'capture_deadline';
+export type ReviewerScopeBuildResult = {
+    ok: true;
+    scope: ReviewerTaskScope;
+} | {
+    ok: false;
+    code: ReviewerScopeBuildFailureCode;
+    retryable: boolean;
+    file?: string;
+    detail?: string;
+};
 /**
  * Resolve the exact known plan task carried by reviewer/coder Task arguments.
  *
@@ -58,14 +82,17 @@ export declare function resolveReviewerScopeTaskId(directory: string, args: unkn
 export declare const _internals: {
     spawn: typeof child_process.spawn;
     realpath: typeof fs.promises.realpath;
-    lstatBigInt: (path: fs.PathLike) => Promise<fs.BigIntStats>;
-    open: typeof fs.promises.open;
-    fileHandleStatBigInt: (handle: fs.promises.FileHandle) => Promise<fs.BigIntStats>;
 };
 /**
- * Build the exact scope fingerprint input for a guardrails-observed file list.
+ * Build the exact reviewer-task manifest for a guardrails-observed file list.
+ *
+ * Every regular file contributes its COMPLETE byte count and SHA-256 (streamed
+ * capture); the payload budget only selects per-file delivery mode. Transient
+ * failures return typed retryable results; the caller owns bounded retry.
  */
-export declare function buildReviewerTaskScope(directory: string, modifiedFiles: readonly string[], maxBytes?: number, provenance?: ReviewerTaskScopeProvenance): Promise<ReviewerTaskScope | null>;
+export declare function buildReviewerTaskScope(directory: string, modifiedFiles: readonly string[], maxBytes?: number, provenance?: ReviewerTaskScopeProvenance, options?: {
+    deadlineAt?: number;
+}): Promise<ReviewerScopeBuildResult>;
 /**
  * Resolve scope only from the architect session's guardrails-owned task state.
  * Receipt collection consumes the completed coder handoff exactly once; direct