@devtrack-solution/codesdd 1.2.2 → 1.2.4-rc3

package/schemas/sdd/plugin-artifact-map.schema.json

@@ -0,0 +1,223 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "schema_version": {
+      "type": "number",
+      "const": 1
+    },
+    "sdk_package": {
+      "default": "@devtrack-solution/codesdd-plugin-sdk",
+      "type": "string",
+      "const": "@devtrack-solution/codesdd-plugin-sdk"
+    },
+    "feature_ref": {
+      "type": "string",
+      "pattern": "^FEAT-\\d{4}$"
+    },
+    "operation_id": {
+      "type": "string",
+      "pattern": "^[a-z0-9][a-z0-9-]*$"
+    },
+    "plugin_ref": {
+      "type": "object",
+      "properties": {
+        "id": {
+          "type": "string",
+          "minLength": 1
+        },
+        "version": {
+          "type": "string",
+          "pattern": "^\\d+\\.\\d+\\.\\d+(?:[-+][0-9A-Za-z.-]+)?$"
+        }
+      },
+      "required": [
+        "id",
+        "version"
+      ],
+      "additionalProperties": false
+    },
+    "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))$"
+    },
+    "artifacts": {
+      "default": [],
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "path": {
+            "type": "string",
+            "pattern": "^(?!\\/)(?![A-Za-z]:[\\\\/])(?!.*(?:^|[\\\\/])\\.\\.(?:[\\\\/]|$)).+$"
+          },
+          "operation": {
+            "type": "string",
+            "enum": [
+              "planned",
+              "created",
+              "modified",
+              "deleted",
+              "unchanged",
+              "validated"
+            ]
+          },
+          "artifact_kind": {
+            "type": "string",
+            "enum": [
+              "source",
+              "test",
+              "documentation",
+              "configuration",
+              "schema",
+              "evidence",
+              "migration",
+              "asset",
+              "package-metadata"
+            ]
+          },
+          "role": {
+            "type": "string",
+            "enum": [
+              "interface",
+              "type",
+              "implementation",
+              "abstraction",
+              "business-object",
+              "value-object",
+              "entity",
+              "repository-port",
+              "use-case",
+              "service",
+              "handler",
+              "adapter",
+              "mapper",
+              "module",
+              "controller",
+              "dto",
+              "validator",
+              "policy",
+              "manifest",
+              "fixture",
+              "test",
+              "documentation",
+              "evidence"
+            ]
+          },
+          "layer": {
+            "type": "string",
+            "enum": [
+              "root",
+              "domain",
+              "application",
+              "infrastructure",
+              "presentation",
+              "shared",
+              "tests",
+              "docs",
+              "sdd",
+              "config",
+              "assets"
+            ]
+          },
+          "content_type": {
+            "type": "string",
+            "minLength": 1
+          },
+          "reason": {
+            "type": "string",
+            "minLength": 1
+          },
+          "language": {
+            "type": "string",
+            "enum": [
+              "typescript",
+              "javascript",
+              "python",
+              "java",
+              "go",
+              "rust",
+              "csharp",
+              "php",
+              "ruby",
+              "shell",
+              "other"
+            ]
+          },
+          "context": {
+            "type": "string",
+            "minLength": 1
+          },
+          "implementation": {
+            "default": "manual",
+            "type": "string",
+            "enum": [
+              "concrete",
+              "abstract",
+              "contract",
+              "generated",
+              "manual"
+            ]
+          },
+          "decision_refs": {
+            "default": [],
+            "type": "array",
+            "items": {
+              "type": "string",
+              "pattern": "^(?:ADR|DEB|EPIC|FEAT|INS)-\\d{4}$"
+            }
+          },
+          "source_refs": {
+            "default": [],
+            "type": "array",
+            "items": {
+              "type": "string",
+              "minLength": 1
+            }
+          },
+          "tags": {
+            "default": [],
+            "type": "array",
+            "items": {
+              "type": "string",
+              "minLength": 1
+            }
+          },
+          "metadata": {
+            "default": {},
+            "type": "object",
+            "propertyNames": {
+              "type": "string"
+            },
+            "additionalProperties": {}
+          }
+        },
+        "required": [
+          "path",
+          "operation",
+          "artifact_kind",
+          "role",
+          "layer",
+          "content_type",
+          "reason",
+          "implementation",
+          "decision_refs",
+          "source_refs",
+          "tags",
+          "metadata"
+        ],
+        "additionalProperties": false
+      }
+    }
+  },
+  "required": [
+    "schema_version",
+    "sdk_package",
+    "generated_at",
+    "artifacts"
+  ],
+  "additionalProperties": false,
+  "title": "CodeSDD Plugin SDK Artifact Map",
+  "description": "Typed file map for plugin-planned artifacts with layer, role, kind, operation, decision refs, and source refs."
+}

package/schemas/sdd/plugin-compliance-index.schema.json

@@ -0,0 +1,136 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "schema_version": {
+      "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}$"
+    },
+    "operation_id": {
+      "type": "string",
+      "pattern": "^[a-z0-9][a-z0-9-]*$"
+    },
+    "plugin_ref": {
+      "type": "object",
+      "properties": {
+        "id": {
+          "type": "string",
+          "minLength": 1
+        },
+        "version": {
+          "type": "string",
+          "minLength": 1
+        }
+      },
+      "required": [
+        "id",
+        "version"
+      ],
+      "additionalProperties": false
+    },
+    "capability": {
+      "type": "string",
+      "minLength": 1
+    },
+    "score": {
+      "type": "number",
+      "minimum": 0,
+      "maximum": 100
+    },
+    "decision": {
+      "type": "string",
+      "enum": [
+        "compliant",
+        "warning",
+        "non-compliant"
+      ]
+    },
+    "criteria": {
+      "minItems": 1,
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": "string",
+            "minLength": 1
+          },
+          "label": {
+            "type": "string",
+            "minLength": 1
+          },
+          "status": {
+            "type": "string",
+            "enum": [
+              "pass",
+              "warn",
+              "fail"
+            ]
+          },
+          "score": {
+            "type": "number",
+            "minimum": 0
+          },
+          "max_score": {
+            "type": "number",
+            "exclusiveMinimum": 0
+          },
+          "evidence": {
+            "type": "string",
+            "minLength": 1
+          },
+          "issues": {
+            "default": [],
+            "type": "array",
+            "items": {
+              "type": "string",
+              "minLength": 1
+            }
+          }
+        },
+        "required": [
+          "id",
+          "label",
+          "status",
+          "score",
+          "max_score",
+          "evidence",
+          "issues"
+        ],
+        "additionalProperties": false
+      }
+    },
+    "evidence_refs": {
+      "default": [],
+      "type": "array",
+      "items": {
+        "type": "string",
+        "minLength": 1
+      }
+    }
+  },
+  "required": [
+    "schema_version",
+    "generated_at",
+    "feature_ref",
+    "operation_id",
+    "plugin_ref",
+    "capability",
+    "score",
+    "decision",
+    "criteria",
+    "evidence_refs"
+  ],
+  "additionalProperties": false,
+  "title": "CodeSDD Plugin Compliance Index",
+  "description": "Machine-readable compliance score and criterion index for a CodeSDD enterprise plugin operation."
+}

package/schemas/sdd/plugin-dry-run-plan.schema.json

@@ -0,0 +1,260 @@
+{
+  "$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": [
+        "planned",
+        "unresolved"
+      ]
+    },
+    "request": {
+      "type": "object",
+      "properties": {
+        "feature_ref": {
+          "type": "string",
+          "pattern": "^FEAT-\\d{4}$"
+        },
+        "capability": {
+          "type": "string",
+          "minLength": 1
+        },
+        "inputs": {
+          "default": {},
+          "type": "object",
+          "propertyNames": {
+            "type": "string"
+          },
+          "additionalProperties": {}
+        },
+        "skill_ref": {
+          "type": "string",
+          "minLength": 1
+        },
+        "technology": {
+          "type": "object",
+          "properties": {
+            "language": {
+              "type": "string",
+              "minLength": 1
+            },
+            "framework": {
+              "type": "string",
+              "minLength": 1
+            }
+          },
+          "additionalProperties": false
+        },
+        "requested_write_scope": {
+          "default": [],
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1
+          }
+        },
+        "require_apply": {
+          "default": false,
+          "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": [
+        "feature_ref",
+        "capability",
+        "inputs",
+        "requested_write_scope",
+        "require_apply"
+      ],
+      "additionalProperties": false
+    },
+    "reasons": {
+      "default": [],
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
+    "envelope": {
+      "type": "object",
+      "properties": {
+        "schema_version": {
+          "type": "number",
+          "const": 1
+        },
+        "mode": {
+          "type": "string",
+          "const": "dry-run"
+        },
+        "feature_ref": {
+          "type": "string",
+          "pattern": "^FEAT-\\d{4}$"
+        },
+        "skill_ref": {
+          "type": "string"
+        },
+        "plugin_ref": {
+          "type": "object",
+          "properties": {
+            "id": {
+              "type": "string",
+              "minLength": 1
+            },
+            "version": {
+              "type": "string",
+              "minLength": 1
+            }
+          },
+          "required": [
+            "id",
+            "version"
+          ],
+          "additionalProperties": false
+        },
+        "capability": {
+          "type": "string",
+          "minLength": 1
+        },
+        "inputs": {
+          "type": "object",
+          "propertyNames": {
+            "type": "string"
+          },
+          "additionalProperties": {}
+        },
+        "command": {
+          "type": "object",
+          "properties": {
+            "executable": {
+              "type": "string",
+              "minLength": 1
+            },
+            "args": {
+              "default": [],
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            },
+            "timeout_seconds": {
+              "type": "integer",
+              "exclusiveMinimum": 0,
+              "maximum": 9007199254740991
+            },
+            "env_allowlist": {
+              "default": [],
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            },
+            "network": {
+              "type": "string",
+              "enum": [
+                "disabled",
+                "restricted",
+                "enabled"
+              ]
+            },
+            "process_spawn": {
+              "type": "string",
+              "enum": [
+                "forbidden",
+                "declared"
+              ]
+            }
+          },
+          "required": [
+            "executable",
+            "args",
+            "timeout_seconds",
+            "env_allowlist",
+            "network",
+            "process_spawn"
+          ],
+          "additionalProperties": false
+        },
+        "write_scope": {
+          "default": [],
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "evidence_requirements": {
+          "default": [],
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        }
+      },
+      "required": [
+        "schema_version",
+        "mode",
+        "feature_ref",
+        "plugin_ref",
+        "capability",
+        "inputs",
+        "command",
+        "write_scope",
+        "evidence_requirements"
+      ],
+      "additionalProperties": false
+    },
+    "artifact_plan": {
+      "default": [],
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "path": {
+            "type": "string",
+            "minLength": 1
+          },
+          "operation": {
+            "type": "string",
+            "enum": [
+              "plan"
+            ]
+          },
+          "reason": {
+            "type": "string",
+            "minLength": 1
+          }
+        },
+        "required": [
+          "path",
+          "operation",
+          "reason"
+        ],
+        "additionalProperties": false
+      }
+    }
+  },
+  "required": [
+    "schema_version",
+    "created_at",
+    "status",
+    "request",
+    "reasons",
+    "artifact_plan"
+  ],
+  "additionalProperties": false,
+  "title": "CodeSDD Plugin Dry-Run Execution Plan",
+  "description": "Machine-readable dry-run broker plan contract for a resolved CodeSDD enterprise plugin capability."
+}