feat: add protocol compatibility diagnostics and historical readers

This commit is contained in:
2026-11-16 10:13:05 +00:00
parent a8a8faf5d8
commit f10c237d44
48 changed files with 1382 additions and 13 deletions
+1 -1
View File
@@ -1,3 +1,3 @@
---
schemaVersion: 2
lastWork: "0002"
lastWork: "0003"
@@ -0,0 +1,11 @@
---
schemaVersion: 1
id: "ART-0001"
workId: "WRK-0003"
origin: "aie-compatibility-implementation.txt"
purpose: "Implementação e verificações preliminares do diagnóstico de compatibilidade"
path: "artifacts/evidence/ART-0001/payload"
sha256: "b009a496b049ae875075fd6ca250042b10a0d41448e9e80f0d03a49a3e72559a"
size: 1312
author: "agent"
createdAt: "2026-11-16T10:03:20.899471Z"
@@ -0,0 +1,11 @@
WRK-0003 — implementação de compatibilidade
Autorização: instrução explícita do usuário nesta sessão para criar a infraestrutura, sem migrar zelda-1 nem Works COMPLETED existentes.
Implementado: protocolVersion independente de schemaVersion; catálogo de formatos com versões de leitura/escrita; project compatibility e resumo em status; leitura dos arquivos correntes, revisões e recibos AIE; diagnóstico de campos opcionais legados; recusa de sobrescrever contratos futuros.
Verificado: ./gradlew test --tests '*CompatibilityTest' --console=plain passou com 8 testes antes de acrescentar o caso de recibos; testes OperationalSafetyTest, ProtocolIntegrationTest e ArchitectureTest também passaram. A regressão completa com o caso adicional de recibos está em execução.
CLI empacotada (JAR): project compatibility no AIE inspecionou 233 registros, incluindo 1 recibo; zelda-1 inspecionou 12 registros. Ambos retornaram LEGACY_COMPATIBLE, readable=true e migrationRequired=false, exit 0. Saídas completas temporárias: /tmp/aie-compatibility-project.json e /tmp/aie-compatibility-zelda.json.
Preservação: comparação SHA-256 de 302 arquivos em WRK-0001, WRK-0002 e .ai-engineering do zelda-1 confirmou igualdade byte a byte. Nenhum comando de migração foi executado nesses projetos.
@@ -0,0 +1,12 @@
---
schemaVersion: 1
id: "ART-0002"
workId: "WRK-0003"
origin: "aie-compatibility-final-verification.txt"
purpose: "Regressão, native smoke, diagnóstico real e preservação histórica da infraestrutura\
\ de compatibilidade"
path: "artifacts/evidence/ART-0002/payload"
sha256: "3867d205c335fbb53420d4a4634190dbba0b15e6521d9978e9ec098f14bdc4ab"
size: 6694
author: "agent"
createdAt: "2026-11-16T10:11:26.059225Z"
@@ -0,0 +1,53 @@
WRK-0003 — evidência final de compatibilidade
Escopo entregue: revisão do contrato independente do schema do manifesto, catálogo de versões de leitura/escrita, diagnóstico público project compatibility, resumo em status, inspeção de revisões e recibos de conclusão, bloqueio de contratos futuros, documentação pública e instalada, fixture histórica congelada.
Não há migração obrigatória registrada. Nenhuma migração ou reabertura dos Works COMPLETED existentes ou do piloto zelda-1 foi executada. Onboard atualizou somente .ai-engineering/README.md e protocol.json no AIE, com backups.
Verificação executada:
- ./gradlew test nativeCompile --console=plain: a etapa test passou (126 testes, 20 suites, zero falhas/erros/skips); a etapa nativeCompile falhou porque o JDK padrão não contém native-image.
- JAVA_HOME=/Users/niltonconstantino/.sdkman/candidates/java/25.5.5.0+3-graalce GRAALVM_HOME=/Users/niltonconstantino/.sdkman/candidates/java/25.5.5.0+3-graalce ./gradlew nativeCompile --console=plain: BUILD SUCCESSFUL.
- bash scripts/native-smoke.sh /Users/niltonconstantino/personal/workspace.personal/my-projects/ai-engineering/build/native/nativeCompile/ai-engineering: exit 0 fora do sandbox, incluindo novos cenários de compatibilidade, recusa de downgrade, preservação de legado e todos os cenários anteriores. A tentativa inicial dentro do sandbox parou por sysctl bloqueado.
- Native aie project compatibility no AIE após onboard: CURRENT, readable=true, migrationRequired=false.
- Native aie --project <zelda-1> project compatibility: LEGACY_COMPATIBLE, readable=true, migrationRequired=false.
- Native aie work context WRK-0001 e WRK-0002: COMPLETED, origens de conclusão HUMAN e SYSTEM_PLANS preservadas.
- Comparação SHA-256 de todos os 302 arquivos previamente capturados em WRK-0001, WRK-0002 e .ai-engineering do zelda-1: nenhuma diferença.
- aie project validate: valid=true, issues=[]. git diff --check: sem erros.
A fixture congelada valida leitura de formato antigo, aprovação histórica, evidência, hash de escopo e preservação byte a byte, incluindo após onboard. O diagnóstico diferencia compatibilidade de formato de integridade e prontidão para conclusão; versões desconhecidas não geram uma rota de conversão inventada.
As primeiras revisões do plano usaram defaults de autoria da CLI; DSC-0002 esclarece que os comandos foram executados pelo agente, sem aprovação humana de entrega. A autorização explícita de implementação consta em DSC-0001.
Hashes dos arquivos de implementação, documentação e testes:
1c5f0a918cfb7d8dc89bde1b48b56faf5a4ace62ea1601d3ba11918a8c517f4e .ai-engineering/README.md
5895627eff101f7073cf7aae128a2c621d3bc2351b5cedd703add7dda65f8aa4 .ai-engineering/protocol.json
0414345b72827bbb0a89bc1bc4bc5210204daeaeebb1806f8657d6424c45675a README.md
924a05809dacdc111137b30cf4bb1acacd389fa88740e2a8d1b08caa98343ecb docs/architecture.md
ecc2e98adcb1b2e4a2bee00bf9d80d4981b5b1fae21588f341f4d07cfbfa63cf docs/compatibility.md
cfc5d6df8d08632498deb2d6b7dd8834100aeb5394ce8d3c14cb069ceeed1434 docs/protocol.md
b81cf3da88ab73537770d5649f8b8213cbffbe1c1dbc275b0e899c16940c57ad scripts/native-smoke.sh
f3433769c0a1205f37fc827be8f9449674b6a8ef902db2d705530bbac23e5ecb src/main/java/net/intrepid/aiengineering/NativeHints.java
58f80360833bbbf780a6b3db250cbe4b85569fbf129a06723149608ad7288e55 src/main/java/net/intrepid/aiengineering/cli/EngineeringCli.java
eec862917985131f2f1da60395ab214faa117709d6ada29191977f73cc89b9c4 src/main/java/net/intrepid/aiengineering/filesystem/Documents.java
42dd90682874adc0a041ab6d8800a9fd850cafbd816e21bff96e999cf1f2f1f2 src/main/java/net/intrepid/aiengineering/filesystem/FormatVersions.java
494bd3d84c98a2533470bbeccfa1ba0ba1561d8a7b8be4d9a78132b9d0a4534a src/main/java/net/intrepid/aiengineering/filesystem/ProtocolException.java
ab31106f9355e44c370a3c0bdef44abc571c0a18ad65e1132c40e547c6207923 src/main/java/net/intrepid/aiengineering/project/ProtocolContract.java
5e6865eaeff6764796086c47fc19e248cf0256a7836869790db9c4ae11e896de src/main/java/net/intrepid/aiengineering/project/ProtocolGuide.java
e1f397714b9724f08169e896b31f0cd7226acbe07a1a8dd96e118173e29eb964 src/main/java/net/intrepid/aiengineering/verification/CompatibilityService.java
5655d1994c1deb48c858fb6d0d5ad9a9bdc5994e1ac123209323570680c0d8de src/main/java/net/intrepid/aiengineering/verification/VerificationService.java
1c5f0a918cfb7d8dc89bde1b48b56faf5a4ace62ea1601d3ba11918a8c517f4e src/main/resources/protocol/README.md
5895627eff101f7073cf7aae128a2c621d3bc2351b5cedd703add7dda65f8aa4 src/main/resources/protocol/protocol.json
85155d8a8e611fbe5a03638cb34747192b1d84179cb9facb53ad38b7e282eec4 src/test/java/net/intrepid/aiengineering/CompatibilityTest.java
bd83ae325eeccfbe49ee8d7453d773738592233f8d56e0595d66fc5e47724fa6 src/test/java/net/intrepid/aiengineering/ProtocolIntegrationTest.java
b5eab70fb460ad5f769828e84bb9f5c4a3a0da64423d4f779be80b5592bbb9be src/test/resources/compatibility/README.md
d9bdcf54dd002d7846a5f8fb214a93318258731838060b05f394e122d2c2677c src/test/resources/compatibility/baseline-v1/.ai-engineering/ai-engineering.yaml
a6090a1059dcc47e647bdf626edaae745250f6ceeebacfa4c8d47be3047f8ac9 src/test/resources/compatibility/baseline-v1/.ai-engineering/protocol.json
b9140d7534a25e61459751f2180416c398a3fcf11eadc4cce777018584ac4580 src/test/resources/compatibility/baseline-v1/.ai-engineering/works/.sequence.yaml
f7752c7e6568ef105d914564624ffb1f3382d1c066c8415377f400e2859177d1 src/test/resources/compatibility/baseline-v1/.ai-engineering/works/WRK-0001-delivered-baseline/artifacts/evidence/ART-0001/artifact.yaml
98545564d0747210b91b933bf8554c4b7e36ba878e6662cb48156b08ff74e1ee src/test/resources/compatibility/baseline-v1/.ai-engineering/works/WRK-0001-delivered-baseline/artifacts/evidence/ART-0001/payload
545dc8e36da222fdeaf9458f77880bf2d1842738b82bac5296cddf62452a7e01 src/test/resources/compatibility/baseline-v1/.ai-engineering/works/WRK-0001-delivered-baseline/decisions/.history/DEC-0001/r0001.md
e3446e03b4a29f9c9b825806628663cfd1256c5063efcaddd6752a1ba50fed8e src/test/resources/compatibility/baseline-v1/.ai-engineering/works/WRK-0001-delivered-baseline/decisions/DEC-0001.md
413a5c7eb3b5fbefb48c87fa178902b0fbd619b266100547cc9059441f26c38e src/test/resources/compatibility/baseline-v1/.ai-engineering/works/WRK-0001-delivered-baseline/discussions/DSC-0001.md
9370531b72d488d2494b455483fe2a413473fde7ffa0f2e539b165e733c3ef27 src/test/resources/compatibility/baseline-v1/.ai-engineering/works/WRK-0001-delivered-baseline/work.md
Executável nativo SHA-256: 858507824ae8705e2c50bc06bcde838524392167d3d1ad6341e3eebb0c8ae167
@@ -0,0 +1,12 @@
---
schemaVersion: 1
id: "ART-0003"
workId: "WRK-0003"
origin: "ai-engineering:plans:26fd692ddba3509e88d031446d441a0849848d20b98b094c08f045c9c25f3027"
purpose: "Deterministic aggregation of completed Plans and reviewed cancellations;\
\ not semantic verification of prose criteria"
path: "artifacts/evidence/ART-0003/payload"
sha256: "26fd692ddba3509e88d031446d441a0849848d20b98b094c08f045c9c25f3027"
size: 283
author: "system:plans"
createdAt: "2026-11-16T10:11:35.942748Z"
@@ -0,0 +1,10 @@
{
"schemaVersion" : 1,
"workId" : "WRK-0003",
"inputHash" : "e48d3536a51a54b72c10790ad264ef2a0f50bddced889d4ed8851d71900eec8b",
"plans" : [ {
"id" : "PLN-0001",
"revision" : 8,
"sha256" : "e8097dd6e269a82a3993aba3151e1ccc5aee29e835e00271c45e2ea78f152644"
} ]
}
@@ -0,0 +1,13 @@
---
schemaVersion: 1
id: "DSC-0001"
workId: "WRK-0003"
discussionId: "main"
kind: "NOTE"
author: "agent"
createdAt: "2026-11-16T09:50:02.422633Z"
respondsTo: null
documentVersion: 2
---
Autorização explícita do usuário nesta sessão: criar a infraestrutura de compatibilidade mesmo sem migração necessária; zelda1 é piloto e não precisa ser migrado; Works COMPLETED existentes devem permanecer intactos e continuar legíveis e interpretáveis em versões posteriores. A execução limita-se ao AIE e a fixtures descartáveis. Esta autorização não atesta aprovação de entrega.
@@ -0,0 +1,13 @@
---
schemaVersion: 1
id: "DSC-0002"
workId: "WRK-0003"
discussionId: "main"
kind: "NOTE"
author: "agent"
createdAt: "2026-11-16T10:10:18.057321Z"
respondsTo: null
documentVersion: 2
---
Rastreabilidade de autoria: o agente criou o Plano e seus passos. author/updatedBy=human nas primeiras revisões resultou dos valores padrão da CLI, não de uma nova manifestação humana. A autorização explícita de implementação está registrada em DSC-0001; nenhuma aprovação humana de entrega foi atestada.
@@ -0,0 +1,19 @@
---
schemaVersion: 1
id: "PLN-0001"
workId: "WRK-0003"
title: "Diagnóstico público e leitura histórica sem migração"
decisions: []
steps: []
status: "OPEN"
author: "human"
createdAt: "2026-11-16T09:50:02.714336Z"
revision: 1
previousHash: null
updatedAt: "2026-11-16T09:50:02.714336Z"
updatedBy: "human"
changeReason: "Plan created"
documentVersion: 2
---
Adicionar contrato versionado e catálogo de formatos; expor diagnóstico somente leitura na CLI; documentar política de evolução; testar registros históricos e versões não suportadas, executar regressão e verificar preservação dos Works concluídos.
@@ -0,0 +1,30 @@
---
schemaVersion: 1
id: "PLN-0001"
workId: "WRK-0003"
title: "Diagnóstico público e leitura histórica sem migração"
decisions: []
steps:
- id: "TSK-0001"
title: "Implementar contrato e diagnóstico de compatibilidade"
description: ""
acceptanceCriteria:
- "Comando público distingue contrato, formatos, legado legível e versões não suportadas\
\ sem escrita."
dependsOn: []
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-16T09:50:03.355683Z"
status: "OPEN"
author: "human"
createdAt: "2026-11-16T09:50:02.714336Z"
revision: 2
previousHash: "f126c370a4b5e225ed8296563c3d2cfb19c313a3079b8ddec1e32196e446ed95"
updatedAt: "2026-11-16T09:50:03.355969Z"
updatedBy: "human"
changeReason: "Step added"
documentVersion: 2
---
Adicionar contrato versionado e catálogo de formatos; expor diagnóstico somente leitura na CLI; documentar política de evolução; testar registros históricos e versões não suportadas, executar regressão e verificar preservação dos Works concluídos.
@@ -0,0 +1,42 @@
---
schemaVersion: 1
id: "PLN-0001"
workId: "WRK-0003"
title: "Diagnóstico público e leitura histórica sem migração"
decisions: []
steps:
- id: "TSK-0001"
title: "Implementar contrato e diagnóstico de compatibilidade"
description: ""
acceptanceCriteria:
- "Comando público distingue contrato, formatos, legado legível e versões não suportadas\
\ sem escrita."
dependsOn: []
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-16T09:50:03.355683Z"
- id: "TSK-0002"
title: "Documentar e verificar continuidade histórica"
description: ""
acceptanceCriteria:
- "Testes e CLI empacotada preservam registros concluídos e documentam evolução;\
\ regressão passa."
dependsOn:
- "TSK-0001"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-16T09:50:04.057668Z"
status: "OPEN"
author: "human"
createdAt: "2026-11-16T09:50:02.714336Z"
revision: 3
previousHash: "9cc57268b41a4a8725f6a5f6df714c430b10dcd4d6d3dcca5c0298477fad7f60"
updatedAt: "2026-11-16T09:50:04.057691Z"
updatedBy: "human"
changeReason: "Step added"
documentVersion: 2
---
Adicionar contrato versionado e catálogo de formatos; expor diagnóstico somente leitura na CLI; documentar política de evolução; testar registros históricos e versões não suportadas, executar regressão e verificar preservação dos Works concluídos.
@@ -0,0 +1,42 @@
---
schemaVersion: 1
id: "PLN-0001"
workId: "WRK-0003"
title: "Diagnóstico público e leitura histórica sem migração"
decisions: []
steps:
- id: "TSK-0001"
title: "Implementar contrato e diagnóstico de compatibilidade"
description: ""
acceptanceCriteria:
- "Comando público distingue contrato, formatos, legado legível e versões não suportadas\
\ sem escrita."
dependsOn: []
status: "ACTIVE"
result: "Implementação autorizada explicitamente pelo usuário."
evidence: []
updatedAt: "2026-11-16T09:50:04.828478Z"
- id: "TSK-0002"
title: "Documentar e verificar continuidade histórica"
description: ""
acceptanceCriteria:
- "Testes e CLI empacotada preservam registros concluídos e documentam evolução;\
\ regressão passa."
dependsOn:
- "TSK-0001"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-16T09:50:04.057668Z"
status: "ACTIVE"
author: "human"
createdAt: "2026-11-16T09:50:02.714336Z"
revision: 4
previousHash: "f864d25e997a60b9178bbd4e180b041f8d1c0a41f5efcb3a9338c17667fabc23"
updatedAt: "2026-11-16T09:50:04.828509Z"
updatedBy: "agent"
changeReason: "Implementação autorizada explicitamente pelo usuário."
documentVersion: 2
---
Adicionar contrato versionado e catálogo de formatos; expor diagnóstico somente leitura na CLI; documentar política de evolução; testar registros históricos e versões não suportadas, executar regressão e verificar preservação dos Works concluídos.
@@ -0,0 +1,45 @@
---
schemaVersion: 1
id: "PLN-0001"
workId: "WRK-0003"
title: "Diagnóstico público e leitura histórica sem migração"
decisions: []
steps:
- id: "TSK-0001"
title: "Implementar contrato e diagnóstico de compatibilidade"
description: ""
acceptanceCriteria:
- "Comando público distingue contrato, formatos, legado legível e versões não suportadas\
\ sem escrita."
dependsOn: []
status: "COMPLETED"
result: "Contrato, catálogo, diagnóstico público e leitura de legado implementados;\
\ testes focados e inspeção dos dois projetos passaram."
evidence:
- "ART-0001"
updatedAt: "2026-11-16T10:03:26.080558Z"
- id: "TSK-0002"
title: "Documentar e verificar continuidade histórica"
description: ""
acceptanceCriteria:
- "Testes e CLI empacotada preservam registros concluídos e documentam evolução;\
\ regressão passa."
dependsOn:
- "TSK-0001"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-16T09:50:04.057668Z"
status: "ACTIVE"
author: "human"
createdAt: "2026-11-16T09:50:02.714336Z"
revision: 5
previousHash: "4dbc5e8ce2fbc59aaa82f9cbddee547a76e3fd7abc809a47f3dfb1a3465d4fc4"
updatedAt: "2026-11-16T10:03:26.080586Z"
updatedBy: "agent"
changeReason: "Contrato, catálogo, diagnóstico público e leitura de legado implementados;\
\ testes focados e inspeção dos dois projetos passaram."
documentVersion: 2
---
Adicionar contrato versionado e catálogo de formatos; expor diagnóstico somente leitura na CLI; documentar política de evolução; testar registros históricos e versões não suportadas, executar regressão e verificar preservação dos Works concluídos.
@@ -0,0 +1,46 @@
---
schemaVersion: 1
id: "PLN-0001"
workId: "WRK-0003"
title: "Diagnóstico público e leitura histórica sem migração"
decisions: []
steps:
- id: "TSK-0001"
title: "Implementar contrato e diagnóstico de compatibilidade"
description: ""
acceptanceCriteria:
- "Comando público distingue contrato, formatos, legado legível e versões não suportadas\
\ sem escrita."
dependsOn: []
status: "COMPLETED"
result: "Contrato, catálogo, diagnóstico público e leitura de legado implementados;\
\ testes focados e inspeção dos dois projetos passaram."
evidence:
- "ART-0001"
updatedAt: "2026-11-16T10:03:26.080558Z"
- id: "TSK-0002"
title: "Documentar e verificar continuidade histórica"
description: ""
acceptanceCriteria:
- "Testes e CLI empacotada preservam registros concluídos e documentam evolução;\
\ regressão passa."
dependsOn:
- "TSK-0001"
status: "ACTIVE"
result: "Documentação e fixture histórica prontas; regressão completa e geração\
\ nativa em execução."
evidence: []
updatedAt: "2026-11-16T10:03:26.943708Z"
status: "ACTIVE"
author: "human"
createdAt: "2026-11-16T09:50:02.714336Z"
revision: 6
previousHash: "6344a8e0e775112994f729b5aef457e98a85b38fe36b1017e7e04140b1a7a525"
updatedAt: "2026-11-16T10:03:26.943733Z"
updatedBy: "agent"
changeReason: "Documentação e fixture histórica prontas; regressão completa e geraç\
ão nativa em execução."
documentVersion: 2
---
Adicionar contrato versionado e catálogo de formatos; expor diagnóstico somente leitura na CLI; documentar política de evolução; testar registros históricos e versões não suportadas, executar regressão e verificar preservação dos Works concluídos.
@@ -0,0 +1,49 @@
---
schemaVersion: 1
id: "PLN-0001"
workId: "WRK-0003"
title: "Diagnóstico público e leitura histórica sem migração"
decisions: []
steps:
- id: "TSK-0001"
title: "Implementar contrato e diagnóstico de compatibilidade"
description: ""
acceptanceCriteria:
- "Comando público distingue contrato, formatos, legado legível e versões não suportadas\
\ sem escrita."
dependsOn: []
status: "COMPLETED"
result: "Contrato, catálogo, diagnóstico público e leitura de legado implementados;\
\ testes focados e inspeção dos dois projetos passaram."
evidence:
- "ART-0001"
updatedAt: "2026-11-16T10:03:26.080558Z"
- id: "TSK-0002"
title: "Documentar e verificar continuidade histórica"
description: ""
acceptanceCriteria:
- "Testes e CLI empacotada preservam registros concluídos e documentam evolução;\
\ regressão passa."
dependsOn:
- "TSK-0001"
status: "COMPLETED"
result: "Documentação instalada e pública, fixture histórica, 126 testes e smoke\
\ nativo passaram; diagnóstico dos projetos reais e preservação de 302 arquivos\
\ históricos/piloto confirmados."
evidence:
- "ART-0002"
updatedAt: "2026-11-16T10:11:34.939996Z"
status: "ACTIVE"
author: "human"
createdAt: "2026-11-16T09:50:02.714336Z"
revision: 7
previousHash: "c5ac6782c1bf92ee43611201601865fa2f4e581e24ef552e603e7629337e287e"
updatedAt: "2026-11-16T10:11:34.940023Z"
updatedBy: "agent"
changeReason: "Documentação instalada e pública, fixture histórica, 126 testes e smoke\
\ nativo passaram; diagnóstico dos projetos reais e preservação de 302 arquivos\
\ históricos/piloto confirmados."
documentVersion: 2
---
Adicionar contrato versionado e catálogo de formatos; expor diagnóstico somente leitura na CLI; documentar política de evolução; testar registros históricos e versões não suportadas, executar regressão e verificar preservação dos Works concluídos.
@@ -0,0 +1,47 @@
---
schemaVersion: 1
id: "PLN-0001"
workId: "WRK-0003"
title: "Diagnóstico público e leitura histórica sem migração"
decisions: []
steps:
- id: "TSK-0001"
title: "Implementar contrato e diagnóstico de compatibilidade"
description: ""
acceptanceCriteria:
- "Comando público distingue contrato, formatos, legado legível e versões não suportadas\
\ sem escrita."
dependsOn: []
status: "COMPLETED"
result: "Contrato, catálogo, diagnóstico público e leitura de legado implementados;\
\ testes focados e inspeção dos dois projetos passaram."
evidence:
- "ART-0001"
updatedAt: "2026-11-16T10:03:26.080558Z"
- id: "TSK-0002"
title: "Documentar e verificar continuidade histórica"
description: ""
acceptanceCriteria:
- "Testes e CLI empacotada preservam registros concluídos e documentam evolução;\
\ regressão passa."
dependsOn:
- "TSK-0001"
status: "COMPLETED"
result: "Documentação instalada e pública, fixture histórica, 126 testes e smoke\
\ nativo passaram; diagnóstico dos projetos reais e preservação de 302 arquivos\
\ históricos/piloto confirmados."
evidence:
- "ART-0002"
updatedAt: "2026-11-16T10:11:34.939996Z"
status: "COMPLETED"
author: "human"
createdAt: "2026-11-16T09:50:02.714336Z"
revision: 8
previousHash: "28bb6dc031ef79789ce15805ad1490855694d947998f7b6fcef4966bb25fcbb0"
updatedAt: "2026-11-16T10:11:35.345624Z"
updatedBy: "system:plans"
changeReason: "All required steps completed; reviewed cancellations retained"
documentVersion: 2
---
Adicionar contrato versionado e catálogo de formatos; expor diagnóstico somente leitura na CLI; documentar política de evolução; testar registros históricos e versões não suportadas, executar regressão e verificar preservação dos Works concluídos.
@@ -0,0 +1,80 @@
---
schemaVersion: 1
id: "WRK-0003"
title: "Infraestrutura de compatibilidade e evolução do protocolo"
description: ""
goal: "Diagnosticar versões e compatibilidade usando a CLI pública, preservando leitura\
\ e interpretação de registros históricos sem migração obrigatória."
motivation: ""
constraints:
- "Não migrar nem regravar os Works COMPLETED existentes ou o projeto piloto zelda-1."
acceptanceCriteria:
- "A CLI distingue contrato do protocolo e formatos persistidos, diagnosticando legado\
\ compatível e formatos não suportados sem escrever durante leituras."
- "Testes demonstram leitura e interpretação de Works históricos concluídos e preservaç\
ão byte a byte após diagnóstico e atualização das instruções."
- "Documentação instalada explica o diagnóstico e a evolução sem exigir acesso ao\
\ código-fonte."
status: "COMPLETED"
createdAt: "2026-11-16T09:48:15.430009Z"
updatedAt: "2026-11-16T10:11:35.978959Z"
author: "agent"
repositories:
- repositoryId: "ai-engineering"
path: "."
head: "bd2c9133dad87a90b95d108c141cfe9eacbe77a3"
dirty: false
discussions:
- "DSC-0001"
- "DSC-0002"
decisions: []
artifacts:
- "ART-0001"
- "ART-0002"
- "ART-0003"
plans:
- "PLN-0001"
completions:
- at: "2026-11-16T10:11:35.978959Z"
by: "system:plans"
summary: "All required Plans completed; requester=agent"
humanApproved: false
scopeHash: "3ba6a687117bed72317e065a3cea9cf53fa5c725fbca994e512ada0713e7f74f"
criteria:
- criterion: 1
text: "A CLI distingue contrato do protocolo e formatos persistidos, diagnosticando\
\ legado compatível e formatos não suportados sem escrever durante leituras."
evidence:
- "ART-0003"
- criterion: 2
text: "Testes demonstram leitura e interpretação de Works históricos concluídos\
\ e preservação byte a byte após diagnóstico e atualização das instruções."
evidence:
- "ART-0003"
- criterion: 3
text: "Documentação instalada explica o diagnóstico e a evolução sem exigir acesso\
\ ao código-fonte."
evidence:
- "ART-0003"
integrations: []
noIntegrationReason: "Canonical changes and execution results are recorded in the\
\ Plan step evidence"
origin: "SYSTEM_PLANS"
delegation: null
aggregation:
receipt: "ART-0003"
inputHash: "e48d3536a51a54b72c10790ad264ef2a0f50bddced889d4ed8851d71900eec8b"
requester: "agent"
requestId: "0f38bb1b-3484-4d10-a8af-1dac0b43564e"
events:
- action: "COMPLETE"
by: "system:plans"
reason: "All required Plans completed; requester=agent"
at: "2026-11-16T10:11:35.978959Z"
archived: false
topics: []
surveys: []
dispositions: []
agentRuns: []
epic: false
---