@ludecker/aaac 1.0.0 → 1.1.0

package/templates/cursor/aaac/dispatch.md

@@ -2,10 +2,22 @@
 
 Agents running any AAAC command **must** follow this sequence.
 
+**Enforcement (runtime):** Cursor hooks in [.cursor/hooks.json](../hooks.json) create Runs and **block code edits** until the `execute` phase. See [.cursor/rules/aaac-enforcement.mdc](../rules/aaac-enforcement.mdc). Applies to **all** AAAC slash commands.
+
 **Path convention:** In [graph.yaml](graph.yaml), paths under `agents/`, `policies/`, `skills/`, and `domains/` are relative to **`.cursor/`**.
 
 **Primary execution object:** Every command runs inside a **Run** — see [run/RUN.md](run/RUN.md) and [run/schema.json](run/schema.json).
 
+## 0. Hook-initiated Run (automatic)
+
+On submit, hooks call [scripts/run-engine/init-run.mjs](../scripts/run-engine/init-run.mjs). Follow `run.json` phases. `preToolUse` denies Write/StrReplace/Delete outside allowed phases.
+
+Advance after swarm + artifacts:
+
+```bash
+node .cursor/aaac/scripts/run-engine/advance-phase.mjs <run_id> <completed_phase>
+```
+
 ## 1. Parse input
 
 From `$ARGUMENTS` and the user message:
@@ -21,6 +33,8 @@ If intent contains `Sync inventory only` (case-insensitive), orchestrator runs *
 
 **Resume:** If user references `run_{id}`, load `state/runs/{run_id}/run.json` and continue from `phase`.
 
+**Workflow exceptions:** Commands like `write-article` use `command_workflows.<command>` in graph (not `verb_runtime`). `fix-module` and `fix-bug` also have explicit workflows matching the fix verb runtime. No governance gate stack unless orchestrator specifies one.
+
 **Aliases:** `commands.<name>.alias` → resolve canonical command (e.g. `update-api` → `update-integration`) and continue.
 
 Legacy names (`module-update`, `architecture`, `swarm-check`, …) are aliases in [graph.yaml](graph.yaml).
@@ -39,7 +53,8 @@ Read [graph.yaml](graph.yaml) and [ontology.json](ontology.json).
 - **Maturity:** read `object_maturity.<object>` and apply `maturity_rules.<level>` (may require extra gate phases)
 - **Capabilities:** resolve `object_capabilities.<object>` via [capabilities/registry.json](capabilities/registry.json) — record all providers (skill + mcp) on Run
 - **Dependencies:** [dependencies.yaml](dependencies.yaml)
-- **Fitness:** [fitness-functions.yaml](fitness-functions.yaml)
+- **Fitness:** [fitness-functions.yaml](fitness-functions.yaml) — includes `minimal_complexity` for create/update/fix
+- **Complexity:** [complexity.yaml](complexity.yaml) + [minimal-complexity.md](../policies/minimal-complexity.md) for create/update/fix
 - **Contracts:** validate against [contracts/commands/](contracts/commands/) and [contracts/skills/](contracts/skills/)
 
 ## 2.5 Create or resume Run
@@ -47,7 +62,7 @@ Read [graph.yaml](graph.yaml) and [ontology.json](ontology.json).
 Before loading orchestrator:
 
 1. **Create** `state/runs/{run_id}/run.json` per [run/schema.json](run/schema.json)
-2. Set `pending` from `verb_runtime.<verb>` in graph (work + gates composed)
+2. Set `pending` from `command_workflows.<command>` when present, else `verb_runtime.<verb>`
 3. Set `status: running`, first `phase`, `phase_kind: work`
 4. Record resolved orchestrator, object, domain, intent on Run
 
@@ -63,6 +78,7 @@ All state and observability live on the Run — **no** standalone execution-stat
   - [master-rules.md](../policies/master-rules.md)
   - [implementation.md](../policies/implementation.md)
   - [mcp-and-deploy.md](../policies/mcp-and-deploy.md)
+  - [minimal-complexity.md](../policies/minimal-complexity.md) — **create / update / fix only**
 - Read [verbs/_dispatch-utils.md](../skills/shared/verbs/_dispatch-utils.md) for inventory + investigation rules
 - Read [run/SKILL.md](../skills/shared/run/SKILL.md) for Run update protocol
 
@@ -89,10 +105,10 @@ Gates run after `plan`, before `execute` (or before `report` when verb has no ex
 
 | Gate | Skill |
 |------|-------|
-| **validate** | [validation/SKILL.md](../skills/shared/validation/SKILL.md) |
+| **validate** | [validation/SKILL.md](../skills/shared/validation/SKILL.md) — confidence + **complexity plan** |
 | **impact_analysis** | [impact-analysis/SKILL.md](../skills/shared/impact-analysis/SKILL.md) |
 | **dependency_graph** | [dependency-graph/SKILL.md](../skills/shared/dependency-graph/SKILL.md) |
-| **fitness_functions** | [fitness-functions/SKILL.md](../skills/shared/fitness-functions/SKILL.md) |
+| **fitness_functions** | [fitness-functions/SKILL.md](../skills/shared/fitness-functions/SKILL.md) — **`minimal_complexity` blocks on fail** |
 | **rollback** | [rollback/SKILL.md](../skills/shared/rollback/SKILL.md) when maturity or blast radius requires |
 
 ### Human approval at gate boundaries
@@ -121,7 +137,16 @@ Do **not** proceed until user approves in chat. On approval: log decision, set `
 |------|----------------|
 | create | [investigation-lite](../skills/shared/investigation-lite/SKILL.md) |
 | update | [investigation-lite](../skills/shared/investigation-lite/SKILL.md) |
-| fix | [investigation](../skills/shared/investigation/SKILL.md) → [root-cause](../skills/shared/root-cause/SKILL.md) |
+| fix | [investigation](../skills/shared/investigation/SKILL.md) Mode A (7-agent swarm) → [root-cause](../skills/shared/root-cause/SKILL.md) |
+
+### Fix swarm (mandatory on fix verb / fix_mode)
+
+1. **discover** — 4–6 parallel Task agents per [discovery/SKILL.md](../skills/shared/discovery/SKILL.md)
+2. **investigate_swarm** — 7 parallel Task agents per investigation Mode A — **one message**
+3. **root_cause** — artifact required; confidence ≥ 0.7 before plan
+4. **verify** — fix verify swarm (3 parallel) per [testing/SKILL.md](../skills/shared/testing/SKILL.md); fail if `repro_status: not_fixed`
+
+Skipping swarms because the issue "looks simple" is a **contract violation** for `fix-module` / `fix-bug` / `fix_mode`.
 
 ## 5. Report
 

package/templates/cursor/aaac/enforcement.json

@@ -0,0 +1,22 @@
+{
+  "version": 1,
+  "description": "AAAC runtime enforcement — SSOT for hooks and run engine",
+  "edit_phases": ["execute", "sync_inventory", "persist", "write"],
+  "artifact_write_phases": ["plan", "report"],
+  "swarm_min_agents": {
+    "discover": 4,
+    "investigate_swarm": 7,
+    "research_swarm": 6,
+    "verify_fix": 3
+  },
+  "phase_artifacts": {
+    "investigate_swarm": ["artifacts/investigation.md"],
+    "root_cause": ["artifacts/root_cause.yaml"],
+    "plan": ["artifacts/plan.yaml"],
+    "report": ["artifacts/report.md"]
+  },
+  "allowed_path_prefixes": {
+    "run_artifacts": [".cursor/aaac/state/runs/", "aaac/state/runs/"]
+  },
+  "fix_commands": ["fix-module", "fix-bug", "module-fix", "bug-fix"]
+}

package/templates/cursor/aaac/fitness-functions.yaml

@@ -28,6 +28,14 @@ functions:
     skill: architecture
     applies_to: [module, component, feature, app]
 
+  minimal_complexity:
+    description: Reuse-first plan, complexity score within verb threshold, YAGNI — no speculative architecture
+    policy: minimal-complexity
+    config: aaac/complexity.yaml
+    applies_to: [function, component, module, schema, model, migration, feature, workflow, integration, app, domain, architecture]
+    applies_to_verbs: [create, update, fix]
+    blocking: true
+
 scoring:
   pass: meets criteria
   warning: minor gap — document in report, may proceed if user intent clear

package/templates/cursor/aaac/governance/gates.json

@@ -24,7 +24,9 @@
     "human_approval": {
       "trigger_when": [
         "confidence below threshold",
-        "fitness fail on security or layer_boundaries",
+        "fitness fail on security or layer_boundaries or minimal_complexity",
+        "complexity score above verb threshold",
+        "plan missing requirement_map or unjustified create",
         "impact proceed false",
         "rollback unverified",
         "user intent contains requires approval"

package/templates/cursor/aaac/graph.project.yaml

@@ -1,4 +1,127 @@
+resolvers:
+  update-module-by-slug:
+    map:
+      cms: cms-update
+      ui: ui-update
+      database: database-update
+      aaac: aaac-update
+  update-component-by-scope:
+    map:
+      cms: cms-design-update
+      ui: ui-design-update
+  create-feature-by-slug:
+    map:
+      cms: cms-create-feature
+      aaac: aaac-create-feature
+  fix-bug-by-slug:
+    map:
+      cms: cms-fix-bug
+      ui: ui-fix-bug
+      database: database-fix-bug
+      aaac: aaac-fix-bug
+    default: verb-fix
+    default_object: feature
+  fix-domain-by-slug:
+    map:
+      cms: cms-fix-bug
+      ui: ui-fix-bug
+      database: database-fix-bug
+      aaac: aaac-fix-bug
+    default: verb-fix
+    default_object: module
+  fix-component-by-scope:
+    map:
+      cms: cms-fix-bug
+      ui: ui-fix-bug
+    default: verb-fix
+    default_object: component
+  fix-data-by-slug:
+    map:
+      database: database-fix-bug
+    default: database-fix-bug
+    default_object: schema
+  fix-integration-by-slug:
+    map:
+      cms: cms-fix-bug
+      ui: ui-fix-bug
+      database: database-fix-bug
+      aaac: aaac-fix-bug
+    default: verb-fix
+    default_object: integration
+  test-module-by-slug:
+    map:
+      cms: cms-test-module
+      ui: ui-test-module
+      database: database-test-module
+      aaac: aaac-test-module
+
 orchestrators:
+  cms-update:
+    domain: cms
+    path: domains/cms/update/orchestrator
+    inventory: domains/cms/update/inventory
+    requires: [discovery, investigation-lite, planning, validation, impact-analysis, dependency-graph, fitness-functions, rollback, execution, testing, verification, reporting]
+    phases: [load_inventory, discover, investigate_lite, plan, validate, impact_analysis, dependency_graph, fitness_functions, rollback, execute, verify, sync_inventory, report]
+
+  ui-update:
+    domain: ui
+    path: domains/ui/update/orchestrator
+    inventory: domains/ui/update/inventory
+    requires: [discovery, investigation-lite, planning, validation, impact-analysis, dependency-graph, fitness-functions, rollback, execution, testing, verification, reporting]
+    phases: [load_inventory, discover, investigate_lite, plan, validate, impact_analysis, dependency_graph, fitness_functions, rollback, execute, verify, sync_inventory, report]
+
+  database-update:
+    domain: database
+    path: domains/database/update/orchestrator
+    inventory: domains/database/update/inventory
+    requires: [discovery, investigation-lite, planning, validation, impact-analysis, dependency-graph, fitness-functions, rollback, execution, testing, verification, reporting]
+    phases: [load_inventory, discover, investigate_lite, plan, validate, impact_analysis, dependency_graph, fitness_functions, rollback, execute, verify, sync_inventory, report]
+
+  cms-design-update:
+    domain: cms
+    path: domains/cms/update/orchestrator
+    inventory: domains/cms/update/inventory
+    requires: [discovery, investigation-lite, planning, validation, impact-analysis, dependency-graph, fitness-functions, rollback, execution, testing, verification, reporting]
+    design_mode: true
+
+  ui-design-update:
+    domain: ui
+    path: domains/ui/update/orchestrator
+    inventory: domains/ui/update/inventory
+    requires: [discovery, investigation-lite, planning, validation, impact-analysis, dependency-graph, fitness-functions, rollback, execution, testing, verification, reporting]
+    design_mode: true
+
+  cms-create-feature:
+    domain: cms
+    path: domains/cms/update/orchestrator
+    inventory: domains/cms/update/inventory
+    requires: [discovery, investigation-lite, planning, validation, impact-analysis, dependency-graph, fitness-functions, rollback, execution, testing, verification, reporting, module-authoring]
+    create_mode: true
+
+  cms-fix-bug:
+    domain: cms
+    path: domains/cms/update/orchestrator
+    inventory: domains/cms/update/inventory
+    requires: [discovery, investigation, root-cause, planning, validation, impact-analysis, dependency-graph, fitness-functions, rollback, execution, testing, verification, reporting]
+    fix_mode: true
+    phases: [load_inventory, discover, investigate_swarm, root_cause, plan, validate, impact_analysis, dependency_graph, fitness_functions, rollback, execute, verify, sync_inventory, report]
+
+  ui-fix-bug:
+    domain: ui
+    path: domains/ui/update/orchestrator
+    inventory: domains/ui/update/inventory
+    requires: [discovery, investigation, root-cause, planning, validation, impact-analysis, dependency-graph, fitness-functions, rollback, execution, testing, verification, reporting]
+    fix_mode: true
+    phases: [load_inventory, discover, investigate_swarm, root_cause, plan, validate, impact_analysis, dependency_graph, fitness_functions, rollback, execute, verify, sync_inventory, report]
+
+  database-fix-bug:
+    domain: database
+    path: domains/database/update/orchestrator
+    inventory: domains/database/update/inventory
+    requires: [discovery, investigation, root-cause, planning, validation, impact-analysis, dependency-graph, fitness-functions, rollback, execution, testing, verification, reporting]
+    fix_mode: true
+    phases: [load_inventory, discover, investigate_swarm, root_cause, plan, validate, impact_analysis, dependency_graph, fitness_functions, rollback, execute, verify, sync_inventory, report]
+
   update-doc:
     path: skills/shared/documentation/orchestrator
     requires: [discovery, documentation, reporting]
@@ -7,7 +130,7 @@ orchestrators:
   review-incident:
     path: skills/shared/investigation/orchestrator
     requires: [discovery, investigation, reporting]
-    optional: [execution]
+    optional: [execution, ludecker-infrastructure]
 
   review-module:
     path: skills/shared/architecture/orchestrator
@@ -23,9 +146,73 @@ orchestrators:
     path: skills/shared/testing/orchestrator
     requires: [discovery, testing, verification, reporting]
 
+  cms-test-module:
+    domain: cms
+    path: domains/cms/update/orchestrator
+    inventory: domains/cms/update/inventory
+    requires: [testing, verification, reporting]
+    test_only: true
+
+  ui-test-module:
+    domain: ui
+    path: domains/ui/update/orchestrator
+    inventory: domains/ui/update/inventory
+    requires: [testing, verification, reporting]
+    test_only: true
+
+  database-test-module:
+    domain: database
+    path: domains/database/update/orchestrator
+    inventory: domains/database/update/inventory
+    requires: [testing, verification, reporting]
+    test_only: true
+
+  aaac-update:
+    domain: aaac
+    path: domains/aaac/update/orchestrator
+    inventory: domains/aaac/update/inventory
+    requires: [discovery, investigation-lite, planning, validation, impact-analysis, dependency-graph, fitness-functions, rollback, execution, testing, verification, reporting, integration]
+    phases: [load_inventory, discover, investigate_lite, plan, validate, impact_analysis, dependency_graph, fitness_functions, rollback, execute, verify, sync_inventory, report]
+
+  aaac-create-feature:
+    domain: aaac
+    path: domains/aaac/update/orchestrator
+    inventory: domains/aaac/update/inventory
+    requires: [discovery, investigation-lite, planning, validation, impact-analysis, dependency-graph, fitness-functions, rollback, execution, testing, verification, reporting, module-authoring, integration]
+    create_mode: true
+
+  aaac-fix-bug:
+    domain: aaac
+    path: domains/aaac/update/orchestrator
+    inventory: domains/aaac/update/inventory
+    requires: [discovery, investigation, root-cause, planning, validation, impact-analysis, dependency-graph, fitness-functions, rollback, execution, testing, verification, reporting, integration]
+    fix_mode: true
+    phases: [load_inventory, discover, investigate_swarm, root_cause, plan, validate, impact_analysis, dependency_graph, fitness_functions, rollback, execute, verify, sync_inventory, report]
+
+  aaac-test-module:
+    domain: aaac
+    path: domains/aaac/update/orchestrator
+    inventory: domains/aaac/update/inventory
+    requires: [testing, verification, reporting, integration]
+    test_only: true
+
+  aaac-publish:
+    domain: aaac
+    path: domains/aaac/update/orchestrator
+    inventory: domains/aaac/update/inventory
+    requires: [testing, verification, execution, reporting, integration]
+    publish_mode: true
+
+  write-article:
+    domain: content
+    path: domains/content/write/orchestrator
+    requires: [run, reporting]
+    workflow: write-article
+    phases: [parse, research_swarm, write, review, persist, report]
+
   release-app:
     path: skills/shared/platform-release/orchestrator
-    requires: [testing, verification, execution, reporting]
+    requires: [testing, verification, execution, reporting, ludecker-infrastructure]
 
   verb-create:
     path: skills/shared/verbs/create/orchestrator
@@ -38,6 +225,7 @@ orchestrators:
   verb-fix:
     path: skills/shared/verbs/fix/orchestrator
     requires: [discovery, investigation, root-cause, planning, validation, impact-analysis, dependency-graph, fitness-functions, rollback, execution, testing, verification, reporting]
+    phases: [load_inventory, discover, investigate_swarm, root_cause, plan, validate, impact_analysis, dependency_graph, fitness_functions, rollback, execute, verify, sync_inventory, report]
 
   verb-review:
     path: skills/shared/verbs/review/orchestrator
@@ -70,7 +258,7 @@ skills:
     depends: [governance/implementation]
   testing:
     path: skills/shared/testing
-    agents: [unit-test-run, fallow-check-changed]
+    agents: [unit-test-run, fallow-check-changed, fix-repro-verify]
   verification:
     path: skills/shared/verification
   reporting:
@@ -82,10 +270,19 @@ skills:
     path: skills/shared/documentation
   investigation:
     path: skills/shared/investigation
-  investigation-lite:
-    path: skills/shared/investigation-lite
+    agents:
+      - fix-repro
+      - fix-code-path
+      - fix-recent-changes
+      - fix-test-failures
+      - fix-regression-scope
+      - fix-runtime-evidence
+      - fix-inventory-confirm
   root-cause:
     path: skills/shared/root-cause
+    agents: [fix-hypothesis-validate]
+  investigation-lite:
+    path: skills/shared/investigation-lite
   validation:
     path: skills/shared/validation
   impact-analysis:
@@ -125,6 +322,18 @@ skills:
     path: skills/shared/platform-release
   governance/implementation:
     path: skills/shared/governance/implementation
+  ludecker-design-system:
+    path: skills/ludecker/design-system
+  ludecker-database-schema:
+    path: skills/ludecker/database-schema
+  ludecker-api-first:
+    path: skills/ludecker/api-first
+  ludecker-security:
+    path: skills/ludecker/security
+  ludecker-user-experience:
+    path: skills/ludecker/user-experience
+  ludecker-infrastructure:
+    path: skills/ludecker/infrastructure
 
 agents:
   discovery-inventory:
@@ -151,11 +360,34 @@ agents:
     path: agents/check-capability-trace.md
   impact-analysis:
     path: agents/impact-analysis.md
+  fix-repro:
+    path: agents/fix-repro.md
+  fix-code-path:
+    path: agents/fix-code-path.md
+  fix-recent-changes:
+    path: agents/fix-recent-changes.md
+  fix-test-failures:
+    path: agents/fix-test-failures.md
+  fix-regression-scope:
+    path: agents/fix-regression-scope.md
+  fix-runtime-evidence:
+    path: agents/fix-runtime-evidence.md
+  fix-inventory-confirm:
+    path: agents/fix-inventory-confirm.md
+  fix-repro-verify:
+    path: agents/fix-repro-verify.md
+  fix-hypothesis-validate:
+    path: agents/fix-hypothesis-validate.md
   release-git:
     path: agents/release-git.md
     wave: 1
     blocking: true
+  release-render:
+    path: agents/release-render.md
+    wave: 2
+    requires: [release-git]
 
 policies:
   - policies/master-rules.md
   - policies/implementation.md
+  - policies/mcp-and-deploy.md

package/templates/cursor/aaac/layers.md

@@ -19,7 +19,8 @@ Lifecycle Layer (work)
 
 Governance Layer (gates + rules)
 ├─ Gate stacks                 .cursor/aaac/governance/gates.json
-├─ Policies                    .cursor/policies/
+├─ Complexity SSOT             .cursor/aaac/complexity.yaml
+├─ Policies                    .cursor/policies/ (incl. minimal-complexity.md)
 ├─ Rules                       .cursor/rules/
 ├─ Dependencies                .cursor/aaac/dependencies.yaml
 ├─ Fitness functions           .cursor/aaac/fitness-functions.yaml
@@ -56,6 +57,7 @@ Contracts Layer (cross-cutting)
 | Graph | Control | Execution routing |
 | Lifecycle | Lifecycle | **Work** phase configuration |
 | Gate stacks | Governance | **Approval** checkpoints |
+| Complexity | Governance | Reuse-first, score limits (create/update/fix) |
 | Run | Run | Primary execution object; state + observability |
 | Domain orchestrators | Execution | Domain coordination |
 | Shared pipeline skills | Execution | Phase execution |

package/templates/cursor/aaac/lifecycle/lifecycle.json

@@ -27,7 +27,7 @@
     "fix": {
       "work_phases": [
         "discover",
-        "investigate",
+        "investigate_swarm",
         "root_cause",
         "plan",
         "execute",
@@ -74,5 +74,45 @@
   "escalation": {
     "on_gate_fail": "STOP_REQUEST_CLARIFICATION",
     "on_human_approval_required": "blocked"
+  },
+  "workflows": {
+    "write-article": {
+      "description": "CMS content swarm — exception command, not verb×object matrix",
+      "work_phases": [
+        "parse",
+        "research_swarm",
+        "write",
+        "review",
+        "persist",
+        "report"
+      ],
+      "gate_stack": null
+    },
+    "fix-module": {
+      "description": "Domain module repair — resolver + full fix swarm",
+      "work_phases": [
+        "discover",
+        "investigate_swarm",
+        "root_cause",
+        "plan",
+        "execute",
+        "verify",
+        "report"
+      ],
+      "gate_stack": "pre_execute"
+    },
+    "fix-bug": {
+      "description": "Alias workflow for defect repair — same as fix-module",
+      "work_phases": [
+        "discover",
+        "investigate_swarm",
+        "root_cause",
+        "plan",
+        "execute",
+        "verify",
+        "report"
+      ],
+      "gate_stack": "pre_execute"
+    }
   }
 }

package/templates/cursor/aaac/lifecycle/phases.json

@@ -5,6 +5,7 @@
     "discover": { "skill": "discovery", "readonly": true },
     "investigate_lite": { "skill": "investigation-lite", "readonly": true },
     "investigate": { "skill": "investigation", "readonly": true },
+    "investigate_swarm": { "skill": "investigation", "readonly": true },
     "root_cause": { "skill": "root-cause", "readonly": true },
     "plan": { "skill": "planning" },
     "validate": { "skill": "validation", "gate": true },

package/templates/cursor/aaac/observability/telemetry.yaml

@@ -0,0 +1,60 @@
+# AAAC telemetry — observability on Run
+
+version: 2
+
+description: >-
+  All observability attaches to the Run manifest (run/schema.json).
+  No standalone markdown logs.
+
+run_manifest: aaac/state/runs/{run_id}/run.json
+
+log_on:
+  - command_parsed
+  - run_created
+  - run_resumed
+  - graph_resolved
+  - phase_start
+  - phase_complete
+  - gate_pass
+  - gate_fail
+  - gate_blocked
+  - human_approval_required
+  - human_approval_received
+  - capability_resolved
+  - skill_loaded
+  - doc_loaded
+  - agent_spawned
+  - execute_start
+  - execute_complete
+  - run_completed
+  - run_failed
+
+run_fields:
+  decisions: routing, capability, gate outcomes, user approvals
+  log: phase and skill events (see schema log_entry)
+  checkpoints: resume points with artifact refs
+  artifacts: plan, investigation, impact, fitness, rollback, report
+  gates.results: per-gate pass/fail
+
+required_log_fields:
+  - at
+  - run_id
+  - phase
+  - phase_kind
+  - event
+  - detail
+
+required_decision_fields:
+  - at
+  - phase
+  - decision
+  - reason
+  - evidence
+
+questions_answered:
+  - Why did it do this?
+  - Which skill ran?
+  - Which docs were loaded?
+  - Why was a route chosen?
+  - Which capabilities resolved to which providers?
+  - Why is the run blocked?