@devtrack-solution/codesdd 1.2.2 → 1.2.3

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

@@ -87,6 +87,7 @@
     "skill_evidence": {
       "default": {
         "required_skill_ids": [],
+        "policy_requirements": [],
         "evidence": [],
         "verification_rule": "No skill evidence required for this feature."
       },
@@ -98,6 +99,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 +190,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 +296,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 +584,267 @@
         "incident_response_review"
       ],
       "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"
+        },
+        "score": {
+          "default": 0,
+          "type": "number"
+        },
+        "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"
+            },
+            "traceability": {
+              "default": 20,
+              "type": "number"
+            },
+            "integrity": {
+              "default": 20,
+              "type": "number"
+            },
+            "naming": {
+              "default": 10,
+              "type": "number"
+            },
+            "token": {
+              "default": 20,
+              "type": "number"
+            }
+          },
+          "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"
+                },
+                "weighted_score": {
+                  "type": "number"
+                },
+                "rationale": {
+                  "type": "string"
+                }
+              },
+              "required": [
+                "raw_score",
+                "weighted_score",
+                "rationale"
+              ],
+              "additionalProperties": false
+            },
+            "traceability": {
+              "type": "object",
+              "properties": {
+                "raw_score": {
+                  "type": "number"
+                },
+                "weighted_score": {
+                  "type": "number"
+                },
+                "rationale": {
+                  "type": "string"
+                }
+              },
+              "required": [
+                "raw_score",
+                "weighted_score",
+                "rationale"
+              ],
+              "additionalProperties": false
+            },
+            "integrity": {
+              "type": "object",
+              "properties": {
+                "raw_score": {
+                  "type": "number"
+                },
+                "weighted_score": {
+                  "type": "number"
+                },
+                "rationale": {
+                  "type": "string"
+                }
+              },
+              "required": [
+                "raw_score",
+                "weighted_score",
+                "rationale"
+              ],
+              "additionalProperties": false
+            },
+            "naming": {
+              "type": "object",
+              "properties": {
+                "raw_score": {
+                  "type": "number"
+                },
+                "weighted_score": {
+                  "type": "number"
+                },
+                "rationale": {
+                  "type": "string"
+                }
+              },
+              "required": [
+                "raw_score",
+                "weighted_score",
+                "rationale"
+              ],
+              "additionalProperties": false
+            },
+            "token": {
+              "type": "object",
+              "properties": {
+                "raw_score": {
+                  "type": "number"
+                },
+                "weighted_score": {
+                  "type": "number"
+                },
+                "rationale": {
+                  "type": "string"
+                }
+              },
+              "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 +855,13 @@
     "evidence_log",
     "skill_evidence",
     "acceptance_matrix",
+    "requirement_validation_evidence_risk_matrix",
     "exceptions",
     "remediation_policy",
-    "traceability"
+    "traceability",
+    "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."
 }

package/schemas/sdd/adr.schema.json

@@ -0,0 +1,148 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "schema_version": {
+      "type": "number",
+      "const": 1
+    },
+    "id": {
+      "type": "string",
+      "pattern": "^ADR-FEAT-\\d{3,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": "ADR"
+    },
+    "feature_id": {
+      "type": "string",
+      "pattern": "^FEAT-\\d{3,4}$"
+    },
+    "decision_status": {
+      "default": "PROPOSED",
+      "type": "string",
+      "enum": [
+        "PROPOSED",
+        "ACCEPTED",
+        "SUPERSEDED"
+      ]
+    },
+    "supersedes": {
+      "default": [],
+      "type": "array",
+      "items": {
+        "type": "string",
+        "pattern": "^ADR-FEAT-\\d{3,4}$"
+      }
+    },
+    "superseded_by": {
+      "default": [],
+      "type": "array",
+      "items": {
+        "type": "string",
+        "pattern": "^ADR-FEAT-\\d{3,4}$"
+      }
+    },
+    "references": {
+      "default": [],
+      "type": "array",
+      "items": {
+        "type": "string",
+        "minLength": 1
+      }
+    }
+  },
+  "required": [
+    "schema_version",
+    "id",
+    "title",
+    "status",
+    "origin",
+    "related_ids",
+    "created_at",
+    "updated_at",
+    "artifact_type",
+    "feature_id",
+    "decision_status",
+    "supersedes",
+    "superseded_by",
+    "references"
+  ],
+  "additionalProperties": false,
+  "title": "CodeSDD ADR Frontmatter",
+  "description": "Machine-readable frontmatter contract for ADR governance artifacts with Markdown body compatibility."
+}