@devtrack-solution/codesdd 1.2.2 → 1.2.4-rc3

package/schemas/sdd/parallel-feat-scheduler-result.schema.json

@@ -0,0 +1,404 @@
+{
+  "$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))$"
+    },
+    "status": {
+      "type": "string",
+      "enum": [
+        "ready",
+        "blocked",
+        "empty"
+      ]
+    },
+    "plan": {
+      "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))$"
+        },
+        "status": {
+          "type": "string",
+          "enum": [
+            "ready",
+            "blocked",
+            "empty"
+          ]
+        },
+        "max_agents": {
+          "type": "integer",
+          "exclusiveMinimum": 0,
+          "maximum": 9007199254740991
+        },
+        "state_boundary": {
+          "type": "object",
+          "properties": {
+            "id": {
+              "type": "string",
+              "const": "codesdd-canonical-sdd-state"
+            },
+            "canonical_state_glob": {
+              "type": "string",
+              "const": ".sdd/state/*.yaml"
+            },
+            "project_state_root": {
+              "type": "string",
+              "const": ".sdd"
+            },
+            "hidden_state_allowed": {
+              "type": "boolean",
+              "const": false
+            },
+            "external_state_allowed": {
+              "type": "boolean",
+              "const": false
+            }
+          },
+          "required": [
+            "id",
+            "canonical_state_glob",
+            "project_state_root",
+            "hidden_state_allowed",
+            "external_state_allowed"
+          ],
+          "additionalProperties": false
+        },
+        "write_policy": {
+          "type": "object",
+          "properties": {
+            "allowed_root": {
+              "type": "string",
+              "const": ".sdd"
+            },
+            "canonical_state_glob": {
+              "type": "string",
+              "const": ".sdd/state/*.yaml"
+            },
+            "hidden_state_allowed": {
+              "type": "boolean",
+              "const": false
+            },
+            "external_state_allowed": {
+              "type": "boolean",
+              "const": false
+            }
+          },
+          "required": [
+            "allowed_root",
+            "canonical_state_glob",
+            "hidden_state_allowed",
+            "external_state_allowed"
+          ],
+          "additionalProperties": false
+        },
+        "rules": {
+          "default": [],
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1
+          }
+        },
+        "waves": {
+          "default": [],
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "wave_index": {
+                "type": "integer",
+                "exclusiveMinimum": 0,
+                "maximum": 9007199254740991
+              },
+              "max_parallel": {
+                "type": "integer",
+                "exclusiveMinimum": 0,
+                "maximum": 9007199254740991
+              },
+              "status": {
+                "type": "string",
+                "enum": [
+                  "ready",
+                  "blocked"
+                ]
+              },
+              "conflicts": {
+                "default": [],
+                "type": "array",
+                "items": {
+                  "type": "string"
+                }
+              },
+              "steps": {
+                "default": [],
+                "type": "array",
+                "items": {
+                  "type": "object",
+                  "properties": {
+                    "feature_ref": {
+                      "type": "string",
+                      "pattern": "^FEAT-\\d{4}$"
+                    },
+                    "title": {
+                      "type": "string",
+                      "minLength": 3
+                    },
+                    "sequence": {
+                      "type": "integer",
+                      "exclusiveMinimum": 0,
+                      "maximum": 9007199254740991
+                    },
+                    "delegation": {
+                      "type": "object",
+                      "properties": {
+                        "mode": {
+                          "type": "string",
+                          "enum": [
+                            "local-codex",
+                            "agent-adapter"
+                          ]
+                        },
+                        "provider": {
+                          "type": "string",
+                          "enum": [
+                            "codex",
+                            "opencode",
+                            "claude-code",
+                            "cloudcode",
+                            "deepagents",
+                            "fake"
+                          ]
+                        }
+                      },
+                      "required": [
+                        "mode"
+                      ],
+                      "additionalProperties": false
+                    },
+                    "commands": {
+                      "minItems": 1,
+                      "type": "array",
+                      "items": {
+                        "type": "string",
+                        "minLength": 1
+                      }
+                    },
+                    "commit_boundary": {
+                      "type": "object",
+                      "properties": {
+                        "clean_worktree_required": {
+                          "type": "boolean"
+                        },
+                        "finalize_before_commit": {
+                          "type": "boolean"
+                        },
+                        "commit_per_feature": {
+                          "type": "boolean"
+                        },
+                        "commit_message": {
+                          "type": "string",
+                          "minLength": 1
+                        }
+                      },
+                      "required": [
+                        "clean_worktree_required",
+                        "finalize_before_commit",
+                        "commit_per_feature",
+                        "commit_message"
+                      ],
+                      "additionalProperties": false
+                    },
+                    "state_boundary_ref": {
+                      "type": "string",
+                      "const": "codesdd-canonical-sdd-state"
+                    },
+                    "allowed_state_writes": {
+                      "minItems": 1,
+                      "type": "array",
+                      "items": {
+                        "type": "string",
+                        "minLength": 1
+                      }
+                    },
+                    "forbidden_state_writes": {
+                      "default": [
+                        ".codesdd/**",
+                        "external-context/**"
+                      ],
+                      "type": "array",
+                      "items": {
+                        "type": "string",
+                        "minLength": 1
+                      }
+                    },
+                    "evidence_required": {
+                      "default": [],
+                      "type": "array",
+                      "items": {
+                        "type": "string",
+                        "minLength": 1
+                      }
+                    }
+                  },
+                  "required": [
+                    "feature_ref",
+                    "title",
+                    "sequence",
+                    "delegation",
+                    "commands",
+                    "commit_boundary",
+                    "state_boundary_ref",
+                    "allowed_state_writes",
+                    "forbidden_state_writes",
+                    "evidence_required"
+                  ],
+                  "additionalProperties": false
+                }
+              }
+            },
+            "required": [
+              "wave_index",
+              "max_parallel",
+              "status",
+              "conflicts",
+              "steps"
+            ],
+            "additionalProperties": false
+          }
+        },
+        "summary": {
+          "type": "object",
+          "properties": {
+            "feature_count": {
+              "type": "integer",
+              "minimum": 0,
+              "maximum": 9007199254740991
+            },
+            "wave_count": {
+              "type": "integer",
+              "minimum": 0,
+              "maximum": 9007199254740991
+            },
+            "blocked_wave_count": {
+              "type": "integer",
+              "minimum": 0,
+              "maximum": 9007199254740991
+            }
+          },
+          "required": [
+            "feature_count",
+            "wave_count",
+            "blocked_wave_count"
+          ],
+          "additionalProperties": false
+        }
+      },
+      "required": [
+        "schema_version",
+        "generated_at",
+        "status",
+        "max_agents",
+        "state_boundary",
+        "write_policy",
+        "rules",
+        "waves",
+        "summary"
+      ],
+      "additionalProperties": false
+    },
+    "blocked_features": {
+      "default": [],
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "feature_ref": {
+            "type": "string",
+            "pattern": "^FEAT-\\d{4}$"
+          },
+          "blocked_by": {
+            "default": [],
+            "type": "array",
+            "items": {
+              "type": "string",
+              "pattern": "^FEAT-\\d{4}$"
+            }
+          },
+          "reason": {
+            "type": "string",
+            "minLength": 1
+          }
+        },
+        "required": [
+          "feature_ref",
+          "blocked_by",
+          "reason"
+        ],
+        "additionalProperties": false
+      }
+    },
+    "summary": {
+      "type": "object",
+      "properties": {
+        "feature_count": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 9007199254740991
+        },
+        "scheduled_feature_count": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 9007199254740991
+        },
+        "done_feature_count": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 9007199254740991
+        },
+        "blocked_feature_count": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 9007199254740991
+        },
+        "wave_count": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 9007199254740991
+        }
+      },
+      "required": [
+        "feature_count",
+        "scheduled_feature_count",
+        "done_feature_count",
+        "blocked_feature_count",
+        "wave_count"
+      ],
+      "additionalProperties": false
+    }
+  },
+  "required": [
+    "schema_version",
+    "generated_at",
+    "status",
+    "plan",
+    "blocked_features",
+    "summary"
+  ],
+  "additionalProperties": false,
+  "title": "CodeSDD Parallel FEAT Scheduler Result",
+  "description": "Machine-readable scheduler result linking chained FEAT waves, blocked dependencies, and the execution plan."
+}

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

@@ -0,0 +1,259 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "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"
+          },
+          "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": [
+          "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,
+  "title": "CodeSDD Plugin Artifact Manifest",
+  "description": "Machine-readable artifact output contract for a CodeSDD enterprise plugin invocation."
+}