agentic-orchestrator 0.1.6 → 0.1.8

package/.prettierignore

@@ -0,0 +1,10 @@
+node_modules
+dist
+coverage
+.nx
+.worktrees
+.aop
+.next
+package-lock.json
+pnpm-lock.yaml
+pnpm-workspace.yaml

package/.prettierrc.json

@@ -0,0 +1,24 @@
+{
+  "$schema": "https://json.schemastore.org/prettierrc",
+  "printWidth": 100,
+  "tabWidth": 2,
+  "useTabs": false,
+  "semi": true,
+  "singleQuote": true,
+  "quoteProps": "as-needed",
+  "trailingComma": "all",
+  "bracketSpacing": true,
+  "bracketSameLine": false,
+  "arrowParens": "always",
+  "endOfLine": "lf",
+  "proseWrap": "preserve",
+  "singleAttributePerLine": false,
+  "overrides": [
+    {
+      "files": ["*.yml", "*.yaml"],
+      "options": {
+        "singleQuote": false
+      }
+    }
+  ]
+}

package/CLAUDE.md

@@ -38,7 +38,7 @@ This is an MCP-first, multi-agent orchestrator control plane. The codebase lives
 - **MCP Tool Runtime** (`mcp/tool-runtime.ts`): Tool execution pipeline with registry-based dispatch, input/output schema validation, role-based authorization, and idempotency tracking via `operation_id`.
 - **Application Services** (`application/services/`): 12+ focused services (plan, patch, gates, QA, locks, merge, deletion, etc.) implementing port interfaces consumed by the kernel.
 
-### Configuration Layer (`agentic/orchestrator/`)
+### Configuration Layer (`config/agentic/orchestrator/`)
 
 - `policy.yaml` — Commit/patch/merge policies, lock TTL, RBAC, supervisor iteration limits
 - `gates.yaml` — Gate profiles (fast/full/merge) with commands and coverage thresholds
@@ -93,6 +93,7 @@ Lines: 90% | Branches: 90% | Functions: 90% | Statements: 90%
 ### Entry format
 
 Each entry must include:
+
 - A sequential number (increment from the last entry)
 - A short title describing what was done
 - **Goal** — one sentence on why the change was made
@@ -121,6 +122,6 @@ Each entry must include:
 When beginning work from a spec file (e.g. `spec-files/agentic_orchestrator_*.md`):
 
 1. **Before writing any code**, read the spec and add all planned tasks to the `## Next Tasks:` section of `progress.md`. Use the spec's section numbers as identifiers (e.g. `§3.1 — Add mutating cross-check`).
-2. **As each task completes**, move it out of `## Next Tasks:` and into a new numbered `✅ **Entry N — ...`** in the Completed Tasks section.
+2. **As each task completes**, move it out of `## Next Tasks:` and into a new numbered `✅ **Entry N — ...`\*\* in the Completed Tasks section.
 3. **Never leave a completed task in `## Next Tasks:`**. The section must only contain work that hasn't started or isn't finished.
 4. If a task is blocked or deferred, leave it in `## Next Tasks:` with a `[BLOCKED]` or `[DEFERRED]` annotation and a one-line reason.

package/README.md

@@ -120,7 +120,7 @@ Agentic-Orchestrator/
 │       │   ├── mcp/                   # MCP tool runtime and tool-registry-loader
 │       │   ├── providers/             # provider resolution + adapter
 │       │   └── supervisor/            # runtime orchestration loop
-│       ├── test/                      # Vitest suites (71 files / 1155 tests)
+│       ├── test/                      # Vitest suites
 │       ├── project.json               # Nx targets
 │       └── vitest.config.ts
 ├── docker/
@@ -246,7 +246,13 @@ Behavior:
 - Provider selection precedence:
   1. CLI flags (`--agent-provider`, `--agent-model`, `--agent-config`, `--provider-config-env`)
   2. env vars (`AOP_AGENT_PROVIDER`, `AOP_AGENT_MODEL`, `AOP_AGENT_CONFIG`/`AOP_AGENT_CONFIG_JSON`, `AOP_PROVIDER_CONFIG_ENV`)
-  3. `agentic/orchestrator/agents.yaml` runtime defaults
+  3. `config/agentic/orchestrator/agents.yaml` runtime defaults
+- Provider credential resolution (`provider_config_ref`):
+  1. `--provider-config-env <NAME>` if `NAME` exists in env
+  2. `agents.yaml runtime.provider_config_env` if that env var exists
+  3. `AOP_PROVIDER_CONFIG_ENV` fallback:
+     - if it looks like an env-var name and that env var exists, use that value (legacy indirection)
+     - otherwise use `AOP_PROVIDER_CONFIG_ENV` as the direct credential value
 - Runtime start:
   - starts `SupervisorRuntime` with `max_active_features=5`, `max_parallel_gate_runs=3`.
   - `max_iterations_per_phase` resolves from `policy.yaml` (`supervisor.max_iterations_per_phase`, default `6`).
@@ -376,7 +382,7 @@ When `cleanup.auto_after_merge` is enabled in `policy.yaml`, the runtime automat
 
 ### `init`
 
-Initialises agentic orchestrator configuration in the current directory. Generates `policy.yaml`, `gates.yaml`, `agents.yaml`, `adapters.yaml`, and system prompt templates. The wizard also captures default agent `provider`/`model` and `scm-provider`.
+Initialises agentic orchestrator configuration in the current directory. Generates `policy.yaml`, `gates.yaml`, `agents.yaml`, `adapters.yaml`, and system prompt templates. The wizard also captures default agent `provider`/`model`, `scm-provider`, and provider-auth mode.
 
 Schema files are bundled with AOP and validated from the installation path; `aop init` does not copy schemas into the target repository.
 
@@ -406,13 +412,22 @@ aop init --force
 #### Runtime Policy Composition
 
 At runtime the kernel always composes a canonical full policy by:
+
 1. Loading bundled `agentic/orchestrator/defaults/policy.defaults.yaml`
-2. Loading `agentic/orchestrator/policy.yaml` from your repository
+2. Loading `config/agentic/orchestrator/policy.yaml` from your repository
 3. Deep-merging user overrides over defaults (scalars replace, objects merge, arrays replace wholesale)
 4. Validating the merged result against the full `policy.schema.json`
 
 Existing repositories with full `policy.yaml` files continue to work without changes — user values override defaults entirely.
 
+#### Provider Auth Flow In `aop init`
+
+- wizard prompt: `Will you use a local agent CLI ... (yes/no)` (default `yes`)
+- if `yes`: init skips `runtime.provider_config_env` in `agents.yaml`
+- if `no`: init asks for provider env var name and checks both process env and repo `.env`
+- if missing: init prompts for a key, stores it in `.env` as `AOP_PROVIDER_CONFIG_ENV`, and writes `runtime.provider_config_env: AOP_PROVIDER_CONFIG_ENV`
+- `aop init --auto` defaults to local-CLI mode and does not emit `provider_config_env`
+
 ### `dashboard`
 
 Starts the web dashboard server (`packages/web-dashboard/`). Provides a real-time Kanban view of all features, review approval/denial, checkout, and SSE-based live updates.
@@ -475,31 +490,31 @@ aop help dashboard
 
 Supported options:
 
-| Option                                                | Description                                                                       |
-|-------------------------------------------------------|-----------------------------------------------------------------------------------|
-| `-fi <PATH>`                                          | Run exactly one spec file                                                         |
-| `-fl <PATH>`                                          | Resolve all `**/*.md` files recursively in a folder (deterministic lexical order) |
-| `--batch`                                             | Batch-ingest all specs; skip already-active features (`run`)                      |
-| `--agent-provider <codex\\|claude\\|gemini\\|custom\\|kiro-cli\\|copilot>` | Provider selection                                      |
-| `--agent-model <model-id>`                            | Model selection                                                                   |
-| `--agent-config <json-object>`                        | Additional provider-specific agent config (for example command/args payload)      |
-| `--provider-config-env <ENV_VAR>`                     | Provider auth/config environment variable name                                    |
-| `--transport <mcp\\|inprocess>`                       | Tool transport selection (default `mcp`)                                          |
-| `--takeover-stale-run`                                | Allow stale run-lease takeover during `run`                                       |
-| `--project <name>`                                    | Select project from `multi-project.yaml` (run, status, resume, retry)            |
-| `--feature-id <id>`                                   | Target feature for `delete`, `cleanup`, `retry`, `send`, `attach`                |
-| `--dry-run [true\\|false]`                            | Preview-only mode for `delete` and `cleanup`                                      |
-| `--yes`                                               | Confirm destructive `delete` or `cleanup` execution                               |
-| `--remove-worktree [true\\|false]`                    | Whether to remove `.worktrees/<feature_id>` (default `true`)                      |
-| `--remove-branch <none\\|safe\\|force>`               | Local branch cleanup mode (default `none`)                                        |
-| `--summary`                                           | Condensed one-line-per-feature output (`status`)                                  |
-| `--all`                                               | Aggregate across all projects (`status`); delete all features (`delete`)          |
-| `--auto`                                              | Non-interactive init with all defaults (`init`)                                   |
-| `--force`                                             | Overwrite existing config (`init`); force retry regardless of state (`retry`)     |
-| `--port <number>`                                     | Dashboard listen port (default `3000`)                                            |
-| `--dev`                                               | Start dashboard in Next.js dev mode                                               |
-| `--foreground`                                        | Keep dashboard server in the foreground                                           |
-| `--message <text>`                                    | Message to deliver to agent session (`send`)                                      |
+| Option                            | Description                                                                       |
+| --------------------------------- | --------------------------------------------------------------------------------- | ------------------------------------------------------------ | ------------------------------------------ | ---------- | --------- | ------------------ |
+| `-fi <PATH>`                      | Run exactly one spec file                                                         |
+| `-fl <PATH>`                      | Resolve all `**/*.md` files recursively in a folder (deterministic lexical order) |
+| `--batch`                         | Batch-ingest all specs; skip already-active features (`run`)                      |
+| `--agent-provider <codex\\        | claude\\                                                                          | gemini\\                                                     | custom\\                                   | kiro-cli\\ | copilot>` | Provider selection |
+| `--agent-model <model-id>`        | Model selection                                                                   |
+| `--agent-config <json-object>`    | Additional provider-specific agent config (for example command/args payload)      |
+| `--provider-config-env <ENV_VAR>` | Provider auth/config env var name for API-backed providers                        |
+| `--transport <mcp\\               | inprocess>`                                                                       | Tool transport selection (default `mcp`)                     |
+| `--takeover-stale-run`            | Allow stale run-lease takeover during `run`                                       |
+| `--project <name>`                | Select project from `multi-project.yaml` (run, status, resume, retry)             |
+| `--feature-id <id>`               | Target feature for `delete`, `cleanup`, `retry`, `send`, `attach`                 |
+| `--dry-run [true\\                | false]`                                                                           | Preview-only mode for `delete` and `cleanup`                 |
+| `--yes`                           | Confirm destructive `delete` or `cleanup` execution                               |
+| `--remove-worktree [true\\        | false]`                                                                           | Whether to remove `.worktrees/<feature_id>` (default `true`) |
+| `--remove-branch <none\\          | safe\\                                                                            | force>`                                                      | Local branch cleanup mode (default `none`) |
+| `--summary`                       | Condensed one-line-per-feature output (`status`)                                  |
+| `--all`                           | Aggregate across all projects (`status`); delete all features (`delete`)          |
+| `--auto`                          | Non-interactive init with all defaults (`init`)                                   |
+| `--force`                         | Overwrite existing config (`init`); force retry regardless of state (`retry`)     |
+| `--port <number>`                 | Dashboard listen port (default `3000`)                                            |
+| `--dev`                           | Start dashboard in Next.js dev mode                                               |
+| `--foreground`                    | Keep dashboard server in the foreground                                           |
+| `--message <text>`                | Message to deliver to agent session (`send`)                                      |
 
 Validation behavior:
 
@@ -522,7 +537,15 @@ Provider resolution precedence:
 
 1. CLI flags
 2. env vars (`AOP_AGENT_PROVIDER`, `AOP_AGENT_MODEL`, `AOP_AGENT_CONFIG`/`AOP_AGENT_CONFIG_JSON`, `AOP_PROVIDER_CONFIG_ENV`)
-3. `agentic/orchestrator/agents.yaml` runtime defaults
+3. `config/agentic/orchestrator/agents.yaml` runtime defaults
+
+Provider credential fallback:
+
+1. `--provider-config-env <NAME>` if `NAME` exists
+2. `runtime.provider_config_env` if that env var exists
+3. `AOP_PROVIDER_CONFIG_ENV`:
+   - `AOP_PROVIDER_CONFIG_ENV=OTHER_ENV` and `OTHER_ENV` exists -> use `OTHER_ENV`
+   - otherwise treat `AOP_PROVIDER_CONFIG_ENV` as direct credential value
 
 Transport behavior:
 
@@ -534,7 +557,7 @@ Transport behavior:
 
 ## Configuration
 
-### Policy (`agentic/orchestrator/policy.yaml`)
+### Policy (`config/agentic/orchestrator/policy.yaml`)
 
 Current defaults include:
 
@@ -553,7 +576,7 @@ Current defaults include:
 - `issue_tracker` config: provider (`github`/`linear`/`jira`), credentials, and field mapping
 - `cleanup.auto_after_merge` / `cleanup.grace_period_seconds`: automatic merged-artifact removal
 
-### Gates (`agentic/orchestrator/gates.yaml`)
+### Gates (`config/agentic/orchestrator/gates.yaml`)
 
 Default profile modes:
 
@@ -567,19 +590,19 @@ Coverage parser:
 
 - `lcov` from `coverage/control-plane/lcov.info`
 
-### Agents (`agentic/orchestrator/agents.yaml`)
+### Agents (`config/agentic/orchestrator/agents.yaml`)
 
 - role-specific system prompt paths
-- default provider/model/config-env fallback values
+- default provider/model values with optional `runtime.provider_config_env` for API-backed providers
 - optional `runtime.provider_configs.<provider>` objects for provider-specific payloads (for example `kiro-cli chat --agent dev`)
 - `worktree.post_create` commands and `worktree.symlinks` for workspace hook automation
 - stack-specific examples: [`example-configurations/node/`](example-configurations/node) and [`example-configurations/java/`](example-configurations/java)
 
-### Multi-Project (`agentic/orchestrator/multi-project.yaml`)
+### Multi-Project (`config/agentic/orchestrator/multi-project.yaml`)
 
 Optional. Defines multiple independent projects in one repository. Pass `--project <name>` on the CLI to scope commands to a project. `aop status --all` aggregates across all projects. Each project can override `policy` and `gates` paths.
 
-### Adapter Registry (`agentic/orchestrator/adapters.yaml`)
+### Adapter Registry (`config/agentic/orchestrator/adapters.yaml`)
 
 Optional. Registers custom adapters for `notification-channel`, `activity-detector`, and `scm-provider` slots. Resolves at kernel/supervisor boot.
 
@@ -600,9 +623,9 @@ This section defines the schema-governed files the target repository must contai
 
 Files you provide/configure:
 
-- `agentic/orchestrator/policy.yaml`
-- `agentic/orchestrator/gates.yaml`
-- `agentic/orchestrator/agents.yaml` (recommended; if present it is schema validated)
+- `config/agentic/orchestrator/policy.yaml`
+- `config/agentic/orchestrator/gates.yaml`
+- `config/agentic/orchestrator/agents.yaml` (recommended; if present it is schema validated)
 - `.aop/features/<feature_id>/spec.md` (input spec per feature)
 
 Files the runtime creates/maintains:
@@ -617,13 +640,13 @@ Files the runtime creates/maintains:
 ### Schema mapping
 
 | Runtime file                                       | Schema file                                              | Required/expected essentials                                                                                                                                                                    |
-|----------------------------------------------------|----------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| -------------------------------------------------- | -------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | `.aop/features/<feature_id>/plan.json`             | `agentic/orchestrator/schemas/plan.schema.json`          | `feature_id`, `plan_version`, `summary`, `allowed_areas`, `forbidden_areas`, `base_ref`, `files.{create,modify,delete}`, `contracts.{openapi,events,db}`, `acceptance_criteria`, `gate_profile` |
 | `.aop/features/<feature_id>/state.md` front matter | `agentic/orchestrator/schemas/state.schema.json`         | `feature_id`, `version`, `branch`, `worktree_path`, `status`, `gate_profile`, `gates`, `locks.held`, `collisions`, `cluster`, `role_status`, `last_updated`                                     |
 | `.aop/features/index.json`                         | `agentic/orchestrator/schemas/index.schema.json`         | `version`, `active`, `blocked`, `merged`, `locks`, `lock_leases`, `blocked_queue`, `runtime_sessions.{run_id,orchestrator_session_id,owner_instance_id,lease_expires_at,feature_sessions}`      |
-| `agentic/orchestrator/gates.yaml`                  | `agentic/orchestrator/schemas/gates.schema.json`         | `version`, `profiles.<profile>.modes.<mode>[{name,cmd,...}]`, optional parser/threshold metadata                                                                                                |
-| `agentic/orchestrator/policy.yaml`                 | `agentic/orchestrator/schemas/policy.schema.json`        | commit/merge policy, patch policy, lock config, collision policy, path rules, execution policy, RBAC, Nx/Vitest implementation constraints                                                      |
-| `agentic/orchestrator/agents.yaml`                 | `agentic/orchestrator/schemas/agents.schema.json`        | `version`, `roles`, `missing_prompt_behavior`, optional runtime defaults                                                                                                                        |
+| `config/agentic/orchestrator/gates.yaml`           | `agentic/orchestrator/schemas/gates.schema.json`         | `version`, `profiles.<profile>.modes.<mode>[{name,cmd,...}]`, optional parser/threshold metadata                                                                                                |
+| `config/agentic/orchestrator/policy.yaml`          | `agentic/orchestrator/schemas/policy.schema.json`        | commit/merge policy, patch policy, lock config, collision policy, path rules, execution policy, RBAC, Nx/Vitest implementation constraints                                                      |
+| `config/agentic/orchestrator/agents.yaml`          | `agentic/orchestrator/schemas/agents.schema.json`        | `version`, `roles`, `missing_prompt_behavior`, optional runtime defaults                                                                                                                        |
 | `.aop/features/<feature_id>/qa_test_index.json`    | `agentic/orchestrator/schemas/qa_test_index.schema.json` | `feature_id`, `version`, `source_diff_ref`, `items[]` with path/hunks/required_tests/status                                                                                                     |
 
 ### Important operational notes
@@ -708,7 +731,7 @@ The MCP contracts validator checks: protocol pinning, `catalog.json`/`tools.md`/
 ### Tool definitions
 
 | Tool                         | Purpose                                                                | Mutates state/files | Typical caller role(s)                 |
-|------------------------------|------------------------------------------------------------------------|---------------------|----------------------------------------|
+| ---------------------------- | ---------------------------------------------------------------------- | ------------------- | -------------------------------------- |
 | `feature.discover_specs`     | Discover canonical `spec.md` files under `.aop/features/*`             | No                  | orchestrator, system                   |
 | `feature.init`               | Initialize feature folder/state and ensure branch/worktree             | Yes                 | orchestrator, system                   |
 | `feature.get_context`        | Return spec + state + plan + latest evidence + QA index bundle         | No                  | orchestrator, planner, builder, qa     |
@@ -790,7 +813,7 @@ From [progress.md](spec-files/progress.md):
 - Linear and Jira issue tracker adapters with full API-backed status sync
 - Architecture boundary checks CI-enforced via `npm run validate:architecture` (93 files, 0 violations)
 - Strict linting enforced (`npm run lint`) and build is lint-gated
-- `npm run typecheck` passes; `npm test` passes (68 test files / 899 tests; all per-file coverage ≥ 90%)
+- `npm run typecheck` passes; `npm test` passes (all per-file coverage ≥ 90%)
 
 Environment note observed during implementation sessions:
 
@@ -844,6 +867,6 @@ See [LICENSE](LICENSE).
 - Implementation log: [progress.md](spec-files/progress.md)
 - Example bundles: [example-configurations/README.md](example-configurations/README.md)
 - Tool catalog: [agentic/orchestrator/tools.md](agentic/orchestrator/tools.md)
-- Policy config: [agentic/orchestrator/policy.yaml](agentic/orchestrator/policy.yaml)
-- Gates config: [agentic/orchestrator/gates.yaml](agentic/orchestrator/gates.yaml)
-- Agents config: [agentic/orchestrator/agents.yaml](agentic/orchestrator/agents.yaml)
+- Policy config: [config/agentic/orchestrator/policy.yaml](config/agentic/orchestrator/policy.yaml)
+- Gates config: [config/agentic/orchestrator/gates.yaml](config/agentic/orchestrator/gates.yaml)
+- Agents config: [config/agentic/orchestrator/agents.yaml](config/agentic/orchestrator/agents.yaml)

package/agentic/orchestrator/defaults/policy.defaults.yaml

@@ -27,7 +27,7 @@ locks:
     multiplier: 2
     jitter_ms: 150
 protected_areas:
-  - agentic/orchestrator/policy.yaml
+  - config/agentic/orchestrator/policy.yaml
 required_modes:
   - fast
   - full

package/agentic/orchestrator/prompts/planner.system.md

@@ -4,6 +4,7 @@ Produce deterministic plan submissions and plan updates that conform to plan sch
 Avoid speculative edits outside the declared file scope.
 
 After each QA wave, perform an explicit reconciliation pass:
+
 - re-read feature context (`feature.get_context`) including spec, accepted plan, QA index summary, and latest gate evidence
 - verify builder/QA outcomes still satisfy the accepted plan and spec intent
 - emit `plan.update` when correction gaps exist, with concrete revision reasons

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

@@ -3,10 +3,7 @@
   "$id": "https://example.local/agentic/agents.schema.json",
   "description": "Agent role and runtime provider configuration for the Agentic Orchestrator.",
   "type": "object",
-  "required": [
-    "version",
-    "roles"
-  ],
+  "required": ["version", "roles"],
   "additionalProperties": false,
   "properties": {
     "version": {
@@ -16,11 +13,7 @@
     "roles": {
       "type": "object",
       "description": "Per-role prompt configuration keyed by role name (planner, builder, qa).",
-      "required": [
-        "planner",
-        "builder",
-        "qa"
-      ],
+      "required": ["planner", "builder", "qa"],
       "properties": {
         "planner": {
           "$ref": "#/$defs/roleCfg",
@@ -39,10 +32,7 @@
     "missing_prompt_behavior": {
       "type": "string",
       "description": "What to do when a role's system_prompt_path file cannot be read. 'ignore' silently skips it (role gets no system prompt); 'error' throws MISSING_ROLE_PROMPT and aborts the run.",
-      "enum": [
-        "ignore",
-        "error"
-      ],
+      "enum": ["ignore", "error"],
       "default": "ignore"
     },
     "runtime": {
@@ -52,14 +42,7 @@
         "default_provider": {
           "type": "string",
           "description": "Default AI provider name (e.g. 'codex', 'claude', 'gemini'). Overridden by --agent-provider CLI flag or AOP_AGENT_PROVIDER env var.",
-          "enum": [
-            "codex",
-            "claude",
-            "gemini",
-            "custom",
-            "kiro-cli",
-            "copilot"
-          ]
+          "enum": ["codex", "claude", "gemini", "custom", "kiro-cli", "copilot"]
         },
         "default_model": {
           "type": "string",
@@ -71,7 +54,7 @@
         },
         "provider_config_env": {
           "type": "string",
-          "description": "Name of an environment variable whose value is a JSON provider-config blob. Takes lower priority than the CLI flag but higher than this file."
+          "description": "Optional env var name for API-backed provider credentials/config. Local CLI providers typically omit this. Runtime also supports AOP_PROVIDER_CONFIG_ENV fallback (legacy indirection or direct credential value)."
         },
         "provider_configs": {
           "type": "object",

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

@@ -4,10 +4,7 @@
   "description": "Gate profiles defining the verification steps and coverage thresholds used to validate feature branches.",
   "type": "object",
   "additionalProperties": false,
-  "required": [
-    "version",
-    "profiles"
-  ],
+  "required": ["version", "profiles"],
   "properties": {
     "version": {
       "type": "number",
@@ -19,9 +16,7 @@
       "additionalProperties": {
         "type": "object",
         "description": "A named gate profile containing one or more execution modes.",
-        "required": [
-          "modes"
-        ],
+        "required": ["modes"],
         "properties": {
           "modes": {
             "type": "object",
@@ -30,10 +25,7 @@
               "type": "array",
               "items": {
                 "type": "object",
-                "required": [
-                  "name",
-                  "cmd"
-                ],
+                "required": ["name", "cmd"],
                 "additionalProperties": false,
                 "properties": {
                   "name": {
@@ -127,14 +119,7 @@
       "description": "Coverage format capabilities declared for this project. Used to select the appropriate coverage parser (e.g. 'lcov', 'junit_xml').",
       "items": {
         "type": "string",
-        "enum": [
-          "none",
-          "lcov",
-          "junit_xml",
-          "jacoco_xml",
-          "cobertura_xml",
-          "custom"
-        ]
+        "enum": ["none", "lcov", "junit_xml", "jacoco_xml", "cobertura_xml", "custom"]
       }
     }
   }

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

@@ -62,11 +62,7 @@
         "anyOf": [
           {
             "type": "object",
-            "required": [
-              "holder",
-              "lease_id",
-              "expires_at"
-            ],
+            "required": ["holder", "lease_id", "expires_at"],
             "properties": {
               "holder": {
                 "type": "string",
@@ -140,10 +136,7 @@
       "description": "Features whose plan submission was deferred because one or more declared feature dependencies have not yet merged.",
       "items": {
         "type": "object",
-        "required": [
-          "feature_id",
-          "depends_on_unresolved"
-        ],
+        "required": ["feature_id", "depends_on_unresolved"],
         "properties": {
           "feature_id": {
             "type": "string",
@@ -230,11 +223,7 @@
           "additionalProperties": {
             "type": "object",
             "additionalProperties": false,
-            "required": [
-              "planner_session_id",
-              "builder_session_id",
-              "qa_session_id"
-            ],
+            "required": ["planner_session_id", "builder_session_id", "qa_session_id"],
             "properties": {
               "planner_session_id": {
                 "type": "string",

package/agentic/orchestrator/schemas/multi-project.schema.json

@@ -3,10 +3,7 @@
   "$id": "https://example.local/agentic/multi-project.schema.json",
   "description": "Multi-project workspace configuration stored in agentic/orchestrator/multi-project.yaml. Defines multiple repository projects managed by a single orchestrator installation.",
   "type": "object",
-  "required": [
-    "version",
-    "projects"
-  ],
+  "required": ["version", "projects"],
   "additionalProperties": false,
   "properties": {
     "version": {
@@ -65,10 +62,7 @@
       "minItems": 1,
       "items": {
         "type": "object",
-        "required": [
-          "name",
-          "path"
-        ],
+        "required": ["name", "path"],
         "additionalProperties": false,
         "properties": {
           "name": {

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

@@ -58,11 +58,7 @@
       "type": "object",
       "description": "Planned file operations. When a plan is present, every patched file must appear in one of these lists.",
       "additionalProperties": false,
-      "required": [
-        "create",
-        "modify",
-        "delete"
-      ],
+      "required": ["create", "modify", "delete"],
       "properties": {
         "create": {
           "type": "array",
@@ -94,34 +90,21 @@
       "type": "object",
       "description": "Declares which shared contract types this plan modifies. Each 'modify' or 'migration' value triggers a lock requirement.",
       "additionalProperties": false,
-      "required": [
-        "openapi",
-        "events",
-        "db"
-      ],
+      "required": ["openapi", "events", "db"],
       "properties": {
         "openapi": {
           "type": "string",
-          "enum": [
-            "none",
-            "modify"
-          ],
+          "enum": ["none", "modify"],
           "description": "'modify' means this plan changes the OpenAPI contract file, requiring the 'openapi' lock to be held before plan submission."
         },
         "events": {
           "type": "string",
-          "enum": [
-            "none",
-            "modify"
-          ],
+          "enum": ["none", "modify"],
           "description": "'modify' means this plan changes the events contract file, requiring the 'events' lock."
         },
         "db": {
           "type": "string",
-          "enum": [
-            "none",
-            "migration"
-          ],
+          "enum": ["none", "migration"],
           "description": "'migration' means this plan adds a database schema migration, requiring the 'db' lock."
         }
       }
@@ -199,10 +182,7 @@
           "items": {
             "type": "object",
             "additionalProperties": false,
-            "required": [
-              "name",
-              "cmd"
-            ],
+            "required": ["name", "cmd"],
             "properties": {
               "name": {
                 "type": "string",