opencode-swarm 7.126.0 → 7.126.2

package/dist/cli/{index-r1gdkn2d.js → index-vcqwhe9d.js}

@@ -60,19 +60,35 @@ var init_tool_metadata = __esm(() => {
         "critic_oversight",
         "coder",
         "test_engineer"
-      ]
+      ],
+      prWorkflow: {
+        modes: ["PR_REVIEW", "PR_FEEDBACK"],
+        capability: "observe"
+      }
     },
     diff_summary: {
       description: "filter classified AST changes by category, risk level, or file for reviewer drill-down",
-      agents: ["architect", "reviewer", "critic_oversight"]
+      agents: ["architect", "reviewer", "critic_oversight"],
+      prWorkflow: {
+        modes: ["PR_REVIEW", "PR_FEEDBACK"],
+        capability: "observe"
+      }
     },
     syntax_check: {
       description: "check syntax of source files using tree-sitter parsers across multiple languages, returning per-file errors",
-      agents: ["architect", "coder", "test_engineer"]
+      agents: ["architect", "coder", "test_engineer"],
+      prWorkflow: {
+        modes: ["PR_REVIEW"],
+        capability: "validate"
+      }
     },
     placeholder_scan: {
       description: "todo and FIXME comment detection",
-      agents: ["architect", "reviewer"]
+      agents: ["architect", "reviewer"],
+      prWorkflow: {
+        modes: ["PR_REVIEW", "PR_FEEDBACK"],
+        capability: "observe"
+      }
     },
     imports: {
       description: "find all consumers that import from a given file \u2014 use before refactoring shared modules to avoid breaking unseen dependents",
@@ -89,19 +105,35 @@ var init_tool_metadata = __esm(() => {
         "critic",
         "coder",
         "test_engineer"
-      ]
+      ],
+      prWorkflow: {
+        modes: ["PR_REVIEW", "PR_FEEDBACK"],
+        capability: "observe"
+      }
     },
     lint: {
       description: "run project linter in check or fix mode; supports biome, eslint, ruff, clippy, and more, returns structured results",
-      agents: ["architect", "reviewer", "coder"]
+      agents: ["architect", "reviewer", "coder"],
+      prWorkflow: {
+        modes: ["PR_REVIEW"],
+        capability: "validate"
+      }
     },
     secretscan: {
       description: "scan for secrets (API keys, tokens, passwords) via regex and entropy; returns redacted previews, excludes common dirs",
-      agents: ["architect", "reviewer", "critic_oversight"]
+      agents: ["architect", "reviewer", "critic_oversight"],
+      prWorkflow: {
+        modes: ["PR_REVIEW"],
+        capability: "validate"
+      }
     },
     sast_scan: {
       description: "static analysis security scan",
-      agents: ["architect", "reviewer", "critic_oversight"]
+      agents: ["architect", "reviewer", "critic_oversight"],
+      prWorkflow: {
+        modes: ["PR_REVIEW"],
+        capability: "validate"
+      }
     },
     build_check: {
       description: "discover and run build, typecheck, and test commands for various project ecosystems in the working directory",
@@ -113,7 +145,11 @@ var init_tool_metadata = __esm(() => {
     },
     quality_budget: {
       description: "code quality budget check",
-      agents: ["architect"]
+      agents: ["architect"],
+      prWorkflow: {
+        modes: ["PR_REVIEW"],
+        capability: "validate"
+      }
     },
     symbols: {
       description: "extract exported symbols (functions, classes, interfaces, types) from source files; supports TypeScript, JavaScript, and Python",
@@ -152,11 +188,19 @@ var init_tool_metadata = __esm(() => {
     },
     schema_drift: {
       description: "OpenAPI spec vs route drift",
-      agents: ["architect", "sme", "researcher", "docs", "explorer"]
+      agents: ["architect", "sme", "researcher", "docs", "explorer"],
+      prWorkflow: {
+        modes: ["PR_REVIEW", "PR_FEEDBACK"],
+        capability: "observe"
+      }
     },
     todo_extract: {
       description: "structured TODO/FIXME extraction",
-      agents: ["architect", "researcher", "docs", "explorer"]
+      agents: ["architect", "researcher", "docs", "explorer"],
+      prWorkflow: {
+        modes: ["PR_REVIEW", "PR_FEEDBACK"],
+        capability: "observe"
+      }
     },
     evidence_check: {
       description: "verify task evidence completeness",
@@ -178,6 +222,10 @@ var init_tool_metadata = __esm(() => {
       description: "abort an unrecoverable PR_REVIEW/PR_FEEDBACK mechanical gate and clear its durable session state",
       agents: ["architect"]
     },
+    prepare_pr_workflow_checkout: {
+      description: "preserve explicit dirty tracked files before an unbound PR workflow checkout with an auditable recovery receipt",
+      agents: ["architect"]
+    },
     run_pr_feedback_stage_a: {
       description: "execute and persist mandatory PR-feedback Stage A checks on a content-bound revision",
       agents: ["architect"]
@@ -210,7 +258,11 @@ var init_tool_metadata = __esm(() => {
         "reviewer",
         "critic_oversight",
         "test_engineer"
-      ]
+      ],
+      prWorkflow: {
+        modes: ["PR_REVIEW"],
+        capability: "validate"
+      }
     },
     parse_lane_candidates: {
       description: "Parse [CANDIDATE] rows from a dispatch_lanes or collect_lane_results artifact (by output_ref), produce structured records with provenance, optionally persist to a per-batch sidecar JSONL. Pure-parser variant exists as internal module.",
@@ -220,13 +272,29 @@ var init_tool_metadata = __esm(() => {
       description: "persist the complete PR-review trigger evaluation with exact-set validation, dispatch provenance, and live merge-base verification",
       agents: ["architect"]
     },
+    write_pr_review_artifact: {
+      description: "persist schema-validated PR-review findings checkpoints and exact actionable feedback handoffs under the active run",
+      agents: ["architect"]
+    },
+    prepare_pr_feedback_scope: {
+      description: "prepare an exact file scope for one PR-feedback coder Task after immutable feedback verification settles",
+      agents: ["architect"]
+    },
     test_runner: {
       description: "auto-detect and run tests",
-      agents: ["architect", "reviewer", "test_engineer"]
+      agents: ["architect", "reviewer", "test_engineer"],
+      prWorkflow: {
+        modes: ["PR_REVIEW"],
+        capability: "validate"
+      }
     },
     test_impact: {
       description: "identify test files impacted by changed source files via import analysis",
-      agents: ["architect", "reviewer", "critic_oversight", "test_engineer"]
+      agents: ["architect", "reviewer", "critic_oversight", "test_engineer"],
+      prWorkflow: {
+        modes: ["PR_REVIEW", "PR_FEEDBACK"],
+        capability: "observe"
+      }
     },
     mutation_test: {
       description: "executes pre-generated mutation patches against tests, evaluates kill rate against quality gate thresholds",
@@ -253,11 +321,19 @@ var init_tool_metadata = __esm(() => {
     },
     git_blame: {
       description: "per-line git blame metadata: sha, author, date, summary for each line in a file",
-      agents: ["reviewer", "explorer", "architect"]
+      agents: ["reviewer", "explorer", "architect"],
+      prWorkflow: {
+        modes: ["PR_REVIEW", "PR_FEEDBACK"],
+        capability: "observe"
+      }
     },
     gitingest: {
       description: "fetch a GitHub repository full content via gitingest.com",
-      agents: ["architect", "docs", "explorer"]
+      agents: ["architect", "docs", "explorer"],
+      prWorkflow: {
+        modes: ["PR_REVIEW", "PR_FEEDBACK"],
+        capability: "observe"
+      }
     },
     retrieve_summary: {
       description: "retrieve the full content of a stored tool output summary",
@@ -280,7 +356,11 @@ var init_tool_metadata = __esm(() => {
     },
     retrieve_lane_output: {
       description: "retrieve paged full dispatch lane output by output_ref; use before consuming truncated lane previews or routing candidates from lane results",
-      agents: ["architect"]
+      agents: ["architect"],
+      prWorkflow: {
+        modes: ["PR_REVIEW", "PR_FEEDBACK"],
+        capability: "observe"
+      }
     },
     extract_code_blocks: {
       description: "extract code blocks from text content and save them to files",
@@ -427,15 +507,27 @@ var init_tool_metadata = __esm(() => {
     },
     actionlint_scan: {
       description: "Run actionlint against GitHub Actions workflow YAML files with structured findings. Resolves actionlint lazily and does not modify files.",
-      agents: ["architect", "test_engineer"]
+      agents: ["architect", "test_engineer"],
+      prWorkflow: {
+        modes: ["PR_REVIEW"],
+        capability: "validate"
+      }
     },
     osv_scan: {
       description: "Run OSV-Scanner against a workspace path and return structured dependency vulnerability findings. Resolves osv-scanner lazily and does not modify files.",
-      agents: ["architect", "test_engineer"]
+      agents: ["architect", "test_engineer"],
+      prWorkflow: {
+        modes: ["PR_REVIEW"],
+        capability: "validate"
+      }
     },
     gh_evidence: {
       description: "Fetch bounded GitHub pull request or issue metadata through gh for review and CI evidence. Resolves gh lazily and is read-only.",
-      agents: ["architect", "researcher"]
+      agents: ["architect", "researcher"],
+      prWorkflow: {
+        modes: ["PR_REVIEW", "PR_FEEDBACK"],
+        capability: "observe"
+      }
     },
     batch_symbols: {
       description: "Batched symbol extraction across multiple files. Returns per-file symbol summaries with isolated error handling.",
@@ -479,7 +571,11 @@ var init_tool_metadata = __esm(() => {
         "critic_oversight",
         "explorer",
         "coder"
-      ]
+      ],
+      prWorkflow: {
+        modes: ["PR_REVIEW", "PR_FEEDBACK"],
+        capability: "observe"
+      }
     },
     get_qa_gate_profile: {
       description: "retrieve the QA gate profile for the current plan: gates (reviewer, test_engineer, sme_enabled, critic_pre_plan, sast_enabled, council_mode, hallucination_guard, mutation_test, phase_council, drift_check, final_council), lock state, and profile hash. Read-only.",

package/dist/cli/{index-g4ef4v3m.js → index-w9cb5zwh.js}

@@ -39,7 +39,7 @@ var _internals = {
     symlinkSync: fs.symlinkSync
   },
   writeScopeToDisk: async (directory, taskId, files) => {
-    const { writeScopeToDisk: realWrite } = await import("./scope-persistence-habn4q8a.js");
+    const { writeScopeToDisk: realWrite } = await import("./scope-persistence-dm5bab50.js");
     return realWrite(directory, taskId, files);
   },
   writeLaneProfileToDisk: async (_worktreePath, _laneIndex, _envOverrides) => {

package/dist/cli/{index-y4ry07h8.js → index-z8ftpav0.js}

@@ -12,14 +12,14 @@ import {
   detectPosixWrites,
   detectWindowsWrites,
   resolveWriteTargets
-} from "./index-0ff5cm9j.js";
+} from "./index-d88y17ht.js";
 import {
   checkFileAuthority,
   classifyFile,
   isInDeclaredScope,
   redactPath,
   redactShellCommand
-} from "./index-dezgmvtw.js";
+} from "./index-gxw20m1d.js";
 
 // src/services/guardrail-explain-service.ts
 import path from "path";

package/dist/cli/index.js

@@ -7,41 +7,41 @@ import {
   getPluginLockFilePaths,
   package_default,
   resolveCommand
-} from "./index-0ff5cm9j.js";
-import"./index-dezgmvtw.js";
-import"./index-jt7hnr7q.js";
+} from "./index-d88y17ht.js";
+import"./index-gxw20m1d.js";
+import"./index-3xd9a2g7.js";
 import"./index-kk1scggc.js";
 import"./index-4905hd2m.js";
 import"./index-134d35c1.js";
 import"./index-6n2jpz7x.js";
-import"./index-yfzn5r9s.js";
-import"./index-bcgfhxzv.js";
-import"./index-cdx337js.js";
+import"./index-7bxw3v5w.js";
+import"./index-f97dm6tz.js";
+import"./index-pf3xae4s.js";
 import"./index-vxv732ex.js";
 import"./index-c8s9a3zh.js";
 import"./index-9ss2m4rs.js";
 import"./index-23zsx7dm.js";
-import"./index-kwnsatzq.js";
-import"./index-mgrsx5hn.js";
+import"./index-88dt7c9z.js";
+import"./index-gwss5btk.js";
 import"./index-rtry5xyf.js";
-import"./index-2yd75hms.js";
-import"./index-2bnfwmk3.js";
+import"./index-pb8ag9vg.js";
+import"./index-nqp13m5a.js";
 import"./index-ae75rja9.js";
 import"./index-q27bajqb.js";
-import"./index-a1c9az5e.js";
+import"./index-gf9cxvp0.js";
 import"./index-k5jrywpr.js";
 import"./index-n832052r.js";
 import {
   DEFAULT_AGENT_CONFIGS,
   init_constants
-} from "./index-r1gdkn2d.js";
+} from "./index-vcqwhe9d.js";
 import"./index-bk5tah7q.js";
 import"./index-8fwhhayc.js";
 import"./index-q1exe2b3.js";
-import"./index-gnvg72y1.js";
+import"./index-4ff0x4cg.js";
 import"./index-2tn5h2zp.js";
 import"./index-1kz6da87.js";
-import"./index-g4ef4v3m.js";
+import"./index-w9cb5zwh.js";
 import"./index-4rhhvd1a.js";
 import"./index-0cz1ws47.js";
 import"./index-2445sx3d.js";

package/dist/cli/{knowledge-escalator-4hc8w7sd.js → knowledge-escalator-nna0zec3.js}

@@ -8,9 +8,9 @@ import {
   maybeEscalateOnViolation,
   maybeQuarantineOnContradiction,
   readRecentEscalations
-} from "./index-bcgfhxzv.js";
-import"./index-2yd75hms.js";
-import"./index-2bnfwmk3.js";
+} from "./index-f97dm6tz.js";
+import"./index-pb8ag9vg.js";
+import"./index-nqp13m5a.js";
 import"./index-ae75rja9.js";
 import"./index-q27bajqb.js";
 import"./index-bk5tah7q.js";

package/dist/cli/{knowledge-events-kyqjv1f8.js → knowledge-events-7k82xk36.js}

@@ -26,7 +26,7 @@ import {
   resolveKnowledgeCounterBaselinePath,
   resolveKnowledgeEventsPath,
   resolveLegacyApplicationLogPath
-} from "./index-2bnfwmk3.js";
+} from "./index-nqp13m5a.js";
 import"./index-ae75rja9.js";
 import"./index-q27bajqb.js";
 import"./index-zgwm4ryv.js";

package/dist/cli/{knowledge-store-06k0p1gs.js → knowledge-store-efvtng9t.js}

@@ -40,7 +40,7 @@ import {
   transactKnowledge,
   transactKnowledgeWithCas,
   wordBigrams
-} from "./index-2yd75hms.js";
+} from "./index-pb8ag9vg.js";
 import {
   resolveHiveDataDir
 } from "./index-ae75rja9.js";

package/dist/cli/{knowledge-validator-42xjmcmh.js → knowledge-validator-jh93eagj.js}

@@ -23,11 +23,11 @@ import {
   validateLesson,
   validateSkillCandidatePath,
   validateSkillPath
-} from "./index-kwnsatzq.js";
-import"./index-mgrsx5hn.js";
+} from "./index-88dt7c9z.js";
+import"./index-gwss5btk.js";
 import"./index-rtry5xyf.js";
-import"./index-2yd75hms.js";
-import"./index-2bnfwmk3.js";
+import"./index-pb8ag9vg.js";
+import"./index-nqp13m5a.js";
 import"./index-ae75rja9.js";
 import"./index-q27bajqb.js";
 import"./index-bk5tah7q.js";

package/dist/cli/{scan-cursor-gjcvpyta.js → scan-cursor-cydz8d9q.js}

@@ -4,8 +4,8 @@ import {
   alreadyCuratedThisGeneration,
   claimNextScanBatch,
   getScanStatus
-} from "./index-cdx337js.js";
-import"./index-2yd75hms.js";
+} from "./index-pf3xae4s.js";
+import"./index-pb8ag9vg.js";
 import"./index-ae75rja9.js";
 import"./index-q27bajqb.js";
 import"./index-bk5tah7q.js";

package/dist/cli/{schema-69z8w1ka.js → schema-fa033pqw.js}

@@ -89,7 +89,7 @@ import {
   resolveGeneratedAgentRole,
   resolveGuardrailsConfig,
   stripKnownSwarmPrefix
-} from "./index-r1gdkn2d.js";
+} from "./index-vcqwhe9d.js";
 import"./index-bk5tah7q.js";
 import"./index-zjygnfay.js";
 import"./index-bpmtbmy9.js";

package/dist/cli/{scope-persistence-habn4q8a.js → scope-persistence-dm5bab50.js}

@@ -6,12 +6,13 @@ import {
   readPlanScope,
   readScopeBindingFromDisk,
   readScopeFromDisk,
+  resolveAuthorizedPrFeedbackScopeBindingFromDisk,
   resolveAuthorizedScopeBinding,
   resolveAuthorizedScopeBindingForSession,
   resolveScopeWithFallbacks,
   writeScopeBindingToDisk,
   writeScopeToDisk
-} from "./index-gnvg72y1.js";
+} from "./index-4ff0x4cg.js";
 import"./index-2tn5h2zp.js";
 import"./index-1kz6da87.js";
 import"./index-zgwm4ryv.js";
@@ -27,6 +28,7 @@ export {
   resolveScopeWithFallbacks,
   resolveAuthorizedScopeBindingForSession,
   resolveAuthorizedScopeBinding,
+  resolveAuthorizedPrFeedbackScopeBindingFromDisk,
   readScopeFromDisk,
   readScopeBindingFromDisk,
   readPlanScope,

package/dist/cli/{skill-generator-t6j93mwt.js → skill-generator-8v463kj7.js}

@@ -33,12 +33,12 @@ import {
   sanitizeSlug,
   selectCandidateEntries,
   writeEvalStub
-} from "./index-yfzn5r9s.js";
-import"./index-kwnsatzq.js";
-import"./index-mgrsx5hn.js";
+} from "./index-7bxw3v5w.js";
+import"./index-88dt7c9z.js";
+import"./index-gwss5btk.js";
 import"./index-rtry5xyf.js";
-import"./index-2yd75hms.js";
-import"./index-2bnfwmk3.js";
+import"./index-pb8ag9vg.js";
+import"./index-nqp13m5a.js";
 import"./index-ae75rja9.js";
 import"./index-q27bajqb.js";
 import"./index-bk5tah7q.js";

package/dist/config/index.d.ts

@@ -2,6 +2,7 @@ export type { AgentName, PipelineAgentName, QAAgentName, } from './constants';
 export { ALL_AGENT_NAMES, ALL_SUBAGENT_NAMES, DEFAULT_MODELS, isQAAgent, isSubagent, ORCHESTRATOR_NAME, PIPELINE_AGENTS, QA_AGENTS, } from './constants';
 export type { ApprovalEvidence, BaseEvidence, DiffEvidence, Evidence, EvidenceBundle, EvidenceType, EvidenceVerdict, NoteEvidence, ReviewEvidence, TestEvidence, } from './evidence-schema';
 export { ApprovalEvidenceSchema, BaseEvidenceSchema, DiffEvidenceSchema, EVIDENCE_MAX_JSON_BYTES, EVIDENCE_MAX_PATCH_BYTES, EVIDENCE_MAX_TASK_BYTES, EvidenceBundleSchema, EvidenceSchema, EvidenceTypeSchema, EvidenceVerdictSchema, NoteEvidenceSchema, ReviewEvidenceSchema, TestEvidenceSchema, } from './evidence-schema';
+export type { ConfigBuildResult, ConfigLoadResult, ConfigRecovery, } from './loader';
 export { loadAgentPrompt, loadPluginConfig, loadPluginConfigWithMeta, loadPluginConfigWithMetaAsync, } from './loader';
 import { loadPluginConfigWithMeta } from './loader';
 /**

package/dist/config/loader.d.ts

@@ -1,26 +1,6 @@
 import type { z } from 'zod';
 import { type PluginConfig } from './schema';
 export declare const MAX_CONFIG_FILE_BYTES = 102400;
-/**
- * Recovery type indicating how the config was recovered from parse failure.
- * - 'none': config parsed cleanly on first attempt
- * - 'stripped_keys': Zod-confirmed unrecognized keys were surgically removed and parse succeeded
- * - 'user_only': project config was ignored (validation error); user config used alone
- * - 'guardrails_defaults': no recovery succeeded; fail-secure guardrails defaults applied
- */
-export type RecoveryType = 'none' | 'stripped_keys' | 'user_only' | 'guardrails_defaults';
-/**
- * Structured recovery metadata returned by parseConfigWithFallback.
- * Exposed via loadPluginConfigWithMeta[Async] so programmatic callers can
- * introspect what recovery was performed.
- */
-export interface RecoveryInfo {
-    recovery: RecoveryType;
-    /** Dotted key paths that were removed during recovery (empty if none were stripped). */
-    removedKeys: string[];
-    /** Human-readable advisory messages describing what recovery was performed. */
-    warnings: string[];
-}
 export { deepMerge, MAX_MERGE_DEPTH } from '../utils/merge';
 /**
  * Flatten a ZodError into a compact, single-line, human-readable summary that
@@ -35,36 +15,71 @@ export { deepMerge, MAX_MERGE_DEPTH } from '../utils/merge';
  * raw dump of the user's config values.
  */
 export declare function formatZodIssues(error: z.ZodError): string;
-export declare function loadPluginConfig(directory: string): PluginConfig;
 /**
- * Internal variant of loadPluginConfig that also returns loader metadata.
- * Used only by src/index.ts to determine guardrails fallback behavior.
- * NOT part of the public API — use loadPluginConfig() for all other callers.
+ * Recovery classification returned by `buildConfigWithMeta`.
+ *
+ *   'none'               – config parsed cleanly, no keys removed.
+ *   'stripped_keys'      – pre-Zod section sanitization (gates, external_skills)
+ *                          and/or Zod-targeted key removal dropped some keys;
+ *                          the remaining configuration was preserved.
+ *   'user_only'          – project config was discarded (failed validation and
+ *                          targeted recovery); user config alone was used.
+ *   'guardrails_defaults'– neither merged nor user config was recoverable;
+ *                          fell back to fail-secure guardrails-only defaults.
  */
-export declare function loadPluginConfigWithMeta(directory: string): {
+export type ConfigRecovery = 'none' | 'stripped_keys' | 'user_only' | 'guardrails_defaults';
+/** Full result from the shared config-build core. */
+export type ConfigBuildResult = {
     config: PluginConfig;
+    recovery: ConfigRecovery;
+    /** Dotted key paths that were removed during recovery (gates, Zod strict, etc.). */
+    removedKeys: string[];
+    /** Human-readable summary messages about the recovery action. */
+    warnings: string[];
+};
+/**
+ * Full result from `loadPluginConfigWithMeta` and `loadPluginConfigWithMetaAsync`.
+ * Extends `ConfigBuildResult` with I/O-layer fields about whether a config
+ * file was found and whether it could be read.
+ */
+export type ConfigLoadResult = ConfigBuildResult & {
+    /** True when at least one config file (user or project) existed on disk. */
     loadedFromFile: boolean;
     /** True when a config file existed but could not be loaded (corrupt JSON,
      *  oversized, permission error). Consumers with fail-closed semantics —
      *  e.g. the Full-Auto `locked` activation guard — must treat this as
      *  "config unknown", not "config defaults". */
     configHadErrors: boolean;
-    recovery: RecoveryType;
-    removedKeys: string[];
-    warnings: string[];
 };
+/**
+ * Load plugin configuration from user and project config files.
+ *
+ * Config locations:
+ * 1. User config: ~/.config/opencode/opencode-swarm.json
+ * 2. Project config: <directory>/.opencode/opencode-swarm.json
+ *
+ * Project config takes precedence. Nested objects are deep-merged, except
+ * `full_auto.locked`: it is a hard-off and OR-merges across both levels, so
+ * `locked: true` at either level cannot be overridden by `locked: false`.
+ * IMPORTANT: Raw configs are merged BEFORE Zod parsing so that
+ * Zod defaults don't override explicit user values.
+ */
+export declare function loadPluginConfig(directory: string): PluginConfig;
+/**
+ * Variant of `loadPluginConfig` that also returns loader metadata, including
+ * recovery classification, removed keys, and warning messages.  All callers
+ * that need to surface config-health information (doctor, command-return) use
+ * this function.  `buildConfigWithMeta` is the shared core — files are read
+ * exactly once, no double-read.
+ */
+export declare function loadPluginConfigWithMeta(directory: string): ConfigLoadResult;
 /**
  * Async variant of `loadPluginConfigWithMeta`. Used by the plugin entry
  * (issue #704) so initialization does not perform synchronous fs reads.
+ * Calls the same `buildConfigWithMeta` shared core as the sync path — the
+ * only difference is that file I/O uses `node:fs/promises` (issue #1900 FR-1).
  */
-export declare function loadPluginConfigWithMetaAsync(directory: string): Promise<{
-    config: PluginConfig;
-    loadedFromFile: boolean;
-    configHadErrors: boolean;
-    recovery: RecoveryType;
-    removedKeys: string[];
-    warnings: string[];
-}>;
+export declare function loadPluginConfigWithMetaAsync(directory: string): Promise<ConfigLoadResult>;
 /**
  * Load custom prompt for an agent from the prompts directory.
  * Checks for {agent}.md (replaces default) and {agent}_append.md (appends).

package/dist/hooks/delegation-gate.d.ts

@@ -269,6 +269,17 @@ interface MessageWithParts {
  */
 export declare function isPlanCriticApproved(directory: string): Promise<boolean>;
 declare function resolveDelegatedPlanTaskId(args: Record<string, unknown>, knownPlanTaskIds?: ReadonlySet<string>): string | null;
+/**
+ * Builds a cause-specific diagnostic for `prepareCoderScope`'s SCOPE_NOT_DECLARED
+ * throw when `resolveDelegatedPlanTaskId` returns null. Re-runs extraction with
+ * diagnostics enabled so the architect can self-correct in one turn instead of
+ * guessing. Issue #1914 Defect 2.
+ *
+ * Only invoked on the null-resolution failure path — does not affect happy-path
+ * latency, and does NOT handle plan-task-shaped-but-unknown ids (those are
+ * rejected by the membership gate in prepareCoderScope with their own message).
+ */
+declare function describeCoderScopeFailure(args: Record<string, unknown>, planTaskIds: ReadonlySet<string>): string;
 /**
  * Parses structured per-task verdict lines from agent dispatch output.
  *
@@ -299,8 +310,8 @@ declare function buildParallelExecutionGuidance(directory: string | undefined, s
 declare function resolveEvidenceTaskId(args: Record<string, unknown> | undefined, session: AgentSessionState, directory: string): Promise<string | null>;
 /**
  * _internals export for testing — do not use in production code.
- * Exposes resolveEvidenceTaskId, resolveDelegatedPlanTaskId, and
- * buildParallelExecutionGuidance for unit testing.
+ * Exposes resolveEvidenceTaskId, resolveDelegatedPlanTaskId,
+ * describeCoderScopeFailure, and buildParallelExecutionGuidance for unit testing.
  *
  * Worktree operation entries (provisionWorktree, removeWorktree, etc.) proxy
  * to delegation-gate/worktree-isolation._internals via getters/setters so
@@ -309,6 +320,7 @@ declare function resolveEvidenceTaskId(args: Record<string, unknown> | undefined
 export declare const _internals: {
     resolveEvidenceTaskId: typeof resolveEvidenceTaskId;
     resolveDelegatedPlanTaskId: typeof resolveDelegatedPlanTaskId;
+    describeCoderScopeFailure: typeof describeCoderScopeFailure;
     parsePerTaskVerdicts: typeof parsePerTaskVerdicts;
     buildParallelExecutionGuidance: typeof buildParallelExecutionGuidance;
     loadPlanJsonOnly: typeof loadPlanJsonOnly;