From cb72a9f2ccee4260aebf114ab31df72a28c51195 Mon Sep 17 00:00:00 2001 From: Pessoa Date: Wed, 16 Sep 2026 18:46:52 -0300 Subject: [PATCH] =?UTF-8?q?docs(extensoes):=20nenhum=20link=20aponta=20par?= =?UTF-8?q?a=20a=20pasta=20interna=20de=20decis=C3=B5es?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit `Decisão Implementações/` não é versionada no repositório público, e doze links markdown apontavam para ela — em `triagem/TRIAGEM.md`, `docs/research/extensoes/` e `evidence/extensoes/README.md`. Na branch de trabalho eles resolviam, porque a pasta existe no disco; no PR #1016 viraram 404 para qualquer leitor, e o do `TRIAGEM.md` reprovou o `verify` (`documentacao-aponta-para-o-que-existe`, que vigia só os documentos de autoridade — os outros onze estavam igualmente mortos, sem gate que os visse). Cada link vira citação pelo nome, como a `main` já faz com essa pasta. Na triagem, a citação aponta a régua pública que vale para PR: `docs/doctrine/extensoes.md`. Co-Authored-By: Claude Opus 5 (1M context) --- docs/research/extensoes/08-integracao-bases.md | 4 ++-- docs/research/extensoes/10-integracao-riscos.md | 2 +- docs/research/extensoes/README.md | 12 ++++++------ evidence/extensoes/README.md | 2 +- triagem/TRIAGEM.md | 2 +- 5 files changed, 11 insertions(+), 11 deletions(-) diff --git a/docs/research/extensoes/08-integracao-bases.md b/docs/research/extensoes/08-integracao-bases.md index 627c5fec6..4c33cfa7d 100644 --- a/docs/research/extensoes/08-integracao-bases.md +++ b/docs/research/extensoes/08-integracao-bases.md @@ -6,9 +6,9 @@ ## Contratos aprovados que delimitam o reaproveitamento -O [PROG-017](../../../Decisão%20Implementações/PROG-017%20—%20Extensões%20—%20arquitetura%20e%20contratos.md), §§4–6 e 12, separa catálogo central, artefato local admitido, ativação/configuração da organização e ação autorizada do ator. Catálogo tem aplicação/banco próprios; não recebe contatos/conversas nem executa na VPS. Pacote tem identidade incluindo origem/publicador, versão/digest exatos e contrato do host. Metadado obrigatório desconhecido impede ativação. +O PROG-017 *(documento interno de decisão)*, §§4–6 e 12, separa catálogo central, artefato local admitido, ativação/configuração da organização e ação autorizada do ator. Catálogo tem aplicação/banco próprios; não recebe contatos/conversas nem executa na VPS. Pacote tem identidade incluindo origem/publicador, versão/digest exatos e contrato do host. Metadado obrigatório desconhecido impede ativação. -O [PROG-018](../../../Decisão%20Implementações/PROG-018%20—%20Extensões%20—%20provas%20e%20sequência%20de%20entrega.md), marco 2, exige serviço separado, pacote realmente baixado, instalação/configuração pela tela, uso em A sem efeito em B e desativação/recuperação. O primeiro host pode exigir uma release para introduzir esses contratos; o pacote de prova deve ser publicado depois dessa imagem e instalado sem recompilá-la. +O PROG-018 *(documento interno de decisão)*, marco 2, exige serviço separado, pacote realmente baixado, instalação/configuração pela tela, uso em A sem efeito em B e desativação/recuperação. O primeiro host pode exigir uma release para introduzir esses contratos; o pacote de prova deve ser publicado depois dessa imagem e instalado sem recompilá-la. ## Mapa de reutilização diff --git a/docs/research/extensoes/10-integracao-riscos.md b/docs/research/extensoes/10-integracao-riscos.md index 25484c799..be2323a28 100644 --- a/docs/research/extensoes/10-integracao-riscos.md +++ b/docs/research/extensoes/10-integracao-riscos.md @@ -4,7 +4,7 @@ Escopo: marco 2; pesquisa documental, sem implementação, serviços, testes ou SQL executados. -Autoridade: [PROG-017](<../../../Decisão Implementações/PROG-017 — Extensões — arquitetura e contratos.md>) §§5–6, 9–11 e [PROG-018](<../../../Decisão Implementações/PROG-018 — Extensões — provas e sequência de entrega.md>) marco 2/P0-03, 04, 07, 12, 13/P1-22. AGENTS/CLAUDE lidos; números experimentais anteriores não são prova desta integração. +Autoridade: PROG-017 *(documento interno de decisão)* §§5–6, 9–11 e PROG-018 *(documento interno de decisão)* marco 2/P0-03, 04, 07, 12, 13/P1-22. AGENTS/CLAUDE lidos; números experimentais anteriores não são prova desta integração. ## O que já existe e o que sua evidência permite afirmar diff --git a/docs/research/extensoes/README.md b/docs/research/extensoes/README.md index b76abe241..69d9fbb32 100644 --- a/docs/research/extensoes/README.md +++ b/docs/research/extensoes/README.md @@ -8,10 +8,10 @@ Referência de código: `25edc35b05c8d522e2bfe313863e6003f47b8f56`, obtida de `o | Documento | Conteúdo | |---|---| -| [PROG-016 — Plano e andamento](../../../Decis%C3%A3o%20Implementa%C3%A7%C3%B5es/PROG-016%20%E2%80%94%20Extens%C3%B5es%20%E2%80%94%20plano%20e%20andamento.md) | Contexto, achados, estado da entrega e próximos passos | -| [PROG-017 — Arquitetura e contratos](../../../Decis%C3%A3o%20Implementa%C3%A7%C3%B5es/PROG-017%20%E2%80%94%20Extens%C3%B5es%20%E2%80%94%20arquitetura%20e%20contratos.md) | Síntese das alternativas e desenho recomendado | -| [PROG-018 — Provas e sequência de entrega](../../../Decis%C3%A3o%20Implementa%C3%A7%C3%B5es/PROG-018%20%E2%80%94%20Extens%C3%B5es%20%E2%80%94%20provas%20e%20sequ%C3%AAncia%20de%20entrega.md) | Experimentos de viabilidade e jornadas planejadas em tela | -| [DEC-004 — Publicação, incidentes e métricas](../../../Decis%C3%A3o%20Implementa%C3%A7%C3%B5es/DEC-004%20%E2%80%94%20Extens%C3%B5es%20%E2%80%94%20publica%C3%A7%C3%A3o%2C%20incidentes%20e%20m%C3%A9tricas.md) | Escolhas de produto com alternativas, recomendação e espaço de resposta | +| PROG-016 — Plano e andamento *(documento interno de decisão)* | Contexto, achados, estado da entrega e próximos passos | +| PROG-017 — Arquitetura e contratos *(documento interno de decisão)* | Síntese das alternativas e desenho recomendado | +| PROG-018 — Provas e sequência de entrega *(documento interno de decisão)* | Experimentos de viabilidade e jornadas planejadas em tela | +| DEC-004 — Publicação, incidentes e métricas *(documento interno de decisão)* | Escolhas de produto com alternativas, recomendação e espaço de resposta | ## Três investigações distintas e paralelas @@ -38,11 +38,11 @@ O diagrama da proposta descreve responsabilidades futuras. Ele não foi publicad | [06 — Estado e dados](06-bancada-estado-e-dados.md) | Compatibilidade real de tarefa antiga, RLS da fixture, desativação e anonimização | | [07 — Perfil de contêiner](07-perfil-comparacao-executor.md) | Imagem fixa, rodada Docker real, limites exercitados e comparação delimitada | -O [runbook da bancada](../../../experiments/extensoes/README.md) permite repetir os experimentos em ambiente próprio. O [PROG-020](../../../Decis%C3%A3o%20Implementa%C3%A7%C3%B5es/PROG-020%20%E2%80%94%20Extens%C3%B5es%20%E2%80%94%20resultados%20da%20bancada.md) é a síntese para acompanhar a execução sem ler o código. +O [runbook da bancada](../../../experiments/extensoes/README.md) permite repetir os experimentos em ambiente próprio. O PROG-020 *(documento interno de decisão)* é a síntese para acompanhar a execução sem ler o código. ## Primeira integração ao CRM -A branch `feat/extensoes-declarativas-20260914` preserva a bancada e incorpora `origin/main` em `60079eb5`. O [PROG-021](<../../../Decisão Implementações/PROG-021 — Extensões — primeira integração.md>) acompanha implementação e provas do marco 2. O [contrato v1](../../specs/extensoes-declarativas-v1.md) define o pacote declarativo, admissão e jornada. +A branch `feat/extensoes-declarativas-20260914` preserva a bancada e incorpora `origin/main` em `60079eb5`. O PROG-021 *(documento interno de decisão)* acompanha implementação e provas do marco 2. O [contrato v1](../../specs/extensoes-declarativas-v1.md) define o pacote declarativo, admissão e jornada. | Investigação | Foco desta integração | |---|---| diff --git a/evidence/extensoes/README.md b/evidence/extensoes/README.md index 290f5f9d9..c2be212fc 100644 --- a/evidence/extensoes/README.md +++ b/evidence/extensoes/README.md @@ -2,7 +2,7 @@ Capturas de 14/set/2026, somente dados sintéticos. Extraídas da rodada final de cinco jornadas Playwright em Chromium e inspecionadas pelo agente principal. São provas da interface experimental; não mostram um marketplace ou a jornada de extensões integrada ao CRM. -O navegador iniciou as três provas reais, comparou o resultado exibido com o backend e o arquivo persistido, recarregou a tela e percorreu ambiente ausente, perda de conexão e resposta perdida depois do aceite. A revisão adicional conferiu os controles do processo e a reconciliação da solicitação. Resultados, limites e próximos passos no [PROG-020](../../Decis%C3%A3o%20Implementa%C3%A7%C3%B5es/PROG-020%20%E2%80%94%20Extens%C3%B5es%20%E2%80%94%20resultados%20da%20bancada.md). +O navegador iniciou as três provas reais, comparou o resultado exibido com o backend e o arquivo persistido, recarregou a tela e percorreu ambiente ausente, perda de conexão e resposta perdida depois do aceite. A revisão adicional conferiu os controles do processo e a reconciliação da solicitação. Resultados, limites e próximos passos no PROG-020 *(documento interno de decisão)*. ## Três resultados reais na tela diff --git a/triagem/TRIAGEM.md b/triagem/TRIAGEM.md index 317e95a3a..e3406ad4a 100644 --- a/triagem/TRIAGEM.md +++ b/triagem/TRIAGEM.md @@ -137,7 +137,7 @@ latência que ela existe para matar. Para uma mudança de comportamento, registre o destino e a razão antes da reconciliação. A lei é a [doutrina de extensões](../docs/doctrine/extensoes.md) (item 18 do DoD); o critério foi -aprovado no [PROG-017, seção 2](../Decis%C3%A3o%20Implementa%C3%A7%C3%B5es/PROG-017%20%E2%80%94%20Extens%C3%B5es%20%E2%80%94%20arquitetura%20e%20contratos.md). +aprovado no PROG-017, seção 2 (documento interno de decisão, fora do repositório público; a régua que vale para PR está em [`docs/doctrine/extensoes.md`](../docs/doctrine/extensoes.md)). O núcleo precisa continuar útil com zero extensões; nichos podem acrescentar capacidades sem determinar a operação de todas as instalações.