@tea-agent/loop-agent 0.12.0 → 0.13.0-beta.0

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

@@ -1,383 +1,411 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://loop-agent.local/schemas/agent-dag.schema.json",
-  "title": "Agent DAG Spec",
-  "type": "object",
-  "additionalProperties": false,
-  "required": ["version", "title", "tasks"],
-  "allOf": [
-    {
-      "if": { "properties": { "version": { "const": 3 } }, "required": ["version"] },
-      "then": { "required": ["runtimeContract"] }
-    },
-    {
-      "if": { "required": ["runtimeContract"] },
-      "then": { "properties": { "version": { "const": 3 } } }
-    }
-  ],
-  "properties": {
-    "$schema": {
-      "type": "string"
-    },
-    "version": {
-      "enum": [1, 2, 3],
-      "default": 1
-    },
-    "title": {
-      "type": "string",
-      "minLength": 1
-    },
-    "runtimeContract": { "$ref": "#/$defs/runtimeContract" },
-    "objective": {
-      "type": "string"
-    },
-    "successCriteria": {
-      "type": "array",
-      "items": { "type": "string", "minLength": 1 }
-    },
-    "globalConstraints": {
-      "type": "array",
-      "items": { "type": "string", "minLength": 1 }
-    },
-    "verifyStrategy": { "$ref": "#/$defs/verifyStrategy" },
-    "defaults": {
-      "type": "object",
-      "additionalProperties": false,
-      "properties": {
-        "executor": { "$ref": "#/$defs/executor" },
-        "model": { "type": "string" },
-        "piBackend": {
-          "enum": ["sdk-first", "cli-only"],
-          "description": "Accepted metadata only. Runtime Pi backend selection is controlled by CODE_AGENT_PI_BACKEND."
-        },
-        "contextProfile": { "type": "string" },
-        "skills": {
-          "type": "array",
-          "items": { "type": "string", "minLength": 1 }
-        },
-        "writePolicy": { "$ref": "#/$defs/writePolicy" }
-      }
-    },
-    "skillsByRole": {
-      "type": "object",
-      "additionalProperties": {
-        "type": "array",
-        "items": { "type": "string", "minLength": 1 }
-      }
-    },
-    "executorModels": {
-      "type": "object",
-      "description": "Executor-owned model routing template keyed by executor then complexity. Do not use legacy top-level models or defaults.model.",
-      "additionalProperties": false,
-      "properties": {
-        "pi": { "$ref": "#/$defs/complexityModelMap" }
-      }
-    },
-    "tasks": {
-      "type": "array",
-      "minItems": 1,
-      "items": { "$ref": "#/$defs/task" }
-    }
-  },
-  "not": {
-    "required": ["models"]
-  },
-  "$defs": {
-    "runtimeContract": {
-      "type": "object",
-      "additionalProperties": false,
-      "required": ["schemaVersion", "agentRuntime", "repairWriterProtocol"],
-      "description": "DagSpec v3 controller capability handshake. Compatibility is decided by capability fields first; minimumControllerVersion is enforced when present. Legacy v1/v2 DAGs may omit this block.",
-      "properties": {
-        "schemaVersion": { "const": 1 },
-        "agentRuntime": { "const": "pi-only" },
-        "repairWriterProtocol": { "const": "explicit-node-v1" },
-        "minimumControllerVersion": {
-          "type": "string",
-          "pattern": "^\\d+\\.\\d+\\.\\d+([-+].+)?$"
-        }
-      }
-    },
-    "complexity": {
-      "enum": ["LOW", "MED", "HIGH"]
-    },
-    "executor": {
-      "enum": ["pi", "shell", "static"]
-    },
-    "toolProfile": {
-      "enum": ["read-only", "write"]
-    },
-    "role": {
-      "enum": ["planner", "scout", "implementer", "reviewer", "supervisor", "verifier", "closeout"]
-    },
-    "writePolicy": {
-      "enum": ["read-only", "docs-only", "exclusive", "none"]
-    },
-    "complexityModelMap": {
-      "type": "object",
-      "additionalProperties": false,
-      "properties": {
-        "LOW": { "type": "string", "minLength": 1 },
-        "MED": { "type": "string", "minLength": 1 },
-        "HIGH": { "type": "string", "minLength": 1 }
-      }
-    },
-    "verifyQuota": {
-      "enum": ["1", "3", "full"]
-    },
-    "verifyStrategy": {
-      "type": "object",
-      "additionalProperties": false,
-      "properties": {
-        "intermediateQuota": { "$ref": "#/$defs/verifyQuota" },
-        "finalQuota": {
-          "const": "full",
-          "default": "full",
-          "description": "Final completion verification cannot be quota-reduced."
-        },
-        "focusedCommandSource": {
-          "const": "adapter",
-          "default": "adapter"
-        }
-      }
-    },
-    "shellVerifyEvidence": {
-      "type": "object",
-      "additionalProperties": false,
-      "required": ["phase", "quota", "commandSource", "commandCount"],
-      "properties": {
-        "phase": { "enum": ["intermediate", "final"] },
-        "quota": { "$ref": "#/$defs/verifyQuota" },
-        "commandSource": { "enum": ["adapter", "inline"] },
-        "commandCount": { "type": "integer", "minimum": 0 },
-        "commandLabels": {
-          "type": "array",
-          "items": { "type": "string" },
-          "default": []
-        },
-        "finalFullRequired": { "type": "boolean" }
-      }
-    },
-    "repairArtifactGate": {
-      "type": "object",
-      "additionalProperties": false,
-      "required": ["fromNodeId"],
-      "properties": {
-        "fromNodeId": {
-          "type": "string",
-          "pattern": "^[a-z][a-z0-9-]*$"
-        },
-        "repairNodeId": {
-          "type": "string",
-          "pattern": "^[a-z][a-z0-9-]*$",
-          "description": "Explicit governed Pi repair writer this gate feeds (executor=pi, toolProfile=write, writePolicy=exclusive, non-empty allowedPaths+writeSet, depends_on the gate). New DAGs must set this; legacy DAGs are only accepted when a unique safe downstream Pi writer can be derived."
-        }
-      }
-    },
-    "shellConfig": {
-      "type": "object",
-      "additionalProperties": false,
-      "properties": {
-        "commands": {
-          "type": "array",
-          "items": { "type": "string", "minLength": 1 },
-          "default": []
-        },
-        "preset": {
-          "enum": ["loop-agent-standard-verify"]
-        },
-        "verdictGate": {
-          "type": "object",
-          "additionalProperties": false,
-          "required": ["fromNodeId", "accept"],
-          "properties": {
-            "fromNodeId": {
-              "type": "string",
-              "pattern": "^[a-z][a-z0-9-]*$",
-              "description": "Upstream node id whose canonical JSON output in the runner-injected current run directory ($HARNESS_DAG_RUN_DIR/<fromNodeId>.json) supplies the verdict line."
-            },
-            "accept": {
-              "type": "array",
-              "minItems": 1,
-              "items": { "type": "string", "minLength": 1 },
-              "description": "Exact assistantText/stdout verdict lines that pass the gate."
-            },
-            "label": {
-              "type": "string",
-              "minLength": 1,
-              "description": "Optional human-readable gate label for error messages."
-            },
-            "lineMode": {
-              "type": "string",
-              "enum": ["first-non-empty", "first-verdict-line"],
-              "default": "first-non-empty",
-              "description": "Selects how verdict gates parse assistant output: first non-empty line (legacy) or first normalized line starting with 'VERDICT:' (common whole-line Markdown emphasis is normalized before exact accept matching)."
-            }
-          }
-        },
-        "verifyEvidence": { "$ref": "#/$defs/shellVerifyEvidence" },
-        "repairArtifactGate": { "$ref": "#/$defs/repairArtifactGate" },
-        "envAllowlist": {
-          "type": "array",
-          "items": {
-            "type": "string",
-            "pattern": "^[A-Z_][A-Z0-9_]*$"
-          }
-        },
-        "timeoutMs": { "type": "number" },
-        "cwd": { "type": "string", "minLength": 1 }
-      },
-      "anyOf": [
-        { "required": ["commands"], "properties": { "commands": { "minItems": 1 } } },
-        { "required": ["preset"] },
-        { "required": ["verdictGate"] }
-      ]
-    },
-    "staticConfig": {
-      "type": "object",
-      "additionalProperties": false,
-      "required": ["resultMarkdown"],
-      "properties": {
-        "resultMarkdown": { "type": "string", "minLength": 1 },
-        "status": { "enum": ["success", "error"] }
-      }
-    },
-    "retryPolicy": {
-      "type": "object",
-      "additionalProperties": false,
-      "required": ["maxAttempts"],
-      "description": "Retry policy for safe read-only planner/scout/reviewer/verifier/closeout Pi nodes. Total attempts include the first try and are capped at five. Supervisors, implementers, and side-effecting nodes are ineligible. Only the categories listed in retryCategories are retried; quota/auth/invalid-output/write-guard are never retried.",
-      "properties": {
-        "maxAttempts": {
-          "type": "integer",
-          "minimum": 1,
-          "maximum": 5,
-          "description": "Total attempts including the first try. 1 disables retry."
-        },
-        "backoff": { "const": "exponential", "default": "exponential" },
-        "initialDelayMs": {
-          "type": "integer",
-          "minimum": 0,
-          "default": 2000
-        },
-        "maxDelayMs": {
-          "type": "integer",
-          "minimum": 0,
-          "default": 30000
-        },
-        "retryCategories": {
-          "type": "array",
-          "items": {
-            "enum": ["timeout", "network", "rate-limit", "unavailable"]
-          },
-          "default": ["timeout", "network", "rate-limit", "unavailable"],
-          "description": "Failure categories eligible for retry. quota is never eligible."
-        }
-      }
-    },
-    "promptSource": {
-      "type": "object",
-      "additionalProperties": false,
-      "required": ["type", "path", "sha256"],
-      "properties": {
-        "type": { "const": "markdown" },
-        "path": { "type": "string", "minLength": 1 },
-        "sha256": { "type": "string", "minLength": 1 }
-      }
-    },
-    "task": {
-      "type": "object",
-      "additionalProperties": false,
-      "required": ["id", "depends_on", "complexity"],
-      "properties": {
-        "id": {
-          "type": "string",
-          "pattern": "^[a-z][a-z0-9-]*$"
-        },
-        "depends_on": {
-          "type": "array",
-          "items": { "type": "string", "pattern": "^[a-z][a-z0-9-]*$" },
-          "default": []
-        },
-        "complexity": { "$ref": "#/$defs/complexity" },
-        "subtask_prompt": {
-          "type": "string",
-          "minLength": 1
-        },
-        "subtask_prompt_markdown": {
-          "type": "string",
-          "minLength": 1
-        },
-        "subtask_prompt_source": { "$ref": "#/$defs/promptSource" },
-        "executor": {
-          "$ref": "#/$defs/executor",
-          "default": "pi"
-        },
-        "role": { "$ref": "#/$defs/role" },
-        "skills": {
-          "type": "array",
-          "items": { "type": "string", "minLength": 1 }
-        },
-        "toolProfile": { "$ref": "#/$defs/toolProfile" },
-        "writePolicy": { "$ref": "#/$defs/writePolicy" },
-        "writeSet": {
-          "type": "array",
-          "items": { "type": "string", "minLength": 1 }
-        },
-        "piStep": {
-          "type": "string",
-          "minLength": 1
-        },
-        "shell": {
-          "$ref": "#/$defs/shellConfig"
-        },
-        "static": {
-          "$ref": "#/$defs/staticConfig"
-        },
-        "outputContract": {
-          "type": "string",
-          "minLength": 1
-        },
-        "allowedPaths": {
-          "type": "array",
-          "items": { "type": "string", "minLength": 1 },
-          "default": []
-        },
-        "forbiddenPaths": {
-          "type": "array",
-          "items": { "type": "string", "minLength": 1 },
-          "default": []
-        },
-        "decisionGate": {
-          "type": "object",
-          "additionalProperties": false,
-          "required": ["enabled"],
-          "properties": {
-            "enabled": { "type": "boolean" },
-            "schemaVersion": { "const": 1 },
-            "mode": {
-              "enum": ["record-only", "pause-on-human"],
-              "default": "record-only"
-            }
-          }
-        },
-        "retryPolicy": {
-          "$ref": "#/$defs/retryPolicy",
-          "description": "Opt-in retry policy. Allowed only on safe read-only planner/scout/reviewer/verifier/closeout non-dynamic Pi nodes; validation rejects it on supervisors, implementers, writers, dynamic, shell, static, docs-only, and decision-gate nodes. Generated DAGs declare the default policy on eligible nodes automatically."
-        }
-      },
-      "oneOf": [
-        {
-          "description": "Inline prompt only; subtask_prompt_markdown must be absent.",
-          "required": ["subtask_prompt"],
-          "not": { "required": ["subtask_prompt_markdown"] }
-        },
-        {
-          "description": "Markdown-backed prompt only; subtask_prompt must be absent until file loader resolves it.",
-          "required": ["subtask_prompt_markdown"],
-          "not": { "required": ["subtask_prompt"] }
-        }
-      ]
-    }
-  }
-}
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://loop-agent.local/schemas/agent-dag.schema.json",
+  "title": "Agent DAG Spec",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["version", "title", "tasks"],
+  "allOf": [
+    {
+      "if": { "properties": { "version": { "const": 3 } }, "required": ["version"] },
+      "then": { "required": ["runtimeContract"] }
+    },
+    {
+      "if": { "required": ["runtimeContract"] },
+      "then": { "properties": { "version": { "const": 3 } } }
+    }
+  ],
+  "properties": {
+    "$schema": {
+      "type": "string"
+    },
+    "version": {
+      "enum": [1, 2, 3],
+      "default": 1
+    },
+    "title": {
+      "type": "string",
+      "minLength": 1
+    },
+    "runtimeContract": { "$ref": "#/$defs/runtimeContract" },
+    "sourceBinding": { "$ref": "#/$defs/sourceBinding" },
+    "objective": {
+      "type": "string"
+    },
+    "successCriteria": {
+      "type": "array",
+      "items": { "type": "string", "minLength": 1 }
+    },
+    "globalConstraints": {
+      "type": "array",
+      "items": { "type": "string", "minLength": 1 }
+    },
+    "verifyStrategy": { "$ref": "#/$defs/verifyStrategy" },
+    "defaults": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "executor": { "$ref": "#/$defs/executor" },
+        "model": { "type": "string" },
+        "piBackend": {
+          "enum": ["sdk-first", "cli-only"],
+          "description": "Accepted metadata only. Runtime Pi backend selection is controlled by CODE_AGENT_PI_BACKEND."
+        },
+        "contextProfile": { "type": "string" },
+        "skills": {
+          "type": "array",
+          "items": { "type": "string", "minLength": 1 }
+        },
+        "writePolicy": { "$ref": "#/$defs/writePolicy" }
+      }
+    },
+    "skillsByRole": {
+      "type": "object",
+      "additionalProperties": {
+        "type": "array",
+        "items": { "type": "string", "minLength": 1 }
+      }
+    },
+    "executorModels": {
+      "type": "object",
+      "description": "Executor-owned model routing template keyed by executor then complexity. Do not use legacy top-level models or defaults.model.",
+      "additionalProperties": false,
+      "properties": {
+        "pi": { "$ref": "#/$defs/complexityModelMap" }
+      }
+    },
+    "tasks": {
+      "type": "array",
+      "minItems": 1,
+      "items": { "$ref": "#/$defs/task" }
+    }
+  },
+  "not": {
+    "required": ["models"]
+  },
+  "$defs": {
+    "runtimeContract": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["schemaVersion", "agentRuntime", "repairWriterProtocol"],
+      "description": "DagSpec v3 controller capability handshake. Compatibility is decided by capability fields first; minimumControllerVersion is enforced when present. Legacy v1/v2 DAGs may omit this block.",
+      "properties": {
+        "schemaVersion": { "const": 1 },
+        "agentRuntime": { "const": "pi-only" },
+        "repairWriterProtocol": { "const": "explicit-node-v1" },
+        "minimumControllerVersion": {
+          "type": "string",
+          "pattern": "^\\d+\\.\\d+\\.\\d+([-+].+)?$"
+        }
+      }
+    },
+    "sourceBinding": {
+      "type": "object", "additionalProperties": false,
+      "required": ["schemaVersion", "taskId", "sources", "requirementIds"],
+      "properties": {
+        "schemaVersion": { "const": 1 },
+        "taskId": { "type": "string", "minLength": 1 },
+        "sources": { "type": "array", "minItems": 1, "items": {
+          "type": "object", "additionalProperties": false, "required": ["kind", "path", "sha256"],
+          "properties": {
+            "kind": { "enum": ["requirement", "constraint", "reference"] },
+            "path": { "type": "string", "minLength": 1 },
+            "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }
+          }
+        } },
+        "requirementIds": { "type": "array", "items": { "type": "string", "pattern": "^(?:REQ|BR|AC)-[A-Z0-9]+(?:-[A-Z0-9]+)*$" } }
+      }
+    },
+    "complexity": {
+      "enum": ["LOW", "MED", "HIGH"]
+    },
+    "executor": {
+      "enum": ["pi", "shell", "static"]
+    },
+    "toolProfile": {
+      "enum": ["read-only", "write"]
+    },
+    "role": {
+      "enum": ["planner", "scout", "implementer", "reviewer", "supervisor", "verifier", "closeout"]
+    },
+    "writePolicy": {
+      "enum": ["read-only", "docs-only", "exclusive", "none"]
+    },
+    "complexityModelMap": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "LOW": { "type": "string", "minLength": 1 },
+        "MED": { "type": "string", "minLength": 1 },
+        "HIGH": { "type": "string", "minLength": 1 }
+      }
+    },
+    "verifyQuota": {
+      "enum": ["1", "3", "full"]
+    },
+    "verifyStrategy": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "intermediateQuota": { "$ref": "#/$defs/verifyQuota" },
+        "finalQuota": {
+          "const": "full",
+          "default": "full",
+          "description": "Final completion verification cannot be quota-reduced."
+        },
+        "focusedCommandSource": {
+          "const": "adapter",
+          "default": "adapter"
+        }
+      }
+    },
+    "shellVerifyEvidence": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["phase", "quota", "commandSource", "commandCount"],
+      "properties": {
+        "phase": { "enum": ["intermediate", "final"] },
+        "quota": { "$ref": "#/$defs/verifyQuota" },
+        "commandSource": { "enum": ["adapter", "inline"] },
+        "commandCount": { "type": "integer", "minimum": 0 },
+        "commandLabels": {
+          "type": "array",
+          "items": { "type": "string" },
+          "default": []
+        },
+        "finalFullRequired": { "type": "boolean" }
+      }
+    },
+    "repairArtifactGate": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["fromNodeId"],
+      "properties": {
+        "fromNodeId": {
+          "type": "string",
+          "pattern": "^[a-z][a-z0-9-]*$"
+        },
+        "repairNodeId": {
+          "type": "string",
+          "pattern": "^[a-z][a-z0-9-]*$",
+          "description": "Explicit governed Pi repair writer this gate feeds (executor=pi, toolProfile=write, writePolicy=exclusive, non-empty allowedPaths+writeSet, depends_on the gate). New DAGs must set this; legacy DAGs are only accepted when a unique safe downstream Pi writer can be derived."
+        }
+      }
+    },
+    "shellConfig": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "commands": {
+          "type": "array",
+          "items": { "type": "string", "minLength": 1 },
+          "default": []
+        },
+        "preset": {
+          "enum": ["loop-agent-standard-verify"]
+        },
+        "verdictGate": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["fromNodeId", "accept"],
+          "properties": {
+            "fromNodeId": {
+              "type": "string",
+              "pattern": "^[a-z][a-z0-9-]*$",
+              "description": "Upstream node id whose canonical JSON output in the runner-injected current run directory ($HARNESS_DAG_RUN_DIR/<fromNodeId>.json) supplies the verdict line."
+            },
+            "accept": {
+              "type": "array",
+              "minItems": 1,
+              "items": { "type": "string", "minLength": 1 },
+              "description": "Exact assistantText/stdout verdict lines that pass the gate."
+            },
+            "label": {
+              "type": "string",
+              "minLength": 1,
+              "description": "Optional human-readable gate label for error messages."
+            },
+            "lineMode": {
+              "type": "string",
+              "enum": ["first-non-empty", "first-verdict-line"],
+              "default": "first-non-empty",
+              "description": "Selects how verdict gates parse assistant output: first non-empty line (legacy) or first normalized line starting with 'VERDICT:' (common whole-line Markdown emphasis is normalized before exact accept matching)."
+            }
+          }
+        },
+        "requirementCoverageGate": {
+          "type": "object", "additionalProperties": false,
+          "required": ["fromNodeIds", "requiredIds"],
+          "properties": {
+            "fromNodeIds": { "type": "array", "minItems": 1, "items": { "type": "string", "pattern": "^[a-z][a-z0-9-]*$" } },
+            "requiredIds": { "type": "array", "minItems": 1, "items": { "type": "string", "pattern": "^(?:REQ|BR|AC)-[A-Z0-9]+(?:-[A-Z0-9]+)*$" } },
+            "label": { "type": "string", "minLength": 1 }
+          }
+        },
+        "verifyEvidence": { "$ref": "#/$defs/shellVerifyEvidence" },
+        "repairArtifactGate": { "$ref": "#/$defs/repairArtifactGate" },
+        "envAllowlist": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "pattern": "^[A-Z_][A-Z0-9_]*$"
+          }
+        },
+        "timeoutMs": { "type": "number" },
+        "cwd": { "type": "string", "minLength": 1 }
+      },
+      "anyOf": [
+        { "required": ["commands"], "properties": { "commands": { "minItems": 1 } } },
+        { "required": ["preset"] },
+        { "required": ["verdictGate"] },
+        { "required": ["requirementCoverageGate"] }
+      ]
+    },
+    "staticConfig": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["resultMarkdown"],
+      "properties": {
+        "resultMarkdown": { "type": "string", "minLength": 1 },
+        "status": { "enum": ["success", "error"] }
+      }
+    },
+    "retryPolicy": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["maxAttempts"],
+      "description": "Retry policy for safe read-only planner/scout/reviewer/verifier/closeout Pi nodes. Total attempts include the first try and are capped at five. Supervisors, implementers, and side-effecting nodes are ineligible. Only the categories listed in retryCategories are retried; quota/auth/invalid-output/write-guard are never retried.",
+      "properties": {
+        "maxAttempts": {
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 5,
+          "description": "Total attempts including the first try. 1 disables retry."
+        },
+        "backoff": { "const": "exponential", "default": "exponential" },
+        "initialDelayMs": {
+          "type": "integer",
+          "minimum": 0,
+          "default": 2000
+        },
+        "maxDelayMs": {
+          "type": "integer",
+          "minimum": 0,
+          "default": 30000
+        },
+        "retryCategories": {
+          "type": "array",
+          "items": {
+            "enum": ["timeout", "network", "rate-limit", "unavailable"]
+          },
+          "default": ["timeout", "network", "rate-limit", "unavailable"],
+          "description": "Failure categories eligible for retry. quota is never eligible."
+        }
+      }
+    },
+    "promptSource": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["type", "path", "sha256"],
+      "properties": {
+        "type": { "const": "markdown" },
+        "path": { "type": "string", "minLength": 1 },
+        "sha256": { "type": "string", "minLength": 1 }
+      }
+    },
+    "task": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "depends_on", "complexity"],
+      "properties": {
+        "id": {
+          "type": "string",
+          "pattern": "^[a-z][a-z0-9-]*$"
+        },
+        "depends_on": {
+          "type": "array",
+          "items": { "type": "string", "pattern": "^[a-z][a-z0-9-]*$" },
+          "default": []
+        },
+        "complexity": { "$ref": "#/$defs/complexity" },
+        "subtask_prompt": {
+          "type": "string",
+          "minLength": 1
+        },
+        "subtask_prompt_markdown": {
+          "type": "string",
+          "minLength": 1
+        },
+        "subtask_prompt_source": { "$ref": "#/$defs/promptSource" },
+        "executor": {
+          "$ref": "#/$defs/executor",
+          "default": "pi"
+        },
+        "role": { "$ref": "#/$defs/role" },
+        "skills": {
+          "type": "array",
+          "items": { "type": "string", "minLength": 1 }
+        },
+        "toolProfile": { "$ref": "#/$defs/toolProfile" },
+        "writePolicy": { "$ref": "#/$defs/writePolicy" },
+        "writeSet": {
+          "type": "array",
+          "items": { "type": "string", "minLength": 1 }
+        },
+        "piStep": {
+          "type": "string",
+          "minLength": 1
+        },
+        "shell": {
+          "$ref": "#/$defs/shellConfig"
+        },
+        "static": {
+          "$ref": "#/$defs/staticConfig"
+        },
+        "outputContract": {
+          "type": "string",
+          "minLength": 1
+        },
+        "allowedPaths": {
+          "type": "array",
+          "items": { "type": "string", "minLength": 1 },
+          "default": []
+        },
+        "forbiddenPaths": {
+          "type": "array",
+          "items": { "type": "string", "minLength": 1 },
+          "default": []
+        },
+        "decisionGate": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["enabled"],
+          "properties": {
+            "enabled": { "type": "boolean" },
+            "schemaVersion": { "const": 1 },
+            "mode": {
+              "enum": ["record-only", "pause-on-human"],
+              "default": "record-only"
+            }
+          }
+        },
+        "retryPolicy": {
+          "$ref": "#/$defs/retryPolicy",
+          "description": "Opt-in retry policy. Allowed only on safe read-only planner/scout/reviewer/verifier/closeout non-dynamic Pi nodes; validation rejects it on supervisors, implementers, writers, dynamic, shell, static, docs-only, and decision-gate nodes. Generated DAGs declare the default policy on eligible nodes automatically."
+        }
+      },
+      "oneOf": [
+        {
+          "description": "Inline prompt only; subtask_prompt_markdown must be absent.",
+          "required": ["subtask_prompt"],
+          "not": { "required": ["subtask_prompt_markdown"] }
+        },
+        {
+          "description": "Markdown-backed prompt only; subtask_prompt must be absent until file loader resolves it.",
+          "required": ["subtask_prompt_markdown"],
+          "not": { "required": ["subtask_prompt"] }
+        }
+      ]
+    }
+  }
+}