fsolla/teqo-backup
1
0
Fork 0
mirror of https://github.com/fsolla/teqo.git synced 2026-11-12 22:13:05 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions

docs(ops): alinhar contrato agent:ready ao canPromotePlanIssue

Browse source
This commit is contained in:
Cursor Agent 2026-08-02 23:12:52 +00:00
parent 9d6f80b464
commit 6773bbb526
No known key found for this signature in database
3 changed files with 7 additions and 4 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

2
.cursor/skills/plan-issue/SKILL.md
View file

@ -160,7 +160,7 @@ Sem `--plan`: nasce `ready` (use `--blocked` só se quiser não-claimável sem p
2. Atualize `Issue: #N` (e status) no plano local.
3. Commit + **`pnpm push`** + PR **Ready** `--base main` com **`Related #N`** (nunca `Closes #N` em PR só de `docs/plans/` — `plans-only-closes`).
4. Auto-merge (`gh pr merge --auto --merge`); espere o merge em `main`.
5. **Promote** com o script (idempotente; só Issues `blocked` + link `docs/plans/`):
5. **Promote** com o script (idempotente se já `ready`; só Issues `blocked` + link `docs/plans/`, sem gates humanos `needs:*` nem `in-progress`/`done`/`in-prod`):
```bash
pnpm agent:ready -- --issue <N[,N…]>

2
docs/plans/plan-issue-lifecycle-ready-impl.md
View file

@ -70,6 +70,8 @@ flowchart LR
- **Label `needs:plan`.**
- **Reescrever `capture-review-debts` para auto-promote** (só nota + defer para OPS18).
- **Rename cosmético `canPromotePlanIssue` → `canMarkPlanIssueReady`** — defer; API estável para OPS18 Action.
- **Hoist `HUMAN_GATE_LABELS` / `issueHasPlanLink` / lista ativa-ou-terminal para módulo neutro** — defer até OPS18 (#296) precisar do mesmo predicado fora de `agent-pool-eligibility` (2 call sites hoje; gatilho = 3º consumidor ou Action dual).
- **Batch `agent:ready` acumular falhas** — defer; v1 fail-fast no primeiro reject não-skip é ok.
## Riscos e mitigação

7
scripts/agent-ready.mjs
View file

@ -5,9 +5,10 @@
* pnpm agent:ready -- --issue 292
* pnpm agent:ready -- --issue 292,293
*
* Fail-closed: only Issues that are open, labeled `blocked`, and link
* `docs/plans/` in the body. Does not promote product-blocked Issues without
* a plan link (those stay for human triage).
* Fail-closed via `canPromotePlanIssue`: open + `blocked` + `docs/plans/` link,
* and not `needs:consent` / `requirements-changed` / `in-progress`|`done`|`in-prod`.
* Idempotent skip when already `ready`. Product-blocked Issues without a plan
* link stay for human triage.
*/
import { dieAgent, gh, ghJson, labelNames, parseArgs, setLabels } from './lib/agent-github.mjs'