AI编码代理编排工具

You:    We need OAuth2 login with Google
Agent:  "Handle errors gracefully" — what does that mean concretely?
        Return 400? Log and continue? Show a user-facing message?
You:    Return 401 with a JSON error body for invalid tokens
Agent:  Got it. Creating 6 tasks with dependencies...

[14:02] picking up task-3 — refresh token rotation
        loading parent summaries: task-1, task-2
        spawning container with sidecar...

[14:18] task-3 completed — summary pushed via sidecar
        tokens: 42,180 in / 8,340 out

[14:18] task-4 unblocked — token revocation on logout

✓  Provider config loads from env
✓  Login redirects to Google
✗  Refresh token rotates on expiry       ← broken
✓  Logout revokes all tokens
✓  Integration tests pass

git clone https://github.com/JLugagne/agach.git
cd agach
docker compose up --build

export AGACH_SERVER_URL=http://localhost:8322
export AGACH_ONBOARDING_CODE=123456
agach-daemon

graph TB
    subgraph Server
        API[REST API]
        WS[WebSocket Hub]
        Dashboard
        Identity
        PG[(PostgreSQL)]
        API --> PG
        Identity --> PG
    end

    subgraph Daemon
        Chat[Planning Chat]
        Git[Git Worktrees]
        Docker[Docker Builds]
        Scheduler[Task Scheduler]
        SQLite[(Local SQLite)]
        Docker --> SQLite
    end

    subgraph Container 1
        CC1[Claude Code]
        SC1[Sidecar]
        CC1 --> MCPtools
        MCPtools --> SC1
    end

    subgraph Container 2
        CC2[Claude Code]
        SC2[Sidecar]
        CC2 --> MCPtools
        MCPtools --> SC2
    end

    Dashboard <--> WS
    Daemon -- WebSocket + REST --> Server
    Scheduler -- spawns --> Container1
    Scheduler -- spawns --> Container2
    SC1 -- REST --> API
    SC2 -- REST --> API

sequenceDiagram
    participant PM as PM / Dashboard
    participant S as Server
    participant D as Daemon
    participant C as Container
    participant SC as Sidecar

    PM->>S: Create feature
    PM->>S: Start planning chat
    S->>D: chat.start (WebSocket)
    D->>D: Clone/pull worktree
    D->>D: Spawn Claude Code
    D-->>PM: Stream planning conversation
    Note over PM,D: PM and planning agent negotiate spec

    D->>S: Upload conversation JSONL
    S->>S: Store tasks from plan

    loop For each unblocked task
        D->>D: Build Docker image (if needed)
        D->>C: Spawn container + inject sidecar
        C->>SC: complete_task (MCP)
        SC->>S: POST /api/tasks/{id}/complete
        SC->>S: Upload _SUMMARY.md
        S-->>PM: Task completed (WebSocket)
    end

    PM->>PM: Review feature narrative

graph LR
    S[scaffold-1] --> R1[red-1]
    S --> R2[red-2]
    S --> R3[red-3]
    R1 --> G1[green-1]
    R2 --> G2[green-2]
    R3 --> G3[green-3]
    G1 --> RF[refactor-1]
    G2 --> RF
    G3 --> RF
    RF --> RV[reviewer]

    style S fill:#6b7280,stroke:#4b5563,color:#f9fafb
    style R1 fill:#ef4444,stroke:#dc2626,color:#fff
    style R2 fill:#ef4444,stroke:#dc2626,color:#fff
    style R3 fill:#ef4444,stroke:#dc2626,color:#fff
    style G1 fill:#22c55e,stroke:#16a34a,color:#fff
    style G2 fill:#22c55e,stroke:#16a34a,color:#fff
    style G3 fill:#22c55e,stroke:#16a34a,color:#fff
    style RF fill:#a78bfa,stroke:#7c3aed,color:#fff
    style RV fill:#3b82f6,stroke:#2563eb,color:#fff

internal/
  server/            # Project management
    domain/          #   Types, errors, repository interfaces
    app/             #   Business logic, prompt rendering
    inbound/         #   REST handlers, converters
    outbound/pg/     #   PostgreSQL + migrations
    ux/              #   React + TypeScript dashboard
  identity/          # Auth, users, teams, nodes
    domain/          #   Types, repositories, service interfaces
    app/             #   Auth, SSO, onboarding, node management
    inbound/         #   REST handlers
    outbound/pg/     #   PostgreSQL
  daemon/            # Agent orchestration
    domain/          #   Types, build repository
    app/             #   Chat manager, git service, Docker service
    client/          #   Onboarding, auth, projects, upload clients
    inbound/ws/      #   WebSocket event handlers
    outbound/sqlite/ #   Local build history
  sidecar/           # In-container bridge (planned)
    mcp/             #   MCP tool definitions
    client/          #   Server API client
    watcher/         #   Summary file watcher
pkg/
  server/            # Shared DTOs with validation
  daemonws/          # Shared WebSocket protocol (docker + chat events)
  controller/        # HTTP response helpers
  middleware/        # Auth, rate limiting, body limits
  websocket/         # WebSocket hub
  sse/               # Server-sent events hub