@devtrack-solution/codesdd 1.2.3 → 1.2.4

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-evidence-manifest.schema.json

@@ -133,6 +133,115 @@
               },
               "content_type": {
                 "type": "string"
+              },
+              "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"
+                ]
+              },
+              "language": {
+                "type": "string",
+                "enum": [
+                  "typescript",
+                  "javascript",
+                  "python",
+                  "java",
+                  "go",
+                  "rust",
+                  "csharp",
+                  "php",
+                  "ruby",
+                  "shell",
+                  "other"
+                ]
+              },
+              "context": {
+                "type": "string",
+                "minLength": 1
+              },
+              "implementation": {
+                "type": "string",
+                "enum": [
+                  "concrete",
+                  "abstract",
+                  "contract",
+                  "generated",
+                  "manual"
+                ]
+              },
+              "decision_refs": {
+                "type": "array",
+                "items": {
+                  "type": "string",
+                  "pattern": "^(?:ADR|DEB|EPIC|FEAT|INS)-\\d{4}$"
+                }
+              },
+              "source_refs": {
+                "type": "array",
+                "items": {
+                  "type": "string",
+                  "minLength": 1
+                }
+              },
+              "tags": {
+                "type": "array",
+                "items": {
+                  "type": "string",
+                  "minLength": 1
+                }
               }
             },
             "required": [

package/schemas/sdd/plugin-language-runtime.schema.json

@@ -0,0 +1,103 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "language": {
+      "type": "string",
+      "enum": [
+        "typescript",
+        "javascript",
+        "python",
+        "java",
+        "go",
+        "rust",
+        "csharp",
+        "php",
+        "ruby",
+        "shell",
+        "other"
+      ]
+    },
+    "runtime": {
+      "type": "string",
+      "minLength": 1
+    },
+    "bridge": {
+      "type": "string",
+      "enum": [
+        "node-library",
+        "stdio-json",
+        "process-cli",
+        "http-local",
+        "container",
+        "wasm"
+      ]
+    },
+    "input_transport": {
+      "type": "string",
+      "enum": [
+        "sdk-call",
+        "stdin-json",
+        "stdout-json",
+        "file-envelope",
+        "http-json"
+      ]
+    },
+    "output_transport": {
+      "type": "string",
+      "enum": [
+        "sdk-call",
+        "stdin-json",
+        "stdout-json",
+        "file-envelope",
+        "http-json"
+      ]
+    },
+    "command": {
+      "type": "string",
+      "minLength": 1
+    },
+    "args": {
+      "default": [],
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
+    "package_manager": {
+      "type": "string",
+      "minLength": 1
+    },
+    "min_versions": {
+      "default": {},
+      "type": "object",
+      "propertyNames": {
+        "type": "string"
+      },
+      "additionalProperties": {
+        "type": "string"
+      }
+    },
+    "env_allowlist": {
+      "default": [],
+      "type": "array",
+      "items": {
+        "type": "string",
+        "pattern": "^[A-Z_][A-Z0-9_]*$"
+      }
+    }
+  },
+  "required": [
+    "language",
+    "runtime",
+    "bridge",
+    "input_transport",
+    "output_transport",
+    "args",
+    "min_versions",
+    "env_allowlist"
+  ],
+  "additionalProperties": false,
+  "title": "CodeSDD Plugin SDK Language Runtime",
+  "description": "Language-agnostic runtime bridge contract for TypeScript, JavaScript, Python, Java, Go, Rust, C#, shell, and custom plugin implementations."
+}

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

@@ -0,0 +1,74 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "package_name": {
+      "type": "string",
+      "pattern": "^@devtrack-solution\\/codesdd-plugin-[a-z0-9][a-z0-9-]*$"
+    },
+    "sdk_package": {
+      "default": "@devtrack-solution/codesdd-plugin-sdk",
+      "type": "string",
+      "pattern": "^@devtrack-solution\\/codesdd-plugin-sdk$"
+    },
+    "sdk_version": {
+      "default": "*",
+      "type": "string",
+      "pattern": "^(?:[~^]?\\d+\\.\\d+\\.\\d+(?:[-+][0-9A-Za-z.-]+)?|[<>]=?\\d+\\.\\d+\\.\\d+(?:\\s+<\\d+\\.\\d+\\.\\d+)?|\\*)$"
+    },
+    "package_kind": {
+      "type": "string",
+      "enum": [
+        "frontend",
+        "backend",
+        "full-stack",
+        "generator",
+        "validator",
+        "evidence",
+        "agent-adapter",
+        "policy-pack"
+      ]
+    },
+    "versioning": {
+      "default": "semver",
+      "type": "string",
+      "const": "semver"
+    },
+    "registry": {
+      "default": "workspace",
+      "type": "string",
+      "enum": [
+        "workspace",
+        "npm",
+        "private-npm",
+        "artifact-registry",
+        "custom"
+      ]
+    },
+    "keywords": {
+      "default": [],
+      "type": "array",
+      "items": {
+        "type": "string",
+        "minLength": 1
+      }
+    },
+    "internal_package": {
+      "default": false,
+      "type": "boolean"
+    }
+  },
+  "required": [
+    "package_name",
+    "sdk_package",
+    "sdk_version",
+    "package_kind",
+    "versioning",
+    "registry",
+    "keywords",
+    "internal_package"
+  ],
+  "additionalProperties": false,
+  "title": "CodeSDD Plugin SDK Package Governance",
+  "description": "Package naming, versioning, registry, and keyword contract for @devtrack-solution/codesdd-plugin-sdk plugin packages."
+}

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

@@ -96,6 +96,177 @@
                 ],
                 "additionalProperties": false
               },
+              "package_governance": {
+                "type": "object",
+                "properties": {
+                  "package_name": {
+                    "type": "string",
+                    "pattern": "^@devtrack-solution\\/codesdd-plugin-[a-z0-9][a-z0-9-]*$"
+                  },
+                  "sdk_package": {
+                    "default": "@devtrack-solution/codesdd-plugin-sdk",
+                    "type": "string",
+                    "pattern": "^@devtrack-solution\\/codesdd-plugin-sdk$"
+                  },
+                  "sdk_version": {
+                    "default": "*",
+                    "type": "string",
+                    "pattern": "^(?:[~^]?\\d+\\.\\d+\\.\\d+(?:[-+][0-9A-Za-z.-]+)?|[<>]=?\\d+\\.\\d+\\.\\d+(?:\\s+<\\d+\\.\\d+\\.\\d+)?|\\*)$"
+                  },
+                  "package_kind": {
+                    "type": "string",
+                    "enum": [
+                      "frontend",
+                      "backend",
+                      "full-stack",
+                      "generator",
+                      "validator",
+                      "evidence",
+                      "agent-adapter",
+                      "policy-pack"
+                    ]
+                  },
+                  "versioning": {
+                    "default": "semver",
+                    "type": "string",
+                    "const": "semver"
+                  },
+                  "registry": {
+                    "default": "workspace",
+                    "type": "string",
+                    "enum": [
+                      "workspace",
+                      "npm",
+                      "private-npm",
+                      "artifact-registry",
+                      "custom"
+                    ]
+                  },
+                  "keywords": {
+                    "default": [],
+                    "type": "array",
+                    "items": {
+                      "type": "string",
+                      "minLength": 1
+                    }
+                  },
+                  "internal_package": {
+                    "default": false,
+                    "type": "boolean"
+                  }
+                },
+                "required": [
+                  "package_name",
+                  "sdk_package",
+                  "sdk_version",
+                  "package_kind",
+                  "versioning",
+                  "registry",
+                  "keywords",
+                  "internal_package"
+                ],
+                "additionalProperties": false
+              },
+              "language_runtime": {
+                "type": "object",
+                "properties": {
+                  "language": {
+                    "type": "string",
+                    "enum": [
+                      "typescript",
+                      "javascript",
+                      "python",
+                      "java",
+                      "go",
+                      "rust",
+                      "csharp",
+                      "php",
+                      "ruby",
+                      "shell",
+                      "other"
+                    ]
+                  },
+                  "runtime": {
+                    "type": "string",
+                    "minLength": 1
+                  },
+                  "bridge": {
+                    "type": "string",
+                    "enum": [
+                      "node-library",
+                      "stdio-json",
+                      "process-cli",
+                      "http-local",
+                      "container",
+                      "wasm"
+                    ]
+                  },
+                  "input_transport": {
+                    "type": "string",
+                    "enum": [
+                      "sdk-call",
+                      "stdin-json",
+                      "stdout-json",
+                      "file-envelope",
+                      "http-json"
+                    ]
+                  },
+                  "output_transport": {
+                    "type": "string",
+                    "enum": [
+                      "sdk-call",
+                      "stdin-json",
+                      "stdout-json",
+                      "file-envelope",
+                      "http-json"
+                    ]
+                  },
+                  "command": {
+                    "type": "string",
+                    "minLength": 1
+                  },
+                  "args": {
+                    "default": [],
+                    "type": "array",
+                    "items": {
+                      "type": "string"
+                    }
+                  },
+                  "package_manager": {
+                    "type": "string",
+                    "minLength": 1
+                  },
+                  "min_versions": {
+                    "default": {},
+                    "type": "object",
+                    "propertyNames": {
+                      "type": "string"
+                    },
+                    "additionalProperties": {
+                      "type": "string"
+                    }
+                  },
+                  "env_allowlist": {
+                    "default": [],
+                    "type": "array",
+                    "items": {
+                      "type": "string",
+                      "pattern": "^[A-Z_][A-Z0-9_]*$"
+                    }
+                  }
+                },
+                "required": [
+                  "language",
+                  "runtime",
+                  "bridge",
+                  "input_transport",
+                  "output_transport",
+                  "args",
+                  "min_versions",
+                  "env_allowlist"
+                ],
+                "additionalProperties": false
+              },
               "capabilities": {
                 "minItems": 1,
                 "type": "array",