opencode-swarm 7.126.0 → 7.126.2

package/dist/scope/scope-binding.d.ts

@@ -1,6 +1,6 @@
 import type { Plan } from '../config/plan-schema';
 export declare const MAX_PENDING_SCOPE_BINDINGS = 256;
-export type ScopeBindingSource = 'declare_scope' | 'plan' | 'file_directive' | 'worktree_derived';
+export type ScopeBindingSource = 'declare_scope' | 'plan' | 'file_directive' | 'pr_feedback' | 'worktree_derived';
 export interface ScopeBinding {
     version: 2;
     workspaceIdentity: string;
@@ -14,6 +14,9 @@ export interface ScopeBinding {
     activation: 'declaration' | 'pending_child' | 'active';
     parentOwnerSessionId?: string;
     parentCallId?: string;
+    /** PR_FEEDBACK bindings carry their parent workflow identity and revision. */
+    workflowSessionId?: string;
+    workflowRevisionDigest?: string;
     source: ScopeBindingSource;
     files: string[];
     declaredAt: number;
@@ -28,7 +31,7 @@ export declare function createScopeBinding(input: {
     files: readonly string[];
     ownerSessionId: string;
     ownerMessageId: string;
-    source: Exclude<ScopeBindingSource, 'worktree_derived'>;
+    source: Exclude<ScopeBindingSource, 'pr_feedback' | 'worktree_derived'>;
     dispatchCallId?: string;
     activation?: ScopeBinding['activation'];
     ttlMs?: number;
@@ -41,6 +44,22 @@ export declare function getScopeBinding(input: {
     ownerSessionId: string;
     ownerMessageId?: string;
 }): ScopeBinding | null;
+export declare function createPrFeedbackScopeBinding(input: {
+    directory: string;
+    taskId: string;
+    files: readonly string[];
+    ownerSessionId: string;
+    ownerMessageId: string;
+    workflowSessionId: string;
+    workflowRevisionDigest: string;
+    dispatchCallId?: string;
+    activation?: ScopeBinding['activation'];
+}): ScopeBinding | null;
+export declare function getAuthorizedPrFeedbackScopeBinding(input: {
+    directory: string;
+    activeSessionId: string;
+    taskId?: string;
+}): ScopeBinding | null;
 /** Resolve the one Task-correlated authorization for an executing coder. */
 export declare function getAuthorizedScopeBinding(input: {
     directory: string;

package/dist/scope/scope-persistence.d.ts

@@ -105,6 +105,12 @@ export declare function resolveAuthorizedScopeBindingForSession(input: {
     directory: string;
     activeSessionId: string;
 }): ScopeBinding | null;
+/** Recover one exact planless PR_FEEDBACK child binding after plugin restart. */
+export declare function resolveAuthorizedPrFeedbackScopeBindingFromDisk(input: {
+    directory: string;
+    activeSessionId: string;
+    taskId?: string;
+}): ScopeBinding | null;
 /**
  * Read persisted scope for a task. Returns null on:
  *   - file missing

package/dist/tools/index.d.ts

@@ -49,6 +49,7 @@ export { phase_complete } from './phase-complete';
 export { pkg_audit } from './pkg-audit';
 export { type PlaceholderFinding, type PlaceholderScanInput, type PlaceholderScanResult, placeholder_scan, placeholderScan, } from './placeholder-scan';
 export { type PreCheckBatchInput, type PreCheckBatchResult, pre_check_batch, runPreCheckBatch, type ToolResult, } from './pre-check-batch';
+export { executePreparePrFeedbackScope, prepare_pr_feedback_scope, } from './prepare-pr-feedback-scope';
 export { type QualityBudgetInput, type QualityBudgetResult, quality_budget, qualityBudget, } from './quality-budget';
 export { buildWorkspaceGraph, type GraphEdge, type GraphNode, loadGraph, loadOrCreateGraph, type RepoGraph, resolveModuleSpecifier, saveGraph, updateGraphForFiles, } from './repo-graph';
 export { repo_map } from './repo-map';
@@ -100,6 +101,7 @@ export { lean_turbo_runner_status } from './lean-turbo-runner-status';
 export { lean_turbo_status } from './lean-turbo-status';
 export { lint_spec } from './lint-spec';
 export { mutation_test } from './mutation-test';
+export { executePreparePrWorkflowCheckout, prepare_pr_workflow_checkout, } from './prepare-pr-workflow-checkout';
 export { executeRunPrFeedbackStageA, run_pr_feedback_stage_a, } from './run-pr-feedback-stage-a';
 export { symbols } from './symbols';
 export { type SyntaxCheckFileResult, type SyntaxCheckInput, type SyntaxCheckResult, syntax_check, syntaxCheck, } from './syntax-check';
@@ -113,5 +115,6 @@ export { write_drift_evidence } from './write-drift-evidence';
 export { write_final_council_evidence } from './write-final-council-evidence';
 export { write_hallucination_evidence } from './write-hallucination-evidence';
 export { write_mutation_evidence } from './write-mutation-evidence';
+export { executeWritePrReviewArtifact, write_pr_review_artifact, } from './write-pr-review-artifact';
 export { executeWritePrReviewTriggerEval, PR_REVIEW_TRIGGER_DEFINITIONS, write_pr_review_trigger_eval, } from './write-pr-review-trigger-eval';
 export { executeWriteRetro, write_retro } from './write-retro';

package/dist/tools/manifest.d.ts

@@ -44,6 +44,7 @@ export declare const TOOL_MANIFEST: {
     completion_verify: () => ToolDefinition;
     complete_pr_workflow: () => ToolDefinition;
     abort_pr_workflow: () => ToolDefinition;
+    prepare_pr_workflow_checkout: () => ToolDefinition;
     run_pr_feedback_stage_a: () => ToolDefinition;
     submit_council_verdicts: () => ToolDefinition;
     submit_phase_council_verdicts: () => ToolDefinition;
@@ -52,6 +53,8 @@ export declare const TOOL_MANIFEST: {
     checkpoint: () => ToolDefinition;
     pkg_audit: () => ToolDefinition;
     parse_lane_candidates: () => ToolDefinition;
+    prepare_pr_feedback_scope: () => ToolDefinition;
+    write_pr_review_artifact: () => ToolDefinition;
     write_pr_review_trigger_eval: () => ToolDefinition;
     test_runner: () => ToolDefinition;
     test_impact: () => ToolDefinition;

package/dist/tools/prepare-pr-feedback-scope.d.ts

@@ -0,0 +1,5 @@
+import { createSwarmTool } from './create-tool.js';
+export declare function executePreparePrFeedbackScope(args: unknown, directory: string, context?: {
+    sessionID?: string;
+}): Promise<string>;
+export declare const prepare_pr_feedback_scope: ReturnType<typeof createSwarmTool>;

package/dist/tools/prepare-pr-workflow-checkout.d.ts

@@ -0,0 +1,25 @@
+import { createSwarmTool } from './create-tool.js';
+/**
+ * Preserve explicit dirty tracked files before the unbound PR checkout.
+ *
+ * The tool uses the canonical gate's cross-process mutation lock and
+ * schema-validated state, so an abort, bind, or same-session reactivation
+ * cannot revoke or replace authorization while the fixed Git command runs.
+ * The independent receipt is retained under `.swarm/` after terminal gate
+ * cleanup so the exact stash recovery command remains auditable.
+ */
+export declare function executePreparePrWorkflowCheckout(args: unknown, directory: string, context?: {
+    sessionID?: string;
+}): Promise<string>;
+declare function runGit(directory: string, args: string[], options?: {
+    captureStdout?: boolean;
+}): Promise<{
+    exitCode: number;
+    stdout: string;
+}>;
+/** Test-only seam for serializing concurrent real-Git checkout preparation. */
+export declare const _internals: {
+    runGit: typeof runGit;
+};
+export declare const prepare_pr_workflow_checkout: ReturnType<typeof createSwarmTool>;
+export {};

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

@@ -21,6 +21,11 @@ export interface ToolMeta {
     description: string;
     /** Agents granted this tool by default (inverted into AGENT_TOOL_MAP). Empty = overlay-only. */
     agents: AgentName[];
+    /** Explicit PR-workflow capability. Omitted tools remain fail-closed. */
+    prWorkflow?: {
+        modes: Array<'PR_REVIEW' | 'PR_FEEDBACK'>;
+        capability: 'observe' | 'validate';
+    };
 }
 /**
  * The registry metadata. Keys are the canonical tool names; `ToolName` derives
@@ -30,34 +35,66 @@ export declare const TOOL_METADATA: {
     diff: {
         description: string;
         agents: ("reviewer" | "test_engineer" | "coder" | "critic_oversight" | "architect")[];
+        prWorkflow: {
+            modes: ("PR_REVIEW" | "PR_FEEDBACK")[];
+            capability: "observe";
+        };
     };
     diff_summary: {
         description: string;
         agents: ("reviewer" | "critic_oversight" | "architect")[];
+        prWorkflow: {
+            modes: ("PR_REVIEW" | "PR_FEEDBACK")[];
+            capability: "observe";
+        };
     };
     syntax_check: {
         description: string;
         agents: ("test_engineer" | "coder" | "architect")[];
+        prWorkflow: {
+            modes: "PR_REVIEW"[];
+            capability: "validate";
+        };
     };
     placeholder_scan: {
         description: string;
         agents: ("reviewer" | "architect")[];
+        prWorkflow: {
+            modes: ("PR_REVIEW" | "PR_FEEDBACK")[];
+            capability: "observe";
+        };
     };
     imports: {
         description: string;
         agents: ("reviewer" | "test_engineer" | "coder" | "docs" | "sme" | "critic" | "critic_sounding_board" | "critic_drift_verifier" | "critic_hallucination_verifier" | "architect" | "researcher" | "docs_design")[];
+        prWorkflow: {
+            modes: ("PR_REVIEW" | "PR_FEEDBACK")[];
+            capability: "observe";
+        };
     };
     lint: {
         description: string;
         agents: ("reviewer" | "coder" | "architect")[];
+        prWorkflow: {
+            modes: "PR_REVIEW"[];
+            capability: "validate";
+        };
     };
     secretscan: {
         description: string;
         agents: ("reviewer" | "critic_oversight" | "architect")[];
+        prWorkflow: {
+            modes: "PR_REVIEW"[];
+            capability: "validate";
+        };
     };
     sast_scan: {
         description: string;
         agents: ("reviewer" | "critic_oversight" | "architect")[];
+        prWorkflow: {
+            modes: "PR_REVIEW"[];
+            capability: "validate";
+        };
     };
     build_check: {
         description: string;
@@ -70,6 +107,10 @@ export declare const TOOL_METADATA: {
     quality_budget: {
         description: string;
         agents: "architect"[];
+        prWorkflow: {
+            modes: "PR_REVIEW"[];
+            capability: "validate";
+        };
     };
     symbols: {
         description: string;
@@ -82,10 +123,18 @@ export declare const TOOL_METADATA: {
     schema_drift: {
         description: string;
         agents: ("docs" | "explorer" | "sme" | "architect" | "researcher")[];
+        prWorkflow: {
+            modes: ("PR_REVIEW" | "PR_FEEDBACK")[];
+            capability: "observe";
+        };
     };
     todo_extract: {
         description: string;
         agents: ("docs" | "explorer" | "architect" | "researcher")[];
+        prWorkflow: {
+            modes: ("PR_REVIEW" | "PR_FEEDBACK")[];
+            capability: "observe";
+        };
     };
     evidence_check: {
         description: string;
@@ -107,6 +156,10 @@ export declare const TOOL_METADATA: {
         description: string;
         agents: "architect"[];
     };
+    prepare_pr_workflow_checkout: {
+        description: string;
+        agents: "architect"[];
+    };
     run_pr_feedback_stage_a: {
         description: string;
         agents: "architect"[];
@@ -134,6 +187,10 @@ export declare const TOOL_METADATA: {
     pkg_audit: {
         description: string;
         agents: ("reviewer" | "test_engineer" | "critic_hallucination_verifier" | "critic_oversight" | "architect")[];
+        prWorkflow: {
+            modes: "PR_REVIEW"[];
+            capability: "validate";
+        };
     };
     parse_lane_candidates: {
         description: string;
@@ -143,13 +200,29 @@ export declare const TOOL_METADATA: {
         description: string;
         agents: "architect"[];
     };
+    write_pr_review_artifact: {
+        description: string;
+        agents: "architect"[];
+    };
+    prepare_pr_feedback_scope: {
+        description: string;
+        agents: "architect"[];
+    };
     test_runner: {
         description: string;
         agents: ("reviewer" | "test_engineer" | "architect")[];
+        prWorkflow: {
+            modes: "PR_REVIEW"[];
+            capability: "validate";
+        };
     };
     test_impact: {
         description: string;
         agents: ("reviewer" | "test_engineer" | "critic_oversight" | "architect")[];
+        prWorkflow: {
+            modes: ("PR_REVIEW" | "PR_FEEDBACK")[];
+            capability: "observe";
+        };
     };
     mutation_test: {
         description: string;
@@ -166,10 +239,18 @@ export declare const TOOL_METADATA: {
     git_blame: {
         description: string;
         agents: ("reviewer" | "explorer" | "architect")[];
+        prWorkflow: {
+            modes: ("PR_REVIEW" | "PR_FEEDBACK")[];
+            capability: "observe";
+        };
     };
     gitingest: {
         description: string;
         agents: ("docs" | "explorer" | "architect")[];
+        prWorkflow: {
+            modes: ("PR_REVIEW" | "PR_FEEDBACK")[];
+            capability: "observe";
+        };
     };
     retrieve_summary: {
         description: string;
@@ -178,6 +259,10 @@ export declare const TOOL_METADATA: {
     retrieve_lane_output: {
         description: string;
         agents: "architect"[];
+        prWorkflow: {
+            modes: ("PR_REVIEW" | "PR_FEEDBACK")[];
+            capability: "observe";
+        };
     };
     extract_code_blocks: {
         description: string;
@@ -266,14 +351,26 @@ export declare const TOOL_METADATA: {
     actionlint_scan: {
         description: string;
         agents: ("test_engineer" | "architect")[];
+        prWorkflow: {
+            modes: "PR_REVIEW"[];
+            capability: "validate";
+        };
     };
     osv_scan: {
         description: string;
         agents: ("test_engineer" | "architect")[];
+        prWorkflow: {
+            modes: "PR_REVIEW"[];
+            capability: "validate";
+        };
     };
     gh_evidence: {
         description: string;
         agents: ("architect" | "researcher")[];
+        prWorkflow: {
+            modes: ("PR_REVIEW" | "PR_FEEDBACK")[];
+            capability: "observe";
+        };
     };
     batch_symbols: {
         description: string;
@@ -294,6 +391,10 @@ export declare const TOOL_METADATA: {
     repo_map: {
         description: string;
         agents: ("reviewer" | "coder" | "explorer" | "critic" | "critic_sounding_board" | "critic_drift_verifier" | "critic_hallucination_verifier" | "critic_architecture_supervisor" | "critic_oversight" | "architect")[];
+        prWorkflow: {
+            modes: ("PR_REVIEW" | "PR_FEEDBACK")[];
+            capability: "observe";
+        };
     };
     get_qa_gate_profile: {
         description: string;
@@ -470,6 +571,7 @@ export type ToolName = keyof typeof TOOL_METADATA;
 export declare const TOOL_NAMES: readonly ToolName[];
 /** Set for O(1) tool name validation. */
 export declare const TOOL_NAME_SET: ReadonlySet<ToolName>;
+export declare function getPrWorkflowToolCapability(toolName: string, mode: 'PR_REVIEW' | 'PR_FEEDBACK'): 'observe' | 'validate' | null;
 /** Human-readable descriptions, keyed by tool name. */
 export declare const TOOL_DESCRIPTIONS: Partial<Record<ToolName, string>>;
 /**

package/dist/tools/write-pr-review-artifact.d.ts

@@ -0,0 +1,5 @@
+import { createSwarmTool } from './create-tool.js';
+export declare function executeWritePrReviewArtifact(args: unknown, directory: string, context?: {
+    sessionID?: string;
+}): Promise<string>;
+export declare const write_pr_review_artifact: ReturnType<typeof createSwarmTool>;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "opencode-swarm",
-	"version": "7.126.0",
+	"version": "7.126.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",
@@ -106,8 +106,8 @@
 		"repro:1873": "bun build scripts/repro-1873-entry.ts --outdir dist-build-test/repro-1873 --target node --format esm && node scripts/repro-1873.mjs"
 	},
 	"dependencies": {
-		"@opencode-ai/plugin": "^1.1.53",
-		"@opencode-ai/sdk": "^1.1.53",
+		"@opencode-ai/plugin": "^1.18.3",
+		"@opencode-ai/sdk": "^1.18.3",
 		"@vscode/tree-sitter-wasm": "^0.3.0",
 		"bash-parser": "^0.5.0",
 		"p-limit": "^7.3.0",