teqo/scripts/agent-claim.mjs
Francisco Ignácio Fontoura Solla f021992de0 ci: main-only cutover with gated Vercel deploy
Remove stage/promote/Neon smoke. PR CI targets main; ci.yml full-suite
verifier deploys via vercel CLI and requeues when HEAD moves. Pool uses
POOL_GITHUB_TOKEN and POOL_BASE_REF=main. Docs/skills/rules retargeted.
2026-07-31 20:57:18 -03:00

124 lines
4.2 KiB
JavaScript

/**
* `pnpm agent:claim` — claim the next trackable issue for this agent run.
*
* Queue: open issues labeled `ready`, filtered to UNBLOCKED (every frontmatter
* `depends` id is closed or labeled `done`/`in-prod`), ordered by `prio:P0..P3`
* then oldest first. `--dry-run` prints the queue without claiming.
*
* Lock otimista: re-reads the issue right before flipping labels, refuses if
* someone else already took it (`in-progress` present / `ready` gone), then
* swaps ready→in-progress and leaves a claim comment with the run timestamp.
*
* Output: the brief on stdout (issue, id, priority, plan/spec body) — the
* agent reads it and starts; it does NOT create the branch (Cursor worktrees
* own that) and it never merges anywhere. PRs go `--base main`.
*/
import {
buildClaimQueue,
dieAgent,
gh,
ghJson,
issuesById,
labelNames,
parseArgs,
parseFrontmatter,
setLabels,
} from './lib/agent-github.mjs'
const die = dieAgent('claim')
const { flags } = parseArgs(process.argv.slice(2), new Set(['issue']))
const openReady = ghJson([
'issue',
'list',
'--state',
'open',
'--label',
'ready',
'--limit',
'200',
'--json',
'number,title,body,labels,createdAt',
])
// Queue builder lives in agent-github.mjs (shared with the agent pool —
// identical ordering/filtering, pinned by agentPoolEligibility.unit.spec.ts).
const queue = buildClaimQueue(openReady, issuesById())
if (flags['dry-run'] || flags['dryrun']) {
console.log(`[agent:claim] ${queue.length} unblocked ready issue(s):`)
for (const entry of queue) {
const model = entry.meta.model ? ` model:${entry.meta.model}` : ''
console.log(` #${entry.issue.number} [${entry.priority}]${model} ${entry.issue.title}`)
}
process.exit(0)
}
const pick = flags.issue
? queue.find((entry) => entry.issue.number === Number(flags.issue))
: queue[0]
if (!pick) {
die(
flags.issue
? `Issue #${flags.issue} is not claimable (missing, not ready, or blocked by deps).`
: 'Nothing to claim — no unblocked issues labeled `ready`. Run with --dry-run to inspect.',
)
}
// Optimistic lock: re-read right before flipping.
const fresh = ghJson(['issue', 'view', String(pick.issue.number), '--json', 'number,labels,state'])
const freshLabels = labelNames(fresh)
if (
fresh.state !== 'OPEN' ||
!freshLabels.includes('ready') ||
freshLabels.includes('in-progress')
) {
die(`Issue #${pick.issue.number} was just claimed or closed by someone else. Re-run claim.`)
}
setLabels(pick.issue.number, { add: ['in-progress'], remove: ['ready'] })
gh([
'issue',
'comment',
String(pick.issue.number),
'--body',
`Claimed by agent run at ${new Date().toISOString()}. Lock otimista: outro claim deve falhar e re-rodar \`pnpm agent:claim\`.`,
])
const { rest } = parseFrontmatter(pick.issue.body)
const issueId = pick.meta.id ?? null
let subject = pick.issue.title
if (issueId) {
const idPrefix = `${issueId} — `
if (subject.startsWith(idPrefix)) subject = subject.slice(idPrefix.length)
}
const sessionTitle = issueId
? `#${pick.issue.number} ${issueId} — ${subject}`
: `#${pick.issue.number} — ${subject}`
console.log(`\n[agent:claim] Claimed #${pick.issue.number} — ${pick.issue.title}`)
console.log(` id: ${issueId ?? '(none)'} priority: ${pick.priority}`)
console.log(` rename_chat: ${sessionTitle.slice(0, 200)}`)
if (pick.meta.model) {
console.log(
` model: ${pick.meta.model} (propriedade da Issue — verificar, não recalcular; ver skill model-selection)`,
)
} else {
console.log(
' model: ausente — aplicar model-selection uma vez e registrar na Issue (gh issue edit)',
)
}
if (pick.satisfiedWithoutIssue.length > 0) {
console.log(
` deps sem issue (roadmap entregue, satisfeitas): ${pick.satisfiedWithoutIssue.join(', ')}`,
)
}
console.log(` url: https://github.com/fsolla/teqo/issues/${pick.issue.number}`)
console.log('\n--- spec ---\n')
console.log(rest.trim() || '(empty body — see linked plan)')
console.log(
'\n[agent:claim] Fluxo: rename_chat (cursor-app-control) → implementar → gate:fast → pnpm push -u origin HEAD → gh pr create --base main (Closes #' +
`${pick.issue.number}) → PARAR. Promote stage→main é automático após CI stage green.`,
)