@tea-agent/loop-agent 0.26.0 → 0.26.1

package/docs/templates/agent-dag-report.schema.json

@@ -1,473 +1,473 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://loop-agent.local/schemas/agent-dag-report.schema.json",
-  "title": "Agent DAG Report",
-  "description": "Stable JSON contract for `dag report --json` output consumed by Decision Gate evidence builders and operator tooling. Derived read-only view over `.harness/dag-runs/` canonical facts; never mutates run state.",
-  "type": "object",
-  "additionalProperties": false,
-  "required": ["schemaVersion", "runs"],
-  "properties": {
-    "schemaVersion": {
-      "type": "integer",
-      "const": 1,
-      "description": "Report envelope schema version. Bump only when breaking stable fields."
-    },
-    "runs": {
-      "type": "array",
-      "items": { "$ref": "#/$defs/dagRunReportEntry" }
-    }
-  },
-  "$defs": {
-    "dagArtifactRef": {
-      "type": "object",
-      "additionalProperties": false,
-      "required": ["path", "exists"],
-      "properties": {
-        "path": { "type": "string" },
-        "exists": { "type": "boolean" }
-      }
-    },
-    "dagRecoveryRecommendation": {
-      "type": "object",
-      "additionalProperties": false,
-      "required": [
-        "action",
-        "summary",
-        "reason",
-        "humanRequired",
-        "autoRetryEligible"
-      ],
-      "properties": {
-        "action": {
-          "type": "string",
-          "enum": [
-            "none",
-            "monitor",
-            "retry-node",
-            "rerun-after-fix",
-            "resume-or-reject",
-            "manual-review",
-            "inspect-upstream",
-            "unknown"
-          ]
-        },
-        "summary": { "type": "string" },
-        "reason": { "type": "string" },
-        "humanRequired": { "type": "boolean" },
-        "autoRetryEligible": { "type": "boolean" },
-        "commandHint": { "type": "string" }
-      }
-    },
-    "dagProductLineFailureCategory": {
-      "type": "string",
-      "enum": [
-        "SpecUnclear",
-        "ContractMismatch",
-        "ProductBug",
-        "TestBug",
-        "EnvFailure",
-        "FlakyTest",
-        "RiskyChange",
-        "DependencyFailure",
-        "NeedsHuman",
-        "Unknown"
-      ]
-    },
-    "dagReportPrimaryFailure": {
-      "type": "object",
-      "additionalProperties": false,
-      "required": ["scope"],
-      "properties": {
-        "scope": { "type": "string", "enum": ["node", "run"] },
-        "nodeId": { "type": "string" },
-        "nodeStatus": {
-          "type": "string",
-          "enum": ["PENDING", "RUNNING", "FINISHED", "ERROR", "SKIPPED"]
-        },
-        "failureCategory": { "type": "string" },
-        "normalizedFailureCategory": {
-          "type": "string",
-          "enum": [
-            "success",
-            "validation",
-            "executor",
-            "write-guard",
-            "timeout",
-            "auth",
-            "human-required",
-            "human-rejected",
-            "shell-command",
-            "static-error",
-            "decision-envelope",
-            "skipped",
-            "unknown"
-          ]
-        },
-        "productLineFailureCategory": {
-          "$ref": "#/$defs/dagProductLineFailureCategory"
-        },
-        "recommendedFollowUp": { "type": "string" }
-      }
-    },
-    "dagReportPrimaryRecovery": {
-      "$ref": "#/$defs/dagRecoveryRecommendation"
-    },
-    "dagReportDownstreamSkippedNode": {
-      "type": "object",
-      "additionalProperties": false,
-      "required": ["nodeId"],
-      "properties": {
-        "nodeId": { "type": "string" },
-        "failureCategory": { "type": "string" },
-        "normalizedFailureCategory": {
-          "type": "string",
-          "enum": [
-            "success",
-            "validation",
-            "executor",
-            "write-guard",
-            "timeout",
-            "auth",
-            "human-required",
-            "human-rejected",
-            "shell-command",
-            "static-error",
-            "decision-envelope",
-            "skipped",
-            "unknown"
-          ]
-        },
-        "productLineFailureCategory": {
-          "$ref": "#/$defs/dagProductLineFailureCategory"
-        },
-        "recommendedFollowUp": { "type": "string" }
-      }
-    },
-    "dagNodeDecisionEnvelope": {
-      "type": "object",
-      "additionalProperties": true,
-      "required": ["parseOk"],
-      "properties": {
-        "parseOk": { "type": "boolean" },
-        "decision": { "type": "string" },
-        "requiresHuman": { "type": "boolean" },
-        "nextAction": { "type": "string" },
-        "riskLevel": { "type": "string" },
-        "source": {
-          "type": "string",
-          "enum": ["assistantText", "resultSummaryFallback"]
-        },
-        "errors": {
-          "type": "array",
-          "items": { "type": "string" }
-        }
-      }
-    },
-    "dagNodeArtifactsReport": {
-      "type": "object",
-      "additionalProperties": false,
-      "required": [
-        "resultSummary",
-        "promptRedacted",
-        "skills",
-        "nodeRecord",
-        "decisionEnvelope",
-        "decisionEnvelopeValidation",
-        "humanEscalationJson",
-        "humanEscalationMd",
-        "humanApproval",
-        "humanRejection"
-      ],
-      "properties": {
-        "resultSummary": { "$ref": "#/$defs/dagArtifactRef" },
-        "promptRedacted": { "$ref": "#/$defs/dagArtifactRef" },
-        "skills": { "$ref": "#/$defs/dagArtifactRef" },
-        "nodeRecord": { "$ref": "#/$defs/dagArtifactRef" },
-        "decisionEnvelope": { "$ref": "#/$defs/dagArtifactRef" },
-        "decisionEnvelopeValidation": { "$ref": "#/$defs/dagArtifactRef" },
-        "humanEscalationJson": { "$ref": "#/$defs/dagArtifactRef" },
-        "humanEscalationMd": { "$ref": "#/$defs/dagArtifactRef" },
-        "humanApproval": { "$ref": "#/$defs/dagArtifactRef" },
-        "humanRejection": { "$ref": "#/$defs/dagArtifactRef" }
-      }
-    },
-    "repairArtifact": {
-      "type": "object",
-      "additionalProperties": false,
-      "required": [
-        "schemaVersion",
-        "verdict",
-        "failureClass",
-        "rootCause",
-        "fixScope",
-        "invariant",
-        "evidenceRefs",
-        "rawLogFallbackAllowed"
-      ],
-      "properties": {
-        "schemaVersion": { "type": "integer", "const": 1 },
-        "verdict": {
-          "type": "string",
-          "enum": ["pass", "request-revision"]
-        },
-        "failureClass": {
-          "type": "string",
-          "enum": [
-            "syntax",
-            "runtime",
-            "logic",
-            "boundary",
-            "environment",
-            "governance",
-            "unknown"
-          ]
-        },
-        "rootCause": { "type": "string", "minLength": 1 },
-        "fixScope": {
-          "type": "array",
-          "items": { "type": "string", "minLength": 1 }
-        },
-        "invariant": { "type": "string", "minLength": 1 },
-        "evidenceRefs": {
-          "type": "array",
-          "items": { "type": "string", "minLength": 1 }
-        },
-        "rawLogFallbackAllowed": { "type": "boolean" }
-      }
-    },
-    "dagConvergencePassArtifactRef": {
-      "type": "object",
-      "additionalProperties": false,
-      "required": ["nodeId", "status"],
-      "properties": {
-        "nodeId": { "type": "string" },
-        "status": {
-          "type": "string",
-          "enum": ["PENDING", "RUNNING", "FINISHED", "ERROR", "SKIPPED"]
-        },
-        "failureCategory": { "type": "string" },
-        "nodeRecordPath": { "type": "string" },
-        "stdoutArtifactPath": { "type": "string" },
-        "assistantArtifactPath": { "type": "string" },
-        "preservedNodeRecordPath": { "type": "string" },
-        "preservedNodeDir": { "type": "string" }
-      }
-    },
-    "dagConvergencePass": {
-      "type": "object",
-      "additionalProperties": false,
-      "required": ["pass", "finishedAt", "status", "reason", "artifactRefs"],
-      "properties": {
-        "pass": { "type": "integer", "minimum": 1 },
-        "startedAt": { "type": "string" },
-        "finishedAt": { "type": "string" },
-        "status": {
-          "type": "string",
-          "enum": ["retrying", "terminal", "paused"]
-        },
-        "reason": { "type": "string" },
-        "hardVerifyStatus": {
-          "type": "string",
-          "enum": ["PENDING", "RUNNING", "FINISHED", "ERROR", "SKIPPED"]
-        },
-        "hardVerifyFailureCategory": { "type": "string" },
-        "processVerdict": {
-          "type": "string",
-          "enum": ["pass", "request-revision", "unknown"]
-        },
-        "repairArtifact": { "$ref": "#/$defs/repairArtifact" },
-        "verifyPhase": {
-          "type": "string",
-          "enum": ["intermediate", "final"]
-        },
-        "verifyQuota": {
-          "type": "string",
-          "enum": ["1", "3", "full"]
-        },
-        "verifyCommandCount": { "type": "integer", "minimum": 0 },
-        "verifyCommandLabels": {
-          "type": "array",
-          "items": { "type": "string" }
-        },
-        "shellSuccessCount": { "type": "integer", "minimum": 0 },
-        "artifactRefs": {
-          "type": "array",
-          "items": { "$ref": "#/$defs/dagConvergencePassArtifactRef" }
-        }
-      }
-    },
-    "dagConvergence": {
-      "type": "object",
-      "additionalProperties": false,
-      "required": ["enabled", "maxPasses", "currentPass", "passHistory"],
-      "properties": {
-        "enabled": { "type": "boolean" },
-        "maxPasses": { "type": "integer", "minimum": 1 },
-        "currentPass": { "type": "integer", "minimum": 1 },
-        "terminalReason": { "type": "string" },
-        "passHistory": {
-          "type": "array",
-          "items": { "$ref": "#/$defs/dagConvergencePass" }
-        }
-      }
-    },
-    "dagNodeReportRow": {
-      "type": "object",
-      "additionalProperties": false,
-      "required": [
-        "nodeId",
-        "rank",
-        "order",
-        "executor",
-        "status",
-        "artifacts"
-      ],
-      "properties": {
-        "nodeId": { "type": "string" },
-        "rank": { "type": "integer", "minimum": 0 },
-        "order": { "type": "integer", "minimum": 0 },
-        "executor": {
-          "type": "string",
-          "enum": ["pi", "shell", "static"]
-        },
-        "model": { "type": "string" },
-        "status": {
-          "type": "string",
-          "enum": ["PENDING", "RUNNING", "FINISHED", "ERROR", "SKIPPED"]
-        },
-        "durationMs": { "type": "number", "minimum": 0 },
-        "tokensUsed": { "type": "number", "minimum": 0 },
-        "failureCategory": { "type": "string" },
-        "normalizedFailureCategory": {
-          "type": "string",
-          "enum": [
-            "success",
-            "validation",
-            "executor",
-            "write-guard",
-            "timeout",
-            "auth",
-            "human-required",
-            "human-rejected",
-            "shell-command",
-            "static-error",
-            "decision-envelope",
-            "skipped",
-            "unknown"
-          ]
-        },
-        "productLineFailureCategory": {
-          "$ref": "#/$defs/dagProductLineFailureCategory"
-        },
-        "recommendedFollowUp": { "type": "string" },
-        "recoveryRecommendation": {
-          "$ref": "#/$defs/dagRecoveryRecommendation"
-        },
-        "backend": { "type": "string", "enum": ["sdk", "cli"] },
-        "sdkAttempted": { "type": "boolean" },
-        "startedAt": { "type": "string" },
-        "finishedAt": { "type": "string" },
-        "decisionEnvelope": { "$ref": "#/$defs/dagNodeDecisionEnvelope" },
-        "artifacts": { "$ref": "#/$defs/dagNodeArtifactsReport" }
-      }
-    },
-    "dagRunReportEntry": {
-      "type": "object",
-      "additionalProperties": false,
-      "required": [
-        "runId",
-        "title",
-        "lifecycle",
-        "status",
-        "runDir",
-        "startedAt",
-        "primaryFailure",
-        "primaryRecovery",
-        "downstreamSkippedNodes",
-        "executorJsonl",
-        "nodes"
-      ],
-      "properties": {
-        "runId": { "type": "string", "minLength": 1 },
-        "title": { "type": "string" },
-        "lifecycle": {
-          "type": "string",
-          "enum": ["active", "paused", "completed"]
-        },
-        "status": {
-          "type": "string",
-          "enum": [
-            "pending",
-            "running",
-            "finished",
-            "partial_failed",
-            "failed",
-            "paused",
-            "superseded",
-            "abandoned"
-          ]
-        },
-        "runDir": { "type": "string", "minLength": 1 },
-        "startedAt": { "type": "string", "minLength": 1 },
-        "finishedAt": { "type": "string" },
-        "failureCategory": { "type": "string" },
-        "normalizedFailureCategory": {
-          "type": "string",
-          "enum": [
-            "success",
-            "validation",
-            "executor",
-            "write-guard",
-            "timeout",
-            "auth",
-            "human-required",
-            "human-rejected",
-            "shell-command",
-            "static-error",
-            "decision-envelope",
-            "skipped",
-            "unknown"
-          ]
-        },
-        "productLineFailureCategory": {
-          "$ref": "#/$defs/dagProductLineFailureCategory"
-        },
-        "recommendedFollowUp": { "type": "string" },
-        "recoveryRecommendation": {
-          "$ref": "#/$defs/dagRecoveryRecommendation"
-        },
-        "primaryFailure": { "$ref": "#/$defs/dagReportPrimaryFailure" },
-        "primaryRecovery": { "$ref": "#/$defs/dagReportPrimaryRecovery" },
-        "downstreamSkippedNodes": {
-          "type": "array",
-          "items": { "$ref": "#/$defs/dagReportDownstreamSkippedNode" }
-        },
-        "pausedByNodeId": { "type": "string" },
-        "pauseReason": { "type": "string" },
-        "controllerIdentity": {
-          "type": "object",
-          "additionalProperties": false,
-          "required": ["status", "capturedAt", "runtimeContractCompatibility"],
-          "properties": {
-            "status": { "enum": ["pinned", "legacy-unpinned"] },
-            "capturedAt": { "type": "string" },
-            "packageName": { "type": "string" },
-            "packageVersion": { "type": "string" },
-            "packageFingerprint": { "type": "string" },
-            "binarySha256": { "type": "string" },
-            "runtimeContractCompatibility": {
-              "enum": ["compatible", "incompatible", "legacy-unspecified"]
-            },
-            "runtimeContractReason": { "type": "string" }
-          }
-        },
-        "executorJsonl": { "$ref": "#/$defs/dagArtifactRef" },
-        "convergence": { "$ref": "#/$defs/dagConvergence" },
-        "nodes": {
-          "type": "array",
-          "items": { "$ref": "#/$defs/dagNodeReportRow" }
-        }
-      }
-    }
-  }
-}
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://loop-agent.local/schemas/agent-dag-report.schema.json",
+  "title": "Agent DAG Report",
+  "description": "Stable JSON contract for `dag report --json` output consumed by Decision Gate evidence builders and operator tooling. Derived read-only view over `.harness/dag-runs/` canonical facts; never mutates run state.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "runs"],
+  "properties": {
+    "schemaVersion": {
+      "type": "integer",
+      "const": 1,
+      "description": "Report envelope schema version. Bump only when breaking stable fields."
+    },
+    "runs": {
+      "type": "array",
+      "items": { "$ref": "#/$defs/dagRunReportEntry" }
+    }
+  },
+  "$defs": {
+    "dagArtifactRef": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["path", "exists"],
+      "properties": {
+        "path": { "type": "string" },
+        "exists": { "type": "boolean" }
+      }
+    },
+    "dagRecoveryRecommendation": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "action",
+        "summary",
+        "reason",
+        "humanRequired",
+        "autoRetryEligible"
+      ],
+      "properties": {
+        "action": {
+          "type": "string",
+          "enum": [
+            "none",
+            "monitor",
+            "retry-node",
+            "rerun-after-fix",
+            "resume-or-reject",
+            "manual-review",
+            "inspect-upstream",
+            "unknown"
+          ]
+        },
+        "summary": { "type": "string" },
+        "reason": { "type": "string" },
+        "humanRequired": { "type": "boolean" },
+        "autoRetryEligible": { "type": "boolean" },
+        "commandHint": { "type": "string" }
+      }
+    },
+    "dagProductLineFailureCategory": {
+      "type": "string",
+      "enum": [
+        "SpecUnclear",
+        "ContractMismatch",
+        "ProductBug",
+        "TestBug",
+        "EnvFailure",
+        "FlakyTest",
+        "RiskyChange",
+        "DependencyFailure",
+        "NeedsHuman",
+        "Unknown"
+      ]
+    },
+    "dagReportPrimaryFailure": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["scope"],
+      "properties": {
+        "scope": { "type": "string", "enum": ["node", "run"] },
+        "nodeId": { "type": "string" },
+        "nodeStatus": {
+          "type": "string",
+          "enum": ["PENDING", "RUNNING", "FINISHED", "ERROR", "SKIPPED"]
+        },
+        "failureCategory": { "type": "string" },
+        "normalizedFailureCategory": {
+          "type": "string",
+          "enum": [
+            "success",
+            "validation",
+            "executor",
+            "write-guard",
+            "timeout",
+            "auth",
+            "human-required",
+            "human-rejected",
+            "shell-command",
+            "static-error",
+            "decision-envelope",
+            "skipped",
+            "unknown"
+          ]
+        },
+        "productLineFailureCategory": {
+          "$ref": "#/$defs/dagProductLineFailureCategory"
+        },
+        "recommendedFollowUp": { "type": "string" }
+      }
+    },
+    "dagReportPrimaryRecovery": {
+      "$ref": "#/$defs/dagRecoveryRecommendation"
+    },
+    "dagReportDownstreamSkippedNode": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["nodeId"],
+      "properties": {
+        "nodeId": { "type": "string" },
+        "failureCategory": { "type": "string" },
+        "normalizedFailureCategory": {
+          "type": "string",
+          "enum": [
+            "success",
+            "validation",
+            "executor",
+            "write-guard",
+            "timeout",
+            "auth",
+            "human-required",
+            "human-rejected",
+            "shell-command",
+            "static-error",
+            "decision-envelope",
+            "skipped",
+            "unknown"
+          ]
+        },
+        "productLineFailureCategory": {
+          "$ref": "#/$defs/dagProductLineFailureCategory"
+        },
+        "recommendedFollowUp": { "type": "string" }
+      }
+    },
+    "dagNodeDecisionEnvelope": {
+      "type": "object",
+      "additionalProperties": true,
+      "required": ["parseOk"],
+      "properties": {
+        "parseOk": { "type": "boolean" },
+        "decision": { "type": "string" },
+        "requiresHuman": { "type": "boolean" },
+        "nextAction": { "type": "string" },
+        "riskLevel": { "type": "string" },
+        "source": {
+          "type": "string",
+          "enum": ["assistantText", "resultSummaryFallback"]
+        },
+        "errors": {
+          "type": "array",
+          "items": { "type": "string" }
+        }
+      }
+    },
+    "dagNodeArtifactsReport": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "resultSummary",
+        "promptRedacted",
+        "skills",
+        "nodeRecord",
+        "decisionEnvelope",
+        "decisionEnvelopeValidation",
+        "humanEscalationJson",
+        "humanEscalationMd",
+        "humanApproval",
+        "humanRejection"
+      ],
+      "properties": {
+        "resultSummary": { "$ref": "#/$defs/dagArtifactRef" },
+        "promptRedacted": { "$ref": "#/$defs/dagArtifactRef" },
+        "skills": { "$ref": "#/$defs/dagArtifactRef" },
+        "nodeRecord": { "$ref": "#/$defs/dagArtifactRef" },
+        "decisionEnvelope": { "$ref": "#/$defs/dagArtifactRef" },
+        "decisionEnvelopeValidation": { "$ref": "#/$defs/dagArtifactRef" },
+        "humanEscalationJson": { "$ref": "#/$defs/dagArtifactRef" },
+        "humanEscalationMd": { "$ref": "#/$defs/dagArtifactRef" },
+        "humanApproval": { "$ref": "#/$defs/dagArtifactRef" },
+        "humanRejection": { "$ref": "#/$defs/dagArtifactRef" }
+      }
+    },
+    "repairArtifact": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "schemaVersion",
+        "verdict",
+        "failureClass",
+        "rootCause",
+        "fixScope",
+        "invariant",
+        "evidenceRefs",
+        "rawLogFallbackAllowed"
+      ],
+      "properties": {
+        "schemaVersion": { "type": "integer", "const": 1 },
+        "verdict": {
+          "type": "string",
+          "enum": ["pass", "request-revision"]
+        },
+        "failureClass": {
+          "type": "string",
+          "enum": [
+            "syntax",
+            "runtime",
+            "logic",
+            "boundary",
+            "environment",
+            "governance",
+            "unknown"
+          ]
+        },
+        "rootCause": { "type": "string", "minLength": 1 },
+        "fixScope": {
+          "type": "array",
+          "items": { "type": "string", "minLength": 1 }
+        },
+        "invariant": { "type": "string", "minLength": 1 },
+        "evidenceRefs": {
+          "type": "array",
+          "items": { "type": "string", "minLength": 1 }
+        },
+        "rawLogFallbackAllowed": { "type": "boolean" }
+      }
+    },
+    "dagConvergencePassArtifactRef": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["nodeId", "status"],
+      "properties": {
+        "nodeId": { "type": "string" },
+        "status": {
+          "type": "string",
+          "enum": ["PENDING", "RUNNING", "FINISHED", "ERROR", "SKIPPED"]
+        },
+        "failureCategory": { "type": "string" },
+        "nodeRecordPath": { "type": "string" },
+        "stdoutArtifactPath": { "type": "string" },
+        "assistantArtifactPath": { "type": "string" },
+        "preservedNodeRecordPath": { "type": "string" },
+        "preservedNodeDir": { "type": "string" }
+      }
+    },
+    "dagConvergencePass": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["pass", "finishedAt", "status", "reason", "artifactRefs"],
+      "properties": {
+        "pass": { "type": "integer", "minimum": 1 },
+        "startedAt": { "type": "string" },
+        "finishedAt": { "type": "string" },
+        "status": {
+          "type": "string",
+          "enum": ["retrying", "terminal", "paused"]
+        },
+        "reason": { "type": "string" },
+        "hardVerifyStatus": {
+          "type": "string",
+          "enum": ["PENDING", "RUNNING", "FINISHED", "ERROR", "SKIPPED"]
+        },
+        "hardVerifyFailureCategory": { "type": "string" },
+        "processVerdict": {
+          "type": "string",
+          "enum": ["pass", "request-revision", "unknown"]
+        },
+        "repairArtifact": { "$ref": "#/$defs/repairArtifact" },
+        "verifyPhase": {
+          "type": "string",
+          "enum": ["intermediate", "final"]
+        },
+        "verifyQuota": {
+          "type": "string",
+          "enum": ["1", "3", "full"]
+        },
+        "verifyCommandCount": { "type": "integer", "minimum": 0 },
+        "verifyCommandLabels": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "shellSuccessCount": { "type": "integer", "minimum": 0 },
+        "artifactRefs": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/dagConvergencePassArtifactRef" }
+        }
+      }
+    },
+    "dagConvergence": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["enabled", "maxPasses", "currentPass", "passHistory"],
+      "properties": {
+        "enabled": { "type": "boolean" },
+        "maxPasses": { "type": "integer", "minimum": 1 },
+        "currentPass": { "type": "integer", "minimum": 1 },
+        "terminalReason": { "type": "string" },
+        "passHistory": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/dagConvergencePass" }
+        }
+      }
+    },
+    "dagNodeReportRow": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "nodeId",
+        "rank",
+        "order",
+        "executor",
+        "status",
+        "artifacts"
+      ],
+      "properties": {
+        "nodeId": { "type": "string" },
+        "rank": { "type": "integer", "minimum": 0 },
+        "order": { "type": "integer", "minimum": 0 },
+        "executor": {
+          "type": "string",
+          "enum": ["pi", "shell", "static"]
+        },
+        "model": { "type": "string" },
+        "status": {
+          "type": "string",
+          "enum": ["PENDING", "RUNNING", "FINISHED", "ERROR", "SKIPPED"]
+        },
+        "durationMs": { "type": "number", "minimum": 0 },
+        "tokensUsed": { "type": "number", "minimum": 0 },
+        "failureCategory": { "type": "string" },
+        "normalizedFailureCategory": {
+          "type": "string",
+          "enum": [
+            "success",
+            "validation",
+            "executor",
+            "write-guard",
+            "timeout",
+            "auth",
+            "human-required",
+            "human-rejected",
+            "shell-command",
+            "static-error",
+            "decision-envelope",
+            "skipped",
+            "unknown"
+          ]
+        },
+        "productLineFailureCategory": {
+          "$ref": "#/$defs/dagProductLineFailureCategory"
+        },
+        "recommendedFollowUp": { "type": "string" },
+        "recoveryRecommendation": {
+          "$ref": "#/$defs/dagRecoveryRecommendation"
+        },
+        "backend": { "type": "string", "enum": ["sdk", "cli"] },
+        "sdkAttempted": { "type": "boolean" },
+        "startedAt": { "type": "string" },
+        "finishedAt": { "type": "string" },
+        "decisionEnvelope": { "$ref": "#/$defs/dagNodeDecisionEnvelope" },
+        "artifacts": { "$ref": "#/$defs/dagNodeArtifactsReport" }
+      }
+    },
+    "dagRunReportEntry": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "runId",
+        "title",
+        "lifecycle",
+        "status",
+        "runDir",
+        "startedAt",
+        "primaryFailure",
+        "primaryRecovery",
+        "downstreamSkippedNodes",
+        "executorJsonl",
+        "nodes"
+      ],
+      "properties": {
+        "runId": { "type": "string", "minLength": 1 },
+        "title": { "type": "string" },
+        "lifecycle": {
+          "type": "string",
+          "enum": ["active", "paused", "completed"]
+        },
+        "status": {
+          "type": "string",
+          "enum": [
+            "pending",
+            "running",
+            "finished",
+            "partial_failed",
+            "failed",
+            "paused",
+            "superseded",
+            "abandoned"
+          ]
+        },
+        "runDir": { "type": "string", "minLength": 1 },
+        "startedAt": { "type": "string", "minLength": 1 },
+        "finishedAt": { "type": "string" },
+        "failureCategory": { "type": "string" },
+        "normalizedFailureCategory": {
+          "type": "string",
+          "enum": [
+            "success",
+            "validation",
+            "executor",
+            "write-guard",
+            "timeout",
+            "auth",
+            "human-required",
+            "human-rejected",
+            "shell-command",
+            "static-error",
+            "decision-envelope",
+            "skipped",
+            "unknown"
+          ]
+        },
+        "productLineFailureCategory": {
+          "$ref": "#/$defs/dagProductLineFailureCategory"
+        },
+        "recommendedFollowUp": { "type": "string" },
+        "recoveryRecommendation": {
+          "$ref": "#/$defs/dagRecoveryRecommendation"
+        },
+        "primaryFailure": { "$ref": "#/$defs/dagReportPrimaryFailure" },
+        "primaryRecovery": { "$ref": "#/$defs/dagReportPrimaryRecovery" },
+        "downstreamSkippedNodes": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/dagReportDownstreamSkippedNode" }
+        },
+        "pausedByNodeId": { "type": "string" },
+        "pauseReason": { "type": "string" },
+        "controllerIdentity": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["status", "capturedAt", "runtimeContractCompatibility"],
+          "properties": {
+            "status": { "enum": ["pinned", "legacy-unpinned"] },
+            "capturedAt": { "type": "string" },
+            "packageName": { "type": "string" },
+            "packageVersion": { "type": "string" },
+            "packageFingerprint": { "type": "string" },
+            "binarySha256": { "type": "string" },
+            "runtimeContractCompatibility": {
+              "enum": ["compatible", "incompatible", "legacy-unspecified"]
+            },
+            "runtimeContractReason": { "type": "string" }
+          }
+        },
+        "executorJsonl": { "$ref": "#/$defs/dagArtifactRef" },
+        "convergence": { "$ref": "#/$defs/dagConvergence" },
+        "nodes": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/dagNodeReportRow" }
+        }
+      }
+    }
+  }
+}