teqo/tests/unit/agentPoolPrompt.unit.spec.ts
Francisco Solla 680ff56754 feat(agent-pool): orquestrador de pool de workers Cursor Cloud (fases A–D) (#65)
* 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>
2026-07-30 20:08:34 -03:00

65 lines
2.1 KiB
TypeScript

// @vitest-environment node
import { describe, expect, it } from 'vitest'
import { buildPoolWorkerPrompt, extractPlanPath } from '../../scripts/lib/agent-pool-prompt.mjs'
const prompt = buildPoolWorkerPrompt({
issueNumber: 42,
issueTitle: 'B91 — Ajustar badge',
issueId: 'B91',
planPath: 'docs/plans/ajustar-badge.md',
modelSlug: 'kimi-k3-low',
})
describe('buildPoolWorkerPrompt', () => {
it('tells the worker the issue is pre-claimed and forbids agent:claim', () => {
expect(prompt).toContain('#42')
expect(prompt).toContain('NÃO rode `pnpm agent:claim`')
expect(prompt).toContain('in-progress')
})
it('pins the PR contract: base stage, Closes #N, auto-merge, CI watch', () => {
expect(prompt).toContain('gh pr create --base stage')
expect(prompt).toContain('Closes #42')
expect(prompt).toContain('gh pr merge --auto --merge')
expect(prompt).toContain('gh pr checks <PR> --watch')
})
it('restates the hard prohibitions (promote humano, sem DB remota, escopo da Issue)', () => {
expect(prompt).toContain('pnpm agent:promote')
expect(prompt).toContain('DATABASE_URL')
expect(prompt).toContain('ALLOW_REMOTE_DB')
expect(prompt).toContain('trabalhar fora da Issue #42')
})
it('links the plan and the declared model when present', () => {
expect(prompt).toContain('docs/plans/ajustar-badge.md')
expect(prompt).toContain('kimi-k3-low')
})
it('notes the pool default when the issue declares no model', () => {
const noModel = buildPoolWorkerPrompt({
issueNumber: 7,
issueTitle: 'x',
issueId: null,
planPath: null,
modelSlug: null,
})
expect(noModel).toContain('composer-2.5')
expect(noModel).toContain('não há plano linkado')
})
})
describe('extractPlanPath', () => {
it('pulls the first docs/plans path from the body', () => {
expect(
extractPlanPath('Plano: [`docs/plans/foo-bar.md`](docs/plans/foo-bar.md)\n\nmais texto'),
).toBe('docs/plans/foo-bar.md')
})
it('returns null when the body has no plan link', () => {
expect(extractPlanPath('spec solta')).toBeNull()
expect(extractPlanPath('')).toBeNull()
})
})