@devtrack-solution/codesdd 1.2.3 → 1.2.4

package/schemas/sdd/2-plan.schema.json

@@ -10,6 +10,205 @@
       "type": "string",
       "pattern": "^FEAT-\\d{4}$"
     },
+    "governance": {
+      "default": {
+        "state_boundary": "codesdd-canonical-sdd-state",
+        "planning_artifacts": [
+          ".sdd/state/backlog.yaml"
+        ],
+        "decision_refs": [],
+        "planned_state_writes": [],
+        "rollback_plan": "Review and revert only the scoped CodeSDD feature workspace and state changes if validation fails.",
+        "validation_gates": [
+          {
+            "name": "SDD check",
+            "command": "codesdd sdd check --render",
+            "expected": "CodeSDD state and generated views remain valid."
+          }
+        ]
+      },
+      "type": "object",
+      "properties": {
+        "state_boundary": {
+          "default": "codesdd-canonical-sdd-state",
+          "type": "string",
+          "const": "codesdd-canonical-sdd-state"
+        },
+        "planning_artifacts": {
+          "minItems": 1,
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1
+          }
+        },
+        "decision_refs": {
+          "default": [],
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1
+          }
+        },
+        "planned_state_writes": {
+          "default": [],
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1
+          }
+        },
+        "rollback_plan": {
+          "type": "string",
+          "minLength": 20
+        },
+        "validation_gates": {
+          "minItems": 1,
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "name": {
+                "type": "string",
+                "minLength": 1
+              },
+              "command": {
+                "type": "string",
+                "minLength": 1
+              },
+              "expected": {
+                "type": "string",
+                "minLength": 1
+              }
+            },
+            "required": [
+              "name",
+              "command",
+              "expected"
+            ],
+            "additionalProperties": false
+          }
+        }
+      },
+      "required": [
+        "state_boundary",
+        "planning_artifacts",
+        "decision_refs",
+        "planned_state_writes",
+        "rollback_plan",
+        "validation_gates"
+      ],
+      "additionalProperties": false
+    },
+    "execution_plan": {
+      "default": {
+        "mode": "single-feature",
+        "state_boundary_ref": "codesdd-canonical-sdd-state",
+        "command_sequence": [
+          {
+            "name": "SDD check",
+            "command": "codesdd sdd check --render",
+            "writes_state": false,
+            "expected_state_writes": []
+          }
+        ],
+        "allowed_state_writes": [],
+        "forbidden_state_writes": [
+          ".codesdd/**",
+          "external-context/**"
+        ],
+        "handoff_artifacts": []
+      },
+      "type": "object",
+      "properties": {
+        "mode": {
+          "default": "single-feature",
+          "type": "string",
+          "enum": [
+            "single-feature",
+            "parallel-wave",
+            "chained-features"
+          ]
+        },
+        "state_boundary_ref": {
+          "default": "codesdd-canonical-sdd-state",
+          "type": "string",
+          "const": "codesdd-canonical-sdd-state"
+        },
+        "command_sequence": {
+          "minItems": 1,
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "name": {
+                "type": "string",
+                "minLength": 1
+              },
+              "command": {
+                "type": "string",
+                "minLength": 1
+              },
+              "writes_state": {
+                "default": false,
+                "type": "boolean"
+              },
+              "expected_state_writes": {
+                "default": [],
+                "type": "array",
+                "items": {
+                  "type": "string",
+                  "minLength": 1
+                }
+              }
+            },
+            "required": [
+              "name",
+              "command",
+              "writes_state",
+              "expected_state_writes"
+            ],
+            "additionalProperties": false
+          }
+        },
+        "allowed_state_writes": {
+          "default": [],
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1
+          }
+        },
+        "forbidden_state_writes": {
+          "default": [
+            ".codesdd/**",
+            "external-context/**"
+          ],
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1
+          }
+        },
+        "handoff_artifacts": {
+          "default": [],
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1
+          }
+        }
+      },
+      "required": [
+        "mode",
+        "state_boundary_ref",
+        "command_sequence",
+        "allowed_state_writes",
+        "forbidden_state_writes",
+        "handoff_artifacts"
+      ],
+      "additionalProperties": false
+    },
     "architectural_impact": {
       "type": "object",
       "properties": {
@@ -73,10 +272,14 @@
       "type": "object",
       "properties": {
         "unit_target": {
-          "type": "number"
+          "type": "number",
+          "minimum": 0,
+          "maximum": 100
         },
         "integration_target": {
-          "type": "number"
+          "type": "number",
+          "minimum": 0,
+          "maximum": 100
         },
         "approach": {
           "type": "string"
@@ -259,6 +462,8 @@
   "required": [
     "schema_version",
     "feature_id",
+    "governance",
+    "execution_plan",
     "architectural_impact",
     "frontend_impact",
     "affected_contracts",

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
           }
         }
       },
@@ -74,6 +80,49 @@
           },
           "artifact": {
             "type": "string"
+          },
+          "critical": {
+            "type": "boolean"
+          },
+          "provenance": {
+            "type": "object",
+            "properties": {
+              "command": {
+                "type": "string",
+                "minLength": 1
+              },
+              "exit_code": {
+                "type": "integer",
+                "minimum": -9007199254740991,
+                "maximum": 9007199254740991
+              },
+              "timestamp_iso": {
+                "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))$"
+              },
+              "commit_sha": {
+                "type": "string",
+                "pattern": "^[0-9a-f]{7,40}$"
+              },
+              "artifact_path": {
+                "type": "string",
+                "minLength": 1
+              },
+              "artifact_hash": {
+                "type": "string",
+                "minLength": 1
+              }
+            },
+            "required": [
+              "command",
+              "exit_code",
+              "timestamp_iso",
+              "commit_sha",
+              "artifact_path",
+              "artifact_hash"
+            ],
+            "additionalProperties": false
           }
         },
         "required": [
@@ -585,6 +634,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 +889,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 +924,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 +996,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 +1021,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 +1046,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 +1071,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 +1096,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 +1156,8 @@
     "exceptions",
     "remediation_policy",
     "traceability",
+    "token_budget_gates",
+    "runtime_quality_gates",
     "q95_ledger"
   ],
   "additionalProperties": false,