mirror of
https://github.com/fsolla/teqo.git
synced 2026-11-13 06:43:06 +00:00
b7f4e16c0f
Safety net dual com agent:ready: no merge em main, workflow lê Related #N e promove Issues ainda aguardando plano (canPromotePlanIssue), soft-skip idempotente. Helper parseRelatedIssueNumbers + pins unitários. Co-authored-by: Francisco Solla <fsolla@users.noreply.github.com>
68 lines
2.4 KiB
JavaScript
68 lines
2.4 KiB
JavaScript
/**
|
|
* Plan-issue lifecycle helpers (OPS17 + OPS18): register with `--plan` starts
|
|
* non-claimable; promote to `ready` only after the intention plan is on `main`
|
|
* (agent `pnpm agent:ready` and/or merge Action reading `Related #N`).
|
|
*
|
|
* Pure — no IO. Used by `agent-register` / `agent-ready` / the OPS18 Action
|
|
* script and pinned by unit tests.
|
|
*/
|
|
|
|
import { labelNames } from './agent-github.mjs'
|
|
import { HUMAN_GATE_LABELS, issueHasPlanLink } from './agent-pool-eligibility.mjs'
|
|
|
|
/**
|
|
* Initial state label for a newly registered issue.
|
|
*
|
|
* @param {{ hasPlan: boolean, explicitBlocked?: boolean }} options
|
|
* @returns {'ready' | 'blocked'}
|
|
*/
|
|
export const resolveRegisterStateLabel = ({ hasPlan, explicitBlocked = false }) => {
|
|
if (explicitBlocked || hasPlan) return 'blocked'
|
|
return 'ready'
|
|
}
|
|
|
|
const TERMINAL_OR_ACTIVE = ['in-progress', 'done', 'in-prod']
|
|
|
|
/** `Related #N` only — never closing keywords (those are owned by issue-done). */
|
|
const RELATED_ISSUE_RE = /\brelated\s+#(\d+)\b/gi
|
|
|
|
/**
|
|
* Issue numbers cited as `Related #N` in a PR body (plans-only contract).
|
|
* Deduped, stable first-seen order. Ignores Closes/Fixes/Resolves.
|
|
*
|
|
* @param {string | null | undefined} body
|
|
* @returns {number[]}
|
|
*/
|
|
export const parseRelatedIssueNumbers = (body) => {
|
|
if (!body) return []
|
|
const seen = new Set()
|
|
const numbers = []
|
|
for (const match of body.matchAll(RELATED_ISSUE_RE)) {
|
|
const number = Number(match[1])
|
|
if (seen.has(number)) continue
|
|
seen.add(number)
|
|
numbers.push(number)
|
|
}
|
|
return numbers
|
|
}
|
|
|
|
/**
|
|
* Whether an issue is waiting for its intention plan on `main` and may be
|
|
* flipped `blocked` → `ready` by `agent:ready` (or the OPS18 Action).
|
|
*
|
|
* @param {{ state?: string, body?: string, labels?: Array<{ name: string }> }} issue
|
|
* @returns {{ ok: true } | { ok: false, reason: string }}
|
|
*/
|
|
export const canPromotePlanIssue = (issue) => {
|
|
if ((issue?.state ?? 'OPEN') !== 'OPEN') return { ok: false, reason: 'not-open' }
|
|
const labels = labelNames(issue ?? { labels: [] })
|
|
if (!labels.includes('blocked')) return { ok: false, reason: 'not-blocked' }
|
|
if (TERMINAL_OR_ACTIVE.some((label) => labels.includes(label))) {
|
|
return { ok: false, reason: 'state-label' }
|
|
}
|
|
if (HUMAN_GATE_LABELS.some((label) => labels.includes(label))) {
|
|
return { ok: false, reason: 'needs-human' }
|
|
}
|
|
if (!issueHasPlanLink(issue)) return { ok: false, reason: 'no-plan-link' }
|
|
return { ok: true }
|
|
}
|