agentic-orchestrator 0.1.28 → 0.2.0

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

@@ -10,6 +10,7 @@
     "branch",
     "worktree_path",
     "status",
+    "intake",
     "gate_profile",
     "gates",
     "locks",
@@ -38,8 +39,62 @@
     },
     "status": {
       "type": "string",
-      "description": "Current lifecycle phase. planning \u2192 building \u2192 qa \u2192 ready_to_merge \u2192 merged. 'blocked' is a cross-cutting pause state; 'failed' is terminal.",
-      "enum": ["planning", "building", "qa", "blocked", "ready_to_merge", "merged", "failed"]
+      "description": "Current lifecycle phase. intake \u2192 planning \u2192 building \u2192 qa \u2192 ready_to_merge \u2192 merged. 'blocked' and 'awaiting_input' are cross-cutting pause states; 'failed' is terminal.",
+      "enum": [
+        "intake",
+        "planning",
+        "building",
+        "qa",
+        "blocked",
+        "awaiting_input",
+        "ready_to_merge",
+        "merged",
+        "failed"
+      ]
+    },
+    "intake": {
+      "type": "object",
+      "description": "Requirements-intake state tracked before execution planning begins.",
+      "required": [
+        "status",
+        "bootstrap_manifest_version",
+        "verified_manifest_version",
+        "open_ambiguity_count",
+        "last_verified_at",
+        "promotion_basis"
+      ],
+      "properties": {
+        "status": {
+          "type": "string",
+          "enum": ["not_started", "in_progress", "awaiting_input", "verified"]
+        },
+        "bootstrap_manifest_version": {
+          "type": ["integer", "null"],
+          "minimum": 1
+        },
+        "verified_manifest_version": {
+          "type": ["integer", "null"],
+          "minimum": 1
+        },
+        "open_ambiguity_count": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "last_verified_at": {
+          "type": ["string", "null"],
+          "format": "date-time"
+        },
+        "promotion_basis": {
+          "type": ["string", "null"],
+          "enum": [
+            "structured_spec",
+            "questions_resolved",
+            "policy_approved_auto_promotion",
+            "human_review_confirmed",
+            null
+          ]
+        }
+      }
     },
     "execution_mode": {
       "type": "string",
@@ -58,6 +113,46 @@
         "enum": ["pass", "fail", "na"]
       }
     },
+    "merge_repair": {
+      "type": "object",
+      "description": "Merge-gate repair loop state used when a ready_to_merge feature fails merge gating and is sent back through QA for repair.",
+      "required": ["attempts", "max_attempts", "active"],
+      "properties": {
+        "attempts": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "max_attempts": {
+          "type": "integer",
+          "minimum": 1
+        },
+        "active": {
+          "type": "boolean"
+        },
+        "requested_at": {
+          "type": ["string", "null"],
+          "format": "date-time"
+        },
+        "last_failed_at": {
+          "type": ["string", "null"],
+          "format": "date-time"
+        },
+        "last_gate_evidence_path": {
+          "type": ["string", "null"]
+        },
+        "last_failure_summary": {
+          "type": ["string", "null"]
+        },
+        "reviewer_message": {
+          "type": ["string", "null"]
+        },
+        "exhausted_at": {
+          "type": ["string", "null"],
+          "format": "date-time"
+        }
+      },
+      "additionalProperties": false
+    },
     "locks": {
       "type": "object",
       "description": "Lock resources currently held by this feature.",
@@ -125,6 +220,10 @@
         "qa_session_id": {
           "type": "string",
           "description": "AI session ID of the QA agent for this feature."
+        },
+        "reconciler_session_id": {
+          "type": "string",
+          "description": "Shared AI session ID of the reconciler agent for this run. Present when the feature needs mainline-divergence repair routing."
         }
       }
     },
@@ -150,6 +249,38 @@
         }
       }
     },
+    "run_history": {
+      "type": "array",
+      "description": "Time-sorted list of run IDs associated with this feature (newest first). Updated by supervisor on run start/end.",
+      "default": [],
+      "items": {
+        "type": "object",
+        "required": ["run_id", "started_at"],
+        "additionalProperties": false,
+        "properties": {
+          "run_id": {
+            "type": "string",
+            "pattern": "^run:[a-f0-9-]+$",
+            "description": "Run ID from runtime_sessions."
+          },
+          "started_at": {
+            "type": "string",
+            "format": "date-time",
+            "description": "When this run started working on this feature."
+          },
+          "ended_at": {
+            "type": ["string", "null"],
+            "format": "date-time",
+            "description": "When this run stopped working on this feature (null if still active)."
+          },
+          "status": {
+            "type": "string",
+            "enum": ["active", "completed", "failed", "timeout", "interrupted"],
+            "description": "Final status of this run for this feature."
+          }
+        }
+      }
+    },
     "checkpoints": {
       "type": "array",
       "description": "Checkpoint history captured during interactive execution mode. Each item records the diff snapshot, validation status, and any violations.",
@@ -194,10 +325,86 @@
           "diff_snapshot": {
             "type": "string",
             "description": "Repository-relative path to the stored checkpoint diff artifact."
+          },
+          "diff_hash": {
+            "type": "string",
+            "description": "SHA-256 of the checkpoint diff snapshot, used to detect duplicate or stale worktree state across resumes."
+          },
+          "duplicate_of_checkpoint_id": {
+            "type": "string",
+            "description": "Optional pointer to the previous checkpoint when this snapshot captured identical diff content."
+          },
+          "net_new_worktree_change": {
+            "type": "boolean",
+            "description": "Whether this checkpoint represents net-new worktree content relative to the watchdog baseline/previous checkpoint."
+          },
+          "head_sha": {
+            "type": "string",
+            "description": "Git HEAD commit SHA of the worktree at the time the checkpoint was captured."
+          },
+          "workspace_fingerprint": {
+            "type": "string",
+            "description": "Combined hash of head_sha and diff_hash used to detect workspace state changes across checkpoints."
           }
         }
       }
     },
+    "human_input": {
+      "type": "object",
+      "description": "Deterministic question lifecycle summary for the feature.",
+      "required": [
+        "open_question_id",
+        "open_question_count",
+        "awaiting_since",
+        "requested_by_role",
+        "resume_status"
+      ],
+      "properties": {
+        "open_question_id": {
+          "type": ["string", "null"]
+        },
+        "open_question_count": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "awaiting_since": {
+          "type": ["string", "null"],
+          "format": "date-time"
+        },
+        "requested_by_role": {
+          "type": ["string", "null"]
+        },
+        "prompt_summary": {
+          "type": ["string", "null"]
+        },
+        "resume_status": {
+          "type": ["string", "null"],
+          "enum": [
+            "intake",
+            "planning",
+            "building",
+            "qa",
+            "blocked",
+            "ready_to_merge",
+            "awaiting_input",
+            "merged",
+            "failed",
+            null
+          ]
+        }
+      }
+    },
+    "context_request_count": {
+      "type": "integer",
+      "minimum": 0
+    },
+    "last_context_request_at": {
+      "type": ["string", "null"],
+      "format": "date-time"
+    },
+    "last_context_request_role": {
+      "type": ["string", "null"]
+    },
     "pr": {
       "type": "object",
       "description": "Pull request metadata populated by the PR monitor service when a PR exists for this feature.",
@@ -255,6 +462,11 @@
       "format": "date-time",
       "description": "ISO 8601 timestamp of the most recent state write. Set automatically by FeatureStateService on every update."
     },
+    "phase_entered_at": {
+      "type": "string",
+      "format": "date-time",
+      "description": "ISO 8601 timestamp of when the feature last entered its current status/phase. Set automatically by FeatureStateService on every status transition."
+    },
     "status_reason": {
       "type": "string",
       "description": "Human-readable explanation of the current status. Set on error, blocked, and merge transitions (e.g. 'Gate mode full failed')."
@@ -263,6 +475,89 @@
       "type": "object",
       "additionalProperties": true,
       "description": "Freeform key-value evidence bag. Gate runs write last_gate_mode, last_gate_evidence_path, and coverage_status here; merge writes merge_sha, merge_strategy, and merge_at."
+    },
+    "run_history": {
+      "type": "array",
+      "description": "Time-sorted list of run IDs associated with this feature (newest first). Updated by supervisor on run start/end.",
+      "default": [],
+      "items": {
+        "type": "object",
+        "required": ["run_id", "started_at"],
+        "additionalProperties": false,
+        "properties": {
+          "run_id": {
+            "type": "string",
+            "pattern": "^run:[a-f0-9-]+$",
+            "description": "Run ID from runtime_sessions"
+          },
+          "started_at": {
+            "type": "string",
+            "format": "date-time",
+            "description": "When this run started working on this feature"
+          },
+          "ended_at": {
+            "type": ["string", "null"],
+            "format": "date-time",
+            "description": "When this run stopped working on this feature (null if still active)"
+          },
+          "status": {
+            "type": "string",
+            "enum": ["active", "completed", "failed", "timeout"],
+            "description": "Final status of this run for this feature"
+          }
+        }
+      }
+    }
+  },
+  "allOf": [
+    {
+      "if": {
+        "properties": {
+          "feature_id": {
+            "not": {
+              "const": "global"
+            }
+          },
+          "status": {
+            "enum": ["planning", "building", "qa", "ready_to_merge", "merged"]
+          }
+        },
+        "required": ["feature_id", "status"]
+      },
+      "then": {
+        "properties": {
+          "intake": {
+            "properties": {
+              "status": {
+                "const": "verified"
+              },
+              "verified_manifest_version": {
+                "type": "integer",
+                "minimum": 1
+              },
+              "last_verified_at": {
+                "type": "string",
+                "format": "date-time"
+              },
+              "promotion_basis": {
+                "type": "string",
+                "enum": [
+                  "structured_spec",
+                  "questions_resolved",
+                  "policy_approved_auto_promotion",
+                  "human_review_confirmed"
+                ]
+              }
+            },
+            "required": [
+              "status",
+              "verified_manifest_version",
+              "last_verified_at",
+              "promotion_basis"
+            ]
+          }
+        }
+      }
     }
-  }
+  ]
 }

package/agentic/orchestrator/tools/catalog.json

@@ -7,7 +7,7 @@
       "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"],
+      "supported_roles": ["orchestrator", "planner", "builder", "qa", "reconciler", "system"],
       "handler_id": "feature.discover_specs",
       "mutating": false,
       "requires_operation_id": false
@@ -27,17 +27,27 @@
       "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"],
+      "supported_roles": ["orchestrator", "planner", "builder", "qa", "reconciler", "system"],
       "handler_id": "feature.get_context",
       "mutating": false,
       "requires_operation_id": false
     },
+    {
+      "name": "feature.intake_submit",
+      "description": "Persist a verified intake manifest and promote the feature into execution planning.",
+      "input_schema_ref": "schemas/input/feature.intake_submit.input.schema.json",
+      "output_schema_ref": "schemas/output/feature.intake_submit.output.schema.json",
+      "supported_roles": ["orchestrator", "planner", "system"],
+      "handler_id": "feature.intake_submit",
+      "mutating": true,
+      "requires_operation_id": true
+    },
     {
       "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"],
+      "supported_roles": ["orchestrator", "planner", "builder", "qa", "reconciler", "system"],
       "handler_id": "feature.state_get",
       "mutating": false,
       "requires_operation_id": false
@@ -47,7 +57,7 @@
       "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"],
+      "supported_roles": ["orchestrator", "reconciler", "system"],
       "handler_id": "feature.state_patch",
       "mutating": true,
       "requires_operation_id": true
@@ -57,7 +67,7 @@
       "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"],
+      "supported_roles": ["orchestrator", "reconciler", "system"],
       "handler_id": "feature.log_append",
       "mutating": true,
       "requires_operation_id": true
@@ -67,7 +77,7 @@
       "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"],
+      "supported_roles": ["orchestrator", "planner", "reconciler", "system"],
       "handler_id": "plan.submit",
       "mutating": true,
       "requires_operation_id": true
@@ -77,7 +87,7 @@
       "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"],
+      "supported_roles": ["orchestrator", "planner", "reconciler", "system"],
       "handler_id": "plan.get",
       "mutating": false,
       "requires_operation_id": false
@@ -87,7 +97,7 @@
       "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"],
+      "supported_roles": ["orchestrator", "planner", "reconciler", "system"],
       "handler_id": "plan.update",
       "mutating": true,
       "requires_operation_id": true
@@ -107,7 +117,7 @@
       "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"],
+      "supported_roles": ["orchestrator", "builder", "qa", "reconciler", "system"],
       "handler_id": "repo.apply_patch",
       "mutating": true,
       "requires_operation_id": true
@@ -117,7 +127,7 @@
       "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"],
+      "supported_roles": ["orchestrator", "builder", "reconciler", "system"],
       "handler_id": "repo.status",
       "mutating": false,
       "requires_operation_id": false
@@ -127,7 +137,7 @@
       "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"],
+      "supported_roles": ["orchestrator", "builder", "qa", "reconciler", "system"],
       "handler_id": "repo.diff",
       "mutating": false,
       "requires_operation_id": false
@@ -137,7 +147,7 @@
       "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"],
+      "supported_roles": ["orchestrator", "planner", "builder", "qa", "reconciler", "system"],
       "handler_id": "repo.read_file",
       "mutating": false,
       "requires_operation_id": false
@@ -147,7 +157,7 @@
       "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"],
+      "supported_roles": ["orchestrator", "planner", "builder", "qa", "reconciler", "system"],
       "handler_id": "repo.search",
       "mutating": false,
       "requires_operation_id": false
@@ -162,6 +172,46 @@
       "mutating": false,
       "requires_operation_id": false
     },
+    {
+      "name": "repo.reconcile_mainline",
+      "description": "Reconcile a feature worktree against the base branch or detect divergence only.",
+      "input_schema_ref": "schemas/input/repo.reconcile_mainline.input.schema.json",
+      "output_schema_ref": "schemas/output/repo.reconcile_mainline.output.schema.json",
+      "supported_roles": ["orchestrator", "system"],
+      "handler_id": "repo.reconcile_mainline",
+      "mutating": true,
+      "requires_operation_id": true
+    },
+    {
+      "name": "repo.conflict_files",
+      "description": "List conflicting files with ours/theirs content for a feature with an active mainline divergence conflict.",
+      "input_schema_ref": "schemas/input/repo.conflict_files.input.schema.json",
+      "output_schema_ref": "schemas/output/repo.conflict_files.output.schema.json",
+      "supported_roles": ["orchestrator", "system"],
+      "handler_id": "repo.conflict_files",
+      "mutating": false,
+      "requires_operation_id": true
+    },
+    {
+      "name": "repo.resolve_conflict",
+      "description": "Accept resolution for specific conflicting files using a per-file strategy (accept_ours, accept_theirs, or manual with provided content).",
+      "input_schema_ref": "schemas/input/repo.resolve_conflict.input.schema.json",
+      "output_schema_ref": "schemas/output/repo.resolve_conflict.output.schema.json",
+      "supported_roles": ["orchestrator", "system"],
+      "handler_id": "repo.resolve_conflict",
+      "mutating": true,
+      "requires_operation_id": true
+    },
+    {
+      "name": "repo.conflict_abort",
+      "description": "Abort an in-progress conflict merge and restore a clean worktree state for the feature.",
+      "input_schema_ref": "schemas/input/repo.conflict_abort.input.schema.json",
+      "output_schema_ref": "schemas/output/repo.conflict_abort.output.schema.json",
+      "supported_roles": ["orchestrator", "system"],
+      "handler_id": "repo.conflict_abort",
+      "mutating": true,
+      "requires_operation_id": true
+    },
     {
       "name": "feature.ready_to_merge",
       "description": "Validate and merge a feature branch.",
@@ -197,7 +247,7 @@
       "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"],
+      "supported_roles": ["orchestrator", "builder", "qa", "reconciler", "system"],
       "handler_id": "gates.run",
       "mutating": true,
       "requires_operation_id": true
@@ -282,6 +332,26 @@
       "mutating": false,
       "requires_operation_id": false
     },
+    {
+      "name": "runtime.execution_request_submit",
+      "description": "Submit a durable add-feature execution request for the active run.",
+      "input_schema_ref": "schemas/input/runtime.execution_request_submit.input.schema.json",
+      "output_schema_ref": "schemas/output/runtime.execution_request_submit.output.schema.json",
+      "supported_roles": ["orchestrator", "system"],
+      "handler_id": "runtime.execution_request_submit",
+      "mutating": true,
+      "requires_operation_id": true
+    },
+    {
+      "name": "runtime.execution_request_list",
+      "description": "List execution-control requests for the current runtime instance.",
+      "input_schema_ref": "schemas/input/runtime.execution_request_list.input.schema.json",
+      "output_schema_ref": "schemas/output/runtime.execution_request_list.output.schema.json",
+      "supported_roles": ["orchestrator", "system"],
+      "handler_id": "runtime.execution_request_list",
+      "mutating": false,
+      "requires_operation_id": false
+    },
     {
       "name": "feature.send_message",
       "description": "Send a message to the active orchestrator session for a feature.",
@@ -292,6 +362,36 @@
       "mutating": true,
       "requires_operation_id": true
     },
+    {
+      "name": "feature.question_create",
+      "description": "Create a durable blocking human-input question for a feature.",
+      "input_schema_ref": "schemas/input/feature.question_create.input.schema.json",
+      "output_schema_ref": "schemas/output/feature.question_create.output.schema.json",
+      "supported_roles": ["orchestrator", "planner", "builder", "qa", "system"],
+      "handler_id": "feature.question_create",
+      "mutating": true,
+      "requires_operation_id": true
+    },
+    {
+      "name": "feature.question_list",
+      "description": "List persisted question records for a feature.",
+      "input_schema_ref": "schemas/input/feature.question_list.input.schema.json",
+      "output_schema_ref": "schemas/output/feature.question_list.output.schema.json",
+      "supported_roles": ["orchestrator", "planner", "builder", "qa", "reconciler", "system"],
+      "handler_id": "feature.question_list",
+      "mutating": false,
+      "requires_operation_id": false
+    },
+    {
+      "name": "feature.question_answer",
+      "description": "Answer and close a persisted blocking question for a feature.",
+      "input_schema_ref": "schemas/input/feature.question_answer.input.schema.json",
+      "output_schema_ref": "schemas/output/feature.question_answer.output.schema.json",
+      "supported_roles": ["orchestrator", "system"],
+      "handler_id": "feature.question_answer",
+      "mutating": true,
+      "requires_operation_id": true
+    },
     {
       "name": "cost.record",
       "description": "Record token usage and estimated cost for a feature.",
@@ -327,10 +427,40 @@
       "description": "Get agent performance analytics with optional provider/model filters.",
       "input_schema_ref": "schemas/input/performance.get_analytics.input.schema.json",
       "output_schema_ref": "schemas/output/performance.get_analytics.output.schema.json",
-      "supported_roles": ["orchestrator", "planner", "builder", "qa", "system"],
+      "supported_roles": ["orchestrator", "planner", "builder", "qa", "reconciler", "system"],
       "handler_id": "performance.get_analytics",
       "mutating": false,
       "requires_operation_id": false
+    },
+    {
+      "name": "replay.timeline_get",
+      "description": "Query the deterministic replay timeline for a run. Returns tool call events sorted by sequence ascending.",
+      "input_schema_ref": "schemas/input/replay.timeline_get.input.schema.json",
+      "output_schema_ref": "schemas/output/replay.timeline_get.output.schema.json",
+      "supported_roles": ["orchestrator", "planner", "builder", "qa", "system"],
+      "handler_id": "replay.timeline_get",
+      "mutating": false,
+      "requires_operation_id": false
+    },
+    {
+      "name": "evidence.verify_chain",
+      "description": "[STUB] Verify the tamper-evident hash chain for a feature's evidence artifacts. Implemented in companion spec (OID2).",
+      "input_schema_ref": "schemas/input/evidence.verify_chain.input.schema.json",
+      "output_schema_ref": "schemas/output/evidence.verify_chain.output.schema.json",
+      "supported_roles": ["orchestrator", "qa", "system"],
+      "handler_id": "evidence.verify_chain",
+      "mutating": false,
+      "requires_operation_id": false
+    },
+    {
+      "name": "doctor.run",
+      "description": "[STUB] Run diagnostics and return a structured health report. Implemented in companion spec (OID3).",
+      "input_schema_ref": "schemas/input/doctor.run.input.schema.json",
+      "output_schema_ref": "schemas/output/doctor.run.output.schema.json",
+      "supported_roles": ["orchestrator", "system"],
+      "handler_id": "doctor.run",
+      "mutating": false,
+      "requires_operation_id": false
     }
   ]
 }

package/agentic/orchestrator/tools/schemas/input/doctor.run.input.schema.json

@@ -0,0 +1,18 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "additionalProperties": false,
+  "properties": {
+    "feature_id": {
+      "type": "string",
+      "description": "Optional feature ID to scope diagnostics to."
+    },
+    "checks": {
+      "type": "array",
+      "description": "Optional list of specific check names to run. Runs all checks if omitted.",
+      "items": {
+        "type": "string"
+      }
+    }
+  }
+}

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

@@ -7,6 +7,10 @@
     "feature_id": {
       "type": "string",
       "minLength": 1
+    },
+    "mode": {
+      "type": "string",
+      "minLength": 1
     }
   },
   "additionalProperties": false