@devtrack-solution/codesdd 1.2.2 → 1.2.4-rc3

package/schemas/sdd/debate.schema.json

@@ -0,0 +1,244 @@
+{
+  "$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": "DEB"
+    },
+    "decision": {
+      "type": "object",
+      "properties": {
+        "question": {
+          "type": "string",
+          "minLength": 1
+        },
+        "options": {
+          "minItems": 1,
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "id": {
+                "type": "string",
+                "pattern": "^[A-Z]$"
+              },
+              "label": {
+                "type": "string",
+                "minLength": 1
+              }
+            },
+            "required": [
+              "id",
+              "label"
+            ],
+            "additionalProperties": false
+          }
+        },
+        "criteria": {
+          "default": [],
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1
+          }
+        },
+        "scoring": {
+          "default": [],
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "criterion": {
+                "type": "string",
+                "minLength": 1
+              },
+              "weight": {
+                "type": "number"
+              },
+              "scores": {
+                "type": "object",
+                "propertyNames": {
+                  "type": "string",
+                  "pattern": "^[A-Z]$"
+                },
+                "additionalProperties": {
+                  "type": "number"
+                }
+              }
+            },
+            "required": [
+              "criterion",
+              "weight",
+              "scores"
+            ],
+            "additionalProperties": false
+          }
+        },
+        "mediator": {
+          "type": "object",
+          "properties": {
+            "choice": {
+              "type": "string",
+              "pattern": "^[A-Z]$"
+            },
+            "rationale": {
+              "type": "string",
+              "minLength": 1
+            },
+            "accepted_risks": {
+              "default": [],
+              "type": "array",
+              "items": {
+                "type": "object",
+                "properties": {
+                  "risk": {
+                    "type": "string",
+                    "minLength": 1
+                  },
+                  "mitigation": {
+                    "type": "string",
+                    "minLength": 1
+                  }
+                },
+                "required": [
+                  "risk",
+                  "mitigation"
+                ],
+                "additionalProperties": false
+              }
+            },
+            "reversal_conditions": {
+              "default": [],
+              "type": "array",
+              "items": {
+                "type": "string",
+                "minLength": 1
+              }
+            }
+          },
+          "required": [
+            "choice",
+            "rationale",
+            "accepted_risks",
+            "reversal_conditions"
+          ],
+          "additionalProperties": false
+        },
+        "output": {
+          "type": "string",
+          "enum": [
+            "APPROVED",
+            "DISCARDED"
+          ]
+        }
+      },
+      "required": [
+        "question",
+        "options",
+        "criteria",
+        "scoring",
+        "mediator",
+        "output"
+      ],
+      "additionalProperties": false
+    }
+  },
+  "required": [
+    "schema_version",
+    "id",
+    "title",
+    "status",
+    "origin",
+    "related_ids",
+    "created_at",
+    "updated_at",
+    "artifact_type",
+    "decision"
+  ],
+  "additionalProperties": false,
+  "title": "CodeSDD Debate Frontmatter",
+  "description": "Machine-readable frontmatter contract for DEB governance artifacts with Markdown body compatibility."
+}

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

@@ -0,0 +1,58 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "schema_version": {
+      "type": "number",
+      "const": 1
+    },
+    "contract": {
+      "type": "string",
+      "const": "deepagent-decision-evidence/v1"
+    },
+    "decision_point": {
+      "type": "string",
+      "minLength": 1
+    },
+    "alternatives": {
+      "minItems": 1,
+      "type": "array",
+      "items": {
+        "type": "string",
+        "minLength": 1
+      }
+    },
+    "selected_option": {
+      "type": "string",
+      "minLength": 1
+    },
+    "adr_required": {
+      "type": "boolean"
+    },
+    "rationale": {
+      "type": "string",
+      "minLength": 1
+    },
+    "approvals": {
+      "default": [],
+      "type": "array",
+      "items": {
+        "type": "string",
+        "minLength": 1
+      }
+    }
+  },
+  "required": [
+    "schema_version",
+    "contract",
+    "decision_point",
+    "alternatives",
+    "selected_option",
+    "adr_required",
+    "rationale",
+    "approvals"
+  ],
+  "additionalProperties": false,
+  "title": "CodeSDD DeepAgent Decision Evidence",
+  "description": "Machine-readable decision trace contract for DeepAgents runs, including alternatives, approvals, ADR requirement, and rationale."
+}

package/schemas/sdd/deepagent-env-contract.schema.json

@@ -0,0 +1,143 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "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,
+  "title": "CodeSDD DeepAgent Environment Contract",
+  "description": "Machine-readable execution environment contract for DeepAgents runs, including env allowlist, secrets references, pass-through rules, and blocked paths."
+}

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

@@ -0,0 +1,108 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "schema_version": {
+      "type": "number",
+      "const": 1
+    },
+    "contract": {
+      "type": "string",
+      "const": "deepagent-quality-evidence/v1"
+    },
+    "matrix": {
+      "minItems": 1,
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "requirement_id": {
+            "type": "string",
+            "minLength": 1
+          },
+          "validation_id": {
+            "type": "string",
+            "minLength": 1
+          },
+          "evidence_refs": {
+            "default": [],
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "kind": {
+                  "type": "string",
+                  "minLength": 1
+                },
+                "ref": {
+                  "type": "string",
+                  "minLength": 1
+                },
+                "path": {
+                  "type": "string",
+                  "minLength": 1
+                }
+              },
+              "required": [
+                "kind",
+                "ref"
+              ],
+              "additionalProperties": false
+            }
+          },
+          "residual_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": [
+          "requirement_id",
+          "validation_id",
+          "evidence_refs",
+          "residual_risks"
+        ],
+        "additionalProperties": false
+      }
+    }
+  },
+  "required": [
+    "schema_version",
+    "contract",
+    "matrix"
+  ],
+  "additionalProperties": false,
+  "title": "CodeSDD DeepAgent Quality Evidence",
+  "description": "Machine-readable requirement-to-validation evidence matrix contract for DeepAgents runs, including residual risk traceability."
+}