680ff56754
* feat(agent-pool): fundacao read-only do orquestrador (fase A) - docs/plans/agent-pool-orchestrator.md: plano completo (14 secoes) - buildClaimQueue extraido de agent-claim para agent-github (comportamento identico, pinado) - agent-pool-eligibility: isAutonomousClaimable puro e fail-closed + buildPoolQueue - agent-pool-state: parsePoolConfig, marcadores pool-worker, classifyPoolClaim, spawn plan, auto-stop - agent-pool-github: leitura de repo variables (degrada nao-estrito), claims/PRs/migration-lock - pnpm agent:pool -- status|tick --dry-run (inspecao local; live chega na fase B) - 34 specs unit novos (992/992 verde); lint/tsc/knip/cycles/format verdes Co-authored-by: Francisco Solla <fsolla@users.noreply.github.com> * feat(agent-pool): spawn remoto de workers via Cursor API (fase B) - agent-pool-cursor: client fino da Cloud Agents API v1 (fetch injetavel; CursorApiError com status/body) - agent-pool-models: resolvePoolModel contra /v1/models (id/alias, sufixo -fast -> param, fallback composer-2.5 com warn) - agent-pool-prompt: contrato do worker (claim pre-feito, pula passo 1; PR base stage + Closes #N; promote proibido) - claim coordenado no tick: lock otimista + flip + marcador; agentId idempotente bc-<uuid>; 409 recupera; rollback em falha de spawn - agent:pool workflow --action start|stop|pause|resume|tick|status (variables POOL_*); doctor; wrappers gh workflow run - .github/workflows/agent-pool.yml (dispatch-only; schedule/triggers na fase C) - 19 specs novos (1011/1011); lint/tsc/knip/cycles/format verdes Co-authored-by: Francisco Solla <fsolla@users.noreply.github.com> * feat(agent-pool): ciclo de vida do supervisor (fase C) - derivePoolClaims com status real dos runs (getCursorRun), heal de spawn via agentId deterministico, cancel de duplicatas - reconcilePoolClaims: falha terminal -> comentario + blocked + archive; merge concluido -> slot livre + archive - auto-stop real: fila drenada + zero ativos -> POOL_ENABLED=false (exclusoes migration-busy nao desligam) - job summary markdown (GITHUB_STEP_SUMMARY) — superficie remota de status - workflow: schedule */10min + pull_request closed em stage (ativam na default branch apos promote) - 2 specs novos (1013/1013); lint/tsc/knip/cycles/format verdes Co-authored-by: Francisco Solla <fsolla@users.noreply.github.com> * docs(agent-pool): runbook operacional e adendo do spike (fase D) - skill agent-pool: runbook humano (pre-requisitos, start/stop/pause remoto, ciclo de vida, triage, smoke de aceite) - AGENT-OPS: linha na tabela de comandos + secao Agent pool (canal, secrets, ativacao pos-promote) - CHANGELOG-AGENTS: entrada curta da entrega - engineering-audit: pause/resume do pool no protocolo do modo solitario - plano secao 14.1: evidencias do spike 2026-07-30 (environment repo-file confirmado, id bc-<uuid>, degradacao 403, pendencias do primeiro run com CURSOR_API_KEY) Co-authored-by: Francisco Solla <fsolla@users.noreply.github.com> * fix(test): teardown flake no homeSearchUi.unit.spec (dono do CI) O scheduler do react (prefetch do next/link) podia disparar apos o teardown do jsdom e derrubar o job unit com 'window is not defined' (run 30587862940). afterEach(cleanup) — padrao dos 14 specs irmaos. Co-authored-by: Francisco Solla <fsolla@users.noreply.github.com> --------- Co-authored-by: Cursor Agent <cursoragent@cursor.com> Co-authored-by: Francisco Solla <fsolla@users.noreply.github.com>
75 lines
2.4 KiB
YAML
75 lines
2.4 KiB
YAML
# Agent pool supervisor (docs/plans/agent-pool-orchestrator.md).
|
|
#
|
|
# Stateless tick: reconciles pool claims and spawns Cursor Cloud workers up to
|
|
# POOL_MAX_SLOTS over `ready` autonomous-eligible issues. Three triggers:
|
|
# - workflow_dispatch — the canonical human channel (start/stop/pause/resume)
|
|
# - schedule */10min — the periodic reconcile (default branch only)
|
|
# - pull_request closed on stage — immediate slot replenish after a merge
|
|
# Schedule and PR triggers only run from the default branch: they activate
|
|
# after the human promote to main; until then dispatch on the branch works.
|
|
#
|
|
# Secrets: CURSOR_API_KEY (repo secret) — Cursor Cloud Agents API key.
|
|
# GITHUB_TOKEN needs actions: write (pool state lives in repo variables).
|
|
name: Agent pool supervisor
|
|
|
|
on:
|
|
schedule:
|
|
- cron: '*/10 * * * *'
|
|
pull_request:
|
|
types: [closed]
|
|
branches: [stage]
|
|
workflow_dispatch:
|
|
inputs:
|
|
action:
|
|
description: 'Ação do pool'
|
|
required: true
|
|
type: choice
|
|
options:
|
|
- start
|
|
- stop
|
|
- pause
|
|
- resume
|
|
- tick
|
|
- status
|
|
maxSlots:
|
|
description: 'Slots simultâneos (só com action=start; default 5, máx 8)'
|
|
required: false
|
|
type: string
|
|
|
|
# Single-allocator invariant: ticks never overlap.
|
|
concurrency:
|
|
group: agent-pool
|
|
cancel-in-progress: false
|
|
|
|
permissions:
|
|
actions: write
|
|
contents: read
|
|
issues: write
|
|
pull-requests: read
|
|
|
|
jobs:
|
|
tick:
|
|
runs-on: ubuntu-latest
|
|
timeout-minutes: 10
|
|
steps:
|
|
- uses: actions/checkout@v4
|
|
- uses: actions/setup-node@v4
|
|
with:
|
|
node-version: 24
|
|
# The pool scripts are dependency-free .mjs (gh CLI + native fetch) — no
|
|
# pnpm install, ticks stay under a minute.
|
|
- name: agent:pool workflow
|
|
env:
|
|
GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
|
|
CURSOR_API_KEY: ${{ secrets.CURSOR_API_KEY }}
|
|
ACTION: ${{ inputs.action }}
|
|
MAX_SLOTS: ${{ inputs.maxSlots }}
|
|
run: |
|
|
# schedule / pull_request closed → reconcile tick; dispatch → the chosen action.
|
|
if [ "$GITHUB_EVENT_NAME" = "workflow_dispatch" ]; then
|
|
args=(--action "$ACTION" --actor "$GITHUB_ACTOR")
|
|
if [ -n "$MAX_SLOTS" ]; then args+=(--max-slots "$MAX_SLOTS"); fi
|
|
else
|
|
args=(--action tick --actor "$GITHUB_ACTOR")
|
|
fi
|
|
node scripts/agent-pool.mjs workflow "${args[@]}"
|