agentic-orchestrator 0.1.0

package/agentic/orchestrator/schemas/policy.schema.json

@@ -0,0 +1,227 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://example.local/agentic/policy.schema.json",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "version",
+    "commit_policy",
+    "patch_policy",
+    "locks",
+    "protected_areas",
+    "required_modes",
+    "required_merge_mode",
+    "collision_policy",
+    "config_precedence",
+    "path_rules",
+    "execution",
+    "implementation",
+    "testing",
+    "merge_policy",
+    "worktree",
+    "rbac"
+  ],
+  "properties": {
+    "version": { "type": "number" },
+    "commit_policy": {
+      "type": "object",
+      "required": ["allow_commit", "allow_merge"],
+      "properties": {
+        "allow_commit": { "type": "boolean" },
+        "allow_merge": { "type": "boolean" }
+      }
+    },
+    "patch_policy": {
+      "type": "object",
+      "required": ["enforce_plan", "enforce_allowed_areas"],
+      "properties": {
+        "enforce_plan": { "type": "boolean" },
+        "enforce_allowed_areas": { "type": "boolean" }
+      }
+    },
+    "locks": {
+      "type": "object",
+      "required": [
+        "resources",
+        "contract_to_resource",
+        "lease_ttl_seconds",
+        "acquire_behavior",
+        "default_wait_timeout_seconds",
+        "acquire_backoff"
+      ],
+      "properties": {
+        "resources": {
+          "type": "array",
+          "items": { "type": "string", "minLength": 1 }
+        },
+        "contract_to_resource": {
+          "type": "object",
+          "required": ["openapi", "events", "db"],
+          "properties": {
+            "openapi": { "type": "string" },
+            "events": { "type": "string" },
+            "db": { "type": "string" }
+          }
+        },
+        "lease_ttl_seconds": { "type": "number", "minimum": 1 },
+        "acquire_behavior": { "type": "string", "enum": ["wait", "fail"] },
+        "default_wait_timeout_seconds": { "type": "number", "minimum": 1 },
+        "acquire_backoff": {
+          "type": "object",
+          "required": ["initial_ms", "max_ms", "multiplier", "jitter_ms"],
+          "properties": {
+            "initial_ms": { "type": "number", "minimum": 1 },
+            "max_ms": { "type": "number", "minimum": 1 },
+            "multiplier": { "type": "number", "minimum": 1 },
+            "jitter_ms": { "type": "number", "minimum": 0 }
+          }
+        }
+      }
+    },
+    "protected_areas": {
+      "type": "array",
+      "items": { "type": "string" }
+    },
+    "exclusive_areas": {
+      "type": "array",
+      "items": { "type": "string" }
+    },
+    "required_modes": {
+      "type": "array",
+      "items": { "type": "string" },
+      "minItems": 1
+    },
+    "required_merge_mode": {
+      "type": "string"
+    },
+    "collision_policy": {
+      "type": "string",
+      "enum": ["reject", "block"]
+    },
+    "config_precedence": {
+      "type": "object"
+    },
+    "path_rules": {
+      "type": "object",
+      "required": ["matching", "normalize_paths", "allow_symlink_traversal"],
+      "properties": {
+        "matching": { "type": "string", "enum": ["repo_prefix", "glob"] },
+        "normalize_paths": { "type": "boolean", "const": true },
+        "allow_symlink_traversal": { "type": "boolean" }
+      }
+    },
+    "execution": {
+      "type": "object",
+      "required": ["default_step_timeout_seconds", "retry_policy", "env_allowlist"],
+      "properties": {
+        "default_step_timeout_seconds": { "type": "number", "minimum": 1 },
+        "retry_policy": {
+          "type": "object",
+          "required": ["transient_max_retries", "transient_error_codes", "non_retryable_error_codes"],
+          "properties": {
+            "transient_max_retries": { "type": "number", "minimum": 0 },
+            "transient_error_codes": {
+              "type": "array",
+              "items": { "type": "number" }
+            },
+            "non_retryable_error_codes": {
+              "type": "array",
+              "items": { "type": "number" }
+            }
+          }
+        },
+        "env_allowlist": {
+          "type": "array",
+          "items": { "type": "string" }
+        }
+      }
+    },
+    "implementation": {
+      "type": "object",
+      "required": ["workspace"],
+      "properties": {
+        "workspace": { "type": "string", "const": "nx" }
+      }
+    },
+    "testing": {
+      "type": "object",
+      "required": ["framework", "coverage"],
+      "properties": {
+        "framework": { "type": "string", "const": "vitest" },
+        "coverage": {
+          "type": "object",
+          "required": ["minimums", "targets"],
+          "properties": {
+            "minimums": {
+              "type": "object",
+              "required": ["line", "branch"],
+              "properties": {
+                "line": { "type": "number", "minimum": 0, "maximum": 1 },
+                "branch": { "type": "number", "minimum": 0, "maximum": 1 }
+              }
+            },
+            "targets": {
+              "type": "object",
+              "required": ["line", "branch"],
+              "properties": {
+                "line": { "type": "number", "minimum": 0, "maximum": 1 },
+                "branch": { "type": "number", "minimum": 0, "maximum": 1 }
+              }
+            }
+          }
+        }
+      }
+    },
+    "merge_policy": {
+      "type": "object",
+      "required": ["require_user_approval", "allowed_strategies"],
+      "properties": {
+        "require_user_approval": { "type": "boolean" },
+        "allowed_strategies": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "enum": ["merge_commit", "squash", "rebase"]
+          }
+        }
+      }
+    },
+    "worktree": {
+      "type": "object",
+      "required": ["base_branch"],
+      "properties": {
+        "base_branch": { "type": "string", "minLength": 1 }
+      }
+    },
+    "rbac": {
+      "type": "object",
+      "additionalProperties": {
+        "type": "array",
+        "items": { "type": "string" }
+      }
+    },
+    "recovery": {
+      "type": "object",
+      "properties": {
+        "orchestrator_session_reattach_timeout_ms": {
+          "type": "number",
+          "minimum": 0
+        },
+        "orphan_session_cleanup_enabled": {
+          "type": "boolean"
+        }
+      }
+    },
+    "supervisor": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "max_iterations_per_phase": {
+          "type": "integer",
+          "minimum": 0,
+          "default": 6
+        }
+      }
+    }
+  }
+}

package/agentic/orchestrator/schemas/qa_test_index.schema.json

@@ -0,0 +1,53 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://example.local/agentic/qa_test_index.schema.json",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["feature_id", "version", "source_diff_ref", "items"],
+  "properties": {
+    "feature_id": { "type": "string" },
+    "version": { "type": "integer", "minimum": 1 },
+    "source_diff_ref": { "type": "string" },
+    "items": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["path", "hunks", "required_tests", "status"],
+        "properties": {
+          "path": { "type": "string" },
+          "hunks": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "required": ["start_line", "end_line", "change_type"],
+              "properties": {
+                "start_line": { "type": "integer", "minimum": 1 },
+                "end_line": { "type": "integer", "minimum": 1 },
+                "change_type": {
+                  "type": "string",
+                  "enum": ["add", "modify", "delete"]
+                }
+              }
+            }
+          },
+          "required_tests": {
+            "type": "array",
+            "items": { "type": "string" }
+          },
+          "status": {
+            "type": "string",
+            "enum": ["pending", "running", "passed", "failed", "waived"]
+          },
+          "last_run_at": {
+            "type": "string",
+            "format": "date-time"
+          },
+          "evidence_refs": {
+            "type": "array",
+            "items": { "type": "string" }
+          }
+        }
+      }
+    }
+  }
+}

package/agentic/orchestrator/schemas/state.schema.json

@@ -0,0 +1,92 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://example.local/agentic/state.schema.json",
+  "type": "object",
+  "additionalProperties": true,
+  "required": [
+    "feature_id",
+    "version",
+    "branch",
+    "worktree_path",
+    "status",
+    "gate_profile",
+    "gates",
+    "locks",
+    "collisions",
+    "cluster",
+    "role_status",
+    "last_updated"
+  ],
+  "properties": {
+    "feature_id": { "type": "string" },
+    "version": { "type": "integer", "minimum": 1 },
+    "branch": { "type": "string" },
+    "worktree_path": { "type": "string" },
+    "status": {
+      "type": "string",
+      "enum": ["planning", "building", "qa", "blocked", "ready_to_merge", "merged", "failed"]
+    },
+    "gate_profile": { "type": "string" },
+    "gates": {
+      "type": "object",
+      "additionalProperties": {
+        "type": "string",
+        "enum": ["pass", "fail", "na"]
+      }
+    },
+    "locks": {
+      "type": "object",
+      "required": ["held"],
+      "properties": {
+        "held": {
+          "type": "array",
+          "items": { "type": "string" }
+        }
+      }
+    },
+    "collisions": {
+      "type": "object",
+      "required": ["files", "areas", "contracts"],
+      "properties": {
+        "files": { "type": "array", "items": { "type": "object" } },
+        "areas": { "type": "array", "items": { "type": "object" } },
+        "contracts": { "type": "array", "items": { "type": "object" } }
+      }
+    },
+    "cluster": {
+      "type": "object",
+      "description": "Compatibility cluster snapshot. Active features must match index.runtime_sessions.orchestrator_session_id.",
+      "required": ["orchestrator_session_id", "planner_session_id", "builder_session_id", "qa_session_id"],
+      "properties": {
+        "orchestrator_session_id": { "type": "string" },
+        "planner_session_id": { "type": "string" },
+        "builder_session_id": { "type": "string" },
+        "qa_session_id": { "type": "string" }
+      }
+    },
+    "role_status": {
+      "type": "object",
+      "required": ["planner", "builder", "qa"],
+      "properties": {
+        "planner": {
+          "type": "string",
+          "enum": ["ready", "running", "blocked", "done"]
+        },
+        "builder": {
+          "type": "string",
+          "enum": ["ready", "running", "blocked", "done"]
+        },
+        "qa": {
+          "type": "string",
+          "enum": ["ready", "running", "blocked", "done"]
+        }
+      }
+    },
+    "last_updated": { "type": "string", "format": "date-time" },
+    "status_reason": { "type": "string" },
+    "evidence": {
+      "type": "object",
+      "additionalProperties": true
+    }
+  }
+}