Compare commits

..

2 Commits

Author SHA1 Message Date
50c5650228 docs: inventariar merges órfãos Gitea (MAN-136)
Co-authored-by: Cursor <cursoragent@cursor.com>
2026-08-13 13:37:14 -03:00
93b680c172 docs: require Linear issues and auto-ship PRs (#4)
All checks were successful
CI / static (push) Successful in 2m25s
CI / unit (push) Successful in 3m34s
CI / feature (push) Successful in 3m17s
CI / container (push) Successful in 20s
CI / browser (push) Successful in 3m43s
## WHAT

- `AGENTS.md` e `docs/agents/issue-tracker.md`: todo trabalho e todo PR precisam de issue Linear.
- SDLC automático: trabalho feito → testes feitos ou atualizados → pre-commit verde → commit → PR, sem perguntar.
- Templates de PR idênticos no Gitea (`.gitea/PULL_REQUEST_TEMPLATE.md`) e no GitHub (`.github/pull_request_template.md`) com WHAT / WHY / HOW / Linear Issue / Comments.

## WHY

Agentes estavam soltos no tracker e paravam pra perguntar se podiam commitar. O contrato precisa ser o ciclo completo, com issue Linear e template de PR.

## HOW

Docs e templates only. Sem mudança de runtime. Pre-commit (`composer pint:check` + `composer phpstan`) passou.

## Linear Issue

- [MAN-132](https://linear.app/maneco-workspace/issue/MAN-132/exigir-issue-linear-em-todo-trabalho-e-pr)
- [MAN-133](https://linear.app/maneco-workspace/issue/MAN-133/adicionar-pr-template-no-gitea-e-no-github)

## Comments

GitHub é o mirror legado; o PR canônico é este no Gitea.

Reviewed-on: #4
Co-authored-by: manoel freitas <manoel.josefneto@gmail.com>
Co-committed-by: manoel freitas <manoel.josefneto@gmail.com>
2026-08-13 11:46:36 +00:00

View File

@@ -0,0 +1,92 @@
# MAN-136 — Inventário de merges órfãos no Gitea
**Issue:** [MAN-136](https://linear.app/maneco-workspace/issue/MAN-136/research-inventariar-merges-orfaos-no-gitea)
**Branch:** `research/man-136-orphan-gitea-merges`
**HEAD inventariado:** `origin/main` @ `93b680c`
**Data:** 2026-08-13
**Escopo:** inventário only — **não** criar issues Linear retroativas.
## Critério de janela
**Início inclusivo:** commit `84f6d7c` (`ci: migrate GitHub Actions para Gitea Actions`, 2026-08-12).
**Fim:** `HEAD` de `origin/main` (`93b680c`).
Justificativa: primeiro commit que troca CI/registry/docs para Gitea (`git.hellomanoel.com`). Commits anteriores (GitHub PR #5#60 era) ficam fora. A fronteira é o SHA da migração de Actions, não a data de criação do repo Gitea.
## Critério de “issue correspondente”
Um merge/commit **tem** issue Linear correspondente no projeto **Amare — Lançamento MVP** se **qualquer** for verdade:
1. Body/assunto do PR ou commit cita identifier `MAN-xxx` desse projeto; ou
2. Existe issue no projeto cujo título + critérios de aceite descrevem de forma única a mudança shipped (match funcional 1:1).
**Não conta como correspondente:**
- Epic/issue já **Done** antes do merge que “poderia” cobrir trabalho novo (ex.: MAN-102 Done em 2026-08-08 vs remodel `/sobre` em 2026-08-12).
- Issue ampla de copy/arquitetura sem AC específico para o ship (ex.: MAN-97).
- Mencionar “Gitea” só em issues de template (MAN-133) não cobre a migração de CI.
Classificação pedida: **órfão shipped** = chegou em `main` sem issue correspondente. Sem criar tickets.
## Fontes
| Fonte | Uso |
| --- | --- |
| `git log origin/main` (`84f6d7c^..HEAD`) | commits da janela |
| `tea pr list --state all` + API Gitea `/pulls/{1..4}` | PRs Gitea merged |
| Linear `list_issues` project `Amare — Lançamento MVP` (incl. archived) | universo de issues |
## Matriz PRs Gitea #1#4
| PR | Título | Merge SHA | Issue Linear? | Classificação |
| --- | --- | --- | --- | --- |
| [#1](https://git.hellomanoel.com/manoel-freitas/amare/pulls/1) | feat: remodelar `/sobre` conforme mock editorial | `fc1c617` | Nenhuma (sem citação; MAN-102 já Done; sem issue dedicada) | **órfão shipped** |
| [#2](https://git.hellomanoel.com/manoel-freitas/amare/pulls/2) | fix: CTAs de modalidades em `/servicos` via WhatsApp | `e2af1f6` | [MAN-127](https://linear.app/maneco-workspace/issue/MAN-127/ajustar-ctas-consultivos-no-whatsapp-e-briefing-comercial) (Fluxo 1 — CTAs WhatsApp nos cards de modalidade; PR não cita, match por AC) | matched (não órfão) |
| [#3](https://git.hellomanoel.com/manoel-freitas/amare/pulls/3) | fix(about): alinhar layout `/sobre` ao ritmo editorial | `ba38894` | Nenhuma (follow-up de #1; sem citação) | **órfão shipped** |
| [#4](https://git.hellomanoel.com/manoel-freitas/amare/pulls/4) | docs: require Linear issues and auto-ship PRs | `93b680c` | [MAN-132](https://linear.app/maneco-workspace/issue/MAN-132/exigir-issue-linear-em-todo-trabalho-e-pr) + [MAN-133](https://linear.app/maneco-workspace/issue/MAN-133/adicionar-pr-template-no-gitea-e-no-github) (citados no body) | matched (não órfão) |
## Órfãos shipped (tabela canônica)
| Nome descritivo | Evidência | Link |
| --- | --- | --- |
| Remodelar `/sobre` conforme mock editorial | Gitea PR #1 merged | https://git.hellomanoel.com/manoel-freitas/amare/pulls/1 |
| Alinhar layout `/sobre` ao ritmo editorial | Gitea PR #3 merged | https://git.hellomanoel.com/manoel-freitas/amare/pulls/3 |
| Migração CI GitHub → Gitea Actions (+ follow-ups de runner/registry/staging) | 10 commits direct-push em `main`, **sem** PR Gitea | sem PR — ver série abaixo |
### Série vizinha sem PR (direct push)
Todos sem citação `MAN-*` e sem issue de migração Gitea no projeto Amare MVP:
| SHA | Assunto |
| --- | --- |
| `84f6d7c` | ci: migrate GitHub Actions para Gitea Actions |
| `716196d` | fix: owner path manoel-freitas/amare no registry Gitea |
| `1e215ac` | docs: alinhar remotes e registry para Gitea |
| `f730e76` | fix: secrets de registry sem prefixo GITEA_ |
| `1468a23` | fix: remover actions/cache no Gitea Actions |
| `87a0191` | fix: CI Postgres via hostname, sem bind :5432 no host |
| `dd82ca2` | fix: paralelizar CI no act_runner |
| `91c0d41` | fix: nomes únicos para containers CI no docker.sock compartilhado |
| `ac08b5f` | fix: staging deploy via needs no CI, não workflow_run |
| `26a68e1` | fix: restaurar deploy-staging via workflow_run (Gitea ≥1.25) |
Tratados como **um** órfão shipped agregado (mesmo tema ops/CI), não dez tickets potenciais.
## Não-órfãos na janela (referência)
- PR #2 → MAN-127 (parcial; issue ainda Todo no Linear — status Linear ≠ presença de issue).
- PR #4 → MAN-132 + MAN-133.
## Ambiguidades registradas
1. **PR #2 sem citação explícita:** match por AC de MAN-127 (Fluxo 1). Se o inventário MAN-135 exigir citação literal, reclassificar #2 como órfão — este doc **não** faz isso.
2. **`/sobre` vs MAN-97 / MAN-98 / MAN-102:** rejeitado como correspondente (Done prévio ou escopo sem AC de remodel layout).
3. **Merge commits vs squash:** PR #1 landa como `fc1c617` (sem merge commit separado); PR #3 tem merge `ba38894`. Ambos contam como merges shipped.
## Resumo executivo
**3 órfãos shipped** na era pós-migração Gitea:
1. Remodelar `/sobre` — [PR #1](https://git.hellomanoel.com/manoel-freitas/amare/pulls/1)
2. Fix layout `/sobre` — [PR #3](https://git.hellomanoel.com/manoel-freitas/amare/pulls/3)
3. Migração CI/Gitea Actions (+ follow-ups) — direct push, sem PR