@devtrack-solution/codesdd 1.2.2 → 1.2.4-rc3

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."
+}

package/schemas/sdd/agent-binding-adapter.schema.json

@@ -0,0 +1,210 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "schema_version": {
+      "default": 1,
+      "type": "number",
+      "const": 1
+    },
+    "id": {
+      "type": "string",
+      "pattern": "^codesdd-agent-[a-z0-9][a-z0-9-]*$"
+    },
+    "provider": {
+      "type": "string",
+      "enum": [
+        "codex",
+        "opencode",
+        "claude-code",
+        "cloudcode",
+        "deepagents",
+        "fake"
+      ]
+    },
+    "label": {
+      "type": "string",
+      "minLength": 2
+    },
+    "status": {
+      "default": "active",
+      "type": "string",
+      "enum": [
+        "active",
+        "disabled",
+        "experimental"
+      ]
+    },
+    "execution": {
+      "type": "object",
+      "properties": {
+        "mode": {
+          "type": "string",
+          "enum": [
+            "local-cli",
+            "cloud",
+            "test-double"
+          ]
+        },
+        "command": {
+          "type": "string",
+          "minLength": 1
+        },
+        "args": {
+          "default": [],
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "network": {
+          "default": "disabled",
+          "type": "string",
+          "enum": [
+            "disabled",
+            "restricted",
+            "enabled"
+          ]
+        },
+        "evidence_contract": {
+          "default": "agent-evidence/v1",
+          "type": "string",
+          "minLength": 1
+        }
+      },
+      "required": [
+        "mode",
+        "args",
+        "network",
+        "evidence_contract"
+      ],
+      "additionalProperties": false
+    },
+    "capabilities": {
+      "minItems": 1,
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "task_kind": {
+            "type": "string",
+            "enum": [
+              "planning",
+              "review",
+              "validation",
+              "implementation",
+              "reverse-engineering",
+              "plugin-execution",
+              "adr-governance",
+              "quality-witness",
+              "documentation-sync"
+            ]
+          },
+          "description": {
+            "type": "string",
+            "minLength": 20
+          },
+          "read_only": {
+            "type": "boolean"
+          },
+          "edits": {
+            "type": "boolean"
+          },
+          "background": {
+            "type": "boolean"
+          },
+          "worktree_isolation": {
+            "type": "boolean"
+          },
+          "mcp": {
+            "type": "boolean"
+          },
+          "skills": {
+            "type": "boolean"
+          },
+          "structured_evidence": {
+            "type": "boolean"
+          },
+          "risk_tier": {
+            "default": "medium",
+            "type": "string",
+            "enum": [
+              "low",
+              "medium",
+              "high",
+              "critical"
+            ]
+          }
+        },
+        "required": [
+          "task_kind",
+          "description",
+          "read_only",
+          "edits",
+          "background",
+          "worktree_isolation",
+          "mcp",
+          "skills",
+          "structured_evidence",
+          "risk_tier"
+        ],
+        "additionalProperties": false
+      }
+    },
+    "governance": {
+      "type": "object",
+      "properties": {
+        "owner": {
+          "type": "string",
+          "minLength": 2
+        },
+        "trust_tier": {
+          "type": "string",
+          "enum": [
+            "enterprise-approved",
+            "local-dev",
+            "experimental",
+            "blocked"
+          ]
+        },
+        "approval": {
+          "default": "maintainer",
+          "type": "string",
+          "enum": [
+            "none",
+            "maintainer",
+            "architecture-board",
+            "security"
+          ]
+        },
+        "notes": {
+          "default": [],
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        }
+      },
+      "required": [
+        "owner",
+        "trust_tier",
+        "approval",
+        "notes"
+      ],
+      "additionalProperties": false
+    }
+  },
+  "required": [
+    "schema_version",
+    "id",
+    "provider",
+    "label",
+    "status",
+    "execution",
+    "capabilities",
+    "governance"
+  ],
+  "additionalProperties": false,
+  "title": "CodeSDD Agent Binding Adapter",
+  "description": "Machine-readable provider adapter contract for Codex, OpenCode, Claude Code, CloudCode, and test agent bindings."
+}

package/schemas/sdd/agent-binding-resolution.schema.json

@@ -0,0 +1,338 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "schema_version": {
+      "type": "number",
+      "const": 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))$"
+    },
+    "status": {
+      "type": "string",
+      "enum": [
+        "resolved",
+        "fallback"
+      ]
+    },
+    "request": {
+      "type": "object",
+      "properties": {
+        "schema_version": {
+          "default": 1,
+          "type": "number",
+          "const": 1
+        },
+        "feature_ref": {
+          "type": "string",
+          "pattern": "^FEAT-\\d{4}$"
+        },
+        "task_kind": {
+          "type": "string",
+          "enum": [
+            "planning",
+            "review",
+            "validation",
+            "implementation",
+            "reverse-engineering",
+            "plugin-execution",
+            "adr-governance",
+            "quality-witness",
+            "documentation-sync"
+          ]
+        },
+        "provider": {
+          "type": "string",
+          "enum": [
+            "codex",
+            "opencode",
+            "claude-code",
+            "cloudcode",
+            "deepagents",
+            "fake"
+          ]
+        },
+        "allowed_providers": {
+          "default": [
+            "codex",
+            "opencode",
+            "claude-code",
+            "cloudcode",
+            "deepagents",
+            "fake"
+          ],
+          "type": "array",
+          "items": {
+            "type": "string",
+            "enum": [
+              "codex",
+              "opencode",
+              "claude-code",
+              "cloudcode",
+              "deepagents",
+              "fake"
+            ]
+          }
+        },
+        "statuses": {
+          "default": [
+            "active"
+          ],
+          "type": "array",
+          "items": {
+            "type": "string",
+            "enum": [
+              "active",
+              "disabled",
+              "experimental"
+            ]
+          }
+        },
+        "trust_tiers": {
+          "default": [
+            "enterprise-approved",
+            "local-dev",
+            "experimental"
+          ],
+          "type": "array",
+          "items": {
+            "type": "string",
+            "enum": [
+              "enterprise-approved",
+              "local-dev",
+              "experimental",
+              "blocked"
+            ]
+          }
+        },
+        "require_edits": {
+          "default": false,
+          "type": "boolean"
+        },
+        "require_background": {
+          "default": false,
+          "type": "boolean"
+        },
+        "require_worktree_isolation": {
+          "default": false,
+          "type": "boolean"
+        },
+        "require_mcp": {
+          "default": false,
+          "type": "boolean"
+        },
+        "require_skills": {
+          "default": false,
+          "type": "boolean"
+        },
+        "require_structured_evidence": {
+          "default": true,
+          "type": "boolean"
+        },
+        "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))$"
+        }
+      },
+      "required": [
+        "schema_version",
+        "feature_ref",
+        "task_kind",
+        "allowed_providers",
+        "statuses",
+        "trust_tiers",
+        "require_edits",
+        "require_background",
+        "require_worktree_isolation",
+        "require_mcp",
+        "require_skills",
+        "require_structured_evidence"
+      ],
+      "additionalProperties": false
+    },
+    "selected": {
+      "type": "object",
+      "properties": {
+        "adapter_ref": {
+          "type": "object",
+          "properties": {
+            "id": {
+              "type": "string",
+              "pattern": "^codesdd-agent-[a-z0-9][a-z0-9-]*$"
+            },
+            "provider": {
+              "type": "string",
+              "enum": [
+                "codex",
+                "opencode",
+                "claude-code",
+                "cloudcode",
+                "deepagents",
+                "fake"
+              ]
+            },
+            "label": {
+              "type": "string",
+              "minLength": 2
+            }
+          },
+          "required": [
+            "id",
+            "provider",
+            "label"
+          ],
+          "additionalProperties": false
+        },
+        "task_kind": {
+          "type": "string",
+          "enum": [
+            "planning",
+            "review",
+            "validation",
+            "implementation",
+            "reverse-engineering",
+            "plugin-execution",
+            "adr-governance",
+            "quality-witness",
+            "documentation-sync"
+          ]
+        },
+        "rank": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 9007199254740991
+        },
+        "reasons": {
+          "default": [],
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        }
+      },
+      "required": [
+        "adapter_ref",
+        "task_kind",
+        "rank",
+        "reasons"
+      ],
+      "additionalProperties": false
+    },
+    "candidates": {
+      "default": [],
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "adapter_ref": {
+            "type": "object",
+            "properties": {
+              "id": {
+                "type": "string",
+                "pattern": "^codesdd-agent-[a-z0-9][a-z0-9-]*$"
+              },
+              "provider": {
+                "type": "string",
+                "enum": [
+                  "codex",
+                  "opencode",
+                  "claude-code",
+                  "cloudcode",
+                  "deepagents",
+                  "fake"
+                ]
+              },
+              "label": {
+                "type": "string",
+                "minLength": 2
+              }
+            },
+            "required": [
+              "id",
+              "provider",
+              "label"
+            ],
+            "additionalProperties": false
+          },
+          "task_kind": {
+            "type": "string",
+            "enum": [
+              "planning",
+              "review",
+              "validation",
+              "implementation",
+              "reverse-engineering",
+              "plugin-execution",
+              "adr-governance",
+              "quality-witness",
+              "documentation-sync"
+            ]
+          },
+          "rank": {
+            "type": "integer",
+            "minimum": 0,
+            "maximum": 9007199254740991
+          },
+          "reasons": {
+            "default": [],
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          }
+        },
+        "required": [
+          "adapter_ref",
+          "task_kind",
+          "rank",
+          "reasons"
+        ],
+        "additionalProperties": false
+      }
+    },
+    "reasons": {
+      "default": [],
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
+    "fallback": {
+      "type": "object",
+      "properties": {
+        "strategy": {
+          "type": "string",
+          "enum": [
+            "manual-agent-selection",
+            "local-human-execution",
+            "no-compatible-agent"
+          ]
+        },
+        "message": {
+          "type": "string",
+          "minLength": 1
+        }
+      },
+      "required": [
+        "strategy",
+        "message"
+      ],
+      "additionalProperties": false
+    }
+  },
+  "required": [
+    "schema_version",
+    "created_at",
+    "status",
+    "request",
+    "candidates",
+    "reasons"
+  ],
+  "additionalProperties": false,
+  "title": "CodeSDD Agent Binding Resolution",
+  "description": "Machine-readable resolution result for selecting a compatible coding-agent adapter for a FEAT task."
+}