@devtrack-solution/codesdd 1.2.2 → 1.2.3

package/schemas/sdd/backlog-projection-plan.schema.json

@@ -0,0 +1,180 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "schema_version": {
+      "default": 1,
+      "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))$"
+    },
+    "provider": {
+      "type": "string",
+      "enum": [
+        "azure-devops",
+        "jira",
+        "trello",
+        "confluence",
+        "asana",
+        "generic"
+      ]
+    },
+    "mode": {
+      "type": "string",
+      "enum": [
+        "dry-run",
+        "apply"
+      ]
+    },
+    "direction": {
+      "type": "string",
+      "enum": [
+        "push",
+        "pull",
+        "bidirectional"
+      ]
+    },
+    "source_of_truth": {
+      "type": "string",
+      "const": "codesdd"
+    },
+    "items": {
+      "default": [],
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "schema_version": {
+            "default": 1,
+            "type": "number",
+            "const": 1
+          },
+          "provider": {
+            "type": "string",
+            "enum": [
+              "azure-devops",
+              "jira",
+              "trello",
+              "confluence",
+              "asana",
+              "generic"
+            ]
+          },
+          "canonical_ref": {
+            "type": "string",
+            "pattern": "^(INS|DEB|EPIC|FEAT)-\\d{4}$"
+          },
+          "entity_kind": {
+            "type": "string",
+            "enum": [
+              "insight",
+              "debate",
+              "epic",
+              "feature",
+              "task"
+            ]
+          },
+          "operation": {
+            "type": "string",
+            "enum": [
+              "create",
+              "update",
+              "link",
+              "noop"
+            ]
+          },
+          "idempotency_key": {
+            "type": "string",
+            "minLength": 1
+          },
+          "external_type": {
+            "type": "string",
+            "minLength": 1
+          },
+          "fields": {
+            "type": "object",
+            "propertyNames": {
+              "type": "string",
+              "pattern": "^[A-Za-z][A-Za-z0-9_.-]*$"
+            },
+            "additionalProperties": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  }
+                }
+              ]
+            }
+          },
+          "links": {
+            "default": [],
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "rel": {
+                  "type": "string",
+                  "enum": [
+                    "parent",
+                    "trace",
+                    "canonical"
+                  ]
+                },
+                "target_ref": {
+                  "type": "string",
+                  "pattern": "^(INS|DEB|EPIC|FEAT)-\\d{4}$"
+                }
+              },
+              "required": [
+                "rel",
+                "target_ref"
+              ],
+              "additionalProperties": false
+            }
+          }
+        },
+        "required": [
+          "schema_version",
+          "provider",
+          "canonical_ref",
+          "entity_kind",
+          "operation",
+          "idempotency_key",
+          "external_type",
+          "fields",
+          "links"
+        ],
+        "additionalProperties": false
+      }
+    },
+    "warnings": {
+      "default": [],
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    }
+  },
+  "required": [
+    "schema_version",
+    "created_at",
+    "provider",
+    "mode",
+    "direction",
+    "source_of_truth",
+    "items",
+    "warnings"
+  ],
+  "additionalProperties": false,
+  "title": "CodeSDD Backlog Projection Plan",
+  "description": "Machine-readable dry-run or apply projection plan for external backlog/task-management providers."
+}

package/schemas/sdd/backlog-provider-contract.schema.json

@@ -0,0 +1,260 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "schema_version": {
+      "default": 1,
+      "type": "number",
+      "const": 1
+    },
+    "provider": {
+      "type": "string",
+      "enum": [
+        "azure-devops",
+        "jira",
+        "trello",
+        "confluence",
+        "asana",
+        "generic"
+      ]
+    },
+    "adapter_id": {
+      "type": "string",
+      "pattern": "^[a-z][a-z0-9-]*$"
+    },
+    "label": {
+      "type": "string",
+      "minLength": 2
+    },
+    "status": {
+      "default": "experimental",
+      "type": "string",
+      "enum": [
+        "active",
+        "experimental",
+        "disabled"
+      ]
+    },
+    "auth": {
+      "type": "object",
+      "properties": {
+        "mode": {
+          "type": "string",
+          "enum": [
+            "none",
+            "pat",
+            "oauth",
+            "managed-identity",
+            "app-installation"
+          ]
+        },
+        "required_env": {
+          "default": [],
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1
+          }
+        },
+        "secret_fields": {
+          "default": [],
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1
+          }
+        }
+      },
+      "required": [
+        "mode",
+        "required_env",
+        "secret_fields"
+      ],
+      "additionalProperties": false
+    },
+    "capabilities": {
+      "minItems": 1,
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "operation": {
+            "type": "string",
+            "enum": [
+              "create",
+              "update",
+              "link",
+              "query"
+            ]
+          },
+          "entity_kinds": {
+            "minItems": 1,
+            "type": "array",
+            "items": {
+              "type": "string",
+              "enum": [
+                "insight",
+                "debate",
+                "epic",
+                "feature",
+                "task"
+              ]
+            }
+          },
+          "dry_run": {
+            "default": true,
+            "type": "boolean"
+          },
+          "apply": {
+            "default": false,
+            "type": "boolean"
+          },
+          "idempotent": {
+            "default": true,
+            "type": "boolean"
+          },
+          "required_fields": {
+            "default": [],
+            "type": "array",
+            "items": {
+              "type": "string",
+              "pattern": "^[A-Za-z][A-Za-z0-9_.-]*$"
+            }
+          }
+        },
+        "required": [
+          "operation",
+          "entity_kinds",
+          "dry_run",
+          "apply",
+          "idempotent",
+          "required_fields"
+        ],
+        "additionalProperties": false
+      }
+    },
+    "mapping": {
+      "type": "object",
+      "properties": {
+        "external_project_field": {
+          "type": "string",
+          "pattern": "^[A-Za-z][A-Za-z0-9_.-]*$"
+        },
+        "external_id_field": {
+          "type": "string",
+          "pattern": "^[A-Za-z][A-Za-z0-9_.-]*$"
+        },
+        "external_url_field": {
+          "type": "string",
+          "pattern": "^[A-Za-z][A-Za-z0-9_.-]*$"
+        },
+        "canonical_ref_field": {
+          "type": "string",
+          "pattern": "^[A-Za-z][A-Za-z0-9_.-]*$"
+        },
+        "parent_ref_field": {
+          "type": "string",
+          "pattern": "^[A-Za-z][A-Za-z0-9_.-]*$"
+        },
+        "entity_type_field": {
+          "type": "string",
+          "pattern": "^[A-Za-z][A-Za-z0-9_.-]*$"
+        },
+        "title_field": {
+          "type": "string",
+          "pattern": "^[A-Za-z][A-Za-z0-9_.-]*$"
+        },
+        "status_field": {
+          "type": "string",
+          "pattern": "^[A-Za-z][A-Za-z0-9_.-]*$"
+        }
+      },
+      "required": [
+        "external_id_field",
+        "canonical_ref_field",
+        "entity_type_field",
+        "title_field",
+        "status_field"
+      ],
+      "additionalProperties": false
+    },
+    "canonical_state_boundary": {
+      "type": "object",
+      "properties": {
+        "source_of_truth": {
+          "type": "string",
+          "const": "codesdd"
+        },
+        "state_paths": {
+          "default": [
+            ".sdd/state/*.yaml"
+          ],
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1
+          }
+        },
+        "external_state_authoritative": {
+          "type": "boolean",
+          "const": false
+        },
+        "hidden_state_allowed": {
+          "type": "boolean",
+          "const": false
+        }
+      },
+      "required": [
+        "source_of_truth",
+        "state_paths",
+        "external_state_authoritative",
+        "hidden_state_allowed"
+      ],
+      "additionalProperties": false
+    },
+    "governance": {
+      "type": "object",
+      "properties": {
+        "owner": {
+          "type": "string",
+          "minLength": 2
+        },
+        "sync_requires_dry_run": {
+          "default": true,
+          "type": "boolean"
+        },
+        "mutation_requires_approval": {
+          "default": true,
+          "type": "boolean"
+        },
+        "audit_event": {
+          "default": "codesdd.backlog.projection",
+          "type": "string",
+          "minLength": 1
+        }
+      },
+      "required": [
+        "owner",
+        "sync_requires_dry_run",
+        "mutation_requires_approval",
+        "audit_event"
+      ],
+      "additionalProperties": false
+    }
+  },
+  "required": [
+    "schema_version",
+    "provider",
+    "adapter_id",
+    "label",
+    "status",
+    "auth",
+    "capabilities",
+    "mapping",
+    "canonical_state_boundary",
+    "governance"
+  ],
+  "additionalProperties": false,
+  "title": "CodeSDD Backlog Provider Contract",
+  "description": "Machine-readable provider contract for projecting canonical CodeSDD backlog state to external planning tools."
+}