teqo-backup/scripts/agent-promote-related-on-merge.mjs
Francisco Solla c90f70aab4 ops(OPS76): tracker de Issues migra do Forgejo para o GitHub — GitHub como host único
Decisão (2026-08-21): o GitHub passa a ser a fonte única — main, branches,
PRs, CI via Actions E tracker de Issues. O Forgejo deixa de ser canal ativo
(git.e issue tracker congelados pós-convergência).

Data: 17 issues migradas do Forgejo para o GitHub (frontmatter id/depends/
serializes/priority/model preservados, labels mapeados, comment de origem
em cada uma; tabela Forgejo→GitHub registrada).

Tooling: github-api.mjs estendido com a camada de issues/labels/comments/
close/workflow-dispatch/contents (mesmo shape normalizado do forgejo-api);
18 scripts trocam o transporte forgejo-api → github-api; forgejo-api.mjs e
seu teste (961 linhas) removidos; teste githubApi.unit.spec.ts novo (7 casos);
issue-transition-on-merge.mjs renomeado e reapontado.

Flips pós-merge: issue-done e plan-issue-ready agora usam o GITHUB_TOKEN com
issues:write no repo (sem FORGEJO_API_TOKEN) e fecham/flipam Issues no GitHub.

Docs: AGENTS.md, AGENT-OPS.md e skills do fluxo vivo (work-issue, plan-issue,
project-status, capture-review-debts, worktree-next-issue, agent-work-issue)
apontam o tracker para github.com/fsolla/teqo/issues.

Gates: tsc/lint/format/knip/cycles/unit 2416 verdes.
2026-08-21 08:19:06 -03:00

78 lines
2.6 KiB
JavaScript

/**
* OPS18 safety net — on PR merge to `main`, promote plan-issue Issues cited as
* `Related #N` from `blocked` → `ready` when they are still awaiting a plan.
*
* Soft-skips ineligible Issues (already ready, product-blocked without a plan
* link, needs:*, etc.). Flip/comment failures for one Issue are logged and do
* not abort siblings. Idempotent with `pnpm agent:ready`.
*
* node scripts/agent-promote-related-on-merge.mjs --pr 123
* PR_BODY='Related #296' node scripts/agent-promote-related-on-merge.mjs --pr 123
*
* Env: GITHUB_TOKEN (the tracker lives on GitHub); optional PR_BODY skips the PR read.
*/
import { dieAgent, parseArgs, setLabels } from './lib/agent-forgejo.mjs'
import { canPromotePlanIssue, parseRelatedIssueNumbers } from './lib/agent-plan-lifecycle.mjs'
import { githubApi as api } from './lib/github-api.mjs'
const die = dieAgent('promote-related')
const { flags } = parseArgs(process.argv.slice(2), new Set(['pr']))
if (!flags.pr || !/^\d+$/.test(String(flags.pr))) {
die('Usage: node scripts/agent-promote-related-on-merge.mjs --pr <N>')
}
const prNumber = Number(flags.pr)
const bodyFromEnv = process.env.PR_BODY
const body =
typeof bodyFromEnv === 'string' ? bodyFromEnv : (await api.getPullRequest(prNumber)).body
const numbers = parseRelatedIssueNumbers(body)
if (numbers.length === 0) {
console.log(`[agent:promote-related] PR #${prNumber}: no Related #N — nothing to do`)
process.exit(0)
}
console.log(
`[agent:promote-related] PR #${prNumber}: Related → ${numbers.map((n) => `#${n}`).join(', ')}`,
)
for (const number of numbers) {
let issue
try {
issue = await api.getIssue(number)
} catch (error) {
console.log(
`[agent:promote-related] #${number}: skip (issue view failed: ${
error instanceof Error ? error.message : String(error)
})`,
)
continue
}
const verdict = canPromotePlanIssue(issue)
if (!verdict.ok) {
if (verdict.reason === 'already-ready') {
console.log(`[agent:promote-related] #${number}: already ready — skip`)
continue
}
console.log(`[agent:promote-related] #${number}: skip (${verdict.reason})`)
continue
}
try {
await setLabels(number, { add: ['ready'], remove: ['blocked'] })
await api.addComment(
number,
`Promovido a \`ready\` via Action OPS18 — plano de intenção em \`main\` (PR #${prNumber} com \`Related #${number}\`).`,
)
console.log(`[agent:promote-related] #${number}: blocked → ready`)
} catch (error) {
console.log(
`[agent:promote-related] #${number}: promote failed (${
error instanceof Error ? error.message : String(error)
})`,
)
}
}