Claim extraído para scripts/lib/agent-github.mjs (claimIssue/claimBriefLines/ claimQueueEntry/claimTargetVerdict), agent-claim.mjs vira CLI fino com mesma saída; branch validada antes do claim (sem claim órfão); hint de falha pós-claim; guard -B contra reset de commits de sessão; diretiva launch com prompt citado + tokenização xargs no worktree.sh; --issue sem valor/posicional morrem com motivo (sem misclaim); unit novos (directive com issueNumber, claimQueueEntry, claimTargetVerdict); docs/textos (AGENTS.md, /worktree, skill worktree-next-issue, AGENT-OPS, CHANGELOG).
77 lines
2.6 KiB
JavaScript
77 lines
2.6 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,
|
|
claimBriefLines,
|
|
claimIssue,
|
|
dieAgent,
|
|
ghJson,
|
|
issuesById,
|
|
parseArgs,
|
|
} 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',
|
|
// Include `state` for parity with the pool queue (isAutonomousClaimable).
|
|
'--json',
|
|
'number,title,body,labels,createdAt,state',
|
|
])
|
|
|
|
// 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 (shared with `worktree next`).
|
|
claimIssue(pick, die)
|
|
|
|
console.log(`\n[agent:claim] Claimed #${pick.issue.number} — ${pick.issue.title}`)
|
|
for (const line of claimBriefLines(pick)) console.log(line)
|
|
console.log(
|
|
'\n[agent:claim] Fluxo: claim feito fora da sessão → abra a sessão de trabalho no worktree (skill `work-issue`, humano; no pool, o prompt do worker aponta `agent-work-issue`) → gates → PR Ready --base main (Closes #' +
|
|
`${pick.issue.number}) → auto-merge.`,
|
|
)
|