Skip to content

docs(fechamento): fecha o Registro e conformidade e a fundação do front-end (L19) - #1238

Merged
leandrotcawork merged 3 commits into
mainfrom
feat/conexus-fechamento-registro-fundacao
Nov 22, 2026
Merged

leandrotcawork merged 3 commits into
mainfrom
feat/conexus-fechamento-registro-fundacao

Conversation

@leandrotcawork

@leandrotcawork leandrotcawork commented Nov 22, 2026 •

Copy link
Copy Markdown
Collaborator

Why

Fecha as duas etapas em construção pela L19: o Registro e conformidade (trilha Dados) e a fundação do front-end (trilha Agentes e Apps). O fundador publicou a v0.24.109 em 2026-11-22 e usou as duas na nuvem. Na manhã de 2026-11-22, à ordem proposta (os dois fechamentos primeiro, depois o PR de método #1230, depois os cartões 1228, 1229 e 1231), respondeu "Aprovo".

As linhas de uso e de fechamento nos arquivos de aprovação (docs/approvals/registro-e-conformidade.md e docs/approvals/fundacao-do-front-end.md) entram pelo firstmate, num commit dele neste pull request. Este PR não escreve em docs/approvals/.

What changed

Só documentos, no molde do fechamento 8bddeb3a.

  • Os dois cartões apagados. Estão no histórico do main: o Registro no commit 07aa2924, a fundação no 8030631f, os últimos que os mudaram.
  • O roteiro e as trilhas. docs/roadmap.md, docs/steps/trilhas/dados.md e docs/steps/trilhas/agentes-e-apps.md dão as duas etapas como fechadas. Na Dados segue a etapa 1 do lago, O lago da empresa nasce e some (o cartão em rascunho em docs(lago): o cartão da etapa 1, o lago da empresa nasce e some #1231). Na Agentes e Apps segue A Prévia (o cartão em rascunho em docs(previa): o cartão de A Prévia em endereço próprio #1229). O texto desses cartões não entra aqui.
  • Os links ao cartão apagado. As notas das partes 3 e 4 da spec dos dados apontavam para o cartão do Registro. Agora apontam para o commit dele. No mapa das telas (docs/explanation/mapa.md), o Registro de dados passa de "o que vem" para "o que existe hoje", no grupo da empresa, depois de Papéis.

A L19, item por item

Os critérios, conferidos contra o main (4d143a99)

Para cada critério, o arquivo do teste e o título foram procurados no main. Os que diferem do cartão:

Registro e conformidade. Todos os critérios de G1, G3, G4 e G5 têm teste. Cinco mudaram de lugar ou de nome:

  • Critério 9: o caso se chama "dependency-cruiser recusa data-read-only-through-the-recorder em …/hub/data/other.ts", gerado pela lista BAD de scripts/rules-doors.test.ts. O nome do cartão era "só o gravador escreve no Registro".
  • Critério 54: o lugar "projeto" roda em apps/server/src/hub/data/conformance-project.test.ts, separado de conformance.test.ts, porque o runner dá 120 s por arquivo.
  • Critérios 74 e 82: os casos "a exportação para em 5.000" e "a exportação leva no máximo 31 dias" ficam em apps/server/src/hub/data/reads-export.test.ts, não em reads.test.ts.
  • Critério 80: o caso está em apps/web/src/hub/data/csv.test.tsx, não em csv.test.ts.
  • Critério 105: o corte em 4.000 é feito na borda, e o caso "a consulta longa é cortada" está em apps/edge/src/db.test.ts, não em read-notice.test.ts.

Fundação do front-end. Os critérios 1 a 23 e 26 existem. Dois mudaram de arquivo:

  • Critérios 6 e 7: os casos "toda peça de ui/ tem entrada na vitrine" e "a vitrine sob a política do Hub" estão em apps/web/showcase.layout.test.ts, não em pieces.layout.test.ts.

O caso de 708 (critério 15) está em agent-list.test.tsx, e os dois de 705 (critério 18), em agents.layout.test.ts.

Os critérios 24 e 25 (U6, a regra "peça antes de tela") entram neste PR, como o cartão mandava. A L20 deixa guia e skill mudarem no fechamento da etapa, e o method-freeze aceita: "no step in construction, the method may change". Commit ccb4f336:

  • Critério 24. docs/guides/design.md ganha a V62, "Piece before screen". Antes de escrever uma tela, o autor procura a peça em apps/web/src/ui/ e na vitrine (/pieces). Uma peça de aparência nasce só em ui/, de fonte nativa (W21), com a sua entrada na vitrine e a sua linha no DESIGN.md, no mesmo commit da tela que a usa. A falha que a regra evita é o seletor de Projeto (a mesma escolha cinco vezes, com quatro peças, em 14 dias). O passo da regra entrou em:
    • conexus-build, passo 2a;
    • conexus-review, passo 6, e references/screen.md, onde a peça refeita fora de ui/, ou nova sem vitrine e sem DESIGN.md, é achado;
    • conexus-scope, passo 5, e os modelos references/card.md, references/screens.md e references/pattern-card.md;
    • conexus-qa, passo 5, que captura a vitrine nos dois temas.
  • Critério 25. V3 nomeia shadcn/no-raw-colors, e V16 e V22 nomeiam shadcn/no-arbitrary-values, em aviso sob a catraca. O "review" fica, porque o lint não prova a grade de 4 px da V16 nem as sombras da V3.
  • Os tetos de palavras. Cada skill fica no teto trocando palavras que não mudam o que o agente faz. Em conexus-build, sai "A ruling not in the card is not built.", que o "Stop and ask" já diz. Em conexus-review, sai "Record reads and commit;", que o modelo do veredito já pede. Contagens: build 593, review 598, scope 599 e qa 600 (teto 600); card.md 1.497 (teto 1.500); o guia de design 2.186 (teto 2.500).

A #1236, aberta antes desta correção, foi fechada apontando para este PR.

As linhas remendo

Nenhuma das duas tabelas de referência tem linha remendo: todas as linhas são nativo ou embrulhado. As tabelas das correções da entrada do app (PRs 1213 e 1214) também não têm. Nada entra em docs/reference/boundaries.md.

A lista de Fechamento

As revisões dos PRs 1213, 1214, 1223 e 1227, e as do G1, G2 e G3 da fundação:

De onde Item Como ficou
1213 Fechamento 1: o comentário de apps/edge/src/dispatcher-tab.test.ts:7-9 Feito no main pela #1227. O texto é o que a revisão sugeriu
1213 Nit: appSessionCookies('', place) em dispatch.ts passa um place que o apagar ignora Issue #1234, item 6. A mudança é no código de produção, então não é um comentário de teste nem um nome
1214 Fechamentos 1 e 2: o veredito e o pin da vibesdk na tabela Feitos no corpo do 1214 (embrulhado, @ 9da158d8)
1214 Nit 4: rounds vale sempre 2 Fica como está, como a revisão recomendou: o campo atende ao texto da decisão 3.B e não custa nada
1214 Nit 5: nenhum teste leva a Prévia pela entrada nova Comentado na issue que já existia, #358 (sem teste de ponta a ponta da entrada da Prévia)
1223 Achado 1: o tipo, a sequência e o INTO deixam ver a tabela Na #1226 (etapa 3 do lago), pelo "1 B" do fundador
1223 Fechamentos 2, 3 e 5: o escopo da CTE, o mutante que sobrevive e localStamp #1234, itens 1, 2 e 5
1223 Fechamento 4: os três textos que prometem mais Feito pela 1227
1227 Fechamentos 1 e 2: o comentário de statementVerdict e o doc de DataSources.query #1234, itens 3 e 4. São comentários de produção. A frase do cartão saiu com ele
G1 (1177) Fechamentos 3 a 5 Feitos no 1177 (conferência 1)
G2 (1186) A guarda item-press, o maxLength sem teste, o popup e o rótulo a 390 px, a sentinela loaded, o nome do Spinner, o lc_ctype #1235, itens 1 a 6
G3 (1195) Fechamentos 2 a 4 Feitos no 1195. A dívida das tarefas, do plano e da aprovação, que seguem o Mastra e não a receita Trace, está na #1235, item 7
1202 Fechamentos 1 e 2 Feitos no main (96cbae37)
Cartão do Registro A dívida "duas linhas por ato", que o cartão mandava para a seção 11 da arquitetura #1237. docs/architecture.md está no teto de 2.500 palavras, e o fechamento não apaga outra linha para ela caber

As Issues futuras, com o rótulo next-card

Os itens que as etapas levaram

Fechadas, com o teste que prova cada uma:

A #1181 já dizia, desde o fechamento do Registro, o que foi feito e o que segue aberto. A #709 e a #706, que o cartão da fundação deixou esperando, seguem abertas.

Scope

São só documentos: os dois cartões, o roteiro, as duas trilhas, as notas da spec dos dados, o mapa das telas e a U6 da fundação. A U6 é a design V62, as marcas de V3, V16 e V22 e o passo da regra em conexus-build, conexus-review, conexus-scope e conexus-qa. docs/approvals/ não muda, e nenhum código muda: os Fechamentos que pedem código estão nas issues acima.

Verification

  • npm run docs: 233 documentos ok. O roteiro fica em 1.600 palavras, o mesmo teto de antes.
  • method-freeze com a U6: "no step in construction, the method may change". O guia e as skills mudam no fechamento da etapa dona (L20).
  • second-card: "one card per track". approval: "no card of a track this change affects". method-freeze: "no step in construction, the method may change". boundaries: "pins match the lockfile".
  • A conferência dos critérios usou um script fora do repositório, que procura no main o arquivo e o título de cada linha do cartão. As diferenças estão listadas acima.
  • Não provado aqui: npm run check inteiro. O check:workflows precisa de Docker, que este ambiente não tem, e nenhum workflow mudou.

Generated by Claude Code

reviewer added 2 commits November 22, 2026 10:33
…nt-end (L19)

Os dois cartões apagados (estão no histórico do main, nos commits 07aa292 e 8030631, os últimos
que os mudaram), o roteiro e as duas trilhas com as etapas fechadas: na Dados segue a etapa 1 do
lago, O lago da empresa nasce e some (cartão em rascunho no PR 1231); na Agentes e Apps, A Prévia
(cartão em rascunho no PR 1229). As notas da spec dos dados e o mapa das telas deixam de apontar para
o cartão apagado, e o Registro de dados passa a "o que existe hoje" no mapa.

A U6 da fundação (a regra "peça antes de tela" no guia de design e nas skills) não entra aqui: só
um pull request de método muda guia e skill (L20). As linhas de uso e de fechamento nos arquivos de
aprovação entram pelo firstmate, num commit dele.
…, L20)

A design V62: antes de escrever uma tela, procure a peça em `ui/` e na vitrine; uma peça de
aparência nasce só em `ui/`, de fonte nativa (W21), com a entrada na vitrine e a linha no
DESIGN.md, no commit da tela que a usa. V3, V16 e V22 nomeiam o que o lint de design cobre delas,
em aviso sob a catraca, sem tirar o "review" (critérios 24 e 25 do cartão, no commit 8030631).

O passo da regra em conexus-build (2a), conexus-review (6, e a referência de tela),
conexus-scope (5, o modelo do cartão, o de tela e o da trilha de molde) e conexus-qa (5, a vitrine
nos dois temas), trocando palavras para cada arquivo ficar no seu teto. A página da trilha Agentes
e Apps diz que a U6 entrou.
@leandrotcawork
leandrotcawork marked this pull request as ready for review November 22, 2026 10:48
@chatgpt-codex-connector

Copy link
Copy Markdown
Codex Review Summary: ❌ Failed

This comment shows the latest Codex review activity on this pull request.

Review Status Commit Review trigger
📝 Code Review ❌ Failed 2026-11-22T10:49:00.134759Z
We couldn’t complete this review. Comment @codex review to try again.
f21296d Draft marked ready
ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.

@chatgpt-codex-connector

Copy link
Copy Markdown

You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard.
To continue using code reviews, you can upgrade your account or add credits to your account and enable them for code reviews in your settings.

@leandrotcawork
leandrotcawork merged commit ee27ac5 into main Nov 22, 2026
27 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants