@devtrack-solution/codesdd 1.2.3 → 1.2.4-rc3

package/schemas/sdd/5-quality.schema.json

@@ -14,10 +14,14 @@
       "type": "object",
       "properties": {
         "unit": {
-          "type": "number"
+          "type": "number",
+          "minimum": 0,
+          "maximum": 100
         },
         "integration": {
-          "type": "number"
+          "type": "number",
+          "minimum": 0,
+          "maximum": 100
         },
         "modules": {
           "type": "object",
@@ -25,7 +29,9 @@
             "type": "string"
           },
           "additionalProperties": {
-            "type": "number"
+            "type": "number",
+            "minimum": 0,
+            "maximum": 100
           }
         }
       },
@@ -585,6 +591,215 @@
       ],
       "additionalProperties": false
     },
+    "token_budget_gates": {
+      "default": {
+        "require_numeric_efficiency": true,
+        "fail_below_percent": 95,
+        "telemetry": []
+      },
+      "type": "object",
+      "properties": {
+        "max_context_chars": {
+          "type": "integer",
+          "exclusiveMinimum": 0,
+          "maximum": 9007199254740991
+        },
+        "require_numeric_efficiency": {
+          "default": true,
+          "type": "boolean"
+        },
+        "fail_below_percent": {
+          "default": 95,
+          "type": "number",
+          "minimum": 0,
+          "maximum": 100
+        },
+        "telemetry": {
+          "default": [],
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "mode": {
+                "type": "string",
+                "enum": [
+                  "compact",
+                  "standard",
+                  "full"
+                ]
+              },
+              "budget_chars": {
+                "type": "integer",
+                "exclusiveMinimum": 0,
+                "maximum": 9007199254740991
+              },
+              "actual_chars": {
+                "type": "integer",
+                "minimum": 0,
+                "maximum": 9007199254740991
+              },
+              "efficiency_percent": {
+                "type": "number",
+                "minimum": 0,
+                "maximum": 100
+              },
+              "gate": {
+                "default": "pass",
+                "type": "string",
+                "enum": [
+                  "pass",
+                  "warn",
+                  "fail"
+                ]
+              },
+              "evidence_ref": {
+                "type": "string",
+                "minLength": 1
+              },
+              "notes": {
+                "type": "string"
+              }
+            },
+            "required": [
+              "gate"
+            ],
+            "additionalProperties": false
+          }
+        }
+      },
+      "required": [
+        "require_numeric_efficiency",
+        "fail_below_percent",
+        "telemetry"
+      ],
+      "additionalProperties": false
+    },
+    "runtime_quality_gates": {
+      "default": {
+        "mode": "observe",
+        "performance": [],
+        "flakiness": []
+      },
+      "type": "object",
+      "properties": {
+        "mode": {
+          "default": "observe",
+          "type": "string",
+          "enum": [
+            "observe",
+            "enforce"
+          ]
+        },
+        "performance": {
+          "default": [],
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "command": {
+                "type": "string",
+                "minLength": 1
+              },
+              "metric": {
+                "default": "duration_ms",
+                "type": "string",
+                "enum": [
+                  "duration_ms",
+                  "p95_ms",
+                  "memory_mb",
+                  "cpu_percent"
+                ]
+              },
+              "threshold": {
+                "type": "number",
+                "minimum": 0
+              },
+              "actual": {
+                "type": "number",
+                "minimum": 0
+              },
+              "gate": {
+                "default": "pass",
+                "type": "string",
+                "enum": [
+                  "pass",
+                  "warn",
+                  "fail"
+                ]
+              },
+              "evidence_ref": {
+                "type": "string",
+                "minLength": 1
+              },
+              "notes": {
+                "type": "string"
+              }
+            },
+            "required": [
+              "command",
+              "metric",
+              "gate"
+            ],
+            "additionalProperties": false
+          }
+        },
+        "flakiness": {
+          "default": [],
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "command": {
+                "type": "string",
+                "minLength": 1
+              },
+              "attempts": {
+                "type": "integer",
+                "exclusiveMinimum": 0,
+                "maximum": 9007199254740991
+              },
+              "failures": {
+                "type": "integer",
+                "minimum": 0,
+                "maximum": 9007199254740991
+              },
+              "failure_rate_percent": {
+                "type": "number",
+                "minimum": 0,
+                "maximum": 100
+              },
+              "gate": {
+                "default": "pass",
+                "type": "string",
+                "enum": [
+                  "pass",
+                  "warn",
+                  "fail"
+                ]
+              },
+              "evidence_ref": {
+                "type": "string",
+                "minLength": 1
+              },
+              "notes": {
+                "type": "string"
+              }
+            },
+            "required": [
+              "command",
+              "gate"
+            ],
+            "additionalProperties": false
+          }
+        }
+      },
+      "required": [
+        "mode",
+        "performance",
+        "flakiness"
+      ],
+      "additionalProperties": false
+    },
     "q95_ledger": {
       "default": {
         "threshold": 95,
@@ -631,11 +846,15 @@
       "properties": {
         "threshold": {
           "default": 95,
-          "type": "number"
+          "type": "number",
+          "minimum": 0,
+          "maximum": 100
         },
         "score": {
           "default": 0,
-          "type": "number"
+          "type": "number",
+          "minimum": 0,
+          "maximum": 100
         },
         "status": {
           "default": "pending",
@@ -662,23 +881,33 @@
           "properties": {
             "coverage": {
               "default": 30,
-              "type": "number"
+              "type": "number",
+              "minimum": 0,
+              "maximum": 100
             },
             "traceability": {
               "default": 20,
-              "type": "number"
+              "type": "number",
+              "minimum": 0,
+              "maximum": 100
             },
             "integrity": {
               "default": 20,
-              "type": "number"
+              "type": "number",
+              "minimum": 0,
+              "maximum": 100
             },
             "naming": {
               "default": 10,
-              "type": "number"
+              "type": "number",
+              "minimum": 0,
+              "maximum": 100
             },
             "token": {
               "default": 20,
-              "type": "number"
+              "type": "number",
+              "minimum": 0,
+              "maximum": 100
             }
           },
           "required": [
@@ -724,13 +953,18 @@
               "type": "object",
               "properties": {
                 "raw_score": {
-                  "type": "number"
+                  "type": "number",
+                  "minimum": 0,
+                  "maximum": 100
                 },
                 "weighted_score": {
-                  "type": "number"
+                  "type": "number",
+                  "minimum": 0,
+                  "maximum": 100
                 },
                 "rationale": {
-                  "type": "string"
+                  "type": "string",
+                  "minLength": 1
                 }
               },
               "required": [
@@ -744,13 +978,18 @@
               "type": "object",
               "properties": {
                 "raw_score": {
-                  "type": "number"
+                  "type": "number",
+                  "minimum": 0,
+                  "maximum": 100
                 },
                 "weighted_score": {
-                  "type": "number"
+                  "type": "number",
+                  "minimum": 0,
+                  "maximum": 100
                 },
                 "rationale": {
-                  "type": "string"
+                  "type": "string",
+                  "minLength": 1
                 }
               },
               "required": [
@@ -764,13 +1003,18 @@
               "type": "object",
               "properties": {
                 "raw_score": {
-                  "type": "number"
+                  "type": "number",
+                  "minimum": 0,
+                  "maximum": 100
                 },
                 "weighted_score": {
-                  "type": "number"
+                  "type": "number",
+                  "minimum": 0,
+                  "maximum": 100
                 },
                 "rationale": {
-                  "type": "string"
+                  "type": "string",
+                  "minLength": 1
                 }
               },
               "required": [
@@ -784,13 +1028,18 @@
               "type": "object",
               "properties": {
                 "raw_score": {
-                  "type": "number"
+                  "type": "number",
+                  "minimum": 0,
+                  "maximum": 100
                 },
                 "weighted_score": {
-                  "type": "number"
+                  "type": "number",
+                  "minimum": 0,
+                  "maximum": 100
                 },
                 "rationale": {
-                  "type": "string"
+                  "type": "string",
+                  "minLength": 1
                 }
               },
               "required": [
@@ -804,13 +1053,18 @@
               "type": "object",
               "properties": {
                 "raw_score": {
-                  "type": "number"
+                  "type": "number",
+                  "minimum": 0,
+                  "maximum": 100
                 },
                 "weighted_score": {
-                  "type": "number"
+                  "type": "number",
+                  "minimum": 0,
+                  "maximum": 100
                 },
                 "rationale": {
-                  "type": "string"
+                  "type": "string",
+                  "minLength": 1
                 }
               },
               "required": [
@@ -859,6 +1113,8 @@
     "exceptions",
     "remediation_policy",
     "traceability",
+    "token_budget_gates",
+    "runtime_quality_gates",
     "q95_ledger"
   ],
   "additionalProperties": false,

package/schemas/sdd/agent-runtime-command-plan.schema.json

@@ -0,0 +1,212 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "schema_version": {
+      "type": "number",
+      "const": 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))$"
+    },
+    "status": {
+      "type": "string",
+      "enum": [
+        "planned",
+        "blocked"
+      ]
+    },
+    "request": {
+      "type": "object",
+      "properties": {
+        "schema_version": {
+          "default": 1,
+          "type": "number",
+          "const": 1
+        },
+        "feature_ref": {
+          "type": "string",
+          "pattern": "^FEAT-\\d{4}$"
+        },
+        "provider": {
+          "type": "string",
+          "enum": [
+            "deepagents",
+            "codex",
+            "opencode"
+          ]
+        },
+        "mode": {
+          "default": "plan",
+          "type": "string",
+          "enum": [
+            "read-only",
+            "plan",
+            "validate",
+            "apply-sandbox",
+            "apply-approved"
+          ]
+        },
+        "instruction": {
+          "type": "string",
+          "minLength": 1
+        },
+        "cwd": {
+          "default": ".",
+          "type": "string",
+          "minLength": 1
+        },
+        "model": {
+          "type": "string",
+          "minLength": 1
+        },
+        "sandbox": {
+          "default": "read-only",
+          "type": "string",
+          "enum": [
+            "read-only",
+            "workspace-write",
+            "danger-full-access"
+          ]
+        },
+        "output_schema": {
+          "type": "string",
+          "minLength": 1
+        },
+        "output_last_message": {
+          "type": "string",
+          "minLength": 1
+        },
+        "agent": {
+          "type": "string",
+          "minLength": 1
+        },
+        "session": {
+          "type": "string",
+          "minLength": 1
+        },
+        "files": {
+          "default": [],
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1
+          }
+        },
+        "approval_grants": {
+          "default": [],
+          "type": "array",
+          "items": {
+            "type": "string",
+            "enum": [
+              "maintainer",
+              "architecture-board",
+              "security"
+            ]
+          }
+        }
+      },
+      "required": [
+        "schema_version",
+        "feature_ref",
+        "provider",
+        "mode",
+        "instruction",
+        "cwd",
+        "sandbox",
+        "files",
+        "approval_grants"
+      ],
+      "additionalProperties": false
+    },
+    "provider": {
+      "type": "string",
+      "enum": [
+        "deepagents",
+        "codex",
+        "opencode"
+      ]
+    },
+    "command": {
+      "type": "object",
+      "properties": {
+        "executable": {
+          "type": "string",
+          "minLength": 1
+        },
+        "args": {
+          "default": [],
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "stdin": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "executable",
+        "args"
+      ],
+      "additionalProperties": false
+    },
+    "evidence_contract": {
+      "type": "string",
+      "enum": [
+        "agent-runtime-v2/deepagents",
+        "agent-runtime-v2/codex-exec",
+        "agent-runtime-v2/opencode-run"
+      ]
+    },
+    "structured_output": {
+      "type": "boolean"
+    },
+    "reasons": {
+      "default": [],
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
+    "policy": {
+      "type": "object",
+      "properties": {
+        "direct_state_write_allowed": {
+          "type": "boolean",
+          "const": false
+        },
+        "requires_codesdd_finalize": {
+          "type": "boolean",
+          "const": true
+        },
+        "mutating_modes_require_approval": {
+          "type": "boolean",
+          "const": true
+        }
+      },
+      "required": [
+        "direct_state_write_allowed",
+        "requires_codesdd_finalize",
+        "mutating_modes_require_approval"
+      ],
+      "additionalProperties": false
+    }
+  },
+  "required": [
+    "schema_version",
+    "created_at",
+    "status",
+    "request",
+    "provider",
+    "evidence_contract",
+    "structured_output",
+    "reasons",
+    "policy"
+  ],
+  "additionalProperties": false,
+  "title": "CodeSDD Agent Runtime Command Plan",
+  "description": "Provider-normalized command plan for DeepAgents, Codex exec, and OpenCode run agent runtimes."
+}