@devtrack-solution/codesdd 1.2.2 → 1.2.3

package/schemas/sdd/deepagent-run-request.schema.json

@@ -0,0 +1,321 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "schema_version": {
+      "type": "number",
+      "const": 1
+    },
+    "contract": {
+      "type": "string",
+      "const": "deepagent-run-request/v1"
+    },
+    "provider": {
+      "type": "string",
+      "const": "deepagents"
+    },
+    "feature_ref": {
+      "type": "string",
+      "pattern": "^FEAT-\\d{4}$"
+    },
+    "mode": {
+      "type": "string",
+      "enum": [
+        "read-only",
+        "plan",
+        "validate",
+        "apply-sandbox",
+        "apply-approved"
+      ]
+    },
+    "objective": {
+      "type": "string",
+      "minLength": 1
+    },
+    "allowed_tools": {
+      "default": [],
+      "type": "array",
+      "items": {
+        "type": "string",
+        "minLength": 1
+      }
+    },
+    "write_scope": {
+      "type": "object",
+      "properties": {
+        "allow_project_writes": {
+          "default": false,
+          "type": "boolean"
+        },
+        "allowed_paths": {
+          "default": [],
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1
+          }
+        }
+      },
+      "required": [
+        "allow_project_writes",
+        "allowed_paths"
+      ],
+      "additionalProperties": false
+    },
+    "network_policy": {
+      "type": "object",
+      "properties": {
+        "mode": {
+          "default": "disabled",
+          "type": "string",
+          "enum": [
+            "disabled",
+            "restricted",
+            "enabled"
+          ]
+        },
+        "allowlist": {
+          "default": [],
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1
+          }
+        }
+      },
+      "required": [
+        "mode",
+        "allowlist"
+      ],
+      "additionalProperties": false
+    },
+    "env_contract": {
+      "type": "object",
+      "properties": {
+        "schema_version": {
+          "type": "number",
+          "const": 1
+        },
+        "contract": {
+          "type": "string",
+          "const": "deepagent-env-contract/v1"
+        },
+        "runtime_mode": {
+          "default": "disabled",
+          "type": "string",
+          "enum": [
+            "disabled",
+            "fake",
+            "deepagents-js"
+          ]
+        },
+        "model_ref": {
+          "type": "string",
+          "minLength": 1
+        },
+        "planner_model_ref": {
+          "type": "string",
+          "minLength": 1
+        },
+        "reviewer_model_ref": {
+          "type": "string",
+          "minLength": 1
+        },
+        "coder_model_ref": {
+          "type": "string",
+          "minLength": 1
+        },
+        "execution_limits": {
+          "default": {},
+          "type": "object",
+          "properties": {
+            "max_iterations": {
+              "type": "integer",
+              "exclusiveMinimum": 0,
+              "maximum": 9007199254740991
+            },
+            "max_subagents": {
+              "type": "integer",
+              "exclusiveMinimum": 0,
+              "maximum": 9007199254740991
+            },
+            "max_parallel": {
+              "type": "integer",
+              "exclusiveMinimum": 0,
+              "maximum": 9007199254740991
+            }
+          },
+          "additionalProperties": false
+        },
+        "provider_profile": {
+          "type": "string",
+          "minLength": 1
+        },
+        "env_allowlist": {
+          "default": [],
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1
+          }
+        },
+        "secret_refs": {
+          "default": [],
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1
+          }
+        },
+        "credential_env_refs": {
+          "default": [],
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1
+          }
+        },
+        "endpoint_env_refs": {
+          "default": [],
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1
+          }
+        },
+        "sandbox_passthrough_rules": {
+          "default": [],
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1
+          }
+        },
+        "network_mode": {
+          "default": "disabled",
+          "type": "string",
+          "enum": [
+            "disabled",
+            "restricted",
+            "enabled"
+          ]
+        },
+        "blocked_paths": {
+          "default": [],
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1
+          }
+        },
+        "masked_config_fingerprint": {
+          "type": "string",
+          "minLength": 1
+        }
+      },
+      "required": [
+        "schema_version",
+        "contract",
+        "runtime_mode",
+        "execution_limits",
+        "env_allowlist",
+        "secret_refs",
+        "credential_env_refs",
+        "endpoint_env_refs",
+        "sandbox_passthrough_rules",
+        "network_mode",
+        "blocked_paths",
+        "masked_config_fingerprint"
+      ],
+      "additionalProperties": false
+    },
+    "skill_ids": {
+      "default": [],
+      "type": "array",
+      "items": {
+        "type": "string",
+        "minLength": 1
+      }
+    },
+    "plugin_envelopes": {
+      "default": [],
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "plugin_id": {
+            "type": "string",
+            "minLength": 1
+          },
+          "capability": {
+            "type": "string",
+            "minLength": 1
+          },
+          "version": {
+            "type": "string",
+            "minLength": 1
+          }
+        },
+        "required": [
+          "plugin_id",
+          "capability",
+          "version"
+        ],
+        "additionalProperties": false
+      }
+    },
+    "reversa_scope": {
+      "type": "object",
+      "properties": {
+        "enabled": {
+          "default": false,
+          "type": "boolean"
+        },
+        "objective": {
+          "type": "string",
+          "minLength": 1
+        },
+        "targets": {
+          "default": [],
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1
+          }
+        }
+      },
+      "required": [
+        "enabled",
+        "targets"
+      ],
+      "additionalProperties": false
+    },
+    "expected_evidence": {
+      "minItems": 1,
+      "type": "array",
+      "items": {
+        "type": "string",
+        "minLength": 1
+      }
+    }
+  },
+  "required": [
+    "schema_version",
+    "contract",
+    "provider",
+    "feature_ref",
+    "mode",
+    "objective",
+    "allowed_tools",
+    "write_scope",
+    "network_policy",
+    "env_contract",
+    "skill_ids",
+    "plugin_envelopes",
+    "reversa_scope",
+    "expected_evidence"
+  ],
+  "additionalProperties": false,
+  "title": "CodeSDD DeepAgent Run Request",
+  "description": "Machine-readable request contract for governed DeepAgents execution with scoped tools, write policy, env contract, and expected evidence."
+}

package/schemas/sdd/deepagent-subagent-evidence.schema.json

@@ -0,0 +1,110 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "schema_version": {
+      "type": "number",
+      "const": 1
+    },
+    "contract": {
+      "type": "string",
+      "const": "deepagent-subagent-evidence/v1"
+    },
+    "subagent_name": {
+      "type": "string",
+      "minLength": 1
+    },
+    "prompt_purpose": {
+      "type": "string",
+      "minLength": 1
+    },
+    "tools_used": {
+      "default": [],
+      "type": "array",
+      "items": {
+        "type": "string",
+        "minLength": 1
+      }
+    },
+    "skills_used": {
+      "default": [],
+      "type": "array",
+      "items": {
+        "type": "string",
+        "minLength": 1
+      }
+    },
+    "inputs": {
+      "default": {},
+      "type": "object",
+      "propertyNames": {
+        "type": "string"
+      },
+      "additionalProperties": {}
+    },
+    "structured_output": {
+      "default": {},
+      "type": "object",
+      "propertyNames": {
+        "type": "string"
+      },
+      "additionalProperties": {}
+    },
+    "confidence": {
+      "type": "number",
+      "minimum": 0,
+      "maximum": 1
+    },
+    "risks": {
+      "default": [],
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": "string",
+            "minLength": 1
+          },
+          "severity": {
+            "type": "string",
+            "enum": [
+              "low",
+              "medium",
+              "high",
+              "critical"
+            ]
+          },
+          "summary": {
+            "type": "string",
+            "minLength": 1
+          },
+          "mitigation": {
+            "type": "string",
+            "minLength": 1
+          }
+        },
+        "required": [
+          "id",
+          "severity",
+          "summary"
+        ],
+        "additionalProperties": false
+      }
+    }
+  },
+  "required": [
+    "schema_version",
+    "contract",
+    "subagent_name",
+    "prompt_purpose",
+    "tools_used",
+    "skills_used",
+    "inputs",
+    "structured_output",
+    "confidence",
+    "risks"
+  ],
+  "additionalProperties": false,
+  "title": "CodeSDD DeepAgent Subagent Evidence",
+  "description": "Machine-readable subagent execution evidence contract with prompt purpose, tools, skills, structured output, confidence, and risks."
+}

package/schemas/sdd/deepagent-tool-call-evidence.schema.json

@@ -0,0 +1,78 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "schema_version": {
+      "type": "number",
+      "const": 1
+    },
+    "contract": {
+      "type": "string",
+      "const": "deepagent-tool-call-evidence/v1"
+    },
+    "tool_name": {
+      "type": "string",
+      "minLength": 1
+    },
+    "input_hash": {
+      "type": "string",
+      "minLength": 1
+    },
+    "output_hash": {
+      "type": "string",
+      "minLength": 1
+    },
+    "state_access_class": {
+      "type": "string",
+      "enum": [
+        "read",
+        "write",
+        "execute",
+        "network"
+      ]
+    },
+    "policy_gate": {
+      "type": "string",
+      "minLength": 1
+    },
+    "hitl_decision": {
+      "default": "none",
+      "type": "string",
+      "enum": [
+        "none",
+        "approve",
+        "reject",
+        "edit",
+        "respond"
+      ]
+    },
+    "duration_ms": {
+      "type": "integer",
+      "minimum": 0,
+      "maximum": 9007199254740991
+    },
+    "result": {
+      "type": "string",
+      "enum": [
+        "ok",
+        "error",
+        "blocked"
+      ]
+    }
+  },
+  "required": [
+    "schema_version",
+    "contract",
+    "tool_name",
+    "input_hash",
+    "output_hash",
+    "state_access_class",
+    "policy_gate",
+    "hitl_decision",
+    "duration_ms",
+    "result"
+  ],
+  "additionalProperties": false,
+  "title": "CodeSDD DeepAgent Tool Call Evidence",
+  "description": "Machine-readable tool call evidence contract with policy gates, HITL decisions, state access class, and execution results."
+}

package/schemas/sdd/discarded.schema.json

@@ -0,0 +1,127 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "schema_version": {
+      "type": "number",
+      "const": 1
+    },
+    "id": {
+      "type": "string",
+      "pattern": "^DEB-\\d{4}$"
+    },
+    "title": {
+      "type": "string",
+      "minLength": 1
+    },
+    "title_canonical": {
+      "type": "string",
+      "minLength": 1
+    },
+    "status": {
+      "type": "string",
+      "enum": [
+        "NEW",
+        "OPEN",
+        "DEBATED",
+        "PROMOTED",
+        "DROPPED",
+        "APPROVED",
+        "DISCARDED",
+        "SUPERSEDED",
+        "READY",
+        "PLANNED",
+        "IN_PROGRESS",
+        "DONE",
+        "CANCELLED"
+      ]
+    },
+    "origin": {
+      "type": "object",
+      "properties": {
+        "type": {
+          "type": "string",
+          "enum": [
+            "user_prompt",
+            "insight",
+            "debate",
+            "feature",
+            "source_intake"
+          ]
+        },
+        "ref": {
+          "type": "string",
+          "minLength": 1
+        }
+      },
+      "required": [
+        "type"
+      ],
+      "additionalProperties": false
+    },
+    "related_ids": {
+      "default": [],
+      "type": "array",
+      "items": {
+        "type": "string",
+        "minLength": 1
+      }
+    },
+    "created_at": {
+      "type": "string",
+      "format": "date-time",
+      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
+    },
+    "updated_at": {
+      "type": "string",
+      "format": "date-time",
+      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
+    },
+    "quality_contract": {
+      "type": "object",
+      "propertyNames": {
+        "type": "string"
+      },
+      "additionalProperties": {}
+    },
+    "artifact_type": {
+      "type": "string",
+      "const": "Discarded"
+    },
+    "discarded_from": {
+      "type": "string",
+      "pattern": "^DEB-\\d{4}$"
+    },
+    "discard_reason": {
+      "type": "string",
+      "minLength": 1
+    },
+    "discarded_at": {
+      "type": "string",
+      "format": "date-time",
+      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
+    },
+    "discarded_by": {
+      "type": "string",
+      "minLength": 1
+    }
+  },
+  "required": [
+    "schema_version",
+    "id",
+    "title",
+    "status",
+    "origin",
+    "related_ids",
+    "created_at",
+    "updated_at",
+    "artifact_type",
+    "discarded_from",
+    "discard_reason",
+    "discarded_at",
+    "discarded_by"
+  ],
+  "additionalProperties": false,
+  "title": "CodeSDD Discarded Frontmatter",
+  "description": "Machine-readable frontmatter contract for discarded governance artifacts with Markdown body compatibility."
+}