agentic-orchestrator 0.1.0

package/agentic/orchestrator/tools/catalog.json

@@ -0,0 +1,399 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "version": 1,
+  "tools": [
+    {
+      "name": "feature.discover_specs",
+      "description": "Discover feature specification files.",
+      "input_schema_ref": "schemas/input/feature.discover_specs.input.schema.json",
+      "output_schema_ref": "schemas/output/feature.discover_specs.output.schema.json",
+      "supported_roles": [
+        "orchestrator",
+        "planner",
+        "builder",
+        "qa",
+        "system"
+      ],
+      "handler_id": "feature.discover_specs",
+      "mutating": false,
+      "requires_operation_id": false
+    },
+    {
+      "name": "feature.init",
+      "description": "Initialize feature state and worktree.",
+      "input_schema_ref": "schemas/input/feature.init.input.schema.json",
+      "output_schema_ref": "schemas/output/feature.init.output.schema.json",
+      "supported_roles": [
+        "orchestrator",
+        "system"
+      ],
+      "handler_id": "feature.init",
+      "mutating": true,
+      "requires_operation_id": true
+    },
+    {
+      "name": "feature.get_context",
+      "description": "Get feature context bundle including state and plan.",
+      "input_schema_ref": "schemas/input/feature.get_context.input.schema.json",
+      "output_schema_ref": "schemas/output/feature.get_context.output.schema.json",
+      "supported_roles": [
+        "orchestrator",
+        "planner",
+        "builder",
+        "qa",
+        "system"
+      ],
+      "handler_id": "feature.get_context",
+      "mutating": false,
+      "requires_operation_id": false
+    },
+    {
+      "name": "feature.state_get",
+      "description": "Read feature state.",
+      "input_schema_ref": "schemas/input/feature.state_get.input.schema.json",
+      "output_schema_ref": "schemas/output/feature.state_get.output.schema.json",
+      "supported_roles": [
+        "orchestrator",
+        "planner",
+        "builder",
+        "qa",
+        "system"
+      ],
+      "handler_id": "feature.state_get",
+      "mutating": false,
+      "requires_operation_id": false
+    },
+    {
+      "name": "feature.state_patch",
+      "description": "Patch feature state with optimistic concurrency.",
+      "input_schema_ref": "schemas/input/feature.state_patch.input.schema.json",
+      "output_schema_ref": "schemas/output/feature.state_patch.output.schema.json",
+      "supported_roles": [
+        "orchestrator",
+        "system"
+      ],
+      "handler_id": "feature.state_patch",
+      "mutating": true,
+      "requires_operation_id": true
+    },
+    {
+      "name": "feature.log_append",
+      "description": "Append structured feature decision log notes.",
+      "input_schema_ref": "schemas/input/feature.log_append.input.schema.json",
+      "output_schema_ref": "schemas/output/feature.log_append.output.schema.json",
+      "supported_roles": [
+        "orchestrator",
+        "system"
+      ],
+      "handler_id": "feature.log_append",
+      "mutating": true,
+      "requires_operation_id": true
+    },
+    {
+      "name": "plan.submit",
+      "description": "Submit initial feature plan.",
+      "input_schema_ref": "schemas/input/plan.submit.input.schema.json",
+      "output_schema_ref": "schemas/output/plan.submit.output.schema.json",
+      "supported_roles": [
+        "orchestrator",
+        "planner",
+        "system"
+      ],
+      "handler_id": "plan.submit",
+      "mutating": true,
+      "requires_operation_id": true
+    },
+    {
+      "name": "plan.get",
+      "description": "Read current feature plan.",
+      "input_schema_ref": "schemas/input/plan.get.input.schema.json",
+      "output_schema_ref": "schemas/output/plan.get.output.schema.json",
+      "supported_roles": [
+        "orchestrator",
+        "planner",
+        "system"
+      ],
+      "handler_id": "plan.get",
+      "mutating": false,
+      "requires_operation_id": false
+    },
+    {
+      "name": "plan.update",
+      "description": "Submit a revised plan version.",
+      "input_schema_ref": "schemas/input/plan.update.input.schema.json",
+      "output_schema_ref": "schemas/output/plan.update.output.schema.json",
+      "supported_roles": [
+        "orchestrator",
+        "planner",
+        "system"
+      ],
+      "handler_id": "plan.update",
+      "mutating": true,
+      "requires_operation_id": true
+    },
+    {
+      "name": "repo.ensure_worktree",
+      "description": "Ensure feature worktree exists.",
+      "input_schema_ref": "schemas/input/repo.ensure_worktree.input.schema.json",
+      "output_schema_ref": "schemas/output/repo.ensure_worktree.output.schema.json",
+      "supported_roles": [
+        "orchestrator",
+        "system"
+      ],
+      "handler_id": "repo.ensure_worktree",
+      "mutating": true,
+      "requires_operation_id": true
+    },
+    {
+      "name": "repo.apply_patch",
+      "description": "Apply diff patch to feature worktree.",
+      "input_schema_ref": "schemas/input/repo.apply_patch.input.schema.json",
+      "output_schema_ref": "schemas/output/repo.apply_patch.output.schema.json",
+      "supported_roles": [
+        "orchestrator",
+        "builder",
+        "qa",
+        "system"
+      ],
+      "handler_id": "repo.apply_patch",
+      "mutating": true,
+      "requires_operation_id": true
+    },
+    {
+      "name": "repo.status",
+      "description": "Read git status for feature worktree.",
+      "input_schema_ref": "schemas/input/repo.status.input.schema.json",
+      "output_schema_ref": "schemas/output/repo.status.output.schema.json",
+      "supported_roles": [
+        "orchestrator",
+        "builder",
+        "system"
+      ],
+      "handler_id": "repo.status",
+      "mutating": false,
+      "requires_operation_id": false
+    },
+    {
+      "name": "repo.diff",
+      "description": "Read git diff for feature worktree.",
+      "input_schema_ref": "schemas/input/repo.diff.input.schema.json",
+      "output_schema_ref": "schemas/output/repo.diff.output.schema.json",
+      "supported_roles": [
+        "orchestrator",
+        "builder",
+        "qa",
+        "system"
+      ],
+      "handler_id": "repo.diff",
+      "mutating": false,
+      "requires_operation_id": false
+    },
+    {
+      "name": "repo.read_file",
+      "description": "Read file from feature worktree.",
+      "input_schema_ref": "schemas/input/repo.read_file.input.schema.json",
+      "output_schema_ref": "schemas/output/repo.read_file.output.schema.json",
+      "supported_roles": [
+        "orchestrator",
+        "planner",
+        "builder",
+        "qa",
+        "system"
+      ],
+      "handler_id": "repo.read_file",
+      "mutating": false,
+      "requires_operation_id": false
+    },
+    {
+      "name": "repo.search",
+      "description": "Search feature worktree content.",
+      "input_schema_ref": "schemas/input/repo.search.input.schema.json",
+      "output_schema_ref": "schemas/output/repo.search.output.schema.json",
+      "supported_roles": [
+        "orchestrator",
+        "planner",
+        "builder",
+        "qa",
+        "system"
+      ],
+      "handler_id": "repo.search",
+      "mutating": false,
+      "requires_operation_id": false
+    },
+    {
+      "name": "repo.diff_bundle",
+      "description": "Read complete diff bundle and latest evidence.",
+      "input_schema_ref": "schemas/input/repo.diff_bundle.input.schema.json",
+      "output_schema_ref": "schemas/output/repo.diff_bundle.output.schema.json",
+      "supported_roles": [
+        "orchestrator",
+        "system"
+      ],
+      "handler_id": "repo.diff_bundle",
+      "mutating": false,
+      "requires_operation_id": false
+    },
+    {
+      "name": "feature.ready_to_merge",
+      "description": "Validate and merge a feature branch.",
+      "input_schema_ref": "schemas/input/feature.ready_to_merge.input.schema.json",
+      "output_schema_ref": "schemas/output/feature.ready_to_merge.output.schema.json",
+      "supported_roles": [
+        "orchestrator",
+        "system"
+      ],
+      "handler_id": "feature.ready_to_merge",
+      "mutating": true,
+      "requires_operation_id": true
+    },
+    {
+      "name": "feature.delete",
+      "description": "Delete feature runtime artifacts and optional git state.",
+      "input_schema_ref": "schemas/input/feature.delete.input.schema.json",
+      "output_schema_ref": "schemas/output/feature.delete.output.schema.json",
+      "supported_roles": [
+        "orchestrator",
+        "system"
+      ],
+      "handler_id": "feature.delete",
+      "mutating": true,
+      "requires_operation_id": true
+    },
+    {
+      "name": "gates.list",
+      "description": "List available gate profiles.",
+      "input_schema_ref": "schemas/input/gates.list.input.schema.json",
+      "output_schema_ref": "schemas/output/gates.list.output.schema.json",
+      "supported_roles": [
+        "orchestrator",
+        "system"
+      ],
+      "handler_id": "gates.list",
+      "mutating": false,
+      "requires_operation_id": false
+    },
+    {
+      "name": "gates.run",
+      "description": "Run configured feature gates.",
+      "input_schema_ref": "schemas/input/gates.run.input.schema.json",
+      "output_schema_ref": "schemas/output/gates.run.output.schema.json",
+      "supported_roles": [
+        "orchestrator",
+        "builder",
+        "qa",
+        "system"
+      ],
+      "handler_id": "gates.run",
+      "mutating": true,
+      "requires_operation_id": true
+    },
+    {
+      "name": "evidence.latest",
+      "description": "Read latest gate evidence.",
+      "input_schema_ref": "schemas/input/evidence.latest.input.schema.json",
+      "output_schema_ref": "schemas/output/evidence.latest.output.schema.json",
+      "supported_roles": [
+        "orchestrator",
+        "qa",
+        "system"
+      ],
+      "handler_id": "evidence.latest",
+      "mutating": false,
+      "requires_operation_id": false
+    },
+    {
+      "name": "qa.test_index_get",
+      "description": "Read QA test index.",
+      "input_schema_ref": "schemas/input/qa.test_index_get.input.schema.json",
+      "output_schema_ref": "schemas/output/qa.test_index_get.output.schema.json",
+      "supported_roles": [
+        "orchestrator",
+        "qa",
+        "system"
+      ],
+      "handler_id": "qa.test_index_get",
+      "mutating": false,
+      "requires_operation_id": false
+    },
+    {
+      "name": "qa.test_index_update",
+      "description": "Update QA test index.",
+      "input_schema_ref": "schemas/input/qa.test_index_update.input.schema.json",
+      "output_schema_ref": "schemas/output/qa.test_index_update.output.schema.json",
+      "supported_roles": [
+        "orchestrator",
+        "qa",
+        "system"
+      ],
+      "handler_id": "qa.test_index_update",
+      "mutating": true,
+      "requires_operation_id": true
+    },
+    {
+      "name": "locks.acquire",
+      "description": "Acquire lock lease for resource.",
+      "input_schema_ref": "schemas/input/locks.acquire.input.schema.json",
+      "output_schema_ref": "schemas/output/locks.acquire.output.schema.json",
+      "supported_roles": [
+        "orchestrator",
+        "system"
+      ],
+      "handler_id": "locks.acquire",
+      "mutating": true,
+      "requires_operation_id": true
+    },
+    {
+      "name": "locks.release",
+      "description": "Release lock lease for resource.",
+      "input_schema_ref": "schemas/input/locks.release.input.schema.json",
+      "output_schema_ref": "schemas/output/locks.release.output.schema.json",
+      "supported_roles": [
+        "orchestrator",
+        "system"
+      ],
+      "handler_id": "locks.release",
+      "mutating": true,
+      "requires_operation_id": true
+    },
+    {
+      "name": "collisions.scan",
+      "description": "Compute collision matrix across accepted plans.",
+      "input_schema_ref": "schemas/input/collisions.scan.input.schema.json",
+      "output_schema_ref": "schemas/output/collisions.scan.output.schema.json",
+      "supported_roles": [
+        "orchestrator",
+        "planner",
+        "system"
+      ],
+      "handler_id": "collisions.scan",
+      "mutating": false,
+      "requires_operation_id": false
+    },
+    {
+      "name": "report.dashboard",
+      "description": "Read orchestrator dashboard summary.",
+      "input_schema_ref": "schemas/input/report.dashboard.input.schema.json",
+      "output_schema_ref": "schemas/output/report.dashboard.output.schema.json",
+      "supported_roles": [
+        "orchestrator",
+        "system"
+      ],
+      "handler_id": "report.dashboard",
+      "mutating": false,
+      "requires_operation_id": false
+    },
+    {
+      "name": "report.feature_summary",
+      "description": "Read summarized feature report.",
+      "input_schema_ref": "schemas/input/report.feature_summary.input.schema.json",
+      "output_schema_ref": "schemas/output/report.feature_summary.output.schema.json",
+      "supported_roles": [
+        "orchestrator",
+        "system"
+      ],
+      "handler_id": "report.feature_summary",
+      "mutating": false,
+      "requires_operation_id": false
+    }
+  ]
+}

package/agentic/orchestrator/tools/errors.schema.json

@@ -0,0 +1,21 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://example.local/agentic/tools/errors.schema.json",
+  "type": "object",
+  "required": ["ok", "error"],
+  "properties": {
+    "ok": { "type": "boolean", "const": false },
+    "error": {
+      "type": "object",
+      "required": ["code", "message", "details"],
+      "properties": {
+        "code": { "type": "string", "minLength": 1 },
+        "message": { "type": "string", "minLength": 1 },
+        "details": {}
+      },
+      "additionalProperties": true
+    },
+    "evidence": {}
+  },
+  "additionalProperties": true
+}

package/agentic/orchestrator/tools/protocol.json

@@ -0,0 +1,8 @@
+{
+  "mcp_protocol_version": "2025-11-05",
+  "sdk": {
+    "package": "@modelcontextprotocol/sdk",
+    "version": "1.18.0"
+  },
+  "enabled_transports": ["stdio", "inprocess"]
+}

package/agentic/orchestrator/tools/schemas/input/collisions.scan.input.schema.json

@@ -0,0 +1,7 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://example.local/agentic/tools/schemas/input/collisions.scan.input.schema.json",
+  "type": "object",
+  "properties": {},
+  "additionalProperties": false
+}

package/agentic/orchestrator/tools/schemas/input/evidence.latest.input.schema.json

@@ -0,0 +1,15 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://example.local/agentic/tools/schemas/input/evidence.latest.input.schema.json",
+  "type": "object",
+  "required": [
+    "feature_id"
+  ],
+  "properties": {
+    "feature_id": {
+      "type": "string",
+      "minLength": 1
+    }
+  },
+  "additionalProperties": false
+}

package/agentic/orchestrator/tools/schemas/input/feature.delete.input.schema.json

@@ -0,0 +1,42 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://example.local/agentic/tools/schemas/input/feature.delete.input.schema.json",
+  "type": "object",
+  "required": [
+    "operation_id",
+    "feature_id",
+    "dry_run",
+    "confirm",
+    "remove_worktree",
+    "remove_branch"
+  ],
+  "properties": {
+    "operation_id": {
+      "type": "string",
+      "minLength": 8,
+      "maxLength": 256
+    },
+    "feature_id": {
+      "type": "string",
+      "pattern": "^[a-z0-9_][a-z0-9_-]*$"
+    },
+    "dry_run": {
+      "type": "boolean"
+    },
+    "confirm": {
+      "type": "boolean"
+    },
+    "remove_worktree": {
+      "type": "boolean"
+    },
+    "remove_branch": {
+      "type": "string",
+      "enum": [
+        "none",
+        "safe",
+        "force"
+      ]
+    }
+  },
+  "additionalProperties": false
+}

package/agentic/orchestrator/tools/schemas/input/feature.discover_specs.input.schema.json

@@ -0,0 +1,7 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://example.local/agentic/tools/schemas/input/feature.discover_specs.input.schema.json",
+  "type": "object",
+  "properties": {},
+  "additionalProperties": false
+}

package/agentic/orchestrator/tools/schemas/input/feature.get_context.input.schema.json

@@ -0,0 +1,15 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://example.local/agentic/tools/schemas/input/feature.get_context.input.schema.json",
+  "type": "object",
+  "required": [
+    "feature_id"
+  ],
+  "properties": {
+    "feature_id": {
+      "type": "string",
+      "minLength": 1
+    }
+  },
+  "additionalProperties": false
+}

package/agentic/orchestrator/tools/schemas/input/feature.init.input.schema.json

@@ -0,0 +1,21 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://example.local/agentic/tools/schemas/input/feature.init.input.schema.json",
+  "type": "object",
+  "required": [
+    "operation_id",
+    "feature_id"
+  ],
+  "properties": {
+    "operation_id": {
+      "type": "string",
+      "minLength": 8,
+      "maxLength": 256
+    },
+    "feature_id": {
+      "type": "string",
+      "minLength": 1
+    }
+  },
+  "additionalProperties": false
+}

package/agentic/orchestrator/tools/schemas/input/feature.log_append.input.schema.json

@@ -0,0 +1,26 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://example.local/agentic/tools/schemas/input/feature.log_append.input.schema.json",
+  "type": "object",
+  "required": [
+    "operation_id",
+    "feature_id",
+    "note"
+  ],
+  "properties": {
+    "operation_id": {
+      "type": "string",
+      "minLength": 8,
+      "maxLength": 256
+    },
+    "feature_id": {
+      "type": "string",
+      "minLength": 1
+    },
+    "note": {
+      "type": "string",
+      "minLength": 1
+    }
+  },
+  "additionalProperties": false
+}

package/agentic/orchestrator/tools/schemas/input/feature.ready_to_merge.input.schema.json

@@ -0,0 +1,34 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://example.local/agentic/tools/schemas/input/feature.ready_to_merge.input.schema.json",
+  "type": "object",
+  "required": [
+    "operation_id",
+    "feature_id",
+    "commit_message",
+    "merge_strategy"
+  ],
+  "properties": {
+    "operation_id": {
+      "type": "string",
+      "minLength": 8,
+      "maxLength": 256
+    },
+    "feature_id": {
+      "type": "string",
+      "minLength": 1
+    },
+    "commit_message": {
+      "type": "string",
+      "minLength": 1
+    },
+    "merge_strategy": {
+      "type": "string",
+      "minLength": 1
+    },
+    "user_approval_token": {
+      "type": "string"
+    }
+  },
+  "additionalProperties": false
+}

package/agentic/orchestrator/tools/schemas/input/feature.state_get.input.schema.json

@@ -0,0 +1,15 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://example.local/agentic/tools/schemas/input/feature.state_get.input.schema.json",
+  "type": "object",
+  "required": [
+    "feature_id"
+  ],
+  "properties": {
+    "feature_id": {
+      "type": "string",
+      "minLength": 1
+    }
+  },
+  "additionalProperties": false
+}

package/agentic/orchestrator/tools/schemas/input/feature.state_patch.input.schema.json

@@ -0,0 +1,28 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://example.local/agentic/tools/schemas/input/feature.state_patch.input.schema.json",
+  "type": "object",
+  "required": [
+    "operation_id",
+    "feature_id",
+    "patch"
+  ],
+  "properties": {
+    "operation_id": {
+      "type": "string",
+      "minLength": 8,
+      "maxLength": 256
+    },
+    "feature_id": {
+      "type": "string",
+      "minLength": 1
+    },
+    "expected_version": {
+      "type": "number"
+    },
+    "patch": {
+      "type": "object"
+    }
+  },
+  "additionalProperties": false
+}

package/agentic/orchestrator/tools/schemas/input/gates.list.input.schema.json

@@ -0,0 +1,11 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://example.local/agentic/tools/schemas/input/gates.list.input.schema.json",
+  "type": "object",
+  "properties": {
+    "profile": {
+      "type": "string"
+    }
+  },
+  "additionalProperties": false
+}