@devtrack-solution/codesdd 1.2.2 → 1.2.3

package/schemas/sdd/plugin-runtime-invocation-plan.schema.json

@@ -0,0 +1,845 @@
+{
+  "$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": [
+        "ready",
+        "blocked",
+        "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))$"
+        },
+        "mode": {
+          "default": "dry-run",
+          "type": "string",
+          "enum": [
+            "dry-run",
+            "apply",
+            "rollback"
+          ]
+        },
+        "operation_id": {
+          "type": "string",
+          "pattern": "^[a-z0-9][a-z0-9-]*$"
+        },
+        "approval_grants": {
+          "default": [],
+          "type": "array",
+          "items": {
+            "type": "string",
+            "enum": [
+              "maintainer",
+              "security",
+              "architecture-board"
+            ]
+          }
+        },
+        "source_checksum": {
+          "type": "string"
+        },
+        "planned_writes": {
+          "default": [],
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1
+          }
+        },
+        "requested_env": {
+          "default": [],
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1
+          }
+        },
+        "network_domains": {
+          "default": [],
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1
+          }
+        },
+        "process_spawn_requested": {
+          "default": false,
+          "type": "boolean"
+        },
+        "filesystem_checks": {
+          "default": [],
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "path": {
+                "type": "string",
+                "minLength": 1
+              },
+              "real_path": {
+                "type": "string",
+                "minLength": 1
+              },
+              "project_root": {
+                "type": "string",
+                "minLength": 1
+              },
+              "is_symlink": {
+                "default": false,
+                "type": "boolean"
+              }
+            },
+            "required": [
+              "path",
+              "real_path",
+              "project_root",
+              "is_symlink"
+            ],
+            "additionalProperties": false
+          }
+        }
+      },
+      "required": [
+        "feature_ref",
+        "capability",
+        "inputs",
+        "requested_write_scope",
+        "require_apply",
+        "mode",
+        "approval_grants",
+        "planned_writes",
+        "requested_env",
+        "network_domains",
+        "process_spawn_requested",
+        "filesystem_checks"
+      ],
+      "additionalProperties": false
+    },
+    "reasons": {
+      "default": [],
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
+    "policy": {
+      "type": "object",
+      "properties": {
+        "schema_version": {
+          "type": "number",
+          "const": 1
+        },
+        "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
+        },
+        "mode": {
+          "type": "string",
+          "enum": [
+            "dry-run",
+            "apply",
+            "rollback"
+          ]
+        },
+        "decision": {
+          "type": "string",
+          "enum": [
+            "allow",
+            "warn",
+            "deny"
+          ]
+        },
+        "issues": {
+          "default": [],
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "code": {
+                "type": "string",
+                "minLength": 1
+              },
+              "severity": {
+                "type": "string",
+                "enum": [
+                  "deny",
+                  "warn"
+                ]
+              },
+              "message": {
+                "type": "string",
+                "minLength": 1
+              },
+              "path": {
+                "type": "string"
+              }
+            },
+            "required": [
+              "code",
+              "severity",
+              "message"
+            ],
+            "additionalProperties": false
+          }
+        }
+      },
+      "required": [
+        "schema_version",
+        "plugin_ref",
+        "capability",
+        "mode",
+        "decision",
+        "issues"
+      ],
+      "additionalProperties": false
+    },
+    "envelope": {
+      "type": "object",
+      "properties": {
+        "schema_version": {
+          "type": "number",
+          "const": 1
+        },
+        "operation_id": {
+          "type": "string",
+          "pattern": "^[a-z0-9][a-z0-9-]*$"
+        },
+        "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))$"
+        },
+        "mode": {
+          "type": "string",
+          "enum": [
+            "dry-run",
+            "apply",
+            "rollback"
+          ]
+        },
+        "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"
+              ]
+            },
+            "working_directory": {
+              "type": "string",
+              "minLength": 1
+            }
+          },
+          "required": [
+            "executable",
+            "args",
+            "timeout_seconds",
+            "env_allowlist",
+            "network",
+            "process_spawn",
+            "working_directory"
+          ],
+          "additionalProperties": false
+        },
+        "write_scope": {
+          "default": [],
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "policy": {
+          "type": "object",
+          "properties": {
+            "schema_version": {
+              "type": "number",
+              "const": 1
+            },
+            "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
+            },
+            "mode": {
+              "type": "string",
+              "enum": [
+                "dry-run",
+                "apply",
+                "rollback"
+              ]
+            },
+            "decision": {
+              "type": "string",
+              "enum": [
+                "allow",
+                "warn",
+                "deny"
+              ]
+            },
+            "issues": {
+              "default": [],
+              "type": "array",
+              "items": {
+                "type": "object",
+                "properties": {
+                  "code": {
+                    "type": "string",
+                    "minLength": 1
+                  },
+                  "severity": {
+                    "type": "string",
+                    "enum": [
+                      "deny",
+                      "warn"
+                    ]
+                  },
+                  "message": {
+                    "type": "string",
+                    "minLength": 1
+                  },
+                  "path": {
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "code",
+                  "severity",
+                  "message"
+                ],
+                "additionalProperties": false
+              }
+            }
+          },
+          "required": [
+            "schema_version",
+            "plugin_ref",
+            "capability",
+            "mode",
+            "decision",
+            "issues"
+          ],
+          "additionalProperties": false
+        },
+        "expected_artifact_manifest": {
+          "type": "object",
+          "properties": {
+            "path": {
+              "type": "string",
+              "minLength": 1
+            },
+            "required_operations": {
+              "default": [],
+              "type": "array",
+              "items": {
+                "type": "string",
+                "enum": [
+                  "planned",
+                  "created",
+                  "modified",
+                  "deleted",
+                  "unchanged",
+                  "validated"
+                ]
+              }
+            }
+          },
+          "required": [
+            "path",
+            "required_operations"
+          ],
+          "additionalProperties": false
+        },
+        "expected_evidence_manifest": {
+          "type": "object",
+          "properties": {
+            "path": {
+              "type": "string",
+              "minLength": 1
+            }
+          },
+          "required": [
+            "path"
+          ],
+          "additionalProperties": false
+        },
+        "expected_validation_manifest": {
+          "type": "object",
+          "properties": {
+            "path": {
+              "type": "string",
+              "minLength": 1
+            },
+            "required_statuses": {
+              "default": [],
+              "type": "array",
+              "items": {
+                "type": "string",
+                "enum": [
+                  "passed",
+                  "failed",
+                  "partial"
+                ]
+              }
+            }
+          },
+          "required": [
+            "path",
+            "required_statuses"
+          ],
+          "additionalProperties": false
+        },
+        "expected_rollback_manifest": {
+          "type": "object",
+          "properties": {
+            "path": {
+              "type": "string",
+              "minLength": 1
+            },
+            "required_for_mode": {
+              "type": "boolean"
+            }
+          },
+          "required": [
+            "path",
+            "required_for_mode"
+          ],
+          "additionalProperties": false
+        },
+        "evidence_requirements": {
+          "default": [],
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        }
+      },
+      "required": [
+        "schema_version",
+        "operation_id",
+        "created_at",
+        "mode",
+        "feature_ref",
+        "plugin_ref",
+        "capability",
+        "inputs",
+        "command",
+        "write_scope",
+        "policy",
+        "expected_artifact_manifest",
+        "expected_evidence_manifest",
+        "expected_validation_manifest",
+        "expected_rollback_manifest",
+        "evidence_requirements"
+      ],
+      "additionalProperties": false
+    },
+    "artifact_manifest": {
+      "type": "object",
+      "properties": {
+        "schema_version": {
+          "type": "number",
+          "const": 1
+        },
+        "operation_id": {
+          "type": "string",
+          "pattern": "^[a-z0-9][a-z0-9-]*$"
+        },
+        "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}$"
+        },
+        "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
+        },
+        "mode": {
+          "type": "string",
+          "enum": [
+            "dry-run",
+            "apply",
+            "rollback"
+          ]
+        },
+        "status": {
+          "type": "string",
+          "enum": [
+            "planned",
+            "applied",
+            "rolled_back",
+            "failed"
+          ]
+        },
+        "artifacts": {
+          "default": [],
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "path": {
+                "type": "string",
+                "minLength": 1
+              },
+              "operation": {
+                "type": "string",
+                "enum": [
+                  "planned",
+                  "created",
+                  "modified",
+                  "deleted",
+                  "unchanged",
+                  "validated"
+                ]
+              },
+              "reason": {
+                "type": "string",
+                "minLength": 1
+              },
+              "checksum_before": {
+                "type": "string"
+              },
+              "checksum_after": {
+                "type": "string"
+              },
+              "content_type": {
+                "type": "string"
+              }
+            },
+            "required": [
+              "path",
+              "operation",
+              "reason"
+            ],
+            "additionalProperties": false
+          }
+        },
+        "validation_evidence": {
+          "default": [],
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "command": {
+                "type": "string",
+                "minLength": 1
+              },
+              "status": {
+                "type": "string",
+                "enum": [
+                  "pending",
+                  "passed",
+                  "failed",
+                  "skipped"
+                ]
+              },
+              "evidence_ref": {
+                "type": "string"
+              }
+            },
+            "required": [
+              "command",
+              "status"
+            ],
+            "additionalProperties": false
+          }
+        }
+      },
+      "required": [
+        "schema_version",
+        "operation_id",
+        "generated_at",
+        "feature_ref",
+        "plugin_ref",
+        "capability",
+        "mode",
+        "status",
+        "artifacts",
+        "validation_evidence"
+      ],
+      "additionalProperties": false
+    },
+    "rollback_manifest": {
+      "type": "object",
+      "properties": {
+        "schema_version": {
+          "type": "number",
+          "const": 1
+        },
+        "operation_id": {
+          "type": "string",
+          "pattern": "^[a-z0-9][a-z0-9-]*$"
+        },
+        "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}$"
+        },
+        "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
+        },
+        "mode": {
+          "type": "string",
+          "enum": [
+            "dry-run",
+            "apply",
+            "rollback"
+          ]
+        },
+        "status": {
+          "type": "string",
+          "enum": [
+            "planned",
+            "not-required"
+          ]
+        },
+        "reason": {
+          "type": "string",
+          "minLength": 1
+        },
+        "rollback_steps": {
+          "default": [],
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1
+          }
+        }
+      },
+      "required": [
+        "schema_version",
+        "operation_id",
+        "generated_at",
+        "feature_ref",
+        "plugin_ref",
+        "capability",
+        "mode",
+        "status",
+        "reason",
+        "rollback_steps"
+      ],
+      "additionalProperties": false
+    }
+  },
+  "required": [
+    "schema_version",
+    "created_at",
+    "status",
+    "request",
+    "reasons"
+  ],
+  "additionalProperties": false,
+  "title": "CodeSDD Plugin Runtime Invocation Plan",
+  "description": "Machine-readable runtime invocation envelope and authorization plan for a CodeSDD enterprise plugin capability."
+}