@devtrack-solution/codesdd 1.2.2 → 1.2.4-rc3

package/schemas/sdd/parallel-feat-automation-plan.schema.json

@@ -0,0 +1,304 @@
+{
+  "$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"
+      ]
+    },
+    "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,
+  "title": "CodeSDD Parallel FEAT Automation Plan",
+  "description": "Machine-readable execution plan for safe parallel FEAT waves, quality gates, and commit boundaries."
+}

package/schemas/sdd/parallel-feat-automation-request.schema.json

@@ -0,0 +1,109 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "schema_version": {
+      "default": 1,
+      "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))$"
+    },
+    "max_agents": {
+      "default": 5,
+      "type": "integer",
+      "minimum": 1,
+      "maximum": 10
+    },
+    "require_clean_worktree": {
+      "default": true,
+      "type": "boolean"
+    },
+    "require_commit_per_feature": {
+      "default": true,
+      "type": "boolean"
+    },
+    "require_finalize_before_commit": {
+      "default": true,
+      "type": "boolean"
+    },
+    "agent_provider": {
+      "type": "string",
+      "enum": [
+        "codex",
+        "opencode",
+        "claude-code",
+        "cloudcode",
+        "deepagents",
+        "fake"
+      ]
+    },
+    "features": {
+      "default": [],
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "feature_ref": {
+            "type": "string",
+            "pattern": "^FEAT-\\d{4}$"
+          },
+          "title": {
+            "type": "string",
+            "minLength": 3
+          },
+          "recommended_skills": {
+            "default": [],
+            "type": "array",
+            "items": {
+              "type": "string",
+              "minLength": 1
+            }
+          },
+          "lock_domains": {
+            "default": [],
+            "type": "array",
+            "items": {
+              "type": "string",
+              "minLength": 1
+            }
+          }
+        },
+        "required": [
+          "feature_ref",
+          "title",
+          "recommended_skills",
+          "lock_domains"
+        ],
+        "additionalProperties": false
+      }
+    },
+    "waves": {
+      "default": [],
+      "type": "array",
+      "items": {
+        "minItems": 1,
+        "type": "array",
+        "items": {
+          "type": "string",
+          "pattern": "^FEAT-\\d{4}$"
+        }
+      }
+    }
+  },
+  "required": [
+    "schema_version",
+    "max_agents",
+    "require_clean_worktree",
+    "require_commit_per_feature",
+    "require_finalize_before_commit",
+    "features",
+    "waves"
+  ],
+  "additionalProperties": false,
+  "title": "CodeSDD Parallel FEAT Automation Request",
+  "description": "Machine-readable input contract for planning safe parallel FEAT execution waves."
+}

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

@@ -0,0 +1,116 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "schema_version": {
+      "default": 1,
+      "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))$"
+    },
+    "max_agents": {
+      "default": 5,
+      "type": "integer",
+      "minimum": 1,
+      "maximum": 10
+    },
+    "require_clean_worktree": {
+      "default": true,
+      "type": "boolean"
+    },
+    "require_commit_per_feature": {
+      "default": true,
+      "type": "boolean"
+    },
+    "require_finalize_before_commit": {
+      "default": true,
+      "type": "boolean"
+    },
+    "agent_provider": {
+      "type": "string",
+      "enum": [
+        "codex",
+        "opencode",
+        "claude-code",
+        "cloudcode",
+        "deepagents",
+        "fake"
+      ]
+    },
+    "features": {
+      "default": [],
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "feature_ref": {
+            "type": "string",
+            "pattern": "^FEAT-\\d{4}$"
+          },
+          "title": {
+            "type": "string",
+            "minLength": 3
+          },
+          "recommended_skills": {
+            "default": [],
+            "type": "array",
+            "items": {
+              "type": "string",
+              "minLength": 1
+            }
+          },
+          "lock_domains": {
+            "default": [],
+            "type": "array",
+            "items": {
+              "type": "string",
+              "minLength": 1
+            }
+          },
+          "blocked_by": {
+            "default": [],
+            "type": "array",
+            "items": {
+              "type": "string",
+              "pattern": "^FEAT-\\d{4}$"
+            }
+          },
+          "status": {
+            "default": "READY",
+            "type": "string",
+            "enum": [
+              "READY",
+              "IN_PROGRESS",
+              "BLOCKED",
+              "DONE"
+            ]
+          }
+        },
+        "required": [
+          "feature_ref",
+          "title",
+          "recommended_skills",
+          "lock_domains",
+          "blocked_by",
+          "status"
+        ],
+        "additionalProperties": false
+      }
+    }
+  },
+  "required": [
+    "schema_version",
+    "max_agents",
+    "require_clean_worktree",
+    "require_commit_per_feature",
+    "require_finalize_before_commit",
+    "features"
+  ],
+  "additionalProperties": false,
+  "title": "CodeSDD Parallel FEAT Scheduler Request",
+  "description": "Machine-readable input contract for dependency-aware chained FEAT wave scheduling."
+}