[Initiative] Agent-Oriented Orchestration Workers in the Go Control Plane

[juliuskrah]

Summary

Define an agent-oriented orchestration worker model in the Go control plane for catalog intelligence tasks (e.g., markdown AST compilation, extension execution orchestration, and deterministic enrichment workflows).

In Scope

• Define worker roles and contracts for intelligence tasks in the API/orchestrator layer
• Add queueing/execution model for asynchronous agent tasks with retry and backoff
• Define deterministic input/output envelopes for agent tasks and side-effect boundaries
• Add sandbox execution integration points for WASI-based agent logic where needed
• Add observability and audit trails for agent decisions/actions
• Add guardrails so agent workflows cannot bypass validation/admission boundaries

Out of Scope

• Buyer-facing AI product UX
• Marketplace monetization and packaging UX
• Mutating admission controllers

Acceptance Criteria

• Worker lifecycle and task contracts are documented and implemented
• Agent task execution supports retries, idempotency keys, and failure diagnostics
• Execution traces can be correlated across git event, worker run, and API response
• WASI-backed task integration follows sandbox/resource limits
• Policy boundaries ensure agent workflows cannot write around validation/admission paths
• Integration tests cover success, retry, timeout, and policy-rejection paths

Implementation Notes

This issue is infrastructure for agent orchestration, not end-user agent features. The main risk is non-deterministic behavior in core catalog paths. Keep agent tasks explicit, replayable, and bounded. For safety, agent-generated outputs should pass through the same validating pipeline as human-authored changes.

Dependencies

• Depends on: [Initiative] gRPC GitEvent Notification Stream from gitstore-git-service to gitstore-api #139 (gRPC GitEvent Notification Stream), [Initiative] Controller Watch API with resourceVersion Resume #131 (Controller Watch API), [Initiative] API Admission Controller (Validating Phase Only) #123 (API Admission Controller)
• Related: [Initiative] Agents for the Buyer Journey (MCP / ACP / UCP) #36 (Agents for the Buyer Journey), [Initiative] WASI Extension Marketplace #35 (WASI Extension Marketplace), [Initiative] Dynamic GraphQL Schema Synthesis and Stitching for Custom Kinds #149 (Dynamic GraphQL Schema Synthesis and Stitching)

Tracking

• Area: agents
• Priority: p2 – high
• Target Milestone / Release: TBD

[juliuskrah]

Blocked by: #148 and #149 (handler chain and schema stitching must be settled before agent workers can be wired in).