agentic-orchestrator 0.1.7 → 0.1.9

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (58) hide show
  1. package/README.md +25 -3
  2. package/agentic/orchestrator/schemas/agents.schema.json +1 -1
  3. package/apps/control-plane/src/cli/dashboard-command-handler.ts +42 -5
  4. package/apps/control-plane/src/cli/env-file.ts +115 -0
  5. package/apps/control-plane/src/cli/help-command-handler.ts +1 -1
  6. package/apps/control-plane/src/cli/init-command-handler.ts +72 -2
  7. package/apps/control-plane/src/cli/retry-command-handler.ts +0 -1
  8. package/apps/control-plane/src/core/kernel.ts +1 -3
  9. package/apps/control-plane/src/core/tool-caller.ts +18 -3
  10. package/apps/control-plane/src/interfaces/cli/bootstrap.ts +10 -3
  11. package/apps/control-plane/src/providers/providers.ts +67 -8
  12. package/apps/control-plane/src/supervisor/build-wave-executor.ts +21 -4
  13. package/apps/control-plane/src/supervisor/qa-wave-executor.ts +21 -4
  14. package/apps/control-plane/src/supervisor/runtime.ts +9 -4
  15. package/apps/control-plane/src/supervisor/types.ts +1 -0
  16. package/apps/control-plane/test/cli-helpers.spec.ts +4 -0
  17. package/apps/control-plane/test/dashboard-command.spec.ts +36 -0
  18. package/apps/control-plane/test/init-wizard.spec.ts +166 -1
  19. package/apps/control-plane/test/providers.spec.ts +75 -2
  20. package/apps/control-plane/test/supervisor-collaborators.spec.ts +86 -0
  21. package/apps/control-plane/test/supervisor.unit.spec.ts +1 -1
  22. package/config/agentic/orchestrator/adapters.yaml +3 -0
  23. package/config/agentic/orchestrator/agents.yaml +13 -0
  24. package/config/agentic/orchestrator/gates.yaml +28 -0
  25. package/config/agentic/orchestrator/policy.yaml +22 -0
  26. package/config/agentic/orchestrator/prompts/builder.system.md +1 -0
  27. package/config/agentic/orchestrator/prompts/planner.system.md +16 -0
  28. package/config/agentic/orchestrator/prompts/qa.system.md +1 -0
  29. package/dist/apps/control-plane/cli/dashboard-command-handler.js +32 -5
  30. package/dist/apps/control-plane/cli/dashboard-command-handler.js.map +1 -1
  31. package/dist/apps/control-plane/cli/env-file.d.ts +4 -0
  32. package/dist/apps/control-plane/cli/env-file.js +89 -0
  33. package/dist/apps/control-plane/cli/env-file.js.map +1 -0
  34. package/dist/apps/control-plane/cli/help-command-handler.js +1 -1
  35. package/dist/apps/control-plane/cli/help-command-handler.js.map +1 -1
  36. package/dist/apps/control-plane/cli/init-command-handler.js +53 -4
  37. package/dist/apps/control-plane/cli/init-command-handler.js.map +1 -1
  38. package/dist/apps/control-plane/cli/retry-command-handler.js +0 -1
  39. package/dist/apps/control-plane/cli/retry-command-handler.js.map +1 -1
  40. package/dist/apps/control-plane/core/kernel.js.map +1 -1
  41. package/dist/apps/control-plane/core/tool-caller.d.ts +11 -1
  42. package/dist/apps/control-plane/interfaces/cli/bootstrap.js +9 -3
  43. package/dist/apps/control-plane/interfaces/cli/bootstrap.js.map +1 -1
  44. package/dist/apps/control-plane/providers/providers.d.ts +2 -1
  45. package/dist/apps/control-plane/providers/providers.js +52 -7
  46. package/dist/apps/control-plane/providers/providers.js.map +1 -1
  47. package/dist/apps/control-plane/supervisor/build-wave-executor.js +20 -4
  48. package/dist/apps/control-plane/supervisor/build-wave-executor.js.map +1 -1
  49. package/dist/apps/control-plane/supervisor/qa-wave-executor.js +20 -4
  50. package/dist/apps/control-plane/supervisor/qa-wave-executor.js.map +1 -1
  51. package/dist/apps/control-plane/supervisor/runtime.d.ts +2 -2
  52. package/dist/apps/control-plane/supervisor/runtime.js.map +1 -1
  53. package/dist/apps/control-plane/supervisor/types.d.ts +1 -1
  54. package/dist/apps/control-plane/supervisor/types.js.map +1 -1
  55. package/package.json +1 -1
  56. package/spec-files/completed/agentic_orchestrator_feature_gaps_closure_spec.md +2 -0
  57. package/spec-files/outstanding/agentic_orchestrator_provider_auth_bootstrap_spec.md +384 -0
  58. package/spec-files/progress.md +19 -0
package/spec-files/progress.md CHANGED
@@ -987,3 +987,22 @@ Open blockers:
987
987
  - `agentic/orchestrator/schemas/adapters.schema.json` — added root description + descriptions on all 4 adapter slot properties.
988
988
  - `agentic/orchestrator/schemas/multi-project.schema.json` — added root description + descriptions on all defaults and projects properties.
989
989
  - **Result:** `npm run validate:mcp-contracts` ✅. `npm run validate:architecture` ✅. No structural changes; only `description` annotations added.
990
+
991
+ ✅ **Entry 179 — MCP-First `gates.run` Contract Enforcement and Retry Guarding**
992
+
993
+ - **Goal:** Eliminate kernel-style nullable argument semantics on gate execution paths so all orchestration traffic is valid against MCP tool schemas first.
994
+ - **Changes made:**
995
+ - Added tool-name keyed argument typing in `apps/control-plane/src/core/tool-caller.ts`:
996
+ - `ToolArgsByName` + `ToolArgs<TToolName>` map with strict `gates.run` args (`feature_id`, `mode`, optional string `profile`, optional `operation_id`).
997
+ - Updated `ToolCaller.callTool(...)` generic signature to enforce tool-specific arg shapes.
998
+ - Updated supervisor caller implementation in `apps/control-plane/src/supervisor/runtime.ts` to use `ToolArgs<TToolName>` so typed MCP argument contracts apply at compile time in runtime orchestration code.
999
+ - Removed invalid nullable profile payloads (`profile: null`) from all `gates.run` call sites:
1000
+ - `apps/control-plane/src/supervisor/build-wave-executor.ts`
1001
+ - `apps/control-plane/src/supervisor/qa-wave-executor.ts`
1002
+ - `apps/control-plane/src/cli/retry-command-handler.ts`
1003
+ - Added retry eligibility guards in build/qa executors:
1004
+ - retries now proceed only when a gate failure is explicitly retryable (`error.details.retryable === true`) or when the gate returns an explicit `overall: fail` result envelope.
1005
+ - non-retryable MCP errors (for example, schema validation `invalid_argument`) no longer enter auto-repair retry loops.
1006
+ - Expanded tests:
1007
+ - `apps/control-plane/test/cli-helpers.spec.ts` now asserts retry command omits `profile` from `gates.run` payload.
1008
+ - `apps/control-plane/test/supervisor-collaborators.spec.ts` adds regressions proving build/qa skip retries on non-retryable gate errors.