jordan 39df51defd feat: Add multi-provider code agent interface with Claude Code and OpenCode adapters

Implements weeks 1-4 of the multi-provider architecture:

Week 1 - Foundation:
- Add domain models (AgentProvider, AgentRequest, AgentEvent, AgentResult)
- Define CodeAgent port interface with Execute, Cancel, Capabilities
- Create thread-safe provider registry with first-registered default

Week 2 - Claude Code Adapter:
- Extract kubectl exec logic into CodeAgent implementation
- Parse stream-json output format (init, message, tool_use, result)
- Support session continuation via --resume flag

Week 3 - OpenCode Adapter:
- HTTP/SSE client for opencode serve API
- Session management (create, send message, abort)
- Event streaming with documented buffer rationale

Week 4 - Quality & Polish:
- Fix race condition in OpenCode Cancel method
- Add AgentRequest.Validate() with ErrPromptRequired, ErrInvalidTimeout
- Document DefaultAvailabilityTimeout constants
- Add HTTP error context for debugging

Also includes:
- Work queue system with PostgreSQL adapter
- Credential store for infrastructure secrets
- Project templates with Woodpecker CI integration
- Comprehensive test coverage

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

2026-01-27 09:25:51 -07:00

2.0 KiB

Raw Blame History

Build Orchestration

Last Updated: 2025-01 Confidence: High (Planned - see address-the-gaps.md)

Summary

Build orchestration enables structured build specs for bot-driven development. Bots submit build requests with prompts, workers execute, and callbacks notify completion.

Key Facts:

Build spec includes template, prompt, variables, auto_deploy flag
Enqueues as work task for worker pool
Auto-deploy commits, pushes, triggers Woodpecker CI
Callback URL notified on completion with artifacts

File Pointers:

Service: internal/service/build_service.go
Handler: internal/handlers/build.go
Work queue: internal/port/work_queue.go

Build Spec Schema

type BuildSpec struct {
    Template    string            `json:"template"`
    Prompt      string            `json:"prompt"`
    Variables   map[string]string `json:"variables"`
    AutoDeploy  bool              `json:"auto_deploy"`
    CallbackURL string            `json:"callback_url"`
}

API Endpoint

POST /project/{name}/build
{
    "template": "astro-landing",
    "prompt": "Create a coming soon page with dark theme and threesix.ai branding",
    "auto_deploy": true,
    "callback_url": "https://pantheon.orchard9.ai/webhooks/build-complete"
}

Orchestration Flow

Bot calls POST /project/{name}/build
BuildService validates project exists
Creates WorkTask with build spec
Enqueues to work queue
Returns task ID immediately
Worker picks up task:
- Clones repo
- Runs Claude with prompt
- Commits and pushes (if auto_deploy)
Woodpecker builds and deploys
Callback notified with result

Callback Payload

{
    "task_id": "uuid",
    "project_id": "myapp",
    "status": "completed",
    "result": {
        "output": "...",
        "artifacts": {
            "commit_sha": "abc123",
            "deploy_url": "https://myapp.threesix.ai"
        }
    }
}

2.0 KiB Raw Blame History