@xzzpig/pi-subagents 0.8.0 → 0.10.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (221) hide show
  1. package/CHANGELOG.md +477 -0
  2. package/README.md +2 -2
  3. package/agents/claude-code-writer.md +15 -0
  4. package/agents/claude-code.md +15 -0
  5. package/agents/codex-exec-writer.md +15 -0
  6. package/agents/codex-exec.md +15 -0
  7. package/agents/cursor-agent-writer.md +14 -0
  8. package/agents/cursor-agent.md +14 -0
  9. package/agents/reviewer.md +1 -1
  10. package/agents/scout.md +1 -1
  11. package/docs/agents.md +195 -39
  12. package/docs/configuration.md +81 -22
  13. package/docs/extension-api.md +69 -14
  14. package/docs/missions.md +2 -0
  15. package/docs/models.md +32 -9
  16. package/docs/observability.md +22 -20
  17. package/docs/tool-reference.md +123 -14
  18. package/docs/watchdog.md +92 -114
  19. package/docs/workflows.md +142 -4
  20. package/install.mjs +1 -1
  21. package/package.json +7 -6
  22. package/prompts/review-loop.md +2 -2
  23. package/skills/council-mode/SKILL.md +48 -243
  24. package/skills/council-mode/references/pass-contracts.md +150 -0
  25. package/skills/pi-subagents/SKILL.md +89 -35
  26. package/skills/pi-subagents/references/constraints-and-recipes.md +30 -234
  27. package/skills/pi-subagents/references/execution-controls.md +91 -15
  28. package/skills/pi-subagents/references/management-authoring-rpc.md +5 -5
  29. package/skills/pi-subagents/references/multi-lane-orchestration.md +13 -1
  30. package/skills/pi-subagents/references/prompting-and-roles.md +59 -31
  31. package/skills/pi-subagents/references/review-and-validation.md +73 -0
  32. package/src/agents/agent-management.ts +384 -115
  33. package/src/agents/agent-refinements.ts +4 -4
  34. package/src/agents/agent-serializer.ts +14 -2
  35. package/src/agents/agents.ts +935 -372
  36. package/src/agents/builtin-names.ts +6 -0
  37. package/src/agents/runtime-agent-events.ts +70 -0
  38. package/src/agents/runtime-agent-registry.ts +42 -21
  39. package/src/api/agents.ts +10 -5
  40. package/src/api/background-work.ts +12 -3
  41. package/src/api/capability-ceiling.ts +0 -1
  42. package/src/api/{pi-args.ts → child-tool-plan.ts} +1 -1
  43. package/src/api/delegation.ts +0 -7
  44. package/src/api/external-runs.ts +67 -4
  45. package/src/api/preflight.ts +77 -21
  46. package/src/api/shared-types.ts +6 -0
  47. package/src/extension/config.ts +90 -0
  48. package/src/extension/doctor.ts +5 -13
  49. package/src/extension/fanout-child.ts +14 -14
  50. package/src/extension/index.ts +115 -37
  51. package/src/extension/public-execution.ts +103 -15
  52. package/src/extension/rpc.ts +120 -25
  53. package/src/extension/schemas.ts +65 -29
  54. package/src/extension/tool-description.ts +48 -26
  55. package/src/inspectors/herdr/actions.ts +2 -1
  56. package/src/inspectors/herdr/inspector-runner.ts +21 -23
  57. package/src/inspectors/herdr/session-roots-codec.ts +42 -0
  58. package/src/integrations/herdr-status.ts +51 -3
  59. package/src/intercom/native-supervisor-channel.ts +138 -60
  60. package/src/intercom/result-intercom.ts +7 -0
  61. package/src/intercom/supervisor-ui.ts +243 -0
  62. package/src/profiles/profiles.ts +5 -6
  63. package/src/runs/background/active-async-capacity.ts +103 -18
  64. package/src/runs/background/async-execution.ts +417 -133
  65. package/src/runs/background/async-job-tracker.ts +95 -15
  66. package/src/runs/background/async-resume.ts +60 -28
  67. package/src/runs/background/async-retention.ts +20 -3
  68. package/src/runs/background/async-status-snapshot.ts +23 -261
  69. package/src/runs/background/async-status.ts +204 -14
  70. package/src/runs/background/auto-drain.ts +1 -1
  71. package/src/runs/background/chain-append.ts +8 -3
  72. package/src/runs/background/chain-root-attachment.ts +74 -8
  73. package/src/runs/background/control-channel.ts +4 -205
  74. package/src/runs/background/fleet-view.ts +38 -22
  75. package/src/runs/background/inspect-rpc.ts +8 -8
  76. package/src/runs/background/notify.ts +238 -12
  77. package/src/runs/background/process-terminal.ts +16 -0
  78. package/src/runs/background/result-delivery-ownership.ts +45 -0
  79. package/src/runs/background/result-files.ts +28 -14
  80. package/src/runs/background/result-watcher.ts +39 -16
  81. package/src/runs/background/resume-guidance.ts +2 -2
  82. package/src/runs/background/retained-children.ts +1 -1
  83. package/src/runs/background/run-child-session.ts +613 -0
  84. package/src/runs/background/run-status.ts +84 -17
  85. package/src/runs/background/runner-aliases.ts +125 -0
  86. package/src/runs/background/runner-child-sessions.ts +31 -0
  87. package/src/runs/background/scheduled-runs.ts +174 -18
  88. package/src/runs/background/stale-run-reconciler.ts +10 -4
  89. package/src/runs/background/steering.ts +8 -15
  90. package/src/runs/background/subagent-runner.ts +718 -1161
  91. package/src/runs/background/subagent-wait.ts +86 -31
  92. package/src/runs/background/terminal-run-index.ts +1 -1
  93. package/src/runs/background/wait-completions.ts +43 -2
  94. package/src/runs/background/wait-config.ts +23 -9
  95. package/src/runs/background/wait-tool.ts +26 -19
  96. package/src/runs/foreground/async-steering-action.ts +3 -19
  97. package/src/runs/foreground/execution.ts +489 -499
  98. package/src/runs/foreground/foreground-control.ts +13 -0
  99. package/src/runs/foreground/foreground-history.ts +23 -1
  100. package/src/runs/foreground/subagent-executor.ts +1223 -402
  101. package/src/runs/foreground/workflow-detach-reconcile.ts +140 -115
  102. package/src/runs/foreground/workflow-foreground-steering.ts +24 -98
  103. package/src/runs/shared/abort-recovery.ts +119 -0
  104. package/src/runs/shared/acceptance.ts +138 -36
  105. package/src/runs/shared/async-status-projection.ts +565 -0
  106. package/src/runs/shared/background-process-options.ts +9 -0
  107. package/src/runs/shared/capability-ceiling.ts +2 -2
  108. package/src/runs/shared/child-hooks.ts +25 -0
  109. package/src/runs/shared/child-identity.ts +32 -6
  110. package/src/runs/shared/child-launch-plan.ts +151 -0
  111. package/src/runs/shared/child-launch.ts +364 -0
  112. package/src/runs/shared/child-lifecycle.ts +25 -0
  113. package/src/runs/shared/child-runtime-config.ts +126 -0
  114. package/src/runs/shared/child-session.ts +366 -0
  115. package/src/runs/shared/child-tool-plan.ts +632 -0
  116. package/src/runs/shared/claude-code-adapter.ts +133 -0
  117. package/src/runs/shared/codex-exec-adapter.ts +129 -0
  118. package/src/runs/shared/completion-evidence.ts +89 -0
  119. package/src/runs/shared/completion-guard.ts +6 -5
  120. package/src/runs/shared/cursor-agent-adapter.ts +114 -0
  121. package/src/runs/shared/dynamic-fanout.ts +3 -3
  122. package/src/runs/shared/external-cli-contract.ts +167 -0
  123. package/src/runs/shared/external-cli-preflight.ts +138 -0
  124. package/src/runs/shared/external-cli-runner.ts +348 -55
  125. package/src/runs/shared/fast-mode-extension.ts +5 -5
  126. package/src/runs/shared/host-step-status.ts +231 -0
  127. package/src/runs/shared/lane-metadata.ts +126 -0
  128. package/src/runs/shared/launch-cwd.ts +16 -0
  129. package/src/runs/shared/long-running-guard.ts +2 -1
  130. package/src/runs/shared/mcp-config-sources.ts +422 -0
  131. package/src/runs/shared/mcp-direct-tool-allowlist.ts +222 -158
  132. package/src/runs/shared/mcp-direct-tool-grant.ts +194 -0
  133. package/src/runs/shared/model-exclusions.ts +139 -9
  134. package/src/runs/shared/model-fallback.ts +146 -14
  135. package/src/runs/shared/mutation-evidence.ts +57 -3
  136. package/src/runs/shared/nested-events.ts +99 -77
  137. package/src/runs/shared/nested-path.ts +0 -14
  138. package/src/runs/shared/nested-render.ts +9 -5
  139. package/src/runs/shared/orca-progress-tabs.ts +12 -7
  140. package/src/runs/shared/parallel-handoff.ts +423 -7
  141. package/src/runs/shared/parallel-utils.ts +20 -7
  142. package/src/runs/shared/permissions.ts +1 -14
  143. package/src/runs/shared/pi-spawn.ts +69 -35
  144. package/src/runs/shared/process-signal.ts +16 -0
  145. package/src/runs/shared/run-fanout-budget.ts +0 -13
  146. package/src/runs/shared/run-history.ts +21 -1
  147. package/src/runs/shared/runtime-acknowledged-extensions.ts +0 -27
  148. package/src/runs/shared/sandbox-profile-guard.ts +85 -0
  149. package/src/runs/shared/sandbox-startup-diagnostics.ts +54 -0
  150. package/src/runs/shared/single-output.ts +89 -22
  151. package/src/runs/shared/structured-output.ts +49 -9
  152. package/src/runs/shared/subagent-control.ts +6 -2
  153. package/src/runs/shared/subagent-prompt-runtime.ts +188 -365
  154. package/src/runs/shared/task-intent.ts +21 -7
  155. package/src/runs/shared/tool-availability.ts +18 -62
  156. package/src/runs/shared/tool-budget.ts +0 -14
  157. package/src/runs/shared/tool-timeout.ts +1 -1
  158. package/src/runs/shared/workflow-graph.ts +16 -0
  159. package/src/runs/shared/worktree-cleanup-plan.ts +866 -0
  160. package/src/runs/shared/worktree.ts +571 -62
  161. package/src/shared/atomic-json.ts +3 -1
  162. package/src/shared/child-session-name.ts +46 -0
  163. package/src/shared/extension-context.ts +24 -0
  164. package/src/shared/fork-context.ts +21 -12
  165. package/src/shared/fork-session-cwd.ts +27 -0
  166. package/src/shared/formatters.ts +18 -3
  167. package/src/shared/jsonl-writer.ts +11 -0
  168. package/src/shared/launch-contract.ts +11 -1
  169. package/src/shared/pruned-fork.ts +450 -0
  170. package/src/shared/sandbox-profile.ts +23 -0
  171. package/src/shared/session-file-trust.ts +19 -0
  172. package/src/shared/session-tokens.ts +14 -3
  173. package/src/shared/settings.ts +19 -105
  174. package/src/shared/shortcuts.ts +17 -0
  175. package/src/shared/thinking-ceiling.ts +0 -6
  176. package/src/shared/types.ts +545 -70
  177. package/src/shared/utils.ts +60 -93
  178. package/src/shared/workflow-child-permit.ts +207 -0
  179. package/src/slash/delegation-adapters.ts +1 -9
  180. package/src/slash/delegation-request.ts +0 -4
  181. package/src/slash/prompt-template-bridge.ts +37 -1
  182. package/src/slash/slash-bridge.ts +1 -2
  183. package/src/slash/slash-commands.ts +383 -116
  184. package/src/slash/slash-live-state.ts +22 -11
  185. package/src/slash/subagents-admin.ts +29 -12
  186. package/src/tui/fleet-native-transcript.ts +4 -0
  187. package/src/tui/fleet-status.ts +217 -82
  188. package/src/tui/fleet-transcript.ts +11 -5
  189. package/src/tui/fleet.ts +54 -28
  190. package/src/tui/render-helpers.ts +31 -0
  191. package/src/tui/render.ts +1429 -163
  192. package/src/watchdog/change-signature.ts +40 -1
  193. package/src/watchdog/child-status.ts +54 -34
  194. package/src/watchdog/diff-tool.ts +77 -0
  195. package/src/watchdog/emission-guard.ts +5 -3
  196. package/src/watchdog/guidance.ts +20 -0
  197. package/src/watchdog/register-child.ts +28 -25
  198. package/src/watchdog/register-main.ts +10 -9
  199. package/src/watchdog/render.ts +4 -5
  200. package/src/watchdog/review.ts +15 -4
  201. package/src/watchdog/rules.ts +70 -0
  202. package/src/watchdog/runtime.ts +75 -92
  203. package/src/watchdog/scope.ts +0 -11
  204. package/src/watchdog/settings.ts +48 -104
  205. package/src/watchdog/turn-delta.ts +1 -1
  206. package/src/watchdog/types.ts +18 -32
  207. package/src/watchdog/warning-format.ts +0 -1
  208. package/src/workflows/chat-progress.ts +7 -3
  209. package/src/workflows/host-command.ts +235 -0
  210. package/src/workflows/scripted-workflow.ts +988 -59
  211. package/src/workflows/workflow-checklist.ts +439 -0
  212. package/src/workflows/workflow-child-summary.ts +121 -0
  213. package/src/workflows/workflow-preflight.ts +297 -0
  214. package/src/workflows/workflow-receipt.ts +232 -6
  215. package/src/workflows/workflow-resources.ts +150 -0
  216. package/src/workflows/workflow-settlement.ts +246 -0
  217. package/src/runs/shared/child-protocol.ts +0 -401
  218. package/src/runs/shared/pi-args.ts +0 -935
  219. package/src/runs/shared/subagent-startup-retry.ts +0 -116
  220. package/src/runs/shared/turn-budget.ts +0 -98
  221. package/src/shared/post-exit-stdio-guard.ts +0 -85
@@ -21,7 +21,9 @@ import type {
21
21
  ResolvedAcceptanceGate,
22
22
  SingleResult,
23
23
  SubagentRunMode,
24
+ ChildWatchdogProgress,
24
25
  } from "../../shared/types.ts";
26
+ import { unresolvedChildWatchdogBlockers } from "../../watchdog/child-status.ts";
25
27
  import { isAgentContractV1 } from "./agent-contract.ts";
26
28
  import { classifyTaskMutationIntent, stripSeverityCompounds, taskMayMutate } from "./task-intent.ts";
27
29
 
@@ -47,7 +49,7 @@ const VALID_EVIDENCE_KINDS: AcceptanceEvidenceKind[] = [
47
49
  const VALID_EVIDENCE = new Set<AcceptanceEvidenceKind>(VALID_EVIDENCE_KINDS);
48
50
  const ACCEPTANCE_EVIDENCE_HELP = `Supported evidence kinds: ${VALID_EVIDENCE_KINDS.join(", ")}. Example: { level: "checked", evidence: ["commands-run", "changed-files"] }.`;
49
51
  const ACCEPTANCE_OBJECT_EXAMPLE = "Example: { level: \"checked\", evidence: [\"commands-run\", \"changed-files\"] }.";
50
- const ACCEPTANCE_CONFIG_KEYS = new Set(["level", "criteria", "evidence", "verify", "review", "stopRules", "reason"]);
52
+ const ACCEPTANCE_CONFIG_KEYS = new Set(["level", "report", "criteria", "evidence", "verify", "review", "stopRules", "reason"]);
51
53
  const ACCEPTANCE_GATE_KEYS = new Set(["id", "must", "evidence", "severity"]);
52
54
  const ACCEPTANCE_VERIFY_KEYS = new Set(["id", "command", "timeoutMs", "cwd", "env", "allowFailure"]);
53
55
  const ACCEPTANCE_REVIEW_KEYS = new Set(["agent", "focus", "required"]);
@@ -100,12 +102,13 @@ function inferLevel(input: {
100
102
  const writeTask = taskMayWrite
101
103
  || (input.acceptanceRole === "writer" && !readOnlyTask)
102
104
  || (input.acceptanceRole === undefined && /\bworker\b/.test(agent) && !readOnlyTask);
103
- const inferredReadOnly = readOnlyTask || (input.acceptanceRole === "read-only" && !taskMayWrite);
105
+ const inferredReadOnly = readOnlyTask || ((readOnlyAgent || input.acceptanceRole === "read-only") && !taskMayWrite);
104
106
  const roleResolvesReadOnly = input.acceptanceRole !== undefined && inferredReadOnly;
107
+ const dynamicResolvesReadOnly = inferredReadOnly && !writeTask;
105
108
  const keywordRiskReadOnly = input.acceptanceRole === undefined ? intent.kind === "read-only" : inferredReadOnly;
106
109
  const risky = Boolean(input.async && writeTask)
107
- || (Boolean(input.dynamic) && !roleResolvesReadOnly)
108
- || (Boolean(input.dynamicGroup) && !roleResolvesReadOnly)
110
+ || (Boolean(input.dynamic) && !roleResolvesReadOnly && !dynamicResolvesReadOnly)
111
+ || (Boolean(input.dynamicGroup) && !roleResolvesReadOnly && !dynamicResolvesReadOnly)
109
112
  || (!keywordRiskReadOnly && /\b(?:release|migration|migrate|security|data[- ]loss|destructive|post-review|fix pass)\b/.test(task));
110
113
 
111
114
  if (risky) {
@@ -131,7 +134,7 @@ function inferLevel(input: {
131
134
  if (readOnlyAgent || readOnlyTask) {
132
135
  reasons.push(input.acceptanceRole === "read-only" && !readOnlyTask ? "declared read-only acceptance role" : readOnlyAgent ? "read-only/reviewer-style agent" : "read-only task wording");
133
136
  return {
134
- level: "attested",
137
+ level: "none",
135
138
  reasons,
136
139
  criteria: ["Return concrete findings with file paths and severity when applicable"],
137
140
  evidence: ["review-findings", "residual-risks"],
@@ -146,11 +149,46 @@ function inferLevel(input: {
146
149
  };
147
150
  }
148
151
 
149
- export function normalizeAcceptanceInput(input: AcceptanceInput | undefined): AcceptanceConfig {
152
+ type AcceptanceInputNormalizationResult = { value: unknown; error?: string };
153
+
154
+ function normalizeAcceptanceValue(input: unknown, pathLabel = "acceptance"): AcceptanceInputNormalizationResult {
155
+ if (typeof input !== "string") return { value: input };
156
+ const trimmed = input.trim();
157
+ if (!trimmed.startsWith("{") && !trimmed.startsWith("[")) return { value: input };
158
+ let parsed: unknown;
159
+ try {
160
+ parsed = JSON.parse(trimmed);
161
+ } catch (error) {
162
+ return {
163
+ value: input,
164
+ error: `${pathLabel} JSON string must encode a valid acceptance object: ${error instanceof Error ? error.message : String(error)}`,
165
+ };
166
+ }
167
+ if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
168
+ const kind = parsed === null ? "null" : Array.isArray(parsed) ? "an array" : typeof parsed;
169
+ return { value: input, error: `${pathLabel} JSON string must encode an object; got ${kind}.` };
170
+ }
171
+ return { value: parsed };
172
+ }
173
+
174
+ export function normalizeAcceptanceInput(input: unknown): AcceptanceConfig {
175
+ const normalized = normalizeAcceptanceValue(input);
176
+ if (normalized.error) throw new Error(normalized.error);
177
+ input = normalized.value;
150
178
  if (input === undefined || input === "auto") return { level: "auto" };
151
179
  if (input === false) return { level: "none", reason: "disabled by deprecated false shorthand" };
152
- if (typeof input === "string") return { level: input };
153
- return { ...input };
180
+ if (typeof input === "string") return { level: input as AcceptanceConfig["level"] };
181
+ return { ...(input as AcceptanceConfig) };
182
+ }
183
+
184
+ export type ResolvedAcceptanceReportMode = "off" | "optional" | "required";
185
+
186
+ export function resolveAcceptanceReportMode(input: unknown): ResolvedAcceptanceReportMode {
187
+ const normalized = normalizeAcceptanceValue(input);
188
+ if (normalized.error) throw new Error(normalized.error);
189
+ const value = normalized.value;
190
+ const report = value && typeof value === "object" && !Array.isArray(value) ? (value as AcceptanceConfig).report : undefined;
191
+ return value === false || report === "off" ? "off" : report === "on" ? "required" : "optional";
154
192
  }
155
193
 
156
194
  type GateAcceptanceNormalizationResult =
@@ -158,7 +196,11 @@ type GateAcceptanceNormalizationResult =
158
196
  | { ok: false; error: string };
159
197
 
160
198
  export function normalizeGateAcceptance(gate: unknown, acceptance: AcceptanceInput | undefined): GateAcceptanceNormalizationResult {
161
- if (gate === undefined) return acceptance === undefined ? { ok: true } : { ok: true, acceptance };
199
+ if (gate === undefined) {
200
+ if (acceptance === undefined) return { ok: true };
201
+ const normalized = normalizeAcceptanceValue(acceptance);
202
+ return normalized.error ? { ok: false, error: normalized.error } : { ok: true, acceptance: normalized.value as AcceptanceInput };
203
+ }
162
204
  if (typeof gate !== "string" || !gate.trim()) return { ok: false, error: "gate must be a non-empty command string." };
163
205
  if (acceptance !== undefined) return { ok: false, error: "gate cannot be combined with acceptance; use one gate command or acceptance.verify." };
164
206
  return { ok: true, acceptance: { level: "verified", verify: [{ id: "gate", command: gate.trim() }] } };
@@ -168,6 +210,10 @@ function explicitAcceptanceCanDisable(explicit: AcceptanceConfig): boolean {
168
210
  return explicit.level === "none" && typeof explicit.reason === "string" && explicit.reason.trim().length > 0;
169
211
  }
170
212
 
213
+ function explicitAcceptanceRequestsPolicy(explicit: AcceptanceConfig): boolean {
214
+ return (explicit.level !== undefined && explicit.level !== "auto") || Object.keys(explicit).some((key) => key !== "level");
215
+ }
216
+
171
217
  function unsupportedEvidenceKindMessage(pathLabel: string, item: unknown): string {
172
218
  const value = typeof item === "string" ? ` "${item}"` : "";
173
219
  return `${pathLabel}${value} is not a supported evidence kind. ${ACCEPTANCE_EVIDENCE_HELP}`;
@@ -177,6 +223,9 @@ export function validateAcceptanceInput(input: unknown, pathLabel = "acceptance"
177
223
  const errors: string[] = [];
178
224
  if (input === undefined) return errors;
179
225
  if (input === false) return errors;
226
+ const normalized = normalizeAcceptanceValue(input, pathLabel);
227
+ if (normalized.error) return [normalized.error];
228
+ input = normalized.value;
180
229
  if (typeof input === "string") {
181
230
  if (input === "reviewed") errors.push(`${pathLabel} ${EXPLICIT_REVIEWED_UNAVAILABLE}`);
182
231
  else if (!VALID_LEVELS.has(input as AcceptanceLevel)) errors.push(`${pathLabel} has invalid level '${input}'.`);
@@ -197,6 +246,9 @@ export function validateAcceptanceInput(input: unknown, pathLabel = "acceptance"
197
246
  } else if (value.level !== undefined && (typeof value.level !== "string" || !VALID_LEVELS.has(value.level as AcceptanceLevel))) {
198
247
  errors.push(`${pathLabel}.level must be one of auto, none, attested, checked, verified.`);
199
248
  }
249
+ if (value.report !== undefined && value.report !== "on" && value.report !== "off") {
250
+ errors.push(`${pathLabel}.report must be on or off.`);
251
+ }
200
252
  if (value.level === "none" && (typeof value.reason !== "string" || !value.reason.trim())) {
201
253
  errors.push(`${pathLabel}.reason is required when level is none.`);
202
254
  }
@@ -304,29 +356,45 @@ export function validateAcceptanceInput(input: unknown, pathLabel = "acceptance"
304
356
 
305
357
  export function validateExecutionAcceptance(input: {
306
358
  acceptance?: unknown;
307
- tasks?: Array<{ acceptance?: unknown }>;
359
+ outputSchema?: unknown;
360
+ tasks?: Array<{ acceptance?: unknown; outputSchema?: unknown }>;
308
361
  chain?: Array<{
309
362
  acceptance?: unknown;
310
- parallel?: Array<{ acceptance?: unknown }> | { acceptance?: unknown };
363
+ outputSchema?: unknown;
364
+ parallel?: Array<{ acceptance?: unknown; outputSchema?: unknown }> | { acceptance?: unknown; outputSchema?: unknown };
311
365
  }>;
312
366
  }): string[] {
313
367
  const errors = validateAcceptanceInput(input.acceptance, "acceptance");
368
+ errors.push(...validateAcceptanceReportMode(input.acceptance, input.outputSchema, "acceptance"));
314
369
  for (const [index, task] of (input.tasks ?? []).entries()) {
315
370
  errors.push(...validateAcceptanceInput(task.acceptance, `tasks[${index}].acceptance`));
371
+ errors.push(...validateAcceptanceReportMode(task.acceptance, task.outputSchema, `tasks[${index}].acceptance`));
316
372
  }
317
373
  for (const [stepIndex, step] of (input.chain ?? []).entries()) {
318
374
  errors.push(...validateAcceptanceInput(step.acceptance, `chain[${stepIndex}].acceptance`));
375
+ errors.push(...validateAcceptanceReportMode(step.acceptance, step.outputSchema, `chain[${stepIndex}].acceptance`));
319
376
  if (Array.isArray(step.parallel)) {
320
377
  for (const [taskIndex, task] of step.parallel.entries()) {
321
378
  errors.push(...validateAcceptanceInput(task.acceptance, `chain[${stepIndex}].parallel[${taskIndex}].acceptance`));
379
+ errors.push(...validateAcceptanceReportMode(task.acceptance, task.outputSchema, `chain[${stepIndex}].parallel[${taskIndex}].acceptance`));
322
380
  }
323
381
  } else if (step.parallel) {
324
382
  errors.push(...validateAcceptanceInput(step.parallel.acceptance, `chain[${stepIndex}].parallel.acceptance`));
383
+ errors.push(...validateAcceptanceReportMode(step.parallel.acceptance, step.parallel.outputSchema, `chain[${stepIndex}].parallel.acceptance`));
325
384
  }
326
385
  }
327
386
  return errors;
328
387
  }
329
388
 
389
+ function validateAcceptanceReportMode(acceptance: unknown, outputSchema: unknown, pathLabel: string): string[] {
390
+ const normalized = normalizeAcceptanceValue(acceptance, pathLabel);
391
+ if (normalized.error) return [];
392
+ acceptance = normalized.value;
393
+ if (!acceptance || typeof acceptance !== "object" || Array.isArray(acceptance)) return [];
394
+ if (!("report" in acceptance)) return [];
395
+ return outputSchema === undefined ? [`${pathLabel}.report requires outputSchema.`] : [];
396
+ }
397
+
330
398
  function normalizeCriteria(criteria: Array<string | { id?: string; must?: string; evidence?: AcceptanceEvidenceKind[]; severity?: "required" | "recommended" }> | undefined, evidence: AcceptanceEvidenceKind[]): ResolvedAcceptanceGate[] {
331
399
  return (criteria ?? []).map((criterion, index): ResolvedAcceptanceGate => {
332
400
  if (typeof criterion === "string") {
@@ -376,12 +444,13 @@ export function resolveEffectiveAcceptance(input: {
376
444
  };
377
445
  }
378
446
  const inferred = inferLevel(input);
447
+ const inferredLevel = inferred.level === "none" && explicitAcceptanceRequestsPolicy(explicit) ? "attested" : inferred.level;
379
448
  const level = explicitAcceptanceCanDisable(explicit)
380
449
  ? "none"
381
450
  : explicitLevel === "auto"
382
- ? inferred.level
383
- : (LEVEL_RANK[explicitLevel] >= LEVEL_RANK[inferred.level] ? explicitLevel : inferred.level);
384
- const evidence = unique([...(level === inferred.level ? inferred.evidence : requiredEvidenceForLevel(level)), ...(explicit.evidence ?? [])]);
451
+ ? inferredLevel
452
+ : (LEVEL_RANK[explicitLevel] >= LEVEL_RANK[inferredLevel] ? explicitLevel : inferredLevel);
453
+ const evidence = unique([...(level === inferredLevel ? inferred.evidence : requiredEvidenceForLevel(level)), ...(explicit.evidence ?? [])]);
385
454
  const criteria = normalizeCriteria(
386
455
  (explicit.criteria?.length ? explicit.criteria : inferred.criteria) as Array<string | { id?: string; must?: string; evidence?: AcceptanceEvidenceKind[]; severity?: "required" | "recommended" }>,
387
456
  evidence,
@@ -391,8 +460,8 @@ export function resolveEffectiveAcceptance(input: {
391
460
  level,
392
461
  explicit: input.explicit !== undefined,
393
462
  inferredReason: inferred.reasons,
394
- criteria,
395
- evidence,
463
+ criteria: level === "none" ? [] : criteria,
464
+ evidence: level === "none" ? [] : evidence,
396
465
  verify: explicit.verify ?? [],
397
466
  review,
398
467
  stopRules: explicit.stopRules ?? [],
@@ -678,7 +747,15 @@ function parseAcceptanceReportBody(body: string): { report?: AcceptanceReport; e
678
747
  return validateAcceptanceReport(parseReportJson(body));
679
748
  }
680
749
 
681
- function parseUnterminatedAcceptanceReportFence(output: string): { report?: AcceptanceReport; error?: string } {
750
+ interface AcceptanceReportParseResult {
751
+ report?: AcceptanceReport;
752
+ error?: string;
753
+ /** True when an acceptance-report signal was found but its envelope was invalid. */
754
+ malformed?: boolean;
755
+ sourcePath?: string;
756
+ }
757
+
758
+ function parseUnterminatedAcceptanceReportFence(output: string): AcceptanceReportParseResult {
682
759
  const opener = /```acceptance[-_]report\b[^\n]*\n/gi.exec(output);
683
760
  if (!opener) return {};
684
761
  const bodyStart = opener.index + opener[0].length;
@@ -687,13 +764,13 @@ function parseUnterminatedAcceptanceReportFence(output: string): { report?: Acce
687
764
  const validation = validateAcceptanceReport(JSON.parse(output.slice(bodyStart).trim()) as unknown);
688
765
  return validation.report
689
766
  ? { report: validation.report }
690
- : { error: `Failed to parse acceptance-report: Invalid acceptance-report: ${validation.errors.join("; ")}` };
767
+ : { error: `Failed to parse acceptance-report: Invalid acceptance-report: ${validation.errors.join("; ")}`, malformed: true };
691
768
  } catch (error) {
692
- return { error: `Failed to parse acceptance-report: ${error instanceof Error ? error.message : String(error)}` };
769
+ return { error: `Failed to parse acceptance-report: ${error instanceof Error ? error.message : String(error)}`, malformed: true };
693
770
  }
694
771
  }
695
772
 
696
- function parseGenericJsonAcceptanceReportBody(body: string): { report?: AcceptanceReport; error?: string } {
773
+ function parseGenericJsonAcceptanceReportBody(body: string): AcceptanceReportParseResult {
697
774
  const parsed = parseReportJson(body);
698
775
  const normalized = normalizeAcceptanceReportValue(parsed);
699
776
  const hasCriteriaMarker = normalized.value !== null
@@ -704,12 +781,12 @@ function parseGenericJsonAcceptanceReportBody(body: string): { report?: Acceptan
704
781
  const validation = validateAcceptanceReport(parsed);
705
782
  return validation.report
706
783
  ? { report: validation.report }
707
- : { error: `Invalid acceptance-report: ${validation.errors.join("; ")}` };
784
+ : { error: `Invalid acceptance-report: ${validation.errors.join("; ")}`, malformed: true };
708
785
  }
709
786
 
710
787
  export const ACCEPTANCE_REPORT_NOT_FOUND = "Structured acceptance report not found.";
711
788
 
712
- export function parseAcceptanceReport(output: string): { report?: AcceptanceReport; error?: string } {
789
+ export function parseAcceptanceReport(output: string): AcceptanceReportParseResult {
713
790
  const explicitFencePresent = /```acceptance[-_]report\b/i.test(output);
714
791
  const fenced = fencedBlocks(output, "acceptance[-_]report");
715
792
  const parseErrors: string[] = [];
@@ -722,17 +799,17 @@ export function parseAcceptanceReport(output: string): { report?: AcceptanceRepo
722
799
  parseErrors.push(error instanceof Error ? error.message : String(error));
723
800
  }
724
801
  }
725
- if (parseErrors.length > 0) return { error: `Failed to parse acceptance-report: ${parseErrors.join("; ")}` };
802
+ if (parseErrors.length > 0) return { error: `Failed to parse acceptance-report: ${parseErrors.join("; ")}`, malformed: true };
726
803
  if (explicitFencePresent) {
727
804
  const recovered = parseUnterminatedAcceptanceReportFence(output);
728
805
  if (recovered.report || recovered.error) return recovered;
729
- return { error: "Failed to parse acceptance-report: Empty or unterminated acceptance-report fence." };
806
+ return { error: "Failed to parse acceptance-report: Empty or unterminated acceptance-report fence.", malformed: true };
730
807
  }
731
808
  for (const body of fencedBlocks(output, "(?:json|jsonc|json5)")) {
732
809
  try {
733
810
  const parsed = parseGenericJsonAcceptanceReportBody(body);
734
811
  if (parsed.report) return { report: parsed.report };
735
- if (parsed.error) return { error: `Failed to parse acceptance-report: ${parsed.error}` };
812
+ if (parsed.error) return { error: `Failed to parse acceptance-report: ${parsed.error}`, malformed: parsed.malformed };
736
813
  } catch {
737
814
  // Ignore unrelated malformed generic JSON. A recognizable report shape
738
815
  // returns exact validation errors above instead of being mistaken for prose.
@@ -742,20 +819,20 @@ export function parseAcceptanceReport(output: string): { report?: AcceptanceRepo
742
819
  if (markerIndex !== -1) {
743
820
  const jsonStart = output.indexOf("{", markerIndex);
744
821
  if (jsonStart === -1) {
745
- return { error: "Failed to parse acceptance-report: Expected a JSON object after ACCEPTANCE_REPORT:." };
822
+ return { error: "Failed to parse acceptance-report: Expected a JSON object after ACCEPTANCE_REPORT:.", malformed: true };
746
823
  }
747
824
  const json = extractBalancedJson(output, jsonStart);
748
825
  if (!json) {
749
- return { error: "Failed to parse acceptance-report: Unterminated JSON object after ACCEPTANCE_REPORT:." };
826
+ return { error: "Failed to parse acceptance-report: Unterminated JSON object after ACCEPTANCE_REPORT:.", malformed: true };
750
827
  }
751
828
  try {
752
829
  const parsed = JSON.parse(json) as unknown;
753
830
  const validation = validateAcceptanceReport(parsed);
754
831
  if (validation.report) return { report: validation.report };
755
- return { error: `Failed to parse acceptance-report: Invalid acceptance-report: ${validation.errors.join("; ")}` };
832
+ return { error: `Failed to parse acceptance-report: Invalid acceptance-report: ${validation.errors.join("; ")}`, malformed: true };
756
833
  } catch (error) {
757
834
  const message = error instanceof Error ? error.message : String(error);
758
- return { error: `Failed to parse acceptance-report: ${message}` };
835
+ return { error: `Failed to parse acceptance-report: ${message}`, malformed: true };
759
836
  }
760
837
  }
761
838
  return { error: ACCEPTANCE_REPORT_NOT_FOUND };
@@ -764,14 +841,18 @@ export function parseAcceptanceReport(output: string): { report?: AcceptanceRepo
764
841
  function parseAcceptanceReportSources(
765
842
  output: string,
766
843
  fileOutput: { content: string; path: string; authoritative?: boolean } | undefined,
767
- ): { report?: AcceptanceReport; error?: string } {
844
+ ): AcceptanceReportParseResult {
768
845
  const fromText = () => parseAcceptanceReport(output);
769
846
  const fromFile = () => {
770
847
  if (!fileOutput) return { error: ACCEPTANCE_REPORT_NOT_FOUND };
771
848
  const parsed = parseAcceptanceReport(fileOutput.content);
772
849
  return parsed.report || parsed.error === ACCEPTANCE_REPORT_NOT_FOUND
773
850
  ? parsed
774
- : { error: `${parsed.error} (in configured output ${fileOutput.path})` };
851
+ : {
852
+ ...parsed,
853
+ error: `${parsed.error} (in configured output ${fileOutput.path})`,
854
+ sourcePath: fileOutput.path,
855
+ };
775
856
  };
776
857
  const [primary, secondary] = fileOutput?.authoritative ? [fromFile, fromText] : [fromText, fromFile];
777
858
  const first = primary();
@@ -839,7 +920,7 @@ function validateStringArrayField(errors: string[], value: unknown, pathLabel: s
839
920
  }
840
921
  }
841
922
 
842
- function validateAcceptanceReport(value: unknown, pathLabel = ""): { report?: AcceptanceReport; errors: string[] } {
923
+ export function validateAcceptanceReport(value: unknown, pathLabel = ""): { report?: AcceptanceReport; errors: string[] } {
843
924
  const normalized = normalizeAcceptanceReportValue(value, pathLabel);
844
925
  value = normalized.value;
845
926
  pathLabel = normalized.pathLabel;
@@ -1272,7 +1353,7 @@ export async function evaluateAcceptance(input: {
1272
1353
  * be misattributed). Searched for the acceptance report; searched before
1273
1354
  * the assistant output when `authoritative` (outputMode "file-only").
1274
1355
  */
1275
- fileOutput?: { content: string; path: string; authoritative?: boolean };
1356
+ fileOutput?: { content: string; path: string; authoritative?: boolean; durable?: boolean };
1276
1357
  report?: AcceptanceReport;
1277
1358
  reportError?: string;
1278
1359
  reviewResult?: AcceptanceReviewResult;
@@ -1281,6 +1362,7 @@ export async function evaluateAcceptance(input: {
1281
1362
  reportOptional?: boolean;
1282
1363
  artifactsDir?: string;
1283
1364
  runId?: string;
1365
+ watchdog?: ChildWatchdogProgress;
1284
1366
  }): Promise<AcceptanceLedger> {
1285
1367
  const acceptance = input.acceptance;
1286
1368
  const initialStatus = acceptance.level === "none" ? "not-required" : "claimed";
@@ -1296,16 +1378,32 @@ export async function evaluateAcceptance(input: {
1296
1378
  };
1297
1379
  if (acceptance.level === "none") return ledger;
1298
1380
 
1299
- const parsed = input.reportError
1381
+ if (input.watchdog) {
1382
+ const unresolved = unresolvedChildWatchdogBlockers(input.watchdog);
1383
+ ledger.runtimeChecks.push(unresolved.length
1384
+ ? { id: "watchdog-blocker", status: "failed", message: `Unresolved watchdog blocker: ${unresolved[0]!.summary}` }
1385
+ : { id: "watchdog-blocker", status: "passed", message: "No unresolved watchdog blockers." });
1386
+ }
1387
+
1388
+ const parsed: AcceptanceReportParseResult = input.reportError
1300
1389
  ? { error: input.reportError }
1301
- : input.report
1390
+ : input.report !== undefined
1302
1391
  ? (() => {
1303
1392
  const validation = validateAcceptanceReport(input.report);
1304
1393
  return validation.report
1305
1394
  ? { report: validation.report }
1306
- : { error: `Failed to parse acceptance-report: Invalid acceptance-report: ${validation.errors.join("; ")}` };
1395
+ : { error: `Failed to parse acceptance-report: Invalid acceptance-report: ${validation.errors.join("; ")}`, malformed: true };
1307
1396
  })()
1308
1397
  : parseAcceptanceReportSources(input.output, input.fileOutput);
1398
+ const durableFileOutput = input.fileOutput?.authoritative && input.fileOutput.durable ? input.fileOutput : undefined;
1399
+ if (parsed.malformed && parsed.sourcePath && durableFileOutput) {
1400
+ ledger.recovery = {
1401
+ status: "available-for-review",
1402
+ reason: "acceptance-metadata-rejected",
1403
+ reportPath: parsed.sourcePath,
1404
+ reportHash: hash(durableFileOutput.content),
1405
+ };
1406
+ }
1309
1407
  const needsReport = acceptanceRequiresChildReport(acceptance);
1310
1408
  if (parsed.report) {
1311
1409
  ledger.childReport = parsed.report;
@@ -1314,6 +1412,10 @@ export async function evaluateAcceptance(input: {
1314
1412
  } else if (!input.reportOptional || needsReport || parsed.error !== ACCEPTANCE_REPORT_NOT_FOUND) {
1315
1413
  ledger.childReportParseError = parsed.error;
1316
1414
  ledger.runtimeChecks.push({ id: "attestation", status: "failed", message: parsed.error ?? "Structured acceptance report missing." });
1415
+ if (ledger.recovery) {
1416
+ ledger.status = "rejected";
1417
+ ledger.evidenceStatus = "rejected";
1418
+ }
1317
1419
  if (!input.reportOptional) {
1318
1420
  ledger.status = "rejected";
1319
1421
  ledger.evidenceStatus = "rejected";