feat: add protocol compatibility diagnostics and historical readers

This commit is contained in:
Nilton Constantino
2026-11-16 10:13:05 +00:00
parent bd2c9133da
commit 3dd04a730f
48 changed files with 1382 additions and 13 deletions
+34
View File
@@ -24,6 +24,40 @@ Use `ai-engineering` (or its installed alias `aie`). No server or model API is n
whole lists. Use DEC drafts for significant commitments; small work need not
invent a decision or plan merely to satisfy a ceremony.
## Compatibility and protocol updates
Run `aie project compatibility --format json` before considering an update. `status`
includes a compatibility summary and the diagnostic command. The diagnostic is
read-only: it inspects actual canonical files and record revisions, without locks,
backups, model calls or migrations. It includes AIE completion receipts, while ignored
runs, local backups and ordinary artifact payloads are excluded. Use `project validate`
for integrity.
`protocol.json` separates `schemaVersion` (the manifest shape) from `protocolVersion`
(the engineering contract revision). A missing `protocolVersion` denotes the legacy
baseline contract 1. The report exposes the installed CLI release, supported contract
versions, format catalog, observed versions and missing defaulted Work fields.
Storage `schemaVersion` and narrative `documentVersion` remain independent.
States are `CURRENT`, `LEGACY_COMPATIBLE`, `UNSUPPORTED` and `INVALID`. The first two
are readable, return exit 0 and do not require migration. Unsupported or invalid
records return exit 4 with file-specific diagnostics. A newer manifest does not prove
that old records were converted. A missing optional field is not by itself a defect.
Compatibility is separate from structural validation and completion readiness.
Keep historical and COMPLETED Works in their original formats. The CLI reads older
supported representations and applies documented defaults in memory, preserving
IDs, approvals, evidence, completion provenance and content hashes. Never reopen or
rewrite a completed Work merely to materialize current fields, topics or surveys.
`aie onboard` refreshes the entry instructions and manifest, with backups, while
leaving Works, evidence and revision history unchanged. A newer unsupported manifest
or contract is refused rather than overwritten; use a compatible CLI. No required
migration is registered in this release. Future conversions must have an explicit
public command, scope, preview, backups and repeatable execution. Do not invent a
migration or inspect AIE source code to discover consumer update procedures; report
public-interface gaps with evidence instead.
## Topics, surveys and refinement
Discussion remains the refinement space: receive ideas, organize topics, investigate,
+2 -1
View File
@@ -1,5 +1,6 @@
{
"schemaVersion": 1,
"protocolVersion": 1,
"protocol": "ai-engineering",
"entrypoint": "README.md",
"instructions": "AGENTS.md",
@@ -8,7 +9,7 @@
"command": "ai-engineering",
"aliases": ["aie"],
"startup": ["status --format json", "next-actions --format json", "work context <WRK> --format markdown"],
"capabilities": ["work", "discussion", "topics", "surveys", "answer-history", "proposal-dispositions", "fixture-adapters", "local-cli-adapters", "guided-agent-setup", "agent-doctor", "agent-routing", "run-provenance", "epic", "epic-policy-authorization", "epic-propagation", "epic-reconciliation", "decision-approval", "decision-history", "planning", "step-dependencies", "evidence", "completion", "plan-consolidation", "cancelled-scope-review", "work-reconciliation", "archive", "reopen"],
"capabilities": ["protocol-compatibility", "work", "discussion", "topics", "surveys", "answer-history", "proposal-dispositions", "fixture-adapters", "local-cli-adapters", "guided-agent-setup", "agent-doctor", "agent-routing", "run-provenance", "epic", "epic-policy-authorization", "epic-propagation", "epic-reconciliation", "decision-approval", "decision-history", "planning", "step-dependencies", "evidence", "completion", "plan-consolidation", "cancelled-scope-review", "work-reconciliation", "archive", "reopen"],
"humanApproval": "explicit-attestation",
"execution": "external-human-or-agent",
"legacyImport": false
+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
---