mirror of
https://github.com/fsolla/teqo.git
synced 2026-11-13 15:13:07 +00:00
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>
54 lines
3 KiB
JavaScript
54 lines
3 KiB
JavaScript
/**
|
|
* Worker prompt for pool-spawned Cursor Cloud Agents
|
|
* (docs/plans/agent-pool-orchestrator.md §4/§5).
|
|
*
|
|
* The supervisor claims the issue BEFORE spawning (label flip + pool-worker
|
|
* marker comment — the coordinated-claim anti-race), so the worker SKIPS the
|
|
* claim step of work-issue and starts at step 1b. Everything else — gates, PR
|
|
* base stage with Closes #N, auto-merge + CI watch, never promote — is the
|
|
* standard skill contract restated so the worker cannot miss it.
|
|
*/
|
|
|
|
/** First docs/plans/*.md path in the issue body (the linked plan), if any. */
|
|
export const extractPlanPath = (body) => body?.match(/docs\/plans\/[\w./-]+\.md/)?.[0] ?? null
|
|
|
|
/**
|
|
* @param {Object} options
|
|
* @param {number} options.issueNumber
|
|
* @param {string} options.issueTitle
|
|
* @param {string | null} [options.issueId] frontmatter id (e.g. B79)
|
|
* @param {string | null} [options.planPath]
|
|
* @param {string | null} [options.modelSlug] frontmatter model: as declared
|
|
*/
|
|
export const buildPoolWorkerPrompt = ({ issueNumber, issueTitle, issueId, planPath, modelSlug }) =>
|
|
[
|
|
'Você é um worker do pool de agentes do Teqo (repo fsolla/teqo).',
|
|
'',
|
|
'## Sua Issue (já claimada — NÃO rode `pnpm agent:claim`)',
|
|
'',
|
|
`#${issueNumber} — ${issueTitle}${issueId ? ` (${issueId})` : ''}`,
|
|
'O pool-supervisor já fez o claim desta Issue (label `in-progress` + comentário de claim). Outros workers do pool pegam outras Issues — trabalhe somente nesta.',
|
|
'',
|
|
'## Fluxo',
|
|
'',
|
|
'Siga a skill `.cursor/skills/work-issue/SKILL.md` a partir do passo 1b, PULANDO o passo 1 (claim):',
|
|
'1. Rode `pnpm i` se `node_modules` não existir.',
|
|
planPath
|
|
? `2. Plano: \`${planPath}\` — freshness audit enxuto (passo 3 da skill).`
|
|
: '2. O body da Issue é a spec (não há plano linkado — avalie se ele basta para trabalhar).',
|
|
'3. Execute as fases com os gates do repo: `pnpm gate:fast` antes do push (o pre-push roda `pnpm gate:push`). Comandos bare, nunca piped.',
|
|
`4. PR obrigatoriamente com \`gh pr create --base stage\` e "Closes #${issueNumber}" no body.`,
|
|
'5. `gh pr merge --auto --merge <PR>` e acompanhe `gh pr checks <PR> --watch` até o merge. Falha de CI no seu PR é sua (docs/AGENT-OPS.md — "Dono do PR, dono do CI"): corrija na mesma branch.',
|
|
'',
|
|
'## Proibido',
|
|
'',
|
|
'- `pnpm agent:promote` — promote stage→main é humano.',
|
|
'- `DATABASE_URL` de stage/prod ou `ALLOW_REMOTE_DB` — o setup local (`.cursor/cloud-setup.sh` + seed mínimo) cobre tudo.',
|
|
`- Editar outras Issues \`in-progress\` ou trabalhar fora da Issue #${issueNumber}.`,
|
|
'',
|
|
modelSlug
|
|
? `Modelo declarado da Issue: \`${modelSlug}\` — você foi spawnado nele (ou no fallback documentado pelo pool); a verificação assimétrica do passo 2 não se aplica.`
|
|
: 'A Issue não declara `model:` — você foi spawnado no default do pool (composer-2.5).',
|
|
'',
|
|
`Ao terminar — merge concluído ou falha terminal — comente na Issue #${issueNumber} o desfecho em uma linha e encerre.`,
|
|
].join('\n')
|