@devtrack-solution/codesdd 1.2.2 → 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
           }
         }
       },
@@ -87,6 +93,7 @@
     "skill_evidence": {
       "default": {
         "required_skill_ids": [],
+        "policy_requirements": [],
         "evidence": [],
         "verification_rule": "No skill evidence required for this feature."
       },
@@ -98,6 +105,59 @@
             "type": "string"
           }
         },
+        "policy_requirements": {
+          "default": [],
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "skill_id": {
+                "type": "string",
+                "minLength": 1
+              },
+              "policy_pool_ref": {
+                "type": "string",
+                "minLength": 1
+              },
+              "source_contract_ref": {
+                "type": "string",
+                "minLength": 1
+              },
+              "enforcement": {
+                "type": "string",
+                "enum": [
+                  "blocking",
+                  "advisory"
+                ]
+              },
+              "required_rule_refs": {
+                "default": [],
+                "type": "array",
+                "items": {
+                  "type": "string",
+                  "minLength": 1
+                }
+              },
+              "required_evidence": {
+                "default": [],
+                "type": "array",
+                "items": {
+                  "type": "string",
+                  "minLength": 1
+                }
+              }
+            },
+            "required": [
+              "skill_id",
+              "policy_pool_ref",
+              "source_contract_ref",
+              "enforcement",
+              "required_rule_refs",
+              "required_evidence"
+            ],
+            "additionalProperties": false
+          }
+        },
         "evidence": {
           "type": "array",
           "items": {
@@ -136,11 +196,84 @@
       },
       "required": [
         "required_skill_ids",
+        "policy_requirements",
         "evidence",
         "verification_rule"
       ],
       "additionalProperties": false
     },
+    "policy_injection": {
+      "type": "object",
+      "properties": {
+        "version": {
+          "type": "number",
+          "const": 1
+        },
+        "generated_from": {
+          "type": "string",
+          "const": "recommended_skills"
+        },
+        "required_policies": {
+          "default": [],
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "skill_id": {
+                "type": "string",
+                "minLength": 1
+              },
+              "policy_pool_ref": {
+                "type": "string",
+                "minLength": 1
+              },
+              "source_contract_ref": {
+                "type": "string",
+                "minLength": 1
+              },
+              "enforcement": {
+                "type": "string",
+                "enum": [
+                  "blocking",
+                  "advisory"
+                ]
+              },
+              "required_rule_refs": {
+                "default": [],
+                "type": "array",
+                "items": {
+                  "type": "string",
+                  "minLength": 1
+                }
+              },
+              "required_evidence": {
+                "default": [],
+                "type": "array",
+                "items": {
+                  "type": "string",
+                  "minLength": 1
+                }
+              }
+            },
+            "required": [
+              "skill_id",
+              "policy_pool_ref",
+              "source_contract_ref",
+              "enforcement",
+              "required_rule_refs",
+              "required_evidence"
+            ],
+            "additionalProperties": false
+          }
+        }
+      },
+      "required": [
+        "version",
+        "generated_from",
+        "required_policies"
+      ],
+      "additionalProperties": false
+    },
     "acceptance_matrix": {
       "type": "array",
       "items": {
@@ -169,6 +302,56 @@
         "additionalProperties": false
       }
     },
+    "requirement_validation_evidence_risk_matrix": {
+      "default": [],
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "requirement_ref": {
+            "type": "string",
+            "minLength": 1
+          },
+          "validation_refs": {
+            "minItems": 1,
+            "type": "array",
+            "items": {
+              "type": "string",
+              "minLength": 1
+            }
+          },
+          "evidence_refs": {
+            "minItems": 1,
+            "type": "array",
+            "items": {
+              "type": "string",
+              "minLength": 1
+            }
+          },
+          "residual_risk": {
+            "type": "string",
+            "minLength": 5
+          },
+          "risk_status": {
+            "default": "open",
+            "type": "string",
+            "enum": [
+              "open",
+              "mitigated",
+              "accepted"
+            ]
+          }
+        },
+        "required": [
+          "requirement_ref",
+          "validation_refs",
+          "evidence_refs",
+          "residual_risk",
+          "risk_status"
+        ],
+        "additionalProperties": false
+      }
+    },
     "exceptions": {
       "type": "array",
       "items": {
@@ -407,6 +590,515 @@
         "incident_response_review"
       ],
       "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,
+        "score": 0,
+        "status": "pending",
+        "computed_at": "",
+        "weights": {
+          "coverage": 30,
+          "traceability": 20,
+          "integrity": 20,
+          "naming": 10,
+          "token": 20
+        },
+        "axes": {
+          "coverage": {
+            "raw_score": 0,
+            "weighted_score": 0,
+            "rationale": "Computed during finalize."
+          },
+          "traceability": {
+            "raw_score": 0,
+            "weighted_score": 0,
+            "rationale": "Computed during finalize."
+          },
+          "integrity": {
+            "raw_score": 0,
+            "weighted_score": 0,
+            "rationale": "Computed during finalize."
+          },
+          "naming": {
+            "raw_score": 0,
+            "weighted_score": 0,
+            "rationale": "Computed during finalize."
+          },
+          "token": {
+            "raw_score": 0,
+            "weighted_score": 0,
+            "rationale": "Computed during finalize."
+          }
+        },
+        "next_best_action": "Record missing evidence to raise the lowest weighted axis."
+      },
+      "type": "object",
+      "properties": {
+        "threshold": {
+          "default": 95,
+          "type": "number",
+          "minimum": 0,
+          "maximum": 100
+        },
+        "score": {
+          "default": 0,
+          "type": "number",
+          "minimum": 0,
+          "maximum": 100
+        },
+        "status": {
+          "default": "pending",
+          "type": "string",
+          "enum": [
+            "pass",
+            "fail",
+            "pending"
+          ]
+        },
+        "computed_at": {
+          "default": "",
+          "type": "string"
+        },
+        "weights": {
+          "default": {
+            "coverage": 30,
+            "traceability": 20,
+            "integrity": 20,
+            "naming": 10,
+            "token": 20
+          },
+          "type": "object",
+          "properties": {
+            "coverage": {
+              "default": 30,
+              "type": "number",
+              "minimum": 0,
+              "maximum": 100
+            },
+            "traceability": {
+              "default": 20,
+              "type": "number",
+              "minimum": 0,
+              "maximum": 100
+            },
+            "integrity": {
+              "default": 20,
+              "type": "number",
+              "minimum": 0,
+              "maximum": 100
+            },
+            "naming": {
+              "default": 10,
+              "type": "number",
+              "minimum": 0,
+              "maximum": 100
+            },
+            "token": {
+              "default": 20,
+              "type": "number",
+              "minimum": 0,
+              "maximum": 100
+            }
+          },
+          "required": [
+            "coverage",
+            "traceability",
+            "integrity",
+            "naming",
+            "token"
+          ],
+          "additionalProperties": false
+        },
+        "axes": {
+          "default": {
+            "coverage": {
+              "raw_score": 0,
+              "weighted_score": 0,
+              "rationale": "Computed during finalize."
+            },
+            "traceability": {
+              "raw_score": 0,
+              "weighted_score": 0,
+              "rationale": "Computed during finalize."
+            },
+            "integrity": {
+              "raw_score": 0,
+              "weighted_score": 0,
+              "rationale": "Computed during finalize."
+            },
+            "naming": {
+              "raw_score": 0,
+              "weighted_score": 0,
+              "rationale": "Computed during finalize."
+            },
+            "token": {
+              "raw_score": 0,
+              "weighted_score": 0,
+              "rationale": "Computed during finalize."
+            }
+          },
+          "type": "object",
+          "properties": {
+            "coverage": {
+              "type": "object",
+              "properties": {
+                "raw_score": {
+                  "type": "number",
+                  "minimum": 0,
+                  "maximum": 100
+                },
+                "weighted_score": {
+                  "type": "number",
+                  "minimum": 0,
+                  "maximum": 100
+                },
+                "rationale": {
+                  "type": "string",
+                  "minLength": 1
+                }
+              },
+              "required": [
+                "raw_score",
+                "weighted_score",
+                "rationale"
+              ],
+              "additionalProperties": false
+            },
+            "traceability": {
+              "type": "object",
+              "properties": {
+                "raw_score": {
+                  "type": "number",
+                  "minimum": 0,
+                  "maximum": 100
+                },
+                "weighted_score": {
+                  "type": "number",
+                  "minimum": 0,
+                  "maximum": 100
+                },
+                "rationale": {
+                  "type": "string",
+                  "minLength": 1
+                }
+              },
+              "required": [
+                "raw_score",
+                "weighted_score",
+                "rationale"
+              ],
+              "additionalProperties": false
+            },
+            "integrity": {
+              "type": "object",
+              "properties": {
+                "raw_score": {
+                  "type": "number",
+                  "minimum": 0,
+                  "maximum": 100
+                },
+                "weighted_score": {
+                  "type": "number",
+                  "minimum": 0,
+                  "maximum": 100
+                },
+                "rationale": {
+                  "type": "string",
+                  "minLength": 1
+                }
+              },
+              "required": [
+                "raw_score",
+                "weighted_score",
+                "rationale"
+              ],
+              "additionalProperties": false
+            },
+            "naming": {
+              "type": "object",
+              "properties": {
+                "raw_score": {
+                  "type": "number",
+                  "minimum": 0,
+                  "maximum": 100
+                },
+                "weighted_score": {
+                  "type": "number",
+                  "minimum": 0,
+                  "maximum": 100
+                },
+                "rationale": {
+                  "type": "string",
+                  "minLength": 1
+                }
+              },
+              "required": [
+                "raw_score",
+                "weighted_score",
+                "rationale"
+              ],
+              "additionalProperties": false
+            },
+            "token": {
+              "type": "object",
+              "properties": {
+                "raw_score": {
+                  "type": "number",
+                  "minimum": 0,
+                  "maximum": 100
+                },
+                "weighted_score": {
+                  "type": "number",
+                  "minimum": 0,
+                  "maximum": 100
+                },
+                "rationale": {
+                  "type": "string",
+                  "minLength": 1
+                }
+              },
+              "required": [
+                "raw_score",
+                "weighted_score",
+                "rationale"
+              ],
+              "additionalProperties": false
+            }
+          },
+          "required": [
+            "coverage",
+            "traceability",
+            "integrity",
+            "naming",
+            "token"
+          ],
+          "additionalProperties": false
+        },
+        "next_best_action": {
+          "default": "Record missing evidence to raise the lowest weighted axis.",
+          "type": "string"
+        }
+      },
+      "required": [
+        "threshold",
+        "score",
+        "status",
+        "computed_at",
+        "weights",
+        "axes",
+        "next_best_action"
+      ],
+      "additionalProperties": false
     }
   },
   "required": [
@@ -417,11 +1109,15 @@
     "evidence_log",
     "skill_evidence",
     "acceptance_matrix",
+    "requirement_validation_evidence_risk_matrix",
     "exceptions",
     "remediation_policy",
-    "traceability"
+    "traceability",
+    "token_budget_gates",
+    "runtime_quality_gates",
+    "q95_ledger"
   ],
   "additionalProperties": false,
-  "title": "OpenSDD Workspace Quality",
+  "title": "CodeSDD Workspace Quality",
   "description": "Machine-readable contract for the FEAT quality evidence and remediation workspace document."
 }