@devtrack-solution/codesdd 1.2.2 → 1.2.4-rc3

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

@@ -0,0 +1,197 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "schema_version": {
+      "type": "number",
+      "const": 1
+    },
+    "run_id": {
+      "type": "string",
+      "pattern": "^qrun-[0-9]{8}t[0-9]{6}z-[a-z0-9-]+$"
+    },
+    "scenario_ref": {
+      "type": "string",
+      "pattern": "^QVAL-\\d{4}$"
+    },
+    "feature_ref": {
+      "type": "string",
+      "pattern": "^FEAT-\\d{4}$"
+    },
+    "started_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))$"
+    },
+    "finished_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))$"
+    },
+    "mode": {
+      "type": "string",
+      "enum": [
+        "dry_run",
+        "apply_sandbox",
+        "runtime",
+        "traceability"
+      ]
+    },
+    "status": {
+      "type": "string",
+      "enum": [
+        "passed",
+        "warning",
+        "failed",
+        "blocked"
+      ]
+    },
+    "plugin_ref": {
+      "type": "object",
+      "properties": {
+        "id": {
+          "type": "string",
+          "minLength": 1
+        },
+        "version": {
+          "type": "string",
+          "minLength": 1
+        },
+        "capability": {
+          "type": "string",
+          "minLength": 1
+        }
+      },
+      "required": [
+        "id",
+        "version",
+        "capability"
+      ],
+      "additionalProperties": false
+    },
+    "command": {
+      "type": "object",
+      "properties": {
+        "argv": {
+          "minItems": 1,
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1
+          }
+        },
+        "cwd": {
+          "default": ".",
+          "type": "string",
+          "minLength": 1
+        },
+        "env_keys": {
+          "default": [],
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1
+          }
+        }
+      },
+      "required": [
+        "argv",
+        "cwd",
+        "env_keys"
+      ],
+      "additionalProperties": false
+    },
+    "schema_versions": {
+      "default": {},
+      "type": "object",
+      "propertyNames": {
+        "type": "string"
+      },
+      "additionalProperties": {
+        "type": "string"
+      }
+    },
+    "artifacts": {
+      "default": [],
+      "type": "array",
+      "items": {
+        "type": "string",
+        "minLength": 1
+      }
+    },
+    "findings": {
+      "default": [],
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "code": {
+            "type": "string",
+            "pattern": "^[A-Z][A-Z0-9_]*$"
+          },
+          "severity": {
+            "type": "string",
+            "enum": [
+              "info",
+              "warn",
+              "error",
+              "blocker"
+            ]
+          },
+          "message": {
+            "type": "string",
+            "minLength": 1
+          },
+          "remediation": {
+            "type": "string",
+            "minLength": 1
+          },
+          "path": {
+            "type": "string",
+            "minLength": 1
+          },
+          "gate_id": {
+            "type": "string",
+            "minLength": 1
+          }
+        },
+        "required": [
+          "code",
+          "severity",
+          "message",
+          "remediation"
+        ],
+        "additionalProperties": false
+      }
+    },
+    "evidence_bundle_path": {
+      "type": "string",
+      "minLength": 1
+    },
+    "metadata": {
+      "default": {},
+      "type": "object",
+      "propertyNames": {
+        "type": "string"
+      },
+      "additionalProperties": {}
+    }
+  },
+  "required": [
+    "schema_version",
+    "run_id",
+    "scenario_ref",
+    "feature_ref",
+    "started_at",
+    "mode",
+    "status",
+    "command",
+    "schema_versions",
+    "artifacts",
+    "findings",
+    "metadata"
+  ],
+  "additionalProperties": false,
+  "title": "CodeSDD Quality Run",
+  "description": "Machine-readable execution record for a CodeSDD quality validation scenario."
+}

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

@@ -0,0 +1,252 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "schema_version": {
+      "type": "number",
+      "const": 1
+    },
+    "id": {
+      "type": "string",
+      "pattern": "^QVAL-\\d{4}$"
+    },
+    "title": {
+      "type": "string",
+      "minLength": 10
+    },
+    "feature_ref": {
+      "type": "string",
+      "pattern": "^FEAT-\\d{4}$"
+    },
+    "mode": {
+      "type": "string",
+      "enum": [
+        "dry_run",
+        "apply_sandbox",
+        "runtime",
+        "traceability"
+      ]
+    },
+    "intent": {
+      "type": "string",
+      "minLength": 30
+    },
+    "authority": {
+      "minItems": 1,
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "type": {
+            "type": "string",
+            "enum": [
+              "adr",
+              "skill",
+              "foundation",
+              "debate",
+              "epic",
+              "feature",
+              "schema"
+            ]
+          },
+          "ref": {
+            "type": "string",
+            "minLength": 1
+          },
+          "path": {
+            "type": "string",
+            "minLength": 1
+          },
+          "version": {
+            "type": "string",
+            "minLength": 1
+          },
+          "update_policy": {
+            "type": "string",
+            "minLength": 1
+          }
+        },
+        "required": [
+          "type",
+          "ref",
+          "update_policy"
+        ],
+        "additionalProperties": false
+      }
+    },
+    "input": {
+      "type": "object",
+      "properties": {
+        "prompt": {
+          "type": "string",
+          "minLength": 1
+        },
+        "fixture_path": {
+          "type": "string",
+          "minLength": 1
+        },
+        "payload": {
+          "default": {},
+          "type": "object",
+          "propertyNames": {
+            "type": "string"
+          },
+          "additionalProperties": {}
+        }
+      },
+      "required": [
+        "payload"
+      ],
+      "additionalProperties": false
+    },
+    "expected_artifacts": {
+      "default": [],
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "path_pattern": {
+            "type": "string",
+            "minLength": 1
+          },
+          "required": {
+            "default": true,
+            "type": "boolean"
+          },
+          "artifact_class": {
+            "type": "string",
+            "minLength": 1
+          },
+          "checksum_required": {
+            "default": false,
+            "type": "boolean"
+          }
+        },
+        "required": [
+          "path_pattern",
+          "required",
+          "artifact_class",
+          "checksum_required"
+        ],
+        "additionalProperties": false
+      }
+    },
+    "gates": {
+      "minItems": 1,
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": "string",
+            "minLength": 1
+          },
+          "type": {
+            "type": "string",
+            "enum": [
+              "schema",
+              "filesystem",
+              "import",
+              "runtime",
+              "evidence",
+              "certification",
+              "drift"
+            ]
+          },
+          "severity": {
+            "default": "warn",
+            "type": "string",
+            "enum": [
+              "warn",
+              "fail"
+            ]
+          },
+          "issue_codes": {
+            "default": [],
+            "type": "array",
+            "items": {
+              "type": "string",
+              "pattern": "^[A-Z][A-Z0-9_]*$"
+            }
+          },
+          "remediation": {
+            "type": "string",
+            "minLength": 1
+          }
+        },
+        "required": [
+          "id",
+          "type",
+          "severity",
+          "issue_codes",
+          "remediation"
+        ],
+        "additionalProperties": false
+      }
+    },
+    "negative_variants": {
+      "default": [],
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": "string",
+            "minLength": 1
+          },
+          "description": {
+            "type": "string",
+            "minLength": 10
+          },
+          "expected_issue_codes": {
+            "minItems": 1,
+            "type": "array",
+            "items": {
+              "type": "string",
+              "pattern": "^[A-Z][A-Z0-9_]*$"
+            }
+          }
+        },
+        "required": [
+          "id",
+          "description",
+          "expected_issue_codes"
+        ],
+        "additionalProperties": false
+      }
+    },
+    "allowed_nondeterminism": {
+      "default": [],
+      "type": "array",
+      "items": {
+        "type": "string",
+        "minLength": 1
+      }
+    },
+    "required_evidence": {
+      "minItems": 1,
+      "type": "array",
+      "items": {
+        "type": "string",
+        "minLength": 1
+      }
+    }
+  },
+  "required": [
+    "schema_version",
+    "id",
+    "title",
+    "mode",
+    "intent",
+    "authority",
+    "input",
+    "expected_artifacts",
+    "gates",
+    "negative_variants",
+    "allowed_nondeterminism",
+    "required_evidence"
+  ],
+  "additionalProperties": false,
+  "title": "CodeSDD Quality Scenario",
+  "description": "Machine-readable golden scenario contract for enterprise CodeSDD quality validation runs."
+}

package/schemas/sdd/sdk-agent-plugin-quality-gate-input.schema.json

@@ -0,0 +1,168 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "schema_version": {
+      "default": 1,
+      "type": "number",
+      "const": 1
+    },
+    "generated_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))$"
+    },
+    "feature_ref": {
+      "type": "string",
+      "pattern": "^FEAT-\\d{4}$"
+    },
+    "package_governance": {},
+    "language_runtime": {},
+    "artifact_map": {},
+    "agent_runtime_plans": {
+      "default": [],
+      "type": "array",
+      "items": {}
+    },
+    "plugin_compliance_indexes": {
+      "default": [],
+      "type": "array",
+      "items": {}
+    },
+    "coverage_scopes": {
+      "default": [],
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": "string",
+            "minLength": 1
+          },
+          "label": {
+            "type": "string",
+            "minLength": 1
+          },
+          "metrics": {
+            "type": "object",
+            "properties": {
+              "statements": {
+                "type": "number",
+                "minimum": 0,
+                "maximum": 100
+              },
+              "branches": {
+                "type": "number",
+                "minimum": 0,
+                "maximum": 100
+              },
+              "functions": {
+                "type": "number",
+                "minimum": 0,
+                "maximum": 100
+              },
+              "lines": {
+                "type": "number",
+                "minimum": 0,
+                "maximum": 100
+              }
+            },
+            "additionalProperties": false
+          },
+          "target": {
+            "type": "object",
+            "properties": {
+              "statements": {
+                "type": "number",
+                "minimum": 0,
+                "maximum": 100
+              },
+              "branches": {
+                "type": "number",
+                "minimum": 0,
+                "maximum": 100
+              },
+              "functions": {
+                "type": "number",
+                "minimum": 0,
+                "maximum": 100
+              },
+              "lines": {
+                "type": "number",
+                "minimum": 0,
+                "maximum": 100
+              }
+            },
+            "additionalProperties": false
+          }
+        },
+        "required": [
+          "id",
+          "label",
+          "metrics"
+        ],
+        "additionalProperties": false
+      }
+    },
+    "required_agent_providers": {
+      "default": [
+        "deepagents",
+        "codex",
+        "opencode"
+      ],
+      "type": "array",
+      "items": {
+        "type": "string",
+        "enum": [
+          "deepagents",
+          "codex",
+          "opencode"
+        ]
+      }
+    },
+    "coverage_target": {
+      "default": {
+        "statements": 95,
+        "branches": 85,
+        "functions": 95,
+        "lines": 95
+      },
+      "type": "object",
+      "properties": {
+        "statements": {
+          "type": "number",
+          "minimum": 0,
+          "maximum": 100
+        },
+        "branches": {
+          "type": "number",
+          "minimum": 0,
+          "maximum": 100
+        },
+        "functions": {
+          "type": "number",
+          "minimum": 0,
+          "maximum": 100
+        },
+        "lines": {
+          "type": "number",
+          "minimum": 0,
+          "maximum": 100
+        }
+      },
+      "additionalProperties": false
+    }
+  },
+  "required": [
+    "schema_version",
+    "generated_at",
+    "agent_runtime_plans",
+    "plugin_compliance_indexes",
+    "coverage_scopes",
+    "required_agent_providers",
+    "coverage_target"
+  ],
+  "additionalProperties": false,
+  "title": "CodeSDD SDK Agent Plugin Quality Gate Input",
+  "description": "Input contract for validating plugin SDK, agent runtime, plugin compliance, Foundation artifact map, and coverage evidence together."
+}