@devtrack-solution/codesdd 1.2.2 → 1.2.3

package/schemas/sdd/codesdd-plugin.schema.json

@@ -0,0 +1,474 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "id": {
+      "type": "string",
+      "pattern": "^codesdd-plugin-[a-z0-9][a-z0-9-]*$"
+    },
+    "name": {
+      "type": "string",
+      "minLength": 3
+    },
+    "version": {
+      "type": "string",
+      "pattern": "^\\d+\\.\\d+\\.\\d+(?:[-+][0-9A-Za-z.-]+)?$"
+    },
+    "contract_version": {
+      "type": "number",
+      "const": 1
+    },
+    "vendor": {
+      "type": "string",
+      "minLength": 2
+    },
+    "codesdd_compat": {
+      "type": "object",
+      "properties": {
+        "versions": {
+          "type": "string",
+          "minLength": 1
+        },
+        "sdd_contract_versions": {
+          "minItems": 1,
+          "type": "array",
+          "items": {
+            "type": "integer",
+            "exclusiveMinimum": 0,
+            "maximum": 9007199254740991
+          }
+        }
+      },
+      "required": [
+        "versions",
+        "sdd_contract_versions"
+      ],
+      "additionalProperties": false
+    },
+    "technology": {
+      "type": "object",
+      "properties": {
+        "language": {
+          "type": "string",
+          "minLength": 1
+        },
+        "framework": {
+          "type": "string"
+        },
+        "runtime": {
+          "type": "string"
+        },
+        "package_manager": {
+          "type": "string"
+        },
+        "min_versions": {
+          "default": {},
+          "type": "object",
+          "propertyNames": {
+            "type": "string"
+          },
+          "additionalProperties": {
+            "type": "string"
+          }
+        }
+      },
+      "required": [
+        "language",
+        "min_versions"
+      ],
+      "additionalProperties": false
+    },
+    "capabilities": {
+      "minItems": 1,
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "name": {
+            "type": "string",
+            "pattern": "^[a-z][a-z0-9-]*(?:\\.[a-z][a-z0-9-]*)+$"
+          },
+          "description": {
+            "type": "string",
+            "minLength": 20
+          },
+          "input_schema": {
+            "type": "object",
+            "propertyNames": {
+              "type": "string"
+            },
+            "additionalProperties": {}
+          },
+          "output_schema": {
+            "type": "object",
+            "propertyNames": {
+              "type": "string"
+            },
+            "additionalProperties": {}
+          },
+          "deterministic": {
+            "type": "boolean"
+          },
+          "idempotent": {
+            "type": "boolean"
+          },
+          "supports_dry_run": {
+            "type": "boolean"
+          },
+          "supports_apply": {
+            "type": "boolean"
+          },
+          "supports_rollback": {
+            "default": false,
+            "type": "boolean"
+          },
+          "write_scope": {
+            "default": [],
+            "type": "array",
+            "items": {
+              "type": "string",
+              "minLength": 1
+            }
+          },
+          "risk_tier": {
+            "default": "medium",
+            "type": "string",
+            "enum": [
+              "low",
+              "medium",
+              "high",
+              "critical"
+            ]
+          },
+          "approval": {
+            "default": "maintainer",
+            "type": "string",
+            "enum": [
+              "none",
+              "maintainer",
+              "security",
+              "architecture-board"
+            ]
+          }
+        },
+        "required": [
+          "name",
+          "description",
+          "input_schema",
+          "output_schema",
+          "deterministic",
+          "idempotent",
+          "supports_dry_run",
+          "supports_apply",
+          "supports_rollback",
+          "write_scope",
+          "risk_tier",
+          "approval"
+        ],
+        "additionalProperties": false
+      }
+    },
+    "execution": {
+      "type": "object",
+      "properties": {
+        "command": {
+          "type": "string",
+          "minLength": 1
+        },
+        "args": {
+          "default": [],
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "timeout_seconds": {
+          "default": 120,
+          "type": "integer",
+          "exclusiveMinimum": 0,
+          "maximum": 3600
+        },
+        "env_allowlist": {
+          "default": [],
+          "type": "array",
+          "items": {
+            "type": "string",
+            "pattern": "^[A-Z_][A-Z0-9_]*$"
+          }
+        },
+        "network": {
+          "default": "disabled",
+          "type": "string",
+          "enum": [
+            "disabled",
+            "restricted",
+            "enabled"
+          ]
+        },
+        "process_spawn": {
+          "default": "forbidden",
+          "type": "string",
+          "enum": [
+            "forbidden",
+            "declared"
+          ]
+        },
+        "working_directory": {
+          "default": ".",
+          "type": "string",
+          "minLength": 1
+        }
+      },
+      "required": [
+        "command",
+        "args",
+        "timeout_seconds",
+        "env_allowlist",
+        "network",
+        "process_spawn",
+        "working_directory"
+      ],
+      "additionalProperties": false
+    },
+    "artifacts": {
+      "type": "object",
+      "properties": {
+        "writes": {
+          "default": [],
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1
+          }
+        },
+        "forbidden_writes": {
+          "default": [],
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1
+          }
+        },
+        "naming_conventions": {
+          "default": [],
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1
+          }
+        }
+      },
+      "required": [
+        "writes",
+        "forbidden_writes",
+        "naming_conventions"
+      ],
+      "additionalProperties": false
+    },
+    "supply_chain": {
+      "type": "object",
+      "properties": {
+        "checksum": {
+          "type": "string"
+        },
+        "signature": {
+          "type": "string"
+        },
+        "provenance": {
+          "type": "string"
+        },
+        "sbom": {
+          "type": "string"
+        }
+      },
+      "additionalProperties": false
+    },
+    "governance": {
+      "type": "object",
+      "properties": {
+        "owner": {
+          "type": "string",
+          "minLength": 2
+        },
+        "support_sla": {
+          "type": "string",
+          "minLength": 1
+        },
+        "deprecation_window": {
+          "type": "string",
+          "minLength": 1
+        },
+        "policy_packs": {
+          "default": [],
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1
+          }
+        },
+        "trust_tier": {
+          "type": "string",
+          "enum": [
+            "local-dev",
+            "experimental",
+            "enterprise-approved",
+            "blocked"
+          ]
+        },
+        "allowed_domains": {
+          "default": [],
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1
+          }
+        },
+        "risk_tier": {
+          "default": "medium",
+          "type": "string",
+          "enum": [
+            "low",
+            "medium",
+            "high",
+            "critical"
+          ]
+        }
+      },
+      "required": [
+        "owner",
+        "support_sla",
+        "deprecation_window",
+        "policy_packs",
+        "trust_tier",
+        "allowed_domains",
+        "risk_tier"
+      ],
+      "additionalProperties": false
+    },
+    "validation": {
+      "type": "object",
+      "properties": {
+        "commands": {
+          "minItems": 1,
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1
+          }
+        },
+        "coverage_target": {
+          "default": 95,
+          "type": "number",
+          "minimum": 0,
+          "maximum": 100
+        },
+        "security_checks": {
+          "default": [],
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1
+          }
+        },
+        "dependency_checks": {
+          "default": [],
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1
+          }
+        }
+      },
+      "required": [
+        "commands",
+        "coverage_target",
+        "security_checks",
+        "dependency_checks"
+      ],
+      "additionalProperties": false
+    },
+    "compression": {
+      "default": {
+        "enabled": false,
+        "engine": "none",
+        "mode": "pretooluse",
+        "exclude_commands": [],
+        "tee": "failures",
+        "max_output_tokens": 4000
+      },
+      "type": "object",
+      "properties": {
+        "enabled": {
+          "default": false,
+          "type": "boolean"
+        },
+        "engine": {
+          "default": "none",
+          "type": "string",
+          "enum": [
+            "rtk",
+            "headroom",
+            "builtin",
+            "none"
+          ]
+        },
+        "mode": {
+          "default": "pretooluse",
+          "type": "string",
+          "const": "pretooluse"
+        },
+        "exclude_commands": {
+          "default": [],
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1
+          }
+        },
+        "tee": {
+          "default": "failures",
+          "type": "string",
+          "enum": [
+            "failures",
+            "always",
+            "never"
+          ]
+        },
+        "max_output_tokens": {
+          "default": 4000,
+          "type": "integer",
+          "exclusiveMinimum": 0,
+          "maximum": 64000
+        }
+      },
+      "required": [
+        "enabled",
+        "engine",
+        "mode",
+        "exclude_commands",
+        "tee",
+        "max_output_tokens"
+      ],
+      "additionalProperties": false
+    }
+  },
+  "required": [
+    "id",
+    "name",
+    "version",
+    "contract_version",
+    "vendor",
+    "codesdd_compat",
+    "technology",
+    "capabilities",
+    "execution",
+    "artifacts",
+    "supply_chain",
+    "governance",
+    "validation",
+    "compression"
+  ],
+  "additionalProperties": false,
+  "title": "CodeSDD Enterprise Plugin Manifest",
+  "description": "Machine-readable contract for a CodeSDD enterprise plugin manifest."
+}

package/schemas/sdd/debate.schema.json

@@ -0,0 +1,244 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "schema_version": {
+      "type": "number",
+      "const": 1
+    },
+    "id": {
+      "type": "string",
+      "pattern": "^DEB-\\d{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": "DEB"
+    },
+    "decision": {
+      "type": "object",
+      "properties": {
+        "question": {
+          "type": "string",
+          "minLength": 1
+        },
+        "options": {
+          "minItems": 1,
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "id": {
+                "type": "string",
+                "pattern": "^[A-Z]$"
+              },
+              "label": {
+                "type": "string",
+                "minLength": 1
+              }
+            },
+            "required": [
+              "id",
+              "label"
+            ],
+            "additionalProperties": false
+          }
+        },
+        "criteria": {
+          "default": [],
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1
+          }
+        },
+        "scoring": {
+          "default": [],
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "criterion": {
+                "type": "string",
+                "minLength": 1
+              },
+              "weight": {
+                "type": "number"
+              },
+              "scores": {
+                "type": "object",
+                "propertyNames": {
+                  "type": "string",
+                  "pattern": "^[A-Z]$"
+                },
+                "additionalProperties": {
+                  "type": "number"
+                }
+              }
+            },
+            "required": [
+              "criterion",
+              "weight",
+              "scores"
+            ],
+            "additionalProperties": false
+          }
+        },
+        "mediator": {
+          "type": "object",
+          "properties": {
+            "choice": {
+              "type": "string",
+              "pattern": "^[A-Z]$"
+            },
+            "rationale": {
+              "type": "string",
+              "minLength": 1
+            },
+            "accepted_risks": {
+              "default": [],
+              "type": "array",
+              "items": {
+                "type": "object",
+                "properties": {
+                  "risk": {
+                    "type": "string",
+                    "minLength": 1
+                  },
+                  "mitigation": {
+                    "type": "string",
+                    "minLength": 1
+                  }
+                },
+                "required": [
+                  "risk",
+                  "mitigation"
+                ],
+                "additionalProperties": false
+              }
+            },
+            "reversal_conditions": {
+              "default": [],
+              "type": "array",
+              "items": {
+                "type": "string",
+                "minLength": 1
+              }
+            }
+          },
+          "required": [
+            "choice",
+            "rationale",
+            "accepted_risks",
+            "reversal_conditions"
+          ],
+          "additionalProperties": false
+        },
+        "output": {
+          "type": "string",
+          "enum": [
+            "APPROVED",
+            "DISCARDED"
+          ]
+        }
+      },
+      "required": [
+        "question",
+        "options",
+        "criteria",
+        "scoring",
+        "mediator",
+        "output"
+      ],
+      "additionalProperties": false
+    }
+  },
+  "required": [
+    "schema_version",
+    "id",
+    "title",
+    "status",
+    "origin",
+    "related_ids",
+    "created_at",
+    "updated_at",
+    "artifact_type",
+    "decision"
+  ],
+  "additionalProperties": false,
+  "title": "CodeSDD Debate Frontmatter",
+  "description": "Machine-readable frontmatter contract for DEB governance artifacts with Markdown body compatibility."
+}