feat: adopt local SQLite engineering memory and quality gates

This commit is contained in:
2026-11-22 14:39:00 +00:00
parent f5d5db73c2
commit 218c060b94
228 changed files with 28728 additions and 1161 deletions
+1 -1
View File
@@ -1,3 +1,3 @@
---
schemaVersion: 2
lastWork: "000B"
lastWork: "000D"
@@ -0,0 +1,13 @@
---
schemaVersion: 1
id: "DSC-0001"
workId: "WRK-000C"
discussionId: "main"
kind: "NOTE"
author: "Codex"
createdAt: "2026-11-22T10:06:12.127522Z"
respondsTo: null
documentVersion: 2
---
Ticket solicitado explicitamente por Nilton em 2026-11-22 durante a discussão do WRK-001D do Prometeu. Ambiente: macOS, CLI instalada /Users/niltonconstantino/.local/bin/aie; aie --version retornou ai-engineering 0.1.0. Consumidor: /Users/niltonconstantino/personal/workspace.personal/intrepid/prometeu/project. Comandos aie status --format json e aie next-actions --format json foram iniciados em paralelo pelo agente e permaneceram sem saída em várias consultas durante minutos. Na inspeção final, ps mostrou PID 66921, estado Rs, elapsed 08:43, comando aie status --format json ainda ativo, sem saída na sessão correspondente. next-actions acabou retornando; sua saída refletia guidance UNSPECIFIED do WRK-001D apesar de a escolha EXPLORATORY já ter sido gravada durante a espera, compatível com leitura anterior à mutação, sem confirmar mecanismo de cache. Mutações pontuais terminaram: criação do WRK-001D levou cerca de 0,55 s; discussion add teve exemplos de 0,29 s a 0,69 s; nesta abertura de ticket, work create no projeto AIE levou cerca de 0,15 s. São durações retornadas pelo executor para aquelas chamadas, não benchmark controlado. work context e work validate do Work novo também chegaram a concluir; não há evidência de bloqueio universal das gravações. No projeto AIE, status e next-actions concluíram entre consultas, com estado LEGACY_COMPATIBLE, readable=true, migrationRequired=false. Hipóteses ainda não comprovadas: varredura/validação de histórico e artefatos, operações de filesystem, custo dependente do volume, concorrência ou restrições de ambiente. Próxima investigação proposta: reproduzir com timeout e timestamps, medir primeira saída e conclusão, comparar chamadas sequenciais/concorrentes, e perfilar o processo demorado sem alterar dados canônicos. Esperado: comandos rotineiros interativos com duração mensurada e feedback útil, preservando integridade. Escopo atual é abertura do ticket, não execução de correção. Modo DIRECT/EXPLORATORY não informado para este Work; não foi herdado do Prometeu.
@@ -0,0 +1,13 @@
---
schemaVersion: 1
id: "DSC-0002"
workId: "WRK-000C"
discussionId: "main"
kind: "NOTE"
author: "Codex"
createdAt: "2026-11-22T10:12:39.669653Z"
respondsTo: null
documentVersion: 2
---
Enquadramento inicial em modo EXPLORATORY, escolhido explicitamente por Nilton nesta conversa. Dor proposta: o custo e a ausência de feedback das consultas obrigatórias interrompem a conversa e tornam um registro simples imprevisível; melhorar apenas a mensagem de espera pode ser insuficiente. Evidência histórica: DSC-0001 relata espera de minutos no Prometeu, sem causa confirmada. Observação desta sessão, sem benchmark controlado: work context concluiu em aproximadamente 0,98 s; work guidance em aproximadamente 1,72 s; status e next-actions iniciados em paralelo ultrapassaram a janela inicial de 10 s sem saída; next-actions depois concluiu; ps observou status com elapsed de 31 s e CPU acumulada de 21,12 s. Esses dados não provam deadlock, efeito de concorrência ou causa raiz. Perguntas de produto para discutir: (1) qual limite de tempo total e de primeira resposta torna consultas e registros aceitáveis? (2) o fluxo de uma alteração pontual precisa sempre de visão global ou pode obter contexto suficiente do Work com garantias explícitas? (3) qual volume real de Works, revisões e evidências deve permanecer responsivo? Perguntas técnicas a investigar: (4) qual fase concentra tempo e CPU: inicialização, descoberta/leitura, interpretação, compatibilidade, integridade ou montagem da saída? (5) como o custo varia com o volume, CLI instalada versus local, ambiente e execução sequencial versus concorrente? (6) consultas e mutações têm gargalos distintos, e qual consistência é esperada se o Work mudar durante uma consulta? (7) qual correção mínima cumpre os limites acordados sem enfraquecer integridade, validação ou autoridade humana? Próximo passo proposto: acordar orçamento de latência e cenário representativo, depois medir com limite de duração e localizar o custo. Nenhuma solução, meta numérica, DEC ou implementação aprovada.
@@ -0,0 +1,13 @@
---
schemaVersion: 1
id: "DSC-0003"
workId: "WRK-000C"
discussionId: "main"
kind: "NOTE"
author: "Nilton"
createdAt: "2026-11-22T10:22:00.400005Z"
respondsTo: null
documentVersion: 2
---
Resposta explícita sobre responsividade nesta conversa: o mínimo possível. O sistema não pode ficar flutuando sem retorno dessa maneira, principalmente para leitura. Solicita sugestões para as perguntas do enquadramento com base na inspeção do código existente. Não define um limite numérico nem aprova solução ou implementação.
@@ -0,0 +1,13 @@
---
schemaVersion: 1
id: "DSC-0004"
workId: "WRK-000C"
discussionId: "main"
kind: "NOTE"
author: "Codex"
createdAt: "2026-11-22T10:23:19.859847Z"
respondsTo: null
documentVersion: 2
---
Inspeção estática do código em 2026-11-22, sem alteração de implementação ou benchmark nesta etapa. Achados verificáveis: WorkService.load (linha 27) chama list e desserializa todos os work.md; folder (linha 32) chama load novamente. EpicService.definitions (linha 33) lista todos os Works e chama folder para cada um, inclusive Works sem EPIC; VerificationService.work (linha 48) repete definitions em cada validação. Há portanto amplificação de leituras globais, com termo cúbico no número de Works no caminho de validação global derivado desses laços, sem que isso determine sozinho o tempo observado. VerificationService.status (linha 299) chama work e actions; actions (linha 310) chama work outra vez. status JSON valida cada Work ao menos duas vezes e depois executa CompatibilityService.inspect, que percorre registros e revisões e em geral lê cada registro para metadata e novamente para desserialização. PlanService.list e DecisionService.list verificam cadeias de revisões; ArtifactService.validate relê payloads para SHA-256 e resolve a pasta do Work por artefato. context valida work e PlanCoordinator.inspect valida novamente. A CLI monta o objeto completo antes de emitir JSON; não há progresso nem prazo próprio desses comandos. Filespace.locked utiliza espera bloqueante de lock nas mutações; o caminho normal dessas consultas não adquire esse lock, logo não há base para atribuir a demora de leitura a ele. Contagem local nesta inspeção: 12 Works, 530 arquivos sob works excluindo runs e .local, 206 arquivos de histórico, aproximadamente 1,75 MB; contagem não caracteriza o consumidor Prometeu nem exclui custo de parsing. Propostas para discussão: primeiro eliminar leituras/validações repetidas sem mudar as garantias; criar contexto de leitura por invocação com mapa de IDs/pastas, documentos e avaliações reutilizados entre serviços; verificar alterações concorrentes com mecanismo explícito, pois memória por comando não é snapshot atômico. Investigar acesso ao Work selecionado sem desserializar demais Works, preservando detecção de IDs duplicados e validando dependências relevantes. Só depois avaliar consultas operacionais leves separadas de auditoria completa, com validação não realizada declarada e sem apresentar validade não aferida. A distinção é mudança contratual a discutir, não autorização para retirar validação atual. Aproveitar next-actions WRK já existente e considerar reduzir a redundância do bootstrap em futura revisão do protocolo. Proposta inicial de metas a validar, não promessa: no cenário local representativo, p95 menor ou igual a 1 s para leitura de Work e menor ou igual a 2 s para visão global; se ultrapassar 300-500 ms, progresso verdadeiro em stderr sem contaminar stdout JSON, com prazo/cancelamento e diagnóstico de fase e volume. Medir início frio/quente, tempo total e primeira saída útil, contagens de leituras/parse/hash, volumes de 10/100/1000 Works com histórias curtas/longas e evidências, CLI instalada/local e execução sequencial/concorrente. Não começar por cache persistente ou paralelização; primeiro remover a amplificação e medir. Mutações devem conservar lock, publicação atômica e integridade, com espera limitada e feedback explícito. Próxima investigação proposta: confirmar correspondência do binário instalado com o fonte e perfilar uma reprodução com duração limitada para atribuir custos, comparando os resultados e o comportamento de detecção de corrupção. Todas as metas e soluções são recomendações; exploração permanece aberta.
@@ -0,0 +1,13 @@
---
schemaVersion: 1
id: "DSC-0005"
workId: "WRK-000C"
discussionId: "main"
kind: "NOTE"
author: "Codex"
createdAt: "2026-11-22T10:37:39.149693Z"
respondsTo: null
documentVersion: 2
---
Nova alternativa trazida por Nilton nesta conversa, antes de perseguir as otimizações: avaliar uma base de dados real local distribuída junto com o AIE. Pergunta exploratória, sem aprovação de adoção ou migração. Avaliação: SQLite embarcado é candidato forte para o estado operacional local, pois não exige processo servidor e oferece índices, transações e leitura consistente. Referências oficiais consultadas: https://sqlite.org/serverless.html ; https://sqlite.org/whentouse.html ; https://sqlite.org/isolation.html ; https://sqlite.org/atomiccommit.html . Proposta para discussão: comparar arquivos otimizados, SQLite como índice reconstruível e SQLite como fonte canônica; não manter arquivos e banco como autoridades independentes. Se acesso e edição direta dos arquivos sem CLI for requisito essencial, índice preserva esse contrato, mas precisa detectar alterações externas e invalidar estado sem repetir uma auditoria global em cada consulta. Se a CLI puder ser a interface normal, SQLite canônico com Markdown/JSON exportados tende a simplificar consultas e consistência entre registros; exportações seriam derivadas, e importação seria explícita. Transações cobrem dados no banco; evidências mantidas em arquivos exigem protocolo próprio para publicação e recuperação. SQLite em WAL admite leitura concorrente à escrita, mantendo um escritor por vez; não substitui regras de aprovação ou integridade de evidências. A arquitetura e README atuais tratam arquivos legíveis como persistência canônica e execução sem banco; portanto a troca modifica contrato e exige decisão própria quando o humano encerrar a exploração. Banco por si só não elimina chamadas redundantes nem verificação integral de históricos/payloads em cada leitura; é preciso ajustar os caminhos de acesso. Antes de escolher biblioteca ou migrar, comparar protótipos descartáveis com dados representativos e verificar integração/distribuição JVM e GraalVM Native Image, backup, exportação, histórico e recuperação. Recomendação preliminar: avaliar SQLite embarcado como alternativa arquitetural antes de investir em otimização extensa do armazenamento atual; preferência por fonte canônica se a leitura/edição direta dos arquivos puder deixar de ser o caminho operacional. Nenhuma mudança de implementação executada.
@@ -0,0 +1,13 @@
---
schemaVersion: 1
id: "DSC-0006"
workId: "WRK-000C"
discussionId: "main"
kind: "NOTE"
author: "Nilton"
createdAt: "2026-11-22T10:42:15.904220Z"
respondsTo: null
documentVersion: 2
---
Direção expressa nesta conversa: pergunta se migrar para banco local resolveria os atrasos e afirma que, se sim, considera esse o caminho a seguir. Esclarece que não tem intenção de alterar os arquivos manualmente. Isso remove a edição manual de arquivos como necessidade pessoal declarada e favorece avaliar banco como fonte principal. A preferência pelo caminho foi condicionada à solução dos atrasos; não constitui aprovação de uma DEC concreta, autorização de migração ou pedido explícito para encerrar a exploração.
@@ -0,0 +1,13 @@
---
schemaVersion: 1
id: "DSC-0007"
workId: "WRK-000C"
discussionId: "main"
kind: "NOTE"
author: "Codex"
createdAt: "2026-11-22T10:42:16.345039Z"
respondsTo: null
documentVersion: 2
---
Síntese após a preferência de Nilton: recomendar SQLite embarcado por projeto como candidato a fonte canônica, com acesso normal pela CLI e exportação Markdown/JSON. A inspeção do fonte sustenta que acesso indexado e reutilização de dados podem remover varreduras e desserializações globais repetidas; transações também podem reduzir a complexidade de consistência entre registros armazenados no banco. Não é possível garantir eliminação da latência sem medir o caminho real: substituir armazenamento preservando chamadas redundantes, auditoria integral por consulta, hashes de payloads e montagem completa antes da saída ainda pode produzir demora. A proposta precisa combinar banco, consultas com escopo adequado, reuso por invocação e feedback/prazo explícitos. Critério para confirmar a direção: protótipo descartável com volume e histórico representativos, comparado à CLI atual, medindo tempo total, primeira saída útil, consultas, início frio e chamadas concorrentes; verificar recuperação e preservação das regras de autoridade. As metas anteriores de 1 s por Work e 2 s global continuam propostas, não SLA aceito nem promessa. Histórico, aprovações e hashes existentes devem ser preservados numa eventual migração explícita, com preview, backup, verificação e recuperação; não alterar Works concluídos para acomodar o novo modelo. Ainda não há DEC, Plan ou migração autorizada. Exploração continua aberta; a preferência registrada pode orientar a próxima investigação.
@@ -0,0 +1,13 @@
---
schemaVersion: 1
id: "DSC-0008"
workId: "WRK-000C"
discussionId: "main"
kind: "NOTE"
author: "Codex"
createdAt: "2026-11-22T10:45:08.490904Z"
respondsTo: null
documentVersion: 2
---
Reorientação explicitamente solicitada por Nilton nesta conversa: manter este ticket de latência e abrir outro para a mudança de persistência para uma base consolidada como SQLite; retornar ao problema da demora depois, sob a ótica da nova base. Criado WRK-000D — Adotar SQLite como persistência local do AIE, em modo EXPLORATORY escolhido explicitamente para aquele Work. Sequência acordada: priorizar a discussão e futura entrega da persistência no WRK-000D; retomar a investigação e correção da latência no WRK-000C após a mudança, medindo os comandos na arquitetura então entregue. WRK-000C permanece OPEN, preservando relatos, achados estáticos e critérios; não foi concluído nem arquivado. A adoção de banco não será tomada como evidência de solução da demora. O baseline histórico permanece disponível para a futura comparação. A reorientação não aprova DEC nem autoriza implementação ou migração imediata.
@@ -0,0 +1,13 @@
---
schemaVersion: 1
id: "DSC-0009"
workId: "WRK-000C"
discussionId: "main"
kind: "NOTE"
author: "Codex"
createdAt: "2026-11-22T14:05:45.720030Z"
respondsTo: null
documentVersion: 2
---
Handoff do WRK-000D para responsividade: implementação SQLite/local concluída por etapas; validação integrada ainda em execução nesta sessão. O WRK-000C permanece OPEN e não há alegação de correção da latência. Cenário reproduzível em docs/latency-scenario.md e gerador scripts/latency-fixture.py: comparar o mesmo pacote nativo nos backends sqlite/legacy com 1/10/100 Works e 10 notas por Work; medir work show/context selecionado, next-actions selecionado, list e status em processos novos. Registrar versão + SHA do binário, revisão/build, protocolo/schema, volume, OS/CPU e acesso Git. Ambiente físico desta prova: macOS arm64, GraalVM CE 25.5.5.0+3, JDBC 3.54.1.0/sqlite3 3.54.1. Scripts não fazem instalação, migração real ou benchmark automaticamente. Retomar critérios de espera/feedback e medir separadamente startup, leitura e acesso Git.
@@ -0,0 +1,71 @@
---
schemaVersion: 1
id: "WRK-000C"
title: "Investigar latência excessiva nos comandos de consulta e registro do AIE"
description: "Ticket solicitado por Nilton durante a discussão do WRK-001D no projeto\
\ Prometeu: consultas obrigatórias do AIE ficam vários minutos sem saída, tornando\
\ demorado um registro simples. Investigar e distinguir custo da CLI, tamanho do\
\ projeto, IO, ambiente e efeito de chamadas concorrentes; causa ainda não confirmada.\
\ Reorientação solicitada em 2026-11-22: manter este ticket aberto e priorizar a\
\ mudança de persistência no WRK-000D; após essa entrega, retomar a avaliação e\
\ o tratamento da latência sob a arquitetura de banco de dados, preservando o baseline\
\ histórico e sem presumir que SQLite resolve o atraso."
goal: "Identificar e documentar a causa da latência percebida e propor correção verificá\
vel para manter consultas e registros interativos responsivos."
motivation: "Um simples registro de preferência de janela foi acompanhado de espera\
\ de minutos em status e next-actions, prejudicando a conversa e a confiança no\
\ fluxo."
constraints:
- "Este ticket registra uma investigação; não autoriza implementação, migração, commits\
\ ou alteração dos projetos consumidores."
- "Preservar Works, histórico, aprovações, evidências e alterações preexistentes.\
\ Não herdar modo de discussão nem aprovações do WRK-001D do Prometeu."
- "Não afirmar deadlock ou causa raiz sem evidência; comparar execução sequencial\
\ e concorrente, CLI instalada e execução local, e ambiente restrito versus normal\
\ quando aplicável."
acceptanceCriteria:
- "Reprodução com comandos, versão, ambiente, volume de dados, tempos totais e tempo\
\ até a primeira saída, usando limites de duração definidos."
- "Causa ou gargalos localizados com evidência, diferenciando consultas status/next-actions/context\
\ de mutações como discussion add e work guidance."
- "Proposta de correção e critérios mensuráveis de responsividade registrados, sem\
\ enfraquecer validação, integridade ou autoridade humana."
status: "OPEN"
createdAt: "2026-11-22T10:05:02.624219Z"
updatedAt: "2026-11-22T14:05:45.746386Z"
author: "Codex"
repositories: []
discussions:
- "DSC-0001"
- "DSC-0002"
- "DSC-0003"
- "DSC-0004"
- "DSC-0005"
- "DSC-0006"
- "DSC-0007"
- "DSC-0008"
- "DSC-0009"
decisions: []
artifacts: []
plans: []
completions: []
events: []
archived: false
topics: []
surveys: []
dispositions: []
agentRuns: []
epic: false
guidance:
mode: "EXPLORATORY"
approvalPolicy: "REQUIRED"
history:
- mode: "EXPLORATORY"
approvalPolicy: "REQUIRED"
by: "Nilton"
reason: "Escolha explícita nesta conversa: investigar a dor e comparar hipóteses\
\ antes de decidir."
at: "2026-11-22T10:12:24.202784Z"
humanApproved: true
decisionRequests: []
---
@@ -0,0 +1,11 @@
---
schemaVersion: 1
id: "ART-0001"
workId: "WRK-000D"
origin: "PLN-0001/TSK-0001"
purpose: "Resultado mínimo do mapeamento e dos 45 testes de baseline do TSK-0001"
path: "artifacts/evidence/ART-0001/payload"
sha256: "ca7863dd1128ef219d653c1c988e5632b4e012ebfde76c63704c21e92fe9f9e6"
size: 2502
author: "Codex"
createdAt: "2026-11-22T12:00:15.272156Z"
@@ -0,0 +1,25 @@
# WRK-000D / PLN-0001 / TSK-0001 — resultado
Source revision: f5d5db73c22055988d53cd125d9246f51575410b
Deliverable: docs/sqlite-migration-design.md
Deliverable SHA-256: f492cfa78fdb9132afafb7e58b3de05843062bea971635bf04909d7e259c2cca
Inspeção dos modelos/serviços e formatos atuais concluída. O documento mapeia identidades, relações, defaults históricos, aprovações, recibos e cinco classes de hashes para grupos lógicos SQLite; identifica os limites transacionais e o ciclo futuro de anexos temporários. Corpus de compatibilidade, workflows e importação definido antes da conversão; casos futuros de falha, retry e limpeza são identificados como ainda não implementados.
Validação executada nesta sessão:
`./gradlew test --tests net.intrepid.aiengineering.CompatibilityTest --tests net.intrepid.aiengineering.WorkGuidanceTest --tests net.intrepid.aiengineering.PlanConsolidationSafetyTest --tests net.intrepid.aiengineering.EpicSafetyTest --tests net.intrepid.aiengineering.RefinementSafetyTest --tests net.intrepid.aiengineering.legacyimport.DiscussionImportRecoveryTest --console=plain`
Resultado observado: BUILD SUCCESSFUL em 1m40s; 45 testes, zero falhas/erros/skips em seis classes. Resultados individuais:
- net.intrepid.aiengineering.CompatibilityTest: 9 testes, 0 falhas, 0 erros, 0 skips.
- net.intrepid.aiengineering.EpicSafetyTest: 9 testes, 0 falhas, 0 erros, 0 skips.
- net.intrepid.aiengineering.PlanConsolidationSafetyTest: 9 testes, 0 falhas, 0 erros, 0 skips.
- net.intrepid.aiengineering.RefinementSafetyTest: 9 testes, 0 falhas, 0 erros, 0 skips.
- net.intrepid.aiengineering.WorkGuidanceTest: 8 testes, 0 falhas, 0 erros, 0 skips.
- net.intrepid.aiengineering.legacyimport.DiscussionImportRecoveryTest: 1 testes, 0 falhas, 0 erros, 0 skips.
Âncoras congeladas conferidas: 9 arquivos; scopeHash 72d5803add0b8714d7dc4bf7e63ad55cc3259df910aa8b03790657eac4c2bd02; draftHash 545dc8e36da222fdeaf9458f77880bf2d1842738b82bac5296cddf62452a7e01; payloadHash 98545564d0747210b91b933bf8554c4b7e36ba878e6662cb48156b08ff74e1ee.
git diff --check concluiu com sucesso.
Limites preservados: nenhuma instalação, substituição de binário/biblioteca/atalho, migração do workspace canônico ou de consumidores, descarte de evidências legadas ou alteração dos recursos congelados. Esta etapa caracteriza o backend atual; não comprova implementação SQLite nem solução da latência.
Próximo step: TSK-0002 — prova JVM e Native Image em dados descartáveis.
@@ -0,0 +1,11 @@
---
schemaVersion: 1
id: "ART-0002"
workId: "WRK-000D"
origin: "PLN-0001/TSK-0002"
purpose: "Resultado mínimo da prova SQLite JVM/Native Image TSK-0002 e EXP-0001"
path: "artifacts/evidence/ART-0002/payload"
sha256: "6eda6a977ee223e375e98e2d91922a63928ed69e3122c2dc43d4d6995ba998fc"
size: 1961
author: "Codex"
createdAt: "2026-11-22T12:16:29.197218Z"
@@ -0,0 +1,20 @@
# TSK-0002 / EXP-0001 — resultado observado
Driver selecionado: org.xerial:sqlite-jdbc:3.54.1.0, motor SQLite 3.54.1.
Plataforma verificada: macOS arm64; GraalVM Community 25.0.5.0.3+1 (25.5.5.0+3-graalce).
Mudanças: dependência fixada; source set src/sqliteProbe separado do CLI; tarefas sqliteProbe/nativeSqliteProbeCompile; biblioteca JNI exportada ao lado do executável; scripts/sqlite-probe.sh usa exclusivamente diretório descartável.
Observações desta sessão:
- ./gradlew sqliteProbeClasses: BUILD SUCCESSFUL.
- ./gradlew sqliteProbe -PprobeDatabase=build/sqlite-probe/wrk000d/proof.db: criou a base e verificou UTF-8 e rollback.
- Nova invocação JVM: reabriu a mesma base, com UTF-8 e rollback preservados.
- Primeira tentativa nativa selecionou o JDK comum pelo ambiente; corrigido javaLauncher explícito GraalVM Java 25 antes da repetição. Falha de setup, sem refutar a hipótese de persistência.
- nativeSqliteProbeCompile com o GraalVM existente: BUILD SUCCESSFUL, build de imagem em 46,7 s; executável e libsqlitejdbc.dylib produzidos em build/native/nativeSqliteProbeCompile.
- bash scripts/sqlite-probe.sh <caminho absoluto do build>: passou create/reopen em processos nativos independentes, UTF-8 e rollback com diretório de extração sem escrita. Cópia isolada do executável sem biblioteca falhou conforme esperado.
- Há avisos de depreciação/native-access do toolchain/driver; não impediram o resultado. A prova confirma macOS arm64, sem afirmar validação de outras plataformas.
- git diff --check passou.
Interpretação: hipótese confirmada na plataforma alvo; integração JVM/Native Image e distribuição conjunta da biblioteca são viáveis. Próxima ação: infraestrutura transacional SQLite do TSK-0003.
Nenhuma instalação, substituição de binários/bibliotecas/atalhos ou migração de projetos reais foi feita. A prova não implementa persistência do domínio nem comprova latência fim a fim.
@@ -0,0 +1,11 @@
---
schemaVersion: 1
id: "ART-0003"
workId: "WRK-000D"
origin: "PLN-0001/TSK-0003"
purpose: "Resultado mínimo da infraestrutura SQLite, 13 testes e prova nativa do TSK-0003"
path: "artifacts/evidence/ART-0003/payload"
sha256: "bbdc1fa4341e4fe1015c6e10ad33f19eabd1ea5aaef1a7853e8de33bc8ca92de"
size: 2100
author: "Codex"
createdAt: "2026-11-22T12:25:56.560824Z"
@@ -0,0 +1,14 @@
# TSK-0003 — infraestrutura transacional SQLite
Implementado SqliteDatabase e sqlite/schema-v1.sql: inicialização explícita, marca de aplicação/schema, chaves de identidade/propriedade/revisão/referência e contador local; foreign keys por conexão, WAL/FULL, BEGIN IMMEDIATE para escrita, leitura readonly e consistente, busy timeout limitado. Transações aninhadas compartilham conexão e falha interna impede commit parcial mesmo quando capturada. Abertura não cria base ausente; versões futuras, symlinks e sidecars indevidos são recusados. Campos/tabelas específicos do domínio serão integrados nas TSKs seguintes; CLI ainda não usa SQLite para Works.
Validação executada nesta sessão:
- ./gradlew test --tests net.intrepid.aiengineering.SqliteDatabaseTest --tests net.intrepid.aiengineering.ArchitectureTest --console=plain: BUILD SUCCESSFUL; 12 testes SQLite e 1 teste de arquitetura, zero falhas/erros/skips.
- Casos observados: rollback em falha de FK; publicação conjunta com referências diferidas; falha aninhada capturada não comita; leitura readonly; snapshot estável enquanto outro escritor comita; lock com espera limitada a 75 ms e diagnóstico; schema futuro; nomes de diretório com espaço/?/#/UTF-8; recusa de symlinks e sidecar órfão.
- Prova Native Image recompilada com infraestrutura e recurso de schema: BUILD SUCCESSFUL. scripts/sqlite-probe.sh passou criação e reabertura do schema em processos separados, além de UTF-8, rollback e biblioteca externa, com extração desabilitada. Ausência da biblioteca falha conforme esperado.
- Uma ambiguidade de inferência de tipos no código do teste foi corrigida antes da execução bem-sucedida.
- git diff --check passou.
Arquivos principais: SqliteDatabase.java, sqlite/schema-v1.sql, SqliteDatabaseTest.java, NativeHints.java, build.gradle.kts, src/sqliteProbe e docs/sqlite-migration-design.md.
Nenhuma instalação, ativação de backend no workspace real, migração de consumidores ou descarte de evidências legadas foi feito. Próxima ação: TSK-0004, persistir Works e investigação.
@@ -0,0 +1,11 @@
---
schemaVersion: 1
id: "ART-0004"
workId: "WRK-000D"
origin: "PLN-0001/TSK-0004"
purpose: "Resultado mínimo dos testes e prova nativa de Works/investigação SQLite"
path: "artifacts/evidence/ART-0004/payload"
sha256: "3816032ba0550cd18c16d9a05aeecd6f834d4847c91e1af79a60476af96ed024"
size: 2108
author: "Codex"
createdAt: "2026-11-22T12:43:35.892224Z"
@@ -0,0 +1,11 @@
# TSK-0004 — Works e investigação em SQLite
Implementados: configuração explícita storage=sqlite em ProjectConfig e initializeSqlite para projetos descartáveis; WorkService com busca direta, alocação transacional e localização estável; SqliteRecords com colunas escalares tipadas, listas em linhas ordenadas e estruturas operacionais por item, sem arquivo/Work inteiro serializado; RecordStorage preserva codecs e cadeias de revisão. Discussões, tópicos, surveys/respostas e disposições usam a mesma transação das referências do Work. Backend legado preservado; init público ainda não mudou.
Validação desta sessão:
- ./gradlew test --tests net.intrepid.aiengineering.SqliteInvestigationTest --tests net.intrepid.aiengineering.SqliteDatabaseTest --tests net.intrepid.aiengineering.WorkGuidanceTest --tests net.intrepid.aiengineering.RefinementSafetyTest --tests net.intrepid.aiengineering.CompatibilityTest --tests net.intrepid.aiengineering.ArchitectureTest --console=plain: BUILD SUCCESSFUL; 45 testes, zero falhas/erros/skips, incluindo 6 novos cenários de investigação SQLite.
- Outro processo JVM reconstituiu contexto com discussão UTF-8 e survey pendente. Testados rollback conjunto de filho e referência, encadeamento de revisões de tópico/survey, respostas supersedidas, escolha/pedido de DEC explícitos, duas criações locais concorrentes, renomeação sem mudar localização e leitura selecionada sem desserializar Work alheio inválido.
- nativeSqliteProbeCompile com GraalVM 25: BUILD SUCCESSFUL após incluir metadados AOT com dependência Gradle explícita. scripts/sqlite-probe.sh passou create/reopen de Work e discussão tipados em processos nativos separados, além da infraestrutura e biblioteca externa já verificadas.
- A execução nativa usa apenas diretórios descartáveis; nenhum instalador foi executado.
Próxima etapa: TSK-0005, decisões/planos/experimentos. A instalação ativa, o backend do workspace canônico e os consumidores permanecem intactos. Persistência de domínio completo e migração ainda não são declaradas prontas.
@@ -0,0 +1,12 @@
---
schemaVersion: 1
id: "ART-0005"
workId: "WRK-000D"
origin: "PLN-0001/TSK-0005"
purpose: "Resultado mínimo da persistência e checks de decisões/planos/experimentos\
\ SQLite"
path: "artifacts/evidence/ART-0005/payload"
sha256: "c339f321e05e9225e03895e515a925967dad9637ffb8754af4c4c4440c3b039f"
size: 1614
author: "Codex"
createdAt: "2026-11-22T12:54:08.349836Z"
@@ -0,0 +1,10 @@
# TSK-0005 — decisões, planos e experimentos SQLite
DecisionService e PlanService usam RecordStorage para registros/revisões. Aprovação/supersessão e promoção permitida na criação do Plan compartilham transação com o Plan e referências. Backend SQL não usa compensações por gravação de Markdown; backend legado preserva o fluxo existente. Metadados de ART foram integrados como suporte aos checks; bytes continuam externos e a limpeza será implementada no TSK-0008.
Verificação executada:
- Rodada selecionada de SqliteImplementationTest, SqliteInvestigationTest, PlanExperimentsTest, PlanDecisionPromotionTest, OperationalSafetyTest e ArchitectureTest: 34 testes, um teste novo falhou apenas na expectativa textual (buscava experiment, mas o check existente informa EXP-0001).
- Expectativa corrigida para identificar o EXP bloqueante. ./gradlew test --tests net.intrepid.aiengineering.SqliteImplementationTest --console=plain: BUILD SUCCESSFUL; os 5 testes passaram, zero falhas/erros/skips. Os demais testes da rodada ampla já haviam passado; 34 cenários distintos cobertos ao final.
- Exercitados: exigência de aprovação humana; conteúdo aceito imutável; revisões/UTF-8; dependências; experimentos abertos e retry com reconsideração; evidência real; supersessão que bloqueia execução até reconsiderar o Plan; rollback de promoção+Plan+referência e retry sem duplicar ou fabricar aprovação.
Sem instalação, ativação de novo backend no workspace real, migração de consumidores ou descarte do legado. Próximo: TSK-0006 — RUNs e coordenação de EPICs/Plans.
@@ -0,0 +1,11 @@
---
schemaVersion: 1
id: "ART-0006"
workId: "WRK-000D"
origin: "PLN-0001/TSK-0006"
purpose: "Resultados focados de RUNs, EPICs e coordenação em SQLite"
path: "artifacts/evidence/ART-0006/payload"
sha256: "0a76ae66f292c31a1e96381d23e052b112f4342bb2d411b18bca40684c151339"
size: 520
author: "Codex"
createdAt: "2026-11-22T13:02:06.489484Z"
@@ -0,0 +1,3 @@
TSK-0006: RUNs e EPICs em SQLite
30 cenários distintos passaram em duas rodadas focadas: SqliteCoordinationTest (5), EpicWorkflowTest (6), EpicSafetyTest (9), RefinementSafetyTest (9), ArchitectureTest (1). Comandos: ./gradlew test --tests ... --console=plain. RUNs idempotentes; trigger SQL confirma rollback integral com diagnóstico posterior. EPIC RESULTS/DECOMPOSITION, autoridade, histórico, propagação/reabertura e consolidação por Plans preservados. Sem instalação nativa ou migração deste workspace.
@@ -0,0 +1,11 @@
---
schemaVersion: 1
id: "ART-0007"
workId: "WRK-000D"
origin: "PLN-0001/TSK-0007"
purpose: "Resultados de gates cumulativos e vinculados ao estado"
path: "artifacts/evidence/ART-0007/payload"
sha256: "2e024d13c3cf349df3ef3e6fd335eb79d1e1da94ae21671cfee632b0f6f950c2"
size: 563
author: "Codex"
createdAt: "2026-11-22T13:08:06.641638Z"
@@ -0,0 +1,3 @@
TSK-0007: gates do projeto + Work
./gradlew test --tests *SqliteQualityGatesTest --tests *SqliteCoordinationTest --tests *SqliteDatabaseTest --tests *ArchitectureTest --console=plain: BUILD SUCCESSFUL, 23 cenários. Verificados gates cumulativos, bloqueio por pendência/falha, fingerprint de fontes/escopo/DEC, recusa de resultado obsoleto, evidência obrigatória íntegra, observação explícita, conclusão automática condicionada e snapshot histórico com detecção de alteração. Nenhum executor de repositório, instalação ativa ou migração real.
@@ -0,0 +1,11 @@
---
schemaVersion: 1
id: "ART-0008"
workId: "WRK-000D"
origin: "PLN-0001/TSK-0008"
purpose: "Prova do ciclo recuperável dos anexos temporários"
path: "artifacts/evidence/ART-0008/payload"
sha256: "9bad92fc4bc4804167f2637699cd3dee1c33f62fec6f0a91707aff962b41f143"
size: 618
author: "Codex"
createdAt: "2026-11-22T13:16:11.708988Z"
@@ -0,0 +1,3 @@
TSK-0008 / EXP-0002: ciclo de anexos temporários
32 cenários distintos passaram nas rodadas focadas: SqliteArtifactLifecycleTest (9), SqliteQualityGatesTest (5), SqliteCoordinationTest (5), SqliteDatabaseTest (12), ArchitectureTest (1). BUILD SUCCESSFUL. Retenção durante checks, descarte somente após commit, rollback sem apagar entradas, recuperação após commit/unlink e publicação órfã, retry sem duplicação, recusa de reuso de evidência aposentada, outputs externos intactos e originais legados preservados. Recibos internos tipados, sem payload JSON. Instalação e workspace reais não migrados.
@@ -0,0 +1,11 @@
---
schemaVersion: 1
id: "ART-0009"
workId: "WRK-000D"
origin: "PLN-0001/TSK-0009"
purpose: "Resultados de consultas, snapshots e diagnóstico SQLite"
path: "artifacts/evidence/ART-0009/payload"
sha256: "5e76bdbb24b819727c7aa55710ad133db3aef54abee03e23963142cc9621d938"
size: 531
author: "Codex"
createdAt: "2026-11-22T13:23:21.359613Z"
@@ -0,0 +1,3 @@
TSK-0009: consultas SQLite
./gradlew test --tests *SqliteQueriesTest --tests *SqliteInvestigationTest --tests *SqliteQualityGatesTest --tests *ArchitectureTest --console=plain: 15 testes passaram. Contexto em outro JVM, snapshot com escrita concorrente, contexto selecionado apesar de outro Work inválido, leitura de histórico e recusa de schema não suportado, integridade global e leitura sem descarte. Rodada anterior de CompatibilityTest/coordenação/anexos/arquitetura também passou. Sem migração ou instalação real.
@@ -0,0 +1,11 @@
---
schemaVersion: 1
id: "ART-0010"
workId: "WRK-000D"
origin: "PLN-0001/TSK-0010"
purpose: "Prova de migração e recuperação em fixtures"
path: "artifacts/evidence/ART-0010/payload"
sha256: "c962195302f83a24932413c4e4991284c29a29d6b374268f15ed95e96bf0673d"
size: 749
author: "Codex"
createdAt: "2026-11-22T13:38:16.617539Z"
@@ -0,0 +1,3 @@
TSK-0010 / EXP-0003: migração explícita e recuperável
Rodada final: ./gradlew test --tests *StorageMigrationTest --tests *CompatibilityTest --tests *SqliteImplementationTest --tests *SqliteInvestigationTest --tests *ArchitectureTest --console=plain: 34 testes passaram (13 de migração). Cinco fronteiras interrompidas retomaram; corpus congelado manteve hash 72d5803add0b8714d7dc4bf7e63ad55cc3259df910aa8b03790657eac4c2bd02, aprovações e bytes. Plans, surveys, EPICs, RUNs e IDs reservados preservados. Correção derivada da prova: preservar lista nula versus vazia. Staging limpo ao concluir, originais mantidos, mudanças legadas exigem nova prévia, rollback após nova escrita SQLite recusado. Nenhuma instalação ou migração real.
@@ -0,0 +1,11 @@
---
schemaVersion: 1
id: "ART-0011"
workId: "WRK-000D"
origin: "PLN-0001/TSK-0011"
purpose: "Resultados de init local e compatibilidade"
path: "artifacts/evidence/ART-0011/payload"
sha256: "f2bd87e9d928ce49f8bcaa3fd5ae55e49c6f8781c61d76890ac30b169be53244"
size: 627
author: "Codex"
createdAt: "2026-11-22T13:45:50.903749Z"
@@ -0,0 +1,3 @@
TSK-0011: init local e compatibilidade
Rodada consolidada SqliteInitTest, StorageMigrationTest, CompatibilityTest, ProtocolIntegrationTest e ArchitectureTest passou. Rodada separada de SqliteInitTest + ProcessContinuityTest + ArchitectureTest também passou (12 cenários, seis em processos JVM independentes, sem Git no PATH). Init prepara SQLite antes da publicação, preserva regras e ignora estado por padrão; --version-state mantém política própria. Legacy explícito, onboard não converte, contrato incompatível recusa escrita. Fixtures antigas agora declaram storage legacy. Sem instalação ou migração real.
@@ -0,0 +1,11 @@
---
schemaVersion: 1
id: "ART-0012"
workId: "WRK-000D"
origin: "PLN-0001/TSK-0012"
purpose: "Resultados do pacote preparado e instalador simulado"
path: "artifacts/evidence/ART-0012/payload"
sha256: "906a3047bb0430f307ada5420c02b6c3698a790587886c9f3d47365adfabca3c"
size: 693
author: "Codex"
createdAt: "2026-11-22T13:51:38.945560Z"
@@ -0,0 +1,3 @@
TSK-0012: pacote nativo preparado sem instalação
./gradlew [GraalVM 25 fixado] nativePackage: BUILD SUCCESSFUL; AIE nativo e bibliotecas + sqlite3 3.54.1 compilado de fonte oficial com SHA3 fixado. python3 scripts/verify-native-package.py build/native/package passou: hashes/versões, init descartável pelo AIE nativo e leitura da base com sqlite3 do pacote. python3 scripts/test-install-native.py: 17 testes passaram com ferramentas simuladas; diretórios/atalhos, biblioteca ausente/corrompida, atualização e falha parcial restauram instalação simulada. Plataforma física macOS arm64; Linux somente fixtures. Nenhum instalador real executado, nenhuma ativação ou migração real.
@@ -0,0 +1,11 @@
---
schemaVersion: 1
id: "ART-0013"
workId: "WRK-000D"
origin: "PLN-0001/TSK-0013"
purpose: "Verificação da documentação e recursos distribuídos"
path: "artifacts/evidence/ART-0013/payload"
sha256: "ff34868d7634deaf60467b56ac1ee73d7bafc70a7a3a9203e4fe5a72a182107c"
size: 554
author: "Codex"
createdAt: "2026-11-22T13:58:03.406806Z"
@@ -0,0 +1,3 @@
TSK-0013: documentação do framework local
README, arquitetura, protocolo/compatibilidade, recursos distribuídos e guias de domínio atualizados. Procedimento público docs/storage-migration.md cobre prévia, aplicação, recuperação e rollback. Referência de arquivos mantida como legado explícito. Links locais: OK. ./gradlew test --tests *SqliteInitTest --tests *CompatibilityTest --tests *WorkGuidanceTest --console=plain: BUILD SUCCESSFUL. Dois ciclos/OODA/autoridade preservados, retenção mínima e fronteiras de instalação explícitas.
@@ -0,0 +1,11 @@
---
schemaVersion: 1
id: "ART-0014"
workId: "WRK-000D"
origin: "PLN-0001/TSK-0014"
purpose: "Resultados finais dos gates, pacote e smoke nativo"
path: "artifacts/evidence/ART-0014/payload"
sha256: "808f3fac540afa13534fb625b77b92b076f68aad4e622f030221baaa9cd8236f"
size: 1127
author: "Codex"
createdAt: "2026-11-22T14:23:07.098606Z"
@@ -0,0 +1,7 @@
TSK-0014: regressão integrada e entrega
./gradlew check: 230 testes JVM, zero falhas/erros/skips; fixture Jenkins com 11 cenários passou. Ajuste final do importador: 17 testes focados de importação/recuperação/arquitetura passaram. Instalador: 17 fixtures finais passaram com ferramentas simuladas, incluindo recuperação de ativação parcial.
GraalVM gerou pacote e ZIP/TAR; componentes, hashes, versões e permissão executável verificados. Native smoke completo passou em macOS arm64, incluindo backend legado, guidance/OODA, SQLite/gates, descarte e migração histórica; diagnóstico de processos exigiu repetição autorizada fora do sandbox. Pacote isolado abriu SQLite sem extração temporária; ausência da biblioteca JDBC recusada. Linux/Windows físicos não executados nesta máquina.
Gerador de latência verificado com 1 Work/1 nota, sem benchmark; cenário em docs/latency-scenario.md encaminhado ao WRK-000C, que permanece aberto. Nenhuma instalação nativa real ou migração de workspace/consumidores. Workspace canônico segue contrato 3 sem aie.db. DEC respeitada, EXP-0001/2/3 confirmados.
@@ -0,0 +1,12 @@
---
schemaVersion: 1
id: "ART-0015"
workId: "WRK-000D"
origin: "ai-engineering:plans:d26d0825f0d98177995dcde3abadae702077096385b6692472e7f3d34ef4c17a"
purpose: "Deterministic aggregation of completed Plans and reviewed cancellations;\
\ not semantic verification of prose criteria"
path: "artifacts/evidence/ART-0015/payload"
sha256: "d26d0825f0d98177995dcde3abadae702077096385b6692472e7f3d34ef4c17a"
size: 284
author: "system:plans"
createdAt: "2026-11-22T14:23:22.737899Z"
@@ -0,0 +1,10 @@
{
"schemaVersion" : 1,
"workId" : "WRK-000D",
"inputHash" : "ca97695e9cd8cd557b48e25b8cbedb372ae7ef892fa164e59042c60892c25152",
"plans" : [ {
"id" : "PLN-0001",
"revision" : 51,
"sha256" : "35c51ecbaff2dc840635c4417a436323759783bf74ecbf552a0831cb09bdd222"
} ]
}
@@ -0,0 +1,238 @@
---
schemaVersion: 1
id: "DEC-0001"
workId: "WRK-000D"
title: "Adotar memória de engenharia local em SQLite com gates preservados e retenç\
ão mínima"
context: "O humano definiu AIE como memória local de engenharia por Work, com investigaç\
ão, implementação, OODA e entrega por gates de qualidade. Arquivos atuais geram\
\ acessos repetidos e retenção excessiva. Compartilhamento distribuído e integraç\
ão Git foram retirados deste recorte. Projetos em andamento impedem instalar ou\
\ substituir agora a distribuição nativa em uso."
approach: "Adotar SQLite por projeto como fonte principal; preservar os dois ciclos,\
\ autoridade e checks existentes, com anexos temporários e resultados mínimos persistidos.\
\ Migrar explicitamente com verificação e recuperação. Preparar pacote e script\
\ com AIE nativo e SQLite juntos, validar com fixtures e artefatos descartáveis\
\ e adiar instalação real até instrução humana específica. Manter .ai-engineering\
\ fora de Git por padrão e deixar importação/exportação e sincronização para etapa\
\ posterior."
alternatives: []
rationale: "A decisão concentra o AIE em continuidade e qualidade do trabalho, simplifica\
\ persistência e retenção e trata consistência entre registros com transações. Preserva\
\ histórico e regras humanas, limita mudanças nos consumidores e separa a adoçã\
o do armazenamento da futura comprovação de responsividade no WRK-000C."
risks: []
acceptanceCriteria: []
approvalStatus: "DRAFT"
author: "Codex"
createdAt: "2026-11-22T11:44:02.759315Z"
evidence: []
revision: 1
previousHash: null
updatedAt: "2026-11-22T11:44:02.759315Z"
updatedBy: "Codex"
changeReason: "Draft created"
approvals: []
revises: null
supersededBy: null
documentVersion: 2
---
# Memória de engenharia local com SQLite
## Contexto e objetivo
O AIE deve preservar conhecimento de engenharia por Work: contexto, discussão,
refinamento, decisões e suas justificativas, planos e resultados. A entrega depende
dos gates de qualidade estipulados. Auditoria e retenção de arquivos devem servir
a esse funcionamento com o mínimo necessário.
O armazenamento atual combina documentos e referências em arquivos, validações
repetidas e publicação atômica por arquivo. O WRK-000C registra latência percebida
em consultas e registros. Este Work trata a mudança de persistência; a avaliação
da latência será retomada separadamente após a entrega.
O uso desta versão é local. A discussão de colaboração demonstrou que contador
local e snapshot binário não resolvem criação independente e reconciliação entre
máquinas. Por escolha humana, sincronização e compartilhamento foram retirados
deste recorte, em favor de um framework local fora de Git por padrão.
## Decisão proposta
### 1. Fonte principal e acesso
- Manter uma base SQLite por projeto em `.ai-engineering/aie.db`.
- Persistir registros tipados, textos úteis e relações: Works, discussões, tópicos,
surveys e respostas, DECs e aprovações, Plans e passos, experimentos, coordenação
de EPICs, registros operacionais de execução e resultados dos gates.
- Usar tabelas, índices e restrições para as consultas e relações necessárias.
Consultar um Work não deve carregar todos os Works por conveniência de acesso.
- Textos e estruturas operacionais podem ser armazenados como dados de domínio;
conteúdo de arquivos não será convertido em BLOB, base64 ou TEXT equivalente.
- A CLI é a interface normal de leitura e alteração. Preservar comandos e formatos
públicos quando compatíveis; mudanças necessárias terão documentação explícita.
- Manter a descoberta do projeto, configuração e instruções de entrada em arquivos
pequenos quando necessários ao bootstrap. Eles não constituem uma segunda cópia
autoritativa da memória dos Works.
### 2. Ciclos, qualidade e autoridade
Preservar os dois ciclos existentes: investigação/discussão e implementação,
conectados por DEC e Plan. OODA continua adaptativo: observar resultados, orientar
a investigação, decidir e agir; reconsiderar hipóteses e replanejar quando houver
novas observações. Não criar quatro etapas burocráticas por ação.
Gates obrigatórios vêm do projeto e podem ser complementados por Work. Preservar
os checks existentes e os anexos exigidos durante a avaliação. Gate obrigatório
pendente, falho ou não executado impede a entrega. Registrar o resultado realmente
observado e o estado avaliado; alterações relevantes exigem reavaliar os gates
afetados. Aprovação humana continua distinta de sucesso técnico.
O registro mínimo de um gate identifica a verificação, a execução ou avaliação,
o estado/revisão relevante, o momento e o resultado com resumo curto. O registro
de execução de agente mantém o necessário para continuidade, idempotência e
diagnóstico. Não há obrigação de guardar transporte bruto ou logs completos.
Esta mudança não introduz um executor autônomo de comandos do repositório. A
execução externa e as responsabilidades de agentes/humanos seguem o contrato
aplicável; a persistência registra resultados e aplica os checks determinísticos.
### 3. Anexos, temporários e entregas
- Anexos de comprovação ficam no filesystem e podem continuar obrigatórios.
- Antes de descartar um anexo, concluir todos os checks que dele dependem e
persistir o resultado mínimo correspondente no banco.
- Ao terminar uma execução, limpar os temporários elegíveis automaticamente.
Arquivos ainda necessários a checks pendentes permanecem até esse uso terminar.
- Distinguir anexo temporário validado e legitimamente descartado de arquivo
perdido antes da avaliação. A consulta histórica usa o resultado persistido;
avaliações atuais continuam exigindo suas entradas.
- Em interrupções, não marcar checks como concluídos. A recuperação identifica
resíduos e respeita referências de operações ainda pendentes.
- Código alterado permanece no repositório. Documentos, imagens e outros outputs
solicitados são entregues no destino apropriado e preservados como entregas.
O AIE não exige uma cópia permanente adicional apenas por auditoria.
- Recibos internos necessários ao protocolo podem ter representação estruturada
no banco, preservando a proveniência histórica na migração.
### 4. Transações e concorrência local
Uma operação coerente de alteração usa transação SQLite, inclusive a atualização
de registros e referências relacionados. Habilitar integridade referencial em
cada conexão e tratar concorrência entre processos do mesmo projeto.
Manter transações curtas e espera de escrita limitada, com diagnóstico útil em
caso de contenção. Montar leituras relacionadas em uma visão consistente.
Escolher o modo de journal e os parâmetros de durabilidade com verificação na
plataforma alvo. Arquivos externos não integram a transação SQLite: sua publicação,
referência e remoção precisam de recuperação explícita quando houver interrupção.
### 5. Migração e compatibilidade
A migração do legado é uma operação pública explícita, com prévia, cópia de
segurança própria da migração e recuperação. Não converter projetos consumidores
automaticamente ao instalar, atualizar ou fazer uma consulta.
Preparar uma base separada, importar os registros tipados em transação e comparar
IDs, conteúdo, relações, aprovações, revisões e proveniência com o legado. Preservar
os hashes históricos e suas representações de origem quando necessários à leitura
e verificação de entregas antigas, sem fabricar novas aprovações ou despejar os
arquivos inteiros no banco. Trocar a fonte principal somente após validação.
Repetir uma tentativa não deve duplicar registros. Interrupções e falhas deixam a
fonte anterior recuperável; o comando informa o estado e a próxima ação. Registros
legados e originais de segurança não serão apagados retroativamente nesta mudança
sem disposição explícita.
Versionar o esquema da base e declarar o novo armazenamento no contrato público.
Formatos suportados, diagnóstico de compatibilidade e recusa de combinações
incompatíveis precisam ser explícitos. O bootstrap deve impedir que uma base nova
seja confundida com um projeto vazio ou alterada por uma CLI incompatível.
### 6. Instalação conjunta preparada, ativação adiada
Evoluir `scripts/install-native.sh` e seu empacotamento para distribuir o AIE
nativo, a biblioteca SQLite do driver e o executável `sqlite3` juntos em um
diretório configurável do usuário, com atalhos em `~/.local/bin`. Bancos de projeto
permanecem em `.ai-engineering/`, separados dos binários.
Usar a biblioteca/driver no processo AIE. O `sqlite3` do pacote serve à inspeção
e ao diagnóstico. Avaliar Xerial SQLite JDBC em prova JVM e Native Image;
fixar versão e plataforma compatíveis antes de consolidar a dependência.
Uma disposição recomendada para o pacote é `~/.local/lib/ai-engineering/`, com
atalhos `aie` e `ai-engineering` em `~/.local/bin`. O instalador deve verificar o
pacote completo antes de ativar uma atualização e preservar a instalação anterior
em falhas.
**Restrição humana vigente:** não executar instalação nativa, substituir atalhos,
binários ou bibliotecas da instalação em uso, nem migrar projetos consumidores.
Há projetos em andamento. Este Work pode preparar o script e o pacote e verificar
seu comportamento com fixtures e artefatos de build descartáveis após aprovação;
a instalação real e a ativação exigem uma instrução humana posterior específica.
### 7. Git e recortes futuros
O `init` deixa `.ai-engineering/` fora de Git por padrão e o framework funciona
sem Git. Preservar regras existentes e tornar explícito o tratamento de projetos
já versionados; não remover arquivos rastreados nem reescrever histórico Git
automaticamente. Versionar o estado fica a critério do desenvolvedor.
Ficam fora deste recorte: integração Git LFS, sincronização entre máquinas ou
branches, reconciliação distribuída, importação/exportação de Works ou DECs e
backup como funcionalidade. A cópia de segurança da migração é uma medida local
da conversão. O compartilhamento futuro de DECs tem interesse de produto, sem
reintroduzir colaboração distribuída nesta entrega.
## Condições de sucesso
1. Criar e retomar um Work em processos distintos usando SQLite local preserva
contexto, estado e autoridade nos dois ciclos e em suas transições.
2. Gates do projeto e adicionais do Work bloqueiam a entrega quando necessário;
anexos continuam disponíveis durante os checks e seu descarte legítimo não
invalida resultados históricos nem encobre falta de entrada antes da avaliação.
3. Migração em fixtures representativas preserva conteúdo, IDs, relações,
aprovações e proveniência; falhas, rollback e repetição não perdem nem duplicam
a memória de engenharia.
4. Rollback e concorrência local não publicam alterações relacionadas parcialmente
nem produzem espera ilimitada sem diagnóstico.
5. O projeto funciona sem Git; novas inicializações adotam estado local ignorado.
6. A prova JVM/nativa abre, grava, lê e reabre a base. O pacote contém os componentes
SQLite necessários e seu instalador é validado com fixtures, sem tocar a
instalação ativa ou projetos consumidores.
7. Testes de domínio, integração, compatibilidade, migração e smoke apropriados
verificam a mudança. Não guardar arquivos adicionais apenas para provar que
esses testes existiram.
8. Entregar um cenário reproduzível para retomar a avaliação de responsividade no
WRK-000C; adoção de SQLite não encerra automaticamente o ticket da demora.
## Riscos e adaptação permitida
A integração do driver com Native Image, a preservação das representações
históricas e a distinção entre descarte legítimo e perda de anexos são incertezas
técnicas. Devem ser investigadas com dados descartáveis e critérios prévios.
A implementação pode ajustar esquema, índices, transações e detalhes de build
dentro desses limites. Evidência que questione uma escolha significativa exige
reconsideração e revisão da DEC conforme a autoridade do Work. Preservar OODA e
a restrição de instalação durante essa adaptação.
## Fundamentação
- WRK-000D, DSC-0001 a DSC-0016 e respostas de SVY-0001/SVY-0002: escolhas humanas,
evolução de escopo, retenção mínima, uso local e restrição de instalação.
- WRK-000C, DSC-0004: inspeção estática dos acessos repetidos; não é benchmark nem
comprovação da causa integral da latência.
- Código atual: `WorkService`, `ArtifactService`, `VerificationService`,
`PlanCoordinator`, `EpicCoordinator`, `scripts/install-native.sh` e
`scripts/test-install-native.py`.
- [SQLite JDBC e Native Image](https://github.com/xerial/sqlite-jdbc#graalvm-native-image-support).
- [Transações SQLite](https://sqlite.org/lang_transaction.html) e
[integridade referencial](https://sqlite.org/foreignkeys.html).
## Estado de aprovação
DEC emitida em rascunho a pedido explícito de Nilton. Esse pedido autoriza a
emissão, não aprova antecipadamente seu conteúdo. Aprovação da DEC precede o Plan
e a implementação. A instalação real permanece adiada mesmo após eventual
aprovação desta decisão.
@@ -0,0 +1,247 @@
---
schemaVersion: 1
id: "DEC-0001"
workId: "WRK-000D"
title: "Adotar memória de engenharia local em SQLite com gates preservados e retenç\
ão mínima"
context: "O humano definiu AIE como memória local de engenharia por Work, com investigaç\
ão, implementação, OODA e entrega por gates de qualidade. Arquivos atuais geram\
\ acessos repetidos e retenção excessiva. Compartilhamento distribuído e integraç\
ão Git foram retirados deste recorte. Projetos em andamento impedem instalar ou\
\ substituir agora a distribuição nativa em uso."
approach: "Adotar SQLite por projeto como fonte principal; preservar os dois ciclos,\
\ autoridade e checks existentes, com anexos temporários e resultados mínimos persistidos.\
\ Migrar explicitamente com verificação e recuperação. Preparar pacote e script\
\ com AIE nativo e SQLite juntos, validar com fixtures e artefatos descartáveis\
\ e adiar instalação real até instrução humana específica. Manter .ai-engineering\
\ fora de Git por padrão e deixar importação/exportação e sincronização para etapa\
\ posterior."
alternatives: []
rationale: "A decisão concentra o AIE em continuidade e qualidade do trabalho, simplifica\
\ persistência e retenção e trata consistência entre registros com transações. Preserva\
\ histórico e regras humanas, limita mudanças nos consumidores e separa a adoçã\
o do armazenamento da futura comprovação de responsividade no WRK-000C."
risks: []
acceptanceCriteria: []
approvalStatus: "ACCEPTED"
author: "Codex"
createdAt: "2026-11-22T11:44:02.759315Z"
evidence: []
revision: 2
previousHash: "b0ac158915839dd73162f32c3f1ad1a8f39c2f5468a39a4e81e480b9333acabc"
updatedAt: "2026-11-22T11:49:21.244680Z"
updatedBy: "Nilton"
changeReason: "Aprovação explícita nesta conversa: aceitar a DEC e gerar um Plan dividido\
\ em vários steps. A instalação nativa e a migração de projetos consumidores permanecem\
\ adiadas conforme a DEC."
approvals:
- status: "ACCEPTED"
by: "Nilton"
reason: "Aprovação explícita nesta conversa: aceitar a DEC e gerar um Plan dividido\
\ em vários steps. A instalação nativa e a migração de projetos consumidores permanecem\
\ adiadas conforme a DEC."
at: "2026-11-22T11:49:21.244639Z"
humanApproved: true
revises: null
supersededBy: null
documentVersion: 2
---
# Memória de engenharia local com SQLite
## Contexto e objetivo
O AIE deve preservar conhecimento de engenharia por Work: contexto, discussão,
refinamento, decisões e suas justificativas, planos e resultados. A entrega depende
dos gates de qualidade estipulados. Auditoria e retenção de arquivos devem servir
a esse funcionamento com o mínimo necessário.
O armazenamento atual combina documentos e referências em arquivos, validações
repetidas e publicação atômica por arquivo. O WRK-000C registra latência percebida
em consultas e registros. Este Work trata a mudança de persistência; a avaliação
da latência será retomada separadamente após a entrega.
O uso desta versão é local. A discussão de colaboração demonstrou que contador
local e snapshot binário não resolvem criação independente e reconciliação entre
máquinas. Por escolha humana, sincronização e compartilhamento foram retirados
deste recorte, em favor de um framework local fora de Git por padrão.
## Decisão proposta
### 1. Fonte principal e acesso
- Manter uma base SQLite por projeto em `.ai-engineering/aie.db`.
- Persistir registros tipados, textos úteis e relações: Works, discussões, tópicos,
surveys e respostas, DECs e aprovações, Plans e passos, experimentos, coordenação
de EPICs, registros operacionais de execução e resultados dos gates.
- Usar tabelas, índices e restrições para as consultas e relações necessárias.
Consultar um Work não deve carregar todos os Works por conveniência de acesso.
- Textos e estruturas operacionais podem ser armazenados como dados de domínio;
conteúdo de arquivos não será convertido em BLOB, base64 ou TEXT equivalente.
- A CLI é a interface normal de leitura e alteração. Preservar comandos e formatos
públicos quando compatíveis; mudanças necessárias terão documentação explícita.
- Manter a descoberta do projeto, configuração e instruções de entrada em arquivos
pequenos quando necessários ao bootstrap. Eles não constituem uma segunda cópia
autoritativa da memória dos Works.
### 2. Ciclos, qualidade e autoridade
Preservar os dois ciclos existentes: investigação/discussão e implementação,
conectados por DEC e Plan. OODA continua adaptativo: observar resultados, orientar
a investigação, decidir e agir; reconsiderar hipóteses e replanejar quando houver
novas observações. Não criar quatro etapas burocráticas por ação.
Gates obrigatórios vêm do projeto e podem ser complementados por Work. Preservar
os checks existentes e os anexos exigidos durante a avaliação. Gate obrigatório
pendente, falho ou não executado impede a entrega. Registrar o resultado realmente
observado e o estado avaliado; alterações relevantes exigem reavaliar os gates
afetados. Aprovação humana continua distinta de sucesso técnico.
O registro mínimo de um gate identifica a verificação, a execução ou avaliação,
o estado/revisão relevante, o momento e o resultado com resumo curto. O registro
de execução de agente mantém o necessário para continuidade, idempotência e
diagnóstico. Não há obrigação de guardar transporte bruto ou logs completos.
Esta mudança não introduz um executor autônomo de comandos do repositório. A
execução externa e as responsabilidades de agentes/humanos seguem o contrato
aplicável; a persistência registra resultados e aplica os checks determinísticos.
### 3. Anexos, temporários e entregas
- Anexos de comprovação ficam no filesystem e podem continuar obrigatórios.
- Antes de descartar um anexo, concluir todos os checks que dele dependem e
persistir o resultado mínimo correspondente no banco.
- Ao terminar uma execução, limpar os temporários elegíveis automaticamente.
Arquivos ainda necessários a checks pendentes permanecem até esse uso terminar.
- Distinguir anexo temporário validado e legitimamente descartado de arquivo
perdido antes da avaliação. A consulta histórica usa o resultado persistido;
avaliações atuais continuam exigindo suas entradas.
- Em interrupções, não marcar checks como concluídos. A recuperação identifica
resíduos e respeita referências de operações ainda pendentes.
- Código alterado permanece no repositório. Documentos, imagens e outros outputs
solicitados são entregues no destino apropriado e preservados como entregas.
O AIE não exige uma cópia permanente adicional apenas por auditoria.
- Recibos internos necessários ao protocolo podem ter representação estruturada
no banco, preservando a proveniência histórica na migração.
### 4. Transações e concorrência local
Uma operação coerente de alteração usa transação SQLite, inclusive a atualização
de registros e referências relacionados. Habilitar integridade referencial em
cada conexão e tratar concorrência entre processos do mesmo projeto.
Manter transações curtas e espera de escrita limitada, com diagnóstico útil em
caso de contenção. Montar leituras relacionadas em uma visão consistente.
Escolher o modo de journal e os parâmetros de durabilidade com verificação na
plataforma alvo. Arquivos externos não integram a transação SQLite: sua publicação,
referência e remoção precisam de recuperação explícita quando houver interrupção.
### 5. Migração e compatibilidade
A migração do legado é uma operação pública explícita, com prévia, cópia de
segurança própria da migração e recuperação. Não converter projetos consumidores
automaticamente ao instalar, atualizar ou fazer uma consulta.
Preparar uma base separada, importar os registros tipados em transação e comparar
IDs, conteúdo, relações, aprovações, revisões e proveniência com o legado. Preservar
os hashes históricos e suas representações de origem quando necessários à leitura
e verificação de entregas antigas, sem fabricar novas aprovações ou despejar os
arquivos inteiros no banco. Trocar a fonte principal somente após validação.
Repetir uma tentativa não deve duplicar registros. Interrupções e falhas deixam a
fonte anterior recuperável; o comando informa o estado e a próxima ação. Registros
legados e originais de segurança não serão apagados retroativamente nesta mudança
sem disposição explícita.
Versionar o esquema da base e declarar o novo armazenamento no contrato público.
Formatos suportados, diagnóstico de compatibilidade e recusa de combinações
incompatíveis precisam ser explícitos. O bootstrap deve impedir que uma base nova
seja confundida com um projeto vazio ou alterada por uma CLI incompatível.
### 6. Instalação conjunta preparada, ativação adiada
Evoluir `scripts/install-native.sh` e seu empacotamento para distribuir o AIE
nativo, a biblioteca SQLite do driver e o executável `sqlite3` juntos em um
diretório configurável do usuário, com atalhos em `~/.local/bin`. Bancos de projeto
permanecem em `.ai-engineering/`, separados dos binários.
Usar a biblioteca/driver no processo AIE. O `sqlite3` do pacote serve à inspeção
e ao diagnóstico. Avaliar Xerial SQLite JDBC em prova JVM e Native Image;
fixar versão e plataforma compatíveis antes de consolidar a dependência.
Uma disposição recomendada para o pacote é `~/.local/lib/ai-engineering/`, com
atalhos `aie` e `ai-engineering` em `~/.local/bin`. O instalador deve verificar o
pacote completo antes de ativar uma atualização e preservar a instalação anterior
em falhas.
**Restrição humana vigente:** não executar instalação nativa, substituir atalhos,
binários ou bibliotecas da instalação em uso, nem migrar projetos consumidores.
Há projetos em andamento. Este Work pode preparar o script e o pacote e verificar
seu comportamento com fixtures e artefatos de build descartáveis após aprovação;
a instalação real e a ativação exigem uma instrução humana posterior específica.
### 7. Git e recortes futuros
O `init` deixa `.ai-engineering/` fora de Git por padrão e o framework funciona
sem Git. Preservar regras existentes e tornar explícito o tratamento de projetos
já versionados; não remover arquivos rastreados nem reescrever histórico Git
automaticamente. Versionar o estado fica a critério do desenvolvedor.
Ficam fora deste recorte: integração Git LFS, sincronização entre máquinas ou
branches, reconciliação distribuída, importação/exportação de Works ou DECs e
backup como funcionalidade. A cópia de segurança da migração é uma medida local
da conversão. O compartilhamento futuro de DECs tem interesse de produto, sem
reintroduzir colaboração distribuída nesta entrega.
## Condições de sucesso
1. Criar e retomar um Work em processos distintos usando SQLite local preserva
contexto, estado e autoridade nos dois ciclos e em suas transições.
2. Gates do projeto e adicionais do Work bloqueiam a entrega quando necessário;
anexos continuam disponíveis durante os checks e seu descarte legítimo não
invalida resultados históricos nem encobre falta de entrada antes da avaliação.
3. Migração em fixtures representativas preserva conteúdo, IDs, relações,
aprovações e proveniência; falhas, rollback e repetição não perdem nem duplicam
a memória de engenharia.
4. Rollback e concorrência local não publicam alterações relacionadas parcialmente
nem produzem espera ilimitada sem diagnóstico.
5. O projeto funciona sem Git; novas inicializações adotam estado local ignorado.
6. A prova JVM/nativa abre, grava, lê e reabre a base. O pacote contém os componentes
SQLite necessários e seu instalador é validado com fixtures, sem tocar a
instalação ativa ou projetos consumidores.
7. Testes de domínio, integração, compatibilidade, migração e smoke apropriados
verificam a mudança. Não guardar arquivos adicionais apenas para provar que
esses testes existiram.
8. Entregar um cenário reproduzível para retomar a avaliação de responsividade no
WRK-000C; adoção de SQLite não encerra automaticamente o ticket da demora.
## Riscos e adaptação permitida
A integração do driver com Native Image, a preservação das representações
históricas e a distinção entre descarte legítimo e perda de anexos são incertezas
técnicas. Devem ser investigadas com dados descartáveis e critérios prévios.
A implementação pode ajustar esquema, índices, transações e detalhes de build
dentro desses limites. Evidência que questione uma escolha significativa exige
reconsideração e revisão da DEC conforme a autoridade do Work. Preservar OODA e
a restrição de instalação durante essa adaptação.
## Fundamentação
- WRK-000D, DSC-0001 a DSC-0016 e respostas de SVY-0001/SVY-0002: escolhas humanas,
evolução de escopo, retenção mínima, uso local e restrição de instalação.
- WRK-000C, DSC-0004: inspeção estática dos acessos repetidos; não é benchmark nem
comprovação da causa integral da latência.
- Código atual: `WorkService`, `ArtifactService`, `VerificationService`,
`PlanCoordinator`, `EpicCoordinator`, `scripts/install-native.sh` e
`scripts/test-install-native.py`.
- [SQLite JDBC e Native Image](https://github.com/xerial/sqlite-jdbc#graalvm-native-image-support).
- [Transações SQLite](https://sqlite.org/lang_transaction.html) e
[integridade referencial](https://sqlite.org/foreignkeys.html).
## Estado de aprovação
DEC emitida em rascunho a pedido explícito de Nilton. Esse pedido autoriza a
emissão, não aprova antecipadamente seu conteúdo. Aprovação da DEC precede o Plan
e a implementação. A instalação real permanece adiada mesmo após eventual
aprovação desta decisão.
@@ -0,0 +1,13 @@
---
schemaVersion: 1
id: "DSC-0001"
workId: "WRK-000D"
discussionId: "main"
kind: "NOTE"
author: "Codex"
createdAt: "2026-11-22T10:45:08.099964Z"
respondsTo: null
documentVersion: 2
---
Origem: Nilton propôs explicitamente nesta conversa manter o ticket da demora WRK-000C, abrir um Work separado para a mudança para uma base consolidada como SQLite e retornar à latência depois, sob a ótica da nova base. Escolheu EXPLORATORY especificamente para este novo Work. O escopo deste ticket é a mudança de persistência, incluindo futura implementação e migração após decisão aprovada; os critérios iniciais são proposta a refinar durante a exploração. Contexto de origem no WRK-000C: DSC-0004 contém a inspeção estática dos acessos repetidos; DSC-0005 compara arquivos, índice reconstruível e SQLite canônico; DSC-0006 e DSC-0007 registram que Nilton não pretende editar os arquivos manualmente e favorece a direção de banco principal. A fonte de verdade atual continua sendo os arquivos; nenhuma migração foi executada. Primeiras questões: modelo e limites das transações; formato de histórico e preservação de hashes; evidências internas ou externas; migração e recuperação; exportação e backup; compatibilidade/distribuição JVM e Native Image. A latência permanece no WRK-000C e será reavaliada após a entrega desta mudança; não presumir solução apenas pela adoção de SQLite. A relação entre Works é registrada na discussão, sem inventar dependência formal ou transformar um deles em EPIC.
@@ -0,0 +1,13 @@
---
schemaVersion: 1
id: "DSC-0002"
workId: "WRK-000D"
discussionId: "TOP-0001"
kind: "NOTE"
author: "Nilton"
createdAt: "2026-11-22T10:48:14.674435Z"
respondsTo: null
documentVersion: 2
---
Preferência explícita nesta conversa: não gostaria de gravar os artefatos produzidos (run, output e outros) como blobs. Propõe que SQLite grave somente os textos pertinentes ao funcionamento do AIE e pergunta se essa fronteira faz sentido. A instrução orienta o escopo de persistência; não solicita encerrar a exploração nem aprova uma DEC concreta.
@@ -0,0 +1,13 @@
---
schemaVersion: 1
id: "DSC-0003"
workId: "WRK-000D"
discussionId: "TOP-0001"
kind: "NOTE"
author: "Codex"
createdAt: "2026-11-22T10:48:15.103274Z"
respondsTo: null
documentVersion: 2
---
Proposta baseada na inspeção do código atual: SQLite guarda estado estruturado, textos operacionais, relações, revisões, aprovações e metadados; filesystem guarda conteúdo de anexos, outputs, relatórios, logs e demais arquivos produzidos, inclusive os de formato textual. A fronteira é a função do conteúdo, não sua extensão: uma conclusão de experimento entra no banco; o log completo que a sustenta permanece em arquivo. Não serializar arquivos em BLOB, base64 ou grandes campos TEXT para contornar a restrição. Registros operacionais incluem números, timestamps e flags, não apenas colunas TEXT. Há duas coisas distintas chamadas run no desenho atual: agent-runs/RUN contém tarefa, executor/modelo, estado, sourceHash, proposta validada, referências aplicadas e proveniência necessárias ao funcionamento e replay idempotente (AgentRun.java e AgentService.java); runs/ contém resultados temporários ignorados (docs/protocol.md). A proposta é manter a parte operacional do RUN no banco e arquivos brutos fora dele. Conteúdo estruturado de proposta necessário a auditoria/replay deve ser preservado com esquema e limites explícitos, sem copiar todo transporte bruto. Hoje adapters descartam workspace temporário e não persistem stderr bruto; não introduzir retenção indiscriminada na migração. Artifact.java já separa metadados de bytes: ID local ao Work, workId, origem, finalidade, caminho, SHA-256, tamanho, autor e data; ArtifactService mantém payload no filesystem. Essa separação pode ser mantida, com metadados no banco e caminho relativo ao projeto, propriedade/identidade verificadas e bytes preservados. Outputs temporários não são evidência durável: promover explicitamente a artefato retido quando forem usados para comprovação, sem limpeza automática de evidências ou histórico. Recibos internos de conclusão/importação são registros do protocolo e podem ter representação estruturada no banco; originais históricos que participam de hashes permanecem preservados em arquivos, sem recalcular silenciosamente cadeias ou aprovações. Banco e arquivos externos não compartilham transação SQLite: para anexar, preparar e publicar arquivo completo e imutável antes de confirmar o registro no banco; falha intermediária pode deixar arquivo órfão diagnosticável, sem removê-lo automaticamente. Falta/alteração de arquivo referenciado deve gerar diagnóstico de integridade. Backup/restauração precisam cobrir uma visão consistente do banco e os arquivos por ela referenciados; copiar somente a base não é backup completo do projeto. Leituras rotineiras consultam metadados e conteúdo operacional necessários; validação integral de payloads tem escopo explícito, preservando os checks exigidos nas operações que dependem da evidência. Permanecem em exploração: layout e propriedade dos arquivos, promoção e retenção de outputs, compatibilidade dos hashes/recibos, transações de publicação e recuperação e política de backup. Nenhuma implementação ou migração realizada.
@@ -0,0 +1,13 @@
---
schemaVersion: 1
id: "DSC-0004"
workId: "WRK-000D"
discussionId: "TOP-0001"
kind: "NOTE"
author: "Nilton"
createdAt: "2026-11-22T11:03:13.616058Z"
respondsTo: null
documentVersion: 2
---
Reorientação explícita nesta conversa: não vê sentido em reter o conjunto de artefatos para auditoria. Considera suficiente atender aos gates de qualidade; para esta versão propõe reduzir drasticamente os artefatos armazenados pelo AIE e manter somente o output solicitado quando a entrega não for alteração de código. Observa que os artefatos se tornam obsoletos conforme novos Works são feitos. Considera útil preservar o trabalho no banco para consulta e possíveis lessons futuras. Sugere tornar configurável no init a política de Git: banco como binário referenciado por ponteiro ou diretório .ai-engineering completamente ignorado. Nenhuma das duas políticas foi escolhida como padrão. A mensagem revê as premissas das perguntas de retenção anteriores; não solicita apagar artefatos existentes nem encerrar exploração.
@@ -0,0 +1,13 @@
---
schemaVersion: 1
id: "DSC-0005"
workId: "WRK-000D"
discussionId: "TOP-0001"
kind: "NOTE"
author: "Codex"
createdAt: "2026-11-22T11:03:14.037888Z"
respondsTo: null
documentVersion: 2
---
Síntese e proposta revista: a retenção de evidências em arquivos não deve ser requisito obrigatório de novos Works apenas para auditoria. Para alterações em código, a entrega permanece no repositório; para entregas não relacionadas a código, manter somente os outputs solicitados no destino apropriado, sem cópia adicional obrigatória no AIE. Banco mantém conhecimento útil e estado operacional: escopo, discussão, decisões e justificativas, planos/resultados, aprovações e registro enxuto de gates observados. Proposta de registro de gate: identificação, invocação ou procedimento, revisão/estado do código avaliado quando aplicável, data, resultado e resumo curto; comandos realmente executados ou avaliações realmente feitas devem ser distinguíveis de intenção, sem persistir logs completos ou inventar sucesso. A aprovação humana continua separada do resultado do gate. Logs, payloads de transporte, relatórios intermediários e cópias de builds não são retidos por padrão; temporários de execuções ativas e falhas ainda precisam de ciclo de vida definido. Outputs solicitados não precisam ficar dentro de .ai-engineering; basta referência útil, sem comprometer conhecimento histórico caso um output seja posteriormente movido. Sem BLOB/base64 ou arquivos serializados em TEXT. Mudança exige revisão do contrato, não somente backend: Plan.Step atualmente exige evidence não vazio para COMPLETED; Work.CriterionResult e VerificationService.complete exigem ART por critério; PlanCoordinator e EpicCoordinator geram recibos externos. Propor substituir a obrigação de ART para novos registros por resultados estruturados e critérios/gates satisfeitos; preservar a leitura/proveniência do legado, sem excluir arquivos atuais ou alterar retroativamente entregas. Quanto a Git, propor config explícita no init: LOCAL com .ai-engineering ignorado, ou snapshot consistente versionado opcionalmente via Git LFS; default LOCAL ainda é recomendação. Git LFS armazena ponteiros no Git e conteúdo fora dele (https://git-lfs.com/); não mescla semanticamente duas bases SQLite. Recomenda-se versionar snapshot produzido por API de backup SQLite, em vez de tomar o arquivo de banco em uso como cópia completa: em WAL há arquivos auxiliares relevantes. Referências https://sqlite.org/backup.html e https://sqlite.org/wal.html . São alternativas configuráveis, sem executar Git, mudar ignore ou instalar LFS nesta discussão. Menor retenção é requisito funcional do WRK-000D, separado da futura medição de latência no WRK-000C. Possíveis lessons são uso futuro do conhecimento existente; não introduzir entidade ou fluxo obrigatório de lessons nesta versão.
@@ -0,0 +1,13 @@
---
schemaVersion: 1
id: "DSC-0006"
workId: "WRK-000D"
discussionId: "TOP-0001"
kind: "NOTE"
author: "Nilton"
createdAt: "2026-11-22T11:08:23.031938Z"
respondsTo: null
documentVersion: 2
---
Princípio de produto explicitamente afirmado nesta conversa: precisamos garantir os gates de qualidade estipulados, porém não precisamos de tanta auditoria e retenção de arquivos. AI-Engineering deve ser muito mais próximo de uma memória de engenharia, com discussão e afinamento por trabalho, que entrega por gates de qualidade. O foco não é auditoria; manter somente o mínimo. Esta orientação reforça a simplificação de retenção sem dispensar, enfraquecer ou considerar atendidos os gates por mera ausência de arquivos. Não solicita encerrar exploração nem aprova uma DEC concreta.
@@ -0,0 +1,13 @@
---
schemaVersion: 1
id: "DSC-0007"
workId: "WRK-000D"
discussionId: "TOP-0001"
kind: "NOTE"
author: "Codex"
createdAt: "2026-11-22T11:08:23.444959Z"
respondsTo: null
documentVersion: 2
---
Síntese orientadora: AIE é memória de engenharia por Work, com discussão/refinamento e entrega condicionada aos gates estipulados; auditoria é mínima e subordinada a essa finalidade. Proposta de funcionamento: definir os gates aplicáveis e sua condição de sucesso antes da avaliação; registrar o resultado efetivamente observado com identificação do gate, referência à versão/estado avaliado quando pertinente e resumo suficiente para continuidade; impedir entrega enquanto gate obrigatório estiver pendente ou falhar. Gates não executados não contam como atendidos. Mudanças relevantes após avaliação exigem reavaliar os gates afetados. Aprovação humana e resultado técnico permanecem conceitos distintos, respeitando a autoridade registrada no Work. Nenhum gate deve exigir retenção de log, anexo ART, recibo externo ou cópia de build apenas por auditoria; persistir no banco somente estado, relações, textos de engenharia e resultados operacionais necessários. Outputs solicitados são entregas; temporários e resíduos de execução não se tornam acervo permanente. Revisões e histórico do legado permanecem preservados durante esta exploração; não executar descarte retroativo. O nível mínimo de histórico futuro deve servir a retomada, justificativas e consulta, evitando um novo sistema de auditoria extensivo. Sem introduzir mecanismo de execução autônoma ou novos gates neste registro: integração, execução e avaliação dos gates serão detalhadas na discussão e na DEC quando solicitada pelo humano.
@@ -0,0 +1,13 @@
---
schemaVersion: 1
id: "DSC-0008"
workId: "WRK-000D"
discussionId: "TOP-0001"
kind: "NOTE"
author: "Nilton"
createdAt: "2026-11-22T11:09:54.902840Z"
respondsTo: null
documentVersion: 2
---
Esclarecimento explícito nesta conversa: os dois ciclos existentes, investigação e implementação, com uso de OODA, serão mantidos. A simplificação de auditoria, retenção de arquivos e adoção de SQLite não deve remover esses ciclos nem o caráter adaptativo do processo.
@@ -0,0 +1,13 @@
---
schemaVersion: 1
id: "DSC-0009"
workId: "WRK-000D"
discussionId: "TOP-0001"
kind: "NOTE"
author: "Nilton"
createdAt: "2026-11-22T11:11:08.043729Z"
respondsTo: null
documentVersion: 2
---
Escolha explícita de versionamento nesta conversa: Git LFS primeiro; exportação para backup será considerada depois, se necessário. Esta escolha substitui a recomendação anterior de LOCAL como padrão e retira exportação/backup como funcionalidade obrigatória desta versão. Não constitui aprovação de DEC concreta nem pedido para encerrar a exploração.
@@ -0,0 +1,13 @@
---
schemaVersion: 1
id: "DSC-0010"
workId: "WRK-000D"
discussionId: "TOP-0002"
kind: "NOTE"
author: "Nilton"
createdAt: "2026-11-22T11:21:47.081629Z"
respondsTo: null
documentVersion: 2
---
Respostas explícitas nesta conversa: (1) gates por projeto mais gates individuais por Work quando necessários; (4) sim ao descarte automático de temporários ao fim da execução. Os itens (2) momento de captura para LFS e (3) colaboração precisam de discussão adicional antes de prosseguir. Hoje o uso do AIE é individual, mas Nilton quer considerar compartilhamento com outras pessoas no mesmo projeto e relata que já há problemas no desenho atual: duas pessoas criando um Work em máquinas diferentes podem colidir. Não escolher um fluxo exclusivo de um escritor nem adiar essa questão sem discutir.
@@ -0,0 +1,13 @@
---
schemaVersion: 1
id: "DSC-0011"
workId: "WRK-000D"
discussionId: "TOP-0002"
kind: "NOTE"
author: "Codex"
createdAt: "2026-11-22T11:21:47.512328Z"
respondsTo: null
documentVersion: 2
---
Inspeção estática confirma origem da colisão de identidade: WorkService.createPrepared lê .sequence.yaml e o maior ID local, soma 1 e gera WRK-%04X sob Filespace.locked. O lock só coordena processos com a mesma área local; clones separados reservam o mesmo próximo ID sem se conhecer. WorkService.list rejeita IDs duplicados, mas não reconcilia Works diferentes com o mesmo ID. SQLite com contador local manteria esse problema. Além disso, UUIDs resolveriam geração independente de identidade com probabilidade desprezível de colisão, mas não a combinação de duas bases que divergiram. Recomenda-se discutir identidade completa distribuída (UUID de projeto e entidades) com referências humanas curtas como aliases desambiguáveis, preservando IDs/identidade histórica na migração. UUIDv4/v7 são candidatos, sem escolha final (RFC 9562: https://www.rfc-editor.org/rfc/rfc9562.html). A escolha Git LFS continua registrada para versionamento, porém não resolve sincronização semântica dos registros. Git oferece merge de binários como conflito ou driver próprio (https://git-scm.com/docs/gitattributes); lock LFS é lock de caminho no servidor, não reconciliação de alterações offline (https://raw.githubusercontent.com/git-lfs/git-lfs/main/docs/man/git-lfs-lock.adoc). Snapshot consistente resolve captura local, não combinação de conhecimento produzido separadamente. Alternativas a comparar: (A) SQLite local por participante com sincronização lógica dos registros pelo AIE e transporte via Git; exige representação de intercâmbio/driver de merge e regras de conflito, mesmo sem exportação de backup; (B) serviço compartilhado como autoridade com SQLite local opcional, trazendo infraestrutura e política online/offline, sujeito a revisão explícita da restrição atual sem servidor; (C) atualização serializada de um snapshot único sob lock, opção simples que restringe colaboração e não atende trabalho independente offline. Primeira hipótese recomendada para avaliar, se offline e ausência de servidor forem prioridades: SQLite local, IDs distribuídos, união idempotente de Works independentes e detecção de conflitos nos mesmos registros, sem last-write-wins para decisões, aprovações, critérios e gates. Entradas de discussão independentes podem ser combinadas por identidade; alterações concorrentes do mesmo escopo exigem resolução explícita e reavaliação das aprovações/gates afetados. Identificar um gate como passado em outra versão não satisfaz automaticamente o gate do código após merge. Precisamos esclarecer necessidade de trabalho offline e edição simultânea do mesmo Work para dimensionar colaboração antes de escolher captura/sync. A exigência de sincronização é de funcionamento e memória, não acervo de auditoria; não introduzir logs completos ou trilha infinita de eventos como solução automática. Nenhuma estratégia aprovada, código alterado, DEC ou migração executada.
@@ -0,0 +1,13 @@
---
schemaVersion: 1
id: "DSC-0012"
workId: "WRK-000D"
discussionId: "TOP-0002"
kind: "NOTE"
author: "Nilton"
createdAt: "2026-11-22T11:29:41.062263Z"
respondsTo: null
documentVersion: 2
---
Pivô explícito de produto nesta conversa: desenvolver o AI-Engineering como framework de trabalho local, com .ai-engineering fora de Git por padrão. Versionar o estado fica a critério do desenvolvedor. Importação e exportação de Works para compartilhar registros podem ser planejadas posteriormente, se necessário. DEC é o conteúdo mais interessante para compartilhar, pois orienta o trabalho, mas esse compartilhamento também fica para etapa posterior. A escolha substitui Git LFS como primeira estratégia obrigatória e retira sincronização entre máquinas e colaboração compartilhada do escopo desta versão. Preservar os dois ciclos, OODA, gates e memória de engenharia já definidos. Não há pedido explícito de encerramento da exploração nem aprovação de DEC concreta.
@@ -0,0 +1,13 @@
---
schemaVersion: 1
id: "DSC-0013"
workId: "WRK-000D"
discussionId: "TOP-0001"
kind: "NOTE"
author: "Nilton"
createdAt: "2026-11-22T11:37:40.902619Z"
respondsTo: null
documentVersion: 2
---
Esclarecimentos explícitos nesta conversa: (1) exigência de anexos pode continuar; devem ser tratados como temporários, e os checks podem permanecer como hoje. (2) o desenho da migração é delegado ao agente para investigação e proposta. (3) instalar executável nativo e SQLite juntos num mesmo diretório por script, semelhante ao instalador existente do AIE em ~/.local/bin. A escolha não pede uma instalação imediata nem encerra a exploração.
@@ -0,0 +1,13 @@
---
schemaVersion: 1
id: "DSC-0014"
workId: "WRK-000D"
discussionId: "TOP-0001"
kind: "NOTE"
author: "Codex"
createdAt: "2026-11-22T11:37:41.342432Z"
respondsTo: null
documentVersion: 2
---
Proposta ajustada: preservar a exigência de anexos e as condições dos checks durante a avaliação; anexos de comprovação são temporários e só podem ser descartados depois de todos os checks que deles dependem. Descarte ao fim da execução não pode remover arquivo que ainda é necessário a um gate pendente. Persistir no banco o resultado mínimo e referências/metadados necessários à memória; outputs solicitados continuam entregas. Hoje VerificationService.work revalida payloads e recibos inclusive em Works concluídos, portanto expurgo legítimo precisa ter tratamento de ciclo de vida para que consultas históricas distingam anexo temporário já validado de arquivo perdido antes da validação, sem dispensar checks ativos nem inventar sucesso. Ajuste funcional necessário é a temporalidade/retenção, não afrouxar qualidade. Recibos internos necessários ao funcionamento podem virar registros estruturados no banco. Migração proposta sob responsabilidade técnica do agente: usar cópia descartável do legado, importação transacional dos registros tipados, preservação de identidade, aprovações, relações e proveniência, comparação do contexto e do estado antes/depois e troca da fonte principal somente após validação; cópia de segurança de migração é separada de funcionalidade de exportação/backup. Não despejar arquivos inteiros em TEXT nem remover os originais durante exploração. Instalador existente confirmado: scripts/install-native.sh compila nativeCompile, instala ai-engineering em ~/.local/bin e cria aie como link; scripts/test-install-native.py cobre instalação em ambientes descartáveis. Proposta é evoluir esse script para instalar pacote nativo e dependências SQLite juntos em um diretório privado do usuário, mantendo atalhos em ~/.local/bin e bancos separados em .ai-engineering de cada projeto. SQLite possui motor/biblioteca e CLI sqlite3 distintos (https://sqlite.org/cli.html). Recomenda-se acesso por driver/biblioteca dentro do processo AIE; incluir sqlite3 junto ao pacote para inspeção e diagnóstico, sem usar um subprocesso para cada consulta. Driver Xerial declara suporte GraalVM Native Image e exportação da biblioteca no build para instalação ao lado do executável, evitando extração em cada execução (https://github.com/xerial/sqlite-jdbc#graalvm-native-image-support). Validar versão/plataforma e atualização conjunta do pacote; seleção final da dependência, layout e prova nativa permanecem investigação técnica. Não executar instalação, migração ou mudança de código nesta etapa.
@@ -0,0 +1,13 @@
---
schemaVersion: 1
id: "DSC-0015"
workId: "WRK-000D"
discussionId: "main"
kind: "NOTE"
author: "Codex"
createdAt: "2026-11-22T11:40:07.438598Z"
respondsTo: null
documentVersion: 2
---
Síntese técnica proposta após as respostas de Nilton: não há novas perguntas essenciais de produto identificadas. Discussão pode ser considerada madura para futura DEC, cujo pedido de criação e encerramento da exploração permanecem com o humano. Proposta concreta: (1) uma base .ai-engineering/aie.db por projeto, fora do Git por padrão, armazenando registros tipados, textos úteis e relações; tabelas e índices por identidade/Work/estado/referências, sem arquivos em BLOB/base64/TEXT e sem substituir toda a estrutura por um único documento serializado. Preservar interfaces públicas e regras de domínio tanto quanto possível, alterando a infraestrutura de persistência. (2) Avaliar Xerial SQLite JDBC como driver, começando por uma prova descartável JVM/Native Image que faça create/read/write/reopen e instale biblioteca ao lado do nativo; incluir CLI sqlite3 no pacote para diagnóstico. Fixar versão suportada e verificar plataforma; não prometer compatibilidade apenas pela documentação. (3) Usar transações curtas por operação coerente, integridade referencial explicitamente habilitada por conexão e espera de lock limitada com mensagem útil. Uma leitura de contexto utiliza uma transação coerente e consulta somente os dados necessários; definição de journal/configuração será validada em prova, sem supor ganho de desempenho automaticamente. (4) Gates atuais, inclusive anexos quando exigidos, permanecem durante avaliação; persistir resultado mínimo antes do descarte de anexos temporários, condicionado à inexistência de checks pendentes que os usem. Caso uma execução seja interrompida, não marcar gate como concluído e recuperar temporários remanescentes no ciclo de vida definido. Outputs solicitados permanecem entregas. (5) Migração explícita e repetível: prévia sem escrita, cópia de segurança de migração, importação transacional numa base de preparo, comparação de IDs/relações/conteúdo/aprovações/contexto com o legado e ativação apenas após verificação. Retentar não duplica registros; falha deixa a fonte anterior utilizável. Preservar hashes e proveniência históricos sem inventar nova aprovação nem manter cópias integrais de arquivos em TEXT. (6) Evoluir scripts/install-native.sh para diretório de instalação configurável com nativo, biblioteca SQLite e sqlite3 juntos, atalhos aie/ai-engineering em ~/.local/bin, instalação verificada antes de troca e bancos de projeto separados dos binários. (7) Validar principalmente continuidade entre processos, transações/rollback, preservação do legado, checks/gates e descarte legítimo, funcionamento sem Git, instalação/atualização e smoke nativo. WRK-000C recebe depois o cenário e as medições para tratar responsividade; esta entrega não comprova automaticamente a solução da latência. Fora deste recorte: Git LFS, sincronização distribuída, importação/exportação de Works/DECs e backup como funcionalidade. Fontes oficiais verificadas: https://github.com/xerial/sqlite-jdbc#graalvm-native-image-support ; https://sqlite.org/lang_transaction.html ; https://sqlite.org/foreignkeys.html ; https://sqlite.org/pragma.html#pragma_busy_timeout . Nenhuma DEC, Plan, instalação ou migração foi executada.
@@ -0,0 +1,13 @@
---
schemaVersion: 1
id: "DSC-0016"
workId: "WRK-000D"
discussionId: "main"
kind: "NOTE"
author: "Nilton"
createdAt: "2026-11-22T11:42:06.434625Z"
respondsTo: null
documentVersion: 2
---
Instrução explícita nesta conversa: não fazer a instalação nativa ainda, pois existem projetos em andamento usando o AIE instalado. Quanto ao restante da proposta, solicita emitir a DEC. Esta instrução autoriza preparar a decisão concreta; não é aprovação antecipada de seu conteúdo nem autorização para substituir o executável, bibliotecas ou instalação em uso.
@@ -0,0 +1,103 @@
---
schemaVersion: 1
id: "PLN-0001"
workId: "WRK-000D"
title: "Implementar memória de engenharia local em SQLite sem instalação ativa"
decisions:
- "DEC-0001"
steps: []
status: "OPEN"
author: "Codex"
createdAt: "2026-11-22T11:52:06.993736Z"
revision: 1
previousHash: null
updatedAt: "2026-11-22T11:52:06.993736Z"
updatedBy: "Codex"
changeReason: "Plan created"
documentVersion: 2
---
# Implementar memória de engenharia local em SQLite
## Autoridade e objetivo
Executar a DEC-0001 do WRK-000D, aceita explicitamente por Nilton nesta conversa.
O resultado é um framework local de memória de engenharia por Work, com SQLite
por projeto, investigação e implementação orientadas por OODA, gates preservados,
anexos temporários e retenção mínima. A aprovação desta DEC mantém a instalação
real adiada.
Este Plan foi solicitado com decomposição em vários steps. Todos os steps começam
OPEN; a criação do Plan não constitui execução ou comprovação de resultado.
## Limites obrigatórios
- Não instalar nem substituir o AIE, SQLite, bibliotecas ou atalhos em uso.
- Não executar o instalador real contra HOME, ~/.local/bin ou outro destino ativo.
Sua validação usa fixtures com ferramentas simuladas e destinos descartáveis.
- Não migrar este workspace canônico ou projetos consumidores. Exercitar o novo
backend e a migração em fixtures e cópias descartáveis; ativação real depende de
instrução humana posterior específica.
- Preservar alterações preexistentes, IDs, conteúdo e proveniência legada,
aprovações, evidências históricas e instruções do projeto fora do bloco gerido.
- Não introduzir arquivos em BLOB/base64 ou TEXT equivalente, retenção extensa,
executor autônomo de repositório, colaboração distribuída ou integração Git LFS.
- Importação/exportação de Works/DECs e backup como funcionalidade ficam fora.
A cópia de segurança da migração é parte da recuperação da conversão.
- Código e outputs solicitados permanecem nos destinos de entrega apropriados.
- O WRK-000C permanece aberto para avaliar e tratar latência após esta mudança.
## Execução e dependências
Os 14 steps possuem dependências explícitas e critérios próprios. Mapear primeiro
o contrato e o legado; provar a integração SQLite/JVM/Native Image; depois construir
as transações e migrar os fluxos de domínio. Integrar gates e ciclo dos anexos antes
de consolidar as consultas, a migração pública e o bootstrap. Preparar distribuição
e documentação e concluir com regressão integrada e encaminhamento ao WRK-000C.
Não iniciar um step com dependências pendentes. Verificações focadas fazem parte
de cada mudança; a última etapa integra os cenários e não substitui essas verificações.
Steps independentes podem ser executados em ordem compatível, sem presumir
autorização de delegação ou de instalação real.
## OODA e incertezas
Nas provas relevantes, principalmente driver/nativo, migração e descarte de anexos,
registrar hipótese, critério de sucesso e invocação antes de executar. Registrar
observação, interpretação e próxima ação após o resultado; reconsiderar antes de
repetir uma hipótese falha. Usar os registros de experimentos do Plan quando úteis,
sem impor um ritual de quatro fases a toda alteração.
Ajustar esquema, índices, transações e build dentro da DEC. Se um resultado
questionar a decisão, registrar a preocupação, continuar investigações autorizadas
e rever a DEC com aprovação aplicável antes da execução afetada.
## Verificação e registro mínimo
Durante a execução deste Work, respeitar o protocolo que está em uso. Registrar
resultados reais e evidência mínima necessária para completar os steps; não usar
a futura política de limpeza para apagar evidências legadas ou simular gates.
Verificar continuidade entre processos, integridade referencial, rollback,
concorrência local com espera limitada, autoridade humana, gates e anexos
temporários, migração repetível e operação sem Git. Provas nativas usam somente
artefatos de build e projetos descartáveis.
Comandos candidatos à validação, ajustados ao resultado e ao código final:
- `./gradlew test` e `./gradlew check` para a suíte e arquitetura do projeto.
- `python3 scripts/test-install-native.py` para fixtures do instalador.
- `./gradlew nativeCompile` e tarefas de distribuição para construir o pacote.
- `bash scripts/native-smoke.sh <caminho-absoluto-do-build>` em projetos descartáveis.
Esses comandos são planejados, não executados na criação do Plan. Preservar os
gates específicos do projeto e adicionais do Work definidos na execução. Logs de
trabalho podem ser temporários; guardar na memória somente o necessário ao contrato.
## Conclusão
Todos os steps obrigatórios devem satisfazer seus critérios, com a DEC aceita e
sem experimentos ou preocupações pendentes. A entrega é código, documentação,
pacote preparado e resultados de verificação. Não depende de instalar a nova
versão no ambiente em uso. Encaminhar ao WRK-000C um cenário reproduzível com
comandos, versão, volume e ambiente, sem declarar resolvido o problema de atraso.
@@ -0,0 +1,124 @@
---
schemaVersion: 1
id: "PLN-0001"
workId: "WRK-000D"
title: "Implementar memória de engenharia local em SQLite sem instalação ativa"
decisions:
- "DEC-0001"
steps:
- id: "TSK-0001"
title: "Mapear contrato, dados legados e cenários de migração"
description: "Inspecionar WorkService, serviços de Discussion/Decision/Plan/Agent,\
\ coordenadores e VerificationService. Mapear registros, referências, revisões,\
\ hashes, recibos e bootstrap para tabelas e regras do backend SQLite, preservando\
\ conteúdo e autoridade. Selecionar fixtures existentes de compatibilidade, workflows\
\ e importação como corpus; usar apenas cópias descartáveis. Identificar checks\
\ e pontos de retenção sem realizar benchmark conclusivo do WRK-000C."
acceptanceCriteria:
- "Mapeamento cobre entidades persistidas, IDs locais ao Work, referências, revisõ\
es, aprovações e casos de conclusão legada com hashes/recibos."
- "Corpus representativo e resultados esperados de continuidade/migração estão definidos\
\ antes da conversão, incluindo dados inválidos e estados interrompidos."
- "Limites de instalação, migração de consumidores e preservação do workspace atual\
\ estão explícitos e respeitados."
dependsOn: []
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:52:14.922292Z"
status: "OPEN"
author: "Codex"
createdAt: "2026-11-22T11:52:06.993736Z"
revision: 2
previousHash: "96fcb80d5c6936cf092e438986bfb435dd545f06cd6114d96f325eaf07d20087"
updatedAt: "2026-11-22T11:52:14.922357Z"
updatedBy: "Codex"
changeReason: "Decomposição solicitada por Nilton; DEC-0001 aceita, com instalaçã\
o real adiada."
documentVersion: 2
---
# Implementar memória de engenharia local em SQLite
## Autoridade e objetivo
Executar a DEC-0001 do WRK-000D, aceita explicitamente por Nilton nesta conversa.
O resultado é um framework local de memória de engenharia por Work, com SQLite
por projeto, investigação e implementação orientadas por OODA, gates preservados,
anexos temporários e retenção mínima. A aprovação desta DEC mantém a instalação
real adiada.
Este Plan foi solicitado com decomposição em vários steps. Todos os steps começam
OPEN; a criação do Plan não constitui execução ou comprovação de resultado.
## Limites obrigatórios
- Não instalar nem substituir o AIE, SQLite, bibliotecas ou atalhos em uso.
- Não executar o instalador real contra HOME, ~/.local/bin ou outro destino ativo.
Sua validação usa fixtures com ferramentas simuladas e destinos descartáveis.
- Não migrar este workspace canônico ou projetos consumidores. Exercitar o novo
backend e a migração em fixtures e cópias descartáveis; ativação real depende de
instrução humana posterior específica.
- Preservar alterações preexistentes, IDs, conteúdo e proveniência legada,
aprovações, evidências históricas e instruções do projeto fora do bloco gerido.
- Não introduzir arquivos em BLOB/base64 ou TEXT equivalente, retenção extensa,
executor autônomo de repositório, colaboração distribuída ou integração Git LFS.
- Importação/exportação de Works/DECs e backup como funcionalidade ficam fora.
A cópia de segurança da migração é parte da recuperação da conversão.
- Código e outputs solicitados permanecem nos destinos de entrega apropriados.
- O WRK-000C permanece aberto para avaliar e tratar latência após esta mudança.
## Execução e dependências
Os 14 steps possuem dependências explícitas e critérios próprios. Mapear primeiro
o contrato e o legado; provar a integração SQLite/JVM/Native Image; depois construir
as transações e migrar os fluxos de domínio. Integrar gates e ciclo dos anexos antes
de consolidar as consultas, a migração pública e o bootstrap. Preparar distribuição
e documentação e concluir com regressão integrada e encaminhamento ao WRK-000C.
Não iniciar um step com dependências pendentes. Verificações focadas fazem parte
de cada mudança; a última etapa integra os cenários e não substitui essas verificações.
Steps independentes podem ser executados em ordem compatível, sem presumir
autorização de delegação ou de instalação real.
## OODA e incertezas
Nas provas relevantes, principalmente driver/nativo, migração e descarte de anexos,
registrar hipótese, critério de sucesso e invocação antes de executar. Registrar
observação, interpretação e próxima ação após o resultado; reconsiderar antes de
repetir uma hipótese falha. Usar os registros de experimentos do Plan quando úteis,
sem impor um ritual de quatro fases a toda alteração.
Ajustar esquema, índices, transações e build dentro da DEC. Se um resultado
questionar a decisão, registrar a preocupação, continuar investigações autorizadas
e rever a DEC com aprovação aplicável antes da execução afetada.
## Verificação e registro mínimo
Durante a execução deste Work, respeitar o protocolo que está em uso. Registrar
resultados reais e evidência mínima necessária para completar os steps; não usar
a futura política de limpeza para apagar evidências legadas ou simular gates.
Verificar continuidade entre processos, integridade referencial, rollback,
concorrência local com espera limitada, autoridade humana, gates e anexos
temporários, migração repetível e operação sem Git. Provas nativas usam somente
artefatos de build e projetos descartáveis.
Comandos candidatos à validação, ajustados ao resultado e ao código final:
- `./gradlew test` e `./gradlew check` para a suíte e arquitetura do projeto.
- `python3 scripts/test-install-native.py` para fixtures do instalador.
- `./gradlew nativeCompile` e tarefas de distribuição para construir o pacote.
- `bash scripts/native-smoke.sh <caminho-absoluto-do-build>` em projetos descartáveis.
Esses comandos são planejados, não executados na criação do Plan. Preservar os
gates específicos do projeto e adicionais do Work definidos na execução. Logs de
trabalho podem ser temporários; guardar na memória somente o necessário ao contrato.
## Conclusão
Todos os steps obrigatórios devem satisfazer seus critérios, com a DEC aceita e
sem experimentos ou preocupações pendentes. A entrega é código, documentação,
pacote preparado e resultados de verificação. Não depende de instalar a nova
versão no ambiente em uso. Encaminhar ao WRK-000C um cenário reproduzível com
comandos, versão, volume e ambiente, sem declarar resolvido o problema de atraso.
@@ -0,0 +1,145 @@
---
schemaVersion: 1
id: "PLN-0001"
workId: "WRK-000D"
title: "Implementar memória de engenharia local em SQLite sem instalação ativa"
decisions:
- "DEC-0001"
steps:
- id: "TSK-0001"
title: "Mapear contrato, dados legados e cenários de migração"
description: "Inspecionar WorkService, serviços de Discussion/Decision/Plan/Agent,\
\ coordenadores e VerificationService. Mapear registros, referências, revisões,\
\ hashes, recibos e bootstrap para tabelas e regras do backend SQLite, preservando\
\ conteúdo e autoridade. Selecionar fixtures existentes de compatibilidade, workflows\
\ e importação como corpus; usar apenas cópias descartáveis. Identificar checks\
\ e pontos de retenção sem realizar benchmark conclusivo do WRK-000C."
acceptanceCriteria:
- "Mapeamento cobre entidades persistidas, IDs locais ao Work, referências, revisõ\
es, aprovações e casos de conclusão legada com hashes/recibos."
- "Corpus representativo e resultados esperados de continuidade/migração estão definidos\
\ antes da conversão, incluindo dados inválidos e estados interrompidos."
- "Limites de instalação, migração de consumidores e preservação do workspace atual\
\ estão explícitos e respeitados."
dependsOn: []
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:52:14.922292Z"
- id: "TSK-0002"
title: "Provar driver SQLite em JVM e Native Image"
description: "Avaliar Xerial SQLite JDBC e fixar versão compatível com Java, Gradle\
\ e GraalVM do projeto. Registrar hipótese, critério e invocação antes da prova.\
\ Criar, gravar, ler e reabrir uma base descartável em processos JVM e nativos.\
\ Verificar carregamento da biblioteca distribuída ao lado do nativo; sqlite3\
\ será ferramenta de diagnóstico do pacote. Construir e executar somente artefatos\
\ descartáveis, sem instalação real."
acceptanceCriteria:
- "Driver e versão selecionados demonstram persistência e reabertura em JVM e Native\
\ Image na plataforma alvo."
- "Biblioteca do pacote é encontrada por caminho controlado e não depende acidentalmente\
\ do SQLite global ou de extração repetida não planejada."
- "Hipótese, resultado e limitações da prova estão registrados; instalação ativa\
\ e projetos consumidores não foram alterados."
dependsOn:
- "TSK-0001"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:52:22.768410Z"
status: "OPEN"
author: "Codex"
createdAt: "2026-11-22T11:52:06.993736Z"
revision: 3
previousHash: "5e98ef835eec106eb218719eadbcd0ef99ea983815b9c7aa518ae770751f8610"
updatedAt: "2026-11-22T11:52:22.768476Z"
updatedBy: "Codex"
changeReason: "Decomposição solicitada por Nilton; DEC-0001 aceita, com instalaçã\
o real adiada."
documentVersion: 2
---
# Implementar memória de engenharia local em SQLite
## Autoridade e objetivo
Executar a DEC-0001 do WRK-000D, aceita explicitamente por Nilton nesta conversa.
O resultado é um framework local de memória de engenharia por Work, com SQLite
por projeto, investigação e implementação orientadas por OODA, gates preservados,
anexos temporários e retenção mínima. A aprovação desta DEC mantém a instalação
real adiada.
Este Plan foi solicitado com decomposição em vários steps. Todos os steps começam
OPEN; a criação do Plan não constitui execução ou comprovação de resultado.
## Limites obrigatórios
- Não instalar nem substituir o AIE, SQLite, bibliotecas ou atalhos em uso.
- Não executar o instalador real contra HOME, ~/.local/bin ou outro destino ativo.
Sua validação usa fixtures com ferramentas simuladas e destinos descartáveis.
- Não migrar este workspace canônico ou projetos consumidores. Exercitar o novo
backend e a migração em fixtures e cópias descartáveis; ativação real depende de
instrução humana posterior específica.
- Preservar alterações preexistentes, IDs, conteúdo e proveniência legada,
aprovações, evidências históricas e instruções do projeto fora do bloco gerido.
- Não introduzir arquivos em BLOB/base64 ou TEXT equivalente, retenção extensa,
executor autônomo de repositório, colaboração distribuída ou integração Git LFS.
- Importação/exportação de Works/DECs e backup como funcionalidade ficam fora.
A cópia de segurança da migração é parte da recuperação da conversão.
- Código e outputs solicitados permanecem nos destinos de entrega apropriados.
- O WRK-000C permanece aberto para avaliar e tratar latência após esta mudança.
## Execução e dependências
Os 14 steps possuem dependências explícitas e critérios próprios. Mapear primeiro
o contrato e o legado; provar a integração SQLite/JVM/Native Image; depois construir
as transações e migrar os fluxos de domínio. Integrar gates e ciclo dos anexos antes
de consolidar as consultas, a migração pública e o bootstrap. Preparar distribuição
e documentação e concluir com regressão integrada e encaminhamento ao WRK-000C.
Não iniciar um step com dependências pendentes. Verificações focadas fazem parte
de cada mudança; a última etapa integra os cenários e não substitui essas verificações.
Steps independentes podem ser executados em ordem compatível, sem presumir
autorização de delegação ou de instalação real.
## OODA e incertezas
Nas provas relevantes, principalmente driver/nativo, migração e descarte de anexos,
registrar hipótese, critério de sucesso e invocação antes de executar. Registrar
observação, interpretação e próxima ação após o resultado; reconsiderar antes de
repetir uma hipótese falha. Usar os registros de experimentos do Plan quando úteis,
sem impor um ritual de quatro fases a toda alteração.
Ajustar esquema, índices, transações e build dentro da DEC. Se um resultado
questionar a decisão, registrar a preocupação, continuar investigações autorizadas
e rever a DEC com aprovação aplicável antes da execução afetada.
## Verificação e registro mínimo
Durante a execução deste Work, respeitar o protocolo que está em uso. Registrar
resultados reais e evidência mínima necessária para completar os steps; não usar
a futura política de limpeza para apagar evidências legadas ou simular gates.
Verificar continuidade entre processos, integridade referencial, rollback,
concorrência local com espera limitada, autoridade humana, gates e anexos
temporários, migração repetível e operação sem Git. Provas nativas usam somente
artefatos de build e projetos descartáveis.
Comandos candidatos à validação, ajustados ao resultado e ao código final:
- `./gradlew test` e `./gradlew check` para a suíte e arquitetura do projeto.
- `python3 scripts/test-install-native.py` para fixtures do instalador.
- `./gradlew nativeCompile` e tarefas de distribuição para construir o pacote.
- `bash scripts/native-smoke.sh <caminho-absoluto-do-build>` em projetos descartáveis.
Esses comandos são planejados, não executados na criação do Plan. Preservar os
gates específicos do projeto e adicionais do Work definidos na execução. Logs de
trabalho podem ser temporários; guardar na memória somente o necessário ao contrato.
## Conclusão
Todos os steps obrigatórios devem satisfazer seus critérios, com a DEC aceita e
sem experimentos ou preocupações pendentes. A entrega é código, documentação,
pacote preparado e resultados de verificação. Não depende de instalar a nova
versão no ambiente em uso. Encaminhar ao WRK-000C um cenário reproduzível com
comandos, versão, volume e ambiente, sem declarar resolvido o problema de atraso.
@@ -0,0 +1,167 @@
---
schemaVersion: 1
id: "PLN-0001"
workId: "WRK-000D"
title: "Implementar memória de engenharia local em SQLite sem instalação ativa"
decisions:
- "DEC-0001"
steps:
- id: "TSK-0001"
title: "Mapear contrato, dados legados e cenários de migração"
description: "Inspecionar WorkService, serviços de Discussion/Decision/Plan/Agent,\
\ coordenadores e VerificationService. Mapear registros, referências, revisões,\
\ hashes, recibos e bootstrap para tabelas e regras do backend SQLite, preservando\
\ conteúdo e autoridade. Selecionar fixtures existentes de compatibilidade, workflows\
\ e importação como corpus; usar apenas cópias descartáveis. Identificar checks\
\ e pontos de retenção sem realizar benchmark conclusivo do WRK-000C."
acceptanceCriteria:
- "Mapeamento cobre entidades persistidas, IDs locais ao Work, referências, revisõ\
es, aprovações e casos de conclusão legada com hashes/recibos."
- "Corpus representativo e resultados esperados de continuidade/migração estão definidos\
\ antes da conversão, incluindo dados inválidos e estados interrompidos."
- "Limites de instalação, migração de consumidores e preservação do workspace atual\
\ estão explícitos e respeitados."
dependsOn: []
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:52:14.922292Z"
- id: "TSK-0002"
title: "Provar driver SQLite em JVM e Native Image"
description: "Avaliar Xerial SQLite JDBC e fixar versão compatível com Java, Gradle\
\ e GraalVM do projeto. Registrar hipótese, critério e invocação antes da prova.\
\ Criar, gravar, ler e reabrir uma base descartável em processos JVM e nativos.\
\ Verificar carregamento da biblioteca distribuída ao lado do nativo; sqlite3\
\ será ferramenta de diagnóstico do pacote. Construir e executar somente artefatos\
\ descartáveis, sem instalação real."
acceptanceCriteria:
- "Driver e versão selecionados demonstram persistência e reabertura em JVM e Native\
\ Image na plataforma alvo."
- "Biblioteca do pacote é encontrada por caminho controlado e não depende acidentalmente\
\ do SQLite global ou de extração repetida não planejada."
- "Hipótese, resultado e limitações da prova estão registrados; instalação ativa\
\ e projetos consumidores não foram alterados."
dependsOn:
- "TSK-0001"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:52:22.768410Z"
- id: "TSK-0003"
title: "Implementar esquema, conexões e transações SQLite"
description: "Criar infraestrutura de persistência local em .ai-engineering/aie.db\
\ com esquema versionado, tabelas tipadas, índices e relações. Habilitar integridade\
\ referencial em cada conexão, delimitar unidade transacional por operação coerente\
\ e usar leitura consistente. Definir journal/durabilidade e espera limitada de\
\ escrita com diagnóstico. Preservar limites de módulos; serviços aninhados devem\
\ compartilhar a transação aplicável."
acceptanceCriteria:
- "Esquema e índices atendem ao mapeamento sem BLOB/base64 ou arquivos completos\
\ serializados em TEXT."
- "Falha em operação relacionada causa rollback; referências inválidas são recusadas\
\ e gravações concorrentes têm contenção limitada e diagnóstico útil."
- "Abertura de esquema incompatível é diagnosticada sem alterar dados; teste de\
\ leitura consistente cobre mudanças concorrentes locais."
dependsOn:
- "TSK-0001"
- "TSK-0002"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:52:29.986202Z"
status: "OPEN"
author: "Codex"
createdAt: "2026-11-22T11:52:06.993736Z"
revision: 4
previousHash: "5a8fe04ac73648bc424f6df5fa1b6667463193979deaf0e57c8ec677ea1ad30e"
updatedAt: "2026-11-22T11:52:29.986274Z"
updatedBy: "Codex"
changeReason: "Decomposição solicitada por Nilton; DEC-0001 aceita, com instalaçã\
o real adiada."
documentVersion: 2
---
# Implementar memória de engenharia local em SQLite
## Autoridade e objetivo
Executar a DEC-0001 do WRK-000D, aceita explicitamente por Nilton nesta conversa.
O resultado é um framework local de memória de engenharia por Work, com SQLite
por projeto, investigação e implementação orientadas por OODA, gates preservados,
anexos temporários e retenção mínima. A aprovação desta DEC mantém a instalação
real adiada.
Este Plan foi solicitado com decomposição em vários steps. Todos os steps começam
OPEN; a criação do Plan não constitui execução ou comprovação de resultado.
## Limites obrigatórios
- Não instalar nem substituir o AIE, SQLite, bibliotecas ou atalhos em uso.
- Não executar o instalador real contra HOME, ~/.local/bin ou outro destino ativo.
Sua validação usa fixtures com ferramentas simuladas e destinos descartáveis.
- Não migrar este workspace canônico ou projetos consumidores. Exercitar o novo
backend e a migração em fixtures e cópias descartáveis; ativação real depende de
instrução humana posterior específica.
- Preservar alterações preexistentes, IDs, conteúdo e proveniência legada,
aprovações, evidências históricas e instruções do projeto fora do bloco gerido.
- Não introduzir arquivos em BLOB/base64 ou TEXT equivalente, retenção extensa,
executor autônomo de repositório, colaboração distribuída ou integração Git LFS.
- Importação/exportação de Works/DECs e backup como funcionalidade ficam fora.
A cópia de segurança da migração é parte da recuperação da conversão.
- Código e outputs solicitados permanecem nos destinos de entrega apropriados.
- O WRK-000C permanece aberto para avaliar e tratar latência após esta mudança.
## Execução e dependências
Os 14 steps possuem dependências explícitas e critérios próprios. Mapear primeiro
o contrato e o legado; provar a integração SQLite/JVM/Native Image; depois construir
as transações e migrar os fluxos de domínio. Integrar gates e ciclo dos anexos antes
de consolidar as consultas, a migração pública e o bootstrap. Preparar distribuição
e documentação e concluir com regressão integrada e encaminhamento ao WRK-000C.
Não iniciar um step com dependências pendentes. Verificações focadas fazem parte
de cada mudança; a última etapa integra os cenários e não substitui essas verificações.
Steps independentes podem ser executados em ordem compatível, sem presumir
autorização de delegação ou de instalação real.
## OODA e incertezas
Nas provas relevantes, principalmente driver/nativo, migração e descarte de anexos,
registrar hipótese, critério de sucesso e invocação antes de executar. Registrar
observação, interpretação e próxima ação após o resultado; reconsiderar antes de
repetir uma hipótese falha. Usar os registros de experimentos do Plan quando úteis,
sem impor um ritual de quatro fases a toda alteração.
Ajustar esquema, índices, transações e build dentro da DEC. Se um resultado
questionar a decisão, registrar a preocupação, continuar investigações autorizadas
e rever a DEC com aprovação aplicável antes da execução afetada.
## Verificação e registro mínimo
Durante a execução deste Work, respeitar o protocolo que está em uso. Registrar
resultados reais e evidência mínima necessária para completar os steps; não usar
a futura política de limpeza para apagar evidências legadas ou simular gates.
Verificar continuidade entre processos, integridade referencial, rollback,
concorrência local com espera limitada, autoridade humana, gates e anexos
temporários, migração repetível e operação sem Git. Provas nativas usam somente
artefatos de build e projetos descartáveis.
Comandos candidatos à validação, ajustados ao resultado e ao código final:
- `./gradlew test` e `./gradlew check` para a suíte e arquitetura do projeto.
- `python3 scripts/test-install-native.py` para fixtures do instalador.
- `./gradlew nativeCompile` e tarefas de distribuição para construir o pacote.
- `bash scripts/native-smoke.sh <caminho-absoluto-do-build>` em projetos descartáveis.
Esses comandos são planejados, não executados na criação do Plan. Preservar os
gates específicos do projeto e adicionais do Work definidos na execução. Logs de
trabalho podem ser temporários; guardar na memória somente o necessário ao contrato.
## Conclusão
Todos os steps obrigatórios devem satisfazer seus critérios, com a DEC aceita e
sem experimentos ou preocupações pendentes. A entrega é código, documentação,
pacote preparado e resultados de verificação. Não depende de instalar a nova
versão no ambiente em uso. Encaminhar ao WRK-000C um cenário reproduzível com
comandos, versão, volume e ambiente, sem declarar resolvido o problema de atraso.
@@ -0,0 +1,187 @@
---
schemaVersion: 1
id: "PLN-0001"
workId: "WRK-000D"
title: "Implementar memória de engenharia local em SQLite sem instalação ativa"
decisions:
- "DEC-0001"
steps:
- id: "TSK-0001"
title: "Mapear contrato, dados legados e cenários de migração"
description: "Inspecionar WorkService, serviços de Discussion/Decision/Plan/Agent,\
\ coordenadores e VerificationService. Mapear registros, referências, revisões,\
\ hashes, recibos e bootstrap para tabelas e regras do backend SQLite, preservando\
\ conteúdo e autoridade. Selecionar fixtures existentes de compatibilidade, workflows\
\ e importação como corpus; usar apenas cópias descartáveis. Identificar checks\
\ e pontos de retenção sem realizar benchmark conclusivo do WRK-000C."
acceptanceCriteria:
- "Mapeamento cobre entidades persistidas, IDs locais ao Work, referências, revisõ\
es, aprovações e casos de conclusão legada com hashes/recibos."
- "Corpus representativo e resultados esperados de continuidade/migração estão definidos\
\ antes da conversão, incluindo dados inválidos e estados interrompidos."
- "Limites de instalação, migração de consumidores e preservação do workspace atual\
\ estão explícitos e respeitados."
dependsOn: []
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:52:14.922292Z"
- id: "TSK-0002"
title: "Provar driver SQLite em JVM e Native Image"
description: "Avaliar Xerial SQLite JDBC e fixar versão compatível com Java, Gradle\
\ e GraalVM do projeto. Registrar hipótese, critério e invocação antes da prova.\
\ Criar, gravar, ler e reabrir uma base descartável em processos JVM e nativos.\
\ Verificar carregamento da biblioteca distribuída ao lado do nativo; sqlite3\
\ será ferramenta de diagnóstico do pacote. Construir e executar somente artefatos\
\ descartáveis, sem instalação real."
acceptanceCriteria:
- "Driver e versão selecionados demonstram persistência e reabertura em JVM e Native\
\ Image na plataforma alvo."
- "Biblioteca do pacote é encontrada por caminho controlado e não depende acidentalmente\
\ do SQLite global ou de extração repetida não planejada."
- "Hipótese, resultado e limitações da prova estão registrados; instalação ativa\
\ e projetos consumidores não foram alterados."
dependsOn:
- "TSK-0001"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:52:22.768410Z"
- id: "TSK-0003"
title: "Implementar esquema, conexões e transações SQLite"
description: "Criar infraestrutura de persistência local em .ai-engineering/aie.db\
\ com esquema versionado, tabelas tipadas, índices e relações. Habilitar integridade\
\ referencial em cada conexão, delimitar unidade transacional por operação coerente\
\ e usar leitura consistente. Definir journal/durabilidade e espera limitada de\
\ escrita com diagnóstico. Preservar limites de módulos; serviços aninhados devem\
\ compartilhar a transação aplicável."
acceptanceCriteria:
- "Esquema e índices atendem ao mapeamento sem BLOB/base64 ou arquivos completos\
\ serializados em TEXT."
- "Falha em operação relacionada causa rollback; referências inválidas são recusadas\
\ e gravações concorrentes têm contenção limitada e diagnóstico útil."
- "Abertura de esquema incompatível é diagnosticada sem alterar dados; teste de\
\ leitura consistente cobre mudanças concorrentes locais."
dependsOn:
- "TSK-0001"
- "TSK-0002"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:52:29.986202Z"
- id: "TSK-0004"
title: "Persistir Works e investigação no novo backend"
description: "Integrar Work, guidance e histórico de escolhas, discussões, tópicos,\
\ surveys, respostas e disposições à unidade de persistência. Preservar IDs existentes,\
\ semântica dos IDs locais, referências e histórico útil. Consultas selecionadas\
\ devem buscar o Work diretamente. Manter leitura legada delimitada para compatibilidade\
\ e migração; não manter duas fontes autoritativas para a mesma memória."
acceptanceCriteria:
- "Criar e retomar Work/discussão/survey em outro processo preserva conteúdo, histó\
rico de respostas e pendências."
- "Escolhas DIRECT/EXPLORATORY e autoridade humana mantêm as regras existentes,\
\ inclusive ausência de escolha e pedido específico de DEC."
- "Busca por Work e suas referências usa consultas com escopo adequado; alteraçõ\
es e referências relacionadas são transacionais."
dependsOn:
- "TSK-0003"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:52:37.091047Z"
status: "OPEN"
author: "Codex"
createdAt: "2026-11-22T11:52:06.993736Z"
revision: 5
previousHash: "5a41820703048e87fa2cab136c911a2460845b62cf85be0cb9bbc99a2a28f6e9"
updatedAt: "2026-11-22T11:52:37.091242Z"
updatedBy: "Codex"
changeReason: "Decomposição solicitada por Nilton; DEC-0001 aceita, com instalaçã\
o real adiada."
documentVersion: 2
---
# Implementar memória de engenharia local em SQLite
## Autoridade e objetivo
Executar a DEC-0001 do WRK-000D, aceita explicitamente por Nilton nesta conversa.
O resultado é um framework local de memória de engenharia por Work, com SQLite
por projeto, investigação e implementação orientadas por OODA, gates preservados,
anexos temporários e retenção mínima. A aprovação desta DEC mantém a instalação
real adiada.
Este Plan foi solicitado com decomposição em vários steps. Todos os steps começam
OPEN; a criação do Plan não constitui execução ou comprovação de resultado.
## Limites obrigatórios
- Não instalar nem substituir o AIE, SQLite, bibliotecas ou atalhos em uso.
- Não executar o instalador real contra HOME, ~/.local/bin ou outro destino ativo.
Sua validação usa fixtures com ferramentas simuladas e destinos descartáveis.
- Não migrar este workspace canônico ou projetos consumidores. Exercitar o novo
backend e a migração em fixtures e cópias descartáveis; ativação real depende de
instrução humana posterior específica.
- Preservar alterações preexistentes, IDs, conteúdo e proveniência legada,
aprovações, evidências históricas e instruções do projeto fora do bloco gerido.
- Não introduzir arquivos em BLOB/base64 ou TEXT equivalente, retenção extensa,
executor autônomo de repositório, colaboração distribuída ou integração Git LFS.
- Importação/exportação de Works/DECs e backup como funcionalidade ficam fora.
A cópia de segurança da migração é parte da recuperação da conversão.
- Código e outputs solicitados permanecem nos destinos de entrega apropriados.
- O WRK-000C permanece aberto para avaliar e tratar latência após esta mudança.
## Execução e dependências
Os 14 steps possuem dependências explícitas e critérios próprios. Mapear primeiro
o contrato e o legado; provar a integração SQLite/JVM/Native Image; depois construir
as transações e migrar os fluxos de domínio. Integrar gates e ciclo dos anexos antes
de consolidar as consultas, a migração pública e o bootstrap. Preparar distribuição
e documentação e concluir com regressão integrada e encaminhamento ao WRK-000C.
Não iniciar um step com dependências pendentes. Verificações focadas fazem parte
de cada mudança; a última etapa integra os cenários e não substitui essas verificações.
Steps independentes podem ser executados em ordem compatível, sem presumir
autorização de delegação ou de instalação real.
## OODA e incertezas
Nas provas relevantes, principalmente driver/nativo, migração e descarte de anexos,
registrar hipótese, critério de sucesso e invocação antes de executar. Registrar
observação, interpretação e próxima ação após o resultado; reconsiderar antes de
repetir uma hipótese falha. Usar os registros de experimentos do Plan quando úteis,
sem impor um ritual de quatro fases a toda alteração.
Ajustar esquema, índices, transações e build dentro da DEC. Se um resultado
questionar a decisão, registrar a preocupação, continuar investigações autorizadas
e rever a DEC com aprovação aplicável antes da execução afetada.
## Verificação e registro mínimo
Durante a execução deste Work, respeitar o protocolo que está em uso. Registrar
resultados reais e evidência mínima necessária para completar os steps; não usar
a futura política de limpeza para apagar evidências legadas ou simular gates.
Verificar continuidade entre processos, integridade referencial, rollback,
concorrência local com espera limitada, autoridade humana, gates e anexos
temporários, migração repetível e operação sem Git. Provas nativas usam somente
artefatos de build e projetos descartáveis.
Comandos candidatos à validação, ajustados ao resultado e ao código final:
- `./gradlew test` e `./gradlew check` para a suíte e arquitetura do projeto.
- `python3 scripts/test-install-native.py` para fixtures do instalador.
- `./gradlew nativeCompile` e tarefas de distribuição para construir o pacote.
- `bash scripts/native-smoke.sh <caminho-absoluto-do-build>` em projetos descartáveis.
Esses comandos são planejados, não executados na criação do Plan. Preservar os
gates específicos do projeto e adicionais do Work definidos na execução. Logs de
trabalho podem ser temporários; guardar na memória somente o necessário ao contrato.
## Conclusão
Todos os steps obrigatórios devem satisfazer seus critérios, com a DEC aceita e
sem experimentos ou preocupações pendentes. A entrega é código, documentação,
pacote preparado e resultados de verificação. Não depende de instalar a nova
versão no ambiente em uso. Encaminhar ao WRK-000C um cenário reproduzível com
comandos, versão, volume e ambiente, sem declarar resolvido o problema de atraso.
@@ -0,0 +1,207 @@
---
schemaVersion: 1
id: "PLN-0001"
workId: "WRK-000D"
title: "Implementar memória de engenharia local em SQLite sem instalação ativa"
decisions:
- "DEC-0001"
steps:
- id: "TSK-0001"
title: "Mapear contrato, dados legados e cenários de migração"
description: "Inspecionar WorkService, serviços de Discussion/Decision/Plan/Agent,\
\ coordenadores e VerificationService. Mapear registros, referências, revisões,\
\ hashes, recibos e bootstrap para tabelas e regras do backend SQLite, preservando\
\ conteúdo e autoridade. Selecionar fixtures existentes de compatibilidade, workflows\
\ e importação como corpus; usar apenas cópias descartáveis. Identificar checks\
\ e pontos de retenção sem realizar benchmark conclusivo do WRK-000C."
acceptanceCriteria:
- "Mapeamento cobre entidades persistidas, IDs locais ao Work, referências, revisõ\
es, aprovações e casos de conclusão legada com hashes/recibos."
- "Corpus representativo e resultados esperados de continuidade/migração estão definidos\
\ antes da conversão, incluindo dados inválidos e estados interrompidos."
- "Limites de instalação, migração de consumidores e preservação do workspace atual\
\ estão explícitos e respeitados."
dependsOn: []
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:52:14.922292Z"
- id: "TSK-0002"
title: "Provar driver SQLite em JVM e Native Image"
description: "Avaliar Xerial SQLite JDBC e fixar versão compatível com Java, Gradle\
\ e GraalVM do projeto. Registrar hipótese, critério e invocação antes da prova.\
\ Criar, gravar, ler e reabrir uma base descartável em processos JVM e nativos.\
\ Verificar carregamento da biblioteca distribuída ao lado do nativo; sqlite3\
\ será ferramenta de diagnóstico do pacote. Construir e executar somente artefatos\
\ descartáveis, sem instalação real."
acceptanceCriteria:
- "Driver e versão selecionados demonstram persistência e reabertura em JVM e Native\
\ Image na plataforma alvo."
- "Biblioteca do pacote é encontrada por caminho controlado e não depende acidentalmente\
\ do SQLite global ou de extração repetida não planejada."
- "Hipótese, resultado e limitações da prova estão registrados; instalação ativa\
\ e projetos consumidores não foram alterados."
dependsOn:
- "TSK-0001"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:52:22.768410Z"
- id: "TSK-0003"
title: "Implementar esquema, conexões e transações SQLite"
description: "Criar infraestrutura de persistência local em .ai-engineering/aie.db\
\ com esquema versionado, tabelas tipadas, índices e relações. Habilitar integridade\
\ referencial em cada conexão, delimitar unidade transacional por operação coerente\
\ e usar leitura consistente. Definir journal/durabilidade e espera limitada de\
\ escrita com diagnóstico. Preservar limites de módulos; serviços aninhados devem\
\ compartilhar a transação aplicável."
acceptanceCriteria:
- "Esquema e índices atendem ao mapeamento sem BLOB/base64 ou arquivos completos\
\ serializados em TEXT."
- "Falha em operação relacionada causa rollback; referências inválidas são recusadas\
\ e gravações concorrentes têm contenção limitada e diagnóstico útil."
- "Abertura de esquema incompatível é diagnosticada sem alterar dados; teste de\
\ leitura consistente cobre mudanças concorrentes locais."
dependsOn:
- "TSK-0001"
- "TSK-0002"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:52:29.986202Z"
- id: "TSK-0004"
title: "Persistir Works e investigação no novo backend"
description: "Integrar Work, guidance e histórico de escolhas, discussões, tópicos,\
\ surveys, respostas e disposições à unidade de persistência. Preservar IDs existentes,\
\ semântica dos IDs locais, referências e histórico útil. Consultas selecionadas\
\ devem buscar o Work diretamente. Manter leitura legada delimitada para compatibilidade\
\ e migração; não manter duas fontes autoritativas para a mesma memória."
acceptanceCriteria:
- "Criar e retomar Work/discussão/survey em outro processo preserva conteúdo, histó\
rico de respostas e pendências."
- "Escolhas DIRECT/EXPLORATORY e autoridade humana mantêm as regras existentes,\
\ inclusive ausência de escolha e pedido específico de DEC."
- "Busca por Work e suas referências usa consultas com escopo adequado; alteraçõ\
es e referências relacionadas são transacionais."
dependsOn:
- "TSK-0003"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:52:37.091047Z"
- id: "TSK-0005"
title: "Persistir decisões, planos e experimentos"
description: "Integrar DecisionService e PlanService com revisões, aceitação, supersessã\
o, passos, dependências e experimentos. Preservar os dois ciclos e OODA, a autoridade\
\ de DEC/Plan e a distinção entre aprovação humana e promoção permitida por polí\
tica. Tratar operações que alteram registros relacionados em uma transação, sem\
\ reduzir os checks de domínio."
acceptanceCriteria:
- "Aprovação, revisão e supersessão preservam autoria e referências, sem fabricaç\
ão de aprovação ou edição silenciosa de decisão aceita."
- "Dependências e estados de passos, critérios de experimentos, preocupações com\
\ DEC e replanejamento conservam os bloqueios existentes."
- "Interrupção simulada não publica meia supersessão ou promoção parcial; retomada\
\ em outro processo preserva o contexto."
dependsOn:
- "TSK-0004"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:52:43.954237Z"
status: "OPEN"
author: "Codex"
createdAt: "2026-11-22T11:52:06.993736Z"
revision: 6
previousHash: "28a7c87dce0f2e58035fc3f00d77a311c371b1b660b8403a7859e8954a3e7e52"
updatedAt: "2026-11-22T11:52:43.954322Z"
updatedBy: "Codex"
changeReason: "Decomposição solicitada por Nilton; DEC-0001 aceita, com instalaçã\
o real adiada."
documentVersion: 2
---
# Implementar memória de engenharia local em SQLite
## Autoridade e objetivo
Executar a DEC-0001 do WRK-000D, aceita explicitamente por Nilton nesta conversa.
O resultado é um framework local de memória de engenharia por Work, com SQLite
por projeto, investigação e implementação orientadas por OODA, gates preservados,
anexos temporários e retenção mínima. A aprovação desta DEC mantém a instalação
real adiada.
Este Plan foi solicitado com decomposição em vários steps. Todos os steps começam
OPEN; a criação do Plan não constitui execução ou comprovação de resultado.
## Limites obrigatórios
- Não instalar nem substituir o AIE, SQLite, bibliotecas ou atalhos em uso.
- Não executar o instalador real contra HOME, ~/.local/bin ou outro destino ativo.
Sua validação usa fixtures com ferramentas simuladas e destinos descartáveis.
- Não migrar este workspace canônico ou projetos consumidores. Exercitar o novo
backend e a migração em fixtures e cópias descartáveis; ativação real depende de
instrução humana posterior específica.
- Preservar alterações preexistentes, IDs, conteúdo e proveniência legada,
aprovações, evidências históricas e instruções do projeto fora do bloco gerido.
- Não introduzir arquivos em BLOB/base64 ou TEXT equivalente, retenção extensa,
executor autônomo de repositório, colaboração distribuída ou integração Git LFS.
- Importação/exportação de Works/DECs e backup como funcionalidade ficam fora.
A cópia de segurança da migração é parte da recuperação da conversão.
- Código e outputs solicitados permanecem nos destinos de entrega apropriados.
- O WRK-000C permanece aberto para avaliar e tratar latência após esta mudança.
## Execução e dependências
Os 14 steps possuem dependências explícitas e critérios próprios. Mapear primeiro
o contrato e o legado; provar a integração SQLite/JVM/Native Image; depois construir
as transações e migrar os fluxos de domínio. Integrar gates e ciclo dos anexos antes
de consolidar as consultas, a migração pública e o bootstrap. Preparar distribuição
e documentação e concluir com regressão integrada e encaminhamento ao WRK-000C.
Não iniciar um step com dependências pendentes. Verificações focadas fazem parte
de cada mudança; a última etapa integra os cenários e não substitui essas verificações.
Steps independentes podem ser executados em ordem compatível, sem presumir
autorização de delegação ou de instalação real.
## OODA e incertezas
Nas provas relevantes, principalmente driver/nativo, migração e descarte de anexos,
registrar hipótese, critério de sucesso e invocação antes de executar. Registrar
observação, interpretação e próxima ação após o resultado; reconsiderar antes de
repetir uma hipótese falha. Usar os registros de experimentos do Plan quando úteis,
sem impor um ritual de quatro fases a toda alteração.
Ajustar esquema, índices, transações e build dentro da DEC. Se um resultado
questionar a decisão, registrar a preocupação, continuar investigações autorizadas
e rever a DEC com aprovação aplicável antes da execução afetada.
## Verificação e registro mínimo
Durante a execução deste Work, respeitar o protocolo que está em uso. Registrar
resultados reais e evidência mínima necessária para completar os steps; não usar
a futura política de limpeza para apagar evidências legadas ou simular gates.
Verificar continuidade entre processos, integridade referencial, rollback,
concorrência local com espera limitada, autoridade humana, gates e anexos
temporários, migração repetível e operação sem Git. Provas nativas usam somente
artefatos de build e projetos descartáveis.
Comandos candidatos à validação, ajustados ao resultado e ao código final:
- `./gradlew test` e `./gradlew check` para a suíte e arquitetura do projeto.
- `python3 scripts/test-install-native.py` para fixtures do instalador.
- `./gradlew nativeCompile` e tarefas de distribuição para construir o pacote.
- `bash scripts/native-smoke.sh <caminho-absoluto-do-build>` em projetos descartáveis.
Esses comandos são planejados, não executados na criação do Plan. Preservar os
gates específicos do projeto e adicionais do Work definidos na execução. Logs de
trabalho podem ser temporários; guardar na memória somente o necessário ao contrato.
## Conclusão
Todos os steps obrigatórios devem satisfazer seus critérios, com a DEC aceita e
sem experimentos ou preocupações pendentes. A entrega é código, documentação,
pacote preparado e resultados de verificação. Não depende de instalar a nova
versão no ambiente em uso. Encaminhar ao WRK-000C um cenário reproduzível com
comandos, versão, volume e ambiente, sem declarar resolvido o problema de atraso.
@@ -0,0 +1,228 @@
---
schemaVersion: 1
id: "PLN-0001"
workId: "WRK-000D"
title: "Implementar memória de engenharia local em SQLite sem instalação ativa"
decisions:
- "DEC-0001"
steps:
- id: "TSK-0001"
title: "Mapear contrato, dados legados e cenários de migração"
description: "Inspecionar WorkService, serviços de Discussion/Decision/Plan/Agent,\
\ coordenadores e VerificationService. Mapear registros, referências, revisões,\
\ hashes, recibos e bootstrap para tabelas e regras do backend SQLite, preservando\
\ conteúdo e autoridade. Selecionar fixtures existentes de compatibilidade, workflows\
\ e importação como corpus; usar apenas cópias descartáveis. Identificar checks\
\ e pontos de retenção sem realizar benchmark conclusivo do WRK-000C."
acceptanceCriteria:
- "Mapeamento cobre entidades persistidas, IDs locais ao Work, referências, revisõ\
es, aprovações e casos de conclusão legada com hashes/recibos."
- "Corpus representativo e resultados esperados de continuidade/migração estão definidos\
\ antes da conversão, incluindo dados inválidos e estados interrompidos."
- "Limites de instalação, migração de consumidores e preservação do workspace atual\
\ estão explícitos e respeitados."
dependsOn: []
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:52:14.922292Z"
- id: "TSK-0002"
title: "Provar driver SQLite em JVM e Native Image"
description: "Avaliar Xerial SQLite JDBC e fixar versão compatível com Java, Gradle\
\ e GraalVM do projeto. Registrar hipótese, critério e invocação antes da prova.\
\ Criar, gravar, ler e reabrir uma base descartável em processos JVM e nativos.\
\ Verificar carregamento da biblioteca distribuída ao lado do nativo; sqlite3\
\ será ferramenta de diagnóstico do pacote. Construir e executar somente artefatos\
\ descartáveis, sem instalação real."
acceptanceCriteria:
- "Driver e versão selecionados demonstram persistência e reabertura em JVM e Native\
\ Image na plataforma alvo."
- "Biblioteca do pacote é encontrada por caminho controlado e não depende acidentalmente\
\ do SQLite global ou de extração repetida não planejada."
- "Hipótese, resultado e limitações da prova estão registrados; instalação ativa\
\ e projetos consumidores não foram alterados."
dependsOn:
- "TSK-0001"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:52:22.768410Z"
- id: "TSK-0003"
title: "Implementar esquema, conexões e transações SQLite"
description: "Criar infraestrutura de persistência local em .ai-engineering/aie.db\
\ com esquema versionado, tabelas tipadas, índices e relações. Habilitar integridade\
\ referencial em cada conexão, delimitar unidade transacional por operação coerente\
\ e usar leitura consistente. Definir journal/durabilidade e espera limitada de\
\ escrita com diagnóstico. Preservar limites de módulos; serviços aninhados devem\
\ compartilhar a transação aplicável."
acceptanceCriteria:
- "Esquema e índices atendem ao mapeamento sem BLOB/base64 ou arquivos completos\
\ serializados em TEXT."
- "Falha em operação relacionada causa rollback; referências inválidas são recusadas\
\ e gravações concorrentes têm contenção limitada e diagnóstico útil."
- "Abertura de esquema incompatível é diagnosticada sem alterar dados; teste de\
\ leitura consistente cobre mudanças concorrentes locais."
dependsOn:
- "TSK-0001"
- "TSK-0002"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:52:29.986202Z"
- id: "TSK-0004"
title: "Persistir Works e investigação no novo backend"
description: "Integrar Work, guidance e histórico de escolhas, discussões, tópicos,\
\ surveys, respostas e disposições à unidade de persistência. Preservar IDs existentes,\
\ semântica dos IDs locais, referências e histórico útil. Consultas selecionadas\
\ devem buscar o Work diretamente. Manter leitura legada delimitada para compatibilidade\
\ e migração; não manter duas fontes autoritativas para a mesma memória."
acceptanceCriteria:
- "Criar e retomar Work/discussão/survey em outro processo preserva conteúdo, histó\
rico de respostas e pendências."
- "Escolhas DIRECT/EXPLORATORY e autoridade humana mantêm as regras existentes,\
\ inclusive ausência de escolha e pedido específico de DEC."
- "Busca por Work e suas referências usa consultas com escopo adequado; alteraçõ\
es e referências relacionadas são transacionais."
dependsOn:
- "TSK-0003"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:52:37.091047Z"
- id: "TSK-0005"
title: "Persistir decisões, planos e experimentos"
description: "Integrar DecisionService e PlanService com revisões, aceitação, supersessã\
o, passos, dependências e experimentos. Preservar os dois ciclos e OODA, a autoridade\
\ de DEC/Plan e a distinção entre aprovação humana e promoção permitida por polí\
tica. Tratar operações que alteram registros relacionados em uma transação, sem\
\ reduzir os checks de domínio."
acceptanceCriteria:
- "Aprovação, revisão e supersessão preservam autoria e referências, sem fabricaç\
ão de aprovação ou edição silenciosa de decisão aceita."
- "Dependências e estados de passos, critérios de experimentos, preocupações com\
\ DEC e replanejamento conservam os bloqueios existentes."
- "Interrupção simulada não publica meia supersessão ou promoção parcial; retomada\
\ em outro processo preserva o contexto."
dependsOn:
- "TSK-0004"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:52:43.954237Z"
- id: "TSK-0006"
title: "Integrar execuções de agentes e coordenação de EPICs"
description: "Persistir RUNs e seus dados operacionais mínimos, idempotência de\
\ requestId, referências aplicadas e diagnóstico. Integrar PlanCoordinator/EpicCoordinator,\
\ políticas e proveniência de conclusão, representando recibos internos como dados\
\ estruturados quando aplicável. Preservar a fronteira do adaptador: propostas\
\ não aprovam DEC, não respondem pelo humano nem executam comandos de repositó\
rio."
acceptanceCriteria:
- "Repetição idempotente de uma solicitação concluída não duplica registros; solicitaç\
ões divergentes e estados interrompidos são diagnosticados."
- "Políticas RESULTS/DECOMPOSITION, delegação, reabertura, propagação e conclusã\
o por Plans preservam autoridade e proveniência."
- "Resultados estruturados necessários permanecem; transporte bruto, ambiente e\
\ logs completos não viram acervo permanente no banco."
dependsOn:
- "TSK-0005"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:52:50.899228Z"
status: "OPEN"
author: "Codex"
createdAt: "2026-11-22T11:52:06.993736Z"
revision: 7
previousHash: "2432f0ab223e793f269fac5db5e34a5d8072cd07d68bdd1a52204497bb37d8d2"
updatedAt: "2026-11-22T11:52:50.899331Z"
updatedBy: "Codex"
changeReason: "Decomposição solicitada por Nilton; DEC-0001 aceita, com instalaçã\
o real adiada."
documentVersion: 2
---
# Implementar memória de engenharia local em SQLite
## Autoridade e objetivo
Executar a DEC-0001 do WRK-000D, aceita explicitamente por Nilton nesta conversa.
O resultado é um framework local de memória de engenharia por Work, com SQLite
por projeto, investigação e implementação orientadas por OODA, gates preservados,
anexos temporários e retenção mínima. A aprovação desta DEC mantém a instalação
real adiada.
Este Plan foi solicitado com decomposição em vários steps. Todos os steps começam
OPEN; a criação do Plan não constitui execução ou comprovação de resultado.
## Limites obrigatórios
- Não instalar nem substituir o AIE, SQLite, bibliotecas ou atalhos em uso.
- Não executar o instalador real contra HOME, ~/.local/bin ou outro destino ativo.
Sua validação usa fixtures com ferramentas simuladas e destinos descartáveis.
- Não migrar este workspace canônico ou projetos consumidores. Exercitar o novo
backend e a migração em fixtures e cópias descartáveis; ativação real depende de
instrução humana posterior específica.
- Preservar alterações preexistentes, IDs, conteúdo e proveniência legada,
aprovações, evidências históricas e instruções do projeto fora do bloco gerido.
- Não introduzir arquivos em BLOB/base64 ou TEXT equivalente, retenção extensa,
executor autônomo de repositório, colaboração distribuída ou integração Git LFS.
- Importação/exportação de Works/DECs e backup como funcionalidade ficam fora.
A cópia de segurança da migração é parte da recuperação da conversão.
- Código e outputs solicitados permanecem nos destinos de entrega apropriados.
- O WRK-000C permanece aberto para avaliar e tratar latência após esta mudança.
## Execução e dependências
Os 14 steps possuem dependências explícitas e critérios próprios. Mapear primeiro
o contrato e o legado; provar a integração SQLite/JVM/Native Image; depois construir
as transações e migrar os fluxos de domínio. Integrar gates e ciclo dos anexos antes
de consolidar as consultas, a migração pública e o bootstrap. Preparar distribuição
e documentação e concluir com regressão integrada e encaminhamento ao WRK-000C.
Não iniciar um step com dependências pendentes. Verificações focadas fazem parte
de cada mudança; a última etapa integra os cenários e não substitui essas verificações.
Steps independentes podem ser executados em ordem compatível, sem presumir
autorização de delegação ou de instalação real.
## OODA e incertezas
Nas provas relevantes, principalmente driver/nativo, migração e descarte de anexos,
registrar hipótese, critério de sucesso e invocação antes de executar. Registrar
observação, interpretação e próxima ação após o resultado; reconsiderar antes de
repetir uma hipótese falha. Usar os registros de experimentos do Plan quando úteis,
sem impor um ritual de quatro fases a toda alteração.
Ajustar esquema, índices, transações e build dentro da DEC. Se um resultado
questionar a decisão, registrar a preocupação, continuar investigações autorizadas
e rever a DEC com aprovação aplicável antes da execução afetada.
## Verificação e registro mínimo
Durante a execução deste Work, respeitar o protocolo que está em uso. Registrar
resultados reais e evidência mínima necessária para completar os steps; não usar
a futura política de limpeza para apagar evidências legadas ou simular gates.
Verificar continuidade entre processos, integridade referencial, rollback,
concorrência local com espera limitada, autoridade humana, gates e anexos
temporários, migração repetível e operação sem Git. Provas nativas usam somente
artefatos de build e projetos descartáveis.
Comandos candidatos à validação, ajustados ao resultado e ao código final:
- `./gradlew test` e `./gradlew check` para a suíte e arquitetura do projeto.
- `python3 scripts/test-install-native.py` para fixtures do instalador.
- `./gradlew nativeCompile` e tarefas de distribuição para construir o pacote.
- `bash scripts/native-smoke.sh <caminho-absoluto-do-build>` em projetos descartáveis.
Esses comandos são planejados, não executados na criação do Plan. Preservar os
gates específicos do projeto e adicionais do Work definidos na execução. Logs de
trabalho podem ser temporários; guardar na memória somente o necessário ao contrato.
## Conclusão
Todos os steps obrigatórios devem satisfazer seus critérios, com a DEC aceita e
sem experimentos ou preocupações pendentes. A entrega é código, documentação,
pacote preparado e resultados de verificação. Não depende de instalar a nova
versão no ambiente em uso. Encaminhar ao WRK-000C um cenário reproduzível com
comandos, versão, volume e ambiente, sem declarar resolvido o problema de atraso.
@@ -0,0 +1,250 @@
---
schemaVersion: 1
id: "PLN-0001"
workId: "WRK-000D"
title: "Implementar memória de engenharia local em SQLite sem instalação ativa"
decisions:
- "DEC-0001"
steps:
- id: "TSK-0001"
title: "Mapear contrato, dados legados e cenários de migração"
description: "Inspecionar WorkService, serviços de Discussion/Decision/Plan/Agent,\
\ coordenadores e VerificationService. Mapear registros, referências, revisões,\
\ hashes, recibos e bootstrap para tabelas e regras do backend SQLite, preservando\
\ conteúdo e autoridade. Selecionar fixtures existentes de compatibilidade, workflows\
\ e importação como corpus; usar apenas cópias descartáveis. Identificar checks\
\ e pontos de retenção sem realizar benchmark conclusivo do WRK-000C."
acceptanceCriteria:
- "Mapeamento cobre entidades persistidas, IDs locais ao Work, referências, revisõ\
es, aprovações e casos de conclusão legada com hashes/recibos."
- "Corpus representativo e resultados esperados de continuidade/migração estão definidos\
\ antes da conversão, incluindo dados inválidos e estados interrompidos."
- "Limites de instalação, migração de consumidores e preservação do workspace atual\
\ estão explícitos e respeitados."
dependsOn: []
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:52:14.922292Z"
- id: "TSK-0002"
title: "Provar driver SQLite em JVM e Native Image"
description: "Avaliar Xerial SQLite JDBC e fixar versão compatível com Java, Gradle\
\ e GraalVM do projeto. Registrar hipótese, critério e invocação antes da prova.\
\ Criar, gravar, ler e reabrir uma base descartável em processos JVM e nativos.\
\ Verificar carregamento da biblioteca distribuída ao lado do nativo; sqlite3\
\ será ferramenta de diagnóstico do pacote. Construir e executar somente artefatos\
\ descartáveis, sem instalação real."
acceptanceCriteria:
- "Driver e versão selecionados demonstram persistência e reabertura em JVM e Native\
\ Image na plataforma alvo."
- "Biblioteca do pacote é encontrada por caminho controlado e não depende acidentalmente\
\ do SQLite global ou de extração repetida não planejada."
- "Hipótese, resultado e limitações da prova estão registrados; instalação ativa\
\ e projetos consumidores não foram alterados."
dependsOn:
- "TSK-0001"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:52:22.768410Z"
- id: "TSK-0003"
title: "Implementar esquema, conexões e transações SQLite"
description: "Criar infraestrutura de persistência local em .ai-engineering/aie.db\
\ com esquema versionado, tabelas tipadas, índices e relações. Habilitar integridade\
\ referencial em cada conexão, delimitar unidade transacional por operação coerente\
\ e usar leitura consistente. Definir journal/durabilidade e espera limitada de\
\ escrita com diagnóstico. Preservar limites de módulos; serviços aninhados devem\
\ compartilhar a transação aplicável."
acceptanceCriteria:
- "Esquema e índices atendem ao mapeamento sem BLOB/base64 ou arquivos completos\
\ serializados em TEXT."
- "Falha em operação relacionada causa rollback; referências inválidas são recusadas\
\ e gravações concorrentes têm contenção limitada e diagnóstico útil."
- "Abertura de esquema incompatível é diagnosticada sem alterar dados; teste de\
\ leitura consistente cobre mudanças concorrentes locais."
dependsOn:
- "TSK-0001"
- "TSK-0002"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:52:29.986202Z"
- id: "TSK-0004"
title: "Persistir Works e investigação no novo backend"
description: "Integrar Work, guidance e histórico de escolhas, discussões, tópicos,\
\ surveys, respostas e disposições à unidade de persistência. Preservar IDs existentes,\
\ semântica dos IDs locais, referências e histórico útil. Consultas selecionadas\
\ devem buscar o Work diretamente. Manter leitura legada delimitada para compatibilidade\
\ e migração; não manter duas fontes autoritativas para a mesma memória."
acceptanceCriteria:
- "Criar e retomar Work/discussão/survey em outro processo preserva conteúdo, histó\
rico de respostas e pendências."
- "Escolhas DIRECT/EXPLORATORY e autoridade humana mantêm as regras existentes,\
\ inclusive ausência de escolha e pedido específico de DEC."
- "Busca por Work e suas referências usa consultas com escopo adequado; alteraçõ\
es e referências relacionadas são transacionais."
dependsOn:
- "TSK-0003"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:52:37.091047Z"
- id: "TSK-0005"
title: "Persistir decisões, planos e experimentos"
description: "Integrar DecisionService e PlanService com revisões, aceitação, supersessã\
o, passos, dependências e experimentos. Preservar os dois ciclos e OODA, a autoridade\
\ de DEC/Plan e a distinção entre aprovação humana e promoção permitida por polí\
tica. Tratar operações que alteram registros relacionados em uma transação, sem\
\ reduzir os checks de domínio."
acceptanceCriteria:
- "Aprovação, revisão e supersessão preservam autoria e referências, sem fabricaç\
ão de aprovação ou edição silenciosa de decisão aceita."
- "Dependências e estados de passos, critérios de experimentos, preocupações com\
\ DEC e replanejamento conservam os bloqueios existentes."
- "Interrupção simulada não publica meia supersessão ou promoção parcial; retomada\
\ em outro processo preserva o contexto."
dependsOn:
- "TSK-0004"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:52:43.954237Z"
- id: "TSK-0006"
title: "Integrar execuções de agentes e coordenação de EPICs"
description: "Persistir RUNs e seus dados operacionais mínimos, idempotência de\
\ requestId, referências aplicadas e diagnóstico. Integrar PlanCoordinator/EpicCoordinator,\
\ políticas e proveniência de conclusão, representando recibos internos como dados\
\ estruturados quando aplicável. Preservar a fronteira do adaptador: propostas\
\ não aprovam DEC, não respondem pelo humano nem executam comandos de repositó\
rio."
acceptanceCriteria:
- "Repetição idempotente de uma solicitação concluída não duplica registros; solicitaç\
ões divergentes e estados interrompidos são diagnosticados."
- "Políticas RESULTS/DECOMPOSITION, delegação, reabertura, propagação e conclusã\
o por Plans preservam autoridade e proveniência."
- "Resultados estruturados necessários permanecem; transporte bruto, ambiente e\
\ logs completos não viram acervo permanente no banco."
dependsOn:
- "TSK-0005"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:52:50.899228Z"
- id: "TSK-0007"
title: "Integrar gates do projeto e adicionais por Work"
description: "Representar gates obrigatórios do projeto e complementos do Work e\
\ conectar seus resultados aos checks e à entrega. Preservar avaliação externa\
\ e condições de qualidade, inclusive anexos exigidos. Registrar identificaçã\
o, procedimento/execução, estado avaliado, momento e resultado mínimo. Alteraç\
ões pertinentes invalidam a aplicação do resultado aos gates afetados; aprovaç\
ão humana não equivale a sucesso técnico."
acceptanceCriteria:
- "Gate obrigatório pendente, falho ou não executado bloqueia a entrega; gates adicionais\
\ do Work são considerados sem dispensar obrigatórios do projeto."
- "Resultados correspondem ao estado realmente avaliado e não satisfazem silenciosamente\
\ um gate após mudança relevante."
- "Checks existentes e anexos necessários continuam exigidos durante avaliação,\
\ sem introduzir executor autônomo ou retenção bruta obrigatória."
dependsOn:
- "TSK-0005"
- "TSK-0006"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:52:58.285586Z"
status: "OPEN"
author: "Codex"
createdAt: "2026-11-22T11:52:06.993736Z"
revision: 8
previousHash: "58c2cfdd0506391bf10caa81aa7651deb5586e5683ef4a5ec2fb46158b8f139a"
updatedAt: "2026-11-22T11:52:58.285688Z"
updatedBy: "Codex"
changeReason: "Decomposição solicitada por Nilton; DEC-0001 aceita, com instalaçã\
o real adiada."
documentVersion: 2
---
# Implementar memória de engenharia local em SQLite
## Autoridade e objetivo
Executar a DEC-0001 do WRK-000D, aceita explicitamente por Nilton nesta conversa.
O resultado é um framework local de memória de engenharia por Work, com SQLite
por projeto, investigação e implementação orientadas por OODA, gates preservados,
anexos temporários e retenção mínima. A aprovação desta DEC mantém a instalação
real adiada.
Este Plan foi solicitado com decomposição em vários steps. Todos os steps começam
OPEN; a criação do Plan não constitui execução ou comprovação de resultado.
## Limites obrigatórios
- Não instalar nem substituir o AIE, SQLite, bibliotecas ou atalhos em uso.
- Não executar o instalador real contra HOME, ~/.local/bin ou outro destino ativo.
Sua validação usa fixtures com ferramentas simuladas e destinos descartáveis.
- Não migrar este workspace canônico ou projetos consumidores. Exercitar o novo
backend e a migração em fixtures e cópias descartáveis; ativação real depende de
instrução humana posterior específica.
- Preservar alterações preexistentes, IDs, conteúdo e proveniência legada,
aprovações, evidências históricas e instruções do projeto fora do bloco gerido.
- Não introduzir arquivos em BLOB/base64 ou TEXT equivalente, retenção extensa,
executor autônomo de repositório, colaboração distribuída ou integração Git LFS.
- Importação/exportação de Works/DECs e backup como funcionalidade ficam fora.
A cópia de segurança da migração é parte da recuperação da conversão.
- Código e outputs solicitados permanecem nos destinos de entrega apropriados.
- O WRK-000C permanece aberto para avaliar e tratar latência após esta mudança.
## Execução e dependências
Os 14 steps possuem dependências explícitas e critérios próprios. Mapear primeiro
o contrato e o legado; provar a integração SQLite/JVM/Native Image; depois construir
as transações e migrar os fluxos de domínio. Integrar gates e ciclo dos anexos antes
de consolidar as consultas, a migração pública e o bootstrap. Preparar distribuição
e documentação e concluir com regressão integrada e encaminhamento ao WRK-000C.
Não iniciar um step com dependências pendentes. Verificações focadas fazem parte
de cada mudança; a última etapa integra os cenários e não substitui essas verificações.
Steps independentes podem ser executados em ordem compatível, sem presumir
autorização de delegação ou de instalação real.
## OODA e incertezas
Nas provas relevantes, principalmente driver/nativo, migração e descarte de anexos,
registrar hipótese, critério de sucesso e invocação antes de executar. Registrar
observação, interpretação e próxima ação após o resultado; reconsiderar antes de
repetir uma hipótese falha. Usar os registros de experimentos do Plan quando úteis,
sem impor um ritual de quatro fases a toda alteração.
Ajustar esquema, índices, transações e build dentro da DEC. Se um resultado
questionar a decisão, registrar a preocupação, continuar investigações autorizadas
e rever a DEC com aprovação aplicável antes da execução afetada.
## Verificação e registro mínimo
Durante a execução deste Work, respeitar o protocolo que está em uso. Registrar
resultados reais e evidência mínima necessária para completar os steps; não usar
a futura política de limpeza para apagar evidências legadas ou simular gates.
Verificar continuidade entre processos, integridade referencial, rollback,
concorrência local com espera limitada, autoridade humana, gates e anexos
temporários, migração repetível e operação sem Git. Provas nativas usam somente
artefatos de build e projetos descartáveis.
Comandos candidatos à validação, ajustados ao resultado e ao código final:
- `./gradlew test` e `./gradlew check` para a suíte e arquitetura do projeto.
- `python3 scripts/test-install-native.py` para fixtures do instalador.
- `./gradlew nativeCompile` e tarefas de distribuição para construir o pacote.
- `bash scripts/native-smoke.sh <caminho-absoluto-do-build>` em projetos descartáveis.
Esses comandos são planejados, não executados na criação do Plan. Preservar os
gates específicos do projeto e adicionais do Work definidos na execução. Logs de
trabalho podem ser temporários; guardar na memória somente o necessário ao contrato.
## Conclusão
Todos os steps obrigatórios devem satisfazer seus critérios, com a DEC aceita e
sem experimentos ou preocupações pendentes. A entrega é código, documentação,
pacote preparado e resultados de verificação. Não depende de instalar a nova
versão no ambiente em uso. Encaminhar ao WRK-000C um cenário reproduzível com
comandos, versão, volume e ambiente, sem declarar resolvido o problema de atraso.
@@ -0,0 +1,271 @@
---
schemaVersion: 1
id: "PLN-0001"
workId: "WRK-000D"
title: "Implementar memória de engenharia local em SQLite sem instalação ativa"
decisions:
- "DEC-0001"
steps:
- id: "TSK-0001"
title: "Mapear contrato, dados legados e cenários de migração"
description: "Inspecionar WorkService, serviços de Discussion/Decision/Plan/Agent,\
\ coordenadores e VerificationService. Mapear registros, referências, revisões,\
\ hashes, recibos e bootstrap para tabelas e regras do backend SQLite, preservando\
\ conteúdo e autoridade. Selecionar fixtures existentes de compatibilidade, workflows\
\ e importação como corpus; usar apenas cópias descartáveis. Identificar checks\
\ e pontos de retenção sem realizar benchmark conclusivo do WRK-000C."
acceptanceCriteria:
- "Mapeamento cobre entidades persistidas, IDs locais ao Work, referências, revisõ\
es, aprovações e casos de conclusão legada com hashes/recibos."
- "Corpus representativo e resultados esperados de continuidade/migração estão definidos\
\ antes da conversão, incluindo dados inválidos e estados interrompidos."
- "Limites de instalação, migração de consumidores e preservação do workspace atual\
\ estão explícitos e respeitados."
dependsOn: []
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:52:14.922292Z"
- id: "TSK-0002"
title: "Provar driver SQLite em JVM e Native Image"
description: "Avaliar Xerial SQLite JDBC e fixar versão compatível com Java, Gradle\
\ e GraalVM do projeto. Registrar hipótese, critério e invocação antes da prova.\
\ Criar, gravar, ler e reabrir uma base descartável em processos JVM e nativos.\
\ Verificar carregamento da biblioteca distribuída ao lado do nativo; sqlite3\
\ será ferramenta de diagnóstico do pacote. Construir e executar somente artefatos\
\ descartáveis, sem instalação real."
acceptanceCriteria:
- "Driver e versão selecionados demonstram persistência e reabertura em JVM e Native\
\ Image na plataforma alvo."
- "Biblioteca do pacote é encontrada por caminho controlado e não depende acidentalmente\
\ do SQLite global ou de extração repetida não planejada."
- "Hipótese, resultado e limitações da prova estão registrados; instalação ativa\
\ e projetos consumidores não foram alterados."
dependsOn:
- "TSK-0001"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:52:22.768410Z"
- id: "TSK-0003"
title: "Implementar esquema, conexões e transações SQLite"
description: "Criar infraestrutura de persistência local em .ai-engineering/aie.db\
\ com esquema versionado, tabelas tipadas, índices e relações. Habilitar integridade\
\ referencial em cada conexão, delimitar unidade transacional por operação coerente\
\ e usar leitura consistente. Definir journal/durabilidade e espera limitada de\
\ escrita com diagnóstico. Preservar limites de módulos; serviços aninhados devem\
\ compartilhar a transação aplicável."
acceptanceCriteria:
- "Esquema e índices atendem ao mapeamento sem BLOB/base64 ou arquivos completos\
\ serializados em TEXT."
- "Falha em operação relacionada causa rollback; referências inválidas são recusadas\
\ e gravações concorrentes têm contenção limitada e diagnóstico útil."
- "Abertura de esquema incompatível é diagnosticada sem alterar dados; teste de\
\ leitura consistente cobre mudanças concorrentes locais."
dependsOn:
- "TSK-0001"
- "TSK-0002"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:52:29.986202Z"
- id: "TSK-0004"
title: "Persistir Works e investigação no novo backend"
description: "Integrar Work, guidance e histórico de escolhas, discussões, tópicos,\
\ surveys, respostas e disposições à unidade de persistência. Preservar IDs existentes,\
\ semântica dos IDs locais, referências e histórico útil. Consultas selecionadas\
\ devem buscar o Work diretamente. Manter leitura legada delimitada para compatibilidade\
\ e migração; não manter duas fontes autoritativas para a mesma memória."
acceptanceCriteria:
- "Criar e retomar Work/discussão/survey em outro processo preserva conteúdo, histó\
rico de respostas e pendências."
- "Escolhas DIRECT/EXPLORATORY e autoridade humana mantêm as regras existentes,\
\ inclusive ausência de escolha e pedido específico de DEC."
- "Busca por Work e suas referências usa consultas com escopo adequado; alteraçõ\
es e referências relacionadas são transacionais."
dependsOn:
- "TSK-0003"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:52:37.091047Z"
- id: "TSK-0005"
title: "Persistir decisões, planos e experimentos"
description: "Integrar DecisionService e PlanService com revisões, aceitação, supersessã\
o, passos, dependências e experimentos. Preservar os dois ciclos e OODA, a autoridade\
\ de DEC/Plan e a distinção entre aprovação humana e promoção permitida por polí\
tica. Tratar operações que alteram registros relacionados em uma transação, sem\
\ reduzir os checks de domínio."
acceptanceCriteria:
- "Aprovação, revisão e supersessão preservam autoria e referências, sem fabricaç\
ão de aprovação ou edição silenciosa de decisão aceita."
- "Dependências e estados de passos, critérios de experimentos, preocupações com\
\ DEC e replanejamento conservam os bloqueios existentes."
- "Interrupção simulada não publica meia supersessão ou promoção parcial; retomada\
\ em outro processo preserva o contexto."
dependsOn:
- "TSK-0004"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:52:43.954237Z"
- id: "TSK-0006"
title: "Integrar execuções de agentes e coordenação de EPICs"
description: "Persistir RUNs e seus dados operacionais mínimos, idempotência de\
\ requestId, referências aplicadas e diagnóstico. Integrar PlanCoordinator/EpicCoordinator,\
\ políticas e proveniência de conclusão, representando recibos internos como dados\
\ estruturados quando aplicável. Preservar a fronteira do adaptador: propostas\
\ não aprovam DEC, não respondem pelo humano nem executam comandos de repositó\
rio."
acceptanceCriteria:
- "Repetição idempotente de uma solicitação concluída não duplica registros; solicitaç\
ões divergentes e estados interrompidos são diagnosticados."
- "Políticas RESULTS/DECOMPOSITION, delegação, reabertura, propagação e conclusã\
o por Plans preservam autoridade e proveniência."
- "Resultados estruturados necessários permanecem; transporte bruto, ambiente e\
\ logs completos não viram acervo permanente no banco."
dependsOn:
- "TSK-0005"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:52:50.899228Z"
- id: "TSK-0007"
title: "Integrar gates do projeto e adicionais por Work"
description: "Representar gates obrigatórios do projeto e complementos do Work e\
\ conectar seus resultados aos checks e à entrega. Preservar avaliação externa\
\ e condições de qualidade, inclusive anexos exigidos. Registrar identificaçã\
o, procedimento/execução, estado avaliado, momento e resultado mínimo. Alteraç\
ões pertinentes invalidam a aplicação do resultado aos gates afetados; aprovaç\
ão humana não equivale a sucesso técnico."
acceptanceCriteria:
- "Gate obrigatório pendente, falho ou não executado bloqueia a entrega; gates adicionais\
\ do Work são considerados sem dispensar obrigatórios do projeto."
- "Resultados correspondem ao estado realmente avaliado e não satisfazem silenciosamente\
\ um gate após mudança relevante."
- "Checks existentes e anexos necessários continuam exigidos durante avaliação,\
\ sem introduzir executor autônomo ou retenção bruta obrigatória."
dependsOn:
- "TSK-0005"
- "TSK-0006"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:52:58.285586Z"
- id: "TSK-0008"
title: "Implementar anexos temporários e descarte após checks"
description: "Definir ciclo de vida de anexos e arquivos de execução no filesystem.\
\ Publicar arquivos completos, validar e registrar resultados mínimos antes do\
\ descarte; limpar elegíveis ao fim da execução. Proteger anexos ainda usados\
\ por checks pendentes e outputs solicitados. Recuperar falhas entre publicaçã\
o de arquivo, transação no banco e limpeza, distinguindo descarte legítimo de\
\ perda prematura. Não descartar artefatos legados deste workspace."
acceptanceCriteria:
- "Arquivos exigidos permanecem acessíveis até todos os checks dependentes terminarem,\
\ com resultado persistido antes da remoção."
- "Descarte automático preserva outputs solicitados e memória histórica; arquivo\
\ perdido antes da avaliação continua causando falha."
- "Interrupções nos pontos de publicação, registro e limpeza não fabricam sucesso\
\ e permitem recuperação sem remoção de entradas ainda necessárias."
dependsOn:
- "TSK-0007"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:05.800970Z"
status: "OPEN"
author: "Codex"
createdAt: "2026-11-22T11:52:06.993736Z"
revision: 9
previousHash: "91de294440e7e2179a9c771514361e26abef103d361dabf8b494108b7d8c4987"
updatedAt: "2026-11-22T11:53:05.801077Z"
updatedBy: "Codex"
changeReason: "Decomposição solicitada por Nilton; DEC-0001 aceita, com instalaçã\
o real adiada."
documentVersion: 2
---
# Implementar memória de engenharia local em SQLite
## Autoridade e objetivo
Executar a DEC-0001 do WRK-000D, aceita explicitamente por Nilton nesta conversa.
O resultado é um framework local de memória de engenharia por Work, com SQLite
por projeto, investigação e implementação orientadas por OODA, gates preservados,
anexos temporários e retenção mínima. A aprovação desta DEC mantém a instalação
real adiada.
Este Plan foi solicitado com decomposição em vários steps. Todos os steps começam
OPEN; a criação do Plan não constitui execução ou comprovação de resultado.
## Limites obrigatórios
- Não instalar nem substituir o AIE, SQLite, bibliotecas ou atalhos em uso.
- Não executar o instalador real contra HOME, ~/.local/bin ou outro destino ativo.
Sua validação usa fixtures com ferramentas simuladas e destinos descartáveis.
- Não migrar este workspace canônico ou projetos consumidores. Exercitar o novo
backend e a migração em fixtures e cópias descartáveis; ativação real depende de
instrução humana posterior específica.
- Preservar alterações preexistentes, IDs, conteúdo e proveniência legada,
aprovações, evidências históricas e instruções do projeto fora do bloco gerido.
- Não introduzir arquivos em BLOB/base64 ou TEXT equivalente, retenção extensa,
executor autônomo de repositório, colaboração distribuída ou integração Git LFS.
- Importação/exportação de Works/DECs e backup como funcionalidade ficam fora.
A cópia de segurança da migração é parte da recuperação da conversão.
- Código e outputs solicitados permanecem nos destinos de entrega apropriados.
- O WRK-000C permanece aberto para avaliar e tratar latência após esta mudança.
## Execução e dependências
Os 14 steps possuem dependências explícitas e critérios próprios. Mapear primeiro
o contrato e o legado; provar a integração SQLite/JVM/Native Image; depois construir
as transações e migrar os fluxos de domínio. Integrar gates e ciclo dos anexos antes
de consolidar as consultas, a migração pública e o bootstrap. Preparar distribuição
e documentação e concluir com regressão integrada e encaminhamento ao WRK-000C.
Não iniciar um step com dependências pendentes. Verificações focadas fazem parte
de cada mudança; a última etapa integra os cenários e não substitui essas verificações.
Steps independentes podem ser executados em ordem compatível, sem presumir
autorização de delegação ou de instalação real.
## OODA e incertezas
Nas provas relevantes, principalmente driver/nativo, migração e descarte de anexos,
registrar hipótese, critério de sucesso e invocação antes de executar. Registrar
observação, interpretação e próxima ação após o resultado; reconsiderar antes de
repetir uma hipótese falha. Usar os registros de experimentos do Plan quando úteis,
sem impor um ritual de quatro fases a toda alteração.
Ajustar esquema, índices, transações e build dentro da DEC. Se um resultado
questionar a decisão, registrar a preocupação, continuar investigações autorizadas
e rever a DEC com aprovação aplicável antes da execução afetada.
## Verificação e registro mínimo
Durante a execução deste Work, respeitar o protocolo que está em uso. Registrar
resultados reais e evidência mínima necessária para completar os steps; não usar
a futura política de limpeza para apagar evidências legadas ou simular gates.
Verificar continuidade entre processos, integridade referencial, rollback,
concorrência local com espera limitada, autoridade humana, gates e anexos
temporários, migração repetível e operação sem Git. Provas nativas usam somente
artefatos de build e projetos descartáveis.
Comandos candidatos à validação, ajustados ao resultado e ao código final:
- `./gradlew test` e `./gradlew check` para a suíte e arquitetura do projeto.
- `python3 scripts/test-install-native.py` para fixtures do instalador.
- `./gradlew nativeCompile` e tarefas de distribuição para construir o pacote.
- `bash scripts/native-smoke.sh <caminho-absoluto-do-build>` em projetos descartáveis.
Esses comandos são planejados, não executados na criação do Plan. Preservar os
gates específicos do projeto e adicionais do Work definidos na execução. Logs de
trabalho podem ser temporários; guardar na memória somente o necessário ao contrato.
## Conclusão
Todos os steps obrigatórios devem satisfazer seus critérios, com a DEC aceita e
sem experimentos ou preocupações pendentes. A entrega é código, documentação,
pacote preparado e resultados de verificação. Não depende de instalar a nova
versão no ambiente em uso. Encaminhar ao WRK-000C um cenário reproduzível com
comandos, versão, volume e ambiente, sem declarar resolvido o problema de atraso.
@@ -0,0 +1,295 @@
---
schemaVersion: 1
id: "PLN-0001"
workId: "WRK-000D"
title: "Implementar memória de engenharia local em SQLite sem instalação ativa"
decisions:
- "DEC-0001"
steps:
- id: "TSK-0001"
title: "Mapear contrato, dados legados e cenários de migração"
description: "Inspecionar WorkService, serviços de Discussion/Decision/Plan/Agent,\
\ coordenadores e VerificationService. Mapear registros, referências, revisões,\
\ hashes, recibos e bootstrap para tabelas e regras do backend SQLite, preservando\
\ conteúdo e autoridade. Selecionar fixtures existentes de compatibilidade, workflows\
\ e importação como corpus; usar apenas cópias descartáveis. Identificar checks\
\ e pontos de retenção sem realizar benchmark conclusivo do WRK-000C."
acceptanceCriteria:
- "Mapeamento cobre entidades persistidas, IDs locais ao Work, referências, revisõ\
es, aprovações e casos de conclusão legada com hashes/recibos."
- "Corpus representativo e resultados esperados de continuidade/migração estão definidos\
\ antes da conversão, incluindo dados inválidos e estados interrompidos."
- "Limites de instalação, migração de consumidores e preservação do workspace atual\
\ estão explícitos e respeitados."
dependsOn: []
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:52:14.922292Z"
- id: "TSK-0002"
title: "Provar driver SQLite em JVM e Native Image"
description: "Avaliar Xerial SQLite JDBC e fixar versão compatível com Java, Gradle\
\ e GraalVM do projeto. Registrar hipótese, critério e invocação antes da prova.\
\ Criar, gravar, ler e reabrir uma base descartável em processos JVM e nativos.\
\ Verificar carregamento da biblioteca distribuída ao lado do nativo; sqlite3\
\ será ferramenta de diagnóstico do pacote. Construir e executar somente artefatos\
\ descartáveis, sem instalação real."
acceptanceCriteria:
- "Driver e versão selecionados demonstram persistência e reabertura em JVM e Native\
\ Image na plataforma alvo."
- "Biblioteca do pacote é encontrada por caminho controlado e não depende acidentalmente\
\ do SQLite global ou de extração repetida não planejada."
- "Hipótese, resultado e limitações da prova estão registrados; instalação ativa\
\ e projetos consumidores não foram alterados."
dependsOn:
- "TSK-0001"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:52:22.768410Z"
- id: "TSK-0003"
title: "Implementar esquema, conexões e transações SQLite"
description: "Criar infraestrutura de persistência local em .ai-engineering/aie.db\
\ com esquema versionado, tabelas tipadas, índices e relações. Habilitar integridade\
\ referencial em cada conexão, delimitar unidade transacional por operação coerente\
\ e usar leitura consistente. Definir journal/durabilidade e espera limitada de\
\ escrita com diagnóstico. Preservar limites de módulos; serviços aninhados devem\
\ compartilhar a transação aplicável."
acceptanceCriteria:
- "Esquema e índices atendem ao mapeamento sem BLOB/base64 ou arquivos completos\
\ serializados em TEXT."
- "Falha em operação relacionada causa rollback; referências inválidas são recusadas\
\ e gravações concorrentes têm contenção limitada e diagnóstico útil."
- "Abertura de esquema incompatível é diagnosticada sem alterar dados; teste de\
\ leitura consistente cobre mudanças concorrentes locais."
dependsOn:
- "TSK-0001"
- "TSK-0002"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:52:29.986202Z"
- id: "TSK-0004"
title: "Persistir Works e investigação no novo backend"
description: "Integrar Work, guidance e histórico de escolhas, discussões, tópicos,\
\ surveys, respostas e disposições à unidade de persistência. Preservar IDs existentes,\
\ semântica dos IDs locais, referências e histórico útil. Consultas selecionadas\
\ devem buscar o Work diretamente. Manter leitura legada delimitada para compatibilidade\
\ e migração; não manter duas fontes autoritativas para a mesma memória."
acceptanceCriteria:
- "Criar e retomar Work/discussão/survey em outro processo preserva conteúdo, histó\
rico de respostas e pendências."
- "Escolhas DIRECT/EXPLORATORY e autoridade humana mantêm as regras existentes,\
\ inclusive ausência de escolha e pedido específico de DEC."
- "Busca por Work e suas referências usa consultas com escopo adequado; alteraçõ\
es e referências relacionadas são transacionais."
dependsOn:
- "TSK-0003"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:52:37.091047Z"
- id: "TSK-0005"
title: "Persistir decisões, planos e experimentos"
description: "Integrar DecisionService e PlanService com revisões, aceitação, supersessã\
o, passos, dependências e experimentos. Preservar os dois ciclos e OODA, a autoridade\
\ de DEC/Plan e a distinção entre aprovação humana e promoção permitida por polí\
tica. Tratar operações que alteram registros relacionados em uma transação, sem\
\ reduzir os checks de domínio."
acceptanceCriteria:
- "Aprovação, revisão e supersessão preservam autoria e referências, sem fabricaç\
ão de aprovação ou edição silenciosa de decisão aceita."
- "Dependências e estados de passos, critérios de experimentos, preocupações com\
\ DEC e replanejamento conservam os bloqueios existentes."
- "Interrupção simulada não publica meia supersessão ou promoção parcial; retomada\
\ em outro processo preserva o contexto."
dependsOn:
- "TSK-0004"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:52:43.954237Z"
- id: "TSK-0006"
title: "Integrar execuções de agentes e coordenação de EPICs"
description: "Persistir RUNs e seus dados operacionais mínimos, idempotência de\
\ requestId, referências aplicadas e diagnóstico. Integrar PlanCoordinator/EpicCoordinator,\
\ políticas e proveniência de conclusão, representando recibos internos como dados\
\ estruturados quando aplicável. Preservar a fronteira do adaptador: propostas\
\ não aprovam DEC, não respondem pelo humano nem executam comandos de repositó\
rio."
acceptanceCriteria:
- "Repetição idempotente de uma solicitação concluída não duplica registros; solicitaç\
ões divergentes e estados interrompidos são diagnosticados."
- "Políticas RESULTS/DECOMPOSITION, delegação, reabertura, propagação e conclusã\
o por Plans preservam autoridade e proveniência."
- "Resultados estruturados necessários permanecem; transporte bruto, ambiente e\
\ logs completos não viram acervo permanente no banco."
dependsOn:
- "TSK-0005"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:52:50.899228Z"
- id: "TSK-0007"
title: "Integrar gates do projeto e adicionais por Work"
description: "Representar gates obrigatórios do projeto e complementos do Work e\
\ conectar seus resultados aos checks e à entrega. Preservar avaliação externa\
\ e condições de qualidade, inclusive anexos exigidos. Registrar identificaçã\
o, procedimento/execução, estado avaliado, momento e resultado mínimo. Alteraç\
ões pertinentes invalidam a aplicação do resultado aos gates afetados; aprovaç\
ão humana não equivale a sucesso técnico."
acceptanceCriteria:
- "Gate obrigatório pendente, falho ou não executado bloqueia a entrega; gates adicionais\
\ do Work são considerados sem dispensar obrigatórios do projeto."
- "Resultados correspondem ao estado realmente avaliado e não satisfazem silenciosamente\
\ um gate após mudança relevante."
- "Checks existentes e anexos necessários continuam exigidos durante avaliação,\
\ sem introduzir executor autônomo ou retenção bruta obrigatória."
dependsOn:
- "TSK-0005"
- "TSK-0006"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:52:58.285586Z"
- id: "TSK-0008"
title: "Implementar anexos temporários e descarte após checks"
description: "Definir ciclo de vida de anexos e arquivos de execução no filesystem.\
\ Publicar arquivos completos, validar e registrar resultados mínimos antes do\
\ descarte; limpar elegíveis ao fim da execução. Proteger anexos ainda usados\
\ por checks pendentes e outputs solicitados. Recuperar falhas entre publicaçã\
o de arquivo, transação no banco e limpeza, distinguindo descarte legítimo de\
\ perda prematura. Não descartar artefatos legados deste workspace."
acceptanceCriteria:
- "Arquivos exigidos permanecem acessíveis até todos os checks dependentes terminarem,\
\ com resultado persistido antes da remoção."
- "Descarte automático preserva outputs solicitados e memória histórica; arquivo\
\ perdido antes da avaliação continua causando falha."
- "Interrupções nos pontos de publicação, registro e limpeza não fabricam sucesso\
\ e permitem recuperação sem remoção de entradas ainda necessárias."
dependsOn:
- "TSK-0007"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:05.800970Z"
- id: "TSK-0009"
title: "Adaptar verificação, status e contexto ao SQLite"
description: "Integrar VerificationService, CompatibilityService e projeções da\
\ CLI ao backend. Montar status, next-actions, context e readiness com consultas\
\ necessárias e resultados reutilizados na invocação; preservar contrato público\
\ quando compatível e informar mudanças. Separar resultado histórico com anexo\
\ descartado legitimamente de validação ativa. Manter diagnóstico de reparo e\
\ ausência de transições de estado em consultas."
acceptanceCriteria:
- "Consultas e contexto em processos novos preservam informações e autoridade e\
\ não promovem, migram ou concluem registros por leitura."
- "Anexos descartados legitimamente não invalidam histórico; corrupção e referê\
ncias ausentes não são tratadas como gates satisfeitos."
- "Caminhos selecionados não repetem varreduras/validações globais sem necessidade;\
\ saída e códigos de erro compatíveis são verificados."
dependsOn:
- "TSK-0004"
- "TSK-0005"
- "TSK-0006"
- "TSK-0008"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:13.390096Z"
status: "OPEN"
author: "Codex"
createdAt: "2026-11-22T11:52:06.993736Z"
revision: 10
previousHash: "a096e72fa947ed7509a4f51a54b72b3f0661931fcd74bc5f41af2b856f56218f"
updatedAt: "2026-11-22T11:53:13.390203Z"
updatedBy: "Codex"
changeReason: "Decomposição solicitada por Nilton; DEC-0001 aceita, com instalaçã\
o real adiada."
documentVersion: 2
---
# Implementar memória de engenharia local em SQLite
## Autoridade e objetivo
Executar a DEC-0001 do WRK-000D, aceita explicitamente por Nilton nesta conversa.
O resultado é um framework local de memória de engenharia por Work, com SQLite
por projeto, investigação e implementação orientadas por OODA, gates preservados,
anexos temporários e retenção mínima. A aprovação desta DEC mantém a instalação
real adiada.
Este Plan foi solicitado com decomposição em vários steps. Todos os steps começam
OPEN; a criação do Plan não constitui execução ou comprovação de resultado.
## Limites obrigatórios
- Não instalar nem substituir o AIE, SQLite, bibliotecas ou atalhos em uso.
- Não executar o instalador real contra HOME, ~/.local/bin ou outro destino ativo.
Sua validação usa fixtures com ferramentas simuladas e destinos descartáveis.
- Não migrar este workspace canônico ou projetos consumidores. Exercitar o novo
backend e a migração em fixtures e cópias descartáveis; ativação real depende de
instrução humana posterior específica.
- Preservar alterações preexistentes, IDs, conteúdo e proveniência legada,
aprovações, evidências históricas e instruções do projeto fora do bloco gerido.
- Não introduzir arquivos em BLOB/base64 ou TEXT equivalente, retenção extensa,
executor autônomo de repositório, colaboração distribuída ou integração Git LFS.
- Importação/exportação de Works/DECs e backup como funcionalidade ficam fora.
A cópia de segurança da migração é parte da recuperação da conversão.
- Código e outputs solicitados permanecem nos destinos de entrega apropriados.
- O WRK-000C permanece aberto para avaliar e tratar latência após esta mudança.
## Execução e dependências
Os 14 steps possuem dependências explícitas e critérios próprios. Mapear primeiro
o contrato e o legado; provar a integração SQLite/JVM/Native Image; depois construir
as transações e migrar os fluxos de domínio. Integrar gates e ciclo dos anexos antes
de consolidar as consultas, a migração pública e o bootstrap. Preparar distribuição
e documentação e concluir com regressão integrada e encaminhamento ao WRK-000C.
Não iniciar um step com dependências pendentes. Verificações focadas fazem parte
de cada mudança; a última etapa integra os cenários e não substitui essas verificações.
Steps independentes podem ser executados em ordem compatível, sem presumir
autorização de delegação ou de instalação real.
## OODA e incertezas
Nas provas relevantes, principalmente driver/nativo, migração e descarte de anexos,
registrar hipótese, critério de sucesso e invocação antes de executar. Registrar
observação, interpretação e próxima ação após o resultado; reconsiderar antes de
repetir uma hipótese falha. Usar os registros de experimentos do Plan quando úteis,
sem impor um ritual de quatro fases a toda alteração.
Ajustar esquema, índices, transações e build dentro da DEC. Se um resultado
questionar a decisão, registrar a preocupação, continuar investigações autorizadas
e rever a DEC com aprovação aplicável antes da execução afetada.
## Verificação e registro mínimo
Durante a execução deste Work, respeitar o protocolo que está em uso. Registrar
resultados reais e evidência mínima necessária para completar os steps; não usar
a futura política de limpeza para apagar evidências legadas ou simular gates.
Verificar continuidade entre processos, integridade referencial, rollback,
concorrência local com espera limitada, autoridade humana, gates e anexos
temporários, migração repetível e operação sem Git. Provas nativas usam somente
artefatos de build e projetos descartáveis.
Comandos candidatos à validação, ajustados ao resultado e ao código final:
- `./gradlew test` e `./gradlew check` para a suíte e arquitetura do projeto.
- `python3 scripts/test-install-native.py` para fixtures do instalador.
- `./gradlew nativeCompile` e tarefas de distribuição para construir o pacote.
- `bash scripts/native-smoke.sh <caminho-absoluto-do-build>` em projetos descartáveis.
Esses comandos são planejados, não executados na criação do Plan. Preservar os
gates específicos do projeto e adicionais do Work definidos na execução. Logs de
trabalho podem ser temporários; guardar na memória somente o necessário ao contrato.
## Conclusão
Todos os steps obrigatórios devem satisfazer seus critérios, com a DEC aceita e
sem experimentos ou preocupações pendentes. A entrega é código, documentação,
pacote preparado e resultados de verificação. Não depende de instalar a nova
versão no ambiente em uso. Encaminhar ao WRK-000C um cenário reproduzível com
comandos, versão, volume e ambiente, sem declarar resolvido o problema de atraso.
@@ -0,0 +1,317 @@
---
schemaVersion: 1
id: "PLN-0001"
workId: "WRK-000D"
title: "Implementar memória de engenharia local em SQLite sem instalação ativa"
decisions:
- "DEC-0001"
steps:
- id: "TSK-0001"
title: "Mapear contrato, dados legados e cenários de migração"
description: "Inspecionar WorkService, serviços de Discussion/Decision/Plan/Agent,\
\ coordenadores e VerificationService. Mapear registros, referências, revisões,\
\ hashes, recibos e bootstrap para tabelas e regras do backend SQLite, preservando\
\ conteúdo e autoridade. Selecionar fixtures existentes de compatibilidade, workflows\
\ e importação como corpus; usar apenas cópias descartáveis. Identificar checks\
\ e pontos de retenção sem realizar benchmark conclusivo do WRK-000C."
acceptanceCriteria:
- "Mapeamento cobre entidades persistidas, IDs locais ao Work, referências, revisõ\
es, aprovações e casos de conclusão legada com hashes/recibos."
- "Corpus representativo e resultados esperados de continuidade/migração estão definidos\
\ antes da conversão, incluindo dados inválidos e estados interrompidos."
- "Limites de instalação, migração de consumidores e preservação do workspace atual\
\ estão explícitos e respeitados."
dependsOn: []
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:52:14.922292Z"
- id: "TSK-0002"
title: "Provar driver SQLite em JVM e Native Image"
description: "Avaliar Xerial SQLite JDBC e fixar versão compatível com Java, Gradle\
\ e GraalVM do projeto. Registrar hipótese, critério e invocação antes da prova.\
\ Criar, gravar, ler e reabrir uma base descartável em processos JVM e nativos.\
\ Verificar carregamento da biblioteca distribuída ao lado do nativo; sqlite3\
\ será ferramenta de diagnóstico do pacote. Construir e executar somente artefatos\
\ descartáveis, sem instalação real."
acceptanceCriteria:
- "Driver e versão selecionados demonstram persistência e reabertura em JVM e Native\
\ Image na plataforma alvo."
- "Biblioteca do pacote é encontrada por caminho controlado e não depende acidentalmente\
\ do SQLite global ou de extração repetida não planejada."
- "Hipótese, resultado e limitações da prova estão registrados; instalação ativa\
\ e projetos consumidores não foram alterados."
dependsOn:
- "TSK-0001"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:52:22.768410Z"
- id: "TSK-0003"
title: "Implementar esquema, conexões e transações SQLite"
description: "Criar infraestrutura de persistência local em .ai-engineering/aie.db\
\ com esquema versionado, tabelas tipadas, índices e relações. Habilitar integridade\
\ referencial em cada conexão, delimitar unidade transacional por operação coerente\
\ e usar leitura consistente. Definir journal/durabilidade e espera limitada de\
\ escrita com diagnóstico. Preservar limites de módulos; serviços aninhados devem\
\ compartilhar a transação aplicável."
acceptanceCriteria:
- "Esquema e índices atendem ao mapeamento sem BLOB/base64 ou arquivos completos\
\ serializados em TEXT."
- "Falha em operação relacionada causa rollback; referências inválidas são recusadas\
\ e gravações concorrentes têm contenção limitada e diagnóstico útil."
- "Abertura de esquema incompatível é diagnosticada sem alterar dados; teste de\
\ leitura consistente cobre mudanças concorrentes locais."
dependsOn:
- "TSK-0001"
- "TSK-0002"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:52:29.986202Z"
- id: "TSK-0004"
title: "Persistir Works e investigação no novo backend"
description: "Integrar Work, guidance e histórico de escolhas, discussões, tópicos,\
\ surveys, respostas e disposições à unidade de persistência. Preservar IDs existentes,\
\ semântica dos IDs locais, referências e histórico útil. Consultas selecionadas\
\ devem buscar o Work diretamente. Manter leitura legada delimitada para compatibilidade\
\ e migração; não manter duas fontes autoritativas para a mesma memória."
acceptanceCriteria:
- "Criar e retomar Work/discussão/survey em outro processo preserva conteúdo, histó\
rico de respostas e pendências."
- "Escolhas DIRECT/EXPLORATORY e autoridade humana mantêm as regras existentes,\
\ inclusive ausência de escolha e pedido específico de DEC."
- "Busca por Work e suas referências usa consultas com escopo adequado; alteraçõ\
es e referências relacionadas são transacionais."
dependsOn:
- "TSK-0003"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:52:37.091047Z"
- id: "TSK-0005"
title: "Persistir decisões, planos e experimentos"
description: "Integrar DecisionService e PlanService com revisões, aceitação, supersessã\
o, passos, dependências e experimentos. Preservar os dois ciclos e OODA, a autoridade\
\ de DEC/Plan e a distinção entre aprovação humana e promoção permitida por polí\
tica. Tratar operações que alteram registros relacionados em uma transação, sem\
\ reduzir os checks de domínio."
acceptanceCriteria:
- "Aprovação, revisão e supersessão preservam autoria e referências, sem fabricaç\
ão de aprovação ou edição silenciosa de decisão aceita."
- "Dependências e estados de passos, critérios de experimentos, preocupações com\
\ DEC e replanejamento conservam os bloqueios existentes."
- "Interrupção simulada não publica meia supersessão ou promoção parcial; retomada\
\ em outro processo preserva o contexto."
dependsOn:
- "TSK-0004"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:52:43.954237Z"
- id: "TSK-0006"
title: "Integrar execuções de agentes e coordenação de EPICs"
description: "Persistir RUNs e seus dados operacionais mínimos, idempotência de\
\ requestId, referências aplicadas e diagnóstico. Integrar PlanCoordinator/EpicCoordinator,\
\ políticas e proveniência de conclusão, representando recibos internos como dados\
\ estruturados quando aplicável. Preservar a fronteira do adaptador: propostas\
\ não aprovam DEC, não respondem pelo humano nem executam comandos de repositó\
rio."
acceptanceCriteria:
- "Repetição idempotente de uma solicitação concluída não duplica registros; solicitaç\
ões divergentes e estados interrompidos são diagnosticados."
- "Políticas RESULTS/DECOMPOSITION, delegação, reabertura, propagação e conclusã\
o por Plans preservam autoridade e proveniência."
- "Resultados estruturados necessários permanecem; transporte bruto, ambiente e\
\ logs completos não viram acervo permanente no banco."
dependsOn:
- "TSK-0005"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:52:50.899228Z"
- id: "TSK-0007"
title: "Integrar gates do projeto e adicionais por Work"
description: "Representar gates obrigatórios do projeto e complementos do Work e\
\ conectar seus resultados aos checks e à entrega. Preservar avaliação externa\
\ e condições de qualidade, inclusive anexos exigidos. Registrar identificaçã\
o, procedimento/execução, estado avaliado, momento e resultado mínimo. Alteraç\
ões pertinentes invalidam a aplicação do resultado aos gates afetados; aprovaç\
ão humana não equivale a sucesso técnico."
acceptanceCriteria:
- "Gate obrigatório pendente, falho ou não executado bloqueia a entrega; gates adicionais\
\ do Work são considerados sem dispensar obrigatórios do projeto."
- "Resultados correspondem ao estado realmente avaliado e não satisfazem silenciosamente\
\ um gate após mudança relevante."
- "Checks existentes e anexos necessários continuam exigidos durante avaliação,\
\ sem introduzir executor autônomo ou retenção bruta obrigatória."
dependsOn:
- "TSK-0005"
- "TSK-0006"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:52:58.285586Z"
- id: "TSK-0008"
title: "Implementar anexos temporários e descarte após checks"
description: "Definir ciclo de vida de anexos e arquivos de execução no filesystem.\
\ Publicar arquivos completos, validar e registrar resultados mínimos antes do\
\ descarte; limpar elegíveis ao fim da execução. Proteger anexos ainda usados\
\ por checks pendentes e outputs solicitados. Recuperar falhas entre publicaçã\
o de arquivo, transação no banco e limpeza, distinguindo descarte legítimo de\
\ perda prematura. Não descartar artefatos legados deste workspace."
acceptanceCriteria:
- "Arquivos exigidos permanecem acessíveis até todos os checks dependentes terminarem,\
\ com resultado persistido antes da remoção."
- "Descarte automático preserva outputs solicitados e memória histórica; arquivo\
\ perdido antes da avaliação continua causando falha."
- "Interrupções nos pontos de publicação, registro e limpeza não fabricam sucesso\
\ e permitem recuperação sem remoção de entradas ainda necessárias."
dependsOn:
- "TSK-0007"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:05.800970Z"
- id: "TSK-0009"
title: "Adaptar verificação, status e contexto ao SQLite"
description: "Integrar VerificationService, CompatibilityService e projeções da\
\ CLI ao backend. Montar status, next-actions, context e readiness com consultas\
\ necessárias e resultados reutilizados na invocação; preservar contrato público\
\ quando compatível e informar mudanças. Separar resultado histórico com anexo\
\ descartado legitimamente de validação ativa. Manter diagnóstico de reparo e\
\ ausência de transições de estado em consultas."
acceptanceCriteria:
- "Consultas e contexto em processos novos preservam informações e autoridade e\
\ não promovem, migram ou concluem registros por leitura."
- "Anexos descartados legitimamente não invalidam histórico; corrupção e referê\
ncias ausentes não são tratadas como gates satisfeitos."
- "Caminhos selecionados não repetem varreduras/validações globais sem necessidade;\
\ saída e códigos de erro compatíveis são verificados."
dependsOn:
- "TSK-0004"
- "TSK-0005"
- "TSK-0006"
- "TSK-0008"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:13.390096Z"
- id: "TSK-0010"
title: "Implementar migração explícita e recuperável do legado"
description: "Criar comando público de prévia e aplicação da migração, sem conversã\
o em leituras ou atualização do instalador. Usar base de preparo e cópia de seguranç\
a da conversão, importação tipada transacional e verificação contra o corpus.\
\ Preservar IDs, conteúdo, aprovações, hashes, revisões e proveniência histórica\
\ sem despejar arquivos no banco. Ativar somente após sucesso; repetir ou recuperar\
\ interrupção sem duplicar. Executar apenas em fixtures/cópias descartáveis."
acceptanceCriteria:
- "Prévia não modifica o projeto; aplicação compara registros/contexto e ativa a\
\ base somente após validação completa."
- "Fixtures históricas, recibos, aprovações e referências preservam identidade/proveniê\
ncia; execução repetida não duplica conteúdo."
- "Falhas e interrupções deixam a fonte anterior recuperável e informam próxima\
\ ação; nenhum projeto real ou workspace canônico foi migrado."
dependsOn:
- "TSK-0001"
- "TSK-0009"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:21.074969Z"
status: "OPEN"
author: "Codex"
createdAt: "2026-11-22T11:52:06.993736Z"
revision: 11
previousHash: "c59eed84ea2f9a1eef5e67f8e3f6354e1ae87fb271a4f94ed10f4b5f68a2dc30"
updatedAt: "2026-11-22T11:53:21.075089Z"
updatedBy: "Codex"
changeReason: "Decomposição solicitada por Nilton; DEC-0001 aceita, com instalaçã\
o real adiada."
documentVersion: 2
---
# Implementar memória de engenharia local em SQLite
## Autoridade e objetivo
Executar a DEC-0001 do WRK-000D, aceita explicitamente por Nilton nesta conversa.
O resultado é um framework local de memória de engenharia por Work, com SQLite
por projeto, investigação e implementação orientadas por OODA, gates preservados,
anexos temporários e retenção mínima. A aprovação desta DEC mantém a instalação
real adiada.
Este Plan foi solicitado com decomposição em vários steps. Todos os steps começam
OPEN; a criação do Plan não constitui execução ou comprovação de resultado.
## Limites obrigatórios
- Não instalar nem substituir o AIE, SQLite, bibliotecas ou atalhos em uso.
- Não executar o instalador real contra HOME, ~/.local/bin ou outro destino ativo.
Sua validação usa fixtures com ferramentas simuladas e destinos descartáveis.
- Não migrar este workspace canônico ou projetos consumidores. Exercitar o novo
backend e a migração em fixtures e cópias descartáveis; ativação real depende de
instrução humana posterior específica.
- Preservar alterações preexistentes, IDs, conteúdo e proveniência legada,
aprovações, evidências históricas e instruções do projeto fora do bloco gerido.
- Não introduzir arquivos em BLOB/base64 ou TEXT equivalente, retenção extensa,
executor autônomo de repositório, colaboração distribuída ou integração Git LFS.
- Importação/exportação de Works/DECs e backup como funcionalidade ficam fora.
A cópia de segurança da migração é parte da recuperação da conversão.
- Código e outputs solicitados permanecem nos destinos de entrega apropriados.
- O WRK-000C permanece aberto para avaliar e tratar latência após esta mudança.
## Execução e dependências
Os 14 steps possuem dependências explícitas e critérios próprios. Mapear primeiro
o contrato e o legado; provar a integração SQLite/JVM/Native Image; depois construir
as transações e migrar os fluxos de domínio. Integrar gates e ciclo dos anexos antes
de consolidar as consultas, a migração pública e o bootstrap. Preparar distribuição
e documentação e concluir com regressão integrada e encaminhamento ao WRK-000C.
Não iniciar um step com dependências pendentes. Verificações focadas fazem parte
de cada mudança; a última etapa integra os cenários e não substitui essas verificações.
Steps independentes podem ser executados em ordem compatível, sem presumir
autorização de delegação ou de instalação real.
## OODA e incertezas
Nas provas relevantes, principalmente driver/nativo, migração e descarte de anexos,
registrar hipótese, critério de sucesso e invocação antes de executar. Registrar
observação, interpretação e próxima ação após o resultado; reconsiderar antes de
repetir uma hipótese falha. Usar os registros de experimentos do Plan quando úteis,
sem impor um ritual de quatro fases a toda alteração.
Ajustar esquema, índices, transações e build dentro da DEC. Se um resultado
questionar a decisão, registrar a preocupação, continuar investigações autorizadas
e rever a DEC com aprovação aplicável antes da execução afetada.
## Verificação e registro mínimo
Durante a execução deste Work, respeitar o protocolo que está em uso. Registrar
resultados reais e evidência mínima necessária para completar os steps; não usar
a futura política de limpeza para apagar evidências legadas ou simular gates.
Verificar continuidade entre processos, integridade referencial, rollback,
concorrência local com espera limitada, autoridade humana, gates e anexos
temporários, migração repetível e operação sem Git. Provas nativas usam somente
artefatos de build e projetos descartáveis.
Comandos candidatos à validação, ajustados ao resultado e ao código final:
- `./gradlew test` e `./gradlew check` para a suíte e arquitetura do projeto.
- `python3 scripts/test-install-native.py` para fixtures do instalador.
- `./gradlew nativeCompile` e tarefas de distribuição para construir o pacote.
- `bash scripts/native-smoke.sh <caminho-absoluto-do-build>` em projetos descartáveis.
Esses comandos são planejados, não executados na criação do Plan. Preservar os
gates específicos do projeto e adicionais do Work definidos na execução. Logs de
trabalho podem ser temporários; guardar na memória somente o necessário ao contrato.
## Conclusão
Todos os steps obrigatórios devem satisfazer seus critérios, com a DEC aceita e
sem experimentos ou preocupações pendentes. A entrega é código, documentação,
pacote preparado e resultados de verificação. Não depende de instalar a nova
versão no ambiente em uso. Encaminhar ao WRK-000C um cenário reproduzível com
comandos, versão, volume e ambiente, sem declarar resolvido o problema de atraso.
@@ -0,0 +1,339 @@
---
schemaVersion: 1
id: "PLN-0001"
workId: "WRK-000D"
title: "Implementar memória de engenharia local em SQLite sem instalação ativa"
decisions:
- "DEC-0001"
steps:
- id: "TSK-0001"
title: "Mapear contrato, dados legados e cenários de migração"
description: "Inspecionar WorkService, serviços de Discussion/Decision/Plan/Agent,\
\ coordenadores e VerificationService. Mapear registros, referências, revisões,\
\ hashes, recibos e bootstrap para tabelas e regras do backend SQLite, preservando\
\ conteúdo e autoridade. Selecionar fixtures existentes de compatibilidade, workflows\
\ e importação como corpus; usar apenas cópias descartáveis. Identificar checks\
\ e pontos de retenção sem realizar benchmark conclusivo do WRK-000C."
acceptanceCriteria:
- "Mapeamento cobre entidades persistidas, IDs locais ao Work, referências, revisõ\
es, aprovações e casos de conclusão legada com hashes/recibos."
- "Corpus representativo e resultados esperados de continuidade/migração estão definidos\
\ antes da conversão, incluindo dados inválidos e estados interrompidos."
- "Limites de instalação, migração de consumidores e preservação do workspace atual\
\ estão explícitos e respeitados."
dependsOn: []
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:52:14.922292Z"
- id: "TSK-0002"
title: "Provar driver SQLite em JVM e Native Image"
description: "Avaliar Xerial SQLite JDBC e fixar versão compatível com Java, Gradle\
\ e GraalVM do projeto. Registrar hipótese, critério e invocação antes da prova.\
\ Criar, gravar, ler e reabrir uma base descartável em processos JVM e nativos.\
\ Verificar carregamento da biblioteca distribuída ao lado do nativo; sqlite3\
\ será ferramenta de diagnóstico do pacote. Construir e executar somente artefatos\
\ descartáveis, sem instalação real."
acceptanceCriteria:
- "Driver e versão selecionados demonstram persistência e reabertura em JVM e Native\
\ Image na plataforma alvo."
- "Biblioteca do pacote é encontrada por caminho controlado e não depende acidentalmente\
\ do SQLite global ou de extração repetida não planejada."
- "Hipótese, resultado e limitações da prova estão registrados; instalação ativa\
\ e projetos consumidores não foram alterados."
dependsOn:
- "TSK-0001"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:52:22.768410Z"
- id: "TSK-0003"
title: "Implementar esquema, conexões e transações SQLite"
description: "Criar infraestrutura de persistência local em .ai-engineering/aie.db\
\ com esquema versionado, tabelas tipadas, índices e relações. Habilitar integridade\
\ referencial em cada conexão, delimitar unidade transacional por operação coerente\
\ e usar leitura consistente. Definir journal/durabilidade e espera limitada de\
\ escrita com diagnóstico. Preservar limites de módulos; serviços aninhados devem\
\ compartilhar a transação aplicável."
acceptanceCriteria:
- "Esquema e índices atendem ao mapeamento sem BLOB/base64 ou arquivos completos\
\ serializados em TEXT."
- "Falha em operação relacionada causa rollback; referências inválidas são recusadas\
\ e gravações concorrentes têm contenção limitada e diagnóstico útil."
- "Abertura de esquema incompatível é diagnosticada sem alterar dados; teste de\
\ leitura consistente cobre mudanças concorrentes locais."
dependsOn:
- "TSK-0001"
- "TSK-0002"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:52:29.986202Z"
- id: "TSK-0004"
title: "Persistir Works e investigação no novo backend"
description: "Integrar Work, guidance e histórico de escolhas, discussões, tópicos,\
\ surveys, respostas e disposições à unidade de persistência. Preservar IDs existentes,\
\ semântica dos IDs locais, referências e histórico útil. Consultas selecionadas\
\ devem buscar o Work diretamente. Manter leitura legada delimitada para compatibilidade\
\ e migração; não manter duas fontes autoritativas para a mesma memória."
acceptanceCriteria:
- "Criar e retomar Work/discussão/survey em outro processo preserva conteúdo, histó\
rico de respostas e pendências."
- "Escolhas DIRECT/EXPLORATORY e autoridade humana mantêm as regras existentes,\
\ inclusive ausência de escolha e pedido específico de DEC."
- "Busca por Work e suas referências usa consultas com escopo adequado; alteraçõ\
es e referências relacionadas são transacionais."
dependsOn:
- "TSK-0003"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:52:37.091047Z"
- id: "TSK-0005"
title: "Persistir decisões, planos e experimentos"
description: "Integrar DecisionService e PlanService com revisões, aceitação, supersessã\
o, passos, dependências e experimentos. Preservar os dois ciclos e OODA, a autoridade\
\ de DEC/Plan e a distinção entre aprovação humana e promoção permitida por polí\
tica. Tratar operações que alteram registros relacionados em uma transação, sem\
\ reduzir os checks de domínio."
acceptanceCriteria:
- "Aprovação, revisão e supersessão preservam autoria e referências, sem fabricaç\
ão de aprovação ou edição silenciosa de decisão aceita."
- "Dependências e estados de passos, critérios de experimentos, preocupações com\
\ DEC e replanejamento conservam os bloqueios existentes."
- "Interrupção simulada não publica meia supersessão ou promoção parcial; retomada\
\ em outro processo preserva o contexto."
dependsOn:
- "TSK-0004"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:52:43.954237Z"
- id: "TSK-0006"
title: "Integrar execuções de agentes e coordenação de EPICs"
description: "Persistir RUNs e seus dados operacionais mínimos, idempotência de\
\ requestId, referências aplicadas e diagnóstico. Integrar PlanCoordinator/EpicCoordinator,\
\ políticas e proveniência de conclusão, representando recibos internos como dados\
\ estruturados quando aplicável. Preservar a fronteira do adaptador: propostas\
\ não aprovam DEC, não respondem pelo humano nem executam comandos de repositó\
rio."
acceptanceCriteria:
- "Repetição idempotente de uma solicitação concluída não duplica registros; solicitaç\
ões divergentes e estados interrompidos são diagnosticados."
- "Políticas RESULTS/DECOMPOSITION, delegação, reabertura, propagação e conclusã\
o por Plans preservam autoridade e proveniência."
- "Resultados estruturados necessários permanecem; transporte bruto, ambiente e\
\ logs completos não viram acervo permanente no banco."
dependsOn:
- "TSK-0005"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:52:50.899228Z"
- id: "TSK-0007"
title: "Integrar gates do projeto e adicionais por Work"
description: "Representar gates obrigatórios do projeto e complementos do Work e\
\ conectar seus resultados aos checks e à entrega. Preservar avaliação externa\
\ e condições de qualidade, inclusive anexos exigidos. Registrar identificaçã\
o, procedimento/execução, estado avaliado, momento e resultado mínimo. Alteraç\
ões pertinentes invalidam a aplicação do resultado aos gates afetados; aprovaç\
ão humana não equivale a sucesso técnico."
acceptanceCriteria:
- "Gate obrigatório pendente, falho ou não executado bloqueia a entrega; gates adicionais\
\ do Work são considerados sem dispensar obrigatórios do projeto."
- "Resultados correspondem ao estado realmente avaliado e não satisfazem silenciosamente\
\ um gate após mudança relevante."
- "Checks existentes e anexos necessários continuam exigidos durante avaliação,\
\ sem introduzir executor autônomo ou retenção bruta obrigatória."
dependsOn:
- "TSK-0005"
- "TSK-0006"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:52:58.285586Z"
- id: "TSK-0008"
title: "Implementar anexos temporários e descarte após checks"
description: "Definir ciclo de vida de anexos e arquivos de execução no filesystem.\
\ Publicar arquivos completos, validar e registrar resultados mínimos antes do\
\ descarte; limpar elegíveis ao fim da execução. Proteger anexos ainda usados\
\ por checks pendentes e outputs solicitados. Recuperar falhas entre publicaçã\
o de arquivo, transação no banco e limpeza, distinguindo descarte legítimo de\
\ perda prematura. Não descartar artefatos legados deste workspace."
acceptanceCriteria:
- "Arquivos exigidos permanecem acessíveis até todos os checks dependentes terminarem,\
\ com resultado persistido antes da remoção."
- "Descarte automático preserva outputs solicitados e memória histórica; arquivo\
\ perdido antes da avaliação continua causando falha."
- "Interrupções nos pontos de publicação, registro e limpeza não fabricam sucesso\
\ e permitem recuperação sem remoção de entradas ainda necessárias."
dependsOn:
- "TSK-0007"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:05.800970Z"
- id: "TSK-0009"
title: "Adaptar verificação, status e contexto ao SQLite"
description: "Integrar VerificationService, CompatibilityService e projeções da\
\ CLI ao backend. Montar status, next-actions, context e readiness com consultas\
\ necessárias e resultados reutilizados na invocação; preservar contrato público\
\ quando compatível e informar mudanças. Separar resultado histórico com anexo\
\ descartado legitimamente de validação ativa. Manter diagnóstico de reparo e\
\ ausência de transições de estado em consultas."
acceptanceCriteria:
- "Consultas e contexto em processos novos preservam informações e autoridade e\
\ não promovem, migram ou concluem registros por leitura."
- "Anexos descartados legitimamente não invalidam histórico; corrupção e referê\
ncias ausentes não são tratadas como gates satisfeitos."
- "Caminhos selecionados não repetem varreduras/validações globais sem necessidade;\
\ saída e códigos de erro compatíveis são verificados."
dependsOn:
- "TSK-0004"
- "TSK-0005"
- "TSK-0006"
- "TSK-0008"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:13.390096Z"
- id: "TSK-0010"
title: "Implementar migração explícita e recuperável do legado"
description: "Criar comando público de prévia e aplicação da migração, sem conversã\
o em leituras ou atualização do instalador. Usar base de preparo e cópia de seguranç\
a da conversão, importação tipada transacional e verificação contra o corpus.\
\ Preservar IDs, conteúdo, aprovações, hashes, revisões e proveniência histórica\
\ sem despejar arquivos no banco. Ativar somente após sucesso; repetir ou recuperar\
\ interrupção sem duplicar. Executar apenas em fixtures/cópias descartáveis."
acceptanceCriteria:
- "Prévia não modifica o projeto; aplicação compara registros/contexto e ativa a\
\ base somente após validação completa."
- "Fixtures históricas, recibos, aprovações e referências preservam identidade/proveniê\
ncia; execução repetida não duplica conteúdo."
- "Falhas e interrupções deixam a fonte anterior recuperável e informam próxima\
\ ação; nenhum projeto real ou workspace canônico foi migrado."
dependsOn:
- "TSK-0001"
- "TSK-0009"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:21.074969Z"
- id: "TSK-0011"
title: "Atualizar init, descoberta e contrato de compatibilidade"
description: "Inicializar projetos locais em SQLite e deixar .ai-engineering ignorado\
\ pelo Git por padrão sem exigir Git. Preservar regras preexistentes e instruç\
ões fora do bloco gerido. Declarar backend e versões no contrato público, atualizar\
\ diagnóstico/onboard e evitar que base SQLite seja interpretada como workspace\
\ vazio por combinação incompatível. Manter tratamento explícito de projetos legados\
\ e previamente rastreados."
acceptanceCriteria:
- "Init cria projeto funcional sem Git, com estado local ignorado por padrão e bootstrap\
\ suficiente para humanos e agentes."
- "Reexecução preserva conteúdo/regras; não remove arquivos já rastreados nem converte\
\ legado automaticamente."
- "Versões e backend incompatíveis são recusados com diagnóstico acionável antes\
\ de escrita; documentação/entrypoints não induzem uso de CLI incompatível."
dependsOn:
- "TSK-0009"
- "TSK-0010"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:28.841960Z"
status: "OPEN"
author: "Codex"
createdAt: "2026-11-22T11:52:06.993736Z"
revision: 12
previousHash: "970111b8d97ee7737298e1c24fde59e418edfbefe93f8442b5c79f4eb2492cb8"
updatedAt: "2026-11-22T11:53:28.842081Z"
updatedBy: "Codex"
changeReason: "Decomposição solicitada por Nilton; DEC-0001 aceita, com instalaçã\
o real adiada."
documentVersion: 2
---
# Implementar memória de engenharia local em SQLite
## Autoridade e objetivo
Executar a DEC-0001 do WRK-000D, aceita explicitamente por Nilton nesta conversa.
O resultado é um framework local de memória de engenharia por Work, com SQLite
por projeto, investigação e implementação orientadas por OODA, gates preservados,
anexos temporários e retenção mínima. A aprovação desta DEC mantém a instalação
real adiada.
Este Plan foi solicitado com decomposição em vários steps. Todos os steps começam
OPEN; a criação do Plan não constitui execução ou comprovação de resultado.
## Limites obrigatórios
- Não instalar nem substituir o AIE, SQLite, bibliotecas ou atalhos em uso.
- Não executar o instalador real contra HOME, ~/.local/bin ou outro destino ativo.
Sua validação usa fixtures com ferramentas simuladas e destinos descartáveis.
- Não migrar este workspace canônico ou projetos consumidores. Exercitar o novo
backend e a migração em fixtures e cópias descartáveis; ativação real depende de
instrução humana posterior específica.
- Preservar alterações preexistentes, IDs, conteúdo e proveniência legada,
aprovações, evidências históricas e instruções do projeto fora do bloco gerido.
- Não introduzir arquivos em BLOB/base64 ou TEXT equivalente, retenção extensa,
executor autônomo de repositório, colaboração distribuída ou integração Git LFS.
- Importação/exportação de Works/DECs e backup como funcionalidade ficam fora.
A cópia de segurança da migração é parte da recuperação da conversão.
- Código e outputs solicitados permanecem nos destinos de entrega apropriados.
- O WRK-000C permanece aberto para avaliar e tratar latência após esta mudança.
## Execução e dependências
Os 14 steps possuem dependências explícitas e critérios próprios. Mapear primeiro
o contrato e o legado; provar a integração SQLite/JVM/Native Image; depois construir
as transações e migrar os fluxos de domínio. Integrar gates e ciclo dos anexos antes
de consolidar as consultas, a migração pública e o bootstrap. Preparar distribuição
e documentação e concluir com regressão integrada e encaminhamento ao WRK-000C.
Não iniciar um step com dependências pendentes. Verificações focadas fazem parte
de cada mudança; a última etapa integra os cenários e não substitui essas verificações.
Steps independentes podem ser executados em ordem compatível, sem presumir
autorização de delegação ou de instalação real.
## OODA e incertezas
Nas provas relevantes, principalmente driver/nativo, migração e descarte de anexos,
registrar hipótese, critério de sucesso e invocação antes de executar. Registrar
observação, interpretação e próxima ação após o resultado; reconsiderar antes de
repetir uma hipótese falha. Usar os registros de experimentos do Plan quando úteis,
sem impor um ritual de quatro fases a toda alteração.
Ajustar esquema, índices, transações e build dentro da DEC. Se um resultado
questionar a decisão, registrar a preocupação, continuar investigações autorizadas
e rever a DEC com aprovação aplicável antes da execução afetada.
## Verificação e registro mínimo
Durante a execução deste Work, respeitar o protocolo que está em uso. Registrar
resultados reais e evidência mínima necessária para completar os steps; não usar
a futura política de limpeza para apagar evidências legadas ou simular gates.
Verificar continuidade entre processos, integridade referencial, rollback,
concorrência local com espera limitada, autoridade humana, gates e anexos
temporários, migração repetível e operação sem Git. Provas nativas usam somente
artefatos de build e projetos descartáveis.
Comandos candidatos à validação, ajustados ao resultado e ao código final:
- `./gradlew test` e `./gradlew check` para a suíte e arquitetura do projeto.
- `python3 scripts/test-install-native.py` para fixtures do instalador.
- `./gradlew nativeCompile` e tarefas de distribuição para construir o pacote.
- `bash scripts/native-smoke.sh <caminho-absoluto-do-build>` em projetos descartáveis.
Esses comandos são planejados, não executados na criação do Plan. Preservar os
gates específicos do projeto e adicionais do Work definidos na execução. Logs de
trabalho podem ser temporários; guardar na memória somente o necessário ao contrato.
## Conclusão
Todos os steps obrigatórios devem satisfazer seus critérios, com a DEC aceita e
sem experimentos ou preocupações pendentes. A entrega é código, documentação,
pacote preparado e resultados de verificação. Não depende de instalar a nova
versão no ambiente em uso. Encaminhar ao WRK-000C um cenário reproduzível com
comandos, versão, volume e ambiente, sem declarar resolvido o problema de atraso.
@@ -0,0 +1,362 @@
---
schemaVersion: 1
id: "PLN-0001"
workId: "WRK-000D"
title: "Implementar memória de engenharia local em SQLite sem instalação ativa"
decisions:
- "DEC-0001"
steps:
- id: "TSK-0001"
title: "Mapear contrato, dados legados e cenários de migração"
description: "Inspecionar WorkService, serviços de Discussion/Decision/Plan/Agent,\
\ coordenadores e VerificationService. Mapear registros, referências, revisões,\
\ hashes, recibos e bootstrap para tabelas e regras do backend SQLite, preservando\
\ conteúdo e autoridade. Selecionar fixtures existentes de compatibilidade, workflows\
\ e importação como corpus; usar apenas cópias descartáveis. Identificar checks\
\ e pontos de retenção sem realizar benchmark conclusivo do WRK-000C."
acceptanceCriteria:
- "Mapeamento cobre entidades persistidas, IDs locais ao Work, referências, revisõ\
es, aprovações e casos de conclusão legada com hashes/recibos."
- "Corpus representativo e resultados esperados de continuidade/migração estão definidos\
\ antes da conversão, incluindo dados inválidos e estados interrompidos."
- "Limites de instalação, migração de consumidores e preservação do workspace atual\
\ estão explícitos e respeitados."
dependsOn: []
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:52:14.922292Z"
- id: "TSK-0002"
title: "Provar driver SQLite em JVM e Native Image"
description: "Avaliar Xerial SQLite JDBC e fixar versão compatível com Java, Gradle\
\ e GraalVM do projeto. Registrar hipótese, critério e invocação antes da prova.\
\ Criar, gravar, ler e reabrir uma base descartável em processos JVM e nativos.\
\ Verificar carregamento da biblioteca distribuída ao lado do nativo; sqlite3\
\ será ferramenta de diagnóstico do pacote. Construir e executar somente artefatos\
\ descartáveis, sem instalação real."
acceptanceCriteria:
- "Driver e versão selecionados demonstram persistência e reabertura em JVM e Native\
\ Image na plataforma alvo."
- "Biblioteca do pacote é encontrada por caminho controlado e não depende acidentalmente\
\ do SQLite global ou de extração repetida não planejada."
- "Hipótese, resultado e limitações da prova estão registrados; instalação ativa\
\ e projetos consumidores não foram alterados."
dependsOn:
- "TSK-0001"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:52:22.768410Z"
- id: "TSK-0003"
title: "Implementar esquema, conexões e transações SQLite"
description: "Criar infraestrutura de persistência local em .ai-engineering/aie.db\
\ com esquema versionado, tabelas tipadas, índices e relações. Habilitar integridade\
\ referencial em cada conexão, delimitar unidade transacional por operação coerente\
\ e usar leitura consistente. Definir journal/durabilidade e espera limitada de\
\ escrita com diagnóstico. Preservar limites de módulos; serviços aninhados devem\
\ compartilhar a transação aplicável."
acceptanceCriteria:
- "Esquema e índices atendem ao mapeamento sem BLOB/base64 ou arquivos completos\
\ serializados em TEXT."
- "Falha em operação relacionada causa rollback; referências inválidas são recusadas\
\ e gravações concorrentes têm contenção limitada e diagnóstico útil."
- "Abertura de esquema incompatível é diagnosticada sem alterar dados; teste de\
\ leitura consistente cobre mudanças concorrentes locais."
dependsOn:
- "TSK-0001"
- "TSK-0002"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:52:29.986202Z"
- id: "TSK-0004"
title: "Persistir Works e investigação no novo backend"
description: "Integrar Work, guidance e histórico de escolhas, discussões, tópicos,\
\ surveys, respostas e disposições à unidade de persistência. Preservar IDs existentes,\
\ semântica dos IDs locais, referências e histórico útil. Consultas selecionadas\
\ devem buscar o Work diretamente. Manter leitura legada delimitada para compatibilidade\
\ e migração; não manter duas fontes autoritativas para a mesma memória."
acceptanceCriteria:
- "Criar e retomar Work/discussão/survey em outro processo preserva conteúdo, histó\
rico de respostas e pendências."
- "Escolhas DIRECT/EXPLORATORY e autoridade humana mantêm as regras existentes,\
\ inclusive ausência de escolha e pedido específico de DEC."
- "Busca por Work e suas referências usa consultas com escopo adequado; alteraçõ\
es e referências relacionadas são transacionais."
dependsOn:
- "TSK-0003"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:52:37.091047Z"
- id: "TSK-0005"
title: "Persistir decisões, planos e experimentos"
description: "Integrar DecisionService e PlanService com revisões, aceitação, supersessã\
o, passos, dependências e experimentos. Preservar os dois ciclos e OODA, a autoridade\
\ de DEC/Plan e a distinção entre aprovação humana e promoção permitida por polí\
tica. Tratar operações que alteram registros relacionados em uma transação, sem\
\ reduzir os checks de domínio."
acceptanceCriteria:
- "Aprovação, revisão e supersessão preservam autoria e referências, sem fabricaç\
ão de aprovação ou edição silenciosa de decisão aceita."
- "Dependências e estados de passos, critérios de experimentos, preocupações com\
\ DEC e replanejamento conservam os bloqueios existentes."
- "Interrupção simulada não publica meia supersessão ou promoção parcial; retomada\
\ em outro processo preserva o contexto."
dependsOn:
- "TSK-0004"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:52:43.954237Z"
- id: "TSK-0006"
title: "Integrar execuções de agentes e coordenação de EPICs"
description: "Persistir RUNs e seus dados operacionais mínimos, idempotência de\
\ requestId, referências aplicadas e diagnóstico. Integrar PlanCoordinator/EpicCoordinator,\
\ políticas e proveniência de conclusão, representando recibos internos como dados\
\ estruturados quando aplicável. Preservar a fronteira do adaptador: propostas\
\ não aprovam DEC, não respondem pelo humano nem executam comandos de repositó\
rio."
acceptanceCriteria:
- "Repetição idempotente de uma solicitação concluída não duplica registros; solicitaç\
ões divergentes e estados interrompidos são diagnosticados."
- "Políticas RESULTS/DECOMPOSITION, delegação, reabertura, propagação e conclusã\
o por Plans preservam autoridade e proveniência."
- "Resultados estruturados necessários permanecem; transporte bruto, ambiente e\
\ logs completos não viram acervo permanente no banco."
dependsOn:
- "TSK-0005"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:52:50.899228Z"
- id: "TSK-0007"
title: "Integrar gates do projeto e adicionais por Work"
description: "Representar gates obrigatórios do projeto e complementos do Work e\
\ conectar seus resultados aos checks e à entrega. Preservar avaliação externa\
\ e condições de qualidade, inclusive anexos exigidos. Registrar identificaçã\
o, procedimento/execução, estado avaliado, momento e resultado mínimo. Alteraç\
ões pertinentes invalidam a aplicação do resultado aos gates afetados; aprovaç\
ão humana não equivale a sucesso técnico."
acceptanceCriteria:
- "Gate obrigatório pendente, falho ou não executado bloqueia a entrega; gates adicionais\
\ do Work são considerados sem dispensar obrigatórios do projeto."
- "Resultados correspondem ao estado realmente avaliado e não satisfazem silenciosamente\
\ um gate após mudança relevante."
- "Checks existentes e anexos necessários continuam exigidos durante avaliação,\
\ sem introduzir executor autônomo ou retenção bruta obrigatória."
dependsOn:
- "TSK-0005"
- "TSK-0006"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:52:58.285586Z"
- id: "TSK-0008"
title: "Implementar anexos temporários e descarte após checks"
description: "Definir ciclo de vida de anexos e arquivos de execução no filesystem.\
\ Publicar arquivos completos, validar e registrar resultados mínimos antes do\
\ descarte; limpar elegíveis ao fim da execução. Proteger anexos ainda usados\
\ por checks pendentes e outputs solicitados. Recuperar falhas entre publicaçã\
o de arquivo, transação no banco e limpeza, distinguindo descarte legítimo de\
\ perda prematura. Não descartar artefatos legados deste workspace."
acceptanceCriteria:
- "Arquivos exigidos permanecem acessíveis até todos os checks dependentes terminarem,\
\ com resultado persistido antes da remoção."
- "Descarte automático preserva outputs solicitados e memória histórica; arquivo\
\ perdido antes da avaliação continua causando falha."
- "Interrupções nos pontos de publicação, registro e limpeza não fabricam sucesso\
\ e permitem recuperação sem remoção de entradas ainda necessárias."
dependsOn:
- "TSK-0007"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:05.800970Z"
- id: "TSK-0009"
title: "Adaptar verificação, status e contexto ao SQLite"
description: "Integrar VerificationService, CompatibilityService e projeções da\
\ CLI ao backend. Montar status, next-actions, context e readiness com consultas\
\ necessárias e resultados reutilizados na invocação; preservar contrato público\
\ quando compatível e informar mudanças. Separar resultado histórico com anexo\
\ descartado legitimamente de validação ativa. Manter diagnóstico de reparo e\
\ ausência de transições de estado em consultas."
acceptanceCriteria:
- "Consultas e contexto em processos novos preservam informações e autoridade e\
\ não promovem, migram ou concluem registros por leitura."
- "Anexos descartados legitimamente não invalidam histórico; corrupção e referê\
ncias ausentes não são tratadas como gates satisfeitos."
- "Caminhos selecionados não repetem varreduras/validações globais sem necessidade;\
\ saída e códigos de erro compatíveis são verificados."
dependsOn:
- "TSK-0004"
- "TSK-0005"
- "TSK-0006"
- "TSK-0008"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:13.390096Z"
- id: "TSK-0010"
title: "Implementar migração explícita e recuperável do legado"
description: "Criar comando público de prévia e aplicação da migração, sem conversã\
o em leituras ou atualização do instalador. Usar base de preparo e cópia de seguranç\
a da conversão, importação tipada transacional e verificação contra o corpus.\
\ Preservar IDs, conteúdo, aprovações, hashes, revisões e proveniência histórica\
\ sem despejar arquivos no banco. Ativar somente após sucesso; repetir ou recuperar\
\ interrupção sem duplicar. Executar apenas em fixtures/cópias descartáveis."
acceptanceCriteria:
- "Prévia não modifica o projeto; aplicação compara registros/contexto e ativa a\
\ base somente após validação completa."
- "Fixtures históricas, recibos, aprovações e referências preservam identidade/proveniê\
ncia; execução repetida não duplica conteúdo."
- "Falhas e interrupções deixam a fonte anterior recuperável e informam próxima\
\ ação; nenhum projeto real ou workspace canônico foi migrado."
dependsOn:
- "TSK-0001"
- "TSK-0009"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:21.074969Z"
- id: "TSK-0011"
title: "Atualizar init, descoberta e contrato de compatibilidade"
description: "Inicializar projetos locais em SQLite e deixar .ai-engineering ignorado\
\ pelo Git por padrão sem exigir Git. Preservar regras preexistentes e instruç\
ões fora do bloco gerido. Declarar backend e versões no contrato público, atualizar\
\ diagnóstico/onboard e evitar que base SQLite seja interpretada como workspace\
\ vazio por combinação incompatível. Manter tratamento explícito de projetos legados\
\ e previamente rastreados."
acceptanceCriteria:
- "Init cria projeto funcional sem Git, com estado local ignorado por padrão e bootstrap\
\ suficiente para humanos e agentes."
- "Reexecução preserva conteúdo/regras; não remove arquivos já rastreados nem converte\
\ legado automaticamente."
- "Versões e backend incompatíveis são recusados com diagnóstico acionável antes\
\ de escrita; documentação/entrypoints não induzem uso de CLI incompatível."
dependsOn:
- "TSK-0009"
- "TSK-0010"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:28.841960Z"
- id: "TSK-0012"
title: "Preparar pacote nativo e instalador conjunto sem ativação"
description: "Evoluir build/distribuição e scripts/install-native.sh para empacotar\
\ AIE nativo, biblioteca SQLite do driver e CLI sqlite3 num diretório configurá\
vel, com atalhos aie/ai-engineering e dados de projeto separados. Fixar componentes/plataformas\
\ e verificar pacote antes de ativação, preservando versão anterior em falhas.\
\ Testar instalador com ferramentas simuladas e destinos descartáveis; smoke usa\
\ build local. Não executar instalação real nem tocar ~/.local/bin ou dependê\
ncias ativas."
acceptanceCriteria:
- "Pacote contém componentes corretos e o build nativo acessa uma base descartá\
vel sem depender da instalação global."
- "Fixtures verificam diretórios configuráveis, atalhos, atualização conjunta e\
\ falha sem danificar instalação anterior simulada."
- "Nenhum binário, biblioteca ou atalho ativo é substituído e o instalador real\
\ não é executado; a ativação posterior continua dependente de instrução humana."
dependsOn:
- "TSK-0002"
- "TSK-0011"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:37.290314Z"
status: "OPEN"
author: "Codex"
createdAt: "2026-11-22T11:52:06.993736Z"
revision: 13
previousHash: "f7315978de2bb516a99c90e4799b2ba448cdd913ca068735bd74b2b86b0f60d7"
updatedAt: "2026-11-22T11:53:37.290468Z"
updatedBy: "Codex"
changeReason: "Decomposição solicitada por Nilton; DEC-0001 aceita, com instalaçã\
o real adiada."
documentVersion: 2
---
# Implementar memória de engenharia local em SQLite
## Autoridade e objetivo
Executar a DEC-0001 do WRK-000D, aceita explicitamente por Nilton nesta conversa.
O resultado é um framework local de memória de engenharia por Work, com SQLite
por projeto, investigação e implementação orientadas por OODA, gates preservados,
anexos temporários e retenção mínima. A aprovação desta DEC mantém a instalação
real adiada.
Este Plan foi solicitado com decomposição em vários steps. Todos os steps começam
OPEN; a criação do Plan não constitui execução ou comprovação de resultado.
## Limites obrigatórios
- Não instalar nem substituir o AIE, SQLite, bibliotecas ou atalhos em uso.
- Não executar o instalador real contra HOME, ~/.local/bin ou outro destino ativo.
Sua validação usa fixtures com ferramentas simuladas e destinos descartáveis.
- Não migrar este workspace canônico ou projetos consumidores. Exercitar o novo
backend e a migração em fixtures e cópias descartáveis; ativação real depende de
instrução humana posterior específica.
- Preservar alterações preexistentes, IDs, conteúdo e proveniência legada,
aprovações, evidências históricas e instruções do projeto fora do bloco gerido.
- Não introduzir arquivos em BLOB/base64 ou TEXT equivalente, retenção extensa,
executor autônomo de repositório, colaboração distribuída ou integração Git LFS.
- Importação/exportação de Works/DECs e backup como funcionalidade ficam fora.
A cópia de segurança da migração é parte da recuperação da conversão.
- Código e outputs solicitados permanecem nos destinos de entrega apropriados.
- O WRK-000C permanece aberto para avaliar e tratar latência após esta mudança.
## Execução e dependências
Os 14 steps possuem dependências explícitas e critérios próprios. Mapear primeiro
o contrato e o legado; provar a integração SQLite/JVM/Native Image; depois construir
as transações e migrar os fluxos de domínio. Integrar gates e ciclo dos anexos antes
de consolidar as consultas, a migração pública e o bootstrap. Preparar distribuição
e documentação e concluir com regressão integrada e encaminhamento ao WRK-000C.
Não iniciar um step com dependências pendentes. Verificações focadas fazem parte
de cada mudança; a última etapa integra os cenários e não substitui essas verificações.
Steps independentes podem ser executados em ordem compatível, sem presumir
autorização de delegação ou de instalação real.
## OODA e incertezas
Nas provas relevantes, principalmente driver/nativo, migração e descarte de anexos,
registrar hipótese, critério de sucesso e invocação antes de executar. Registrar
observação, interpretação e próxima ação após o resultado; reconsiderar antes de
repetir uma hipótese falha. Usar os registros de experimentos do Plan quando úteis,
sem impor um ritual de quatro fases a toda alteração.
Ajustar esquema, índices, transações e build dentro da DEC. Se um resultado
questionar a decisão, registrar a preocupação, continuar investigações autorizadas
e rever a DEC com aprovação aplicável antes da execução afetada.
## Verificação e registro mínimo
Durante a execução deste Work, respeitar o protocolo que está em uso. Registrar
resultados reais e evidência mínima necessária para completar os steps; não usar
a futura política de limpeza para apagar evidências legadas ou simular gates.
Verificar continuidade entre processos, integridade referencial, rollback,
concorrência local com espera limitada, autoridade humana, gates e anexos
temporários, migração repetível e operação sem Git. Provas nativas usam somente
artefatos de build e projetos descartáveis.
Comandos candidatos à validação, ajustados ao resultado e ao código final:
- `./gradlew test` e `./gradlew check` para a suíte e arquitetura do projeto.
- `python3 scripts/test-install-native.py` para fixtures do instalador.
- `./gradlew nativeCompile` e tarefas de distribuição para construir o pacote.
- `bash scripts/native-smoke.sh <caminho-absoluto-do-build>` em projetos descartáveis.
Esses comandos são planejados, não executados na criação do Plan. Preservar os
gates específicos do projeto e adicionais do Work definidos na execução. Logs de
trabalho podem ser temporários; guardar na memória somente o necessário ao contrato.
## Conclusão
Todos os steps obrigatórios devem satisfazer seus critérios, com a DEC aceita e
sem experimentos ou preocupações pendentes. A entrega é código, documentação,
pacote preparado e resultados de verificação. Não depende de instalar a nova
versão no ambiente em uso. Encaminhar ao WRK-000C um cenário reproduzível com
comandos, versão, volume e ambiente, sem declarar resolvido o problema de atraso.
@@ -0,0 +1,385 @@
---
schemaVersion: 1
id: "PLN-0001"
workId: "WRK-000D"
title: "Implementar memória de engenharia local em SQLite sem instalação ativa"
decisions:
- "DEC-0001"
steps:
- id: "TSK-0001"
title: "Mapear contrato, dados legados e cenários de migração"
description: "Inspecionar WorkService, serviços de Discussion/Decision/Plan/Agent,\
\ coordenadores e VerificationService. Mapear registros, referências, revisões,\
\ hashes, recibos e bootstrap para tabelas e regras do backend SQLite, preservando\
\ conteúdo e autoridade. Selecionar fixtures existentes de compatibilidade, workflows\
\ e importação como corpus; usar apenas cópias descartáveis. Identificar checks\
\ e pontos de retenção sem realizar benchmark conclusivo do WRK-000C."
acceptanceCriteria:
- "Mapeamento cobre entidades persistidas, IDs locais ao Work, referências, revisõ\
es, aprovações e casos de conclusão legada com hashes/recibos."
- "Corpus representativo e resultados esperados de continuidade/migração estão definidos\
\ antes da conversão, incluindo dados inválidos e estados interrompidos."
- "Limites de instalação, migração de consumidores e preservação do workspace atual\
\ estão explícitos e respeitados."
dependsOn: []
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:52:14.922292Z"
- id: "TSK-0002"
title: "Provar driver SQLite em JVM e Native Image"
description: "Avaliar Xerial SQLite JDBC e fixar versão compatível com Java, Gradle\
\ e GraalVM do projeto. Registrar hipótese, critério e invocação antes da prova.\
\ Criar, gravar, ler e reabrir uma base descartável em processos JVM e nativos.\
\ Verificar carregamento da biblioteca distribuída ao lado do nativo; sqlite3\
\ será ferramenta de diagnóstico do pacote. Construir e executar somente artefatos\
\ descartáveis, sem instalação real."
acceptanceCriteria:
- "Driver e versão selecionados demonstram persistência e reabertura em JVM e Native\
\ Image na plataforma alvo."
- "Biblioteca do pacote é encontrada por caminho controlado e não depende acidentalmente\
\ do SQLite global ou de extração repetida não planejada."
- "Hipótese, resultado e limitações da prova estão registrados; instalação ativa\
\ e projetos consumidores não foram alterados."
dependsOn:
- "TSK-0001"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:52:22.768410Z"
- id: "TSK-0003"
title: "Implementar esquema, conexões e transações SQLite"
description: "Criar infraestrutura de persistência local em .ai-engineering/aie.db\
\ com esquema versionado, tabelas tipadas, índices e relações. Habilitar integridade\
\ referencial em cada conexão, delimitar unidade transacional por operação coerente\
\ e usar leitura consistente. Definir journal/durabilidade e espera limitada de\
\ escrita com diagnóstico. Preservar limites de módulos; serviços aninhados devem\
\ compartilhar a transação aplicável."
acceptanceCriteria:
- "Esquema e índices atendem ao mapeamento sem BLOB/base64 ou arquivos completos\
\ serializados em TEXT."
- "Falha em operação relacionada causa rollback; referências inválidas são recusadas\
\ e gravações concorrentes têm contenção limitada e diagnóstico útil."
- "Abertura de esquema incompatível é diagnosticada sem alterar dados; teste de\
\ leitura consistente cobre mudanças concorrentes locais."
dependsOn:
- "TSK-0001"
- "TSK-0002"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:52:29.986202Z"
- id: "TSK-0004"
title: "Persistir Works e investigação no novo backend"
description: "Integrar Work, guidance e histórico de escolhas, discussões, tópicos,\
\ surveys, respostas e disposições à unidade de persistência. Preservar IDs existentes,\
\ semântica dos IDs locais, referências e histórico útil. Consultas selecionadas\
\ devem buscar o Work diretamente. Manter leitura legada delimitada para compatibilidade\
\ e migração; não manter duas fontes autoritativas para a mesma memória."
acceptanceCriteria:
- "Criar e retomar Work/discussão/survey em outro processo preserva conteúdo, histó\
rico de respostas e pendências."
- "Escolhas DIRECT/EXPLORATORY e autoridade humana mantêm as regras existentes,\
\ inclusive ausência de escolha e pedido específico de DEC."
- "Busca por Work e suas referências usa consultas com escopo adequado; alteraçõ\
es e referências relacionadas são transacionais."
dependsOn:
- "TSK-0003"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:52:37.091047Z"
- id: "TSK-0005"
title: "Persistir decisões, planos e experimentos"
description: "Integrar DecisionService e PlanService com revisões, aceitação, supersessã\
o, passos, dependências e experimentos. Preservar os dois ciclos e OODA, a autoridade\
\ de DEC/Plan e a distinção entre aprovação humana e promoção permitida por polí\
tica. Tratar operações que alteram registros relacionados em uma transação, sem\
\ reduzir os checks de domínio."
acceptanceCriteria:
- "Aprovação, revisão e supersessão preservam autoria e referências, sem fabricaç\
ão de aprovação ou edição silenciosa de decisão aceita."
- "Dependências e estados de passos, critérios de experimentos, preocupações com\
\ DEC e replanejamento conservam os bloqueios existentes."
- "Interrupção simulada não publica meia supersessão ou promoção parcial; retomada\
\ em outro processo preserva o contexto."
dependsOn:
- "TSK-0004"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:52:43.954237Z"
- id: "TSK-0006"
title: "Integrar execuções de agentes e coordenação de EPICs"
description: "Persistir RUNs e seus dados operacionais mínimos, idempotência de\
\ requestId, referências aplicadas e diagnóstico. Integrar PlanCoordinator/EpicCoordinator,\
\ políticas e proveniência de conclusão, representando recibos internos como dados\
\ estruturados quando aplicável. Preservar a fronteira do adaptador: propostas\
\ não aprovam DEC, não respondem pelo humano nem executam comandos de repositó\
rio."
acceptanceCriteria:
- "Repetição idempotente de uma solicitação concluída não duplica registros; solicitaç\
ões divergentes e estados interrompidos são diagnosticados."
- "Políticas RESULTS/DECOMPOSITION, delegação, reabertura, propagação e conclusã\
o por Plans preservam autoridade e proveniência."
- "Resultados estruturados necessários permanecem; transporte bruto, ambiente e\
\ logs completos não viram acervo permanente no banco."
dependsOn:
- "TSK-0005"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:52:50.899228Z"
- id: "TSK-0007"
title: "Integrar gates do projeto e adicionais por Work"
description: "Representar gates obrigatórios do projeto e complementos do Work e\
\ conectar seus resultados aos checks e à entrega. Preservar avaliação externa\
\ e condições de qualidade, inclusive anexos exigidos. Registrar identificaçã\
o, procedimento/execução, estado avaliado, momento e resultado mínimo. Alteraç\
ões pertinentes invalidam a aplicação do resultado aos gates afetados; aprovaç\
ão humana não equivale a sucesso técnico."
acceptanceCriteria:
- "Gate obrigatório pendente, falho ou não executado bloqueia a entrega; gates adicionais\
\ do Work são considerados sem dispensar obrigatórios do projeto."
- "Resultados correspondem ao estado realmente avaliado e não satisfazem silenciosamente\
\ um gate após mudança relevante."
- "Checks existentes e anexos necessários continuam exigidos durante avaliação,\
\ sem introduzir executor autônomo ou retenção bruta obrigatória."
dependsOn:
- "TSK-0005"
- "TSK-0006"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:52:58.285586Z"
- id: "TSK-0008"
title: "Implementar anexos temporários e descarte após checks"
description: "Definir ciclo de vida de anexos e arquivos de execução no filesystem.\
\ Publicar arquivos completos, validar e registrar resultados mínimos antes do\
\ descarte; limpar elegíveis ao fim da execução. Proteger anexos ainda usados\
\ por checks pendentes e outputs solicitados. Recuperar falhas entre publicaçã\
o de arquivo, transação no banco e limpeza, distinguindo descarte legítimo de\
\ perda prematura. Não descartar artefatos legados deste workspace."
acceptanceCriteria:
- "Arquivos exigidos permanecem acessíveis até todos os checks dependentes terminarem,\
\ com resultado persistido antes da remoção."
- "Descarte automático preserva outputs solicitados e memória histórica; arquivo\
\ perdido antes da avaliação continua causando falha."
- "Interrupções nos pontos de publicação, registro e limpeza não fabricam sucesso\
\ e permitem recuperação sem remoção de entradas ainda necessárias."
dependsOn:
- "TSK-0007"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:05.800970Z"
- id: "TSK-0009"
title: "Adaptar verificação, status e contexto ao SQLite"
description: "Integrar VerificationService, CompatibilityService e projeções da\
\ CLI ao backend. Montar status, next-actions, context e readiness com consultas\
\ necessárias e resultados reutilizados na invocação; preservar contrato público\
\ quando compatível e informar mudanças. Separar resultado histórico com anexo\
\ descartado legitimamente de validação ativa. Manter diagnóstico de reparo e\
\ ausência de transições de estado em consultas."
acceptanceCriteria:
- "Consultas e contexto em processos novos preservam informações e autoridade e\
\ não promovem, migram ou concluem registros por leitura."
- "Anexos descartados legitimamente não invalidam histórico; corrupção e referê\
ncias ausentes não são tratadas como gates satisfeitos."
- "Caminhos selecionados não repetem varreduras/validações globais sem necessidade;\
\ saída e códigos de erro compatíveis são verificados."
dependsOn:
- "TSK-0004"
- "TSK-0005"
- "TSK-0006"
- "TSK-0008"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:13.390096Z"
- id: "TSK-0010"
title: "Implementar migração explícita e recuperável do legado"
description: "Criar comando público de prévia e aplicação da migração, sem conversã\
o em leituras ou atualização do instalador. Usar base de preparo e cópia de seguranç\
a da conversão, importação tipada transacional e verificação contra o corpus.\
\ Preservar IDs, conteúdo, aprovações, hashes, revisões e proveniência histórica\
\ sem despejar arquivos no banco. Ativar somente após sucesso; repetir ou recuperar\
\ interrupção sem duplicar. Executar apenas em fixtures/cópias descartáveis."
acceptanceCriteria:
- "Prévia não modifica o projeto; aplicação compara registros/contexto e ativa a\
\ base somente após validação completa."
- "Fixtures históricas, recibos, aprovações e referências preservam identidade/proveniê\
ncia; execução repetida não duplica conteúdo."
- "Falhas e interrupções deixam a fonte anterior recuperável e informam próxima\
\ ação; nenhum projeto real ou workspace canônico foi migrado."
dependsOn:
- "TSK-0001"
- "TSK-0009"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:21.074969Z"
- id: "TSK-0011"
title: "Atualizar init, descoberta e contrato de compatibilidade"
description: "Inicializar projetos locais em SQLite e deixar .ai-engineering ignorado\
\ pelo Git por padrão sem exigir Git. Preservar regras preexistentes e instruç\
ões fora do bloco gerido. Declarar backend e versões no contrato público, atualizar\
\ diagnóstico/onboard e evitar que base SQLite seja interpretada como workspace\
\ vazio por combinação incompatível. Manter tratamento explícito de projetos legados\
\ e previamente rastreados."
acceptanceCriteria:
- "Init cria projeto funcional sem Git, com estado local ignorado por padrão e bootstrap\
\ suficiente para humanos e agentes."
- "Reexecução preserva conteúdo/regras; não remove arquivos já rastreados nem converte\
\ legado automaticamente."
- "Versões e backend incompatíveis são recusados com diagnóstico acionável antes\
\ de escrita; documentação/entrypoints não induzem uso de CLI incompatível."
dependsOn:
- "TSK-0009"
- "TSK-0010"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:28.841960Z"
- id: "TSK-0012"
title: "Preparar pacote nativo e instalador conjunto sem ativação"
description: "Evoluir build/distribuição e scripts/install-native.sh para empacotar\
\ AIE nativo, biblioteca SQLite do driver e CLI sqlite3 num diretório configurá\
vel, com atalhos aie/ai-engineering e dados de projeto separados. Fixar componentes/plataformas\
\ e verificar pacote antes de ativação, preservando versão anterior em falhas.\
\ Testar instalador com ferramentas simuladas e destinos descartáveis; smoke usa\
\ build local. Não executar instalação real nem tocar ~/.local/bin ou dependê\
ncias ativas."
acceptanceCriteria:
- "Pacote contém componentes corretos e o build nativo acessa uma base descartá\
vel sem depender da instalação global."
- "Fixtures verificam diretórios configuráveis, atalhos, atualização conjunta e\
\ falha sem danificar instalação anterior simulada."
- "Nenhum binário, biblioteca ou atalho ativo é substituído e o instalador real\
\ não é executado; a ativação posterior continua dependente de instrução humana."
dependsOn:
- "TSK-0002"
- "TSK-0011"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:37.290314Z"
- id: "TSK-0013"
title: "Consolidar documentação e instruções do framework local"
description: "Atualizar README, docs de arquitetura/protocolo/compatibilidade/migraç\
ão e recursos de entrada para memória local, SQLite, gates e retenção mínima.\
\ Explicar anexos temporários, outputs entregues, migração explícita e recuperaç\
ão, pacote preparado e instalação adiada. Remover instruções que apresentem arquivos\
\ de Works como fonte principal nova ou Git como exigência. Preservar orientaç\
ões dos dois ciclos, OODA, DEC/Plan e aprovações."
acceptanceCriteria:
- "Documentação e recursos distribuídos descrevem o mesmo contrato e permitem inicializar/retomar\
\ um projeto sem Git."
- "Procedimento público de migração explica prévia, efeitos e recuperação sem depender\
\ de inspeção do código interno."
- "Limites de retenção e instalação, papel dos gates e recortes futuros estão claros;\
\ fontes e exemplos não alegam testes ou migrações reais não executados."
dependsOn:
- "TSK-0010"
- "TSK-0011"
- "TSK-0012"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:45.331995Z"
status: "OPEN"
author: "Codex"
createdAt: "2026-11-22T11:52:06.993736Z"
revision: 14
previousHash: "70649e46d952cff45e9333b6f15489309c1285266b46ece7727a03c2fca57920"
updatedAt: "2026-11-22T11:53:45.332155Z"
updatedBy: "Codex"
changeReason: "Decomposição solicitada por Nilton; DEC-0001 aceita, com instalaçã\
o real adiada."
documentVersion: 2
---
# Implementar memória de engenharia local em SQLite
## Autoridade e objetivo
Executar a DEC-0001 do WRK-000D, aceita explicitamente por Nilton nesta conversa.
O resultado é um framework local de memória de engenharia por Work, com SQLite
por projeto, investigação e implementação orientadas por OODA, gates preservados,
anexos temporários e retenção mínima. A aprovação desta DEC mantém a instalação
real adiada.
Este Plan foi solicitado com decomposição em vários steps. Todos os steps começam
OPEN; a criação do Plan não constitui execução ou comprovação de resultado.
## Limites obrigatórios
- Não instalar nem substituir o AIE, SQLite, bibliotecas ou atalhos em uso.
- Não executar o instalador real contra HOME, ~/.local/bin ou outro destino ativo.
Sua validação usa fixtures com ferramentas simuladas e destinos descartáveis.
- Não migrar este workspace canônico ou projetos consumidores. Exercitar o novo
backend e a migração em fixtures e cópias descartáveis; ativação real depende de
instrução humana posterior específica.
- Preservar alterações preexistentes, IDs, conteúdo e proveniência legada,
aprovações, evidências históricas e instruções do projeto fora do bloco gerido.
- Não introduzir arquivos em BLOB/base64 ou TEXT equivalente, retenção extensa,
executor autônomo de repositório, colaboração distribuída ou integração Git LFS.
- Importação/exportação de Works/DECs e backup como funcionalidade ficam fora.
A cópia de segurança da migração é parte da recuperação da conversão.
- Código e outputs solicitados permanecem nos destinos de entrega apropriados.
- O WRK-000C permanece aberto para avaliar e tratar latência após esta mudança.
## Execução e dependências
Os 14 steps possuem dependências explícitas e critérios próprios. Mapear primeiro
o contrato e o legado; provar a integração SQLite/JVM/Native Image; depois construir
as transações e migrar os fluxos de domínio. Integrar gates e ciclo dos anexos antes
de consolidar as consultas, a migração pública e o bootstrap. Preparar distribuição
e documentação e concluir com regressão integrada e encaminhamento ao WRK-000C.
Não iniciar um step com dependências pendentes. Verificações focadas fazem parte
de cada mudança; a última etapa integra os cenários e não substitui essas verificações.
Steps independentes podem ser executados em ordem compatível, sem presumir
autorização de delegação ou de instalação real.
## OODA e incertezas
Nas provas relevantes, principalmente driver/nativo, migração e descarte de anexos,
registrar hipótese, critério de sucesso e invocação antes de executar. Registrar
observação, interpretação e próxima ação após o resultado; reconsiderar antes de
repetir uma hipótese falha. Usar os registros de experimentos do Plan quando úteis,
sem impor um ritual de quatro fases a toda alteração.
Ajustar esquema, índices, transações e build dentro da DEC. Se um resultado
questionar a decisão, registrar a preocupação, continuar investigações autorizadas
e rever a DEC com aprovação aplicável antes da execução afetada.
## Verificação e registro mínimo
Durante a execução deste Work, respeitar o protocolo que está em uso. Registrar
resultados reais e evidência mínima necessária para completar os steps; não usar
a futura política de limpeza para apagar evidências legadas ou simular gates.
Verificar continuidade entre processos, integridade referencial, rollback,
concorrência local com espera limitada, autoridade humana, gates e anexos
temporários, migração repetível e operação sem Git. Provas nativas usam somente
artefatos de build e projetos descartáveis.
Comandos candidatos à validação, ajustados ao resultado e ao código final:
- `./gradlew test` e `./gradlew check` para a suíte e arquitetura do projeto.
- `python3 scripts/test-install-native.py` para fixtures do instalador.
- `./gradlew nativeCompile` e tarefas de distribuição para construir o pacote.
- `bash scripts/native-smoke.sh <caminho-absoluto-do-build>` em projetos descartáveis.
Esses comandos são planejados, não executados na criação do Plan. Preservar os
gates específicos do projeto e adicionais do Work definidos na execução. Logs de
trabalho podem ser temporários; guardar na memória somente o necessário ao contrato.
## Conclusão
Todos os steps obrigatórios devem satisfazer seus critérios, com a DEC aceita e
sem experimentos ou preocupações pendentes. A entrega é código, documentação,
pacote preparado e resultados de verificação. Não depende de instalar a nova
versão no ambiente em uso. Encaminhar ao WRK-000C um cenário reproduzível com
comandos, versão, volume e ambiente, sem declarar resolvido o problema de atraso.
@@ -0,0 +1,406 @@
---
schemaVersion: 1
id: "PLN-0001"
workId: "WRK-000D"
title: "Implementar memória de engenharia local em SQLite sem instalação ativa"
decisions:
- "DEC-0001"
steps:
- id: "TSK-0001"
title: "Mapear contrato, dados legados e cenários de migração"
description: "Inspecionar WorkService, serviços de Discussion/Decision/Plan/Agent,\
\ coordenadores e VerificationService. Mapear registros, referências, revisões,\
\ hashes, recibos e bootstrap para tabelas e regras do backend SQLite, preservando\
\ conteúdo e autoridade. Selecionar fixtures existentes de compatibilidade, workflows\
\ e importação como corpus; usar apenas cópias descartáveis. Identificar checks\
\ e pontos de retenção sem realizar benchmark conclusivo do WRK-000C."
acceptanceCriteria:
- "Mapeamento cobre entidades persistidas, IDs locais ao Work, referências, revisõ\
es, aprovações e casos de conclusão legada com hashes/recibos."
- "Corpus representativo e resultados esperados de continuidade/migração estão definidos\
\ antes da conversão, incluindo dados inválidos e estados interrompidos."
- "Limites de instalação, migração de consumidores e preservação do workspace atual\
\ estão explícitos e respeitados."
dependsOn: []
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:52:14.922292Z"
- id: "TSK-0002"
title: "Provar driver SQLite em JVM e Native Image"
description: "Avaliar Xerial SQLite JDBC e fixar versão compatível com Java, Gradle\
\ e GraalVM do projeto. Registrar hipótese, critério e invocação antes da prova.\
\ Criar, gravar, ler e reabrir uma base descartável em processos JVM e nativos.\
\ Verificar carregamento da biblioteca distribuída ao lado do nativo; sqlite3\
\ será ferramenta de diagnóstico do pacote. Construir e executar somente artefatos\
\ descartáveis, sem instalação real."
acceptanceCriteria:
- "Driver e versão selecionados demonstram persistência e reabertura em JVM e Native\
\ Image na plataforma alvo."
- "Biblioteca do pacote é encontrada por caminho controlado e não depende acidentalmente\
\ do SQLite global ou de extração repetida não planejada."
- "Hipótese, resultado e limitações da prova estão registrados; instalação ativa\
\ e projetos consumidores não foram alterados."
dependsOn:
- "TSK-0001"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:52:22.768410Z"
- id: "TSK-0003"
title: "Implementar esquema, conexões e transações SQLite"
description: "Criar infraestrutura de persistência local em .ai-engineering/aie.db\
\ com esquema versionado, tabelas tipadas, índices e relações. Habilitar integridade\
\ referencial em cada conexão, delimitar unidade transacional por operação coerente\
\ e usar leitura consistente. Definir journal/durabilidade e espera limitada de\
\ escrita com diagnóstico. Preservar limites de módulos; serviços aninhados devem\
\ compartilhar a transação aplicável."
acceptanceCriteria:
- "Esquema e índices atendem ao mapeamento sem BLOB/base64 ou arquivos completos\
\ serializados em TEXT."
- "Falha em operação relacionada causa rollback; referências inválidas são recusadas\
\ e gravações concorrentes têm contenção limitada e diagnóstico útil."
- "Abertura de esquema incompatível é diagnosticada sem alterar dados; teste de\
\ leitura consistente cobre mudanças concorrentes locais."
dependsOn:
- "TSK-0001"
- "TSK-0002"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:52:29.986202Z"
- id: "TSK-0004"
title: "Persistir Works e investigação no novo backend"
description: "Integrar Work, guidance e histórico de escolhas, discussões, tópicos,\
\ surveys, respostas e disposições à unidade de persistência. Preservar IDs existentes,\
\ semântica dos IDs locais, referências e histórico útil. Consultas selecionadas\
\ devem buscar o Work diretamente. Manter leitura legada delimitada para compatibilidade\
\ e migração; não manter duas fontes autoritativas para a mesma memória."
acceptanceCriteria:
- "Criar e retomar Work/discussão/survey em outro processo preserva conteúdo, histó\
rico de respostas e pendências."
- "Escolhas DIRECT/EXPLORATORY e autoridade humana mantêm as regras existentes,\
\ inclusive ausência de escolha e pedido específico de DEC."
- "Busca por Work e suas referências usa consultas com escopo adequado; alteraçõ\
es e referências relacionadas são transacionais."
dependsOn:
- "TSK-0003"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:52:37.091047Z"
- id: "TSK-0005"
title: "Persistir decisões, planos e experimentos"
description: "Integrar DecisionService e PlanService com revisões, aceitação, supersessã\
o, passos, dependências e experimentos. Preservar os dois ciclos e OODA, a autoridade\
\ de DEC/Plan e a distinção entre aprovação humana e promoção permitida por polí\
tica. Tratar operações que alteram registros relacionados em uma transação, sem\
\ reduzir os checks de domínio."
acceptanceCriteria:
- "Aprovação, revisão e supersessão preservam autoria e referências, sem fabricaç\
ão de aprovação ou edição silenciosa de decisão aceita."
- "Dependências e estados de passos, critérios de experimentos, preocupações com\
\ DEC e replanejamento conservam os bloqueios existentes."
- "Interrupção simulada não publica meia supersessão ou promoção parcial; retomada\
\ em outro processo preserva o contexto."
dependsOn:
- "TSK-0004"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:52:43.954237Z"
- id: "TSK-0006"
title: "Integrar execuções de agentes e coordenação de EPICs"
description: "Persistir RUNs e seus dados operacionais mínimos, idempotência de\
\ requestId, referências aplicadas e diagnóstico. Integrar PlanCoordinator/EpicCoordinator,\
\ políticas e proveniência de conclusão, representando recibos internos como dados\
\ estruturados quando aplicável. Preservar a fronteira do adaptador: propostas\
\ não aprovam DEC, não respondem pelo humano nem executam comandos de repositó\
rio."
acceptanceCriteria:
- "Repetição idempotente de uma solicitação concluída não duplica registros; solicitaç\
ões divergentes e estados interrompidos são diagnosticados."
- "Políticas RESULTS/DECOMPOSITION, delegação, reabertura, propagação e conclusã\
o por Plans preservam autoridade e proveniência."
- "Resultados estruturados necessários permanecem; transporte bruto, ambiente e\
\ logs completos não viram acervo permanente no banco."
dependsOn:
- "TSK-0005"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:52:50.899228Z"
- id: "TSK-0007"
title: "Integrar gates do projeto e adicionais por Work"
description: "Representar gates obrigatórios do projeto e complementos do Work e\
\ conectar seus resultados aos checks e à entrega. Preservar avaliação externa\
\ e condições de qualidade, inclusive anexos exigidos. Registrar identificaçã\
o, procedimento/execução, estado avaliado, momento e resultado mínimo. Alteraç\
ões pertinentes invalidam a aplicação do resultado aos gates afetados; aprovaç\
ão humana não equivale a sucesso técnico."
acceptanceCriteria:
- "Gate obrigatório pendente, falho ou não executado bloqueia a entrega; gates adicionais\
\ do Work são considerados sem dispensar obrigatórios do projeto."
- "Resultados correspondem ao estado realmente avaliado e não satisfazem silenciosamente\
\ um gate após mudança relevante."
- "Checks existentes e anexos necessários continuam exigidos durante avaliação,\
\ sem introduzir executor autônomo ou retenção bruta obrigatória."
dependsOn:
- "TSK-0005"
- "TSK-0006"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:52:58.285586Z"
- id: "TSK-0008"
title: "Implementar anexos temporários e descarte após checks"
description: "Definir ciclo de vida de anexos e arquivos de execução no filesystem.\
\ Publicar arquivos completos, validar e registrar resultados mínimos antes do\
\ descarte; limpar elegíveis ao fim da execução. Proteger anexos ainda usados\
\ por checks pendentes e outputs solicitados. Recuperar falhas entre publicaçã\
o de arquivo, transação no banco e limpeza, distinguindo descarte legítimo de\
\ perda prematura. Não descartar artefatos legados deste workspace."
acceptanceCriteria:
- "Arquivos exigidos permanecem acessíveis até todos os checks dependentes terminarem,\
\ com resultado persistido antes da remoção."
- "Descarte automático preserva outputs solicitados e memória histórica; arquivo\
\ perdido antes da avaliação continua causando falha."
- "Interrupções nos pontos de publicação, registro e limpeza não fabricam sucesso\
\ e permitem recuperação sem remoção de entradas ainda necessárias."
dependsOn:
- "TSK-0007"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:05.800970Z"
- id: "TSK-0009"
title: "Adaptar verificação, status e contexto ao SQLite"
description: "Integrar VerificationService, CompatibilityService e projeções da\
\ CLI ao backend. Montar status, next-actions, context e readiness com consultas\
\ necessárias e resultados reutilizados na invocação; preservar contrato público\
\ quando compatível e informar mudanças. Separar resultado histórico com anexo\
\ descartado legitimamente de validação ativa. Manter diagnóstico de reparo e\
\ ausência de transições de estado em consultas."
acceptanceCriteria:
- "Consultas e contexto em processos novos preservam informações e autoridade e\
\ não promovem, migram ou concluem registros por leitura."
- "Anexos descartados legitimamente não invalidam histórico; corrupção e referê\
ncias ausentes não são tratadas como gates satisfeitos."
- "Caminhos selecionados não repetem varreduras/validações globais sem necessidade;\
\ saída e códigos de erro compatíveis são verificados."
dependsOn:
- "TSK-0004"
- "TSK-0005"
- "TSK-0006"
- "TSK-0008"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:13.390096Z"
- id: "TSK-0010"
title: "Implementar migração explícita e recuperável do legado"
description: "Criar comando público de prévia e aplicação da migração, sem conversã\
o em leituras ou atualização do instalador. Usar base de preparo e cópia de seguranç\
a da conversão, importação tipada transacional e verificação contra o corpus.\
\ Preservar IDs, conteúdo, aprovações, hashes, revisões e proveniência histórica\
\ sem despejar arquivos no banco. Ativar somente após sucesso; repetir ou recuperar\
\ interrupção sem duplicar. Executar apenas em fixtures/cópias descartáveis."
acceptanceCriteria:
- "Prévia não modifica o projeto; aplicação compara registros/contexto e ativa a\
\ base somente após validação completa."
- "Fixtures históricas, recibos, aprovações e referências preservam identidade/proveniê\
ncia; execução repetida não duplica conteúdo."
- "Falhas e interrupções deixam a fonte anterior recuperável e informam próxima\
\ ação; nenhum projeto real ou workspace canônico foi migrado."
dependsOn:
- "TSK-0001"
- "TSK-0009"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:21.074969Z"
- id: "TSK-0011"
title: "Atualizar init, descoberta e contrato de compatibilidade"
description: "Inicializar projetos locais em SQLite e deixar .ai-engineering ignorado\
\ pelo Git por padrão sem exigir Git. Preservar regras preexistentes e instruç\
ões fora do bloco gerido. Declarar backend e versões no contrato público, atualizar\
\ diagnóstico/onboard e evitar que base SQLite seja interpretada como workspace\
\ vazio por combinação incompatível. Manter tratamento explícito de projetos legados\
\ e previamente rastreados."
acceptanceCriteria:
- "Init cria projeto funcional sem Git, com estado local ignorado por padrão e bootstrap\
\ suficiente para humanos e agentes."
- "Reexecução preserva conteúdo/regras; não remove arquivos já rastreados nem converte\
\ legado automaticamente."
- "Versões e backend incompatíveis são recusados com diagnóstico acionável antes\
\ de escrita; documentação/entrypoints não induzem uso de CLI incompatível."
dependsOn:
- "TSK-0009"
- "TSK-0010"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:28.841960Z"
- id: "TSK-0012"
title: "Preparar pacote nativo e instalador conjunto sem ativação"
description: "Evoluir build/distribuição e scripts/install-native.sh para empacotar\
\ AIE nativo, biblioteca SQLite do driver e CLI sqlite3 num diretório configurá\
vel, com atalhos aie/ai-engineering e dados de projeto separados. Fixar componentes/plataformas\
\ e verificar pacote antes de ativação, preservando versão anterior em falhas.\
\ Testar instalador com ferramentas simuladas e destinos descartáveis; smoke usa\
\ build local. Não executar instalação real nem tocar ~/.local/bin ou dependê\
ncias ativas."
acceptanceCriteria:
- "Pacote contém componentes corretos e o build nativo acessa uma base descartá\
vel sem depender da instalação global."
- "Fixtures verificam diretórios configuráveis, atalhos, atualização conjunta e\
\ falha sem danificar instalação anterior simulada."
- "Nenhum binário, biblioteca ou atalho ativo é substituído e o instalador real\
\ não é executado; a ativação posterior continua dependente de instrução humana."
dependsOn:
- "TSK-0002"
- "TSK-0011"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:37.290314Z"
- id: "TSK-0013"
title: "Consolidar documentação e instruções do framework local"
description: "Atualizar README, docs de arquitetura/protocolo/compatibilidade/migraç\
ão e recursos de entrada para memória local, SQLite, gates e retenção mínima.\
\ Explicar anexos temporários, outputs entregues, migração explícita e recuperaç\
ão, pacote preparado e instalação adiada. Remover instruções que apresentem arquivos\
\ de Works como fonte principal nova ou Git como exigência. Preservar orientaç\
ões dos dois ciclos, OODA, DEC/Plan e aprovações."
acceptanceCriteria:
- "Documentação e recursos distribuídos descrevem o mesmo contrato e permitem inicializar/retomar\
\ um projeto sem Git."
- "Procedimento público de migração explica prévia, efeitos e recuperação sem depender\
\ de inspeção do código interno."
- "Limites de retenção e instalação, papel dos gates e recortes futuros estão claros;\
\ fontes e exemplos não alegam testes ou migrações reais não executados."
dependsOn:
- "TSK-0010"
- "TSK-0011"
- "TSK-0012"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:45.331995Z"
- id: "TSK-0014"
title: "Executar regressão integrada e encaminhar responsividade ao WRK-000C"
description: "Integrar as verificações das etapas e executar gates apropriados de\
\ testes/arquitetura, migração, concorrência e smoke JVM/nativo em ambientes descartá\
veis. Revisar continuidade e autoridade nos dois ciclos, anexos temporários, recuperaç\
ão e funcionamento sem Git. Consolidar resultados mínimos, resolver experimentos/preocupaç\
ões e entregar cenário reproduzível ao WRK-000C com comandos, versão, dados e\
\ ambiente. Não instalar o pacote nem declarar resolvido o atraso."
acceptanceCriteria:
- "Suíte relevante de domínio/integração/compatibilidade, fixtures do instalador\
\ e smoke nativo passam ou impedimentos são tratados antes da conclusão."
- "Falhas, rollback, concorrência, legado, gates e descarte legítimo foram verificados\
\ com resultados reais e sem alteração da instalação ativa ou consumidores."
- "Todos os steps e critérios da DEC estão satisfeitos, sem experimentos/preocupaç\
ões pendentes; WRK-000C recebe cenário para medição futura e permanece aberto."
dependsOn:
- "TSK-0013"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:53.421052Z"
status: "OPEN"
author: "Codex"
createdAt: "2026-11-22T11:52:06.993736Z"
revision: 15
previousHash: "a5a5c39864250c49d70cfdd5dccbdf15f4f5b71d7d1c8ec650106b2a97730962"
updatedAt: "2026-11-22T11:53:53.421222Z"
updatedBy: "Codex"
changeReason: "Decomposição solicitada por Nilton; DEC-0001 aceita, com instalaçã\
o real adiada."
documentVersion: 2
---
# Implementar memória de engenharia local em SQLite
## Autoridade e objetivo
Executar a DEC-0001 do WRK-000D, aceita explicitamente por Nilton nesta conversa.
O resultado é um framework local de memória de engenharia por Work, com SQLite
por projeto, investigação e implementação orientadas por OODA, gates preservados,
anexos temporários e retenção mínima. A aprovação desta DEC mantém a instalação
real adiada.
Este Plan foi solicitado com decomposição em vários steps. Todos os steps começam
OPEN; a criação do Plan não constitui execução ou comprovação de resultado.
## Limites obrigatórios
- Não instalar nem substituir o AIE, SQLite, bibliotecas ou atalhos em uso.
- Não executar o instalador real contra HOME, ~/.local/bin ou outro destino ativo.
Sua validação usa fixtures com ferramentas simuladas e destinos descartáveis.
- Não migrar este workspace canônico ou projetos consumidores. Exercitar o novo
backend e a migração em fixtures e cópias descartáveis; ativação real depende de
instrução humana posterior específica.
- Preservar alterações preexistentes, IDs, conteúdo e proveniência legada,
aprovações, evidências históricas e instruções do projeto fora do bloco gerido.
- Não introduzir arquivos em BLOB/base64 ou TEXT equivalente, retenção extensa,
executor autônomo de repositório, colaboração distribuída ou integração Git LFS.
- Importação/exportação de Works/DECs e backup como funcionalidade ficam fora.
A cópia de segurança da migração é parte da recuperação da conversão.
- Código e outputs solicitados permanecem nos destinos de entrega apropriados.
- O WRK-000C permanece aberto para avaliar e tratar latência após esta mudança.
## Execução e dependências
Os 14 steps possuem dependências explícitas e critérios próprios. Mapear primeiro
o contrato e o legado; provar a integração SQLite/JVM/Native Image; depois construir
as transações e migrar os fluxos de domínio. Integrar gates e ciclo dos anexos antes
de consolidar as consultas, a migração pública e o bootstrap. Preparar distribuição
e documentação e concluir com regressão integrada e encaminhamento ao WRK-000C.
Não iniciar um step com dependências pendentes. Verificações focadas fazem parte
de cada mudança; a última etapa integra os cenários e não substitui essas verificações.
Steps independentes podem ser executados em ordem compatível, sem presumir
autorização de delegação ou de instalação real.
## OODA e incertezas
Nas provas relevantes, principalmente driver/nativo, migração e descarte de anexos,
registrar hipótese, critério de sucesso e invocação antes de executar. Registrar
observação, interpretação e próxima ação após o resultado; reconsiderar antes de
repetir uma hipótese falha. Usar os registros de experimentos do Plan quando úteis,
sem impor um ritual de quatro fases a toda alteração.
Ajustar esquema, índices, transações e build dentro da DEC. Se um resultado
questionar a decisão, registrar a preocupação, continuar investigações autorizadas
e rever a DEC com aprovação aplicável antes da execução afetada.
## Verificação e registro mínimo
Durante a execução deste Work, respeitar o protocolo que está em uso. Registrar
resultados reais e evidência mínima necessária para completar os steps; não usar
a futura política de limpeza para apagar evidências legadas ou simular gates.
Verificar continuidade entre processos, integridade referencial, rollback,
concorrência local com espera limitada, autoridade humana, gates e anexos
temporários, migração repetível e operação sem Git. Provas nativas usam somente
artefatos de build e projetos descartáveis.
Comandos candidatos à validação, ajustados ao resultado e ao código final:
- `./gradlew test` e `./gradlew check` para a suíte e arquitetura do projeto.
- `python3 scripts/test-install-native.py` para fixtures do instalador.
- `./gradlew nativeCompile` e tarefas de distribuição para construir o pacote.
- `bash scripts/native-smoke.sh <caminho-absoluto-do-build>` em projetos descartáveis.
Esses comandos são planejados, não executados na criação do Plan. Preservar os
gates específicos do projeto e adicionais do Work definidos na execução. Logs de
trabalho podem ser temporários; guardar na memória somente o necessário ao contrato.
## Conclusão
Todos os steps obrigatórios devem satisfazer seus critérios, com a DEC aceita e
sem experimentos ou preocupações pendentes. A entrega é código, documentação,
pacote preparado e resultados de verificação. Não depende de instalar a nova
versão no ambiente em uso. Encaminhar ao WRK-000C um cenário reproduzível com
comandos, versão, volume e ambiente, sem declarar resolvido o problema de atraso.
@@ -0,0 +1,406 @@
---
schemaVersion: 1
id: "PLN-0001"
workId: "WRK-000D"
title: "Implementar memória de engenharia local em SQLite sem instalação ativa"
decisions:
- "DEC-0001"
steps:
- id: "TSK-0001"
title: "Mapear contrato, dados legados e cenários de migração"
description: "Inspecionar WorkService, serviços de Discussion/Decision/Plan/Agent,\
\ coordenadores e VerificationService. Mapear registros, referências, revisões,\
\ hashes, recibos e bootstrap para tabelas e regras do backend SQLite, preservando\
\ conteúdo e autoridade. Selecionar fixtures existentes de compatibilidade, workflows\
\ e importação como corpus; usar apenas cópias descartáveis. Identificar checks\
\ e pontos de retenção sem realizar benchmark conclusivo do WRK-000C."
acceptanceCriteria:
- "Mapeamento cobre entidades persistidas, IDs locais ao Work, referências, revisõ\
es, aprovações e casos de conclusão legada com hashes/recibos."
- "Corpus representativo e resultados esperados de continuidade/migração estão definidos\
\ antes da conversão, incluindo dados inválidos e estados interrompidos."
- "Limites de instalação, migração de consumidores e preservação do workspace atual\
\ estão explícitos e respeitados."
dependsOn: []
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:52:14.922292Z"
- id: "TSK-0002"
title: "Provar driver SQLite em JVM e Native Image"
description: "Avaliar Xerial SQLite JDBC e fixar versão compatível com Java, Gradle\
\ e GraalVM do projeto. Registrar hipótese, critério e invocação antes da prova.\
\ Criar, gravar, ler e reabrir uma base descartável em processos JVM e nativos.\
\ Verificar carregamento da biblioteca distribuída ao lado do nativo; sqlite3\
\ será ferramenta de diagnóstico do pacote. Construir e executar somente artefatos\
\ descartáveis, sem instalação real."
acceptanceCriteria:
- "Driver e versão selecionados demonstram persistência e reabertura em JVM e Native\
\ Image na plataforma alvo."
- "Biblioteca do pacote é encontrada por caminho controlado e não depende acidentalmente\
\ do SQLite global ou de extração repetida não planejada."
- "Hipótese, resultado e limitações da prova estão registrados; instalação ativa\
\ e projetos consumidores não foram alterados."
dependsOn:
- "TSK-0001"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:52:22.768410Z"
- id: "TSK-0003"
title: "Implementar esquema, conexões e transações SQLite"
description: "Criar infraestrutura de persistência local em .ai-engineering/aie.db\
\ com esquema versionado, tabelas tipadas, índices e relações. Habilitar integridade\
\ referencial em cada conexão, delimitar unidade transacional por operação coerente\
\ e usar leitura consistente. Definir journal/durabilidade e espera limitada de\
\ escrita com diagnóstico. Preservar limites de módulos; serviços aninhados devem\
\ compartilhar a transação aplicável."
acceptanceCriteria:
- "Esquema e índices atendem ao mapeamento sem BLOB/base64 ou arquivos completos\
\ serializados em TEXT."
- "Falha em operação relacionada causa rollback; referências inválidas são recusadas\
\ e gravações concorrentes têm contenção limitada e diagnóstico útil."
- "Abertura de esquema incompatível é diagnosticada sem alterar dados; teste de\
\ leitura consistente cobre mudanças concorrentes locais."
dependsOn:
- "TSK-0001"
- "TSK-0002"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:52:29.986202Z"
- id: "TSK-0004"
title: "Persistir Works e investigação no novo backend"
description: "Integrar Work, guidance e histórico de escolhas, discussões, tópicos,\
\ surveys, respostas e disposições à unidade de persistência. Preservar IDs existentes,\
\ semântica dos IDs locais, referências e histórico útil. Consultas selecionadas\
\ devem buscar o Work diretamente. Manter leitura legada delimitada para compatibilidade\
\ e migração; não manter duas fontes autoritativas para a mesma memória."
acceptanceCriteria:
- "Criar e retomar Work/discussão/survey em outro processo preserva conteúdo, histó\
rico de respostas e pendências."
- "Escolhas DIRECT/EXPLORATORY e autoridade humana mantêm as regras existentes,\
\ inclusive ausência de escolha e pedido específico de DEC."
- "Busca por Work e suas referências usa consultas com escopo adequado; alteraçõ\
es e referências relacionadas são transacionais."
dependsOn:
- "TSK-0003"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:52:37.091047Z"
- id: "TSK-0005"
title: "Persistir decisões, planos e experimentos"
description: "Integrar DecisionService e PlanService com revisões, aceitação, supersessã\
o, passos, dependências e experimentos. Preservar os dois ciclos e OODA, a autoridade\
\ de DEC/Plan e a distinção entre aprovação humana e promoção permitida por polí\
tica. Tratar operações que alteram registros relacionados em uma transação, sem\
\ reduzir os checks de domínio."
acceptanceCriteria:
- "Aprovação, revisão e supersessão preservam autoria e referências, sem fabricaç\
ão de aprovação ou edição silenciosa de decisão aceita."
- "Dependências e estados de passos, critérios de experimentos, preocupações com\
\ DEC e replanejamento conservam os bloqueios existentes."
- "Interrupção simulada não publica meia supersessão ou promoção parcial; retomada\
\ em outro processo preserva o contexto."
dependsOn:
- "TSK-0004"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:52:43.954237Z"
- id: "TSK-0006"
title: "Integrar execuções de agentes e coordenação de EPICs"
description: "Persistir RUNs e seus dados operacionais mínimos, idempotência de\
\ requestId, referências aplicadas e diagnóstico. Integrar PlanCoordinator/EpicCoordinator,\
\ políticas e proveniência de conclusão, representando recibos internos como dados\
\ estruturados quando aplicável. Preservar a fronteira do adaptador: propostas\
\ não aprovam DEC, não respondem pelo humano nem executam comandos de repositó\
rio."
acceptanceCriteria:
- "Repetição idempotente de uma solicitação concluída não duplica registros; solicitaç\
ões divergentes e estados interrompidos são diagnosticados."
- "Políticas RESULTS/DECOMPOSITION, delegação, reabertura, propagação e conclusã\
o por Plans preservam autoridade e proveniência."
- "Resultados estruturados necessários permanecem; transporte bruto, ambiente e\
\ logs completos não viram acervo permanente no banco."
dependsOn:
- "TSK-0005"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:52:50.899228Z"
- id: "TSK-0007"
title: "Integrar gates do projeto e adicionais por Work"
description: "Representar gates obrigatórios do projeto e complementos do Work e\
\ conectar seus resultados aos checks e à entrega. Preservar avaliação externa\
\ e condições de qualidade, inclusive anexos exigidos. Registrar identificaçã\
o, procedimento/execução, estado avaliado, momento e resultado mínimo. Alteraç\
ões pertinentes invalidam a aplicação do resultado aos gates afetados; aprovaç\
ão humana não equivale a sucesso técnico."
acceptanceCriteria:
- "Gate obrigatório pendente, falho ou não executado bloqueia a entrega; gates adicionais\
\ do Work são considerados sem dispensar obrigatórios do projeto."
- "Resultados correspondem ao estado realmente avaliado e não satisfazem silenciosamente\
\ um gate após mudança relevante."
- "Checks existentes e anexos necessários continuam exigidos durante avaliação,\
\ sem introduzir executor autônomo ou retenção bruta obrigatória."
dependsOn:
- "TSK-0005"
- "TSK-0006"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:52:58.285586Z"
- id: "TSK-0008"
title: "Implementar anexos temporários e descarte após checks"
description: "Definir ciclo de vida de anexos e arquivos de execução no filesystem.\
\ Publicar arquivos completos, validar e registrar resultados mínimos antes do\
\ descarte; limpar elegíveis ao fim da execução. Proteger anexos ainda usados\
\ por checks pendentes e outputs solicitados. Recuperar falhas entre publicaçã\
o de arquivo, transação no banco e limpeza, distinguindo descarte legítimo de\
\ perda prematura. Não descartar artefatos legados deste workspace."
acceptanceCriteria:
- "Arquivos exigidos permanecem acessíveis até todos os checks dependentes terminarem,\
\ com resultado persistido antes da remoção."
- "Descarte automático preserva outputs solicitados e memória histórica; arquivo\
\ perdido antes da avaliação continua causando falha."
- "Interrupções nos pontos de publicação, registro e limpeza não fabricam sucesso\
\ e permitem recuperação sem remoção de entradas ainda necessárias."
dependsOn:
- "TSK-0007"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:05.800970Z"
- id: "TSK-0009"
title: "Adaptar verificação, status e contexto ao SQLite"
description: "Integrar VerificationService, CompatibilityService e projeções da\
\ CLI ao backend. Montar status, next-actions, context e readiness com consultas\
\ necessárias e resultados reutilizados na invocação; preservar contrato público\
\ quando compatível e informar mudanças. Separar resultado histórico com anexo\
\ descartado legitimamente de validação ativa. Manter diagnóstico de reparo e\
\ ausência de transições de estado em consultas."
acceptanceCriteria:
- "Consultas e contexto em processos novos preservam informações e autoridade e\
\ não promovem, migram ou concluem registros por leitura."
- "Anexos descartados legitimamente não invalidam histórico; corrupção e referê\
ncias ausentes não são tratadas como gates satisfeitos."
- "Caminhos selecionados não repetem varreduras/validações globais sem necessidade;\
\ saída e códigos de erro compatíveis são verificados."
dependsOn:
- "TSK-0004"
- "TSK-0005"
- "TSK-0006"
- "TSK-0008"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:13.390096Z"
- id: "TSK-0010"
title: "Implementar migração explícita e recuperável do legado"
description: "Criar comando público de prévia e aplicação da migração, sem conversã\
o em leituras ou atualização do instalador. Usar base de preparo e cópia de seguranç\
a da conversão, importação tipada transacional e verificação contra o corpus.\
\ Preservar IDs, conteúdo, aprovações, hashes, revisões e proveniência histórica\
\ sem despejar arquivos no banco. Ativar somente após sucesso; repetir ou recuperar\
\ interrupção sem duplicar. Executar apenas em fixtures/cópias descartáveis."
acceptanceCriteria:
- "Prévia não modifica o projeto; aplicação compara registros/contexto e ativa a\
\ base somente após validação completa."
- "Fixtures históricas, recibos, aprovações e referências preservam identidade/proveniê\
ncia; execução repetida não duplica conteúdo."
- "Falhas e interrupções deixam a fonte anterior recuperável e informam próxima\
\ ação; nenhum projeto real ou workspace canônico foi migrado."
dependsOn:
- "TSK-0001"
- "TSK-0009"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:21.074969Z"
- id: "TSK-0011"
title: "Atualizar init, descoberta e contrato de compatibilidade"
description: "Inicializar projetos locais em SQLite e deixar .ai-engineering ignorado\
\ pelo Git por padrão sem exigir Git. Preservar regras preexistentes e instruç\
ões fora do bloco gerido. Declarar backend e versões no contrato público, atualizar\
\ diagnóstico/onboard e evitar que base SQLite seja interpretada como workspace\
\ vazio por combinação incompatível. Manter tratamento explícito de projetos legados\
\ e previamente rastreados."
acceptanceCriteria:
- "Init cria projeto funcional sem Git, com estado local ignorado por padrão e bootstrap\
\ suficiente para humanos e agentes."
- "Reexecução preserva conteúdo/regras; não remove arquivos já rastreados nem converte\
\ legado automaticamente."
- "Versões e backend incompatíveis são recusados com diagnóstico acionável antes\
\ de escrita; documentação/entrypoints não induzem uso de CLI incompatível."
dependsOn:
- "TSK-0009"
- "TSK-0010"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:28.841960Z"
- id: "TSK-0012"
title: "Preparar pacote nativo e instalador conjunto sem ativação"
description: "Evoluir build/distribuição e scripts/install-native.sh para empacotar\
\ AIE nativo, biblioteca SQLite do driver e CLI sqlite3 num diretório configurá\
vel, com atalhos aie/ai-engineering e dados de projeto separados. Fixar componentes/plataformas\
\ e verificar pacote antes de ativação, preservando versão anterior em falhas.\
\ Testar instalador com ferramentas simuladas e destinos descartáveis; smoke usa\
\ build local. Não executar instalação real nem tocar ~/.local/bin ou dependê\
ncias ativas."
acceptanceCriteria:
- "Pacote contém componentes corretos e o build nativo acessa uma base descartá\
vel sem depender da instalação global."
- "Fixtures verificam diretórios configuráveis, atalhos, atualização conjunta e\
\ falha sem danificar instalação anterior simulada."
- "Nenhum binário, biblioteca ou atalho ativo é substituído e o instalador real\
\ não é executado; a ativação posterior continua dependente de instrução humana."
dependsOn:
- "TSK-0002"
- "TSK-0011"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:37.290314Z"
- id: "TSK-0013"
title: "Consolidar documentação e instruções do framework local"
description: "Atualizar README, docs de arquitetura/protocolo/compatibilidade/migraç\
ão e recursos de entrada para memória local, SQLite, gates e retenção mínima.\
\ Explicar anexos temporários, outputs entregues, migração explícita e recuperaç\
ão, pacote preparado e instalação adiada. Remover instruções que apresentem arquivos\
\ de Works como fonte principal nova ou Git como exigência. Preservar orientaç\
ões dos dois ciclos, OODA, DEC/Plan e aprovações."
acceptanceCriteria:
- "Documentação e recursos distribuídos descrevem o mesmo contrato e permitem inicializar/retomar\
\ um projeto sem Git."
- "Procedimento público de migração explica prévia, efeitos e recuperação sem depender\
\ de inspeção do código interno."
- "Limites de retenção e instalação, papel dos gates e recortes futuros estão claros;\
\ fontes e exemplos não alegam testes ou migrações reais não executados."
dependsOn:
- "TSK-0010"
- "TSK-0011"
- "TSK-0012"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:45.331995Z"
- id: "TSK-0014"
title: "Executar regressão integrada e encaminhar responsividade ao WRK-000C"
description: "Integrar as verificações das etapas e executar gates apropriados de\
\ testes/arquitetura, migração, concorrência e smoke JVM/nativo em ambientes descartá\
veis. Revisar continuidade e autoridade nos dois ciclos, anexos temporários, recuperaç\
ão e funcionamento sem Git. Consolidar resultados mínimos, resolver experimentos/preocupaç\
ões e entregar cenário reproduzível ao WRK-000C com comandos, versão, dados e\
\ ambiente. Não instalar o pacote nem declarar resolvido o atraso."
acceptanceCriteria:
- "Suíte relevante de domínio/integração/compatibilidade, fixtures do instalador\
\ e smoke nativo passam ou impedimentos são tratados antes da conclusão."
- "Falhas, rollback, concorrência, legado, gates e descarte legítimo foram verificados\
\ com resultados reais e sem alteração da instalação ativa ou consumidores."
- "Todos os steps e critérios da DEC estão satisfeitos, sem experimentos/preocupaç\
ões pendentes; WRK-000C recebe cenário para medição futura e permanece aberto."
dependsOn:
- "TSK-0013"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:53.421052Z"
status: "ACTIVE"
author: "Codex"
createdAt: "2026-11-22T11:52:06.993736Z"
revision: 16
previousHash: "736533eb9739961d687b9b6c4e5ee2fe60178bb6356c650dae79cec2e8ed6d03"
updatedAt: "2026-11-22T11:56:30.194272Z"
updatedBy: "Codex"
changeReason: "Execução sequencial solicitada por Nilton; iniciar pelo mapeamento,\
\ sem instalação ativa ou migração real."
documentVersion: 2
---
# Implementar memória de engenharia local em SQLite
## Autoridade e objetivo
Executar a DEC-0001 do WRK-000D, aceita explicitamente por Nilton nesta conversa.
O resultado é um framework local de memória de engenharia por Work, com SQLite
por projeto, investigação e implementação orientadas por OODA, gates preservados,
anexos temporários e retenção mínima. A aprovação desta DEC mantém a instalação
real adiada.
Este Plan foi solicitado com decomposição em vários steps. Todos os steps começam
OPEN; a criação do Plan não constitui execução ou comprovação de resultado.
## Limites obrigatórios
- Não instalar nem substituir o AIE, SQLite, bibliotecas ou atalhos em uso.
- Não executar o instalador real contra HOME, ~/.local/bin ou outro destino ativo.
Sua validação usa fixtures com ferramentas simuladas e destinos descartáveis.
- Não migrar este workspace canônico ou projetos consumidores. Exercitar o novo
backend e a migração em fixtures e cópias descartáveis; ativação real depende de
instrução humana posterior específica.
- Preservar alterações preexistentes, IDs, conteúdo e proveniência legada,
aprovações, evidências históricas e instruções do projeto fora do bloco gerido.
- Não introduzir arquivos em BLOB/base64 ou TEXT equivalente, retenção extensa,
executor autônomo de repositório, colaboração distribuída ou integração Git LFS.
- Importação/exportação de Works/DECs e backup como funcionalidade ficam fora.
A cópia de segurança da migração é parte da recuperação da conversão.
- Código e outputs solicitados permanecem nos destinos de entrega apropriados.
- O WRK-000C permanece aberto para avaliar e tratar latência após esta mudança.
## Execução e dependências
Os 14 steps possuem dependências explícitas e critérios próprios. Mapear primeiro
o contrato e o legado; provar a integração SQLite/JVM/Native Image; depois construir
as transações e migrar os fluxos de domínio. Integrar gates e ciclo dos anexos antes
de consolidar as consultas, a migração pública e o bootstrap. Preparar distribuição
e documentação e concluir com regressão integrada e encaminhamento ao WRK-000C.
Não iniciar um step com dependências pendentes. Verificações focadas fazem parte
de cada mudança; a última etapa integra os cenários e não substitui essas verificações.
Steps independentes podem ser executados em ordem compatível, sem presumir
autorização de delegação ou de instalação real.
## OODA e incertezas
Nas provas relevantes, principalmente driver/nativo, migração e descarte de anexos,
registrar hipótese, critério de sucesso e invocação antes de executar. Registrar
observação, interpretação e próxima ação após o resultado; reconsiderar antes de
repetir uma hipótese falha. Usar os registros de experimentos do Plan quando úteis,
sem impor um ritual de quatro fases a toda alteração.
Ajustar esquema, índices, transações e build dentro da DEC. Se um resultado
questionar a decisão, registrar a preocupação, continuar investigações autorizadas
e rever a DEC com aprovação aplicável antes da execução afetada.
## Verificação e registro mínimo
Durante a execução deste Work, respeitar o protocolo que está em uso. Registrar
resultados reais e evidência mínima necessária para completar os steps; não usar
a futura política de limpeza para apagar evidências legadas ou simular gates.
Verificar continuidade entre processos, integridade referencial, rollback,
concorrência local com espera limitada, autoridade humana, gates e anexos
temporários, migração repetível e operação sem Git. Provas nativas usam somente
artefatos de build e projetos descartáveis.
Comandos candidatos à validação, ajustados ao resultado e ao código final:
- `./gradlew test` e `./gradlew check` para a suíte e arquitetura do projeto.
- `python3 scripts/test-install-native.py` para fixtures do instalador.
- `./gradlew nativeCompile` e tarefas de distribuição para construir o pacote.
- `bash scripts/native-smoke.sh <caminho-absoluto-do-build>` em projetos descartáveis.
Esses comandos são planejados, não executados na criação do Plan. Preservar os
gates específicos do projeto e adicionais do Work definidos na execução. Logs de
trabalho podem ser temporários; guardar na memória somente o necessário ao contrato.
## Conclusão
Todos os steps obrigatórios devem satisfazer seus critérios, com a DEC aceita e
sem experimentos ou preocupações pendentes. A entrega é código, documentação,
pacote preparado e resultados de verificação. Não depende de instalar a nova
versão no ambiente em uso. Encaminhar ao WRK-000C um cenário reproduzível com
comandos, versão, volume e ambiente, sem declarar resolvido o problema de atraso.
@@ -0,0 +1,407 @@
---
schemaVersion: 1
id: "PLN-0001"
workId: "WRK-000D"
title: "Implementar memória de engenharia local em SQLite sem instalação ativa"
decisions:
- "DEC-0001"
steps:
- id: "TSK-0001"
title: "Mapear contrato, dados legados e cenários de migração"
description: "Inspecionar WorkService, serviços de Discussion/Decision/Plan/Agent,\
\ coordenadores e VerificationService. Mapear registros, referências, revisões,\
\ hashes, recibos e bootstrap para tabelas e regras do backend SQLite, preservando\
\ conteúdo e autoridade. Selecionar fixtures existentes de compatibilidade, workflows\
\ e importação como corpus; usar apenas cópias descartáveis. Identificar checks\
\ e pontos de retenção sem realizar benchmark conclusivo do WRK-000C."
acceptanceCriteria:
- "Mapeamento cobre entidades persistidas, IDs locais ao Work, referências, revisõ\
es, aprovações e casos de conclusão legada com hashes/recibos."
- "Corpus representativo e resultados esperados de continuidade/migração estão definidos\
\ antes da conversão, incluindo dados inválidos e estados interrompidos."
- "Limites de instalação, migração de consumidores e preservação do workspace atual\
\ estão explícitos e respeitados."
dependsOn: []
status: "ACTIVE"
result: "Iniciar inventário do contrato, relações e corpus de compatibilidade; executar\
\ somente inspeções e testes em dados descartáveis."
evidence: []
updatedAt: "2026-11-22T11:57:06.380554Z"
- id: "TSK-0002"
title: "Provar driver SQLite em JVM e Native Image"
description: "Avaliar Xerial SQLite JDBC e fixar versão compatível com Java, Gradle\
\ e GraalVM do projeto. Registrar hipótese, critério e invocação antes da prova.\
\ Criar, gravar, ler e reabrir uma base descartável em processos JVM e nativos.\
\ Verificar carregamento da biblioteca distribuída ao lado do nativo; sqlite3\
\ será ferramenta de diagnóstico do pacote. Construir e executar somente artefatos\
\ descartáveis, sem instalação real."
acceptanceCriteria:
- "Driver e versão selecionados demonstram persistência e reabertura em JVM e Native\
\ Image na plataforma alvo."
- "Biblioteca do pacote é encontrada por caminho controlado e não depende acidentalmente\
\ do SQLite global ou de extração repetida não planejada."
- "Hipótese, resultado e limitações da prova estão registrados; instalação ativa\
\ e projetos consumidores não foram alterados."
dependsOn:
- "TSK-0001"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:52:22.768410Z"
- id: "TSK-0003"
title: "Implementar esquema, conexões e transações SQLite"
description: "Criar infraestrutura de persistência local em .ai-engineering/aie.db\
\ com esquema versionado, tabelas tipadas, índices e relações. Habilitar integridade\
\ referencial em cada conexão, delimitar unidade transacional por operação coerente\
\ e usar leitura consistente. Definir journal/durabilidade e espera limitada de\
\ escrita com diagnóstico. Preservar limites de módulos; serviços aninhados devem\
\ compartilhar a transação aplicável."
acceptanceCriteria:
- "Esquema e índices atendem ao mapeamento sem BLOB/base64 ou arquivos completos\
\ serializados em TEXT."
- "Falha em operação relacionada causa rollback; referências inválidas são recusadas\
\ e gravações concorrentes têm contenção limitada e diagnóstico útil."
- "Abertura de esquema incompatível é diagnosticada sem alterar dados; teste de\
\ leitura consistente cobre mudanças concorrentes locais."
dependsOn:
- "TSK-0001"
- "TSK-0002"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:52:29.986202Z"
- id: "TSK-0004"
title: "Persistir Works e investigação no novo backend"
description: "Integrar Work, guidance e histórico de escolhas, discussões, tópicos,\
\ surveys, respostas e disposições à unidade de persistência. Preservar IDs existentes,\
\ semântica dos IDs locais, referências e histórico útil. Consultas selecionadas\
\ devem buscar o Work diretamente. Manter leitura legada delimitada para compatibilidade\
\ e migração; não manter duas fontes autoritativas para a mesma memória."
acceptanceCriteria:
- "Criar e retomar Work/discussão/survey em outro processo preserva conteúdo, histó\
rico de respostas e pendências."
- "Escolhas DIRECT/EXPLORATORY e autoridade humana mantêm as regras existentes,\
\ inclusive ausência de escolha e pedido específico de DEC."
- "Busca por Work e suas referências usa consultas com escopo adequado; alteraçõ\
es e referências relacionadas são transacionais."
dependsOn:
- "TSK-0003"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:52:37.091047Z"
- id: "TSK-0005"
title: "Persistir decisões, planos e experimentos"
description: "Integrar DecisionService e PlanService com revisões, aceitação, supersessã\
o, passos, dependências e experimentos. Preservar os dois ciclos e OODA, a autoridade\
\ de DEC/Plan e a distinção entre aprovação humana e promoção permitida por polí\
tica. Tratar operações que alteram registros relacionados em uma transação, sem\
\ reduzir os checks de domínio."
acceptanceCriteria:
- "Aprovação, revisão e supersessão preservam autoria e referências, sem fabricaç\
ão de aprovação ou edição silenciosa de decisão aceita."
- "Dependências e estados de passos, critérios de experimentos, preocupações com\
\ DEC e replanejamento conservam os bloqueios existentes."
- "Interrupção simulada não publica meia supersessão ou promoção parcial; retomada\
\ em outro processo preserva o contexto."
dependsOn:
- "TSK-0004"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:52:43.954237Z"
- id: "TSK-0006"
title: "Integrar execuções de agentes e coordenação de EPICs"
description: "Persistir RUNs e seus dados operacionais mínimos, idempotência de\
\ requestId, referências aplicadas e diagnóstico. Integrar PlanCoordinator/EpicCoordinator,\
\ políticas e proveniência de conclusão, representando recibos internos como dados\
\ estruturados quando aplicável. Preservar a fronteira do adaptador: propostas\
\ não aprovam DEC, não respondem pelo humano nem executam comandos de repositó\
rio."
acceptanceCriteria:
- "Repetição idempotente de uma solicitação concluída não duplica registros; solicitaç\
ões divergentes e estados interrompidos são diagnosticados."
- "Políticas RESULTS/DECOMPOSITION, delegação, reabertura, propagação e conclusã\
o por Plans preservam autoridade e proveniência."
- "Resultados estruturados necessários permanecem; transporte bruto, ambiente e\
\ logs completos não viram acervo permanente no banco."
dependsOn:
- "TSK-0005"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:52:50.899228Z"
- id: "TSK-0007"
title: "Integrar gates do projeto e adicionais por Work"
description: "Representar gates obrigatórios do projeto e complementos do Work e\
\ conectar seus resultados aos checks e à entrega. Preservar avaliação externa\
\ e condições de qualidade, inclusive anexos exigidos. Registrar identificaçã\
o, procedimento/execução, estado avaliado, momento e resultado mínimo. Alteraç\
ões pertinentes invalidam a aplicação do resultado aos gates afetados; aprovaç\
ão humana não equivale a sucesso técnico."
acceptanceCriteria:
- "Gate obrigatório pendente, falho ou não executado bloqueia a entrega; gates adicionais\
\ do Work são considerados sem dispensar obrigatórios do projeto."
- "Resultados correspondem ao estado realmente avaliado e não satisfazem silenciosamente\
\ um gate após mudança relevante."
- "Checks existentes e anexos necessários continuam exigidos durante avaliação,\
\ sem introduzir executor autônomo ou retenção bruta obrigatória."
dependsOn:
- "TSK-0005"
- "TSK-0006"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:52:58.285586Z"
- id: "TSK-0008"
title: "Implementar anexos temporários e descarte após checks"
description: "Definir ciclo de vida de anexos e arquivos de execução no filesystem.\
\ Publicar arquivos completos, validar e registrar resultados mínimos antes do\
\ descarte; limpar elegíveis ao fim da execução. Proteger anexos ainda usados\
\ por checks pendentes e outputs solicitados. Recuperar falhas entre publicaçã\
o de arquivo, transação no banco e limpeza, distinguindo descarte legítimo de\
\ perda prematura. Não descartar artefatos legados deste workspace."
acceptanceCriteria:
- "Arquivos exigidos permanecem acessíveis até todos os checks dependentes terminarem,\
\ com resultado persistido antes da remoção."
- "Descarte automático preserva outputs solicitados e memória histórica; arquivo\
\ perdido antes da avaliação continua causando falha."
- "Interrupções nos pontos de publicação, registro e limpeza não fabricam sucesso\
\ e permitem recuperação sem remoção de entradas ainda necessárias."
dependsOn:
- "TSK-0007"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:05.800970Z"
- id: "TSK-0009"
title: "Adaptar verificação, status e contexto ao SQLite"
description: "Integrar VerificationService, CompatibilityService e projeções da\
\ CLI ao backend. Montar status, next-actions, context e readiness com consultas\
\ necessárias e resultados reutilizados na invocação; preservar contrato público\
\ quando compatível e informar mudanças. Separar resultado histórico com anexo\
\ descartado legitimamente de validação ativa. Manter diagnóstico de reparo e\
\ ausência de transições de estado em consultas."
acceptanceCriteria:
- "Consultas e contexto em processos novos preservam informações e autoridade e\
\ não promovem, migram ou concluem registros por leitura."
- "Anexos descartados legitimamente não invalidam histórico; corrupção e referê\
ncias ausentes não são tratadas como gates satisfeitos."
- "Caminhos selecionados não repetem varreduras/validações globais sem necessidade;\
\ saída e códigos de erro compatíveis são verificados."
dependsOn:
- "TSK-0004"
- "TSK-0005"
- "TSK-0006"
- "TSK-0008"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:13.390096Z"
- id: "TSK-0010"
title: "Implementar migração explícita e recuperável do legado"
description: "Criar comando público de prévia e aplicação da migração, sem conversã\
o em leituras ou atualização do instalador. Usar base de preparo e cópia de seguranç\
a da conversão, importação tipada transacional e verificação contra o corpus.\
\ Preservar IDs, conteúdo, aprovações, hashes, revisões e proveniência histórica\
\ sem despejar arquivos no banco. Ativar somente após sucesso; repetir ou recuperar\
\ interrupção sem duplicar. Executar apenas em fixtures/cópias descartáveis."
acceptanceCriteria:
- "Prévia não modifica o projeto; aplicação compara registros/contexto e ativa a\
\ base somente após validação completa."
- "Fixtures históricas, recibos, aprovações e referências preservam identidade/proveniê\
ncia; execução repetida não duplica conteúdo."
- "Falhas e interrupções deixam a fonte anterior recuperável e informam próxima\
\ ação; nenhum projeto real ou workspace canônico foi migrado."
dependsOn:
- "TSK-0001"
- "TSK-0009"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:21.074969Z"
- id: "TSK-0011"
title: "Atualizar init, descoberta e contrato de compatibilidade"
description: "Inicializar projetos locais em SQLite e deixar .ai-engineering ignorado\
\ pelo Git por padrão sem exigir Git. Preservar regras preexistentes e instruç\
ões fora do bloco gerido. Declarar backend e versões no contrato público, atualizar\
\ diagnóstico/onboard e evitar que base SQLite seja interpretada como workspace\
\ vazio por combinação incompatível. Manter tratamento explícito de projetos legados\
\ e previamente rastreados."
acceptanceCriteria:
- "Init cria projeto funcional sem Git, com estado local ignorado por padrão e bootstrap\
\ suficiente para humanos e agentes."
- "Reexecução preserva conteúdo/regras; não remove arquivos já rastreados nem converte\
\ legado automaticamente."
- "Versões e backend incompatíveis são recusados com diagnóstico acionável antes\
\ de escrita; documentação/entrypoints não induzem uso de CLI incompatível."
dependsOn:
- "TSK-0009"
- "TSK-0010"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:28.841960Z"
- id: "TSK-0012"
title: "Preparar pacote nativo e instalador conjunto sem ativação"
description: "Evoluir build/distribuição e scripts/install-native.sh para empacotar\
\ AIE nativo, biblioteca SQLite do driver e CLI sqlite3 num diretório configurá\
vel, com atalhos aie/ai-engineering e dados de projeto separados. Fixar componentes/plataformas\
\ e verificar pacote antes de ativação, preservando versão anterior em falhas.\
\ Testar instalador com ferramentas simuladas e destinos descartáveis; smoke usa\
\ build local. Não executar instalação real nem tocar ~/.local/bin ou dependê\
ncias ativas."
acceptanceCriteria:
- "Pacote contém componentes corretos e o build nativo acessa uma base descartá\
vel sem depender da instalação global."
- "Fixtures verificam diretórios configuráveis, atalhos, atualização conjunta e\
\ falha sem danificar instalação anterior simulada."
- "Nenhum binário, biblioteca ou atalho ativo é substituído e o instalador real\
\ não é executado; a ativação posterior continua dependente de instrução humana."
dependsOn:
- "TSK-0002"
- "TSK-0011"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:37.290314Z"
- id: "TSK-0013"
title: "Consolidar documentação e instruções do framework local"
description: "Atualizar README, docs de arquitetura/protocolo/compatibilidade/migraç\
ão e recursos de entrada para memória local, SQLite, gates e retenção mínima.\
\ Explicar anexos temporários, outputs entregues, migração explícita e recuperaç\
ão, pacote preparado e instalação adiada. Remover instruções que apresentem arquivos\
\ de Works como fonte principal nova ou Git como exigência. Preservar orientaç\
ões dos dois ciclos, OODA, DEC/Plan e aprovações."
acceptanceCriteria:
- "Documentação e recursos distribuídos descrevem o mesmo contrato e permitem inicializar/retomar\
\ um projeto sem Git."
- "Procedimento público de migração explica prévia, efeitos e recuperação sem depender\
\ de inspeção do código interno."
- "Limites de retenção e instalação, papel dos gates e recortes futuros estão claros;\
\ fontes e exemplos não alegam testes ou migrações reais não executados."
dependsOn:
- "TSK-0010"
- "TSK-0011"
- "TSK-0012"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:45.331995Z"
- id: "TSK-0014"
title: "Executar regressão integrada e encaminhar responsividade ao WRK-000C"
description: "Integrar as verificações das etapas e executar gates apropriados de\
\ testes/arquitetura, migração, concorrência e smoke JVM/nativo em ambientes descartá\
veis. Revisar continuidade e autoridade nos dois ciclos, anexos temporários, recuperaç\
ão e funcionamento sem Git. Consolidar resultados mínimos, resolver experimentos/preocupaç\
ões e entregar cenário reproduzível ao WRK-000C com comandos, versão, dados e\
\ ambiente. Não instalar o pacote nem declarar resolvido o atraso."
acceptanceCriteria:
- "Suíte relevante de domínio/integração/compatibilidade, fixtures do instalador\
\ e smoke nativo passam ou impedimentos são tratados antes da conclusão."
- "Falhas, rollback, concorrência, legado, gates e descarte legítimo foram verificados\
\ com resultados reais e sem alteração da instalação ativa ou consumidores."
- "Todos os steps e critérios da DEC estão satisfeitos, sem experimentos/preocupaç\
ões pendentes; WRK-000C recebe cenário para medição futura e permanece aberto."
dependsOn:
- "TSK-0013"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:53.421052Z"
status: "ACTIVE"
author: "Codex"
createdAt: "2026-11-22T11:52:06.993736Z"
revision: 17
previousHash: "2eb7f7137f0686ea862b03d2c7c88592b22ce415e3fd021fd4ed800c5db04447"
updatedAt: "2026-11-22T11:57:06.380736Z"
updatedBy: "Codex"
changeReason: "Iniciar inventário do contrato, relações e corpus de compatibilidade;\
\ executar somente inspeções e testes em dados descartáveis."
documentVersion: 2
---
# Implementar memória de engenharia local em SQLite
## Autoridade e objetivo
Executar a DEC-0001 do WRK-000D, aceita explicitamente por Nilton nesta conversa.
O resultado é um framework local de memória de engenharia por Work, com SQLite
por projeto, investigação e implementação orientadas por OODA, gates preservados,
anexos temporários e retenção mínima. A aprovação desta DEC mantém a instalação
real adiada.
Este Plan foi solicitado com decomposição em vários steps. Todos os steps começam
OPEN; a criação do Plan não constitui execução ou comprovação de resultado.
## Limites obrigatórios
- Não instalar nem substituir o AIE, SQLite, bibliotecas ou atalhos em uso.
- Não executar o instalador real contra HOME, ~/.local/bin ou outro destino ativo.
Sua validação usa fixtures com ferramentas simuladas e destinos descartáveis.
- Não migrar este workspace canônico ou projetos consumidores. Exercitar o novo
backend e a migração em fixtures e cópias descartáveis; ativação real depende de
instrução humana posterior específica.
- Preservar alterações preexistentes, IDs, conteúdo e proveniência legada,
aprovações, evidências históricas e instruções do projeto fora do bloco gerido.
- Não introduzir arquivos em BLOB/base64 ou TEXT equivalente, retenção extensa,
executor autônomo de repositório, colaboração distribuída ou integração Git LFS.
- Importação/exportação de Works/DECs e backup como funcionalidade ficam fora.
A cópia de segurança da migração é parte da recuperação da conversão.
- Código e outputs solicitados permanecem nos destinos de entrega apropriados.
- O WRK-000C permanece aberto para avaliar e tratar latência após esta mudança.
## Execução e dependências
Os 14 steps possuem dependências explícitas e critérios próprios. Mapear primeiro
o contrato e o legado; provar a integração SQLite/JVM/Native Image; depois construir
as transações e migrar os fluxos de domínio. Integrar gates e ciclo dos anexos antes
de consolidar as consultas, a migração pública e o bootstrap. Preparar distribuição
e documentação e concluir com regressão integrada e encaminhamento ao WRK-000C.
Não iniciar um step com dependências pendentes. Verificações focadas fazem parte
de cada mudança; a última etapa integra os cenários e não substitui essas verificações.
Steps independentes podem ser executados em ordem compatível, sem presumir
autorização de delegação ou de instalação real.
## OODA e incertezas
Nas provas relevantes, principalmente driver/nativo, migração e descarte de anexos,
registrar hipótese, critério de sucesso e invocação antes de executar. Registrar
observação, interpretação e próxima ação após o resultado; reconsiderar antes de
repetir uma hipótese falha. Usar os registros de experimentos do Plan quando úteis,
sem impor um ritual de quatro fases a toda alteração.
Ajustar esquema, índices, transações e build dentro da DEC. Se um resultado
questionar a decisão, registrar a preocupação, continuar investigações autorizadas
e rever a DEC com aprovação aplicável antes da execução afetada.
## Verificação e registro mínimo
Durante a execução deste Work, respeitar o protocolo que está em uso. Registrar
resultados reais e evidência mínima necessária para completar os steps; não usar
a futura política de limpeza para apagar evidências legadas ou simular gates.
Verificar continuidade entre processos, integridade referencial, rollback,
concorrência local com espera limitada, autoridade humana, gates e anexos
temporários, migração repetível e operação sem Git. Provas nativas usam somente
artefatos de build e projetos descartáveis.
Comandos candidatos à validação, ajustados ao resultado e ao código final:
- `./gradlew test` e `./gradlew check` para a suíte e arquitetura do projeto.
- `python3 scripts/test-install-native.py` para fixtures do instalador.
- `./gradlew nativeCompile` e tarefas de distribuição para construir o pacote.
- `bash scripts/native-smoke.sh <caminho-absoluto-do-build>` em projetos descartáveis.
Esses comandos são planejados, não executados na criação do Plan. Preservar os
gates específicos do projeto e adicionais do Work definidos na execução. Logs de
trabalho podem ser temporários; guardar na memória somente o necessário ao contrato.
## Conclusão
Todos os steps obrigatórios devem satisfazer seus critérios, com a DEC aceita e
sem experimentos ou preocupações pendentes. A entrega é código, documentação,
pacote preparado e resultados de verificação. Não depende de instalar a nova
versão no ambiente em uso. Encaminhar ao WRK-000C um cenário reproduzível com
comandos, versão, volume e ambiente, sem declarar resolvido o problema de atraso.
@@ -0,0 +1,412 @@
---
schemaVersion: 1
id: "PLN-0001"
workId: "WRK-000D"
title: "Implementar memória de engenharia local em SQLite sem instalação ativa"
decisions:
- "DEC-0001"
steps:
- id: "TSK-0001"
title: "Mapear contrato, dados legados e cenários de migração"
description: "Inspecionar WorkService, serviços de Discussion/Decision/Plan/Agent,\
\ coordenadores e VerificationService. Mapear registros, referências, revisões,\
\ hashes, recibos e bootstrap para tabelas e regras do backend SQLite, preservando\
\ conteúdo e autoridade. Selecionar fixtures existentes de compatibilidade, workflows\
\ e importação como corpus; usar apenas cópias descartáveis. Identificar checks\
\ e pontos de retenção sem realizar benchmark conclusivo do WRK-000C."
acceptanceCriteria:
- "Mapeamento cobre entidades persistidas, IDs locais ao Work, referências, revisõ\
es, aprovações e casos de conclusão legada com hashes/recibos."
- "Corpus representativo e resultados esperados de continuidade/migração estão definidos\
\ antes da conversão, incluindo dados inválidos e estados interrompidos."
- "Limites de instalação, migração de consumidores e preservação do workspace atual\
\ estão explícitos e respeitados."
dependsOn: []
status: "COMPLETED"
result: "Contrato e legado mapeados em docs/sqlite-migration-design.md; corpus e\
\ casos de falha/retry definidos antes da migração. Baseline: 45 testes em seis\
\ classes passaram, hashes congelados conferidos e fontes históricas intactas.\
\ Sem instalação ou migração real."
evidence:
- "ART-0001"
updatedAt: "2026-11-22T12:00:26.700050Z"
- id: "TSK-0002"
title: "Provar driver SQLite em JVM e Native Image"
description: "Avaliar Xerial SQLite JDBC e fixar versão compatível com Java, Gradle\
\ e GraalVM do projeto. Registrar hipótese, critério e invocação antes da prova.\
\ Criar, gravar, ler e reabrir uma base descartável em processos JVM e nativos.\
\ Verificar carregamento da biblioteca distribuída ao lado do nativo; sqlite3\
\ será ferramenta de diagnóstico do pacote. Construir e executar somente artefatos\
\ descartáveis, sem instalação real."
acceptanceCriteria:
- "Driver e versão selecionados demonstram persistência e reabertura em JVM e Native\
\ Image na plataforma alvo."
- "Biblioteca do pacote é encontrada por caminho controlado e não depende acidentalmente\
\ do SQLite global ou de extração repetida não planejada."
- "Hipótese, resultado e limitações da prova estão registrados; instalação ativa\
\ e projetos consumidores não foram alterados."
dependsOn:
- "TSK-0001"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:52:22.768410Z"
- id: "TSK-0003"
title: "Implementar esquema, conexões e transações SQLite"
description: "Criar infraestrutura de persistência local em .ai-engineering/aie.db\
\ com esquema versionado, tabelas tipadas, índices e relações. Habilitar integridade\
\ referencial em cada conexão, delimitar unidade transacional por operação coerente\
\ e usar leitura consistente. Definir journal/durabilidade e espera limitada de\
\ escrita com diagnóstico. Preservar limites de módulos; serviços aninhados devem\
\ compartilhar a transação aplicável."
acceptanceCriteria:
- "Esquema e índices atendem ao mapeamento sem BLOB/base64 ou arquivos completos\
\ serializados em TEXT."
- "Falha em operação relacionada causa rollback; referências inválidas são recusadas\
\ e gravações concorrentes têm contenção limitada e diagnóstico útil."
- "Abertura de esquema incompatível é diagnosticada sem alterar dados; teste de\
\ leitura consistente cobre mudanças concorrentes locais."
dependsOn:
- "TSK-0001"
- "TSK-0002"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:52:29.986202Z"
- id: "TSK-0004"
title: "Persistir Works e investigação no novo backend"
description: "Integrar Work, guidance e histórico de escolhas, discussões, tópicos,\
\ surveys, respostas e disposições à unidade de persistência. Preservar IDs existentes,\
\ semântica dos IDs locais, referências e histórico útil. Consultas selecionadas\
\ devem buscar o Work diretamente. Manter leitura legada delimitada para compatibilidade\
\ e migração; não manter duas fontes autoritativas para a mesma memória."
acceptanceCriteria:
- "Criar e retomar Work/discussão/survey em outro processo preserva conteúdo, histó\
rico de respostas e pendências."
- "Escolhas DIRECT/EXPLORATORY e autoridade humana mantêm as regras existentes,\
\ inclusive ausência de escolha e pedido específico de DEC."
- "Busca por Work e suas referências usa consultas com escopo adequado; alteraçõ\
es e referências relacionadas são transacionais."
dependsOn:
- "TSK-0003"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:52:37.091047Z"
- id: "TSK-0005"
title: "Persistir decisões, planos e experimentos"
description: "Integrar DecisionService e PlanService com revisões, aceitação, supersessã\
o, passos, dependências e experimentos. Preservar os dois ciclos e OODA, a autoridade\
\ de DEC/Plan e a distinção entre aprovação humana e promoção permitida por polí\
tica. Tratar operações que alteram registros relacionados em uma transação, sem\
\ reduzir os checks de domínio."
acceptanceCriteria:
- "Aprovação, revisão e supersessão preservam autoria e referências, sem fabricaç\
ão de aprovação ou edição silenciosa de decisão aceita."
- "Dependências e estados de passos, critérios de experimentos, preocupações com\
\ DEC e replanejamento conservam os bloqueios existentes."
- "Interrupção simulada não publica meia supersessão ou promoção parcial; retomada\
\ em outro processo preserva o contexto."
dependsOn:
- "TSK-0004"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:52:43.954237Z"
- id: "TSK-0006"
title: "Integrar execuções de agentes e coordenação de EPICs"
description: "Persistir RUNs e seus dados operacionais mínimos, idempotência de\
\ requestId, referências aplicadas e diagnóstico. Integrar PlanCoordinator/EpicCoordinator,\
\ políticas e proveniência de conclusão, representando recibos internos como dados\
\ estruturados quando aplicável. Preservar a fronteira do adaptador: propostas\
\ não aprovam DEC, não respondem pelo humano nem executam comandos de repositó\
rio."
acceptanceCriteria:
- "Repetição idempotente de uma solicitação concluída não duplica registros; solicitaç\
ões divergentes e estados interrompidos são diagnosticados."
- "Políticas RESULTS/DECOMPOSITION, delegação, reabertura, propagação e conclusã\
o por Plans preservam autoridade e proveniência."
- "Resultados estruturados necessários permanecem; transporte bruto, ambiente e\
\ logs completos não viram acervo permanente no banco."
dependsOn:
- "TSK-0005"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:52:50.899228Z"
- id: "TSK-0007"
title: "Integrar gates do projeto e adicionais por Work"
description: "Representar gates obrigatórios do projeto e complementos do Work e\
\ conectar seus resultados aos checks e à entrega. Preservar avaliação externa\
\ e condições de qualidade, inclusive anexos exigidos. Registrar identificaçã\
o, procedimento/execução, estado avaliado, momento e resultado mínimo. Alteraç\
ões pertinentes invalidam a aplicação do resultado aos gates afetados; aprovaç\
ão humana não equivale a sucesso técnico."
acceptanceCriteria:
- "Gate obrigatório pendente, falho ou não executado bloqueia a entrega; gates adicionais\
\ do Work são considerados sem dispensar obrigatórios do projeto."
- "Resultados correspondem ao estado realmente avaliado e não satisfazem silenciosamente\
\ um gate após mudança relevante."
- "Checks existentes e anexos necessários continuam exigidos durante avaliação,\
\ sem introduzir executor autônomo ou retenção bruta obrigatória."
dependsOn:
- "TSK-0005"
- "TSK-0006"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:52:58.285586Z"
- id: "TSK-0008"
title: "Implementar anexos temporários e descarte após checks"
description: "Definir ciclo de vida de anexos e arquivos de execução no filesystem.\
\ Publicar arquivos completos, validar e registrar resultados mínimos antes do\
\ descarte; limpar elegíveis ao fim da execução. Proteger anexos ainda usados\
\ por checks pendentes e outputs solicitados. Recuperar falhas entre publicaçã\
o de arquivo, transação no banco e limpeza, distinguindo descarte legítimo de\
\ perda prematura. Não descartar artefatos legados deste workspace."
acceptanceCriteria:
- "Arquivos exigidos permanecem acessíveis até todos os checks dependentes terminarem,\
\ com resultado persistido antes da remoção."
- "Descarte automático preserva outputs solicitados e memória histórica; arquivo\
\ perdido antes da avaliação continua causando falha."
- "Interrupções nos pontos de publicação, registro e limpeza não fabricam sucesso\
\ e permitem recuperação sem remoção de entradas ainda necessárias."
dependsOn:
- "TSK-0007"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:05.800970Z"
- id: "TSK-0009"
title: "Adaptar verificação, status e contexto ao SQLite"
description: "Integrar VerificationService, CompatibilityService e projeções da\
\ CLI ao backend. Montar status, next-actions, context e readiness com consultas\
\ necessárias e resultados reutilizados na invocação; preservar contrato público\
\ quando compatível e informar mudanças. Separar resultado histórico com anexo\
\ descartado legitimamente de validação ativa. Manter diagnóstico de reparo e\
\ ausência de transições de estado em consultas."
acceptanceCriteria:
- "Consultas e contexto em processos novos preservam informações e autoridade e\
\ não promovem, migram ou concluem registros por leitura."
- "Anexos descartados legitimamente não invalidam histórico; corrupção e referê\
ncias ausentes não são tratadas como gates satisfeitos."
- "Caminhos selecionados não repetem varreduras/validações globais sem necessidade;\
\ saída e códigos de erro compatíveis são verificados."
dependsOn:
- "TSK-0004"
- "TSK-0005"
- "TSK-0006"
- "TSK-0008"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:13.390096Z"
- id: "TSK-0010"
title: "Implementar migração explícita e recuperável do legado"
description: "Criar comando público de prévia e aplicação da migração, sem conversã\
o em leituras ou atualização do instalador. Usar base de preparo e cópia de seguranç\
a da conversão, importação tipada transacional e verificação contra o corpus.\
\ Preservar IDs, conteúdo, aprovações, hashes, revisões e proveniência histórica\
\ sem despejar arquivos no banco. Ativar somente após sucesso; repetir ou recuperar\
\ interrupção sem duplicar. Executar apenas em fixtures/cópias descartáveis."
acceptanceCriteria:
- "Prévia não modifica o projeto; aplicação compara registros/contexto e ativa a\
\ base somente após validação completa."
- "Fixtures históricas, recibos, aprovações e referências preservam identidade/proveniê\
ncia; execução repetida não duplica conteúdo."
- "Falhas e interrupções deixam a fonte anterior recuperável e informam próxima\
\ ação; nenhum projeto real ou workspace canônico foi migrado."
dependsOn:
- "TSK-0001"
- "TSK-0009"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:21.074969Z"
- id: "TSK-0011"
title: "Atualizar init, descoberta e contrato de compatibilidade"
description: "Inicializar projetos locais em SQLite e deixar .ai-engineering ignorado\
\ pelo Git por padrão sem exigir Git. Preservar regras preexistentes e instruç\
ões fora do bloco gerido. Declarar backend e versões no contrato público, atualizar\
\ diagnóstico/onboard e evitar que base SQLite seja interpretada como workspace\
\ vazio por combinação incompatível. Manter tratamento explícito de projetos legados\
\ e previamente rastreados."
acceptanceCriteria:
- "Init cria projeto funcional sem Git, com estado local ignorado por padrão e bootstrap\
\ suficiente para humanos e agentes."
- "Reexecução preserva conteúdo/regras; não remove arquivos já rastreados nem converte\
\ legado automaticamente."
- "Versões e backend incompatíveis são recusados com diagnóstico acionável antes\
\ de escrita; documentação/entrypoints não induzem uso de CLI incompatível."
dependsOn:
- "TSK-0009"
- "TSK-0010"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:28.841960Z"
- id: "TSK-0012"
title: "Preparar pacote nativo e instalador conjunto sem ativação"
description: "Evoluir build/distribuição e scripts/install-native.sh para empacotar\
\ AIE nativo, biblioteca SQLite do driver e CLI sqlite3 num diretório configurá\
vel, com atalhos aie/ai-engineering e dados de projeto separados. Fixar componentes/plataformas\
\ e verificar pacote antes de ativação, preservando versão anterior em falhas.\
\ Testar instalador com ferramentas simuladas e destinos descartáveis; smoke usa\
\ build local. Não executar instalação real nem tocar ~/.local/bin ou dependê\
ncias ativas."
acceptanceCriteria:
- "Pacote contém componentes corretos e o build nativo acessa uma base descartá\
vel sem depender da instalação global."
- "Fixtures verificam diretórios configuráveis, atalhos, atualização conjunta e\
\ falha sem danificar instalação anterior simulada."
- "Nenhum binário, biblioteca ou atalho ativo é substituído e o instalador real\
\ não é executado; a ativação posterior continua dependente de instrução humana."
dependsOn:
- "TSK-0002"
- "TSK-0011"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:37.290314Z"
- id: "TSK-0013"
title: "Consolidar documentação e instruções do framework local"
description: "Atualizar README, docs de arquitetura/protocolo/compatibilidade/migraç\
ão e recursos de entrada para memória local, SQLite, gates e retenção mínima.\
\ Explicar anexos temporários, outputs entregues, migração explícita e recuperaç\
ão, pacote preparado e instalação adiada. Remover instruções que apresentem arquivos\
\ de Works como fonte principal nova ou Git como exigência. Preservar orientaç\
ões dos dois ciclos, OODA, DEC/Plan e aprovações."
acceptanceCriteria:
- "Documentação e recursos distribuídos descrevem o mesmo contrato e permitem inicializar/retomar\
\ um projeto sem Git."
- "Procedimento público de migração explica prévia, efeitos e recuperação sem depender\
\ de inspeção do código interno."
- "Limites de retenção e instalação, papel dos gates e recortes futuros estão claros;\
\ fontes e exemplos não alegam testes ou migrações reais não executados."
dependsOn:
- "TSK-0010"
- "TSK-0011"
- "TSK-0012"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:45.331995Z"
- id: "TSK-0014"
title: "Executar regressão integrada e encaminhar responsividade ao WRK-000C"
description: "Integrar as verificações das etapas e executar gates apropriados de\
\ testes/arquitetura, migração, concorrência e smoke JVM/nativo em ambientes descartá\
veis. Revisar continuidade e autoridade nos dois ciclos, anexos temporários, recuperaç\
ão e funcionamento sem Git. Consolidar resultados mínimos, resolver experimentos/preocupaç\
ões e entregar cenário reproduzível ao WRK-000C com comandos, versão, dados e\
\ ambiente. Não instalar o pacote nem declarar resolvido o atraso."
acceptanceCriteria:
- "Suíte relevante de domínio/integração/compatibilidade, fixtures do instalador\
\ e smoke nativo passam ou impedimentos são tratados antes da conclusão."
- "Falhas, rollback, concorrência, legado, gates e descarte legítimo foram verificados\
\ com resultados reais e sem alteração da instalação ativa ou consumidores."
- "Todos os steps e critérios da DEC estão satisfeitos, sem experimentos/preocupaç\
ões pendentes; WRK-000C recebe cenário para medição futura e permanece aberto."
dependsOn:
- "TSK-0013"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:53.421052Z"
status: "ACTIVE"
author: "Codex"
createdAt: "2026-11-22T11:52:06.993736Z"
revision: 18
previousHash: "dfb8546ea0ce546e036d526c18e04e34394e02d0ca11de4114b7cb20917d4a61"
updatedAt: "2026-11-22T12:00:26.700211Z"
updatedBy: "Codex"
changeReason: "Contrato e legado mapeados em docs/sqlite-migration-design.md; corpus\
\ e casos de falha/retry definidos antes da migração. Baseline: 45 testes em seis\
\ classes passaram, hashes congelados conferidos e fontes históricas intactas. Sem\
\ instalação ou migração real."
documentVersion: 2
---
# Implementar memória de engenharia local em SQLite
## Autoridade e objetivo
Executar a DEC-0001 do WRK-000D, aceita explicitamente por Nilton nesta conversa.
O resultado é um framework local de memória de engenharia por Work, com SQLite
por projeto, investigação e implementação orientadas por OODA, gates preservados,
anexos temporários e retenção mínima. A aprovação desta DEC mantém a instalação
real adiada.
Este Plan foi solicitado com decomposição em vários steps. Todos os steps começam
OPEN; a criação do Plan não constitui execução ou comprovação de resultado.
## Limites obrigatórios
- Não instalar nem substituir o AIE, SQLite, bibliotecas ou atalhos em uso.
- Não executar o instalador real contra HOME, ~/.local/bin ou outro destino ativo.
Sua validação usa fixtures com ferramentas simuladas e destinos descartáveis.
- Não migrar este workspace canônico ou projetos consumidores. Exercitar o novo
backend e a migração em fixtures e cópias descartáveis; ativação real depende de
instrução humana posterior específica.
- Preservar alterações preexistentes, IDs, conteúdo e proveniência legada,
aprovações, evidências históricas e instruções do projeto fora do bloco gerido.
- Não introduzir arquivos em BLOB/base64 ou TEXT equivalente, retenção extensa,
executor autônomo de repositório, colaboração distribuída ou integração Git LFS.
- Importação/exportação de Works/DECs e backup como funcionalidade ficam fora.
A cópia de segurança da migração é parte da recuperação da conversão.
- Código e outputs solicitados permanecem nos destinos de entrega apropriados.
- O WRK-000C permanece aberto para avaliar e tratar latência após esta mudança.
## Execução e dependências
Os 14 steps possuem dependências explícitas e critérios próprios. Mapear primeiro
o contrato e o legado; provar a integração SQLite/JVM/Native Image; depois construir
as transações e migrar os fluxos de domínio. Integrar gates e ciclo dos anexos antes
de consolidar as consultas, a migração pública e o bootstrap. Preparar distribuição
e documentação e concluir com regressão integrada e encaminhamento ao WRK-000C.
Não iniciar um step com dependências pendentes. Verificações focadas fazem parte
de cada mudança; a última etapa integra os cenários e não substitui essas verificações.
Steps independentes podem ser executados em ordem compatível, sem presumir
autorização de delegação ou de instalação real.
## OODA e incertezas
Nas provas relevantes, principalmente driver/nativo, migração e descarte de anexos,
registrar hipótese, critério de sucesso e invocação antes de executar. Registrar
observação, interpretação e próxima ação após o resultado; reconsiderar antes de
repetir uma hipótese falha. Usar os registros de experimentos do Plan quando úteis,
sem impor um ritual de quatro fases a toda alteração.
Ajustar esquema, índices, transações e build dentro da DEC. Se um resultado
questionar a decisão, registrar a preocupação, continuar investigações autorizadas
e rever a DEC com aprovação aplicável antes da execução afetada.
## Verificação e registro mínimo
Durante a execução deste Work, respeitar o protocolo que está em uso. Registrar
resultados reais e evidência mínima necessária para completar os steps; não usar
a futura política de limpeza para apagar evidências legadas ou simular gates.
Verificar continuidade entre processos, integridade referencial, rollback,
concorrência local com espera limitada, autoridade humana, gates e anexos
temporários, migração repetível e operação sem Git. Provas nativas usam somente
artefatos de build e projetos descartáveis.
Comandos candidatos à validação, ajustados ao resultado e ao código final:
- `./gradlew test` e `./gradlew check` para a suíte e arquitetura do projeto.
- `python3 scripts/test-install-native.py` para fixtures do instalador.
- `./gradlew nativeCompile` e tarefas de distribuição para construir o pacote.
- `bash scripts/native-smoke.sh <caminho-absoluto-do-build>` em projetos descartáveis.
Esses comandos são planejados, não executados na criação do Plan. Preservar os
gates específicos do projeto e adicionais do Work definidos na execução. Logs de
trabalho podem ser temporários; guardar na memória somente o necessário ao contrato.
## Conclusão
Todos os steps obrigatórios devem satisfazer seus critérios, com a DEC aceita e
sem experimentos ou preocupações pendentes. A entrega é código, documentação,
pacote preparado e resultados de verificação. Não depende de instalar a nova
versão no ambiente em uso. Encaminhar ao WRK-000C um cenário reproduzível com
comandos, versão, volume e ambiente, sem declarar resolvido o problema de atraso.
@@ -0,0 +1,411 @@
---
schemaVersion: 1
id: "PLN-0001"
workId: "WRK-000D"
title: "Implementar memória de engenharia local em SQLite sem instalação ativa"
decisions:
- "DEC-0001"
steps:
- id: "TSK-0001"
title: "Mapear contrato, dados legados e cenários de migração"
description: "Inspecionar WorkService, serviços de Discussion/Decision/Plan/Agent,\
\ coordenadores e VerificationService. Mapear registros, referências, revisões,\
\ hashes, recibos e bootstrap para tabelas e regras do backend SQLite, preservando\
\ conteúdo e autoridade. Selecionar fixtures existentes de compatibilidade, workflows\
\ e importação como corpus; usar apenas cópias descartáveis. Identificar checks\
\ e pontos de retenção sem realizar benchmark conclusivo do WRK-000C."
acceptanceCriteria:
- "Mapeamento cobre entidades persistidas, IDs locais ao Work, referências, revisõ\
es, aprovações e casos de conclusão legada com hashes/recibos."
- "Corpus representativo e resultados esperados de continuidade/migração estão definidos\
\ antes da conversão, incluindo dados inválidos e estados interrompidos."
- "Limites de instalação, migração de consumidores e preservação do workspace atual\
\ estão explícitos e respeitados."
dependsOn: []
status: "COMPLETED"
result: "Contrato e legado mapeados em docs/sqlite-migration-design.md; corpus e\
\ casos de falha/retry definidos antes da migração. Baseline: 45 testes em seis\
\ classes passaram, hashes congelados conferidos e fontes históricas intactas.\
\ Sem instalação ou migração real."
evidence:
- "ART-0001"
updatedAt: "2026-11-22T12:00:26.700050Z"
- id: "TSK-0002"
title: "Provar driver SQLite em JVM e Native Image"
description: "Avaliar Xerial SQLite JDBC e fixar versão compatível com Java, Gradle\
\ e GraalVM do projeto. Registrar hipótese, critério e invocação antes da prova.\
\ Criar, gravar, ler e reabrir uma base descartável em processos JVM e nativos.\
\ Verificar carregamento da biblioteca distribuída ao lado do nativo; sqlite3\
\ será ferramenta de diagnóstico do pacote. Construir e executar somente artefatos\
\ descartáveis, sem instalação real."
acceptanceCriteria:
- "Driver e versão selecionados demonstram persistência e reabertura em JVM e Native\
\ Image na plataforma alvo."
- "Biblioteca do pacote é encontrada por caminho controlado e não depende acidentalmente\
\ do SQLite global ou de extração repetida não planejada."
- "Hipótese, resultado e limitações da prova estão registrados; instalação ativa\
\ e projetos consumidores não foram alterados."
dependsOn:
- "TSK-0001"
status: "ACTIVE"
result: "Prosseguir autonomamente conforme instrução de Nilton; provar driver em\
\ JVM e Native Image, somente em bases descartáveis e sem instalação."
evidence: []
updatedAt: "2026-11-22T12:09:51.453556Z"
- id: "TSK-0003"
title: "Implementar esquema, conexões e transações SQLite"
description: "Criar infraestrutura de persistência local em .ai-engineering/aie.db\
\ com esquema versionado, tabelas tipadas, índices e relações. Habilitar integridade\
\ referencial em cada conexão, delimitar unidade transacional por operação coerente\
\ e usar leitura consistente. Definir journal/durabilidade e espera limitada de\
\ escrita com diagnóstico. Preservar limites de módulos; serviços aninhados devem\
\ compartilhar a transação aplicável."
acceptanceCriteria:
- "Esquema e índices atendem ao mapeamento sem BLOB/base64 ou arquivos completos\
\ serializados em TEXT."
- "Falha em operação relacionada causa rollback; referências inválidas são recusadas\
\ e gravações concorrentes têm contenção limitada e diagnóstico útil."
- "Abertura de esquema incompatível é diagnosticada sem alterar dados; teste de\
\ leitura consistente cobre mudanças concorrentes locais."
dependsOn:
- "TSK-0001"
- "TSK-0002"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:52:29.986202Z"
- id: "TSK-0004"
title: "Persistir Works e investigação no novo backend"
description: "Integrar Work, guidance e histórico de escolhas, discussões, tópicos,\
\ surveys, respostas e disposições à unidade de persistência. Preservar IDs existentes,\
\ semântica dos IDs locais, referências e histórico útil. Consultas selecionadas\
\ devem buscar o Work diretamente. Manter leitura legada delimitada para compatibilidade\
\ e migração; não manter duas fontes autoritativas para a mesma memória."
acceptanceCriteria:
- "Criar e retomar Work/discussão/survey em outro processo preserva conteúdo, histó\
rico de respostas e pendências."
- "Escolhas DIRECT/EXPLORATORY e autoridade humana mantêm as regras existentes,\
\ inclusive ausência de escolha e pedido específico de DEC."
- "Busca por Work e suas referências usa consultas com escopo adequado; alteraçõ\
es e referências relacionadas são transacionais."
dependsOn:
- "TSK-0003"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:52:37.091047Z"
- id: "TSK-0005"
title: "Persistir decisões, planos e experimentos"
description: "Integrar DecisionService e PlanService com revisões, aceitação, supersessã\
o, passos, dependências e experimentos. Preservar os dois ciclos e OODA, a autoridade\
\ de DEC/Plan e a distinção entre aprovação humana e promoção permitida por polí\
tica. Tratar operações que alteram registros relacionados em uma transação, sem\
\ reduzir os checks de domínio."
acceptanceCriteria:
- "Aprovação, revisão e supersessão preservam autoria e referências, sem fabricaç\
ão de aprovação ou edição silenciosa de decisão aceita."
- "Dependências e estados de passos, critérios de experimentos, preocupações com\
\ DEC e replanejamento conservam os bloqueios existentes."
- "Interrupção simulada não publica meia supersessão ou promoção parcial; retomada\
\ em outro processo preserva o contexto."
dependsOn:
- "TSK-0004"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:52:43.954237Z"
- id: "TSK-0006"
title: "Integrar execuções de agentes e coordenação de EPICs"
description: "Persistir RUNs e seus dados operacionais mínimos, idempotência de\
\ requestId, referências aplicadas e diagnóstico. Integrar PlanCoordinator/EpicCoordinator,\
\ políticas e proveniência de conclusão, representando recibos internos como dados\
\ estruturados quando aplicável. Preservar a fronteira do adaptador: propostas\
\ não aprovam DEC, não respondem pelo humano nem executam comandos de repositó\
rio."
acceptanceCriteria:
- "Repetição idempotente de uma solicitação concluída não duplica registros; solicitaç\
ões divergentes e estados interrompidos são diagnosticados."
- "Políticas RESULTS/DECOMPOSITION, delegação, reabertura, propagação e conclusã\
o por Plans preservam autoridade e proveniência."
- "Resultados estruturados necessários permanecem; transporte bruto, ambiente e\
\ logs completos não viram acervo permanente no banco."
dependsOn:
- "TSK-0005"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:52:50.899228Z"
- id: "TSK-0007"
title: "Integrar gates do projeto e adicionais por Work"
description: "Representar gates obrigatórios do projeto e complementos do Work e\
\ conectar seus resultados aos checks e à entrega. Preservar avaliação externa\
\ e condições de qualidade, inclusive anexos exigidos. Registrar identificaçã\
o, procedimento/execução, estado avaliado, momento e resultado mínimo. Alteraç\
ões pertinentes invalidam a aplicação do resultado aos gates afetados; aprovaç\
ão humana não equivale a sucesso técnico."
acceptanceCriteria:
- "Gate obrigatório pendente, falho ou não executado bloqueia a entrega; gates adicionais\
\ do Work são considerados sem dispensar obrigatórios do projeto."
- "Resultados correspondem ao estado realmente avaliado e não satisfazem silenciosamente\
\ um gate após mudança relevante."
- "Checks existentes e anexos necessários continuam exigidos durante avaliação,\
\ sem introduzir executor autônomo ou retenção bruta obrigatória."
dependsOn:
- "TSK-0005"
- "TSK-0006"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:52:58.285586Z"
- id: "TSK-0008"
title: "Implementar anexos temporários e descarte após checks"
description: "Definir ciclo de vida de anexos e arquivos de execução no filesystem.\
\ Publicar arquivos completos, validar e registrar resultados mínimos antes do\
\ descarte; limpar elegíveis ao fim da execução. Proteger anexos ainda usados\
\ por checks pendentes e outputs solicitados. Recuperar falhas entre publicaçã\
o de arquivo, transação no banco e limpeza, distinguindo descarte legítimo de\
\ perda prematura. Não descartar artefatos legados deste workspace."
acceptanceCriteria:
- "Arquivos exigidos permanecem acessíveis até todos os checks dependentes terminarem,\
\ com resultado persistido antes da remoção."
- "Descarte automático preserva outputs solicitados e memória histórica; arquivo\
\ perdido antes da avaliação continua causando falha."
- "Interrupções nos pontos de publicação, registro e limpeza não fabricam sucesso\
\ e permitem recuperação sem remoção de entradas ainda necessárias."
dependsOn:
- "TSK-0007"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:05.800970Z"
- id: "TSK-0009"
title: "Adaptar verificação, status e contexto ao SQLite"
description: "Integrar VerificationService, CompatibilityService e projeções da\
\ CLI ao backend. Montar status, next-actions, context e readiness com consultas\
\ necessárias e resultados reutilizados na invocação; preservar contrato público\
\ quando compatível e informar mudanças. Separar resultado histórico com anexo\
\ descartado legitimamente de validação ativa. Manter diagnóstico de reparo e\
\ ausência de transições de estado em consultas."
acceptanceCriteria:
- "Consultas e contexto em processos novos preservam informações e autoridade e\
\ não promovem, migram ou concluem registros por leitura."
- "Anexos descartados legitimamente não invalidam histórico; corrupção e referê\
ncias ausentes não são tratadas como gates satisfeitos."
- "Caminhos selecionados não repetem varreduras/validações globais sem necessidade;\
\ saída e códigos de erro compatíveis são verificados."
dependsOn:
- "TSK-0004"
- "TSK-0005"
- "TSK-0006"
- "TSK-0008"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:13.390096Z"
- id: "TSK-0010"
title: "Implementar migração explícita e recuperável do legado"
description: "Criar comando público de prévia e aplicação da migração, sem conversã\
o em leituras ou atualização do instalador. Usar base de preparo e cópia de seguranç\
a da conversão, importação tipada transacional e verificação contra o corpus.\
\ Preservar IDs, conteúdo, aprovações, hashes, revisões e proveniência histórica\
\ sem despejar arquivos no banco. Ativar somente após sucesso; repetir ou recuperar\
\ interrupção sem duplicar. Executar apenas em fixtures/cópias descartáveis."
acceptanceCriteria:
- "Prévia não modifica o projeto; aplicação compara registros/contexto e ativa a\
\ base somente após validação completa."
- "Fixtures históricas, recibos, aprovações e referências preservam identidade/proveniê\
ncia; execução repetida não duplica conteúdo."
- "Falhas e interrupções deixam a fonte anterior recuperável e informam próxima\
\ ação; nenhum projeto real ou workspace canônico foi migrado."
dependsOn:
- "TSK-0001"
- "TSK-0009"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:21.074969Z"
- id: "TSK-0011"
title: "Atualizar init, descoberta e contrato de compatibilidade"
description: "Inicializar projetos locais em SQLite e deixar .ai-engineering ignorado\
\ pelo Git por padrão sem exigir Git. Preservar regras preexistentes e instruç\
ões fora do bloco gerido. Declarar backend e versões no contrato público, atualizar\
\ diagnóstico/onboard e evitar que base SQLite seja interpretada como workspace\
\ vazio por combinação incompatível. Manter tratamento explícito de projetos legados\
\ e previamente rastreados."
acceptanceCriteria:
- "Init cria projeto funcional sem Git, com estado local ignorado por padrão e bootstrap\
\ suficiente para humanos e agentes."
- "Reexecução preserva conteúdo/regras; não remove arquivos já rastreados nem converte\
\ legado automaticamente."
- "Versões e backend incompatíveis são recusados com diagnóstico acionável antes\
\ de escrita; documentação/entrypoints não induzem uso de CLI incompatível."
dependsOn:
- "TSK-0009"
- "TSK-0010"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:28.841960Z"
- id: "TSK-0012"
title: "Preparar pacote nativo e instalador conjunto sem ativação"
description: "Evoluir build/distribuição e scripts/install-native.sh para empacotar\
\ AIE nativo, biblioteca SQLite do driver e CLI sqlite3 num diretório configurá\
vel, com atalhos aie/ai-engineering e dados de projeto separados. Fixar componentes/plataformas\
\ e verificar pacote antes de ativação, preservando versão anterior em falhas.\
\ Testar instalador com ferramentas simuladas e destinos descartáveis; smoke usa\
\ build local. Não executar instalação real nem tocar ~/.local/bin ou dependê\
ncias ativas."
acceptanceCriteria:
- "Pacote contém componentes corretos e o build nativo acessa uma base descartá\
vel sem depender da instalação global."
- "Fixtures verificam diretórios configuráveis, atalhos, atualização conjunta e\
\ falha sem danificar instalação anterior simulada."
- "Nenhum binário, biblioteca ou atalho ativo é substituído e o instalador real\
\ não é executado; a ativação posterior continua dependente de instrução humana."
dependsOn:
- "TSK-0002"
- "TSK-0011"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:37.290314Z"
- id: "TSK-0013"
title: "Consolidar documentação e instruções do framework local"
description: "Atualizar README, docs de arquitetura/protocolo/compatibilidade/migraç\
ão e recursos de entrada para memória local, SQLite, gates e retenção mínima.\
\ Explicar anexos temporários, outputs entregues, migração explícita e recuperaç\
ão, pacote preparado e instalação adiada. Remover instruções que apresentem arquivos\
\ de Works como fonte principal nova ou Git como exigência. Preservar orientaç\
ões dos dois ciclos, OODA, DEC/Plan e aprovações."
acceptanceCriteria:
- "Documentação e recursos distribuídos descrevem o mesmo contrato e permitem inicializar/retomar\
\ um projeto sem Git."
- "Procedimento público de migração explica prévia, efeitos e recuperação sem depender\
\ de inspeção do código interno."
- "Limites de retenção e instalação, papel dos gates e recortes futuros estão claros;\
\ fontes e exemplos não alegam testes ou migrações reais não executados."
dependsOn:
- "TSK-0010"
- "TSK-0011"
- "TSK-0012"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:45.331995Z"
- id: "TSK-0014"
title: "Executar regressão integrada e encaminhar responsividade ao WRK-000C"
description: "Integrar as verificações das etapas e executar gates apropriados de\
\ testes/arquitetura, migração, concorrência e smoke JVM/nativo em ambientes descartá\
veis. Revisar continuidade e autoridade nos dois ciclos, anexos temporários, recuperaç\
ão e funcionamento sem Git. Consolidar resultados mínimos, resolver experimentos/preocupaç\
ões e entregar cenário reproduzível ao WRK-000C com comandos, versão, dados e\
\ ambiente. Não instalar o pacote nem declarar resolvido o atraso."
acceptanceCriteria:
- "Suíte relevante de domínio/integração/compatibilidade, fixtures do instalador\
\ e smoke nativo passam ou impedimentos são tratados antes da conclusão."
- "Falhas, rollback, concorrência, legado, gates e descarte legítimo foram verificados\
\ com resultados reais e sem alteração da instalação ativa ou consumidores."
- "Todos os steps e critérios da DEC estão satisfeitos, sem experimentos/preocupaç\
ões pendentes; WRK-000C recebe cenário para medição futura e permanece aberto."
dependsOn:
- "TSK-0013"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:53.421052Z"
status: "ACTIVE"
author: "Codex"
createdAt: "2026-11-22T11:52:06.993736Z"
revision: 19
previousHash: "024176b8c1377147b8bb96529bbafb271ad5a0a7d232fcd4ce390ee759c390fb"
updatedAt: "2026-11-22T12:09:51.453985Z"
updatedBy: "Codex"
changeReason: "Prosseguir autonomamente conforme instrução de Nilton; provar driver\
\ em JVM e Native Image, somente em bases descartáveis e sem instalação."
documentVersion: 2
---
# Implementar memória de engenharia local em SQLite
## Autoridade e objetivo
Executar a DEC-0001 do WRK-000D, aceita explicitamente por Nilton nesta conversa.
O resultado é um framework local de memória de engenharia por Work, com SQLite
por projeto, investigação e implementação orientadas por OODA, gates preservados,
anexos temporários e retenção mínima. A aprovação desta DEC mantém a instalação
real adiada.
Este Plan foi solicitado com decomposição em vários steps. Todos os steps começam
OPEN; a criação do Plan não constitui execução ou comprovação de resultado.
## Limites obrigatórios
- Não instalar nem substituir o AIE, SQLite, bibliotecas ou atalhos em uso.
- Não executar o instalador real contra HOME, ~/.local/bin ou outro destino ativo.
Sua validação usa fixtures com ferramentas simuladas e destinos descartáveis.
- Não migrar este workspace canônico ou projetos consumidores. Exercitar o novo
backend e a migração em fixtures e cópias descartáveis; ativação real depende de
instrução humana posterior específica.
- Preservar alterações preexistentes, IDs, conteúdo e proveniência legada,
aprovações, evidências históricas e instruções do projeto fora do bloco gerido.
- Não introduzir arquivos em BLOB/base64 ou TEXT equivalente, retenção extensa,
executor autônomo de repositório, colaboração distribuída ou integração Git LFS.
- Importação/exportação de Works/DECs e backup como funcionalidade ficam fora.
A cópia de segurança da migração é parte da recuperação da conversão.
- Código e outputs solicitados permanecem nos destinos de entrega apropriados.
- O WRK-000C permanece aberto para avaliar e tratar latência após esta mudança.
## Execução e dependências
Os 14 steps possuem dependências explícitas e critérios próprios. Mapear primeiro
o contrato e o legado; provar a integração SQLite/JVM/Native Image; depois construir
as transações e migrar os fluxos de domínio. Integrar gates e ciclo dos anexos antes
de consolidar as consultas, a migração pública e o bootstrap. Preparar distribuição
e documentação e concluir com regressão integrada e encaminhamento ao WRK-000C.
Não iniciar um step com dependências pendentes. Verificações focadas fazem parte
de cada mudança; a última etapa integra os cenários e não substitui essas verificações.
Steps independentes podem ser executados em ordem compatível, sem presumir
autorização de delegação ou de instalação real.
## OODA e incertezas
Nas provas relevantes, principalmente driver/nativo, migração e descarte de anexos,
registrar hipótese, critério de sucesso e invocação antes de executar. Registrar
observação, interpretação e próxima ação após o resultado; reconsiderar antes de
repetir uma hipótese falha. Usar os registros de experimentos do Plan quando úteis,
sem impor um ritual de quatro fases a toda alteração.
Ajustar esquema, índices, transações e build dentro da DEC. Se um resultado
questionar a decisão, registrar a preocupação, continuar investigações autorizadas
e rever a DEC com aprovação aplicável antes da execução afetada.
## Verificação e registro mínimo
Durante a execução deste Work, respeitar o protocolo que está em uso. Registrar
resultados reais e evidência mínima necessária para completar os steps; não usar
a futura política de limpeza para apagar evidências legadas ou simular gates.
Verificar continuidade entre processos, integridade referencial, rollback,
concorrência local com espera limitada, autoridade humana, gates e anexos
temporários, migração repetível e operação sem Git. Provas nativas usam somente
artefatos de build e projetos descartáveis.
Comandos candidatos à validação, ajustados ao resultado e ao código final:
- `./gradlew test` e `./gradlew check` para a suíte e arquitetura do projeto.
- `python3 scripts/test-install-native.py` para fixtures do instalador.
- `./gradlew nativeCompile` e tarefas de distribuição para construir o pacote.
- `bash scripts/native-smoke.sh <caminho-absoluto-do-build>` em projetos descartáveis.
Esses comandos são planejados, não executados na criação do Plan. Preservar os
gates específicos do projeto e adicionais do Work definidos na execução. Logs de
trabalho podem ser temporários; guardar na memória somente o necessário ao contrato.
## Conclusão
Todos os steps obrigatórios devem satisfazer seus critérios, com a DEC aceita e
sem experimentos ou preocupações pendentes. A entrega é código, documentação,
pacote preparado e resultados de verificação. Não depende de instalar a nova
versão no ambiente em uso. Encaminhar ao WRK-000C um cenário reproduzível com
comandos, versão, volume e ambiente, sem declarar resolvido o problema de atraso.
@@ -0,0 +1,434 @@
---
schemaVersion: 1
id: "PLN-0001"
workId: "WRK-000D"
title: "Implementar memória de engenharia local em SQLite sem instalação ativa"
decisions:
- "DEC-0001"
steps:
- id: "TSK-0001"
title: "Mapear contrato, dados legados e cenários de migração"
description: "Inspecionar WorkService, serviços de Discussion/Decision/Plan/Agent,\
\ coordenadores e VerificationService. Mapear registros, referências, revisões,\
\ hashes, recibos e bootstrap para tabelas e regras do backend SQLite, preservando\
\ conteúdo e autoridade. Selecionar fixtures existentes de compatibilidade, workflows\
\ e importação como corpus; usar apenas cópias descartáveis. Identificar checks\
\ e pontos de retenção sem realizar benchmark conclusivo do WRK-000C."
acceptanceCriteria:
- "Mapeamento cobre entidades persistidas, IDs locais ao Work, referências, revisõ\
es, aprovações e casos de conclusão legada com hashes/recibos."
- "Corpus representativo e resultados esperados de continuidade/migração estão definidos\
\ antes da conversão, incluindo dados inválidos e estados interrompidos."
- "Limites de instalação, migração de consumidores e preservação do workspace atual\
\ estão explícitos e respeitados."
dependsOn: []
status: "COMPLETED"
result: "Contrato e legado mapeados em docs/sqlite-migration-design.md; corpus e\
\ casos de falha/retry definidos antes da migração. Baseline: 45 testes em seis\
\ classes passaram, hashes congelados conferidos e fontes históricas intactas.\
\ Sem instalação ou migração real."
evidence:
- "ART-0001"
updatedAt: "2026-11-22T12:00:26.700050Z"
- id: "TSK-0002"
title: "Provar driver SQLite em JVM e Native Image"
description: "Avaliar Xerial SQLite JDBC e fixar versão compatível com Java, Gradle\
\ e GraalVM do projeto. Registrar hipótese, critério e invocação antes da prova.\
\ Criar, gravar, ler e reabrir uma base descartável em processos JVM e nativos.\
\ Verificar carregamento da biblioteca distribuída ao lado do nativo; sqlite3\
\ será ferramenta de diagnóstico do pacote. Construir e executar somente artefatos\
\ descartáveis, sem instalação real."
acceptanceCriteria:
- "Driver e versão selecionados demonstram persistência e reabertura em JVM e Native\
\ Image na plataforma alvo."
- "Biblioteca do pacote é encontrada por caminho controlado e não depende acidentalmente\
\ do SQLite global ou de extração repetida não planejada."
- "Hipótese, resultado e limitações da prova estão registrados; instalação ativa\
\ e projetos consumidores não foram alterados."
dependsOn:
- "TSK-0001"
status: "ACTIVE"
result: "Prosseguir autonomamente conforme instrução de Nilton; provar driver em\
\ JVM e Native Image, somente em bases descartáveis e sem instalação."
evidence: []
updatedAt: "2026-11-22T12:09:51.453556Z"
- id: "TSK-0003"
title: "Implementar esquema, conexões e transações SQLite"
description: "Criar infraestrutura de persistência local em .ai-engineering/aie.db\
\ com esquema versionado, tabelas tipadas, índices e relações. Habilitar integridade\
\ referencial em cada conexão, delimitar unidade transacional por operação coerente\
\ e usar leitura consistente. Definir journal/durabilidade e espera limitada de\
\ escrita com diagnóstico. Preservar limites de módulos; serviços aninhados devem\
\ compartilhar a transação aplicável."
acceptanceCriteria:
- "Esquema e índices atendem ao mapeamento sem BLOB/base64 ou arquivos completos\
\ serializados em TEXT."
- "Falha em operação relacionada causa rollback; referências inválidas são recusadas\
\ e gravações concorrentes têm contenção limitada e diagnóstico útil."
- "Abertura de esquema incompatível é diagnosticada sem alterar dados; teste de\
\ leitura consistente cobre mudanças concorrentes locais."
dependsOn:
- "TSK-0001"
- "TSK-0002"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:52:29.986202Z"
- id: "TSK-0004"
title: "Persistir Works e investigação no novo backend"
description: "Integrar Work, guidance e histórico de escolhas, discussões, tópicos,\
\ surveys, respostas e disposições à unidade de persistência. Preservar IDs existentes,\
\ semântica dos IDs locais, referências e histórico útil. Consultas selecionadas\
\ devem buscar o Work diretamente. Manter leitura legada delimitada para compatibilidade\
\ e migração; não manter duas fontes autoritativas para a mesma memória."
acceptanceCriteria:
- "Criar e retomar Work/discussão/survey em outro processo preserva conteúdo, histó\
rico de respostas e pendências."
- "Escolhas DIRECT/EXPLORATORY e autoridade humana mantêm as regras existentes,\
\ inclusive ausência de escolha e pedido específico de DEC."
- "Busca por Work e suas referências usa consultas com escopo adequado; alteraçõ\
es e referências relacionadas são transacionais."
dependsOn:
- "TSK-0003"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:52:37.091047Z"
- id: "TSK-0005"
title: "Persistir decisões, planos e experimentos"
description: "Integrar DecisionService e PlanService com revisões, aceitação, supersessã\
o, passos, dependências e experimentos. Preservar os dois ciclos e OODA, a autoridade\
\ de DEC/Plan e a distinção entre aprovação humana e promoção permitida por polí\
tica. Tratar operações que alteram registros relacionados em uma transação, sem\
\ reduzir os checks de domínio."
acceptanceCriteria:
- "Aprovação, revisão e supersessão preservam autoria e referências, sem fabricaç\
ão de aprovação ou edição silenciosa de decisão aceita."
- "Dependências e estados de passos, critérios de experimentos, preocupações com\
\ DEC e replanejamento conservam os bloqueios existentes."
- "Interrupção simulada não publica meia supersessão ou promoção parcial; retomada\
\ em outro processo preserva o contexto."
dependsOn:
- "TSK-0004"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:52:43.954237Z"
- id: "TSK-0006"
title: "Integrar execuções de agentes e coordenação de EPICs"
description: "Persistir RUNs e seus dados operacionais mínimos, idempotência de\
\ requestId, referências aplicadas e diagnóstico. Integrar PlanCoordinator/EpicCoordinator,\
\ políticas e proveniência de conclusão, representando recibos internos como dados\
\ estruturados quando aplicável. Preservar a fronteira do adaptador: propostas\
\ não aprovam DEC, não respondem pelo humano nem executam comandos de repositó\
rio."
acceptanceCriteria:
- "Repetição idempotente de uma solicitação concluída não duplica registros; solicitaç\
ões divergentes e estados interrompidos são diagnosticados."
- "Políticas RESULTS/DECOMPOSITION, delegação, reabertura, propagação e conclusã\
o por Plans preservam autoridade e proveniência."
- "Resultados estruturados necessários permanecem; transporte bruto, ambiente e\
\ logs completos não viram acervo permanente no banco."
dependsOn:
- "TSK-0005"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:52:50.899228Z"
- id: "TSK-0007"
title: "Integrar gates do projeto e adicionais por Work"
description: "Representar gates obrigatórios do projeto e complementos do Work e\
\ conectar seus resultados aos checks e à entrega. Preservar avaliação externa\
\ e condições de qualidade, inclusive anexos exigidos. Registrar identificaçã\
o, procedimento/execução, estado avaliado, momento e resultado mínimo. Alteraç\
ões pertinentes invalidam a aplicação do resultado aos gates afetados; aprovaç\
ão humana não equivale a sucesso técnico."
acceptanceCriteria:
- "Gate obrigatório pendente, falho ou não executado bloqueia a entrega; gates adicionais\
\ do Work são considerados sem dispensar obrigatórios do projeto."
- "Resultados correspondem ao estado realmente avaliado e não satisfazem silenciosamente\
\ um gate após mudança relevante."
- "Checks existentes e anexos necessários continuam exigidos durante avaliação,\
\ sem introduzir executor autônomo ou retenção bruta obrigatória."
dependsOn:
- "TSK-0005"
- "TSK-0006"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:52:58.285586Z"
- id: "TSK-0008"
title: "Implementar anexos temporários e descarte após checks"
description: "Definir ciclo de vida de anexos e arquivos de execução no filesystem.\
\ Publicar arquivos completos, validar e registrar resultados mínimos antes do\
\ descarte; limpar elegíveis ao fim da execução. Proteger anexos ainda usados\
\ por checks pendentes e outputs solicitados. Recuperar falhas entre publicaçã\
o de arquivo, transação no banco e limpeza, distinguindo descarte legítimo de\
\ perda prematura. Não descartar artefatos legados deste workspace."
acceptanceCriteria:
- "Arquivos exigidos permanecem acessíveis até todos os checks dependentes terminarem,\
\ com resultado persistido antes da remoção."
- "Descarte automático preserva outputs solicitados e memória histórica; arquivo\
\ perdido antes da avaliação continua causando falha."
- "Interrupções nos pontos de publicação, registro e limpeza não fabricam sucesso\
\ e permitem recuperação sem remoção de entradas ainda necessárias."
dependsOn:
- "TSK-0007"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:05.800970Z"
- id: "TSK-0009"
title: "Adaptar verificação, status e contexto ao SQLite"
description: "Integrar VerificationService, CompatibilityService e projeções da\
\ CLI ao backend. Montar status, next-actions, context e readiness com consultas\
\ necessárias e resultados reutilizados na invocação; preservar contrato público\
\ quando compatível e informar mudanças. Separar resultado histórico com anexo\
\ descartado legitimamente de validação ativa. Manter diagnóstico de reparo e\
\ ausência de transições de estado em consultas."
acceptanceCriteria:
- "Consultas e contexto em processos novos preservam informações e autoridade e\
\ não promovem, migram ou concluem registros por leitura."
- "Anexos descartados legitimamente não invalidam histórico; corrupção e referê\
ncias ausentes não são tratadas como gates satisfeitos."
- "Caminhos selecionados não repetem varreduras/validações globais sem necessidade;\
\ saída e códigos de erro compatíveis são verificados."
dependsOn:
- "TSK-0004"
- "TSK-0005"
- "TSK-0006"
- "TSK-0008"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:13.390096Z"
- id: "TSK-0010"
title: "Implementar migração explícita e recuperável do legado"
description: "Criar comando público de prévia e aplicação da migração, sem conversã\
o em leituras ou atualização do instalador. Usar base de preparo e cópia de seguranç\
a da conversão, importação tipada transacional e verificação contra o corpus.\
\ Preservar IDs, conteúdo, aprovações, hashes, revisões e proveniência histórica\
\ sem despejar arquivos no banco. Ativar somente após sucesso; repetir ou recuperar\
\ interrupção sem duplicar. Executar apenas em fixtures/cópias descartáveis."
acceptanceCriteria:
- "Prévia não modifica o projeto; aplicação compara registros/contexto e ativa a\
\ base somente após validação completa."
- "Fixtures históricas, recibos, aprovações e referências preservam identidade/proveniê\
ncia; execução repetida não duplica conteúdo."
- "Falhas e interrupções deixam a fonte anterior recuperável e informam próxima\
\ ação; nenhum projeto real ou workspace canônico foi migrado."
dependsOn:
- "TSK-0001"
- "TSK-0009"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:21.074969Z"
- id: "TSK-0011"
title: "Atualizar init, descoberta e contrato de compatibilidade"
description: "Inicializar projetos locais em SQLite e deixar .ai-engineering ignorado\
\ pelo Git por padrão sem exigir Git. Preservar regras preexistentes e instruç\
ões fora do bloco gerido. Declarar backend e versões no contrato público, atualizar\
\ diagnóstico/onboard e evitar que base SQLite seja interpretada como workspace\
\ vazio por combinação incompatível. Manter tratamento explícito de projetos legados\
\ e previamente rastreados."
acceptanceCriteria:
- "Init cria projeto funcional sem Git, com estado local ignorado por padrão e bootstrap\
\ suficiente para humanos e agentes."
- "Reexecução preserva conteúdo/regras; não remove arquivos já rastreados nem converte\
\ legado automaticamente."
- "Versões e backend incompatíveis são recusados com diagnóstico acionável antes\
\ de escrita; documentação/entrypoints não induzem uso de CLI incompatível."
dependsOn:
- "TSK-0009"
- "TSK-0010"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:28.841960Z"
- id: "TSK-0012"
title: "Preparar pacote nativo e instalador conjunto sem ativação"
description: "Evoluir build/distribuição e scripts/install-native.sh para empacotar\
\ AIE nativo, biblioteca SQLite do driver e CLI sqlite3 num diretório configurá\
vel, com atalhos aie/ai-engineering e dados de projeto separados. Fixar componentes/plataformas\
\ e verificar pacote antes de ativação, preservando versão anterior em falhas.\
\ Testar instalador com ferramentas simuladas e destinos descartáveis; smoke usa\
\ build local. Não executar instalação real nem tocar ~/.local/bin ou dependê\
ncias ativas."
acceptanceCriteria:
- "Pacote contém componentes corretos e o build nativo acessa uma base descartá\
vel sem depender da instalação global."
- "Fixtures verificam diretórios configuráveis, atalhos, atualização conjunta e\
\ falha sem danificar instalação anterior simulada."
- "Nenhum binário, biblioteca ou atalho ativo é substituído e o instalador real\
\ não é executado; a ativação posterior continua dependente de instrução humana."
dependsOn:
- "TSK-0002"
- "TSK-0011"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:37.290314Z"
- id: "TSK-0013"
title: "Consolidar documentação e instruções do framework local"
description: "Atualizar README, docs de arquitetura/protocolo/compatibilidade/migraç\
ão e recursos de entrada para memória local, SQLite, gates e retenção mínima.\
\ Explicar anexos temporários, outputs entregues, migração explícita e recuperaç\
ão, pacote preparado e instalação adiada. Remover instruções que apresentem arquivos\
\ de Works como fonte principal nova ou Git como exigência. Preservar orientaç\
ões dos dois ciclos, OODA, DEC/Plan e aprovações."
acceptanceCriteria:
- "Documentação e recursos distribuídos descrevem o mesmo contrato e permitem inicializar/retomar\
\ um projeto sem Git."
- "Procedimento público de migração explica prévia, efeitos e recuperação sem depender\
\ de inspeção do código interno."
- "Limites de retenção e instalação, papel dos gates e recortes futuros estão claros;\
\ fontes e exemplos não alegam testes ou migrações reais não executados."
dependsOn:
- "TSK-0010"
- "TSK-0011"
- "TSK-0012"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:45.331995Z"
- id: "TSK-0014"
title: "Executar regressão integrada e encaminhar responsividade ao WRK-000C"
description: "Integrar as verificações das etapas e executar gates apropriados de\
\ testes/arquitetura, migração, concorrência e smoke JVM/nativo em ambientes descartá\
veis. Revisar continuidade e autoridade nos dois ciclos, anexos temporários, recuperaç\
ão e funcionamento sem Git. Consolidar resultados mínimos, resolver experimentos/preocupaç\
ões e entregar cenário reproduzível ao WRK-000C com comandos, versão, dados e\
\ ambiente. Não instalar o pacote nem declarar resolvido o atraso."
acceptanceCriteria:
- "Suíte relevante de domínio/integração/compatibilidade, fixtures do instalador\
\ e smoke nativo passam ou impedimentos são tratados antes da conclusão."
- "Falhas, rollback, concorrência, legado, gates e descarte legítimo foram verificados\
\ com resultados reais e sem alteração da instalação ativa ou consumidores."
- "Todos os steps e critérios da DEC estão satisfeitos, sem experimentos/preocupaç\
ões pendentes; WRK-000C recebe cenário para medição futura e permanece aberto."
dependsOn:
- "TSK-0013"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:53.421052Z"
status: "ACTIVE"
author: "Codex"
createdAt: "2026-11-22T11:52:06.993736Z"
revision: 20
previousHash: "1e1d15717b43c85aa2c5f59026ad61674da13352f168154acab557ab9a9dc45a"
updatedAt: "2026-11-22T12:10:00.110882Z"
updatedBy: "Codex"
changeReason: "Prova da dependência e empacotamento nativo antes de implementar a\
\ persistência do domínio."
experiments:
- id: "EXP-0001"
stepId: "TSK-0002"
hypothesis: "SQLite JDBC pode criar, persistir e reabrir uma base em processos JVM\
\ e Native Image com biblioteca distribuída ao lado do executável."
successCriterion: "As duas formas executam create/read/write/reopen e rollback em\
\ diretório descartável; o nativo usa a biblioteca do pacote com extração temporá\
ria indisponível; nenhum binário ativo ou consumidor é alterado."
invocation: "./gradlew sqliteProbeClasses nativeSqliteProbeCompile; scripts/sqlite-probe.sh\
\ <build>; execução da classe de prova JVM e do binário de build em processos\
\ distintos"
retryOf: null
reconsideration: null
by: "Codex"
createdAt: "2026-11-22T12:10:00.110720Z"
outcome: "OPEN"
observation: null
interpretation: null
nextAction: null
evidence: []
questionsDecision: null
finishedAt: null
finishedBy: null
documentVersion: 2
---
# Implementar memória de engenharia local em SQLite
## Autoridade e objetivo
Executar a DEC-0001 do WRK-000D, aceita explicitamente por Nilton nesta conversa.
O resultado é um framework local de memória de engenharia por Work, com SQLite
por projeto, investigação e implementação orientadas por OODA, gates preservados,
anexos temporários e retenção mínima. A aprovação desta DEC mantém a instalação
real adiada.
Este Plan foi solicitado com decomposição em vários steps. Todos os steps começam
OPEN; a criação do Plan não constitui execução ou comprovação de resultado.
## Limites obrigatórios
- Não instalar nem substituir o AIE, SQLite, bibliotecas ou atalhos em uso.
- Não executar o instalador real contra HOME, ~/.local/bin ou outro destino ativo.
Sua validação usa fixtures com ferramentas simuladas e destinos descartáveis.
- Não migrar este workspace canônico ou projetos consumidores. Exercitar o novo
backend e a migração em fixtures e cópias descartáveis; ativação real depende de
instrução humana posterior específica.
- Preservar alterações preexistentes, IDs, conteúdo e proveniência legada,
aprovações, evidências históricas e instruções do projeto fora do bloco gerido.
- Não introduzir arquivos em BLOB/base64 ou TEXT equivalente, retenção extensa,
executor autônomo de repositório, colaboração distribuída ou integração Git LFS.
- Importação/exportação de Works/DECs e backup como funcionalidade ficam fora.
A cópia de segurança da migração é parte da recuperação da conversão.
- Código e outputs solicitados permanecem nos destinos de entrega apropriados.
- O WRK-000C permanece aberto para avaliar e tratar latência após esta mudança.
## Execução e dependências
Os 14 steps possuem dependências explícitas e critérios próprios. Mapear primeiro
o contrato e o legado; provar a integração SQLite/JVM/Native Image; depois construir
as transações e migrar os fluxos de domínio. Integrar gates e ciclo dos anexos antes
de consolidar as consultas, a migração pública e o bootstrap. Preparar distribuição
e documentação e concluir com regressão integrada e encaminhamento ao WRK-000C.
Não iniciar um step com dependências pendentes. Verificações focadas fazem parte
de cada mudança; a última etapa integra os cenários e não substitui essas verificações.
Steps independentes podem ser executados em ordem compatível, sem presumir
autorização de delegação ou de instalação real.
## OODA e incertezas
Nas provas relevantes, principalmente driver/nativo, migração e descarte de anexos,
registrar hipótese, critério de sucesso e invocação antes de executar. Registrar
observação, interpretação e próxima ação após o resultado; reconsiderar antes de
repetir uma hipótese falha. Usar os registros de experimentos do Plan quando úteis,
sem impor um ritual de quatro fases a toda alteração.
Ajustar esquema, índices, transações e build dentro da DEC. Se um resultado
questionar a decisão, registrar a preocupação, continuar investigações autorizadas
e rever a DEC com aprovação aplicável antes da execução afetada.
## Verificação e registro mínimo
Durante a execução deste Work, respeitar o protocolo que está em uso. Registrar
resultados reais e evidência mínima necessária para completar os steps; não usar
a futura política de limpeza para apagar evidências legadas ou simular gates.
Verificar continuidade entre processos, integridade referencial, rollback,
concorrência local com espera limitada, autoridade humana, gates e anexos
temporários, migração repetível e operação sem Git. Provas nativas usam somente
artefatos de build e projetos descartáveis.
Comandos candidatos à validação, ajustados ao resultado e ao código final:
- `./gradlew test` e `./gradlew check` para a suíte e arquitetura do projeto.
- `python3 scripts/test-install-native.py` para fixtures do instalador.
- `./gradlew nativeCompile` e tarefas de distribuição para construir o pacote.
- `bash scripts/native-smoke.sh <caminho-absoluto-do-build>` em projetos descartáveis.
Esses comandos são planejados, não executados na criação do Plan. Preservar os
gates específicos do projeto e adicionais do Work definidos na execução. Logs de
trabalho podem ser temporários; guardar na memória somente o necessário ao contrato.
## Conclusão
Todos os steps obrigatórios devem satisfazer seus critérios, com a DEC aceita e
sem experimentos ou preocupações pendentes. A entrega é código, documentação,
pacote preparado e resultados de verificação. Não depende de instalar a nova
versão no ambiente em uso. Encaminhar ao WRK-000C um cenário reproduzível com
comandos, versão, volume e ambiente, sem declarar resolvido o problema de atraso.
@@ -0,0 +1,438 @@
---
schemaVersion: 1
id: "PLN-0001"
workId: "WRK-000D"
title: "Implementar memória de engenharia local em SQLite sem instalação ativa"
decisions:
- "DEC-0001"
steps:
- id: "TSK-0001"
title: "Mapear contrato, dados legados e cenários de migração"
description: "Inspecionar WorkService, serviços de Discussion/Decision/Plan/Agent,\
\ coordenadores e VerificationService. Mapear registros, referências, revisões,\
\ hashes, recibos e bootstrap para tabelas e regras do backend SQLite, preservando\
\ conteúdo e autoridade. Selecionar fixtures existentes de compatibilidade, workflows\
\ e importação como corpus; usar apenas cópias descartáveis. Identificar checks\
\ e pontos de retenção sem realizar benchmark conclusivo do WRK-000C."
acceptanceCriteria:
- "Mapeamento cobre entidades persistidas, IDs locais ao Work, referências, revisõ\
es, aprovações e casos de conclusão legada com hashes/recibos."
- "Corpus representativo e resultados esperados de continuidade/migração estão definidos\
\ antes da conversão, incluindo dados inválidos e estados interrompidos."
- "Limites de instalação, migração de consumidores e preservação do workspace atual\
\ estão explícitos e respeitados."
dependsOn: []
status: "COMPLETED"
result: "Contrato e legado mapeados em docs/sqlite-migration-design.md; corpus e\
\ casos de falha/retry definidos antes da migração. Baseline: 45 testes em seis\
\ classes passaram, hashes congelados conferidos e fontes históricas intactas.\
\ Sem instalação ou migração real."
evidence:
- "ART-0001"
updatedAt: "2026-11-22T12:00:26.700050Z"
- id: "TSK-0002"
title: "Provar driver SQLite em JVM e Native Image"
description: "Avaliar Xerial SQLite JDBC e fixar versão compatível com Java, Gradle\
\ e GraalVM do projeto. Registrar hipótese, critério e invocação antes da prova.\
\ Criar, gravar, ler e reabrir uma base descartável em processos JVM e nativos.\
\ Verificar carregamento da biblioteca distribuída ao lado do nativo; sqlite3\
\ será ferramenta de diagnóstico do pacote. Construir e executar somente artefatos\
\ descartáveis, sem instalação real."
acceptanceCriteria:
- "Driver e versão selecionados demonstram persistência e reabertura em JVM e Native\
\ Image na plataforma alvo."
- "Biblioteca do pacote é encontrada por caminho controlado e não depende acidentalmente\
\ do SQLite global ou de extração repetida não planejada."
- "Hipótese, resultado e limitações da prova estão registrados; instalação ativa\
\ e projetos consumidores não foram alterados."
dependsOn:
- "TSK-0001"
status: "ACTIVE"
result: "Prosseguir autonomamente conforme instrução de Nilton; provar driver em\
\ JVM e Native Image, somente em bases descartáveis e sem instalação."
evidence: []
updatedAt: "2026-11-22T12:09:51.453556Z"
- id: "TSK-0003"
title: "Implementar esquema, conexões e transações SQLite"
description: "Criar infraestrutura de persistência local em .ai-engineering/aie.db\
\ com esquema versionado, tabelas tipadas, índices e relações. Habilitar integridade\
\ referencial em cada conexão, delimitar unidade transacional por operação coerente\
\ e usar leitura consistente. Definir journal/durabilidade e espera limitada de\
\ escrita com diagnóstico. Preservar limites de módulos; serviços aninhados devem\
\ compartilhar a transação aplicável."
acceptanceCriteria:
- "Esquema e índices atendem ao mapeamento sem BLOB/base64 ou arquivos completos\
\ serializados em TEXT."
- "Falha em operação relacionada causa rollback; referências inválidas são recusadas\
\ e gravações concorrentes têm contenção limitada e diagnóstico útil."
- "Abertura de esquema incompatível é diagnosticada sem alterar dados; teste de\
\ leitura consistente cobre mudanças concorrentes locais."
dependsOn:
- "TSK-0001"
- "TSK-0002"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:52:29.986202Z"
- id: "TSK-0004"
title: "Persistir Works e investigação no novo backend"
description: "Integrar Work, guidance e histórico de escolhas, discussões, tópicos,\
\ surveys, respostas e disposições à unidade de persistência. Preservar IDs existentes,\
\ semântica dos IDs locais, referências e histórico útil. Consultas selecionadas\
\ devem buscar o Work diretamente. Manter leitura legada delimitada para compatibilidade\
\ e migração; não manter duas fontes autoritativas para a mesma memória."
acceptanceCriteria:
- "Criar e retomar Work/discussão/survey em outro processo preserva conteúdo, histó\
rico de respostas e pendências."
- "Escolhas DIRECT/EXPLORATORY e autoridade humana mantêm as regras existentes,\
\ inclusive ausência de escolha e pedido específico de DEC."
- "Busca por Work e suas referências usa consultas com escopo adequado; alteraçõ\
es e referências relacionadas são transacionais."
dependsOn:
- "TSK-0003"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:52:37.091047Z"
- id: "TSK-0005"
title: "Persistir decisões, planos e experimentos"
description: "Integrar DecisionService e PlanService com revisões, aceitação, supersessã\
o, passos, dependências e experimentos. Preservar os dois ciclos e OODA, a autoridade\
\ de DEC/Plan e a distinção entre aprovação humana e promoção permitida por polí\
tica. Tratar operações que alteram registros relacionados em uma transação, sem\
\ reduzir os checks de domínio."
acceptanceCriteria:
- "Aprovação, revisão e supersessão preservam autoria e referências, sem fabricaç\
ão de aprovação ou edição silenciosa de decisão aceita."
- "Dependências e estados de passos, critérios de experimentos, preocupações com\
\ DEC e replanejamento conservam os bloqueios existentes."
- "Interrupção simulada não publica meia supersessão ou promoção parcial; retomada\
\ em outro processo preserva o contexto."
dependsOn:
- "TSK-0004"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:52:43.954237Z"
- id: "TSK-0006"
title: "Integrar execuções de agentes e coordenação de EPICs"
description: "Persistir RUNs e seus dados operacionais mínimos, idempotência de\
\ requestId, referências aplicadas e diagnóstico. Integrar PlanCoordinator/EpicCoordinator,\
\ políticas e proveniência de conclusão, representando recibos internos como dados\
\ estruturados quando aplicável. Preservar a fronteira do adaptador: propostas\
\ não aprovam DEC, não respondem pelo humano nem executam comandos de repositó\
rio."
acceptanceCriteria:
- "Repetição idempotente de uma solicitação concluída não duplica registros; solicitaç\
ões divergentes e estados interrompidos são diagnosticados."
- "Políticas RESULTS/DECOMPOSITION, delegação, reabertura, propagação e conclusã\
o por Plans preservam autoridade e proveniência."
- "Resultados estruturados necessários permanecem; transporte bruto, ambiente e\
\ logs completos não viram acervo permanente no banco."
dependsOn:
- "TSK-0005"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:52:50.899228Z"
- id: "TSK-0007"
title: "Integrar gates do projeto e adicionais por Work"
description: "Representar gates obrigatórios do projeto e complementos do Work e\
\ conectar seus resultados aos checks e à entrega. Preservar avaliação externa\
\ e condições de qualidade, inclusive anexos exigidos. Registrar identificaçã\
o, procedimento/execução, estado avaliado, momento e resultado mínimo. Alteraç\
ões pertinentes invalidam a aplicação do resultado aos gates afetados; aprovaç\
ão humana não equivale a sucesso técnico."
acceptanceCriteria:
- "Gate obrigatório pendente, falho ou não executado bloqueia a entrega; gates adicionais\
\ do Work são considerados sem dispensar obrigatórios do projeto."
- "Resultados correspondem ao estado realmente avaliado e não satisfazem silenciosamente\
\ um gate após mudança relevante."
- "Checks existentes e anexos necessários continuam exigidos durante avaliação,\
\ sem introduzir executor autônomo ou retenção bruta obrigatória."
dependsOn:
- "TSK-0005"
- "TSK-0006"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:52:58.285586Z"
- id: "TSK-0008"
title: "Implementar anexos temporários e descarte após checks"
description: "Definir ciclo de vida de anexos e arquivos de execução no filesystem.\
\ Publicar arquivos completos, validar e registrar resultados mínimos antes do\
\ descarte; limpar elegíveis ao fim da execução. Proteger anexos ainda usados\
\ por checks pendentes e outputs solicitados. Recuperar falhas entre publicaçã\
o de arquivo, transação no banco e limpeza, distinguindo descarte legítimo de\
\ perda prematura. Não descartar artefatos legados deste workspace."
acceptanceCriteria:
- "Arquivos exigidos permanecem acessíveis até todos os checks dependentes terminarem,\
\ com resultado persistido antes da remoção."
- "Descarte automático preserva outputs solicitados e memória histórica; arquivo\
\ perdido antes da avaliação continua causando falha."
- "Interrupções nos pontos de publicação, registro e limpeza não fabricam sucesso\
\ e permitem recuperação sem remoção de entradas ainda necessárias."
dependsOn:
- "TSK-0007"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:05.800970Z"
- id: "TSK-0009"
title: "Adaptar verificação, status e contexto ao SQLite"
description: "Integrar VerificationService, CompatibilityService e projeções da\
\ CLI ao backend. Montar status, next-actions, context e readiness com consultas\
\ necessárias e resultados reutilizados na invocação; preservar contrato público\
\ quando compatível e informar mudanças. Separar resultado histórico com anexo\
\ descartado legitimamente de validação ativa. Manter diagnóstico de reparo e\
\ ausência de transições de estado em consultas."
acceptanceCriteria:
- "Consultas e contexto em processos novos preservam informações e autoridade e\
\ não promovem, migram ou concluem registros por leitura."
- "Anexos descartados legitimamente não invalidam histórico; corrupção e referê\
ncias ausentes não são tratadas como gates satisfeitos."
- "Caminhos selecionados não repetem varreduras/validações globais sem necessidade;\
\ saída e códigos de erro compatíveis são verificados."
dependsOn:
- "TSK-0004"
- "TSK-0005"
- "TSK-0006"
- "TSK-0008"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:13.390096Z"
- id: "TSK-0010"
title: "Implementar migração explícita e recuperável do legado"
description: "Criar comando público de prévia e aplicação da migração, sem conversã\
o em leituras ou atualização do instalador. Usar base de preparo e cópia de seguranç\
a da conversão, importação tipada transacional e verificação contra o corpus.\
\ Preservar IDs, conteúdo, aprovações, hashes, revisões e proveniência histórica\
\ sem despejar arquivos no banco. Ativar somente após sucesso; repetir ou recuperar\
\ interrupção sem duplicar. Executar apenas em fixtures/cópias descartáveis."
acceptanceCriteria:
- "Prévia não modifica o projeto; aplicação compara registros/contexto e ativa a\
\ base somente após validação completa."
- "Fixtures históricas, recibos, aprovações e referências preservam identidade/proveniê\
ncia; execução repetida não duplica conteúdo."
- "Falhas e interrupções deixam a fonte anterior recuperável e informam próxima\
\ ação; nenhum projeto real ou workspace canônico foi migrado."
dependsOn:
- "TSK-0001"
- "TSK-0009"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:21.074969Z"
- id: "TSK-0011"
title: "Atualizar init, descoberta e contrato de compatibilidade"
description: "Inicializar projetos locais em SQLite e deixar .ai-engineering ignorado\
\ pelo Git por padrão sem exigir Git. Preservar regras preexistentes e instruç\
ões fora do bloco gerido. Declarar backend e versões no contrato público, atualizar\
\ diagnóstico/onboard e evitar que base SQLite seja interpretada como workspace\
\ vazio por combinação incompatível. Manter tratamento explícito de projetos legados\
\ e previamente rastreados."
acceptanceCriteria:
- "Init cria projeto funcional sem Git, com estado local ignorado por padrão e bootstrap\
\ suficiente para humanos e agentes."
- "Reexecução preserva conteúdo/regras; não remove arquivos já rastreados nem converte\
\ legado automaticamente."
- "Versões e backend incompatíveis são recusados com diagnóstico acionável antes\
\ de escrita; documentação/entrypoints não induzem uso de CLI incompatível."
dependsOn:
- "TSK-0009"
- "TSK-0010"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:28.841960Z"
- id: "TSK-0012"
title: "Preparar pacote nativo e instalador conjunto sem ativação"
description: "Evoluir build/distribuição e scripts/install-native.sh para empacotar\
\ AIE nativo, biblioteca SQLite do driver e CLI sqlite3 num diretório configurá\
vel, com atalhos aie/ai-engineering e dados de projeto separados. Fixar componentes/plataformas\
\ e verificar pacote antes de ativação, preservando versão anterior em falhas.\
\ Testar instalador com ferramentas simuladas e destinos descartáveis; smoke usa\
\ build local. Não executar instalação real nem tocar ~/.local/bin ou dependê\
ncias ativas."
acceptanceCriteria:
- "Pacote contém componentes corretos e o build nativo acessa uma base descartá\
vel sem depender da instalação global."
- "Fixtures verificam diretórios configuráveis, atalhos, atualização conjunta e\
\ falha sem danificar instalação anterior simulada."
- "Nenhum binário, biblioteca ou atalho ativo é substituído e o instalador real\
\ não é executado; a ativação posterior continua dependente de instrução humana."
dependsOn:
- "TSK-0002"
- "TSK-0011"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:37.290314Z"
- id: "TSK-0013"
title: "Consolidar documentação e instruções do framework local"
description: "Atualizar README, docs de arquitetura/protocolo/compatibilidade/migraç\
ão e recursos de entrada para memória local, SQLite, gates e retenção mínima.\
\ Explicar anexos temporários, outputs entregues, migração explícita e recuperaç\
ão, pacote preparado e instalação adiada. Remover instruções que apresentem arquivos\
\ de Works como fonte principal nova ou Git como exigência. Preservar orientaç\
ões dos dois ciclos, OODA, DEC/Plan e aprovações."
acceptanceCriteria:
- "Documentação e recursos distribuídos descrevem o mesmo contrato e permitem inicializar/retomar\
\ um projeto sem Git."
- "Procedimento público de migração explica prévia, efeitos e recuperação sem depender\
\ de inspeção do código interno."
- "Limites de retenção e instalação, papel dos gates e recortes futuros estão claros;\
\ fontes e exemplos não alegam testes ou migrações reais não executados."
dependsOn:
- "TSK-0010"
- "TSK-0011"
- "TSK-0012"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:45.331995Z"
- id: "TSK-0014"
title: "Executar regressão integrada e encaminhar responsividade ao WRK-000C"
description: "Integrar as verificações das etapas e executar gates apropriados de\
\ testes/arquitetura, migração, concorrência e smoke JVM/nativo em ambientes descartá\
veis. Revisar continuidade e autoridade nos dois ciclos, anexos temporários, recuperaç\
ão e funcionamento sem Git. Consolidar resultados mínimos, resolver experimentos/preocupaç\
ões e entregar cenário reproduzível ao WRK-000C com comandos, versão, dados e\
\ ambiente. Não instalar o pacote nem declarar resolvido o atraso."
acceptanceCriteria:
- "Suíte relevante de domínio/integração/compatibilidade, fixtures do instalador\
\ e smoke nativo passam ou impedimentos são tratados antes da conclusão."
- "Falhas, rollback, concorrência, legado, gates e descarte legítimo foram verificados\
\ com resultados reais e sem alteração da instalação ativa ou consumidores."
- "Todos os steps e critérios da DEC estão satisfeitos, sem experimentos/preocupaç\
ões pendentes; WRK-000C recebe cenário para medição futura e permanece aberto."
dependsOn:
- "TSK-0013"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:53.421052Z"
status: "ACTIVE"
author: "Codex"
createdAt: "2026-11-22T11:52:06.993736Z"
revision: 21
previousHash: "cdfd73b6ed22c8ced85592a9168e02bfb70eb948e6dd1b90b473ee43bc58fb12"
updatedAt: "2026-11-22T12:16:43.109433Z"
updatedBy: "Codex"
changeReason: "Critérios da prova atendidos em dados descartáveis."
experiments:
- id: "EXP-0001"
stepId: "TSK-0002"
hypothesis: "SQLite JDBC pode criar, persistir e reabrir uma base em processos JVM\
\ e Native Image com biblioteca distribuída ao lado do executável."
successCriterion: "As duas formas executam create/read/write/reopen e rollback em\
\ diretório descartável; o nativo usa a biblioteca do pacote com extração temporá\
ria indisponível; nenhum binário ativo ou consumidor é alterado."
invocation: "./gradlew sqliteProbeClasses nativeSqliteProbeCompile; scripts/sqlite-probe.sh\
\ <build>; execução da classe de prova JVM e do binário de build em processos\
\ distintos"
retryOf: null
reconsideration: null
by: "Codex"
createdAt: "2026-11-22T12:10:00.110720Z"
outcome: "CONFIRMED"
observation: "JVM criou e reabriu a base com UTF-8 e rollback. Native Image GraalVM\
\ 25 criou e reabriu em processos independentes com biblioteca externa e extraç\
ão sem escrita; a cópia isolada sem biblioteca falhou."
interpretation: "Driver SQLite JDBC 3.54.1.0 e biblioteca distribuída ao lado do\
\ nativo funcionam na plataforma macOS arm64. Seleção inicial de JDK foi corrigida\
\ explicitamente; sem instalação real."
nextAction: "Implementar infraestrutura transacional e esquema local no TSK-0003."
evidence:
- "ART-0002"
questionsDecision: null
finishedAt: "2026-11-22T12:16:43.109268Z"
finishedBy: "Codex"
documentVersion: 2
---
# Implementar memória de engenharia local em SQLite
## Autoridade e objetivo
Executar a DEC-0001 do WRK-000D, aceita explicitamente por Nilton nesta conversa.
O resultado é um framework local de memória de engenharia por Work, com SQLite
por projeto, investigação e implementação orientadas por OODA, gates preservados,
anexos temporários e retenção mínima. A aprovação desta DEC mantém a instalação
real adiada.
Este Plan foi solicitado com decomposição em vários steps. Todos os steps começam
OPEN; a criação do Plan não constitui execução ou comprovação de resultado.
## Limites obrigatórios
- Não instalar nem substituir o AIE, SQLite, bibliotecas ou atalhos em uso.
- Não executar o instalador real contra HOME, ~/.local/bin ou outro destino ativo.
Sua validação usa fixtures com ferramentas simuladas e destinos descartáveis.
- Não migrar este workspace canônico ou projetos consumidores. Exercitar o novo
backend e a migração em fixtures e cópias descartáveis; ativação real depende de
instrução humana posterior específica.
- Preservar alterações preexistentes, IDs, conteúdo e proveniência legada,
aprovações, evidências históricas e instruções do projeto fora do bloco gerido.
- Não introduzir arquivos em BLOB/base64 ou TEXT equivalente, retenção extensa,
executor autônomo de repositório, colaboração distribuída ou integração Git LFS.
- Importação/exportação de Works/DECs e backup como funcionalidade ficam fora.
A cópia de segurança da migração é parte da recuperação da conversão.
- Código e outputs solicitados permanecem nos destinos de entrega apropriados.
- O WRK-000C permanece aberto para avaliar e tratar latência após esta mudança.
## Execução e dependências
Os 14 steps possuem dependências explícitas e critérios próprios. Mapear primeiro
o contrato e o legado; provar a integração SQLite/JVM/Native Image; depois construir
as transações e migrar os fluxos de domínio. Integrar gates e ciclo dos anexos antes
de consolidar as consultas, a migração pública e o bootstrap. Preparar distribuição
e documentação e concluir com regressão integrada e encaminhamento ao WRK-000C.
Não iniciar um step com dependências pendentes. Verificações focadas fazem parte
de cada mudança; a última etapa integra os cenários e não substitui essas verificações.
Steps independentes podem ser executados em ordem compatível, sem presumir
autorização de delegação ou de instalação real.
## OODA e incertezas
Nas provas relevantes, principalmente driver/nativo, migração e descarte de anexos,
registrar hipótese, critério de sucesso e invocação antes de executar. Registrar
observação, interpretação e próxima ação após o resultado; reconsiderar antes de
repetir uma hipótese falha. Usar os registros de experimentos do Plan quando úteis,
sem impor um ritual de quatro fases a toda alteração.
Ajustar esquema, índices, transações e build dentro da DEC. Se um resultado
questionar a decisão, registrar a preocupação, continuar investigações autorizadas
e rever a DEC com aprovação aplicável antes da execução afetada.
## Verificação e registro mínimo
Durante a execução deste Work, respeitar o protocolo que está em uso. Registrar
resultados reais e evidência mínima necessária para completar os steps; não usar
a futura política de limpeza para apagar evidências legadas ou simular gates.
Verificar continuidade entre processos, integridade referencial, rollback,
concorrência local com espera limitada, autoridade humana, gates e anexos
temporários, migração repetível e operação sem Git. Provas nativas usam somente
artefatos de build e projetos descartáveis.
Comandos candidatos à validação, ajustados ao resultado e ao código final:
- `./gradlew test` e `./gradlew check` para a suíte e arquitetura do projeto.
- `python3 scripts/test-install-native.py` para fixtures do instalador.
- `./gradlew nativeCompile` e tarefas de distribuição para construir o pacote.
- `bash scripts/native-smoke.sh <caminho-absoluto-do-build>` em projetos descartáveis.
Esses comandos são planejados, não executados na criação do Plan. Preservar os
gates específicos do projeto e adicionais do Work definidos na execução. Logs de
trabalho podem ser temporários; guardar na memória somente o necessário ao contrato.
## Conclusão
Todos os steps obrigatórios devem satisfazer seus critérios, com a DEC aceita e
sem experimentos ou preocupações pendentes. A entrega é código, documentação,
pacote preparado e resultados de verificação. Não depende de instalar a nova
versão no ambiente em uso. Encaminhar ao WRK-000C um cenário reproduzível com
comandos, versão, volume e ambiente, sem declarar resolvido o problema de atraso.
@@ -0,0 +1,440 @@
---
schemaVersion: 1
id: "PLN-0001"
workId: "WRK-000D"
title: "Implementar memória de engenharia local em SQLite sem instalação ativa"
decisions:
- "DEC-0001"
steps:
- id: "TSK-0001"
title: "Mapear contrato, dados legados e cenários de migração"
description: "Inspecionar WorkService, serviços de Discussion/Decision/Plan/Agent,\
\ coordenadores e VerificationService. Mapear registros, referências, revisões,\
\ hashes, recibos e bootstrap para tabelas e regras do backend SQLite, preservando\
\ conteúdo e autoridade. Selecionar fixtures existentes de compatibilidade, workflows\
\ e importação como corpus; usar apenas cópias descartáveis. Identificar checks\
\ e pontos de retenção sem realizar benchmark conclusivo do WRK-000C."
acceptanceCriteria:
- "Mapeamento cobre entidades persistidas, IDs locais ao Work, referências, revisõ\
es, aprovações e casos de conclusão legada com hashes/recibos."
- "Corpus representativo e resultados esperados de continuidade/migração estão definidos\
\ antes da conversão, incluindo dados inválidos e estados interrompidos."
- "Limites de instalação, migração de consumidores e preservação do workspace atual\
\ estão explícitos e respeitados."
dependsOn: []
status: "COMPLETED"
result: "Contrato e legado mapeados em docs/sqlite-migration-design.md; corpus e\
\ casos de falha/retry definidos antes da migração. Baseline: 45 testes em seis\
\ classes passaram, hashes congelados conferidos e fontes históricas intactas.\
\ Sem instalação ou migração real."
evidence:
- "ART-0001"
updatedAt: "2026-11-22T12:00:26.700050Z"
- id: "TSK-0002"
title: "Provar driver SQLite em JVM e Native Image"
description: "Avaliar Xerial SQLite JDBC e fixar versão compatível com Java, Gradle\
\ e GraalVM do projeto. Registrar hipótese, critério e invocação antes da prova.\
\ Criar, gravar, ler e reabrir uma base descartável em processos JVM e nativos.\
\ Verificar carregamento da biblioteca distribuída ao lado do nativo; sqlite3\
\ será ferramenta de diagnóstico do pacote. Construir e executar somente artefatos\
\ descartáveis, sem instalação real."
acceptanceCriteria:
- "Driver e versão selecionados demonstram persistência e reabertura em JVM e Native\
\ Image na plataforma alvo."
- "Biblioteca do pacote é encontrada por caminho controlado e não depende acidentalmente\
\ do SQLite global ou de extração repetida não planejada."
- "Hipótese, resultado e limitações da prova estão registrados; instalação ativa\
\ e projetos consumidores não foram alterados."
dependsOn:
- "TSK-0001"
status: "COMPLETED"
result: "Prova JVM e Native Image passou create/read/write/reopen, UTF-8, rollback\
\ e dependência da biblioteca do pacote; sem instalação ativa."
evidence:
- "ART-0002"
updatedAt: "2026-11-22T12:16:52.149066Z"
- id: "TSK-0003"
title: "Implementar esquema, conexões e transações SQLite"
description: "Criar infraestrutura de persistência local em .ai-engineering/aie.db\
\ com esquema versionado, tabelas tipadas, índices e relações. Habilitar integridade\
\ referencial em cada conexão, delimitar unidade transacional por operação coerente\
\ e usar leitura consistente. Definir journal/durabilidade e espera limitada de\
\ escrita com diagnóstico. Preservar limites de módulos; serviços aninhados devem\
\ compartilhar a transação aplicável."
acceptanceCriteria:
- "Esquema e índices atendem ao mapeamento sem BLOB/base64 ou arquivos completos\
\ serializados em TEXT."
- "Falha em operação relacionada causa rollback; referências inválidas são recusadas\
\ e gravações concorrentes têm contenção limitada e diagnóstico útil."
- "Abertura de esquema incompatível é diagnosticada sem alterar dados; teste de\
\ leitura consistente cobre mudanças concorrentes locais."
dependsOn:
- "TSK-0001"
- "TSK-0002"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:52:29.986202Z"
- id: "TSK-0004"
title: "Persistir Works e investigação no novo backend"
description: "Integrar Work, guidance e histórico de escolhas, discussões, tópicos,\
\ surveys, respostas e disposições à unidade de persistência. Preservar IDs existentes,\
\ semântica dos IDs locais, referências e histórico útil. Consultas selecionadas\
\ devem buscar o Work diretamente. Manter leitura legada delimitada para compatibilidade\
\ e migração; não manter duas fontes autoritativas para a mesma memória."
acceptanceCriteria:
- "Criar e retomar Work/discussão/survey em outro processo preserva conteúdo, histó\
rico de respostas e pendências."
- "Escolhas DIRECT/EXPLORATORY e autoridade humana mantêm as regras existentes,\
\ inclusive ausência de escolha e pedido específico de DEC."
- "Busca por Work e suas referências usa consultas com escopo adequado; alteraçõ\
es e referências relacionadas são transacionais."
dependsOn:
- "TSK-0003"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:52:37.091047Z"
- id: "TSK-0005"
title: "Persistir decisões, planos e experimentos"
description: "Integrar DecisionService e PlanService com revisões, aceitação, supersessã\
o, passos, dependências e experimentos. Preservar os dois ciclos e OODA, a autoridade\
\ de DEC/Plan e a distinção entre aprovação humana e promoção permitida por polí\
tica. Tratar operações que alteram registros relacionados em uma transação, sem\
\ reduzir os checks de domínio."
acceptanceCriteria:
- "Aprovação, revisão e supersessão preservam autoria e referências, sem fabricaç\
ão de aprovação ou edição silenciosa de decisão aceita."
- "Dependências e estados de passos, critérios de experimentos, preocupações com\
\ DEC e replanejamento conservam os bloqueios existentes."
- "Interrupção simulada não publica meia supersessão ou promoção parcial; retomada\
\ em outro processo preserva o contexto."
dependsOn:
- "TSK-0004"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:52:43.954237Z"
- id: "TSK-0006"
title: "Integrar execuções de agentes e coordenação de EPICs"
description: "Persistir RUNs e seus dados operacionais mínimos, idempotência de\
\ requestId, referências aplicadas e diagnóstico. Integrar PlanCoordinator/EpicCoordinator,\
\ políticas e proveniência de conclusão, representando recibos internos como dados\
\ estruturados quando aplicável. Preservar a fronteira do adaptador: propostas\
\ não aprovam DEC, não respondem pelo humano nem executam comandos de repositó\
rio."
acceptanceCriteria:
- "Repetição idempotente de uma solicitação concluída não duplica registros; solicitaç\
ões divergentes e estados interrompidos são diagnosticados."
- "Políticas RESULTS/DECOMPOSITION, delegação, reabertura, propagação e conclusã\
o por Plans preservam autoridade e proveniência."
- "Resultados estruturados necessários permanecem; transporte bruto, ambiente e\
\ logs completos não viram acervo permanente no banco."
dependsOn:
- "TSK-0005"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:52:50.899228Z"
- id: "TSK-0007"
title: "Integrar gates do projeto e adicionais por Work"
description: "Representar gates obrigatórios do projeto e complementos do Work e\
\ conectar seus resultados aos checks e à entrega. Preservar avaliação externa\
\ e condições de qualidade, inclusive anexos exigidos. Registrar identificaçã\
o, procedimento/execução, estado avaliado, momento e resultado mínimo. Alteraç\
ões pertinentes invalidam a aplicação do resultado aos gates afetados; aprovaç\
ão humana não equivale a sucesso técnico."
acceptanceCriteria:
- "Gate obrigatório pendente, falho ou não executado bloqueia a entrega; gates adicionais\
\ do Work são considerados sem dispensar obrigatórios do projeto."
- "Resultados correspondem ao estado realmente avaliado e não satisfazem silenciosamente\
\ um gate após mudança relevante."
- "Checks existentes e anexos necessários continuam exigidos durante avaliação,\
\ sem introduzir executor autônomo ou retenção bruta obrigatória."
dependsOn:
- "TSK-0005"
- "TSK-0006"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:52:58.285586Z"
- id: "TSK-0008"
title: "Implementar anexos temporários e descarte após checks"
description: "Definir ciclo de vida de anexos e arquivos de execução no filesystem.\
\ Publicar arquivos completos, validar e registrar resultados mínimos antes do\
\ descarte; limpar elegíveis ao fim da execução. Proteger anexos ainda usados\
\ por checks pendentes e outputs solicitados. Recuperar falhas entre publicaçã\
o de arquivo, transação no banco e limpeza, distinguindo descarte legítimo de\
\ perda prematura. Não descartar artefatos legados deste workspace."
acceptanceCriteria:
- "Arquivos exigidos permanecem acessíveis até todos os checks dependentes terminarem,\
\ com resultado persistido antes da remoção."
- "Descarte automático preserva outputs solicitados e memória histórica; arquivo\
\ perdido antes da avaliação continua causando falha."
- "Interrupções nos pontos de publicação, registro e limpeza não fabricam sucesso\
\ e permitem recuperação sem remoção de entradas ainda necessárias."
dependsOn:
- "TSK-0007"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:05.800970Z"
- id: "TSK-0009"
title: "Adaptar verificação, status e contexto ao SQLite"
description: "Integrar VerificationService, CompatibilityService e projeções da\
\ CLI ao backend. Montar status, next-actions, context e readiness com consultas\
\ necessárias e resultados reutilizados na invocação; preservar contrato público\
\ quando compatível e informar mudanças. Separar resultado histórico com anexo\
\ descartado legitimamente de validação ativa. Manter diagnóstico de reparo e\
\ ausência de transições de estado em consultas."
acceptanceCriteria:
- "Consultas e contexto em processos novos preservam informações e autoridade e\
\ não promovem, migram ou concluem registros por leitura."
- "Anexos descartados legitimamente não invalidam histórico; corrupção e referê\
ncias ausentes não são tratadas como gates satisfeitos."
- "Caminhos selecionados não repetem varreduras/validações globais sem necessidade;\
\ saída e códigos de erro compatíveis são verificados."
dependsOn:
- "TSK-0004"
- "TSK-0005"
- "TSK-0006"
- "TSK-0008"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:13.390096Z"
- id: "TSK-0010"
title: "Implementar migração explícita e recuperável do legado"
description: "Criar comando público de prévia e aplicação da migração, sem conversã\
o em leituras ou atualização do instalador. Usar base de preparo e cópia de seguranç\
a da conversão, importação tipada transacional e verificação contra o corpus.\
\ Preservar IDs, conteúdo, aprovações, hashes, revisões e proveniência histórica\
\ sem despejar arquivos no banco. Ativar somente após sucesso; repetir ou recuperar\
\ interrupção sem duplicar. Executar apenas em fixtures/cópias descartáveis."
acceptanceCriteria:
- "Prévia não modifica o projeto; aplicação compara registros/contexto e ativa a\
\ base somente após validação completa."
- "Fixtures históricas, recibos, aprovações e referências preservam identidade/proveniê\
ncia; execução repetida não duplica conteúdo."
- "Falhas e interrupções deixam a fonte anterior recuperável e informam próxima\
\ ação; nenhum projeto real ou workspace canônico foi migrado."
dependsOn:
- "TSK-0001"
- "TSK-0009"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:21.074969Z"
- id: "TSK-0011"
title: "Atualizar init, descoberta e contrato de compatibilidade"
description: "Inicializar projetos locais em SQLite e deixar .ai-engineering ignorado\
\ pelo Git por padrão sem exigir Git. Preservar regras preexistentes e instruç\
ões fora do bloco gerido. Declarar backend e versões no contrato público, atualizar\
\ diagnóstico/onboard e evitar que base SQLite seja interpretada como workspace\
\ vazio por combinação incompatível. Manter tratamento explícito de projetos legados\
\ e previamente rastreados."
acceptanceCriteria:
- "Init cria projeto funcional sem Git, com estado local ignorado por padrão e bootstrap\
\ suficiente para humanos e agentes."
- "Reexecução preserva conteúdo/regras; não remove arquivos já rastreados nem converte\
\ legado automaticamente."
- "Versões e backend incompatíveis são recusados com diagnóstico acionável antes\
\ de escrita; documentação/entrypoints não induzem uso de CLI incompatível."
dependsOn:
- "TSK-0009"
- "TSK-0010"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:28.841960Z"
- id: "TSK-0012"
title: "Preparar pacote nativo e instalador conjunto sem ativação"
description: "Evoluir build/distribuição e scripts/install-native.sh para empacotar\
\ AIE nativo, biblioteca SQLite do driver e CLI sqlite3 num diretório configurá\
vel, com atalhos aie/ai-engineering e dados de projeto separados. Fixar componentes/plataformas\
\ e verificar pacote antes de ativação, preservando versão anterior em falhas.\
\ Testar instalador com ferramentas simuladas e destinos descartáveis; smoke usa\
\ build local. Não executar instalação real nem tocar ~/.local/bin ou dependê\
ncias ativas."
acceptanceCriteria:
- "Pacote contém componentes corretos e o build nativo acessa uma base descartá\
vel sem depender da instalação global."
- "Fixtures verificam diretórios configuráveis, atalhos, atualização conjunta e\
\ falha sem danificar instalação anterior simulada."
- "Nenhum binário, biblioteca ou atalho ativo é substituído e o instalador real\
\ não é executado; a ativação posterior continua dependente de instrução humana."
dependsOn:
- "TSK-0002"
- "TSK-0011"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:37.290314Z"
- id: "TSK-0013"
title: "Consolidar documentação e instruções do framework local"
description: "Atualizar README, docs de arquitetura/protocolo/compatibilidade/migraç\
ão e recursos de entrada para memória local, SQLite, gates e retenção mínima.\
\ Explicar anexos temporários, outputs entregues, migração explícita e recuperaç\
ão, pacote preparado e instalação adiada. Remover instruções que apresentem arquivos\
\ de Works como fonte principal nova ou Git como exigência. Preservar orientaç\
ões dos dois ciclos, OODA, DEC/Plan e aprovações."
acceptanceCriteria:
- "Documentação e recursos distribuídos descrevem o mesmo contrato e permitem inicializar/retomar\
\ um projeto sem Git."
- "Procedimento público de migração explica prévia, efeitos e recuperação sem depender\
\ de inspeção do código interno."
- "Limites de retenção e instalação, papel dos gates e recortes futuros estão claros;\
\ fontes e exemplos não alegam testes ou migrações reais não executados."
dependsOn:
- "TSK-0010"
- "TSK-0011"
- "TSK-0012"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:45.331995Z"
- id: "TSK-0014"
title: "Executar regressão integrada e encaminhar responsividade ao WRK-000C"
description: "Integrar as verificações das etapas e executar gates apropriados de\
\ testes/arquitetura, migração, concorrência e smoke JVM/nativo em ambientes descartá\
veis. Revisar continuidade e autoridade nos dois ciclos, anexos temporários, recuperaç\
ão e funcionamento sem Git. Consolidar resultados mínimos, resolver experimentos/preocupaç\
ões e entregar cenário reproduzível ao WRK-000C com comandos, versão, dados e\
\ ambiente. Não instalar o pacote nem declarar resolvido o atraso."
acceptanceCriteria:
- "Suíte relevante de domínio/integração/compatibilidade, fixtures do instalador\
\ e smoke nativo passam ou impedimentos são tratados antes da conclusão."
- "Falhas, rollback, concorrência, legado, gates e descarte legítimo foram verificados\
\ com resultados reais e sem alteração da instalação ativa ou consumidores."
- "Todos os steps e critérios da DEC estão satisfeitos, sem experimentos/preocupaç\
ões pendentes; WRK-000C recebe cenário para medição futura e permanece aberto."
dependsOn:
- "TSK-0013"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:53.421052Z"
status: "ACTIVE"
author: "Codex"
createdAt: "2026-11-22T11:52:06.993736Z"
revision: 22
previousHash: "d52d9fb2f4d314c9b18ddf1a419177dd13773296d68664556a12e6a016f48ce6"
updatedAt: "2026-11-22T12:16:52.149228Z"
updatedBy: "Codex"
changeReason: "Prova JVM e Native Image passou create/read/write/reopen, UTF-8, rollback\
\ e dependência da biblioteca do pacote; sem instalação ativa."
experiments:
- id: "EXP-0001"
stepId: "TSK-0002"
hypothesis: "SQLite JDBC pode criar, persistir e reabrir uma base em processos JVM\
\ e Native Image com biblioteca distribuída ao lado do executável."
successCriterion: "As duas formas executam create/read/write/reopen e rollback em\
\ diretório descartável; o nativo usa a biblioteca do pacote com extração temporá\
ria indisponível; nenhum binário ativo ou consumidor é alterado."
invocation: "./gradlew sqliteProbeClasses nativeSqliteProbeCompile; scripts/sqlite-probe.sh\
\ <build>; execução da classe de prova JVM e do binário de build em processos\
\ distintos"
retryOf: null
reconsideration: null
by: "Codex"
createdAt: "2026-11-22T12:10:00.110720Z"
outcome: "CONFIRMED"
observation: "JVM criou e reabriu a base com UTF-8 e rollback. Native Image GraalVM\
\ 25 criou e reabriu em processos independentes com biblioteca externa e extraç\
ão sem escrita; a cópia isolada sem biblioteca falhou."
interpretation: "Driver SQLite JDBC 3.54.1.0 e biblioteca distribuída ao lado do\
\ nativo funcionam na plataforma macOS arm64. Seleção inicial de JDK foi corrigida\
\ explicitamente; sem instalação real."
nextAction: "Implementar infraestrutura transacional e esquema local no TSK-0003."
evidence:
- "ART-0002"
questionsDecision: null
finishedAt: "2026-11-22T12:16:43.109268Z"
finishedBy: "Codex"
documentVersion: 2
---
# Implementar memória de engenharia local em SQLite
## Autoridade e objetivo
Executar a DEC-0001 do WRK-000D, aceita explicitamente por Nilton nesta conversa.
O resultado é um framework local de memória de engenharia por Work, com SQLite
por projeto, investigação e implementação orientadas por OODA, gates preservados,
anexos temporários e retenção mínima. A aprovação desta DEC mantém a instalação
real adiada.
Este Plan foi solicitado com decomposição em vários steps. Todos os steps começam
OPEN; a criação do Plan não constitui execução ou comprovação de resultado.
## Limites obrigatórios
- Não instalar nem substituir o AIE, SQLite, bibliotecas ou atalhos em uso.
- Não executar o instalador real contra HOME, ~/.local/bin ou outro destino ativo.
Sua validação usa fixtures com ferramentas simuladas e destinos descartáveis.
- Não migrar este workspace canônico ou projetos consumidores. Exercitar o novo
backend e a migração em fixtures e cópias descartáveis; ativação real depende de
instrução humana posterior específica.
- Preservar alterações preexistentes, IDs, conteúdo e proveniência legada,
aprovações, evidências históricas e instruções do projeto fora do bloco gerido.
- Não introduzir arquivos em BLOB/base64 ou TEXT equivalente, retenção extensa,
executor autônomo de repositório, colaboração distribuída ou integração Git LFS.
- Importação/exportação de Works/DECs e backup como funcionalidade ficam fora.
A cópia de segurança da migração é parte da recuperação da conversão.
- Código e outputs solicitados permanecem nos destinos de entrega apropriados.
- O WRK-000C permanece aberto para avaliar e tratar latência após esta mudança.
## Execução e dependências
Os 14 steps possuem dependências explícitas e critérios próprios. Mapear primeiro
o contrato e o legado; provar a integração SQLite/JVM/Native Image; depois construir
as transações e migrar os fluxos de domínio. Integrar gates e ciclo dos anexos antes
de consolidar as consultas, a migração pública e o bootstrap. Preparar distribuição
e documentação e concluir com regressão integrada e encaminhamento ao WRK-000C.
Não iniciar um step com dependências pendentes. Verificações focadas fazem parte
de cada mudança; a última etapa integra os cenários e não substitui essas verificações.
Steps independentes podem ser executados em ordem compatível, sem presumir
autorização de delegação ou de instalação real.
## OODA e incertezas
Nas provas relevantes, principalmente driver/nativo, migração e descarte de anexos,
registrar hipótese, critério de sucesso e invocação antes de executar. Registrar
observação, interpretação e próxima ação após o resultado; reconsiderar antes de
repetir uma hipótese falha. Usar os registros de experimentos do Plan quando úteis,
sem impor um ritual de quatro fases a toda alteração.
Ajustar esquema, índices, transações e build dentro da DEC. Se um resultado
questionar a decisão, registrar a preocupação, continuar investigações autorizadas
e rever a DEC com aprovação aplicável antes da execução afetada.
## Verificação e registro mínimo
Durante a execução deste Work, respeitar o protocolo que está em uso. Registrar
resultados reais e evidência mínima necessária para completar os steps; não usar
a futura política de limpeza para apagar evidências legadas ou simular gates.
Verificar continuidade entre processos, integridade referencial, rollback,
concorrência local com espera limitada, autoridade humana, gates e anexos
temporários, migração repetível e operação sem Git. Provas nativas usam somente
artefatos de build e projetos descartáveis.
Comandos candidatos à validação, ajustados ao resultado e ao código final:
- `./gradlew test` e `./gradlew check` para a suíte e arquitetura do projeto.
- `python3 scripts/test-install-native.py` para fixtures do instalador.
- `./gradlew nativeCompile` e tarefas de distribuição para construir o pacote.
- `bash scripts/native-smoke.sh <caminho-absoluto-do-build>` em projetos descartáveis.
Esses comandos são planejados, não executados na criação do Plan. Preservar os
gates específicos do projeto e adicionais do Work definidos na execução. Logs de
trabalho podem ser temporários; guardar na memória somente o necessário ao contrato.
## Conclusão
Todos os steps obrigatórios devem satisfazer seus critérios, com a DEC aceita e
sem experimentos ou preocupações pendentes. A entrega é código, documentação,
pacote preparado e resultados de verificação. Não depende de instalar a nova
versão no ambiente em uso. Encaminhar ao WRK-000C um cenário reproduzível com
comandos, versão, volume e ambiente, sem declarar resolvido o problema de atraso.
@@ -0,0 +1,441 @@
---
schemaVersion: 1
id: "PLN-0001"
workId: "WRK-000D"
title: "Implementar memória de engenharia local em SQLite sem instalação ativa"
decisions:
- "DEC-0001"
steps:
- id: "TSK-0001"
title: "Mapear contrato, dados legados e cenários de migração"
description: "Inspecionar WorkService, serviços de Discussion/Decision/Plan/Agent,\
\ coordenadores e VerificationService. Mapear registros, referências, revisões,\
\ hashes, recibos e bootstrap para tabelas e regras do backend SQLite, preservando\
\ conteúdo e autoridade. Selecionar fixtures existentes de compatibilidade, workflows\
\ e importação como corpus; usar apenas cópias descartáveis. Identificar checks\
\ e pontos de retenção sem realizar benchmark conclusivo do WRK-000C."
acceptanceCriteria:
- "Mapeamento cobre entidades persistidas, IDs locais ao Work, referências, revisõ\
es, aprovações e casos de conclusão legada com hashes/recibos."
- "Corpus representativo e resultados esperados de continuidade/migração estão definidos\
\ antes da conversão, incluindo dados inválidos e estados interrompidos."
- "Limites de instalação, migração de consumidores e preservação do workspace atual\
\ estão explícitos e respeitados."
dependsOn: []
status: "COMPLETED"
result: "Contrato e legado mapeados em docs/sqlite-migration-design.md; corpus e\
\ casos de falha/retry definidos antes da migração. Baseline: 45 testes em seis\
\ classes passaram, hashes congelados conferidos e fontes históricas intactas.\
\ Sem instalação ou migração real."
evidence:
- "ART-0001"
updatedAt: "2026-11-22T12:00:26.700050Z"
- id: "TSK-0002"
title: "Provar driver SQLite em JVM e Native Image"
description: "Avaliar Xerial SQLite JDBC e fixar versão compatível com Java, Gradle\
\ e GraalVM do projeto. Registrar hipótese, critério e invocação antes da prova.\
\ Criar, gravar, ler e reabrir uma base descartável em processos JVM e nativos.\
\ Verificar carregamento da biblioteca distribuída ao lado do nativo; sqlite3\
\ será ferramenta de diagnóstico do pacote. Construir e executar somente artefatos\
\ descartáveis, sem instalação real."
acceptanceCriteria:
- "Driver e versão selecionados demonstram persistência e reabertura em JVM e Native\
\ Image na plataforma alvo."
- "Biblioteca do pacote é encontrada por caminho controlado e não depende acidentalmente\
\ do SQLite global ou de extração repetida não planejada."
- "Hipótese, resultado e limitações da prova estão registrados; instalação ativa\
\ e projetos consumidores não foram alterados."
dependsOn:
- "TSK-0001"
status: "COMPLETED"
result: "Prova JVM e Native Image passou create/read/write/reopen, UTF-8, rollback\
\ e dependência da biblioteca do pacote; sem instalação ativa."
evidence:
- "ART-0002"
updatedAt: "2026-11-22T12:16:52.149066Z"
- id: "TSK-0003"
title: "Implementar esquema, conexões e transações SQLite"
description: "Criar infraestrutura de persistência local em .ai-engineering/aie.db\
\ com esquema versionado, tabelas tipadas, índices e relações. Habilitar integridade\
\ referencial em cada conexão, delimitar unidade transacional por operação coerente\
\ e usar leitura consistente. Definir journal/durabilidade e espera limitada de\
\ escrita com diagnóstico. Preservar limites de módulos; serviços aninhados devem\
\ compartilhar a transação aplicável."
acceptanceCriteria:
- "Esquema e índices atendem ao mapeamento sem BLOB/base64 ou arquivos completos\
\ serializados em TEXT."
- "Falha em operação relacionada causa rollback; referências inválidas são recusadas\
\ e gravações concorrentes têm contenção limitada e diagnóstico útil."
- "Abertura de esquema incompatível é diagnosticada sem alterar dados; teste de\
\ leitura consistente cobre mudanças concorrentes locais."
dependsOn:
- "TSK-0001"
- "TSK-0002"
status: "ACTIVE"
result: "Prosseguir autonomamente para esquema, conexões, transações e concorrê\
ncia local após prova do driver."
evidence: []
updatedAt: "2026-11-22T12:17:01.556543Z"
- id: "TSK-0004"
title: "Persistir Works e investigação no novo backend"
description: "Integrar Work, guidance e histórico de escolhas, discussões, tópicos,\
\ surveys, respostas e disposições à unidade de persistência. Preservar IDs existentes,\
\ semântica dos IDs locais, referências e histórico útil. Consultas selecionadas\
\ devem buscar o Work diretamente. Manter leitura legada delimitada para compatibilidade\
\ e migração; não manter duas fontes autoritativas para a mesma memória."
acceptanceCriteria:
- "Criar e retomar Work/discussão/survey em outro processo preserva conteúdo, histó\
rico de respostas e pendências."
- "Escolhas DIRECT/EXPLORATORY e autoridade humana mantêm as regras existentes,\
\ inclusive ausência de escolha e pedido específico de DEC."
- "Busca por Work e suas referências usa consultas com escopo adequado; alteraçõ\
es e referências relacionadas são transacionais."
dependsOn:
- "TSK-0003"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:52:37.091047Z"
- id: "TSK-0005"
title: "Persistir decisões, planos e experimentos"
description: "Integrar DecisionService e PlanService com revisões, aceitação, supersessã\
o, passos, dependências e experimentos. Preservar os dois ciclos e OODA, a autoridade\
\ de DEC/Plan e a distinção entre aprovação humana e promoção permitida por polí\
tica. Tratar operações que alteram registros relacionados em uma transação, sem\
\ reduzir os checks de domínio."
acceptanceCriteria:
- "Aprovação, revisão e supersessão preservam autoria e referências, sem fabricaç\
ão de aprovação ou edição silenciosa de decisão aceita."
- "Dependências e estados de passos, critérios de experimentos, preocupações com\
\ DEC e replanejamento conservam os bloqueios existentes."
- "Interrupção simulada não publica meia supersessão ou promoção parcial; retomada\
\ em outro processo preserva o contexto."
dependsOn:
- "TSK-0004"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:52:43.954237Z"
- id: "TSK-0006"
title: "Integrar execuções de agentes e coordenação de EPICs"
description: "Persistir RUNs e seus dados operacionais mínimos, idempotência de\
\ requestId, referências aplicadas e diagnóstico. Integrar PlanCoordinator/EpicCoordinator,\
\ políticas e proveniência de conclusão, representando recibos internos como dados\
\ estruturados quando aplicável. Preservar a fronteira do adaptador: propostas\
\ não aprovam DEC, não respondem pelo humano nem executam comandos de repositó\
rio."
acceptanceCriteria:
- "Repetição idempotente de uma solicitação concluída não duplica registros; solicitaç\
ões divergentes e estados interrompidos são diagnosticados."
- "Políticas RESULTS/DECOMPOSITION, delegação, reabertura, propagação e conclusã\
o por Plans preservam autoridade e proveniência."
- "Resultados estruturados necessários permanecem; transporte bruto, ambiente e\
\ logs completos não viram acervo permanente no banco."
dependsOn:
- "TSK-0005"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:52:50.899228Z"
- id: "TSK-0007"
title: "Integrar gates do projeto e adicionais por Work"
description: "Representar gates obrigatórios do projeto e complementos do Work e\
\ conectar seus resultados aos checks e à entrega. Preservar avaliação externa\
\ e condições de qualidade, inclusive anexos exigidos. Registrar identificaçã\
o, procedimento/execução, estado avaliado, momento e resultado mínimo. Alteraç\
ões pertinentes invalidam a aplicação do resultado aos gates afetados; aprovaç\
ão humana não equivale a sucesso técnico."
acceptanceCriteria:
- "Gate obrigatório pendente, falho ou não executado bloqueia a entrega; gates adicionais\
\ do Work são considerados sem dispensar obrigatórios do projeto."
- "Resultados correspondem ao estado realmente avaliado e não satisfazem silenciosamente\
\ um gate após mudança relevante."
- "Checks existentes e anexos necessários continuam exigidos durante avaliação,\
\ sem introduzir executor autônomo ou retenção bruta obrigatória."
dependsOn:
- "TSK-0005"
- "TSK-0006"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:52:58.285586Z"
- id: "TSK-0008"
title: "Implementar anexos temporários e descarte após checks"
description: "Definir ciclo de vida de anexos e arquivos de execução no filesystem.\
\ Publicar arquivos completos, validar e registrar resultados mínimos antes do\
\ descarte; limpar elegíveis ao fim da execução. Proteger anexos ainda usados\
\ por checks pendentes e outputs solicitados. Recuperar falhas entre publicaçã\
o de arquivo, transação no banco e limpeza, distinguindo descarte legítimo de\
\ perda prematura. Não descartar artefatos legados deste workspace."
acceptanceCriteria:
- "Arquivos exigidos permanecem acessíveis até todos os checks dependentes terminarem,\
\ com resultado persistido antes da remoção."
- "Descarte automático preserva outputs solicitados e memória histórica; arquivo\
\ perdido antes da avaliação continua causando falha."
- "Interrupções nos pontos de publicação, registro e limpeza não fabricam sucesso\
\ e permitem recuperação sem remoção de entradas ainda necessárias."
dependsOn:
- "TSK-0007"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:05.800970Z"
- id: "TSK-0009"
title: "Adaptar verificação, status e contexto ao SQLite"
description: "Integrar VerificationService, CompatibilityService e projeções da\
\ CLI ao backend. Montar status, next-actions, context e readiness com consultas\
\ necessárias e resultados reutilizados na invocação; preservar contrato público\
\ quando compatível e informar mudanças. Separar resultado histórico com anexo\
\ descartado legitimamente de validação ativa. Manter diagnóstico de reparo e\
\ ausência de transições de estado em consultas."
acceptanceCriteria:
- "Consultas e contexto em processos novos preservam informações e autoridade e\
\ não promovem, migram ou concluem registros por leitura."
- "Anexos descartados legitimamente não invalidam histórico; corrupção e referê\
ncias ausentes não são tratadas como gates satisfeitos."
- "Caminhos selecionados não repetem varreduras/validações globais sem necessidade;\
\ saída e códigos de erro compatíveis são verificados."
dependsOn:
- "TSK-0004"
- "TSK-0005"
- "TSK-0006"
- "TSK-0008"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:13.390096Z"
- id: "TSK-0010"
title: "Implementar migração explícita e recuperável do legado"
description: "Criar comando público de prévia e aplicação da migração, sem conversã\
o em leituras ou atualização do instalador. Usar base de preparo e cópia de seguranç\
a da conversão, importação tipada transacional e verificação contra o corpus.\
\ Preservar IDs, conteúdo, aprovações, hashes, revisões e proveniência histórica\
\ sem despejar arquivos no banco. Ativar somente após sucesso; repetir ou recuperar\
\ interrupção sem duplicar. Executar apenas em fixtures/cópias descartáveis."
acceptanceCriteria:
- "Prévia não modifica o projeto; aplicação compara registros/contexto e ativa a\
\ base somente após validação completa."
- "Fixtures históricas, recibos, aprovações e referências preservam identidade/proveniê\
ncia; execução repetida não duplica conteúdo."
- "Falhas e interrupções deixam a fonte anterior recuperável e informam próxima\
\ ação; nenhum projeto real ou workspace canônico foi migrado."
dependsOn:
- "TSK-0001"
- "TSK-0009"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:21.074969Z"
- id: "TSK-0011"
title: "Atualizar init, descoberta e contrato de compatibilidade"
description: "Inicializar projetos locais em SQLite e deixar .ai-engineering ignorado\
\ pelo Git por padrão sem exigir Git. Preservar regras preexistentes e instruç\
ões fora do bloco gerido. Declarar backend e versões no contrato público, atualizar\
\ diagnóstico/onboard e evitar que base SQLite seja interpretada como workspace\
\ vazio por combinação incompatível. Manter tratamento explícito de projetos legados\
\ e previamente rastreados."
acceptanceCriteria:
- "Init cria projeto funcional sem Git, com estado local ignorado por padrão e bootstrap\
\ suficiente para humanos e agentes."
- "Reexecução preserva conteúdo/regras; não remove arquivos já rastreados nem converte\
\ legado automaticamente."
- "Versões e backend incompatíveis são recusados com diagnóstico acionável antes\
\ de escrita; documentação/entrypoints não induzem uso de CLI incompatível."
dependsOn:
- "TSK-0009"
- "TSK-0010"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:28.841960Z"
- id: "TSK-0012"
title: "Preparar pacote nativo e instalador conjunto sem ativação"
description: "Evoluir build/distribuição e scripts/install-native.sh para empacotar\
\ AIE nativo, biblioteca SQLite do driver e CLI sqlite3 num diretório configurá\
vel, com atalhos aie/ai-engineering e dados de projeto separados. Fixar componentes/plataformas\
\ e verificar pacote antes de ativação, preservando versão anterior em falhas.\
\ Testar instalador com ferramentas simuladas e destinos descartáveis; smoke usa\
\ build local. Não executar instalação real nem tocar ~/.local/bin ou dependê\
ncias ativas."
acceptanceCriteria:
- "Pacote contém componentes corretos e o build nativo acessa uma base descartá\
vel sem depender da instalação global."
- "Fixtures verificam diretórios configuráveis, atalhos, atualização conjunta e\
\ falha sem danificar instalação anterior simulada."
- "Nenhum binário, biblioteca ou atalho ativo é substituído e o instalador real\
\ não é executado; a ativação posterior continua dependente de instrução humana."
dependsOn:
- "TSK-0002"
- "TSK-0011"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:37.290314Z"
- id: "TSK-0013"
title: "Consolidar documentação e instruções do framework local"
description: "Atualizar README, docs de arquitetura/protocolo/compatibilidade/migraç\
ão e recursos de entrada para memória local, SQLite, gates e retenção mínima.\
\ Explicar anexos temporários, outputs entregues, migração explícita e recuperaç\
ão, pacote preparado e instalação adiada. Remover instruções que apresentem arquivos\
\ de Works como fonte principal nova ou Git como exigência. Preservar orientaç\
ões dos dois ciclos, OODA, DEC/Plan e aprovações."
acceptanceCriteria:
- "Documentação e recursos distribuídos descrevem o mesmo contrato e permitem inicializar/retomar\
\ um projeto sem Git."
- "Procedimento público de migração explica prévia, efeitos e recuperação sem depender\
\ de inspeção do código interno."
- "Limites de retenção e instalação, papel dos gates e recortes futuros estão claros;\
\ fontes e exemplos não alegam testes ou migrações reais não executados."
dependsOn:
- "TSK-0010"
- "TSK-0011"
- "TSK-0012"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:45.331995Z"
- id: "TSK-0014"
title: "Executar regressão integrada e encaminhar responsividade ao WRK-000C"
description: "Integrar as verificações das etapas e executar gates apropriados de\
\ testes/arquitetura, migração, concorrência e smoke JVM/nativo em ambientes descartá\
veis. Revisar continuidade e autoridade nos dois ciclos, anexos temporários, recuperaç\
ão e funcionamento sem Git. Consolidar resultados mínimos, resolver experimentos/preocupaç\
ões e entregar cenário reproduzível ao WRK-000C com comandos, versão, dados e\
\ ambiente. Não instalar o pacote nem declarar resolvido o atraso."
acceptanceCriteria:
- "Suíte relevante de domínio/integração/compatibilidade, fixtures do instalador\
\ e smoke nativo passam ou impedimentos são tratados antes da conclusão."
- "Falhas, rollback, concorrência, legado, gates e descarte legítimo foram verificados\
\ com resultados reais e sem alteração da instalação ativa ou consumidores."
- "Todos os steps e critérios da DEC estão satisfeitos, sem experimentos/preocupaç\
ões pendentes; WRK-000C recebe cenário para medição futura e permanece aberto."
dependsOn:
- "TSK-0013"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:53.421052Z"
status: "ACTIVE"
author: "Codex"
createdAt: "2026-11-22T11:52:06.993736Z"
revision: 23
previousHash: "7216bae64f3ae85841087a46e8e067ffe00ae38e016e0917135c87f806e6cfee"
updatedAt: "2026-11-22T12:17:01.556708Z"
updatedBy: "Codex"
changeReason: "Prosseguir autonomamente para esquema, conexões, transações e concorrê\
ncia local após prova do driver."
experiments:
- id: "EXP-0001"
stepId: "TSK-0002"
hypothesis: "SQLite JDBC pode criar, persistir e reabrir uma base em processos JVM\
\ e Native Image com biblioteca distribuída ao lado do executável."
successCriterion: "As duas formas executam create/read/write/reopen e rollback em\
\ diretório descartável; o nativo usa a biblioteca do pacote com extração temporá\
ria indisponível; nenhum binário ativo ou consumidor é alterado."
invocation: "./gradlew sqliteProbeClasses nativeSqliteProbeCompile; scripts/sqlite-probe.sh\
\ <build>; execução da classe de prova JVM e do binário de build em processos\
\ distintos"
retryOf: null
reconsideration: null
by: "Codex"
createdAt: "2026-11-22T12:10:00.110720Z"
outcome: "CONFIRMED"
observation: "JVM criou e reabriu a base com UTF-8 e rollback. Native Image GraalVM\
\ 25 criou e reabriu em processos independentes com biblioteca externa e extraç\
ão sem escrita; a cópia isolada sem biblioteca falhou."
interpretation: "Driver SQLite JDBC 3.54.1.0 e biblioteca distribuída ao lado do\
\ nativo funcionam na plataforma macOS arm64. Seleção inicial de JDK foi corrigida\
\ explicitamente; sem instalação real."
nextAction: "Implementar infraestrutura transacional e esquema local no TSK-0003."
evidence:
- "ART-0002"
questionsDecision: null
finishedAt: "2026-11-22T12:16:43.109268Z"
finishedBy: "Codex"
documentVersion: 2
---
# Implementar memória de engenharia local em SQLite
## Autoridade e objetivo
Executar a DEC-0001 do WRK-000D, aceita explicitamente por Nilton nesta conversa.
O resultado é um framework local de memória de engenharia por Work, com SQLite
por projeto, investigação e implementação orientadas por OODA, gates preservados,
anexos temporários e retenção mínima. A aprovação desta DEC mantém a instalação
real adiada.
Este Plan foi solicitado com decomposição em vários steps. Todos os steps começam
OPEN; a criação do Plan não constitui execução ou comprovação de resultado.
## Limites obrigatórios
- Não instalar nem substituir o AIE, SQLite, bibliotecas ou atalhos em uso.
- Não executar o instalador real contra HOME, ~/.local/bin ou outro destino ativo.
Sua validação usa fixtures com ferramentas simuladas e destinos descartáveis.
- Não migrar este workspace canônico ou projetos consumidores. Exercitar o novo
backend e a migração em fixtures e cópias descartáveis; ativação real depende de
instrução humana posterior específica.
- Preservar alterações preexistentes, IDs, conteúdo e proveniência legada,
aprovações, evidências históricas e instruções do projeto fora do bloco gerido.
- Não introduzir arquivos em BLOB/base64 ou TEXT equivalente, retenção extensa,
executor autônomo de repositório, colaboração distribuída ou integração Git LFS.
- Importação/exportação de Works/DECs e backup como funcionalidade ficam fora.
A cópia de segurança da migração é parte da recuperação da conversão.
- Código e outputs solicitados permanecem nos destinos de entrega apropriados.
- O WRK-000C permanece aberto para avaliar e tratar latência após esta mudança.
## Execução e dependências
Os 14 steps possuem dependências explícitas e critérios próprios. Mapear primeiro
o contrato e o legado; provar a integração SQLite/JVM/Native Image; depois construir
as transações e migrar os fluxos de domínio. Integrar gates e ciclo dos anexos antes
de consolidar as consultas, a migração pública e o bootstrap. Preparar distribuição
e documentação e concluir com regressão integrada e encaminhamento ao WRK-000C.
Não iniciar um step com dependências pendentes. Verificações focadas fazem parte
de cada mudança; a última etapa integra os cenários e não substitui essas verificações.
Steps independentes podem ser executados em ordem compatível, sem presumir
autorização de delegação ou de instalação real.
## OODA e incertezas
Nas provas relevantes, principalmente driver/nativo, migração e descarte de anexos,
registrar hipótese, critério de sucesso e invocação antes de executar. Registrar
observação, interpretação e próxima ação após o resultado; reconsiderar antes de
repetir uma hipótese falha. Usar os registros de experimentos do Plan quando úteis,
sem impor um ritual de quatro fases a toda alteração.
Ajustar esquema, índices, transações e build dentro da DEC. Se um resultado
questionar a decisão, registrar a preocupação, continuar investigações autorizadas
e rever a DEC com aprovação aplicável antes da execução afetada.
## Verificação e registro mínimo
Durante a execução deste Work, respeitar o protocolo que está em uso. Registrar
resultados reais e evidência mínima necessária para completar os steps; não usar
a futura política de limpeza para apagar evidências legadas ou simular gates.
Verificar continuidade entre processos, integridade referencial, rollback,
concorrência local com espera limitada, autoridade humana, gates e anexos
temporários, migração repetível e operação sem Git. Provas nativas usam somente
artefatos de build e projetos descartáveis.
Comandos candidatos à validação, ajustados ao resultado e ao código final:
- `./gradlew test` e `./gradlew check` para a suíte e arquitetura do projeto.
- `python3 scripts/test-install-native.py` para fixtures do instalador.
- `./gradlew nativeCompile` e tarefas de distribuição para construir o pacote.
- `bash scripts/native-smoke.sh <caminho-absoluto-do-build>` em projetos descartáveis.
Esses comandos são planejados, não executados na criação do Plan. Preservar os
gates específicos do projeto e adicionais do Work definidos na execução. Logs de
trabalho podem ser temporários; guardar na memória somente o necessário ao contrato.
## Conclusão
Todos os steps obrigatórios devem satisfazer seus critérios, com a DEC aceita e
sem experimentos ou preocupações pendentes. A entrega é código, documentação,
pacote preparado e resultados de verificação. Não depende de instalar a nova
versão no ambiente em uso. Encaminhar ao WRK-000C um cenário reproduzível com
comandos, versão, volume e ambiente, sem declarar resolvido o problema de atraso.
@@ -0,0 +1,444 @@
---
schemaVersion: 1
id: "PLN-0001"
workId: "WRK-000D"
title: "Implementar memória de engenharia local em SQLite sem instalação ativa"
decisions:
- "DEC-0001"
steps:
- id: "TSK-0001"
title: "Mapear contrato, dados legados e cenários de migração"
description: "Inspecionar WorkService, serviços de Discussion/Decision/Plan/Agent,\
\ coordenadores e VerificationService. Mapear registros, referências, revisões,\
\ hashes, recibos e bootstrap para tabelas e regras do backend SQLite, preservando\
\ conteúdo e autoridade. Selecionar fixtures existentes de compatibilidade, workflows\
\ e importação como corpus; usar apenas cópias descartáveis. Identificar checks\
\ e pontos de retenção sem realizar benchmark conclusivo do WRK-000C."
acceptanceCriteria:
- "Mapeamento cobre entidades persistidas, IDs locais ao Work, referências, revisõ\
es, aprovações e casos de conclusão legada com hashes/recibos."
- "Corpus representativo e resultados esperados de continuidade/migração estão definidos\
\ antes da conversão, incluindo dados inválidos e estados interrompidos."
- "Limites de instalação, migração de consumidores e preservação do workspace atual\
\ estão explícitos e respeitados."
dependsOn: []
status: "COMPLETED"
result: "Contrato e legado mapeados em docs/sqlite-migration-design.md; corpus e\
\ casos de falha/retry definidos antes da migração. Baseline: 45 testes em seis\
\ classes passaram, hashes congelados conferidos e fontes históricas intactas.\
\ Sem instalação ou migração real."
evidence:
- "ART-0001"
updatedAt: "2026-11-22T12:00:26.700050Z"
- id: "TSK-0002"
title: "Provar driver SQLite em JVM e Native Image"
description: "Avaliar Xerial SQLite JDBC e fixar versão compatível com Java, Gradle\
\ e GraalVM do projeto. Registrar hipótese, critério e invocação antes da prova.\
\ Criar, gravar, ler e reabrir uma base descartável em processos JVM e nativos.\
\ Verificar carregamento da biblioteca distribuída ao lado do nativo; sqlite3\
\ será ferramenta de diagnóstico do pacote. Construir e executar somente artefatos\
\ descartáveis, sem instalação real."
acceptanceCriteria:
- "Driver e versão selecionados demonstram persistência e reabertura em JVM e Native\
\ Image na plataforma alvo."
- "Biblioteca do pacote é encontrada por caminho controlado e não depende acidentalmente\
\ do SQLite global ou de extração repetida não planejada."
- "Hipótese, resultado e limitações da prova estão registrados; instalação ativa\
\ e projetos consumidores não foram alterados."
dependsOn:
- "TSK-0001"
status: "COMPLETED"
result: "Prova JVM e Native Image passou create/read/write/reopen, UTF-8, rollback\
\ e dependência da biblioteca do pacote; sem instalação ativa."
evidence:
- "ART-0002"
updatedAt: "2026-11-22T12:16:52.149066Z"
- id: "TSK-0003"
title: "Implementar esquema, conexões e transações SQLite"
description: "Criar infraestrutura de persistência local em .ai-engineering/aie.db\
\ com esquema versionado, tabelas tipadas, índices e relações. Habilitar integridade\
\ referencial em cada conexão, delimitar unidade transacional por operação coerente\
\ e usar leitura consistente. Definir journal/durabilidade e espera limitada de\
\ escrita com diagnóstico. Preservar limites de módulos; serviços aninhados devem\
\ compartilhar a transação aplicável."
acceptanceCriteria:
- "Esquema e índices atendem ao mapeamento sem BLOB/base64 ou arquivos completos\
\ serializados em TEXT."
- "Falha em operação relacionada causa rollback; referências inválidas são recusadas\
\ e gravações concorrentes têm contenção limitada e diagnóstico útil."
- "Abertura de esquema incompatível é diagnosticada sem alterar dados; teste de\
\ leitura consistente cobre mudanças concorrentes locais."
dependsOn:
- "TSK-0001"
- "TSK-0002"
status: "COMPLETED"
result: "Infraestrutura SQLite validada: 12 testes de transação/integridade/concorrê\
ncia e arquitetura passaram; schema também criado e reaberto pelo Native Image.\
\ CLI de domínio e instalação ativa continuam intactos."
evidence:
- "ART-0003"
updatedAt: "2026-11-22T12:26:10.846492Z"
- id: "TSK-0004"
title: "Persistir Works e investigação no novo backend"
description: "Integrar Work, guidance e histórico de escolhas, discussões, tópicos,\
\ surveys, respostas e disposições à unidade de persistência. Preservar IDs existentes,\
\ semântica dos IDs locais, referências e histórico útil. Consultas selecionadas\
\ devem buscar o Work diretamente. Manter leitura legada delimitada para compatibilidade\
\ e migração; não manter duas fontes autoritativas para a mesma memória."
acceptanceCriteria:
- "Criar e retomar Work/discussão/survey em outro processo preserva conteúdo, histó\
rico de respostas e pendências."
- "Escolhas DIRECT/EXPLORATORY e autoridade humana mantêm as regras existentes,\
\ inclusive ausência de escolha e pedido específico de DEC."
- "Busca por Work e suas referências usa consultas com escopo adequado; alteraçõ\
es e referências relacionadas são transacionais."
dependsOn:
- "TSK-0003"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:52:37.091047Z"
- id: "TSK-0005"
title: "Persistir decisões, planos e experimentos"
description: "Integrar DecisionService e PlanService com revisões, aceitação, supersessã\
o, passos, dependências e experimentos. Preservar os dois ciclos e OODA, a autoridade\
\ de DEC/Plan e a distinção entre aprovação humana e promoção permitida por polí\
tica. Tratar operações que alteram registros relacionados em uma transação, sem\
\ reduzir os checks de domínio."
acceptanceCriteria:
- "Aprovação, revisão e supersessão preservam autoria e referências, sem fabricaç\
ão de aprovação ou edição silenciosa de decisão aceita."
- "Dependências e estados de passos, critérios de experimentos, preocupações com\
\ DEC e replanejamento conservam os bloqueios existentes."
- "Interrupção simulada não publica meia supersessão ou promoção parcial; retomada\
\ em outro processo preserva o contexto."
dependsOn:
- "TSK-0004"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:52:43.954237Z"
- id: "TSK-0006"
title: "Integrar execuções de agentes e coordenação de EPICs"
description: "Persistir RUNs e seus dados operacionais mínimos, idempotência de\
\ requestId, referências aplicadas e diagnóstico. Integrar PlanCoordinator/EpicCoordinator,\
\ políticas e proveniência de conclusão, representando recibos internos como dados\
\ estruturados quando aplicável. Preservar a fronteira do adaptador: propostas\
\ não aprovam DEC, não respondem pelo humano nem executam comandos de repositó\
rio."
acceptanceCriteria:
- "Repetição idempotente de uma solicitação concluída não duplica registros; solicitaç\
ões divergentes e estados interrompidos são diagnosticados."
- "Políticas RESULTS/DECOMPOSITION, delegação, reabertura, propagação e conclusã\
o por Plans preservam autoridade e proveniência."
- "Resultados estruturados necessários permanecem; transporte bruto, ambiente e\
\ logs completos não viram acervo permanente no banco."
dependsOn:
- "TSK-0005"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:52:50.899228Z"
- id: "TSK-0007"
title: "Integrar gates do projeto e adicionais por Work"
description: "Representar gates obrigatórios do projeto e complementos do Work e\
\ conectar seus resultados aos checks e à entrega. Preservar avaliação externa\
\ e condições de qualidade, inclusive anexos exigidos. Registrar identificaçã\
o, procedimento/execução, estado avaliado, momento e resultado mínimo. Alteraç\
ões pertinentes invalidam a aplicação do resultado aos gates afetados; aprovaç\
ão humana não equivale a sucesso técnico."
acceptanceCriteria:
- "Gate obrigatório pendente, falho ou não executado bloqueia a entrega; gates adicionais\
\ do Work são considerados sem dispensar obrigatórios do projeto."
- "Resultados correspondem ao estado realmente avaliado e não satisfazem silenciosamente\
\ um gate após mudança relevante."
- "Checks existentes e anexos necessários continuam exigidos durante avaliação,\
\ sem introduzir executor autônomo ou retenção bruta obrigatória."
dependsOn:
- "TSK-0005"
- "TSK-0006"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:52:58.285586Z"
- id: "TSK-0008"
title: "Implementar anexos temporários e descarte após checks"
description: "Definir ciclo de vida de anexos e arquivos de execução no filesystem.\
\ Publicar arquivos completos, validar e registrar resultados mínimos antes do\
\ descarte; limpar elegíveis ao fim da execução. Proteger anexos ainda usados\
\ por checks pendentes e outputs solicitados. Recuperar falhas entre publicaçã\
o de arquivo, transação no banco e limpeza, distinguindo descarte legítimo de\
\ perda prematura. Não descartar artefatos legados deste workspace."
acceptanceCriteria:
- "Arquivos exigidos permanecem acessíveis até todos os checks dependentes terminarem,\
\ com resultado persistido antes da remoção."
- "Descarte automático preserva outputs solicitados e memória histórica; arquivo\
\ perdido antes da avaliação continua causando falha."
- "Interrupções nos pontos de publicação, registro e limpeza não fabricam sucesso\
\ e permitem recuperação sem remoção de entradas ainda necessárias."
dependsOn:
- "TSK-0007"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:05.800970Z"
- id: "TSK-0009"
title: "Adaptar verificação, status e contexto ao SQLite"
description: "Integrar VerificationService, CompatibilityService e projeções da\
\ CLI ao backend. Montar status, next-actions, context e readiness com consultas\
\ necessárias e resultados reutilizados na invocação; preservar contrato público\
\ quando compatível e informar mudanças. Separar resultado histórico com anexo\
\ descartado legitimamente de validação ativa. Manter diagnóstico de reparo e\
\ ausência de transições de estado em consultas."
acceptanceCriteria:
- "Consultas e contexto em processos novos preservam informações e autoridade e\
\ não promovem, migram ou concluem registros por leitura."
- "Anexos descartados legitimamente não invalidam histórico; corrupção e referê\
ncias ausentes não são tratadas como gates satisfeitos."
- "Caminhos selecionados não repetem varreduras/validações globais sem necessidade;\
\ saída e códigos de erro compatíveis são verificados."
dependsOn:
- "TSK-0004"
- "TSK-0005"
- "TSK-0006"
- "TSK-0008"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:13.390096Z"
- id: "TSK-0010"
title: "Implementar migração explícita e recuperável do legado"
description: "Criar comando público de prévia e aplicação da migração, sem conversã\
o em leituras ou atualização do instalador. Usar base de preparo e cópia de seguranç\
a da conversão, importação tipada transacional e verificação contra o corpus.\
\ Preservar IDs, conteúdo, aprovações, hashes, revisões e proveniência histórica\
\ sem despejar arquivos no banco. Ativar somente após sucesso; repetir ou recuperar\
\ interrupção sem duplicar. Executar apenas em fixtures/cópias descartáveis."
acceptanceCriteria:
- "Prévia não modifica o projeto; aplicação compara registros/contexto e ativa a\
\ base somente após validação completa."
- "Fixtures históricas, recibos, aprovações e referências preservam identidade/proveniê\
ncia; execução repetida não duplica conteúdo."
- "Falhas e interrupções deixam a fonte anterior recuperável e informam próxima\
\ ação; nenhum projeto real ou workspace canônico foi migrado."
dependsOn:
- "TSK-0001"
- "TSK-0009"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:21.074969Z"
- id: "TSK-0011"
title: "Atualizar init, descoberta e contrato de compatibilidade"
description: "Inicializar projetos locais em SQLite e deixar .ai-engineering ignorado\
\ pelo Git por padrão sem exigir Git. Preservar regras preexistentes e instruç\
ões fora do bloco gerido. Declarar backend e versões no contrato público, atualizar\
\ diagnóstico/onboard e evitar que base SQLite seja interpretada como workspace\
\ vazio por combinação incompatível. Manter tratamento explícito de projetos legados\
\ e previamente rastreados."
acceptanceCriteria:
- "Init cria projeto funcional sem Git, com estado local ignorado por padrão e bootstrap\
\ suficiente para humanos e agentes."
- "Reexecução preserva conteúdo/regras; não remove arquivos já rastreados nem converte\
\ legado automaticamente."
- "Versões e backend incompatíveis são recusados com diagnóstico acionável antes\
\ de escrita; documentação/entrypoints não induzem uso de CLI incompatível."
dependsOn:
- "TSK-0009"
- "TSK-0010"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:28.841960Z"
- id: "TSK-0012"
title: "Preparar pacote nativo e instalador conjunto sem ativação"
description: "Evoluir build/distribuição e scripts/install-native.sh para empacotar\
\ AIE nativo, biblioteca SQLite do driver e CLI sqlite3 num diretório configurá\
vel, com atalhos aie/ai-engineering e dados de projeto separados. Fixar componentes/plataformas\
\ e verificar pacote antes de ativação, preservando versão anterior em falhas.\
\ Testar instalador com ferramentas simuladas e destinos descartáveis; smoke usa\
\ build local. Não executar instalação real nem tocar ~/.local/bin ou dependê\
ncias ativas."
acceptanceCriteria:
- "Pacote contém componentes corretos e o build nativo acessa uma base descartá\
vel sem depender da instalação global."
- "Fixtures verificam diretórios configuráveis, atalhos, atualização conjunta e\
\ falha sem danificar instalação anterior simulada."
- "Nenhum binário, biblioteca ou atalho ativo é substituído e o instalador real\
\ não é executado; a ativação posterior continua dependente de instrução humana."
dependsOn:
- "TSK-0002"
- "TSK-0011"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:37.290314Z"
- id: "TSK-0013"
title: "Consolidar documentação e instruções do framework local"
description: "Atualizar README, docs de arquitetura/protocolo/compatibilidade/migraç\
ão e recursos de entrada para memória local, SQLite, gates e retenção mínima.\
\ Explicar anexos temporários, outputs entregues, migração explícita e recuperaç\
ão, pacote preparado e instalação adiada. Remover instruções que apresentem arquivos\
\ de Works como fonte principal nova ou Git como exigência. Preservar orientaç\
ões dos dois ciclos, OODA, DEC/Plan e aprovações."
acceptanceCriteria:
- "Documentação e recursos distribuídos descrevem o mesmo contrato e permitem inicializar/retomar\
\ um projeto sem Git."
- "Procedimento público de migração explica prévia, efeitos e recuperação sem depender\
\ de inspeção do código interno."
- "Limites de retenção e instalação, papel dos gates e recortes futuros estão claros;\
\ fontes e exemplos não alegam testes ou migrações reais não executados."
dependsOn:
- "TSK-0010"
- "TSK-0011"
- "TSK-0012"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:45.331995Z"
- id: "TSK-0014"
title: "Executar regressão integrada e encaminhar responsividade ao WRK-000C"
description: "Integrar as verificações das etapas e executar gates apropriados de\
\ testes/arquitetura, migração, concorrência e smoke JVM/nativo em ambientes descartá\
veis. Revisar continuidade e autoridade nos dois ciclos, anexos temporários, recuperaç\
ão e funcionamento sem Git. Consolidar resultados mínimos, resolver experimentos/preocupaç\
ões e entregar cenário reproduzível ao WRK-000C com comandos, versão, dados e\
\ ambiente. Não instalar o pacote nem declarar resolvido o atraso."
acceptanceCriteria:
- "Suíte relevante de domínio/integração/compatibilidade, fixtures do instalador\
\ e smoke nativo passam ou impedimentos são tratados antes da conclusão."
- "Falhas, rollback, concorrência, legado, gates e descarte legítimo foram verificados\
\ com resultados reais e sem alteração da instalação ativa ou consumidores."
- "Todos os steps e critérios da DEC estão satisfeitos, sem experimentos/preocupaç\
ões pendentes; WRK-000C recebe cenário para medição futura e permanece aberto."
dependsOn:
- "TSK-0013"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:53.421052Z"
status: "ACTIVE"
author: "Codex"
createdAt: "2026-11-22T11:52:06.993736Z"
revision: 24
previousHash: "78d801b18317e63d5f244299d6cbd35f979058af6284a4df6dc0f626beb03b46"
updatedAt: "2026-11-22T12:26:10.846699Z"
updatedBy: "Codex"
changeReason: "Infraestrutura SQLite validada: 12 testes de transação/integridade/concorrê\
ncia e arquitetura passaram; schema também criado e reaberto pelo Native Image.\
\ CLI de domínio e instalação ativa continuam intactos."
experiments:
- id: "EXP-0001"
stepId: "TSK-0002"
hypothesis: "SQLite JDBC pode criar, persistir e reabrir uma base em processos JVM\
\ e Native Image com biblioteca distribuída ao lado do executável."
successCriterion: "As duas formas executam create/read/write/reopen e rollback em\
\ diretório descartável; o nativo usa a biblioteca do pacote com extração temporá\
ria indisponível; nenhum binário ativo ou consumidor é alterado."
invocation: "./gradlew sqliteProbeClasses nativeSqliteProbeCompile; scripts/sqlite-probe.sh\
\ <build>; execução da classe de prova JVM e do binário de build em processos\
\ distintos"
retryOf: null
reconsideration: null
by: "Codex"
createdAt: "2026-11-22T12:10:00.110720Z"
outcome: "CONFIRMED"
observation: "JVM criou e reabriu a base com UTF-8 e rollback. Native Image GraalVM\
\ 25 criou e reabriu em processos independentes com biblioteca externa e extraç\
ão sem escrita; a cópia isolada sem biblioteca falhou."
interpretation: "Driver SQLite JDBC 3.54.1.0 e biblioteca distribuída ao lado do\
\ nativo funcionam na plataforma macOS arm64. Seleção inicial de JDK foi corrigida\
\ explicitamente; sem instalação real."
nextAction: "Implementar infraestrutura transacional e esquema local no TSK-0003."
evidence:
- "ART-0002"
questionsDecision: null
finishedAt: "2026-11-22T12:16:43.109268Z"
finishedBy: "Codex"
documentVersion: 2
---
# Implementar memória de engenharia local em SQLite
## Autoridade e objetivo
Executar a DEC-0001 do WRK-000D, aceita explicitamente por Nilton nesta conversa.
O resultado é um framework local de memória de engenharia por Work, com SQLite
por projeto, investigação e implementação orientadas por OODA, gates preservados,
anexos temporários e retenção mínima. A aprovação desta DEC mantém a instalação
real adiada.
Este Plan foi solicitado com decomposição em vários steps. Todos os steps começam
OPEN; a criação do Plan não constitui execução ou comprovação de resultado.
## Limites obrigatórios
- Não instalar nem substituir o AIE, SQLite, bibliotecas ou atalhos em uso.
- Não executar o instalador real contra HOME, ~/.local/bin ou outro destino ativo.
Sua validação usa fixtures com ferramentas simuladas e destinos descartáveis.
- Não migrar este workspace canônico ou projetos consumidores. Exercitar o novo
backend e a migração em fixtures e cópias descartáveis; ativação real depende de
instrução humana posterior específica.
- Preservar alterações preexistentes, IDs, conteúdo e proveniência legada,
aprovações, evidências históricas e instruções do projeto fora do bloco gerido.
- Não introduzir arquivos em BLOB/base64 ou TEXT equivalente, retenção extensa,
executor autônomo de repositório, colaboração distribuída ou integração Git LFS.
- Importação/exportação de Works/DECs e backup como funcionalidade ficam fora.
A cópia de segurança da migração é parte da recuperação da conversão.
- Código e outputs solicitados permanecem nos destinos de entrega apropriados.
- O WRK-000C permanece aberto para avaliar e tratar latência após esta mudança.
## Execução e dependências
Os 14 steps possuem dependências explícitas e critérios próprios. Mapear primeiro
o contrato e o legado; provar a integração SQLite/JVM/Native Image; depois construir
as transações e migrar os fluxos de domínio. Integrar gates e ciclo dos anexos antes
de consolidar as consultas, a migração pública e o bootstrap. Preparar distribuição
e documentação e concluir com regressão integrada e encaminhamento ao WRK-000C.
Não iniciar um step com dependências pendentes. Verificações focadas fazem parte
de cada mudança; a última etapa integra os cenários e não substitui essas verificações.
Steps independentes podem ser executados em ordem compatível, sem presumir
autorização de delegação ou de instalação real.
## OODA e incertezas
Nas provas relevantes, principalmente driver/nativo, migração e descarte de anexos,
registrar hipótese, critério de sucesso e invocação antes de executar. Registrar
observação, interpretação e próxima ação após o resultado; reconsiderar antes de
repetir uma hipótese falha. Usar os registros de experimentos do Plan quando úteis,
sem impor um ritual de quatro fases a toda alteração.
Ajustar esquema, índices, transações e build dentro da DEC. Se um resultado
questionar a decisão, registrar a preocupação, continuar investigações autorizadas
e rever a DEC com aprovação aplicável antes da execução afetada.
## Verificação e registro mínimo
Durante a execução deste Work, respeitar o protocolo que está em uso. Registrar
resultados reais e evidência mínima necessária para completar os steps; não usar
a futura política de limpeza para apagar evidências legadas ou simular gates.
Verificar continuidade entre processos, integridade referencial, rollback,
concorrência local com espera limitada, autoridade humana, gates e anexos
temporários, migração repetível e operação sem Git. Provas nativas usam somente
artefatos de build e projetos descartáveis.
Comandos candidatos à validação, ajustados ao resultado e ao código final:
- `./gradlew test` e `./gradlew check` para a suíte e arquitetura do projeto.
- `python3 scripts/test-install-native.py` para fixtures do instalador.
- `./gradlew nativeCompile` e tarefas de distribuição para construir o pacote.
- `bash scripts/native-smoke.sh <caminho-absoluto-do-build>` em projetos descartáveis.
Esses comandos são planejados, não executados na criação do Plan. Preservar os
gates específicos do projeto e adicionais do Work definidos na execução. Logs de
trabalho podem ser temporários; guardar na memória somente o necessário ao contrato.
## Conclusão
Todos os steps obrigatórios devem satisfazer seus critérios, com a DEC aceita e
sem experimentos ou preocupações pendentes. A entrega é código, documentação,
pacote preparado e resultados de verificação. Não depende de instalar a nova
versão no ambiente em uso. Encaminhar ao WRK-000C um cenário reproduzível com
comandos, versão, volume e ambiente, sem declarar resolvido o problema de atraso.
@@ -0,0 +1,444 @@
---
schemaVersion: 1
id: "PLN-0001"
workId: "WRK-000D"
title: "Implementar memória de engenharia local em SQLite sem instalação ativa"
decisions:
- "DEC-0001"
steps:
- id: "TSK-0001"
title: "Mapear contrato, dados legados e cenários de migração"
description: "Inspecionar WorkService, serviços de Discussion/Decision/Plan/Agent,\
\ coordenadores e VerificationService. Mapear registros, referências, revisões,\
\ hashes, recibos e bootstrap para tabelas e regras do backend SQLite, preservando\
\ conteúdo e autoridade. Selecionar fixtures existentes de compatibilidade, workflows\
\ e importação como corpus; usar apenas cópias descartáveis. Identificar checks\
\ e pontos de retenção sem realizar benchmark conclusivo do WRK-000C."
acceptanceCriteria:
- "Mapeamento cobre entidades persistidas, IDs locais ao Work, referências, revisõ\
es, aprovações e casos de conclusão legada com hashes/recibos."
- "Corpus representativo e resultados esperados de continuidade/migração estão definidos\
\ antes da conversão, incluindo dados inválidos e estados interrompidos."
- "Limites de instalação, migração de consumidores e preservação do workspace atual\
\ estão explícitos e respeitados."
dependsOn: []
status: "COMPLETED"
result: "Contrato e legado mapeados em docs/sqlite-migration-design.md; corpus e\
\ casos de falha/retry definidos antes da migração. Baseline: 45 testes em seis\
\ classes passaram, hashes congelados conferidos e fontes históricas intactas.\
\ Sem instalação ou migração real."
evidence:
- "ART-0001"
updatedAt: "2026-11-22T12:00:26.700050Z"
- id: "TSK-0002"
title: "Provar driver SQLite em JVM e Native Image"
description: "Avaliar Xerial SQLite JDBC e fixar versão compatível com Java, Gradle\
\ e GraalVM do projeto. Registrar hipótese, critério e invocação antes da prova.\
\ Criar, gravar, ler e reabrir uma base descartável em processos JVM e nativos.\
\ Verificar carregamento da biblioteca distribuída ao lado do nativo; sqlite3\
\ será ferramenta de diagnóstico do pacote. Construir e executar somente artefatos\
\ descartáveis, sem instalação real."
acceptanceCriteria:
- "Driver e versão selecionados demonstram persistência e reabertura em JVM e Native\
\ Image na plataforma alvo."
- "Biblioteca do pacote é encontrada por caminho controlado e não depende acidentalmente\
\ do SQLite global ou de extração repetida não planejada."
- "Hipótese, resultado e limitações da prova estão registrados; instalação ativa\
\ e projetos consumidores não foram alterados."
dependsOn:
- "TSK-0001"
status: "COMPLETED"
result: "Prova JVM e Native Image passou create/read/write/reopen, UTF-8, rollback\
\ e dependência da biblioteca do pacote; sem instalação ativa."
evidence:
- "ART-0002"
updatedAt: "2026-11-22T12:16:52.149066Z"
- id: "TSK-0003"
title: "Implementar esquema, conexões e transações SQLite"
description: "Criar infraestrutura de persistência local em .ai-engineering/aie.db\
\ com esquema versionado, tabelas tipadas, índices e relações. Habilitar integridade\
\ referencial em cada conexão, delimitar unidade transacional por operação coerente\
\ e usar leitura consistente. Definir journal/durabilidade e espera limitada de\
\ escrita com diagnóstico. Preservar limites de módulos; serviços aninhados devem\
\ compartilhar a transação aplicável."
acceptanceCriteria:
- "Esquema e índices atendem ao mapeamento sem BLOB/base64 ou arquivos completos\
\ serializados em TEXT."
- "Falha em operação relacionada causa rollback; referências inválidas são recusadas\
\ e gravações concorrentes têm contenção limitada e diagnóstico útil."
- "Abertura de esquema incompatível é diagnosticada sem alterar dados; teste de\
\ leitura consistente cobre mudanças concorrentes locais."
dependsOn:
- "TSK-0001"
- "TSK-0002"
status: "COMPLETED"
result: "Infraestrutura SQLite validada: 12 testes de transação/integridade/concorrê\
ncia e arquitetura passaram; schema também criado e reaberto pelo Native Image.\
\ CLI de domínio e instalação ativa continuam intactos."
evidence:
- "ART-0003"
updatedAt: "2026-11-22T12:26:10.846492Z"
- id: "TSK-0004"
title: "Persistir Works e investigação no novo backend"
description: "Integrar Work, guidance e histórico de escolhas, discussões, tópicos,\
\ surveys, respostas e disposições à unidade de persistência. Preservar IDs existentes,\
\ semântica dos IDs locais, referências e histórico útil. Consultas selecionadas\
\ devem buscar o Work diretamente. Manter leitura legada delimitada para compatibilidade\
\ e migração; não manter duas fontes autoritativas para a mesma memória."
acceptanceCriteria:
- "Criar e retomar Work/discussão/survey em outro processo preserva conteúdo, histó\
rico de respostas e pendências."
- "Escolhas DIRECT/EXPLORATORY e autoridade humana mantêm as regras existentes,\
\ inclusive ausência de escolha e pedido específico de DEC."
- "Busca por Work e suas referências usa consultas com escopo adequado; alteraçõ\
es e referências relacionadas são transacionais."
dependsOn:
- "TSK-0003"
status: "ACTIVE"
result: "Integrar Works, guidance e investigação ao backend transacional, preservando\
\ leitura do legado e autoridade humana."
evidence: []
updatedAt: "2026-11-22T12:26:20.696235Z"
- id: "TSK-0005"
title: "Persistir decisões, planos e experimentos"
description: "Integrar DecisionService e PlanService com revisões, aceitação, supersessã\
o, passos, dependências e experimentos. Preservar os dois ciclos e OODA, a autoridade\
\ de DEC/Plan e a distinção entre aprovação humana e promoção permitida por polí\
tica. Tratar operações que alteram registros relacionados em uma transação, sem\
\ reduzir os checks de domínio."
acceptanceCriteria:
- "Aprovação, revisão e supersessão preservam autoria e referências, sem fabricaç\
ão de aprovação ou edição silenciosa de decisão aceita."
- "Dependências e estados de passos, critérios de experimentos, preocupações com\
\ DEC e replanejamento conservam os bloqueios existentes."
- "Interrupção simulada não publica meia supersessão ou promoção parcial; retomada\
\ em outro processo preserva o contexto."
dependsOn:
- "TSK-0004"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:52:43.954237Z"
- id: "TSK-0006"
title: "Integrar execuções de agentes e coordenação de EPICs"
description: "Persistir RUNs e seus dados operacionais mínimos, idempotência de\
\ requestId, referências aplicadas e diagnóstico. Integrar PlanCoordinator/EpicCoordinator,\
\ políticas e proveniência de conclusão, representando recibos internos como dados\
\ estruturados quando aplicável. Preservar a fronteira do adaptador: propostas\
\ não aprovam DEC, não respondem pelo humano nem executam comandos de repositó\
rio."
acceptanceCriteria:
- "Repetição idempotente de uma solicitação concluída não duplica registros; solicitaç\
ões divergentes e estados interrompidos são diagnosticados."
- "Políticas RESULTS/DECOMPOSITION, delegação, reabertura, propagação e conclusã\
o por Plans preservam autoridade e proveniência."
- "Resultados estruturados necessários permanecem; transporte bruto, ambiente e\
\ logs completos não viram acervo permanente no banco."
dependsOn:
- "TSK-0005"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:52:50.899228Z"
- id: "TSK-0007"
title: "Integrar gates do projeto e adicionais por Work"
description: "Representar gates obrigatórios do projeto e complementos do Work e\
\ conectar seus resultados aos checks e à entrega. Preservar avaliação externa\
\ e condições de qualidade, inclusive anexos exigidos. Registrar identificaçã\
o, procedimento/execução, estado avaliado, momento e resultado mínimo. Alteraç\
ões pertinentes invalidam a aplicação do resultado aos gates afetados; aprovaç\
ão humana não equivale a sucesso técnico."
acceptanceCriteria:
- "Gate obrigatório pendente, falho ou não executado bloqueia a entrega; gates adicionais\
\ do Work são considerados sem dispensar obrigatórios do projeto."
- "Resultados correspondem ao estado realmente avaliado e não satisfazem silenciosamente\
\ um gate após mudança relevante."
- "Checks existentes e anexos necessários continuam exigidos durante avaliação,\
\ sem introduzir executor autônomo ou retenção bruta obrigatória."
dependsOn:
- "TSK-0005"
- "TSK-0006"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:52:58.285586Z"
- id: "TSK-0008"
title: "Implementar anexos temporários e descarte após checks"
description: "Definir ciclo de vida de anexos e arquivos de execução no filesystem.\
\ Publicar arquivos completos, validar e registrar resultados mínimos antes do\
\ descarte; limpar elegíveis ao fim da execução. Proteger anexos ainda usados\
\ por checks pendentes e outputs solicitados. Recuperar falhas entre publicaçã\
o de arquivo, transação no banco e limpeza, distinguindo descarte legítimo de\
\ perda prematura. Não descartar artefatos legados deste workspace."
acceptanceCriteria:
- "Arquivos exigidos permanecem acessíveis até todos os checks dependentes terminarem,\
\ com resultado persistido antes da remoção."
- "Descarte automático preserva outputs solicitados e memória histórica; arquivo\
\ perdido antes da avaliação continua causando falha."
- "Interrupções nos pontos de publicação, registro e limpeza não fabricam sucesso\
\ e permitem recuperação sem remoção de entradas ainda necessárias."
dependsOn:
- "TSK-0007"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:05.800970Z"
- id: "TSK-0009"
title: "Adaptar verificação, status e contexto ao SQLite"
description: "Integrar VerificationService, CompatibilityService e projeções da\
\ CLI ao backend. Montar status, next-actions, context e readiness com consultas\
\ necessárias e resultados reutilizados na invocação; preservar contrato público\
\ quando compatível e informar mudanças. Separar resultado histórico com anexo\
\ descartado legitimamente de validação ativa. Manter diagnóstico de reparo e\
\ ausência de transições de estado em consultas."
acceptanceCriteria:
- "Consultas e contexto em processos novos preservam informações e autoridade e\
\ não promovem, migram ou concluem registros por leitura."
- "Anexos descartados legitimamente não invalidam histórico; corrupção e referê\
ncias ausentes não são tratadas como gates satisfeitos."
- "Caminhos selecionados não repetem varreduras/validações globais sem necessidade;\
\ saída e códigos de erro compatíveis são verificados."
dependsOn:
- "TSK-0004"
- "TSK-0005"
- "TSK-0006"
- "TSK-0008"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:13.390096Z"
- id: "TSK-0010"
title: "Implementar migração explícita e recuperável do legado"
description: "Criar comando público de prévia e aplicação da migração, sem conversã\
o em leituras ou atualização do instalador. Usar base de preparo e cópia de seguranç\
a da conversão, importação tipada transacional e verificação contra o corpus.\
\ Preservar IDs, conteúdo, aprovações, hashes, revisões e proveniência histórica\
\ sem despejar arquivos no banco. Ativar somente após sucesso; repetir ou recuperar\
\ interrupção sem duplicar. Executar apenas em fixtures/cópias descartáveis."
acceptanceCriteria:
- "Prévia não modifica o projeto; aplicação compara registros/contexto e ativa a\
\ base somente após validação completa."
- "Fixtures históricas, recibos, aprovações e referências preservam identidade/proveniê\
ncia; execução repetida não duplica conteúdo."
- "Falhas e interrupções deixam a fonte anterior recuperável e informam próxima\
\ ação; nenhum projeto real ou workspace canônico foi migrado."
dependsOn:
- "TSK-0001"
- "TSK-0009"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:21.074969Z"
- id: "TSK-0011"
title: "Atualizar init, descoberta e contrato de compatibilidade"
description: "Inicializar projetos locais em SQLite e deixar .ai-engineering ignorado\
\ pelo Git por padrão sem exigir Git. Preservar regras preexistentes e instruç\
ões fora do bloco gerido. Declarar backend e versões no contrato público, atualizar\
\ diagnóstico/onboard e evitar que base SQLite seja interpretada como workspace\
\ vazio por combinação incompatível. Manter tratamento explícito de projetos legados\
\ e previamente rastreados."
acceptanceCriteria:
- "Init cria projeto funcional sem Git, com estado local ignorado por padrão e bootstrap\
\ suficiente para humanos e agentes."
- "Reexecução preserva conteúdo/regras; não remove arquivos já rastreados nem converte\
\ legado automaticamente."
- "Versões e backend incompatíveis são recusados com diagnóstico acionável antes\
\ de escrita; documentação/entrypoints não induzem uso de CLI incompatível."
dependsOn:
- "TSK-0009"
- "TSK-0010"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:28.841960Z"
- id: "TSK-0012"
title: "Preparar pacote nativo e instalador conjunto sem ativação"
description: "Evoluir build/distribuição e scripts/install-native.sh para empacotar\
\ AIE nativo, biblioteca SQLite do driver e CLI sqlite3 num diretório configurá\
vel, com atalhos aie/ai-engineering e dados de projeto separados. Fixar componentes/plataformas\
\ e verificar pacote antes de ativação, preservando versão anterior em falhas.\
\ Testar instalador com ferramentas simuladas e destinos descartáveis; smoke usa\
\ build local. Não executar instalação real nem tocar ~/.local/bin ou dependê\
ncias ativas."
acceptanceCriteria:
- "Pacote contém componentes corretos e o build nativo acessa uma base descartá\
vel sem depender da instalação global."
- "Fixtures verificam diretórios configuráveis, atalhos, atualização conjunta e\
\ falha sem danificar instalação anterior simulada."
- "Nenhum binário, biblioteca ou atalho ativo é substituído e o instalador real\
\ não é executado; a ativação posterior continua dependente de instrução humana."
dependsOn:
- "TSK-0002"
- "TSK-0011"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:37.290314Z"
- id: "TSK-0013"
title: "Consolidar documentação e instruções do framework local"
description: "Atualizar README, docs de arquitetura/protocolo/compatibilidade/migraç\
ão e recursos de entrada para memória local, SQLite, gates e retenção mínima.\
\ Explicar anexos temporários, outputs entregues, migração explícita e recuperaç\
ão, pacote preparado e instalação adiada. Remover instruções que apresentem arquivos\
\ de Works como fonte principal nova ou Git como exigência. Preservar orientaç\
ões dos dois ciclos, OODA, DEC/Plan e aprovações."
acceptanceCriteria:
- "Documentação e recursos distribuídos descrevem o mesmo contrato e permitem inicializar/retomar\
\ um projeto sem Git."
- "Procedimento público de migração explica prévia, efeitos e recuperação sem depender\
\ de inspeção do código interno."
- "Limites de retenção e instalação, papel dos gates e recortes futuros estão claros;\
\ fontes e exemplos não alegam testes ou migrações reais não executados."
dependsOn:
- "TSK-0010"
- "TSK-0011"
- "TSK-0012"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:45.331995Z"
- id: "TSK-0014"
title: "Executar regressão integrada e encaminhar responsividade ao WRK-000C"
description: "Integrar as verificações das etapas e executar gates apropriados de\
\ testes/arquitetura, migração, concorrência e smoke JVM/nativo em ambientes descartá\
veis. Revisar continuidade e autoridade nos dois ciclos, anexos temporários, recuperaç\
ão e funcionamento sem Git. Consolidar resultados mínimos, resolver experimentos/preocupaç\
ões e entregar cenário reproduzível ao WRK-000C com comandos, versão, dados e\
\ ambiente. Não instalar o pacote nem declarar resolvido o atraso."
acceptanceCriteria:
- "Suíte relevante de domínio/integração/compatibilidade, fixtures do instalador\
\ e smoke nativo passam ou impedimentos são tratados antes da conclusão."
- "Falhas, rollback, concorrência, legado, gates e descarte legítimo foram verificados\
\ com resultados reais e sem alteração da instalação ativa ou consumidores."
- "Todos os steps e critérios da DEC estão satisfeitos, sem experimentos/preocupaç\
ões pendentes; WRK-000C recebe cenário para medição futura e permanece aberto."
dependsOn:
- "TSK-0013"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:53.421052Z"
status: "ACTIVE"
author: "Codex"
createdAt: "2026-11-22T11:52:06.993736Z"
revision: 25
previousHash: "49d5bca8fc12419c5822883338ab55e6cba35d0d8f22ef2ffea5f0761ce6832a"
updatedAt: "2026-11-22T12:26:20.696401Z"
updatedBy: "Codex"
changeReason: "Integrar Works, guidance e investigação ao backend transacional, preservando\
\ leitura do legado e autoridade humana."
experiments:
- id: "EXP-0001"
stepId: "TSK-0002"
hypothesis: "SQLite JDBC pode criar, persistir e reabrir uma base em processos JVM\
\ e Native Image com biblioteca distribuída ao lado do executável."
successCriterion: "As duas formas executam create/read/write/reopen e rollback em\
\ diretório descartável; o nativo usa a biblioteca do pacote com extração temporá\
ria indisponível; nenhum binário ativo ou consumidor é alterado."
invocation: "./gradlew sqliteProbeClasses nativeSqliteProbeCompile; scripts/sqlite-probe.sh\
\ <build>; execução da classe de prova JVM e do binário de build em processos\
\ distintos"
retryOf: null
reconsideration: null
by: "Codex"
createdAt: "2026-11-22T12:10:00.110720Z"
outcome: "CONFIRMED"
observation: "JVM criou e reabriu a base com UTF-8 e rollback. Native Image GraalVM\
\ 25 criou e reabriu em processos independentes com biblioteca externa e extraç\
ão sem escrita; a cópia isolada sem biblioteca falhou."
interpretation: "Driver SQLite JDBC 3.54.1.0 e biblioteca distribuída ao lado do\
\ nativo funcionam na plataforma macOS arm64. Seleção inicial de JDK foi corrigida\
\ explicitamente; sem instalação real."
nextAction: "Implementar infraestrutura transacional e esquema local no TSK-0003."
evidence:
- "ART-0002"
questionsDecision: null
finishedAt: "2026-11-22T12:16:43.109268Z"
finishedBy: "Codex"
documentVersion: 2
---
# Implementar memória de engenharia local em SQLite
## Autoridade e objetivo
Executar a DEC-0001 do WRK-000D, aceita explicitamente por Nilton nesta conversa.
O resultado é um framework local de memória de engenharia por Work, com SQLite
por projeto, investigação e implementação orientadas por OODA, gates preservados,
anexos temporários e retenção mínima. A aprovação desta DEC mantém a instalação
real adiada.
Este Plan foi solicitado com decomposição em vários steps. Todos os steps começam
OPEN; a criação do Plan não constitui execução ou comprovação de resultado.
## Limites obrigatórios
- Não instalar nem substituir o AIE, SQLite, bibliotecas ou atalhos em uso.
- Não executar o instalador real contra HOME, ~/.local/bin ou outro destino ativo.
Sua validação usa fixtures com ferramentas simuladas e destinos descartáveis.
- Não migrar este workspace canônico ou projetos consumidores. Exercitar o novo
backend e a migração em fixtures e cópias descartáveis; ativação real depende de
instrução humana posterior específica.
- Preservar alterações preexistentes, IDs, conteúdo e proveniência legada,
aprovações, evidências históricas e instruções do projeto fora do bloco gerido.
- Não introduzir arquivos em BLOB/base64 ou TEXT equivalente, retenção extensa,
executor autônomo de repositório, colaboração distribuída ou integração Git LFS.
- Importação/exportação de Works/DECs e backup como funcionalidade ficam fora.
A cópia de segurança da migração é parte da recuperação da conversão.
- Código e outputs solicitados permanecem nos destinos de entrega apropriados.
- O WRK-000C permanece aberto para avaliar e tratar latência após esta mudança.
## Execução e dependências
Os 14 steps possuem dependências explícitas e critérios próprios. Mapear primeiro
o contrato e o legado; provar a integração SQLite/JVM/Native Image; depois construir
as transações e migrar os fluxos de domínio. Integrar gates e ciclo dos anexos antes
de consolidar as consultas, a migração pública e o bootstrap. Preparar distribuição
e documentação e concluir com regressão integrada e encaminhamento ao WRK-000C.
Não iniciar um step com dependências pendentes. Verificações focadas fazem parte
de cada mudança; a última etapa integra os cenários e não substitui essas verificações.
Steps independentes podem ser executados em ordem compatível, sem presumir
autorização de delegação ou de instalação real.
## OODA e incertezas
Nas provas relevantes, principalmente driver/nativo, migração e descarte de anexos,
registrar hipótese, critério de sucesso e invocação antes de executar. Registrar
observação, interpretação e próxima ação após o resultado; reconsiderar antes de
repetir uma hipótese falha. Usar os registros de experimentos do Plan quando úteis,
sem impor um ritual de quatro fases a toda alteração.
Ajustar esquema, índices, transações e build dentro da DEC. Se um resultado
questionar a decisão, registrar a preocupação, continuar investigações autorizadas
e rever a DEC com aprovação aplicável antes da execução afetada.
## Verificação e registro mínimo
Durante a execução deste Work, respeitar o protocolo que está em uso. Registrar
resultados reais e evidência mínima necessária para completar os steps; não usar
a futura política de limpeza para apagar evidências legadas ou simular gates.
Verificar continuidade entre processos, integridade referencial, rollback,
concorrência local com espera limitada, autoridade humana, gates e anexos
temporários, migração repetível e operação sem Git. Provas nativas usam somente
artefatos de build e projetos descartáveis.
Comandos candidatos à validação, ajustados ao resultado e ao código final:
- `./gradlew test` e `./gradlew check` para a suíte e arquitetura do projeto.
- `python3 scripts/test-install-native.py` para fixtures do instalador.
- `./gradlew nativeCompile` e tarefas de distribuição para construir o pacote.
- `bash scripts/native-smoke.sh <caminho-absoluto-do-build>` em projetos descartáveis.
Esses comandos são planejados, não executados na criação do Plan. Preservar os
gates específicos do projeto e adicionais do Work definidos na execução. Logs de
trabalho podem ser temporários; guardar na memória somente o necessário ao contrato.
## Conclusão
Todos os steps obrigatórios devem satisfazer seus critérios, com a DEC aceita e
sem experimentos ou preocupações pendentes. A entrega é código, documentação,
pacote preparado e resultados de verificação. Não depende de instalar a nova
versão no ambiente em uso. Encaminhar ao WRK-000C um cenário reproduzível com
comandos, versão, volume e ambiente, sem declarar resolvido o problema de atraso.
@@ -0,0 +1,445 @@
---
schemaVersion: 1
id: "PLN-0001"
workId: "WRK-000D"
title: "Implementar memória de engenharia local em SQLite sem instalação ativa"
decisions:
- "DEC-0001"
steps:
- id: "TSK-0001"
title: "Mapear contrato, dados legados e cenários de migração"
description: "Inspecionar WorkService, serviços de Discussion/Decision/Plan/Agent,\
\ coordenadores e VerificationService. Mapear registros, referências, revisões,\
\ hashes, recibos e bootstrap para tabelas e regras do backend SQLite, preservando\
\ conteúdo e autoridade. Selecionar fixtures existentes de compatibilidade, workflows\
\ e importação como corpus; usar apenas cópias descartáveis. Identificar checks\
\ e pontos de retenção sem realizar benchmark conclusivo do WRK-000C."
acceptanceCriteria:
- "Mapeamento cobre entidades persistidas, IDs locais ao Work, referências, revisõ\
es, aprovações e casos de conclusão legada com hashes/recibos."
- "Corpus representativo e resultados esperados de continuidade/migração estão definidos\
\ antes da conversão, incluindo dados inválidos e estados interrompidos."
- "Limites de instalação, migração de consumidores e preservação do workspace atual\
\ estão explícitos e respeitados."
dependsOn: []
status: "COMPLETED"
result: "Contrato e legado mapeados em docs/sqlite-migration-design.md; corpus e\
\ casos de falha/retry definidos antes da migração. Baseline: 45 testes em seis\
\ classes passaram, hashes congelados conferidos e fontes históricas intactas.\
\ Sem instalação ou migração real."
evidence:
- "ART-0001"
updatedAt: "2026-11-22T12:00:26.700050Z"
- id: "TSK-0002"
title: "Provar driver SQLite em JVM e Native Image"
description: "Avaliar Xerial SQLite JDBC e fixar versão compatível com Java, Gradle\
\ e GraalVM do projeto. Registrar hipótese, critério e invocação antes da prova.\
\ Criar, gravar, ler e reabrir uma base descartável em processos JVM e nativos.\
\ Verificar carregamento da biblioteca distribuída ao lado do nativo; sqlite3\
\ será ferramenta de diagnóstico do pacote. Construir e executar somente artefatos\
\ descartáveis, sem instalação real."
acceptanceCriteria:
- "Driver e versão selecionados demonstram persistência e reabertura em JVM e Native\
\ Image na plataforma alvo."
- "Biblioteca do pacote é encontrada por caminho controlado e não depende acidentalmente\
\ do SQLite global ou de extração repetida não planejada."
- "Hipótese, resultado e limitações da prova estão registrados; instalação ativa\
\ e projetos consumidores não foram alterados."
dependsOn:
- "TSK-0001"
status: "COMPLETED"
result: "Prova JVM e Native Image passou create/read/write/reopen, UTF-8, rollback\
\ e dependência da biblioteca do pacote; sem instalação ativa."
evidence:
- "ART-0002"
updatedAt: "2026-11-22T12:16:52.149066Z"
- id: "TSK-0003"
title: "Implementar esquema, conexões e transações SQLite"
description: "Criar infraestrutura de persistência local em .ai-engineering/aie.db\
\ com esquema versionado, tabelas tipadas, índices e relações. Habilitar integridade\
\ referencial em cada conexão, delimitar unidade transacional por operação coerente\
\ e usar leitura consistente. Definir journal/durabilidade e espera limitada de\
\ escrita com diagnóstico. Preservar limites de módulos; serviços aninhados devem\
\ compartilhar a transação aplicável."
acceptanceCriteria:
- "Esquema e índices atendem ao mapeamento sem BLOB/base64 ou arquivos completos\
\ serializados em TEXT."
- "Falha em operação relacionada causa rollback; referências inválidas são recusadas\
\ e gravações concorrentes têm contenção limitada e diagnóstico útil."
- "Abertura de esquema incompatível é diagnosticada sem alterar dados; teste de\
\ leitura consistente cobre mudanças concorrentes locais."
dependsOn:
- "TSK-0001"
- "TSK-0002"
status: "COMPLETED"
result: "Infraestrutura SQLite validada: 12 testes de transação/integridade/concorrê\
ncia e arquitetura passaram; schema também criado e reaberto pelo Native Image.\
\ CLI de domínio e instalação ativa continuam intactos."
evidence:
- "ART-0003"
updatedAt: "2026-11-22T12:26:10.846492Z"
- id: "TSK-0004"
title: "Persistir Works e investigação no novo backend"
description: "Integrar Work, guidance e histórico de escolhas, discussões, tópicos,\
\ surveys, respostas e disposições à unidade de persistência. Preservar IDs existentes,\
\ semântica dos IDs locais, referências e histórico útil. Consultas selecionadas\
\ devem buscar o Work diretamente. Manter leitura legada delimitada para compatibilidade\
\ e migração; não manter duas fontes autoritativas para a mesma memória."
acceptanceCriteria:
- "Criar e retomar Work/discussão/survey em outro processo preserva conteúdo, histó\
rico de respostas e pendências."
- "Escolhas DIRECT/EXPLORATORY e autoridade humana mantêm as regras existentes,\
\ inclusive ausência de escolha e pedido específico de DEC."
- "Busca por Work e suas referências usa consultas com escopo adequado; alteraçõ\
es e referências relacionadas são transacionais."
dependsOn:
- "TSK-0003"
status: "COMPLETED"
result: "Works/investigação SQLite passaram 45 testes e retomada em outro JVM e\
\ nativo; referências transacionais, histórico e autoridade preservados."
evidence:
- "ART-0004"
updatedAt: "2026-11-22T12:43:38.166159Z"
- id: "TSK-0005"
title: "Persistir decisões, planos e experimentos"
description: "Integrar DecisionService e PlanService com revisões, aceitação, supersessã\
o, passos, dependências e experimentos. Preservar os dois ciclos e OODA, a autoridade\
\ de DEC/Plan e a distinção entre aprovação humana e promoção permitida por polí\
tica. Tratar operações que alteram registros relacionados em uma transação, sem\
\ reduzir os checks de domínio."
acceptanceCriteria:
- "Aprovação, revisão e supersessão preservam autoria e referências, sem fabricaç\
ão de aprovação ou edição silenciosa de decisão aceita."
- "Dependências e estados de passos, critérios de experimentos, preocupações com\
\ DEC e replanejamento conservam os bloqueios existentes."
- "Interrupção simulada não publica meia supersessão ou promoção parcial; retomada\
\ em outro processo preserva o contexto."
dependsOn:
- "TSK-0004"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:52:43.954237Z"
- id: "TSK-0006"
title: "Integrar execuções de agentes e coordenação de EPICs"
description: "Persistir RUNs e seus dados operacionais mínimos, idempotência de\
\ requestId, referências aplicadas e diagnóstico. Integrar PlanCoordinator/EpicCoordinator,\
\ políticas e proveniência de conclusão, representando recibos internos como dados\
\ estruturados quando aplicável. Preservar a fronteira do adaptador: propostas\
\ não aprovam DEC, não respondem pelo humano nem executam comandos de repositó\
rio."
acceptanceCriteria:
- "Repetição idempotente de uma solicitação concluída não duplica registros; solicitaç\
ões divergentes e estados interrompidos são diagnosticados."
- "Políticas RESULTS/DECOMPOSITION, delegação, reabertura, propagação e conclusã\
o por Plans preservam autoridade e proveniência."
- "Resultados estruturados necessários permanecem; transporte bruto, ambiente e\
\ logs completos não viram acervo permanente no banco."
dependsOn:
- "TSK-0005"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:52:50.899228Z"
- id: "TSK-0007"
title: "Integrar gates do projeto e adicionais por Work"
description: "Representar gates obrigatórios do projeto e complementos do Work e\
\ conectar seus resultados aos checks e à entrega. Preservar avaliação externa\
\ e condições de qualidade, inclusive anexos exigidos. Registrar identificaçã\
o, procedimento/execução, estado avaliado, momento e resultado mínimo. Alteraç\
ões pertinentes invalidam a aplicação do resultado aos gates afetados; aprovaç\
ão humana não equivale a sucesso técnico."
acceptanceCriteria:
- "Gate obrigatório pendente, falho ou não executado bloqueia a entrega; gates adicionais\
\ do Work são considerados sem dispensar obrigatórios do projeto."
- "Resultados correspondem ao estado realmente avaliado e não satisfazem silenciosamente\
\ um gate após mudança relevante."
- "Checks existentes e anexos necessários continuam exigidos durante avaliação,\
\ sem introduzir executor autônomo ou retenção bruta obrigatória."
dependsOn:
- "TSK-0005"
- "TSK-0006"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:52:58.285586Z"
- id: "TSK-0008"
title: "Implementar anexos temporários e descarte após checks"
description: "Definir ciclo de vida de anexos e arquivos de execução no filesystem.\
\ Publicar arquivos completos, validar e registrar resultados mínimos antes do\
\ descarte; limpar elegíveis ao fim da execução. Proteger anexos ainda usados\
\ por checks pendentes e outputs solicitados. Recuperar falhas entre publicaçã\
o de arquivo, transação no banco e limpeza, distinguindo descarte legítimo de\
\ perda prematura. Não descartar artefatos legados deste workspace."
acceptanceCriteria:
- "Arquivos exigidos permanecem acessíveis até todos os checks dependentes terminarem,\
\ com resultado persistido antes da remoção."
- "Descarte automático preserva outputs solicitados e memória histórica; arquivo\
\ perdido antes da avaliação continua causando falha."
- "Interrupções nos pontos de publicação, registro e limpeza não fabricam sucesso\
\ e permitem recuperação sem remoção de entradas ainda necessárias."
dependsOn:
- "TSK-0007"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:05.800970Z"
- id: "TSK-0009"
title: "Adaptar verificação, status e contexto ao SQLite"
description: "Integrar VerificationService, CompatibilityService e projeções da\
\ CLI ao backend. Montar status, next-actions, context e readiness com consultas\
\ necessárias e resultados reutilizados na invocação; preservar contrato público\
\ quando compatível e informar mudanças. Separar resultado histórico com anexo\
\ descartado legitimamente de validação ativa. Manter diagnóstico de reparo e\
\ ausência de transições de estado em consultas."
acceptanceCriteria:
- "Consultas e contexto em processos novos preservam informações e autoridade e\
\ não promovem, migram ou concluem registros por leitura."
- "Anexos descartados legitimamente não invalidam histórico; corrupção e referê\
ncias ausentes não são tratadas como gates satisfeitos."
- "Caminhos selecionados não repetem varreduras/validações globais sem necessidade;\
\ saída e códigos de erro compatíveis são verificados."
dependsOn:
- "TSK-0004"
- "TSK-0005"
- "TSK-0006"
- "TSK-0008"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:13.390096Z"
- id: "TSK-0010"
title: "Implementar migração explícita e recuperável do legado"
description: "Criar comando público de prévia e aplicação da migração, sem conversã\
o em leituras ou atualização do instalador. Usar base de preparo e cópia de seguranç\
a da conversão, importação tipada transacional e verificação contra o corpus.\
\ Preservar IDs, conteúdo, aprovações, hashes, revisões e proveniência histórica\
\ sem despejar arquivos no banco. Ativar somente após sucesso; repetir ou recuperar\
\ interrupção sem duplicar. Executar apenas em fixtures/cópias descartáveis."
acceptanceCriteria:
- "Prévia não modifica o projeto; aplicação compara registros/contexto e ativa a\
\ base somente após validação completa."
- "Fixtures históricas, recibos, aprovações e referências preservam identidade/proveniê\
ncia; execução repetida não duplica conteúdo."
- "Falhas e interrupções deixam a fonte anterior recuperável e informam próxima\
\ ação; nenhum projeto real ou workspace canônico foi migrado."
dependsOn:
- "TSK-0001"
- "TSK-0009"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:21.074969Z"
- id: "TSK-0011"
title: "Atualizar init, descoberta e contrato de compatibilidade"
description: "Inicializar projetos locais em SQLite e deixar .ai-engineering ignorado\
\ pelo Git por padrão sem exigir Git. Preservar regras preexistentes e instruç\
ões fora do bloco gerido. Declarar backend e versões no contrato público, atualizar\
\ diagnóstico/onboard e evitar que base SQLite seja interpretada como workspace\
\ vazio por combinação incompatível. Manter tratamento explícito de projetos legados\
\ e previamente rastreados."
acceptanceCriteria:
- "Init cria projeto funcional sem Git, com estado local ignorado por padrão e bootstrap\
\ suficiente para humanos e agentes."
- "Reexecução preserva conteúdo/regras; não remove arquivos já rastreados nem converte\
\ legado automaticamente."
- "Versões e backend incompatíveis são recusados com diagnóstico acionável antes\
\ de escrita; documentação/entrypoints não induzem uso de CLI incompatível."
dependsOn:
- "TSK-0009"
- "TSK-0010"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:28.841960Z"
- id: "TSK-0012"
title: "Preparar pacote nativo e instalador conjunto sem ativação"
description: "Evoluir build/distribuição e scripts/install-native.sh para empacotar\
\ AIE nativo, biblioteca SQLite do driver e CLI sqlite3 num diretório configurá\
vel, com atalhos aie/ai-engineering e dados de projeto separados. Fixar componentes/plataformas\
\ e verificar pacote antes de ativação, preservando versão anterior em falhas.\
\ Testar instalador com ferramentas simuladas e destinos descartáveis; smoke usa\
\ build local. Não executar instalação real nem tocar ~/.local/bin ou dependê\
ncias ativas."
acceptanceCriteria:
- "Pacote contém componentes corretos e o build nativo acessa uma base descartá\
vel sem depender da instalação global."
- "Fixtures verificam diretórios configuráveis, atalhos, atualização conjunta e\
\ falha sem danificar instalação anterior simulada."
- "Nenhum binário, biblioteca ou atalho ativo é substituído e o instalador real\
\ não é executado; a ativação posterior continua dependente de instrução humana."
dependsOn:
- "TSK-0002"
- "TSK-0011"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:37.290314Z"
- id: "TSK-0013"
title: "Consolidar documentação e instruções do framework local"
description: "Atualizar README, docs de arquitetura/protocolo/compatibilidade/migraç\
ão e recursos de entrada para memória local, SQLite, gates e retenção mínima.\
\ Explicar anexos temporários, outputs entregues, migração explícita e recuperaç\
ão, pacote preparado e instalação adiada. Remover instruções que apresentem arquivos\
\ de Works como fonte principal nova ou Git como exigência. Preservar orientaç\
ões dos dois ciclos, OODA, DEC/Plan e aprovações."
acceptanceCriteria:
- "Documentação e recursos distribuídos descrevem o mesmo contrato e permitem inicializar/retomar\
\ um projeto sem Git."
- "Procedimento público de migração explica prévia, efeitos e recuperação sem depender\
\ de inspeção do código interno."
- "Limites de retenção e instalação, papel dos gates e recortes futuros estão claros;\
\ fontes e exemplos não alegam testes ou migrações reais não executados."
dependsOn:
- "TSK-0010"
- "TSK-0011"
- "TSK-0012"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:45.331995Z"
- id: "TSK-0014"
title: "Executar regressão integrada e encaminhar responsividade ao WRK-000C"
description: "Integrar as verificações das etapas e executar gates apropriados de\
\ testes/arquitetura, migração, concorrência e smoke JVM/nativo em ambientes descartá\
veis. Revisar continuidade e autoridade nos dois ciclos, anexos temporários, recuperaç\
ão e funcionamento sem Git. Consolidar resultados mínimos, resolver experimentos/preocupaç\
ões e entregar cenário reproduzível ao WRK-000C com comandos, versão, dados e\
\ ambiente. Não instalar o pacote nem declarar resolvido o atraso."
acceptanceCriteria:
- "Suíte relevante de domínio/integração/compatibilidade, fixtures do instalador\
\ e smoke nativo passam ou impedimentos são tratados antes da conclusão."
- "Falhas, rollback, concorrência, legado, gates e descarte legítimo foram verificados\
\ com resultados reais e sem alteração da instalação ativa ou consumidores."
- "Todos os steps e critérios da DEC estão satisfeitos, sem experimentos/preocupaç\
ões pendentes; WRK-000C recebe cenário para medição futura e permanece aberto."
dependsOn:
- "TSK-0013"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:53.421052Z"
status: "ACTIVE"
author: "Codex"
createdAt: "2026-11-22T11:52:06.993736Z"
revision: 26
previousHash: "ce6cc97b923d3b36f8b01b9980f75bb4a55b75cbbe97afa8d3b280a2d6670d8d"
updatedAt: "2026-11-22T12:43:38.166330Z"
updatedBy: "Codex"
changeReason: "Works/investigação SQLite passaram 45 testes e retomada em outro JVM\
\ e nativo; referências transacionais, histórico e autoridade preservados."
experiments:
- id: "EXP-0001"
stepId: "TSK-0002"
hypothesis: "SQLite JDBC pode criar, persistir e reabrir uma base em processos JVM\
\ e Native Image com biblioteca distribuída ao lado do executável."
successCriterion: "As duas formas executam create/read/write/reopen e rollback em\
\ diretório descartável; o nativo usa a biblioteca do pacote com extração temporá\
ria indisponível; nenhum binário ativo ou consumidor é alterado."
invocation: "./gradlew sqliteProbeClasses nativeSqliteProbeCompile; scripts/sqlite-probe.sh\
\ <build>; execução da classe de prova JVM e do binário de build em processos\
\ distintos"
retryOf: null
reconsideration: null
by: "Codex"
createdAt: "2026-11-22T12:10:00.110720Z"
outcome: "CONFIRMED"
observation: "JVM criou e reabriu a base com UTF-8 e rollback. Native Image GraalVM\
\ 25 criou e reabriu em processos independentes com biblioteca externa e extraç\
ão sem escrita; a cópia isolada sem biblioteca falhou."
interpretation: "Driver SQLite JDBC 3.54.1.0 e biblioteca distribuída ao lado do\
\ nativo funcionam na plataforma macOS arm64. Seleção inicial de JDK foi corrigida\
\ explicitamente; sem instalação real."
nextAction: "Implementar infraestrutura transacional e esquema local no TSK-0003."
evidence:
- "ART-0002"
questionsDecision: null
finishedAt: "2026-11-22T12:16:43.109268Z"
finishedBy: "Codex"
documentVersion: 2
---
# Implementar memória de engenharia local em SQLite
## Autoridade e objetivo
Executar a DEC-0001 do WRK-000D, aceita explicitamente por Nilton nesta conversa.
O resultado é um framework local de memória de engenharia por Work, com SQLite
por projeto, investigação e implementação orientadas por OODA, gates preservados,
anexos temporários e retenção mínima. A aprovação desta DEC mantém a instalação
real adiada.
Este Plan foi solicitado com decomposição em vários steps. Todos os steps começam
OPEN; a criação do Plan não constitui execução ou comprovação de resultado.
## Limites obrigatórios
- Não instalar nem substituir o AIE, SQLite, bibliotecas ou atalhos em uso.
- Não executar o instalador real contra HOME, ~/.local/bin ou outro destino ativo.
Sua validação usa fixtures com ferramentas simuladas e destinos descartáveis.
- Não migrar este workspace canônico ou projetos consumidores. Exercitar o novo
backend e a migração em fixtures e cópias descartáveis; ativação real depende de
instrução humana posterior específica.
- Preservar alterações preexistentes, IDs, conteúdo e proveniência legada,
aprovações, evidências históricas e instruções do projeto fora do bloco gerido.
- Não introduzir arquivos em BLOB/base64 ou TEXT equivalente, retenção extensa,
executor autônomo de repositório, colaboração distribuída ou integração Git LFS.
- Importação/exportação de Works/DECs e backup como funcionalidade ficam fora.
A cópia de segurança da migração é parte da recuperação da conversão.
- Código e outputs solicitados permanecem nos destinos de entrega apropriados.
- O WRK-000C permanece aberto para avaliar e tratar latência após esta mudança.
## Execução e dependências
Os 14 steps possuem dependências explícitas e critérios próprios. Mapear primeiro
o contrato e o legado; provar a integração SQLite/JVM/Native Image; depois construir
as transações e migrar os fluxos de domínio. Integrar gates e ciclo dos anexos antes
de consolidar as consultas, a migração pública e o bootstrap. Preparar distribuição
e documentação e concluir com regressão integrada e encaminhamento ao WRK-000C.
Não iniciar um step com dependências pendentes. Verificações focadas fazem parte
de cada mudança; a última etapa integra os cenários e não substitui essas verificações.
Steps independentes podem ser executados em ordem compatível, sem presumir
autorização de delegação ou de instalação real.
## OODA e incertezas
Nas provas relevantes, principalmente driver/nativo, migração e descarte de anexos,
registrar hipótese, critério de sucesso e invocação antes de executar. Registrar
observação, interpretação e próxima ação após o resultado; reconsiderar antes de
repetir uma hipótese falha. Usar os registros de experimentos do Plan quando úteis,
sem impor um ritual de quatro fases a toda alteração.
Ajustar esquema, índices, transações e build dentro da DEC. Se um resultado
questionar a decisão, registrar a preocupação, continuar investigações autorizadas
e rever a DEC com aprovação aplicável antes da execução afetada.
## Verificação e registro mínimo
Durante a execução deste Work, respeitar o protocolo que está em uso. Registrar
resultados reais e evidência mínima necessária para completar os steps; não usar
a futura política de limpeza para apagar evidências legadas ou simular gates.
Verificar continuidade entre processos, integridade referencial, rollback,
concorrência local com espera limitada, autoridade humana, gates e anexos
temporários, migração repetível e operação sem Git. Provas nativas usam somente
artefatos de build e projetos descartáveis.
Comandos candidatos à validação, ajustados ao resultado e ao código final:
- `./gradlew test` e `./gradlew check` para a suíte e arquitetura do projeto.
- `python3 scripts/test-install-native.py` para fixtures do instalador.
- `./gradlew nativeCompile` e tarefas de distribuição para construir o pacote.
- `bash scripts/native-smoke.sh <caminho-absoluto-do-build>` em projetos descartáveis.
Esses comandos são planejados, não executados na criação do Plan. Preservar os
gates específicos do projeto e adicionais do Work definidos na execução. Logs de
trabalho podem ser temporários; guardar na memória somente o necessário ao contrato.
## Conclusão
Todos os steps obrigatórios devem satisfazer seus critérios, com a DEC aceita e
sem experimentos ou preocupações pendentes. A entrega é código, documentação,
pacote preparado e resultados de verificação. Não depende de instalar a nova
versão no ambiente em uso. Encaminhar ao WRK-000C um cenário reproduzível com
comandos, versão, volume e ambiente, sem declarar resolvido o problema de atraso.
@@ -0,0 +1,446 @@
---
schemaVersion: 1
id: "PLN-0001"
workId: "WRK-000D"
title: "Implementar memória de engenharia local em SQLite sem instalação ativa"
decisions:
- "DEC-0001"
steps:
- id: "TSK-0001"
title: "Mapear contrato, dados legados e cenários de migração"
description: "Inspecionar WorkService, serviços de Discussion/Decision/Plan/Agent,\
\ coordenadores e VerificationService. Mapear registros, referências, revisões,\
\ hashes, recibos e bootstrap para tabelas e regras do backend SQLite, preservando\
\ conteúdo e autoridade. Selecionar fixtures existentes de compatibilidade, workflows\
\ e importação como corpus; usar apenas cópias descartáveis. Identificar checks\
\ e pontos de retenção sem realizar benchmark conclusivo do WRK-000C."
acceptanceCriteria:
- "Mapeamento cobre entidades persistidas, IDs locais ao Work, referências, revisõ\
es, aprovações e casos de conclusão legada com hashes/recibos."
- "Corpus representativo e resultados esperados de continuidade/migração estão definidos\
\ antes da conversão, incluindo dados inválidos e estados interrompidos."
- "Limites de instalação, migração de consumidores e preservação do workspace atual\
\ estão explícitos e respeitados."
dependsOn: []
status: "COMPLETED"
result: "Contrato e legado mapeados em docs/sqlite-migration-design.md; corpus e\
\ casos de falha/retry definidos antes da migração. Baseline: 45 testes em seis\
\ classes passaram, hashes congelados conferidos e fontes históricas intactas.\
\ Sem instalação ou migração real."
evidence:
- "ART-0001"
updatedAt: "2026-11-22T12:00:26.700050Z"
- id: "TSK-0002"
title: "Provar driver SQLite em JVM e Native Image"
description: "Avaliar Xerial SQLite JDBC e fixar versão compatível com Java, Gradle\
\ e GraalVM do projeto. Registrar hipótese, critério e invocação antes da prova.\
\ Criar, gravar, ler e reabrir uma base descartável em processos JVM e nativos.\
\ Verificar carregamento da biblioteca distribuída ao lado do nativo; sqlite3\
\ será ferramenta de diagnóstico do pacote. Construir e executar somente artefatos\
\ descartáveis, sem instalação real."
acceptanceCriteria:
- "Driver e versão selecionados demonstram persistência e reabertura em JVM e Native\
\ Image na plataforma alvo."
- "Biblioteca do pacote é encontrada por caminho controlado e não depende acidentalmente\
\ do SQLite global ou de extração repetida não planejada."
- "Hipótese, resultado e limitações da prova estão registrados; instalação ativa\
\ e projetos consumidores não foram alterados."
dependsOn:
- "TSK-0001"
status: "COMPLETED"
result: "Prova JVM e Native Image passou create/read/write/reopen, UTF-8, rollback\
\ e dependência da biblioteca do pacote; sem instalação ativa."
evidence:
- "ART-0002"
updatedAt: "2026-11-22T12:16:52.149066Z"
- id: "TSK-0003"
title: "Implementar esquema, conexões e transações SQLite"
description: "Criar infraestrutura de persistência local em .ai-engineering/aie.db\
\ com esquema versionado, tabelas tipadas, índices e relações. Habilitar integridade\
\ referencial em cada conexão, delimitar unidade transacional por operação coerente\
\ e usar leitura consistente. Definir journal/durabilidade e espera limitada de\
\ escrita com diagnóstico. Preservar limites de módulos; serviços aninhados devem\
\ compartilhar a transação aplicável."
acceptanceCriteria:
- "Esquema e índices atendem ao mapeamento sem BLOB/base64 ou arquivos completos\
\ serializados em TEXT."
- "Falha em operação relacionada causa rollback; referências inválidas são recusadas\
\ e gravações concorrentes têm contenção limitada e diagnóstico útil."
- "Abertura de esquema incompatível é diagnosticada sem alterar dados; teste de\
\ leitura consistente cobre mudanças concorrentes locais."
dependsOn:
- "TSK-0001"
- "TSK-0002"
status: "COMPLETED"
result: "Infraestrutura SQLite validada: 12 testes de transação/integridade/concorrê\
ncia e arquitetura passaram; schema também criado e reaberto pelo Native Image.\
\ CLI de domínio e instalação ativa continuam intactos."
evidence:
- "ART-0003"
updatedAt: "2026-11-22T12:26:10.846492Z"
- id: "TSK-0004"
title: "Persistir Works e investigação no novo backend"
description: "Integrar Work, guidance e histórico de escolhas, discussões, tópicos,\
\ surveys, respostas e disposições à unidade de persistência. Preservar IDs existentes,\
\ semântica dos IDs locais, referências e histórico útil. Consultas selecionadas\
\ devem buscar o Work diretamente. Manter leitura legada delimitada para compatibilidade\
\ e migração; não manter duas fontes autoritativas para a mesma memória."
acceptanceCriteria:
- "Criar e retomar Work/discussão/survey em outro processo preserva conteúdo, histó\
rico de respostas e pendências."
- "Escolhas DIRECT/EXPLORATORY e autoridade humana mantêm as regras existentes,\
\ inclusive ausência de escolha e pedido específico de DEC."
- "Busca por Work e suas referências usa consultas com escopo adequado; alteraçõ\
es e referências relacionadas são transacionais."
dependsOn:
- "TSK-0003"
status: "COMPLETED"
result: "Works/investigação SQLite passaram 45 testes e retomada em outro JVM e\
\ nativo; referências transacionais, histórico e autoridade preservados."
evidence:
- "ART-0004"
updatedAt: "2026-11-22T12:43:38.166159Z"
- id: "TSK-0005"
title: "Persistir decisões, planos e experimentos"
description: "Integrar DecisionService e PlanService com revisões, aceitação, supersessã\
o, passos, dependências e experimentos. Preservar os dois ciclos e OODA, a autoridade\
\ de DEC/Plan e a distinção entre aprovação humana e promoção permitida por polí\
tica. Tratar operações que alteram registros relacionados em uma transação, sem\
\ reduzir os checks de domínio."
acceptanceCriteria:
- "Aprovação, revisão e supersessão preservam autoria e referências, sem fabricaç\
ão de aprovação ou edição silenciosa de decisão aceita."
- "Dependências e estados de passos, critérios de experimentos, preocupações com\
\ DEC e replanejamento conservam os bloqueios existentes."
- "Interrupção simulada não publica meia supersessão ou promoção parcial; retomada\
\ em outro processo preserva o contexto."
dependsOn:
- "TSK-0004"
status: "ACTIVE"
result: "Prosseguir para persistência de decisões, planos e experimentos, preservando\
\ aprovação, revisão e rollback."
evidence: []
updatedAt: "2026-11-22T12:43:49.770509Z"
- id: "TSK-0006"
title: "Integrar execuções de agentes e coordenação de EPICs"
description: "Persistir RUNs e seus dados operacionais mínimos, idempotência de\
\ requestId, referências aplicadas e diagnóstico. Integrar PlanCoordinator/EpicCoordinator,\
\ políticas e proveniência de conclusão, representando recibos internos como dados\
\ estruturados quando aplicável. Preservar a fronteira do adaptador: propostas\
\ não aprovam DEC, não respondem pelo humano nem executam comandos de repositó\
rio."
acceptanceCriteria:
- "Repetição idempotente de uma solicitação concluída não duplica registros; solicitaç\
ões divergentes e estados interrompidos são diagnosticados."
- "Políticas RESULTS/DECOMPOSITION, delegação, reabertura, propagação e conclusã\
o por Plans preservam autoridade e proveniência."
- "Resultados estruturados necessários permanecem; transporte bruto, ambiente e\
\ logs completos não viram acervo permanente no banco."
dependsOn:
- "TSK-0005"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:52:50.899228Z"
- id: "TSK-0007"
title: "Integrar gates do projeto e adicionais por Work"
description: "Representar gates obrigatórios do projeto e complementos do Work e\
\ conectar seus resultados aos checks e à entrega. Preservar avaliação externa\
\ e condições de qualidade, inclusive anexos exigidos. Registrar identificaçã\
o, procedimento/execução, estado avaliado, momento e resultado mínimo. Alteraç\
ões pertinentes invalidam a aplicação do resultado aos gates afetados; aprovaç\
ão humana não equivale a sucesso técnico."
acceptanceCriteria:
- "Gate obrigatório pendente, falho ou não executado bloqueia a entrega; gates adicionais\
\ do Work são considerados sem dispensar obrigatórios do projeto."
- "Resultados correspondem ao estado realmente avaliado e não satisfazem silenciosamente\
\ um gate após mudança relevante."
- "Checks existentes e anexos necessários continuam exigidos durante avaliação,\
\ sem introduzir executor autônomo ou retenção bruta obrigatória."
dependsOn:
- "TSK-0005"
- "TSK-0006"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:52:58.285586Z"
- id: "TSK-0008"
title: "Implementar anexos temporários e descarte após checks"
description: "Definir ciclo de vida de anexos e arquivos de execução no filesystem.\
\ Publicar arquivos completos, validar e registrar resultados mínimos antes do\
\ descarte; limpar elegíveis ao fim da execução. Proteger anexos ainda usados\
\ por checks pendentes e outputs solicitados. Recuperar falhas entre publicaçã\
o de arquivo, transação no banco e limpeza, distinguindo descarte legítimo de\
\ perda prematura. Não descartar artefatos legados deste workspace."
acceptanceCriteria:
- "Arquivos exigidos permanecem acessíveis até todos os checks dependentes terminarem,\
\ com resultado persistido antes da remoção."
- "Descarte automático preserva outputs solicitados e memória histórica; arquivo\
\ perdido antes da avaliação continua causando falha."
- "Interrupções nos pontos de publicação, registro e limpeza não fabricam sucesso\
\ e permitem recuperação sem remoção de entradas ainda necessárias."
dependsOn:
- "TSK-0007"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:05.800970Z"
- id: "TSK-0009"
title: "Adaptar verificação, status e contexto ao SQLite"
description: "Integrar VerificationService, CompatibilityService e projeções da\
\ CLI ao backend. Montar status, next-actions, context e readiness com consultas\
\ necessárias e resultados reutilizados na invocação; preservar contrato público\
\ quando compatível e informar mudanças. Separar resultado histórico com anexo\
\ descartado legitimamente de validação ativa. Manter diagnóstico de reparo e\
\ ausência de transições de estado em consultas."
acceptanceCriteria:
- "Consultas e contexto em processos novos preservam informações e autoridade e\
\ não promovem, migram ou concluem registros por leitura."
- "Anexos descartados legitimamente não invalidam histórico; corrupção e referê\
ncias ausentes não são tratadas como gates satisfeitos."
- "Caminhos selecionados não repetem varreduras/validações globais sem necessidade;\
\ saída e códigos de erro compatíveis são verificados."
dependsOn:
- "TSK-0004"
- "TSK-0005"
- "TSK-0006"
- "TSK-0008"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:13.390096Z"
- id: "TSK-0010"
title: "Implementar migração explícita e recuperável do legado"
description: "Criar comando público de prévia e aplicação da migração, sem conversã\
o em leituras ou atualização do instalador. Usar base de preparo e cópia de seguranç\
a da conversão, importação tipada transacional e verificação contra o corpus.\
\ Preservar IDs, conteúdo, aprovações, hashes, revisões e proveniência histórica\
\ sem despejar arquivos no banco. Ativar somente após sucesso; repetir ou recuperar\
\ interrupção sem duplicar. Executar apenas em fixtures/cópias descartáveis."
acceptanceCriteria:
- "Prévia não modifica o projeto; aplicação compara registros/contexto e ativa a\
\ base somente após validação completa."
- "Fixtures históricas, recibos, aprovações e referências preservam identidade/proveniê\
ncia; execução repetida não duplica conteúdo."
- "Falhas e interrupções deixam a fonte anterior recuperável e informam próxima\
\ ação; nenhum projeto real ou workspace canônico foi migrado."
dependsOn:
- "TSK-0001"
- "TSK-0009"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:21.074969Z"
- id: "TSK-0011"
title: "Atualizar init, descoberta e contrato de compatibilidade"
description: "Inicializar projetos locais em SQLite e deixar .ai-engineering ignorado\
\ pelo Git por padrão sem exigir Git. Preservar regras preexistentes e instruç\
ões fora do bloco gerido. Declarar backend e versões no contrato público, atualizar\
\ diagnóstico/onboard e evitar que base SQLite seja interpretada como workspace\
\ vazio por combinação incompatível. Manter tratamento explícito de projetos legados\
\ e previamente rastreados."
acceptanceCriteria:
- "Init cria projeto funcional sem Git, com estado local ignorado por padrão e bootstrap\
\ suficiente para humanos e agentes."
- "Reexecução preserva conteúdo/regras; não remove arquivos já rastreados nem converte\
\ legado automaticamente."
- "Versões e backend incompatíveis são recusados com diagnóstico acionável antes\
\ de escrita; documentação/entrypoints não induzem uso de CLI incompatível."
dependsOn:
- "TSK-0009"
- "TSK-0010"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:28.841960Z"
- id: "TSK-0012"
title: "Preparar pacote nativo e instalador conjunto sem ativação"
description: "Evoluir build/distribuição e scripts/install-native.sh para empacotar\
\ AIE nativo, biblioteca SQLite do driver e CLI sqlite3 num diretório configurá\
vel, com atalhos aie/ai-engineering e dados de projeto separados. Fixar componentes/plataformas\
\ e verificar pacote antes de ativação, preservando versão anterior em falhas.\
\ Testar instalador com ferramentas simuladas e destinos descartáveis; smoke usa\
\ build local. Não executar instalação real nem tocar ~/.local/bin ou dependê\
ncias ativas."
acceptanceCriteria:
- "Pacote contém componentes corretos e o build nativo acessa uma base descartá\
vel sem depender da instalação global."
- "Fixtures verificam diretórios configuráveis, atalhos, atualização conjunta e\
\ falha sem danificar instalação anterior simulada."
- "Nenhum binário, biblioteca ou atalho ativo é substituído e o instalador real\
\ não é executado; a ativação posterior continua dependente de instrução humana."
dependsOn:
- "TSK-0002"
- "TSK-0011"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:37.290314Z"
- id: "TSK-0013"
title: "Consolidar documentação e instruções do framework local"
description: "Atualizar README, docs de arquitetura/protocolo/compatibilidade/migraç\
ão e recursos de entrada para memória local, SQLite, gates e retenção mínima.\
\ Explicar anexos temporários, outputs entregues, migração explícita e recuperaç\
ão, pacote preparado e instalação adiada. Remover instruções que apresentem arquivos\
\ de Works como fonte principal nova ou Git como exigência. Preservar orientaç\
ões dos dois ciclos, OODA, DEC/Plan e aprovações."
acceptanceCriteria:
- "Documentação e recursos distribuídos descrevem o mesmo contrato e permitem inicializar/retomar\
\ um projeto sem Git."
- "Procedimento público de migração explica prévia, efeitos e recuperação sem depender\
\ de inspeção do código interno."
- "Limites de retenção e instalação, papel dos gates e recortes futuros estão claros;\
\ fontes e exemplos não alegam testes ou migrações reais não executados."
dependsOn:
- "TSK-0010"
- "TSK-0011"
- "TSK-0012"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:45.331995Z"
- id: "TSK-0014"
title: "Executar regressão integrada e encaminhar responsividade ao WRK-000C"
description: "Integrar as verificações das etapas e executar gates apropriados de\
\ testes/arquitetura, migração, concorrência e smoke JVM/nativo em ambientes descartá\
veis. Revisar continuidade e autoridade nos dois ciclos, anexos temporários, recuperaç\
ão e funcionamento sem Git. Consolidar resultados mínimos, resolver experimentos/preocupaç\
ões e entregar cenário reproduzível ao WRK-000C com comandos, versão, dados e\
\ ambiente. Não instalar o pacote nem declarar resolvido o atraso."
acceptanceCriteria:
- "Suíte relevante de domínio/integração/compatibilidade, fixtures do instalador\
\ e smoke nativo passam ou impedimentos são tratados antes da conclusão."
- "Falhas, rollback, concorrência, legado, gates e descarte legítimo foram verificados\
\ com resultados reais e sem alteração da instalação ativa ou consumidores."
- "Todos os steps e critérios da DEC estão satisfeitos, sem experimentos/preocupaç\
ões pendentes; WRK-000C recebe cenário para medição futura e permanece aberto."
dependsOn:
- "TSK-0013"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:53.421052Z"
status: "ACTIVE"
author: "Codex"
createdAt: "2026-11-22T11:52:06.993736Z"
revision: 27
previousHash: "8bcede277e67c22d1880a8dd13b45cdf533f19bc198624dddbc59587a252f726"
updatedAt: "2026-11-22T12:43:49.770679Z"
updatedBy: "Codex"
changeReason: "Prosseguir para persistência de decisões, planos e experimentos, preservando\
\ aprovação, revisão e rollback."
experiments:
- id: "EXP-0001"
stepId: "TSK-0002"
hypothesis: "SQLite JDBC pode criar, persistir e reabrir uma base em processos JVM\
\ e Native Image com biblioteca distribuída ao lado do executável."
successCriterion: "As duas formas executam create/read/write/reopen e rollback em\
\ diretório descartável; o nativo usa a biblioteca do pacote com extração temporá\
ria indisponível; nenhum binário ativo ou consumidor é alterado."
invocation: "./gradlew sqliteProbeClasses nativeSqliteProbeCompile; scripts/sqlite-probe.sh\
\ <build>; execução da classe de prova JVM e do binário de build em processos\
\ distintos"
retryOf: null
reconsideration: null
by: "Codex"
createdAt: "2026-11-22T12:10:00.110720Z"
outcome: "CONFIRMED"
observation: "JVM criou e reabriu a base com UTF-8 e rollback. Native Image GraalVM\
\ 25 criou e reabriu em processos independentes com biblioteca externa e extraç\
ão sem escrita; a cópia isolada sem biblioteca falhou."
interpretation: "Driver SQLite JDBC 3.54.1.0 e biblioteca distribuída ao lado do\
\ nativo funcionam na plataforma macOS arm64. Seleção inicial de JDK foi corrigida\
\ explicitamente; sem instalação real."
nextAction: "Implementar infraestrutura transacional e esquema local no TSK-0003."
evidence:
- "ART-0002"
questionsDecision: null
finishedAt: "2026-11-22T12:16:43.109268Z"
finishedBy: "Codex"
documentVersion: 2
---
# Implementar memória de engenharia local em SQLite
## Autoridade e objetivo
Executar a DEC-0001 do WRK-000D, aceita explicitamente por Nilton nesta conversa.
O resultado é um framework local de memória de engenharia por Work, com SQLite
por projeto, investigação e implementação orientadas por OODA, gates preservados,
anexos temporários e retenção mínima. A aprovação desta DEC mantém a instalação
real adiada.
Este Plan foi solicitado com decomposição em vários steps. Todos os steps começam
OPEN; a criação do Plan não constitui execução ou comprovação de resultado.
## Limites obrigatórios
- Não instalar nem substituir o AIE, SQLite, bibliotecas ou atalhos em uso.
- Não executar o instalador real contra HOME, ~/.local/bin ou outro destino ativo.
Sua validação usa fixtures com ferramentas simuladas e destinos descartáveis.
- Não migrar este workspace canônico ou projetos consumidores. Exercitar o novo
backend e a migração em fixtures e cópias descartáveis; ativação real depende de
instrução humana posterior específica.
- Preservar alterações preexistentes, IDs, conteúdo e proveniência legada,
aprovações, evidências históricas e instruções do projeto fora do bloco gerido.
- Não introduzir arquivos em BLOB/base64 ou TEXT equivalente, retenção extensa,
executor autônomo de repositório, colaboração distribuída ou integração Git LFS.
- Importação/exportação de Works/DECs e backup como funcionalidade ficam fora.
A cópia de segurança da migração é parte da recuperação da conversão.
- Código e outputs solicitados permanecem nos destinos de entrega apropriados.
- O WRK-000C permanece aberto para avaliar e tratar latência após esta mudança.
## Execução e dependências
Os 14 steps possuem dependências explícitas e critérios próprios. Mapear primeiro
o contrato e o legado; provar a integração SQLite/JVM/Native Image; depois construir
as transações e migrar os fluxos de domínio. Integrar gates e ciclo dos anexos antes
de consolidar as consultas, a migração pública e o bootstrap. Preparar distribuição
e documentação e concluir com regressão integrada e encaminhamento ao WRK-000C.
Não iniciar um step com dependências pendentes. Verificações focadas fazem parte
de cada mudança; a última etapa integra os cenários e não substitui essas verificações.
Steps independentes podem ser executados em ordem compatível, sem presumir
autorização de delegação ou de instalação real.
## OODA e incertezas
Nas provas relevantes, principalmente driver/nativo, migração e descarte de anexos,
registrar hipótese, critério de sucesso e invocação antes de executar. Registrar
observação, interpretação e próxima ação após o resultado; reconsiderar antes de
repetir uma hipótese falha. Usar os registros de experimentos do Plan quando úteis,
sem impor um ritual de quatro fases a toda alteração.
Ajustar esquema, índices, transações e build dentro da DEC. Se um resultado
questionar a decisão, registrar a preocupação, continuar investigações autorizadas
e rever a DEC com aprovação aplicável antes da execução afetada.
## Verificação e registro mínimo
Durante a execução deste Work, respeitar o protocolo que está em uso. Registrar
resultados reais e evidência mínima necessária para completar os steps; não usar
a futura política de limpeza para apagar evidências legadas ou simular gates.
Verificar continuidade entre processos, integridade referencial, rollback,
concorrência local com espera limitada, autoridade humana, gates e anexos
temporários, migração repetível e operação sem Git. Provas nativas usam somente
artefatos de build e projetos descartáveis.
Comandos candidatos à validação, ajustados ao resultado e ao código final:
- `./gradlew test` e `./gradlew check` para a suíte e arquitetura do projeto.
- `python3 scripts/test-install-native.py` para fixtures do instalador.
- `./gradlew nativeCompile` e tarefas de distribuição para construir o pacote.
- `bash scripts/native-smoke.sh <caminho-absoluto-do-build>` em projetos descartáveis.
Esses comandos são planejados, não executados na criação do Plan. Preservar os
gates específicos do projeto e adicionais do Work definidos na execução. Logs de
trabalho podem ser temporários; guardar na memória somente o necessário ao contrato.
## Conclusão
Todos os steps obrigatórios devem satisfazer seus critérios, com a DEC aceita e
sem experimentos ou preocupações pendentes. A entrega é código, documentação,
pacote preparado e resultados de verificação. Não depende de instalar a nova
versão no ambiente em uso. Encaminhar ao WRK-000C um cenário reproduzível com
comandos, versão, volume e ambiente, sem declarar resolvido o problema de atraso.
@@ -0,0 +1,449 @@
---
schemaVersion: 1
id: "PLN-0001"
workId: "WRK-000D"
title: "Implementar memória de engenharia local em SQLite sem instalação ativa"
decisions:
- "DEC-0001"
steps:
- id: "TSK-0001"
title: "Mapear contrato, dados legados e cenários de migração"
description: "Inspecionar WorkService, serviços de Discussion/Decision/Plan/Agent,\
\ coordenadores e VerificationService. Mapear registros, referências, revisões,\
\ hashes, recibos e bootstrap para tabelas e regras do backend SQLite, preservando\
\ conteúdo e autoridade. Selecionar fixtures existentes de compatibilidade, workflows\
\ e importação como corpus; usar apenas cópias descartáveis. Identificar checks\
\ e pontos de retenção sem realizar benchmark conclusivo do WRK-000C."
acceptanceCriteria:
- "Mapeamento cobre entidades persistidas, IDs locais ao Work, referências, revisõ\
es, aprovações e casos de conclusão legada com hashes/recibos."
- "Corpus representativo e resultados esperados de continuidade/migração estão definidos\
\ antes da conversão, incluindo dados inválidos e estados interrompidos."
- "Limites de instalação, migração de consumidores e preservação do workspace atual\
\ estão explícitos e respeitados."
dependsOn: []
status: "COMPLETED"
result: "Contrato e legado mapeados em docs/sqlite-migration-design.md; corpus e\
\ casos de falha/retry definidos antes da migração. Baseline: 45 testes em seis\
\ classes passaram, hashes congelados conferidos e fontes históricas intactas.\
\ Sem instalação ou migração real."
evidence:
- "ART-0001"
updatedAt: "2026-11-22T12:00:26.700050Z"
- id: "TSK-0002"
title: "Provar driver SQLite em JVM e Native Image"
description: "Avaliar Xerial SQLite JDBC e fixar versão compatível com Java, Gradle\
\ e GraalVM do projeto. Registrar hipótese, critério e invocação antes da prova.\
\ Criar, gravar, ler e reabrir uma base descartável em processos JVM e nativos.\
\ Verificar carregamento da biblioteca distribuída ao lado do nativo; sqlite3\
\ será ferramenta de diagnóstico do pacote. Construir e executar somente artefatos\
\ descartáveis, sem instalação real."
acceptanceCriteria:
- "Driver e versão selecionados demonstram persistência e reabertura em JVM e Native\
\ Image na plataforma alvo."
- "Biblioteca do pacote é encontrada por caminho controlado e não depende acidentalmente\
\ do SQLite global ou de extração repetida não planejada."
- "Hipótese, resultado e limitações da prova estão registrados; instalação ativa\
\ e projetos consumidores não foram alterados."
dependsOn:
- "TSK-0001"
status: "COMPLETED"
result: "Prova JVM e Native Image passou create/read/write/reopen, UTF-8, rollback\
\ e dependência da biblioteca do pacote; sem instalação ativa."
evidence:
- "ART-0002"
updatedAt: "2026-11-22T12:16:52.149066Z"
- id: "TSK-0003"
title: "Implementar esquema, conexões e transações SQLite"
description: "Criar infraestrutura de persistência local em .ai-engineering/aie.db\
\ com esquema versionado, tabelas tipadas, índices e relações. Habilitar integridade\
\ referencial em cada conexão, delimitar unidade transacional por operação coerente\
\ e usar leitura consistente. Definir journal/durabilidade e espera limitada de\
\ escrita com diagnóstico. Preservar limites de módulos; serviços aninhados devem\
\ compartilhar a transação aplicável."
acceptanceCriteria:
- "Esquema e índices atendem ao mapeamento sem BLOB/base64 ou arquivos completos\
\ serializados em TEXT."
- "Falha em operação relacionada causa rollback; referências inválidas são recusadas\
\ e gravações concorrentes têm contenção limitada e diagnóstico útil."
- "Abertura de esquema incompatível é diagnosticada sem alterar dados; teste de\
\ leitura consistente cobre mudanças concorrentes locais."
dependsOn:
- "TSK-0001"
- "TSK-0002"
status: "COMPLETED"
result: "Infraestrutura SQLite validada: 12 testes de transação/integridade/concorrê\
ncia e arquitetura passaram; schema também criado e reaberto pelo Native Image.\
\ CLI de domínio e instalação ativa continuam intactos."
evidence:
- "ART-0003"
updatedAt: "2026-11-22T12:26:10.846492Z"
- id: "TSK-0004"
title: "Persistir Works e investigação no novo backend"
description: "Integrar Work, guidance e histórico de escolhas, discussões, tópicos,\
\ surveys, respostas e disposições à unidade de persistência. Preservar IDs existentes,\
\ semântica dos IDs locais, referências e histórico útil. Consultas selecionadas\
\ devem buscar o Work diretamente. Manter leitura legada delimitada para compatibilidade\
\ e migração; não manter duas fontes autoritativas para a mesma memória."
acceptanceCriteria:
- "Criar e retomar Work/discussão/survey em outro processo preserva conteúdo, histó\
rico de respostas e pendências."
- "Escolhas DIRECT/EXPLORATORY e autoridade humana mantêm as regras existentes,\
\ inclusive ausência de escolha e pedido específico de DEC."
- "Busca por Work e suas referências usa consultas com escopo adequado; alteraçõ\
es e referências relacionadas são transacionais."
dependsOn:
- "TSK-0003"
status: "COMPLETED"
result: "Works/investigação SQLite passaram 45 testes e retomada em outro JVM e\
\ nativo; referências transacionais, histórico e autoridade preservados."
evidence:
- "ART-0004"
updatedAt: "2026-11-22T12:43:38.166159Z"
- id: "TSK-0005"
title: "Persistir decisões, planos e experimentos"
description: "Integrar DecisionService e PlanService com revisões, aceitação, supersessã\
o, passos, dependências e experimentos. Preservar os dois ciclos e OODA, a autoridade\
\ de DEC/Plan e a distinção entre aprovação humana e promoção permitida por polí\
tica. Tratar operações que alteram registros relacionados em uma transação, sem\
\ reduzir os checks de domínio."
acceptanceCriteria:
- "Aprovação, revisão e supersessão preservam autoria e referências, sem fabricaç\
ão de aprovação ou edição silenciosa de decisão aceita."
- "Dependências e estados de passos, critérios de experimentos, preocupações com\
\ DEC e replanejamento conservam os bloqueios existentes."
- "Interrupção simulada não publica meia supersessão ou promoção parcial; retomada\
\ em outro processo preserva o contexto."
dependsOn:
- "TSK-0004"
status: "COMPLETED"
result: "Decisões/Plans/experimentos SQLite preservam autoridade, revisão, dependê\
ncias e rollback conjunto; 34 cenários distintos selecionados passaram ao final\
\ após ajuste textual de um teste."
evidence:
- "ART-0005"
updatedAt: "2026-11-22T12:54:10.341537Z"
- id: "TSK-0006"
title: "Integrar execuções de agentes e coordenação de EPICs"
description: "Persistir RUNs e seus dados operacionais mínimos, idempotência de\
\ requestId, referências aplicadas e diagnóstico. Integrar PlanCoordinator/EpicCoordinator,\
\ políticas e proveniência de conclusão, representando recibos internos como dados\
\ estruturados quando aplicável. Preservar a fronteira do adaptador: propostas\
\ não aprovam DEC, não respondem pelo humano nem executam comandos de repositó\
rio."
acceptanceCriteria:
- "Repetição idempotente de uma solicitação concluída não duplica registros; solicitaç\
ões divergentes e estados interrompidos são diagnosticados."
- "Políticas RESULTS/DECOMPOSITION, delegação, reabertura, propagação e conclusã\
o por Plans preservam autoridade e proveniência."
- "Resultados estruturados necessários permanecem; transporte bruto, ambiente e\
\ logs completos não viram acervo permanente no banco."
dependsOn:
- "TSK-0005"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:52:50.899228Z"
- id: "TSK-0007"
title: "Integrar gates do projeto e adicionais por Work"
description: "Representar gates obrigatórios do projeto e complementos do Work e\
\ conectar seus resultados aos checks e à entrega. Preservar avaliação externa\
\ e condições de qualidade, inclusive anexos exigidos. Registrar identificaçã\
o, procedimento/execução, estado avaliado, momento e resultado mínimo. Alteraç\
ões pertinentes invalidam a aplicação do resultado aos gates afetados; aprovaç\
ão humana não equivale a sucesso técnico."
acceptanceCriteria:
- "Gate obrigatório pendente, falho ou não executado bloqueia a entrega; gates adicionais\
\ do Work são considerados sem dispensar obrigatórios do projeto."
- "Resultados correspondem ao estado realmente avaliado e não satisfazem silenciosamente\
\ um gate após mudança relevante."
- "Checks existentes e anexos necessários continuam exigidos durante avaliação,\
\ sem introduzir executor autônomo ou retenção bruta obrigatória."
dependsOn:
- "TSK-0005"
- "TSK-0006"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:52:58.285586Z"
- id: "TSK-0008"
title: "Implementar anexos temporários e descarte após checks"
description: "Definir ciclo de vida de anexos e arquivos de execução no filesystem.\
\ Publicar arquivos completos, validar e registrar resultados mínimos antes do\
\ descarte; limpar elegíveis ao fim da execução. Proteger anexos ainda usados\
\ por checks pendentes e outputs solicitados. Recuperar falhas entre publicaçã\
o de arquivo, transação no banco e limpeza, distinguindo descarte legítimo de\
\ perda prematura. Não descartar artefatos legados deste workspace."
acceptanceCriteria:
- "Arquivos exigidos permanecem acessíveis até todos os checks dependentes terminarem,\
\ com resultado persistido antes da remoção."
- "Descarte automático preserva outputs solicitados e memória histórica; arquivo\
\ perdido antes da avaliação continua causando falha."
- "Interrupções nos pontos de publicação, registro e limpeza não fabricam sucesso\
\ e permitem recuperação sem remoção de entradas ainda necessárias."
dependsOn:
- "TSK-0007"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:05.800970Z"
- id: "TSK-0009"
title: "Adaptar verificação, status e contexto ao SQLite"
description: "Integrar VerificationService, CompatibilityService e projeções da\
\ CLI ao backend. Montar status, next-actions, context e readiness com consultas\
\ necessárias e resultados reutilizados na invocação; preservar contrato público\
\ quando compatível e informar mudanças. Separar resultado histórico com anexo\
\ descartado legitimamente de validação ativa. Manter diagnóstico de reparo e\
\ ausência de transições de estado em consultas."
acceptanceCriteria:
- "Consultas e contexto em processos novos preservam informações e autoridade e\
\ não promovem, migram ou concluem registros por leitura."
- "Anexos descartados legitimamente não invalidam histórico; corrupção e referê\
ncias ausentes não são tratadas como gates satisfeitos."
- "Caminhos selecionados não repetem varreduras/validações globais sem necessidade;\
\ saída e códigos de erro compatíveis são verificados."
dependsOn:
- "TSK-0004"
- "TSK-0005"
- "TSK-0006"
- "TSK-0008"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:13.390096Z"
- id: "TSK-0010"
title: "Implementar migração explícita e recuperável do legado"
description: "Criar comando público de prévia e aplicação da migração, sem conversã\
o em leituras ou atualização do instalador. Usar base de preparo e cópia de seguranç\
a da conversão, importação tipada transacional e verificação contra o corpus.\
\ Preservar IDs, conteúdo, aprovações, hashes, revisões e proveniência histórica\
\ sem despejar arquivos no banco. Ativar somente após sucesso; repetir ou recuperar\
\ interrupção sem duplicar. Executar apenas em fixtures/cópias descartáveis."
acceptanceCriteria:
- "Prévia não modifica o projeto; aplicação compara registros/contexto e ativa a\
\ base somente após validação completa."
- "Fixtures históricas, recibos, aprovações e referências preservam identidade/proveniê\
ncia; execução repetida não duplica conteúdo."
- "Falhas e interrupções deixam a fonte anterior recuperável e informam próxima\
\ ação; nenhum projeto real ou workspace canônico foi migrado."
dependsOn:
- "TSK-0001"
- "TSK-0009"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:21.074969Z"
- id: "TSK-0011"
title: "Atualizar init, descoberta e contrato de compatibilidade"
description: "Inicializar projetos locais em SQLite e deixar .ai-engineering ignorado\
\ pelo Git por padrão sem exigir Git. Preservar regras preexistentes e instruç\
ões fora do bloco gerido. Declarar backend e versões no contrato público, atualizar\
\ diagnóstico/onboard e evitar que base SQLite seja interpretada como workspace\
\ vazio por combinação incompatível. Manter tratamento explícito de projetos legados\
\ e previamente rastreados."
acceptanceCriteria:
- "Init cria projeto funcional sem Git, com estado local ignorado por padrão e bootstrap\
\ suficiente para humanos e agentes."
- "Reexecução preserva conteúdo/regras; não remove arquivos já rastreados nem converte\
\ legado automaticamente."
- "Versões e backend incompatíveis são recusados com diagnóstico acionável antes\
\ de escrita; documentação/entrypoints não induzem uso de CLI incompatível."
dependsOn:
- "TSK-0009"
- "TSK-0010"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:28.841960Z"
- id: "TSK-0012"
title: "Preparar pacote nativo e instalador conjunto sem ativação"
description: "Evoluir build/distribuição e scripts/install-native.sh para empacotar\
\ AIE nativo, biblioteca SQLite do driver e CLI sqlite3 num diretório configurá\
vel, com atalhos aie/ai-engineering e dados de projeto separados. Fixar componentes/plataformas\
\ e verificar pacote antes de ativação, preservando versão anterior em falhas.\
\ Testar instalador com ferramentas simuladas e destinos descartáveis; smoke usa\
\ build local. Não executar instalação real nem tocar ~/.local/bin ou dependê\
ncias ativas."
acceptanceCriteria:
- "Pacote contém componentes corretos e o build nativo acessa uma base descartá\
vel sem depender da instalação global."
- "Fixtures verificam diretórios configuráveis, atalhos, atualização conjunta e\
\ falha sem danificar instalação anterior simulada."
- "Nenhum binário, biblioteca ou atalho ativo é substituído e o instalador real\
\ não é executado; a ativação posterior continua dependente de instrução humana."
dependsOn:
- "TSK-0002"
- "TSK-0011"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:37.290314Z"
- id: "TSK-0013"
title: "Consolidar documentação e instruções do framework local"
description: "Atualizar README, docs de arquitetura/protocolo/compatibilidade/migraç\
ão e recursos de entrada para memória local, SQLite, gates e retenção mínima.\
\ Explicar anexos temporários, outputs entregues, migração explícita e recuperaç\
ão, pacote preparado e instalação adiada. Remover instruções que apresentem arquivos\
\ de Works como fonte principal nova ou Git como exigência. Preservar orientaç\
ões dos dois ciclos, OODA, DEC/Plan e aprovações."
acceptanceCriteria:
- "Documentação e recursos distribuídos descrevem o mesmo contrato e permitem inicializar/retomar\
\ um projeto sem Git."
- "Procedimento público de migração explica prévia, efeitos e recuperação sem depender\
\ de inspeção do código interno."
- "Limites de retenção e instalação, papel dos gates e recortes futuros estão claros;\
\ fontes e exemplos não alegam testes ou migrações reais não executados."
dependsOn:
- "TSK-0010"
- "TSK-0011"
- "TSK-0012"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:45.331995Z"
- id: "TSK-0014"
title: "Executar regressão integrada e encaminhar responsividade ao WRK-000C"
description: "Integrar as verificações das etapas e executar gates apropriados de\
\ testes/arquitetura, migração, concorrência e smoke JVM/nativo em ambientes descartá\
veis. Revisar continuidade e autoridade nos dois ciclos, anexos temporários, recuperaç\
ão e funcionamento sem Git. Consolidar resultados mínimos, resolver experimentos/preocupaç\
ões e entregar cenário reproduzível ao WRK-000C com comandos, versão, dados e\
\ ambiente. Não instalar o pacote nem declarar resolvido o atraso."
acceptanceCriteria:
- "Suíte relevante de domínio/integração/compatibilidade, fixtures do instalador\
\ e smoke nativo passam ou impedimentos são tratados antes da conclusão."
- "Falhas, rollback, concorrência, legado, gates e descarte legítimo foram verificados\
\ com resultados reais e sem alteração da instalação ativa ou consumidores."
- "Todos os steps e critérios da DEC estão satisfeitos, sem experimentos/preocupaç\
ões pendentes; WRK-000C recebe cenário para medição futura e permanece aberto."
dependsOn:
- "TSK-0013"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:53.421052Z"
status: "ACTIVE"
author: "Codex"
createdAt: "2026-11-22T11:52:06.993736Z"
revision: 28
previousHash: "c95e42363b9a422460f20bbfb49f606a433f0ef06230d96f9f4a116ffb819949"
updatedAt: "2026-11-22T12:54:10.341713Z"
updatedBy: "Codex"
changeReason: "Decisões/Plans/experimentos SQLite preservam autoridade, revisão, dependê\
ncias e rollback conjunto; 34 cenários distintos selecionados passaram ao final\
\ após ajuste textual de um teste."
experiments:
- id: "EXP-0001"
stepId: "TSK-0002"
hypothesis: "SQLite JDBC pode criar, persistir e reabrir uma base em processos JVM\
\ e Native Image com biblioteca distribuída ao lado do executável."
successCriterion: "As duas formas executam create/read/write/reopen e rollback em\
\ diretório descartável; o nativo usa a biblioteca do pacote com extração temporá\
ria indisponível; nenhum binário ativo ou consumidor é alterado."
invocation: "./gradlew sqliteProbeClasses nativeSqliteProbeCompile; scripts/sqlite-probe.sh\
\ <build>; execução da classe de prova JVM e do binário de build em processos\
\ distintos"
retryOf: null
reconsideration: null
by: "Codex"
createdAt: "2026-11-22T12:10:00.110720Z"
outcome: "CONFIRMED"
observation: "JVM criou e reabriu a base com UTF-8 e rollback. Native Image GraalVM\
\ 25 criou e reabriu em processos independentes com biblioteca externa e extraç\
ão sem escrita; a cópia isolada sem biblioteca falhou."
interpretation: "Driver SQLite JDBC 3.54.1.0 e biblioteca distribuída ao lado do\
\ nativo funcionam na plataforma macOS arm64. Seleção inicial de JDK foi corrigida\
\ explicitamente; sem instalação real."
nextAction: "Implementar infraestrutura transacional e esquema local no TSK-0003."
evidence:
- "ART-0002"
questionsDecision: null
finishedAt: "2026-11-22T12:16:43.109268Z"
finishedBy: "Codex"
documentVersion: 2
---
# Implementar memória de engenharia local em SQLite
## Autoridade e objetivo
Executar a DEC-0001 do WRK-000D, aceita explicitamente por Nilton nesta conversa.
O resultado é um framework local de memória de engenharia por Work, com SQLite
por projeto, investigação e implementação orientadas por OODA, gates preservados,
anexos temporários e retenção mínima. A aprovação desta DEC mantém a instalação
real adiada.
Este Plan foi solicitado com decomposição em vários steps. Todos os steps começam
OPEN; a criação do Plan não constitui execução ou comprovação de resultado.
## Limites obrigatórios
- Não instalar nem substituir o AIE, SQLite, bibliotecas ou atalhos em uso.
- Não executar o instalador real contra HOME, ~/.local/bin ou outro destino ativo.
Sua validação usa fixtures com ferramentas simuladas e destinos descartáveis.
- Não migrar este workspace canônico ou projetos consumidores. Exercitar o novo
backend e a migração em fixtures e cópias descartáveis; ativação real depende de
instrução humana posterior específica.
- Preservar alterações preexistentes, IDs, conteúdo e proveniência legada,
aprovações, evidências históricas e instruções do projeto fora do bloco gerido.
- Não introduzir arquivos em BLOB/base64 ou TEXT equivalente, retenção extensa,
executor autônomo de repositório, colaboração distribuída ou integração Git LFS.
- Importação/exportação de Works/DECs e backup como funcionalidade ficam fora.
A cópia de segurança da migração é parte da recuperação da conversão.
- Código e outputs solicitados permanecem nos destinos de entrega apropriados.
- O WRK-000C permanece aberto para avaliar e tratar latência após esta mudança.
## Execução e dependências
Os 14 steps possuem dependências explícitas e critérios próprios. Mapear primeiro
o contrato e o legado; provar a integração SQLite/JVM/Native Image; depois construir
as transações e migrar os fluxos de domínio. Integrar gates e ciclo dos anexos antes
de consolidar as consultas, a migração pública e o bootstrap. Preparar distribuição
e documentação e concluir com regressão integrada e encaminhamento ao WRK-000C.
Não iniciar um step com dependências pendentes. Verificações focadas fazem parte
de cada mudança; a última etapa integra os cenários e não substitui essas verificações.
Steps independentes podem ser executados em ordem compatível, sem presumir
autorização de delegação ou de instalação real.
## OODA e incertezas
Nas provas relevantes, principalmente driver/nativo, migração e descarte de anexos,
registrar hipótese, critério de sucesso e invocação antes de executar. Registrar
observação, interpretação e próxima ação após o resultado; reconsiderar antes de
repetir uma hipótese falha. Usar os registros de experimentos do Plan quando úteis,
sem impor um ritual de quatro fases a toda alteração.
Ajustar esquema, índices, transações e build dentro da DEC. Se um resultado
questionar a decisão, registrar a preocupação, continuar investigações autorizadas
e rever a DEC com aprovação aplicável antes da execução afetada.
## Verificação e registro mínimo
Durante a execução deste Work, respeitar o protocolo que está em uso. Registrar
resultados reais e evidência mínima necessária para completar os steps; não usar
a futura política de limpeza para apagar evidências legadas ou simular gates.
Verificar continuidade entre processos, integridade referencial, rollback,
concorrência local com espera limitada, autoridade humana, gates e anexos
temporários, migração repetível e operação sem Git. Provas nativas usam somente
artefatos de build e projetos descartáveis.
Comandos candidatos à validação, ajustados ao resultado e ao código final:
- `./gradlew test` e `./gradlew check` para a suíte e arquitetura do projeto.
- `python3 scripts/test-install-native.py` para fixtures do instalador.
- `./gradlew nativeCompile` e tarefas de distribuição para construir o pacote.
- `bash scripts/native-smoke.sh <caminho-absoluto-do-build>` em projetos descartáveis.
Esses comandos são planejados, não executados na criação do Plan. Preservar os
gates específicos do projeto e adicionais do Work definidos na execução. Logs de
trabalho podem ser temporários; guardar na memória somente o necessário ao contrato.
## Conclusão
Todos os steps obrigatórios devem satisfazer seus critérios, com a DEC aceita e
sem experimentos ou preocupações pendentes. A entrega é código, documentação,
pacote preparado e resultados de verificação. Não depende de instalar a nova
versão no ambiente em uso. Encaminhar ao WRK-000C um cenário reproduzível com
comandos, versão, volume e ambiente, sem declarar resolvido o problema de atraso.
@@ -0,0 +1,448 @@
---
schemaVersion: 1
id: "PLN-0001"
workId: "WRK-000D"
title: "Implementar memória de engenharia local em SQLite sem instalação ativa"
decisions:
- "DEC-0001"
steps:
- id: "TSK-0001"
title: "Mapear contrato, dados legados e cenários de migração"
description: "Inspecionar WorkService, serviços de Discussion/Decision/Plan/Agent,\
\ coordenadores e VerificationService. Mapear registros, referências, revisões,\
\ hashes, recibos e bootstrap para tabelas e regras do backend SQLite, preservando\
\ conteúdo e autoridade. Selecionar fixtures existentes de compatibilidade, workflows\
\ e importação como corpus; usar apenas cópias descartáveis. Identificar checks\
\ e pontos de retenção sem realizar benchmark conclusivo do WRK-000C."
acceptanceCriteria:
- "Mapeamento cobre entidades persistidas, IDs locais ao Work, referências, revisõ\
es, aprovações e casos de conclusão legada com hashes/recibos."
- "Corpus representativo e resultados esperados de continuidade/migração estão definidos\
\ antes da conversão, incluindo dados inválidos e estados interrompidos."
- "Limites de instalação, migração de consumidores e preservação do workspace atual\
\ estão explícitos e respeitados."
dependsOn: []
status: "COMPLETED"
result: "Contrato e legado mapeados em docs/sqlite-migration-design.md; corpus e\
\ casos de falha/retry definidos antes da migração. Baseline: 45 testes em seis\
\ classes passaram, hashes congelados conferidos e fontes históricas intactas.\
\ Sem instalação ou migração real."
evidence:
- "ART-0001"
updatedAt: "2026-11-22T12:00:26.700050Z"
- id: "TSK-0002"
title: "Provar driver SQLite em JVM e Native Image"
description: "Avaliar Xerial SQLite JDBC e fixar versão compatível com Java, Gradle\
\ e GraalVM do projeto. Registrar hipótese, critério e invocação antes da prova.\
\ Criar, gravar, ler e reabrir uma base descartável em processos JVM e nativos.\
\ Verificar carregamento da biblioteca distribuída ao lado do nativo; sqlite3\
\ será ferramenta de diagnóstico do pacote. Construir e executar somente artefatos\
\ descartáveis, sem instalação real."
acceptanceCriteria:
- "Driver e versão selecionados demonstram persistência e reabertura em JVM e Native\
\ Image na plataforma alvo."
- "Biblioteca do pacote é encontrada por caminho controlado e não depende acidentalmente\
\ do SQLite global ou de extração repetida não planejada."
- "Hipótese, resultado e limitações da prova estão registrados; instalação ativa\
\ e projetos consumidores não foram alterados."
dependsOn:
- "TSK-0001"
status: "COMPLETED"
result: "Prova JVM e Native Image passou create/read/write/reopen, UTF-8, rollback\
\ e dependência da biblioteca do pacote; sem instalação ativa."
evidence:
- "ART-0002"
updatedAt: "2026-11-22T12:16:52.149066Z"
- id: "TSK-0003"
title: "Implementar esquema, conexões e transações SQLite"
description: "Criar infraestrutura de persistência local em .ai-engineering/aie.db\
\ com esquema versionado, tabelas tipadas, índices e relações. Habilitar integridade\
\ referencial em cada conexão, delimitar unidade transacional por operação coerente\
\ e usar leitura consistente. Definir journal/durabilidade e espera limitada de\
\ escrita com diagnóstico. Preservar limites de módulos; serviços aninhados devem\
\ compartilhar a transação aplicável."
acceptanceCriteria:
- "Esquema e índices atendem ao mapeamento sem BLOB/base64 ou arquivos completos\
\ serializados em TEXT."
- "Falha em operação relacionada causa rollback; referências inválidas são recusadas\
\ e gravações concorrentes têm contenção limitada e diagnóstico útil."
- "Abertura de esquema incompatível é diagnosticada sem alterar dados; teste de\
\ leitura consistente cobre mudanças concorrentes locais."
dependsOn:
- "TSK-0001"
- "TSK-0002"
status: "COMPLETED"
result: "Infraestrutura SQLite validada: 12 testes de transação/integridade/concorrê\
ncia e arquitetura passaram; schema também criado e reaberto pelo Native Image.\
\ CLI de domínio e instalação ativa continuam intactos."
evidence:
- "ART-0003"
updatedAt: "2026-11-22T12:26:10.846492Z"
- id: "TSK-0004"
title: "Persistir Works e investigação no novo backend"
description: "Integrar Work, guidance e histórico de escolhas, discussões, tópicos,\
\ surveys, respostas e disposições à unidade de persistência. Preservar IDs existentes,\
\ semântica dos IDs locais, referências e histórico útil. Consultas selecionadas\
\ devem buscar o Work diretamente. Manter leitura legada delimitada para compatibilidade\
\ e migração; não manter duas fontes autoritativas para a mesma memória."
acceptanceCriteria:
- "Criar e retomar Work/discussão/survey em outro processo preserva conteúdo, histó\
rico de respostas e pendências."
- "Escolhas DIRECT/EXPLORATORY e autoridade humana mantêm as regras existentes,\
\ inclusive ausência de escolha e pedido específico de DEC."
- "Busca por Work e suas referências usa consultas com escopo adequado; alteraçõ\
es e referências relacionadas são transacionais."
dependsOn:
- "TSK-0003"
status: "COMPLETED"
result: "Works/investigação SQLite passaram 45 testes e retomada em outro JVM e\
\ nativo; referências transacionais, histórico e autoridade preservados."
evidence:
- "ART-0004"
updatedAt: "2026-11-22T12:43:38.166159Z"
- id: "TSK-0005"
title: "Persistir decisões, planos e experimentos"
description: "Integrar DecisionService e PlanService com revisões, aceitação, supersessã\
o, passos, dependências e experimentos. Preservar os dois ciclos e OODA, a autoridade\
\ de DEC/Plan e a distinção entre aprovação humana e promoção permitida por polí\
tica. Tratar operações que alteram registros relacionados em uma transação, sem\
\ reduzir os checks de domínio."
acceptanceCriteria:
- "Aprovação, revisão e supersessão preservam autoria e referências, sem fabricaç\
ão de aprovação ou edição silenciosa de decisão aceita."
- "Dependências e estados de passos, critérios de experimentos, preocupações com\
\ DEC e replanejamento conservam os bloqueios existentes."
- "Interrupção simulada não publica meia supersessão ou promoção parcial; retomada\
\ em outro processo preserva o contexto."
dependsOn:
- "TSK-0004"
status: "COMPLETED"
result: "Decisões/Plans/experimentos SQLite preservam autoridade, revisão, dependê\
ncias e rollback conjunto; 34 cenários distintos selecionados passaram ao final\
\ após ajuste textual de um teste."
evidence:
- "ART-0005"
updatedAt: "2026-11-22T12:54:10.341537Z"
- id: "TSK-0006"
title: "Integrar execuções de agentes e coordenação de EPICs"
description: "Persistir RUNs e seus dados operacionais mínimos, idempotência de\
\ requestId, referências aplicadas e diagnóstico. Integrar PlanCoordinator/EpicCoordinator,\
\ políticas e proveniência de conclusão, representando recibos internos como dados\
\ estruturados quando aplicável. Preservar a fronteira do adaptador: propostas\
\ não aprovam DEC, não respondem pelo humano nem executam comandos de repositó\
rio."
acceptanceCriteria:
- "Repetição idempotente de uma solicitação concluída não duplica registros; solicitaç\
ões divergentes e estados interrompidos são diagnosticados."
- "Políticas RESULTS/DECOMPOSITION, delegação, reabertura, propagação e conclusã\
o por Plans preservam autoridade e proveniência."
- "Resultados estruturados necessários permanecem; transporte bruto, ambiente e\
\ logs completos não viram acervo permanente no banco."
dependsOn:
- "TSK-0005"
status: "ACTIVE"
result: "Integrar RUNs, idempotência e coordenação EPIC/Plans na persistência local."
evidence: []
updatedAt: "2026-11-22T12:54:20.537359Z"
- id: "TSK-0007"
title: "Integrar gates do projeto e adicionais por Work"
description: "Representar gates obrigatórios do projeto e complementos do Work e\
\ conectar seus resultados aos checks e à entrega. Preservar avaliação externa\
\ e condições de qualidade, inclusive anexos exigidos. Registrar identificaçã\
o, procedimento/execução, estado avaliado, momento e resultado mínimo. Alteraç\
ões pertinentes invalidam a aplicação do resultado aos gates afetados; aprovaç\
ão humana não equivale a sucesso técnico."
acceptanceCriteria:
- "Gate obrigatório pendente, falho ou não executado bloqueia a entrega; gates adicionais\
\ do Work são considerados sem dispensar obrigatórios do projeto."
- "Resultados correspondem ao estado realmente avaliado e não satisfazem silenciosamente\
\ um gate após mudança relevante."
- "Checks existentes e anexos necessários continuam exigidos durante avaliação,\
\ sem introduzir executor autônomo ou retenção bruta obrigatória."
dependsOn:
- "TSK-0005"
- "TSK-0006"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:52:58.285586Z"
- id: "TSK-0008"
title: "Implementar anexos temporários e descarte após checks"
description: "Definir ciclo de vida de anexos e arquivos de execução no filesystem.\
\ Publicar arquivos completos, validar e registrar resultados mínimos antes do\
\ descarte; limpar elegíveis ao fim da execução. Proteger anexos ainda usados\
\ por checks pendentes e outputs solicitados. Recuperar falhas entre publicaçã\
o de arquivo, transação no banco e limpeza, distinguindo descarte legítimo de\
\ perda prematura. Não descartar artefatos legados deste workspace."
acceptanceCriteria:
- "Arquivos exigidos permanecem acessíveis até todos os checks dependentes terminarem,\
\ com resultado persistido antes da remoção."
- "Descarte automático preserva outputs solicitados e memória histórica; arquivo\
\ perdido antes da avaliação continua causando falha."
- "Interrupções nos pontos de publicação, registro e limpeza não fabricam sucesso\
\ e permitem recuperação sem remoção de entradas ainda necessárias."
dependsOn:
- "TSK-0007"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:05.800970Z"
- id: "TSK-0009"
title: "Adaptar verificação, status e contexto ao SQLite"
description: "Integrar VerificationService, CompatibilityService e projeções da\
\ CLI ao backend. Montar status, next-actions, context e readiness com consultas\
\ necessárias e resultados reutilizados na invocação; preservar contrato público\
\ quando compatível e informar mudanças. Separar resultado histórico com anexo\
\ descartado legitimamente de validação ativa. Manter diagnóstico de reparo e\
\ ausência de transições de estado em consultas."
acceptanceCriteria:
- "Consultas e contexto em processos novos preservam informações e autoridade e\
\ não promovem, migram ou concluem registros por leitura."
- "Anexos descartados legitimamente não invalidam histórico; corrupção e referê\
ncias ausentes não são tratadas como gates satisfeitos."
- "Caminhos selecionados não repetem varreduras/validações globais sem necessidade;\
\ saída e códigos de erro compatíveis são verificados."
dependsOn:
- "TSK-0004"
- "TSK-0005"
- "TSK-0006"
- "TSK-0008"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:13.390096Z"
- id: "TSK-0010"
title: "Implementar migração explícita e recuperável do legado"
description: "Criar comando público de prévia e aplicação da migração, sem conversã\
o em leituras ou atualização do instalador. Usar base de preparo e cópia de seguranç\
a da conversão, importação tipada transacional e verificação contra o corpus.\
\ Preservar IDs, conteúdo, aprovações, hashes, revisões e proveniência histórica\
\ sem despejar arquivos no banco. Ativar somente após sucesso; repetir ou recuperar\
\ interrupção sem duplicar. Executar apenas em fixtures/cópias descartáveis."
acceptanceCriteria:
- "Prévia não modifica o projeto; aplicação compara registros/contexto e ativa a\
\ base somente após validação completa."
- "Fixtures históricas, recibos, aprovações e referências preservam identidade/proveniê\
ncia; execução repetida não duplica conteúdo."
- "Falhas e interrupções deixam a fonte anterior recuperável e informam próxima\
\ ação; nenhum projeto real ou workspace canônico foi migrado."
dependsOn:
- "TSK-0001"
- "TSK-0009"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:21.074969Z"
- id: "TSK-0011"
title: "Atualizar init, descoberta e contrato de compatibilidade"
description: "Inicializar projetos locais em SQLite e deixar .ai-engineering ignorado\
\ pelo Git por padrão sem exigir Git. Preservar regras preexistentes e instruç\
ões fora do bloco gerido. Declarar backend e versões no contrato público, atualizar\
\ diagnóstico/onboard e evitar que base SQLite seja interpretada como workspace\
\ vazio por combinação incompatível. Manter tratamento explícito de projetos legados\
\ e previamente rastreados."
acceptanceCriteria:
- "Init cria projeto funcional sem Git, com estado local ignorado por padrão e bootstrap\
\ suficiente para humanos e agentes."
- "Reexecução preserva conteúdo/regras; não remove arquivos já rastreados nem converte\
\ legado automaticamente."
- "Versões e backend incompatíveis são recusados com diagnóstico acionável antes\
\ de escrita; documentação/entrypoints não induzem uso de CLI incompatível."
dependsOn:
- "TSK-0009"
- "TSK-0010"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:28.841960Z"
- id: "TSK-0012"
title: "Preparar pacote nativo e instalador conjunto sem ativação"
description: "Evoluir build/distribuição e scripts/install-native.sh para empacotar\
\ AIE nativo, biblioteca SQLite do driver e CLI sqlite3 num diretório configurá\
vel, com atalhos aie/ai-engineering e dados de projeto separados. Fixar componentes/plataformas\
\ e verificar pacote antes de ativação, preservando versão anterior em falhas.\
\ Testar instalador com ferramentas simuladas e destinos descartáveis; smoke usa\
\ build local. Não executar instalação real nem tocar ~/.local/bin ou dependê\
ncias ativas."
acceptanceCriteria:
- "Pacote contém componentes corretos e o build nativo acessa uma base descartá\
vel sem depender da instalação global."
- "Fixtures verificam diretórios configuráveis, atalhos, atualização conjunta e\
\ falha sem danificar instalação anterior simulada."
- "Nenhum binário, biblioteca ou atalho ativo é substituído e o instalador real\
\ não é executado; a ativação posterior continua dependente de instrução humana."
dependsOn:
- "TSK-0002"
- "TSK-0011"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:37.290314Z"
- id: "TSK-0013"
title: "Consolidar documentação e instruções do framework local"
description: "Atualizar README, docs de arquitetura/protocolo/compatibilidade/migraç\
ão e recursos de entrada para memória local, SQLite, gates e retenção mínima.\
\ Explicar anexos temporários, outputs entregues, migração explícita e recuperaç\
ão, pacote preparado e instalação adiada. Remover instruções que apresentem arquivos\
\ de Works como fonte principal nova ou Git como exigência. Preservar orientaç\
ões dos dois ciclos, OODA, DEC/Plan e aprovações."
acceptanceCriteria:
- "Documentação e recursos distribuídos descrevem o mesmo contrato e permitem inicializar/retomar\
\ um projeto sem Git."
- "Procedimento público de migração explica prévia, efeitos e recuperação sem depender\
\ de inspeção do código interno."
- "Limites de retenção e instalação, papel dos gates e recortes futuros estão claros;\
\ fontes e exemplos não alegam testes ou migrações reais não executados."
dependsOn:
- "TSK-0010"
- "TSK-0011"
- "TSK-0012"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:45.331995Z"
- id: "TSK-0014"
title: "Executar regressão integrada e encaminhar responsividade ao WRK-000C"
description: "Integrar as verificações das etapas e executar gates apropriados de\
\ testes/arquitetura, migração, concorrência e smoke JVM/nativo em ambientes descartá\
veis. Revisar continuidade e autoridade nos dois ciclos, anexos temporários, recuperaç\
ão e funcionamento sem Git. Consolidar resultados mínimos, resolver experimentos/preocupaç\
ões e entregar cenário reproduzível ao WRK-000C com comandos, versão, dados e\
\ ambiente. Não instalar o pacote nem declarar resolvido o atraso."
acceptanceCriteria:
- "Suíte relevante de domínio/integração/compatibilidade, fixtures do instalador\
\ e smoke nativo passam ou impedimentos são tratados antes da conclusão."
- "Falhas, rollback, concorrência, legado, gates e descarte legítimo foram verificados\
\ com resultados reais e sem alteração da instalação ativa ou consumidores."
- "Todos os steps e critérios da DEC estão satisfeitos, sem experimentos/preocupaç\
ões pendentes; WRK-000C recebe cenário para medição futura e permanece aberto."
dependsOn:
- "TSK-0013"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:53.421052Z"
status: "ACTIVE"
author: "Codex"
createdAt: "2026-11-22T11:52:06.993736Z"
revision: 29
previousHash: "44f025ca24fd0dbeed6a56368b6845fd5003b96a0aeb8711fe898df66b7ee206"
updatedAt: "2026-11-22T12:54:20.537526Z"
updatedBy: "Codex"
changeReason: "Integrar RUNs, idempotência e coordenação EPIC/Plans na persistência\
\ local."
experiments:
- id: "EXP-0001"
stepId: "TSK-0002"
hypothesis: "SQLite JDBC pode criar, persistir e reabrir uma base em processos JVM\
\ e Native Image com biblioteca distribuída ao lado do executável."
successCriterion: "As duas formas executam create/read/write/reopen e rollback em\
\ diretório descartável; o nativo usa a biblioteca do pacote com extração temporá\
ria indisponível; nenhum binário ativo ou consumidor é alterado."
invocation: "./gradlew sqliteProbeClasses nativeSqliteProbeCompile; scripts/sqlite-probe.sh\
\ <build>; execução da classe de prova JVM e do binário de build em processos\
\ distintos"
retryOf: null
reconsideration: null
by: "Codex"
createdAt: "2026-11-22T12:10:00.110720Z"
outcome: "CONFIRMED"
observation: "JVM criou e reabriu a base com UTF-8 e rollback. Native Image GraalVM\
\ 25 criou e reabriu em processos independentes com biblioteca externa e extraç\
ão sem escrita; a cópia isolada sem biblioteca falhou."
interpretation: "Driver SQLite JDBC 3.54.1.0 e biblioteca distribuída ao lado do\
\ nativo funcionam na plataforma macOS arm64. Seleção inicial de JDK foi corrigida\
\ explicitamente; sem instalação real."
nextAction: "Implementar infraestrutura transacional e esquema local no TSK-0003."
evidence:
- "ART-0002"
questionsDecision: null
finishedAt: "2026-11-22T12:16:43.109268Z"
finishedBy: "Codex"
documentVersion: 2
---
# Implementar memória de engenharia local em SQLite
## Autoridade e objetivo
Executar a DEC-0001 do WRK-000D, aceita explicitamente por Nilton nesta conversa.
O resultado é um framework local de memória de engenharia por Work, com SQLite
por projeto, investigação e implementação orientadas por OODA, gates preservados,
anexos temporários e retenção mínima. A aprovação desta DEC mantém a instalação
real adiada.
Este Plan foi solicitado com decomposição em vários steps. Todos os steps começam
OPEN; a criação do Plan não constitui execução ou comprovação de resultado.
## Limites obrigatórios
- Não instalar nem substituir o AIE, SQLite, bibliotecas ou atalhos em uso.
- Não executar o instalador real contra HOME, ~/.local/bin ou outro destino ativo.
Sua validação usa fixtures com ferramentas simuladas e destinos descartáveis.
- Não migrar este workspace canônico ou projetos consumidores. Exercitar o novo
backend e a migração em fixtures e cópias descartáveis; ativação real depende de
instrução humana posterior específica.
- Preservar alterações preexistentes, IDs, conteúdo e proveniência legada,
aprovações, evidências históricas e instruções do projeto fora do bloco gerido.
- Não introduzir arquivos em BLOB/base64 ou TEXT equivalente, retenção extensa,
executor autônomo de repositório, colaboração distribuída ou integração Git LFS.
- Importação/exportação de Works/DECs e backup como funcionalidade ficam fora.
A cópia de segurança da migração é parte da recuperação da conversão.
- Código e outputs solicitados permanecem nos destinos de entrega apropriados.
- O WRK-000C permanece aberto para avaliar e tratar latência após esta mudança.
## Execução e dependências
Os 14 steps possuem dependências explícitas e critérios próprios. Mapear primeiro
o contrato e o legado; provar a integração SQLite/JVM/Native Image; depois construir
as transações e migrar os fluxos de domínio. Integrar gates e ciclo dos anexos antes
de consolidar as consultas, a migração pública e o bootstrap. Preparar distribuição
e documentação e concluir com regressão integrada e encaminhamento ao WRK-000C.
Não iniciar um step com dependências pendentes. Verificações focadas fazem parte
de cada mudança; a última etapa integra os cenários e não substitui essas verificações.
Steps independentes podem ser executados em ordem compatível, sem presumir
autorização de delegação ou de instalação real.
## OODA e incertezas
Nas provas relevantes, principalmente driver/nativo, migração e descarte de anexos,
registrar hipótese, critério de sucesso e invocação antes de executar. Registrar
observação, interpretação e próxima ação após o resultado; reconsiderar antes de
repetir uma hipótese falha. Usar os registros de experimentos do Plan quando úteis,
sem impor um ritual de quatro fases a toda alteração.
Ajustar esquema, índices, transações e build dentro da DEC. Se um resultado
questionar a decisão, registrar a preocupação, continuar investigações autorizadas
e rever a DEC com aprovação aplicável antes da execução afetada.
## Verificação e registro mínimo
Durante a execução deste Work, respeitar o protocolo que está em uso. Registrar
resultados reais e evidência mínima necessária para completar os steps; não usar
a futura política de limpeza para apagar evidências legadas ou simular gates.
Verificar continuidade entre processos, integridade referencial, rollback,
concorrência local com espera limitada, autoridade humana, gates e anexos
temporários, migração repetível e operação sem Git. Provas nativas usam somente
artefatos de build e projetos descartáveis.
Comandos candidatos à validação, ajustados ao resultado e ao código final:
- `./gradlew test` e `./gradlew check` para a suíte e arquitetura do projeto.
- `python3 scripts/test-install-native.py` para fixtures do instalador.
- `./gradlew nativeCompile` e tarefas de distribuição para construir o pacote.
- `bash scripts/native-smoke.sh <caminho-absoluto-do-build>` em projetos descartáveis.
Esses comandos são planejados, não executados na criação do Plan. Preservar os
gates específicos do projeto e adicionais do Work definidos na execução. Logs de
trabalho podem ser temporários; guardar na memória somente o necessário ao contrato.
## Conclusão
Todos os steps obrigatórios devem satisfazer seus critérios, com a DEC aceita e
sem experimentos ou preocupações pendentes. A entrega é código, documentação,
pacote preparado e resultados de verificação. Não depende de instalar a nova
versão no ambiente em uso. Encaminhar ao WRK-000C um cenário reproduzível com
comandos, versão, volume e ambiente, sem declarar resolvido o problema de atraso.
@@ -0,0 +1,450 @@
---
schemaVersion: 1
id: "PLN-0001"
workId: "WRK-000D"
title: "Implementar memória de engenharia local em SQLite sem instalação ativa"
decisions:
- "DEC-0001"
steps:
- id: "TSK-0001"
title: "Mapear contrato, dados legados e cenários de migração"
description: "Inspecionar WorkService, serviços de Discussion/Decision/Plan/Agent,\
\ coordenadores e VerificationService. Mapear registros, referências, revisões,\
\ hashes, recibos e bootstrap para tabelas e regras do backend SQLite, preservando\
\ conteúdo e autoridade. Selecionar fixtures existentes de compatibilidade, workflows\
\ e importação como corpus; usar apenas cópias descartáveis. Identificar checks\
\ e pontos de retenção sem realizar benchmark conclusivo do WRK-000C."
acceptanceCriteria:
- "Mapeamento cobre entidades persistidas, IDs locais ao Work, referências, revisõ\
es, aprovações e casos de conclusão legada com hashes/recibos."
- "Corpus representativo e resultados esperados de continuidade/migração estão definidos\
\ antes da conversão, incluindo dados inválidos e estados interrompidos."
- "Limites de instalação, migração de consumidores e preservação do workspace atual\
\ estão explícitos e respeitados."
dependsOn: []
status: "COMPLETED"
result: "Contrato e legado mapeados em docs/sqlite-migration-design.md; corpus e\
\ casos de falha/retry definidos antes da migração. Baseline: 45 testes em seis\
\ classes passaram, hashes congelados conferidos e fontes históricas intactas.\
\ Sem instalação ou migração real."
evidence:
- "ART-0001"
updatedAt: "2026-11-22T12:00:26.700050Z"
- id: "TSK-0002"
title: "Provar driver SQLite em JVM e Native Image"
description: "Avaliar Xerial SQLite JDBC e fixar versão compatível com Java, Gradle\
\ e GraalVM do projeto. Registrar hipótese, critério e invocação antes da prova.\
\ Criar, gravar, ler e reabrir uma base descartável em processos JVM e nativos.\
\ Verificar carregamento da biblioteca distribuída ao lado do nativo; sqlite3\
\ será ferramenta de diagnóstico do pacote. Construir e executar somente artefatos\
\ descartáveis, sem instalação real."
acceptanceCriteria:
- "Driver e versão selecionados demonstram persistência e reabertura em JVM e Native\
\ Image na plataforma alvo."
- "Biblioteca do pacote é encontrada por caminho controlado e não depende acidentalmente\
\ do SQLite global ou de extração repetida não planejada."
- "Hipótese, resultado e limitações da prova estão registrados; instalação ativa\
\ e projetos consumidores não foram alterados."
dependsOn:
- "TSK-0001"
status: "COMPLETED"
result: "Prova JVM e Native Image passou create/read/write/reopen, UTF-8, rollback\
\ e dependência da biblioteca do pacote; sem instalação ativa."
evidence:
- "ART-0002"
updatedAt: "2026-11-22T12:16:52.149066Z"
- id: "TSK-0003"
title: "Implementar esquema, conexões e transações SQLite"
description: "Criar infraestrutura de persistência local em .ai-engineering/aie.db\
\ com esquema versionado, tabelas tipadas, índices e relações. Habilitar integridade\
\ referencial em cada conexão, delimitar unidade transacional por operação coerente\
\ e usar leitura consistente. Definir journal/durabilidade e espera limitada de\
\ escrita com diagnóstico. Preservar limites de módulos; serviços aninhados devem\
\ compartilhar a transação aplicável."
acceptanceCriteria:
- "Esquema e índices atendem ao mapeamento sem BLOB/base64 ou arquivos completos\
\ serializados em TEXT."
- "Falha em operação relacionada causa rollback; referências inválidas são recusadas\
\ e gravações concorrentes têm contenção limitada e diagnóstico útil."
- "Abertura de esquema incompatível é diagnosticada sem alterar dados; teste de\
\ leitura consistente cobre mudanças concorrentes locais."
dependsOn:
- "TSK-0001"
- "TSK-0002"
status: "COMPLETED"
result: "Infraestrutura SQLite validada: 12 testes de transação/integridade/concorrê\
ncia e arquitetura passaram; schema também criado e reaberto pelo Native Image.\
\ CLI de domínio e instalação ativa continuam intactos."
evidence:
- "ART-0003"
updatedAt: "2026-11-22T12:26:10.846492Z"
- id: "TSK-0004"
title: "Persistir Works e investigação no novo backend"
description: "Integrar Work, guidance e histórico de escolhas, discussões, tópicos,\
\ surveys, respostas e disposições à unidade de persistência. Preservar IDs existentes,\
\ semântica dos IDs locais, referências e histórico útil. Consultas selecionadas\
\ devem buscar o Work diretamente. Manter leitura legada delimitada para compatibilidade\
\ e migração; não manter duas fontes autoritativas para a mesma memória."
acceptanceCriteria:
- "Criar e retomar Work/discussão/survey em outro processo preserva conteúdo, histó\
rico de respostas e pendências."
- "Escolhas DIRECT/EXPLORATORY e autoridade humana mantêm as regras existentes,\
\ inclusive ausência de escolha e pedido específico de DEC."
- "Busca por Work e suas referências usa consultas com escopo adequado; alteraçõ\
es e referências relacionadas são transacionais."
dependsOn:
- "TSK-0003"
status: "COMPLETED"
result: "Works/investigação SQLite passaram 45 testes e retomada em outro JVM e\
\ nativo; referências transacionais, histórico e autoridade preservados."
evidence:
- "ART-0004"
updatedAt: "2026-11-22T12:43:38.166159Z"
- id: "TSK-0005"
title: "Persistir decisões, planos e experimentos"
description: "Integrar DecisionService e PlanService com revisões, aceitação, supersessã\
o, passos, dependências e experimentos. Preservar os dois ciclos e OODA, a autoridade\
\ de DEC/Plan e a distinção entre aprovação humana e promoção permitida por polí\
tica. Tratar operações que alteram registros relacionados em uma transação, sem\
\ reduzir os checks de domínio."
acceptanceCriteria:
- "Aprovação, revisão e supersessão preservam autoria e referências, sem fabricaç\
ão de aprovação ou edição silenciosa de decisão aceita."
- "Dependências e estados de passos, critérios de experimentos, preocupações com\
\ DEC e replanejamento conservam os bloqueios existentes."
- "Interrupção simulada não publica meia supersessão ou promoção parcial; retomada\
\ em outro processo preserva o contexto."
dependsOn:
- "TSK-0004"
status: "COMPLETED"
result: "Decisões/Plans/experimentos SQLite preservam autoridade, revisão, dependê\
ncias e rollback conjunto; 34 cenários distintos selecionados passaram ao final\
\ após ajuste textual de um teste."
evidence:
- "ART-0005"
updatedAt: "2026-11-22T12:54:10.341537Z"
- id: "TSK-0006"
title: "Integrar execuções de agentes e coordenação de EPICs"
description: "Persistir RUNs e seus dados operacionais mínimos, idempotência de\
\ requestId, referências aplicadas e diagnóstico. Integrar PlanCoordinator/EpicCoordinator,\
\ políticas e proveniência de conclusão, representando recibos internos como dados\
\ estruturados quando aplicável. Preservar a fronteira do adaptador: propostas\
\ não aprovam DEC, não respondem pelo humano nem executam comandos de repositó\
rio."
acceptanceCriteria:
- "Repetição idempotente de uma solicitação concluída não duplica registros; solicitaç\
ões divergentes e estados interrompidos são diagnosticados."
- "Políticas RESULTS/DECOMPOSITION, delegação, reabertura, propagação e conclusã\
o por Plans preservam autoridade e proveniência."
- "Resultados estruturados necessários permanecem; transporte bruto, ambiente e\
\ logs completos não viram acervo permanente no banco."
dependsOn:
- "TSK-0005"
status: "COMPLETED"
result: "RUNs/EPICs persistidos e coordenação preservada; 30 cenários distintos\
\ passaram, incluindo rollback integral e idempotência."
evidence:
- "ART-0006"
updatedAt: "2026-11-22T13:02:08.858215Z"
- id: "TSK-0007"
title: "Integrar gates do projeto e adicionais por Work"
description: "Representar gates obrigatórios do projeto e complementos do Work e\
\ conectar seus resultados aos checks e à entrega. Preservar avaliação externa\
\ e condições de qualidade, inclusive anexos exigidos. Registrar identificaçã\
o, procedimento/execução, estado avaliado, momento e resultado mínimo. Alteraç\
ões pertinentes invalidam a aplicação do resultado aos gates afetados; aprovaç\
ão humana não equivale a sucesso técnico."
acceptanceCriteria:
- "Gate obrigatório pendente, falho ou não executado bloqueia a entrega; gates adicionais\
\ do Work são considerados sem dispensar obrigatórios do projeto."
- "Resultados correspondem ao estado realmente avaliado e não satisfazem silenciosamente\
\ um gate após mudança relevante."
- "Checks existentes e anexos necessários continuam exigidos durante avaliação,\
\ sem introduzir executor autônomo ou retenção bruta obrigatória."
dependsOn:
- "TSK-0005"
- "TSK-0006"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:52:58.285586Z"
- id: "TSK-0008"
title: "Implementar anexos temporários e descarte após checks"
description: "Definir ciclo de vida de anexos e arquivos de execução no filesystem.\
\ Publicar arquivos completos, validar e registrar resultados mínimos antes do\
\ descarte; limpar elegíveis ao fim da execução. Proteger anexos ainda usados\
\ por checks pendentes e outputs solicitados. Recuperar falhas entre publicaçã\
o de arquivo, transação no banco e limpeza, distinguindo descarte legítimo de\
\ perda prematura. Não descartar artefatos legados deste workspace."
acceptanceCriteria:
- "Arquivos exigidos permanecem acessíveis até todos os checks dependentes terminarem,\
\ com resultado persistido antes da remoção."
- "Descarte automático preserva outputs solicitados e memória histórica; arquivo\
\ perdido antes da avaliação continua causando falha."
- "Interrupções nos pontos de publicação, registro e limpeza não fabricam sucesso\
\ e permitem recuperação sem remoção de entradas ainda necessárias."
dependsOn:
- "TSK-0007"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:05.800970Z"
- id: "TSK-0009"
title: "Adaptar verificação, status e contexto ao SQLite"
description: "Integrar VerificationService, CompatibilityService e projeções da\
\ CLI ao backend. Montar status, next-actions, context e readiness com consultas\
\ necessárias e resultados reutilizados na invocação; preservar contrato público\
\ quando compatível e informar mudanças. Separar resultado histórico com anexo\
\ descartado legitimamente de validação ativa. Manter diagnóstico de reparo e\
\ ausência de transições de estado em consultas."
acceptanceCriteria:
- "Consultas e contexto em processos novos preservam informações e autoridade e\
\ não promovem, migram ou concluem registros por leitura."
- "Anexos descartados legitimamente não invalidam histórico; corrupção e referê\
ncias ausentes não são tratadas como gates satisfeitos."
- "Caminhos selecionados não repetem varreduras/validações globais sem necessidade;\
\ saída e códigos de erro compatíveis são verificados."
dependsOn:
- "TSK-0004"
- "TSK-0005"
- "TSK-0006"
- "TSK-0008"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:13.390096Z"
- id: "TSK-0010"
title: "Implementar migração explícita e recuperável do legado"
description: "Criar comando público de prévia e aplicação da migração, sem conversã\
o em leituras ou atualização do instalador. Usar base de preparo e cópia de seguranç\
a da conversão, importação tipada transacional e verificação contra o corpus.\
\ Preservar IDs, conteúdo, aprovações, hashes, revisões e proveniência histórica\
\ sem despejar arquivos no banco. Ativar somente após sucesso; repetir ou recuperar\
\ interrupção sem duplicar. Executar apenas em fixtures/cópias descartáveis."
acceptanceCriteria:
- "Prévia não modifica o projeto; aplicação compara registros/contexto e ativa a\
\ base somente após validação completa."
- "Fixtures históricas, recibos, aprovações e referências preservam identidade/proveniê\
ncia; execução repetida não duplica conteúdo."
- "Falhas e interrupções deixam a fonte anterior recuperável e informam próxima\
\ ação; nenhum projeto real ou workspace canônico foi migrado."
dependsOn:
- "TSK-0001"
- "TSK-0009"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:21.074969Z"
- id: "TSK-0011"
title: "Atualizar init, descoberta e contrato de compatibilidade"
description: "Inicializar projetos locais em SQLite e deixar .ai-engineering ignorado\
\ pelo Git por padrão sem exigir Git. Preservar regras preexistentes e instruç\
ões fora do bloco gerido. Declarar backend e versões no contrato público, atualizar\
\ diagnóstico/onboard e evitar que base SQLite seja interpretada como workspace\
\ vazio por combinação incompatível. Manter tratamento explícito de projetos legados\
\ e previamente rastreados."
acceptanceCriteria:
- "Init cria projeto funcional sem Git, com estado local ignorado por padrão e bootstrap\
\ suficiente para humanos e agentes."
- "Reexecução preserva conteúdo/regras; não remove arquivos já rastreados nem converte\
\ legado automaticamente."
- "Versões e backend incompatíveis são recusados com diagnóstico acionável antes\
\ de escrita; documentação/entrypoints não induzem uso de CLI incompatível."
dependsOn:
- "TSK-0009"
- "TSK-0010"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:28.841960Z"
- id: "TSK-0012"
title: "Preparar pacote nativo e instalador conjunto sem ativação"
description: "Evoluir build/distribuição e scripts/install-native.sh para empacotar\
\ AIE nativo, biblioteca SQLite do driver e CLI sqlite3 num diretório configurá\
vel, com atalhos aie/ai-engineering e dados de projeto separados. Fixar componentes/plataformas\
\ e verificar pacote antes de ativação, preservando versão anterior em falhas.\
\ Testar instalador com ferramentas simuladas e destinos descartáveis; smoke usa\
\ build local. Não executar instalação real nem tocar ~/.local/bin ou dependê\
ncias ativas."
acceptanceCriteria:
- "Pacote contém componentes corretos e o build nativo acessa uma base descartá\
vel sem depender da instalação global."
- "Fixtures verificam diretórios configuráveis, atalhos, atualização conjunta e\
\ falha sem danificar instalação anterior simulada."
- "Nenhum binário, biblioteca ou atalho ativo é substituído e o instalador real\
\ não é executado; a ativação posterior continua dependente de instrução humana."
dependsOn:
- "TSK-0002"
- "TSK-0011"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:37.290314Z"
- id: "TSK-0013"
title: "Consolidar documentação e instruções do framework local"
description: "Atualizar README, docs de arquitetura/protocolo/compatibilidade/migraç\
ão e recursos de entrada para memória local, SQLite, gates e retenção mínima.\
\ Explicar anexos temporários, outputs entregues, migração explícita e recuperaç\
ão, pacote preparado e instalação adiada. Remover instruções que apresentem arquivos\
\ de Works como fonte principal nova ou Git como exigência. Preservar orientaç\
ões dos dois ciclos, OODA, DEC/Plan e aprovações."
acceptanceCriteria:
- "Documentação e recursos distribuídos descrevem o mesmo contrato e permitem inicializar/retomar\
\ um projeto sem Git."
- "Procedimento público de migração explica prévia, efeitos e recuperação sem depender\
\ de inspeção do código interno."
- "Limites de retenção e instalação, papel dos gates e recortes futuros estão claros;\
\ fontes e exemplos não alegam testes ou migrações reais não executados."
dependsOn:
- "TSK-0010"
- "TSK-0011"
- "TSK-0012"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:45.331995Z"
- id: "TSK-0014"
title: "Executar regressão integrada e encaminhar responsividade ao WRK-000C"
description: "Integrar as verificações das etapas e executar gates apropriados de\
\ testes/arquitetura, migração, concorrência e smoke JVM/nativo em ambientes descartá\
veis. Revisar continuidade e autoridade nos dois ciclos, anexos temporários, recuperaç\
ão e funcionamento sem Git. Consolidar resultados mínimos, resolver experimentos/preocupaç\
ões e entregar cenário reproduzível ao WRK-000C com comandos, versão, dados e\
\ ambiente. Não instalar o pacote nem declarar resolvido o atraso."
acceptanceCriteria:
- "Suíte relevante de domínio/integração/compatibilidade, fixtures do instalador\
\ e smoke nativo passam ou impedimentos são tratados antes da conclusão."
- "Falhas, rollback, concorrência, legado, gates e descarte legítimo foram verificados\
\ com resultados reais e sem alteração da instalação ativa ou consumidores."
- "Todos os steps e critérios da DEC estão satisfeitos, sem experimentos/preocupaç\
ões pendentes; WRK-000C recebe cenário para medição futura e permanece aberto."
dependsOn:
- "TSK-0013"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:53.421052Z"
status: "ACTIVE"
author: "Codex"
createdAt: "2026-11-22T11:52:06.993736Z"
revision: 30
previousHash: "7b2ebdc1b387d96c1c5096ecd1945951149fb3112b3f6f2972cbaa3cd2218acc"
updatedAt: "2026-11-22T13:02:08.858381Z"
updatedBy: "Codex"
changeReason: "RUNs/EPICs persistidos e coordenação preservada; 30 cenários distintos\
\ passaram, incluindo rollback integral e idempotência."
experiments:
- id: "EXP-0001"
stepId: "TSK-0002"
hypothesis: "SQLite JDBC pode criar, persistir e reabrir uma base em processos JVM\
\ e Native Image com biblioteca distribuída ao lado do executável."
successCriterion: "As duas formas executam create/read/write/reopen e rollback em\
\ diretório descartável; o nativo usa a biblioteca do pacote com extração temporá\
ria indisponível; nenhum binário ativo ou consumidor é alterado."
invocation: "./gradlew sqliteProbeClasses nativeSqliteProbeCompile; scripts/sqlite-probe.sh\
\ <build>; execução da classe de prova JVM e do binário de build em processos\
\ distintos"
retryOf: null
reconsideration: null
by: "Codex"
createdAt: "2026-11-22T12:10:00.110720Z"
outcome: "CONFIRMED"
observation: "JVM criou e reabriu a base com UTF-8 e rollback. Native Image GraalVM\
\ 25 criou e reabriu em processos independentes com biblioteca externa e extraç\
ão sem escrita; a cópia isolada sem biblioteca falhou."
interpretation: "Driver SQLite JDBC 3.54.1.0 e biblioteca distribuída ao lado do\
\ nativo funcionam na plataforma macOS arm64. Seleção inicial de JDK foi corrigida\
\ explicitamente; sem instalação real."
nextAction: "Implementar infraestrutura transacional e esquema local no TSK-0003."
evidence:
- "ART-0002"
questionsDecision: null
finishedAt: "2026-11-22T12:16:43.109268Z"
finishedBy: "Codex"
documentVersion: 2
---
# Implementar memória de engenharia local em SQLite
## Autoridade e objetivo
Executar a DEC-0001 do WRK-000D, aceita explicitamente por Nilton nesta conversa.
O resultado é um framework local de memória de engenharia por Work, com SQLite
por projeto, investigação e implementação orientadas por OODA, gates preservados,
anexos temporários e retenção mínima. A aprovação desta DEC mantém a instalação
real adiada.
Este Plan foi solicitado com decomposição em vários steps. Todos os steps começam
OPEN; a criação do Plan não constitui execução ou comprovação de resultado.
## Limites obrigatórios
- Não instalar nem substituir o AIE, SQLite, bibliotecas ou atalhos em uso.
- Não executar o instalador real contra HOME, ~/.local/bin ou outro destino ativo.
Sua validação usa fixtures com ferramentas simuladas e destinos descartáveis.
- Não migrar este workspace canônico ou projetos consumidores. Exercitar o novo
backend e a migração em fixtures e cópias descartáveis; ativação real depende de
instrução humana posterior específica.
- Preservar alterações preexistentes, IDs, conteúdo e proveniência legada,
aprovações, evidências históricas e instruções do projeto fora do bloco gerido.
- Não introduzir arquivos em BLOB/base64 ou TEXT equivalente, retenção extensa,
executor autônomo de repositório, colaboração distribuída ou integração Git LFS.
- Importação/exportação de Works/DECs e backup como funcionalidade ficam fora.
A cópia de segurança da migração é parte da recuperação da conversão.
- Código e outputs solicitados permanecem nos destinos de entrega apropriados.
- O WRK-000C permanece aberto para avaliar e tratar latência após esta mudança.
## Execução e dependências
Os 14 steps possuem dependências explícitas e critérios próprios. Mapear primeiro
o contrato e o legado; provar a integração SQLite/JVM/Native Image; depois construir
as transações e migrar os fluxos de domínio. Integrar gates e ciclo dos anexos antes
de consolidar as consultas, a migração pública e o bootstrap. Preparar distribuição
e documentação e concluir com regressão integrada e encaminhamento ao WRK-000C.
Não iniciar um step com dependências pendentes. Verificações focadas fazem parte
de cada mudança; a última etapa integra os cenários e não substitui essas verificações.
Steps independentes podem ser executados em ordem compatível, sem presumir
autorização de delegação ou de instalação real.
## OODA e incertezas
Nas provas relevantes, principalmente driver/nativo, migração e descarte de anexos,
registrar hipótese, critério de sucesso e invocação antes de executar. Registrar
observação, interpretação e próxima ação após o resultado; reconsiderar antes de
repetir uma hipótese falha. Usar os registros de experimentos do Plan quando úteis,
sem impor um ritual de quatro fases a toda alteração.
Ajustar esquema, índices, transações e build dentro da DEC. Se um resultado
questionar a decisão, registrar a preocupação, continuar investigações autorizadas
e rever a DEC com aprovação aplicável antes da execução afetada.
## Verificação e registro mínimo
Durante a execução deste Work, respeitar o protocolo que está em uso. Registrar
resultados reais e evidência mínima necessária para completar os steps; não usar
a futura política de limpeza para apagar evidências legadas ou simular gates.
Verificar continuidade entre processos, integridade referencial, rollback,
concorrência local com espera limitada, autoridade humana, gates e anexos
temporários, migração repetível e operação sem Git. Provas nativas usam somente
artefatos de build e projetos descartáveis.
Comandos candidatos à validação, ajustados ao resultado e ao código final:
- `./gradlew test` e `./gradlew check` para a suíte e arquitetura do projeto.
- `python3 scripts/test-install-native.py` para fixtures do instalador.
- `./gradlew nativeCompile` e tarefas de distribuição para construir o pacote.
- `bash scripts/native-smoke.sh <caminho-absoluto-do-build>` em projetos descartáveis.
Esses comandos são planejados, não executados na criação do Plan. Preservar os
gates específicos do projeto e adicionais do Work definidos na execução. Logs de
trabalho podem ser temporários; guardar na memória somente o necessário ao contrato.
## Conclusão
Todos os steps obrigatórios devem satisfazer seus critérios, com a DEC aceita e
sem experimentos ou preocupações pendentes. A entrega é código, documentação,
pacote preparado e resultados de verificação. Não depende de instalar a nova
versão no ambiente em uso. Encaminhar ao WRK-000C um cenário reproduzível com
comandos, versão, volume e ambiente, sem declarar resolvido o problema de atraso.
@@ -0,0 +1,451 @@
---
schemaVersion: 1
id: "PLN-0001"
workId: "WRK-000D"
title: "Implementar memória de engenharia local em SQLite sem instalação ativa"
decisions:
- "DEC-0001"
steps:
- id: "TSK-0001"
title: "Mapear contrato, dados legados e cenários de migração"
description: "Inspecionar WorkService, serviços de Discussion/Decision/Plan/Agent,\
\ coordenadores e VerificationService. Mapear registros, referências, revisões,\
\ hashes, recibos e bootstrap para tabelas e regras do backend SQLite, preservando\
\ conteúdo e autoridade. Selecionar fixtures existentes de compatibilidade, workflows\
\ e importação como corpus; usar apenas cópias descartáveis. Identificar checks\
\ e pontos de retenção sem realizar benchmark conclusivo do WRK-000C."
acceptanceCriteria:
- "Mapeamento cobre entidades persistidas, IDs locais ao Work, referências, revisõ\
es, aprovações e casos de conclusão legada com hashes/recibos."
- "Corpus representativo e resultados esperados de continuidade/migração estão definidos\
\ antes da conversão, incluindo dados inválidos e estados interrompidos."
- "Limites de instalação, migração de consumidores e preservação do workspace atual\
\ estão explícitos e respeitados."
dependsOn: []
status: "COMPLETED"
result: "Contrato e legado mapeados em docs/sqlite-migration-design.md; corpus e\
\ casos de falha/retry definidos antes da migração. Baseline: 45 testes em seis\
\ classes passaram, hashes congelados conferidos e fontes históricas intactas.\
\ Sem instalação ou migração real."
evidence:
- "ART-0001"
updatedAt: "2026-11-22T12:00:26.700050Z"
- id: "TSK-0002"
title: "Provar driver SQLite em JVM e Native Image"
description: "Avaliar Xerial SQLite JDBC e fixar versão compatível com Java, Gradle\
\ e GraalVM do projeto. Registrar hipótese, critério e invocação antes da prova.\
\ Criar, gravar, ler e reabrir uma base descartável em processos JVM e nativos.\
\ Verificar carregamento da biblioteca distribuída ao lado do nativo; sqlite3\
\ será ferramenta de diagnóstico do pacote. Construir e executar somente artefatos\
\ descartáveis, sem instalação real."
acceptanceCriteria:
- "Driver e versão selecionados demonstram persistência e reabertura em JVM e Native\
\ Image na plataforma alvo."
- "Biblioteca do pacote é encontrada por caminho controlado e não depende acidentalmente\
\ do SQLite global ou de extração repetida não planejada."
- "Hipótese, resultado e limitações da prova estão registrados; instalação ativa\
\ e projetos consumidores não foram alterados."
dependsOn:
- "TSK-0001"
status: "COMPLETED"
result: "Prova JVM e Native Image passou create/read/write/reopen, UTF-8, rollback\
\ e dependência da biblioteca do pacote; sem instalação ativa."
evidence:
- "ART-0002"
updatedAt: "2026-11-22T12:16:52.149066Z"
- id: "TSK-0003"
title: "Implementar esquema, conexões e transações SQLite"
description: "Criar infraestrutura de persistência local em .ai-engineering/aie.db\
\ com esquema versionado, tabelas tipadas, índices e relações. Habilitar integridade\
\ referencial em cada conexão, delimitar unidade transacional por operação coerente\
\ e usar leitura consistente. Definir journal/durabilidade e espera limitada de\
\ escrita com diagnóstico. Preservar limites de módulos; serviços aninhados devem\
\ compartilhar a transação aplicável."
acceptanceCriteria:
- "Esquema e índices atendem ao mapeamento sem BLOB/base64 ou arquivos completos\
\ serializados em TEXT."
- "Falha em operação relacionada causa rollback; referências inválidas são recusadas\
\ e gravações concorrentes têm contenção limitada e diagnóstico útil."
- "Abertura de esquema incompatível é diagnosticada sem alterar dados; teste de\
\ leitura consistente cobre mudanças concorrentes locais."
dependsOn:
- "TSK-0001"
- "TSK-0002"
status: "COMPLETED"
result: "Infraestrutura SQLite validada: 12 testes de transação/integridade/concorrê\
ncia e arquitetura passaram; schema também criado e reaberto pelo Native Image.\
\ CLI de domínio e instalação ativa continuam intactos."
evidence:
- "ART-0003"
updatedAt: "2026-11-22T12:26:10.846492Z"
- id: "TSK-0004"
title: "Persistir Works e investigação no novo backend"
description: "Integrar Work, guidance e histórico de escolhas, discussões, tópicos,\
\ surveys, respostas e disposições à unidade de persistência. Preservar IDs existentes,\
\ semântica dos IDs locais, referências e histórico útil. Consultas selecionadas\
\ devem buscar o Work diretamente. Manter leitura legada delimitada para compatibilidade\
\ e migração; não manter duas fontes autoritativas para a mesma memória."
acceptanceCriteria:
- "Criar e retomar Work/discussão/survey em outro processo preserva conteúdo, histó\
rico de respostas e pendências."
- "Escolhas DIRECT/EXPLORATORY e autoridade humana mantêm as regras existentes,\
\ inclusive ausência de escolha e pedido específico de DEC."
- "Busca por Work e suas referências usa consultas com escopo adequado; alteraçõ\
es e referências relacionadas são transacionais."
dependsOn:
- "TSK-0003"
status: "COMPLETED"
result: "Works/investigação SQLite passaram 45 testes e retomada em outro JVM e\
\ nativo; referências transacionais, histórico e autoridade preservados."
evidence:
- "ART-0004"
updatedAt: "2026-11-22T12:43:38.166159Z"
- id: "TSK-0005"
title: "Persistir decisões, planos e experimentos"
description: "Integrar DecisionService e PlanService com revisões, aceitação, supersessã\
o, passos, dependências e experimentos. Preservar os dois ciclos e OODA, a autoridade\
\ de DEC/Plan e a distinção entre aprovação humana e promoção permitida por polí\
tica. Tratar operações que alteram registros relacionados em uma transação, sem\
\ reduzir os checks de domínio."
acceptanceCriteria:
- "Aprovação, revisão e supersessão preservam autoria e referências, sem fabricaç\
ão de aprovação ou edição silenciosa de decisão aceita."
- "Dependências e estados de passos, critérios de experimentos, preocupações com\
\ DEC e replanejamento conservam os bloqueios existentes."
- "Interrupção simulada não publica meia supersessão ou promoção parcial; retomada\
\ em outro processo preserva o contexto."
dependsOn:
- "TSK-0004"
status: "COMPLETED"
result: "Decisões/Plans/experimentos SQLite preservam autoridade, revisão, dependê\
ncias e rollback conjunto; 34 cenários distintos selecionados passaram ao final\
\ após ajuste textual de um teste."
evidence:
- "ART-0005"
updatedAt: "2026-11-22T12:54:10.341537Z"
- id: "TSK-0006"
title: "Integrar execuções de agentes e coordenação de EPICs"
description: "Persistir RUNs e seus dados operacionais mínimos, idempotência de\
\ requestId, referências aplicadas e diagnóstico. Integrar PlanCoordinator/EpicCoordinator,\
\ políticas e proveniência de conclusão, representando recibos internos como dados\
\ estruturados quando aplicável. Preservar a fronteira do adaptador: propostas\
\ não aprovam DEC, não respondem pelo humano nem executam comandos de repositó\
rio."
acceptanceCriteria:
- "Repetição idempotente de uma solicitação concluída não duplica registros; solicitaç\
ões divergentes e estados interrompidos são diagnosticados."
- "Políticas RESULTS/DECOMPOSITION, delegação, reabertura, propagação e conclusã\
o por Plans preservam autoridade e proveniência."
- "Resultados estruturados necessários permanecem; transporte bruto, ambiente e\
\ logs completos não viram acervo permanente no banco."
dependsOn:
- "TSK-0005"
status: "COMPLETED"
result: "RUNs/EPICs persistidos e coordenação preservada; 30 cenários distintos\
\ passaram, incluindo rollback integral e idempotência."
evidence:
- "ART-0006"
updatedAt: "2026-11-22T13:02:08.858215Z"
- id: "TSK-0007"
title: "Integrar gates do projeto e adicionais por Work"
description: "Representar gates obrigatórios do projeto e complementos do Work e\
\ conectar seus resultados aos checks e à entrega. Preservar avaliação externa\
\ e condições de qualidade, inclusive anexos exigidos. Registrar identificaçã\
o, procedimento/execução, estado avaliado, momento e resultado mínimo. Alteraç\
ões pertinentes invalidam a aplicação do resultado aos gates afetados; aprovaç\
ão humana não equivale a sucesso técnico."
acceptanceCriteria:
- "Gate obrigatório pendente, falho ou não executado bloqueia a entrega; gates adicionais\
\ do Work são considerados sem dispensar obrigatórios do projeto."
- "Resultados correspondem ao estado realmente avaliado e não satisfazem silenciosamente\
\ um gate após mudança relevante."
- "Checks existentes e anexos necessários continuam exigidos durante avaliação,\
\ sem introduzir executor autônomo ou retenção bruta obrigatória."
dependsOn:
- "TSK-0005"
- "TSK-0006"
status: "ACTIVE"
result: "Integrar gates do projeto e complementos por Work com resultados vinculados\
\ ao estado avaliado."
evidence: []
updatedAt: "2026-11-22T13:02:21.247070Z"
- id: "TSK-0008"
title: "Implementar anexos temporários e descarte após checks"
description: "Definir ciclo de vida de anexos e arquivos de execução no filesystem.\
\ Publicar arquivos completos, validar e registrar resultados mínimos antes do\
\ descarte; limpar elegíveis ao fim da execução. Proteger anexos ainda usados\
\ por checks pendentes e outputs solicitados. Recuperar falhas entre publicaçã\
o de arquivo, transação no banco e limpeza, distinguindo descarte legítimo de\
\ perda prematura. Não descartar artefatos legados deste workspace."
acceptanceCriteria:
- "Arquivos exigidos permanecem acessíveis até todos os checks dependentes terminarem,\
\ com resultado persistido antes da remoção."
- "Descarte automático preserva outputs solicitados e memória histórica; arquivo\
\ perdido antes da avaliação continua causando falha."
- "Interrupções nos pontos de publicação, registro e limpeza não fabricam sucesso\
\ e permitem recuperação sem remoção de entradas ainda necessárias."
dependsOn:
- "TSK-0007"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:05.800970Z"
- id: "TSK-0009"
title: "Adaptar verificação, status e contexto ao SQLite"
description: "Integrar VerificationService, CompatibilityService e projeções da\
\ CLI ao backend. Montar status, next-actions, context e readiness com consultas\
\ necessárias e resultados reutilizados na invocação; preservar contrato público\
\ quando compatível e informar mudanças. Separar resultado histórico com anexo\
\ descartado legitimamente de validação ativa. Manter diagnóstico de reparo e\
\ ausência de transições de estado em consultas."
acceptanceCriteria:
- "Consultas e contexto em processos novos preservam informações e autoridade e\
\ não promovem, migram ou concluem registros por leitura."
- "Anexos descartados legitimamente não invalidam histórico; corrupção e referê\
ncias ausentes não são tratadas como gates satisfeitos."
- "Caminhos selecionados não repetem varreduras/validações globais sem necessidade;\
\ saída e códigos de erro compatíveis são verificados."
dependsOn:
- "TSK-0004"
- "TSK-0005"
- "TSK-0006"
- "TSK-0008"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:13.390096Z"
- id: "TSK-0010"
title: "Implementar migração explícita e recuperável do legado"
description: "Criar comando público de prévia e aplicação da migração, sem conversã\
o em leituras ou atualização do instalador. Usar base de preparo e cópia de seguranç\
a da conversão, importação tipada transacional e verificação contra o corpus.\
\ Preservar IDs, conteúdo, aprovações, hashes, revisões e proveniência histórica\
\ sem despejar arquivos no banco. Ativar somente após sucesso; repetir ou recuperar\
\ interrupção sem duplicar. Executar apenas em fixtures/cópias descartáveis."
acceptanceCriteria:
- "Prévia não modifica o projeto; aplicação compara registros/contexto e ativa a\
\ base somente após validação completa."
- "Fixtures históricas, recibos, aprovações e referências preservam identidade/proveniê\
ncia; execução repetida não duplica conteúdo."
- "Falhas e interrupções deixam a fonte anterior recuperável e informam próxima\
\ ação; nenhum projeto real ou workspace canônico foi migrado."
dependsOn:
- "TSK-0001"
- "TSK-0009"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:21.074969Z"
- id: "TSK-0011"
title: "Atualizar init, descoberta e contrato de compatibilidade"
description: "Inicializar projetos locais em SQLite e deixar .ai-engineering ignorado\
\ pelo Git por padrão sem exigir Git. Preservar regras preexistentes e instruç\
ões fora do bloco gerido. Declarar backend e versões no contrato público, atualizar\
\ diagnóstico/onboard e evitar que base SQLite seja interpretada como workspace\
\ vazio por combinação incompatível. Manter tratamento explícito de projetos legados\
\ e previamente rastreados."
acceptanceCriteria:
- "Init cria projeto funcional sem Git, com estado local ignorado por padrão e bootstrap\
\ suficiente para humanos e agentes."
- "Reexecução preserva conteúdo/regras; não remove arquivos já rastreados nem converte\
\ legado automaticamente."
- "Versões e backend incompatíveis são recusados com diagnóstico acionável antes\
\ de escrita; documentação/entrypoints não induzem uso de CLI incompatível."
dependsOn:
- "TSK-0009"
- "TSK-0010"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:28.841960Z"
- id: "TSK-0012"
title: "Preparar pacote nativo e instalador conjunto sem ativação"
description: "Evoluir build/distribuição e scripts/install-native.sh para empacotar\
\ AIE nativo, biblioteca SQLite do driver e CLI sqlite3 num diretório configurá\
vel, com atalhos aie/ai-engineering e dados de projeto separados. Fixar componentes/plataformas\
\ e verificar pacote antes de ativação, preservando versão anterior em falhas.\
\ Testar instalador com ferramentas simuladas e destinos descartáveis; smoke usa\
\ build local. Não executar instalação real nem tocar ~/.local/bin ou dependê\
ncias ativas."
acceptanceCriteria:
- "Pacote contém componentes corretos e o build nativo acessa uma base descartá\
vel sem depender da instalação global."
- "Fixtures verificam diretórios configuráveis, atalhos, atualização conjunta e\
\ falha sem danificar instalação anterior simulada."
- "Nenhum binário, biblioteca ou atalho ativo é substituído e o instalador real\
\ não é executado; a ativação posterior continua dependente de instrução humana."
dependsOn:
- "TSK-0002"
- "TSK-0011"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:37.290314Z"
- id: "TSK-0013"
title: "Consolidar documentação e instruções do framework local"
description: "Atualizar README, docs de arquitetura/protocolo/compatibilidade/migraç\
ão e recursos de entrada para memória local, SQLite, gates e retenção mínima.\
\ Explicar anexos temporários, outputs entregues, migração explícita e recuperaç\
ão, pacote preparado e instalação adiada. Remover instruções que apresentem arquivos\
\ de Works como fonte principal nova ou Git como exigência. Preservar orientaç\
ões dos dois ciclos, OODA, DEC/Plan e aprovações."
acceptanceCriteria:
- "Documentação e recursos distribuídos descrevem o mesmo contrato e permitem inicializar/retomar\
\ um projeto sem Git."
- "Procedimento público de migração explica prévia, efeitos e recuperação sem depender\
\ de inspeção do código interno."
- "Limites de retenção e instalação, papel dos gates e recortes futuros estão claros;\
\ fontes e exemplos não alegam testes ou migrações reais não executados."
dependsOn:
- "TSK-0010"
- "TSK-0011"
- "TSK-0012"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:45.331995Z"
- id: "TSK-0014"
title: "Executar regressão integrada e encaminhar responsividade ao WRK-000C"
description: "Integrar as verificações das etapas e executar gates apropriados de\
\ testes/arquitetura, migração, concorrência e smoke JVM/nativo em ambientes descartá\
veis. Revisar continuidade e autoridade nos dois ciclos, anexos temporários, recuperaç\
ão e funcionamento sem Git. Consolidar resultados mínimos, resolver experimentos/preocupaç\
ões e entregar cenário reproduzível ao WRK-000C com comandos, versão, dados e\
\ ambiente. Não instalar o pacote nem declarar resolvido o atraso."
acceptanceCriteria:
- "Suíte relevante de domínio/integração/compatibilidade, fixtures do instalador\
\ e smoke nativo passam ou impedimentos são tratados antes da conclusão."
- "Falhas, rollback, concorrência, legado, gates e descarte legítimo foram verificados\
\ com resultados reais e sem alteração da instalação ativa ou consumidores."
- "Todos os steps e critérios da DEC estão satisfeitos, sem experimentos/preocupaç\
ões pendentes; WRK-000C recebe cenário para medição futura e permanece aberto."
dependsOn:
- "TSK-0013"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:53.421052Z"
status: "ACTIVE"
author: "Codex"
createdAt: "2026-11-22T11:52:06.993736Z"
revision: 31
previousHash: "5791d8f5f1fb3ef63a6490ae901fdb91cbb232cad3d64a430069e0f3252a8bc9"
updatedAt: "2026-11-22T13:02:21.247243Z"
updatedBy: "Codex"
changeReason: "Integrar gates do projeto e complementos por Work com resultados vinculados\
\ ao estado avaliado."
experiments:
- id: "EXP-0001"
stepId: "TSK-0002"
hypothesis: "SQLite JDBC pode criar, persistir e reabrir uma base em processos JVM\
\ e Native Image com biblioteca distribuída ao lado do executável."
successCriterion: "As duas formas executam create/read/write/reopen e rollback em\
\ diretório descartável; o nativo usa a biblioteca do pacote com extração temporá\
ria indisponível; nenhum binário ativo ou consumidor é alterado."
invocation: "./gradlew sqliteProbeClasses nativeSqliteProbeCompile; scripts/sqlite-probe.sh\
\ <build>; execução da classe de prova JVM e do binário de build em processos\
\ distintos"
retryOf: null
reconsideration: null
by: "Codex"
createdAt: "2026-11-22T12:10:00.110720Z"
outcome: "CONFIRMED"
observation: "JVM criou e reabriu a base com UTF-8 e rollback. Native Image GraalVM\
\ 25 criou e reabriu em processos independentes com biblioteca externa e extraç\
ão sem escrita; a cópia isolada sem biblioteca falhou."
interpretation: "Driver SQLite JDBC 3.54.1.0 e biblioteca distribuída ao lado do\
\ nativo funcionam na plataforma macOS arm64. Seleção inicial de JDK foi corrigida\
\ explicitamente; sem instalação real."
nextAction: "Implementar infraestrutura transacional e esquema local no TSK-0003."
evidence:
- "ART-0002"
questionsDecision: null
finishedAt: "2026-11-22T12:16:43.109268Z"
finishedBy: "Codex"
documentVersion: 2
---
# Implementar memória de engenharia local em SQLite
## Autoridade e objetivo
Executar a DEC-0001 do WRK-000D, aceita explicitamente por Nilton nesta conversa.
O resultado é um framework local de memória de engenharia por Work, com SQLite
por projeto, investigação e implementação orientadas por OODA, gates preservados,
anexos temporários e retenção mínima. A aprovação desta DEC mantém a instalação
real adiada.
Este Plan foi solicitado com decomposição em vários steps. Todos os steps começam
OPEN; a criação do Plan não constitui execução ou comprovação de resultado.
## Limites obrigatórios
- Não instalar nem substituir o AIE, SQLite, bibliotecas ou atalhos em uso.
- Não executar o instalador real contra HOME, ~/.local/bin ou outro destino ativo.
Sua validação usa fixtures com ferramentas simuladas e destinos descartáveis.
- Não migrar este workspace canônico ou projetos consumidores. Exercitar o novo
backend e a migração em fixtures e cópias descartáveis; ativação real depende de
instrução humana posterior específica.
- Preservar alterações preexistentes, IDs, conteúdo e proveniência legada,
aprovações, evidências históricas e instruções do projeto fora do bloco gerido.
- Não introduzir arquivos em BLOB/base64 ou TEXT equivalente, retenção extensa,
executor autônomo de repositório, colaboração distribuída ou integração Git LFS.
- Importação/exportação de Works/DECs e backup como funcionalidade ficam fora.
A cópia de segurança da migração é parte da recuperação da conversão.
- Código e outputs solicitados permanecem nos destinos de entrega apropriados.
- O WRK-000C permanece aberto para avaliar e tratar latência após esta mudança.
## Execução e dependências
Os 14 steps possuem dependências explícitas e critérios próprios. Mapear primeiro
o contrato e o legado; provar a integração SQLite/JVM/Native Image; depois construir
as transações e migrar os fluxos de domínio. Integrar gates e ciclo dos anexos antes
de consolidar as consultas, a migração pública e o bootstrap. Preparar distribuição
e documentação e concluir com regressão integrada e encaminhamento ao WRK-000C.
Não iniciar um step com dependências pendentes. Verificações focadas fazem parte
de cada mudança; a última etapa integra os cenários e não substitui essas verificações.
Steps independentes podem ser executados em ordem compatível, sem presumir
autorização de delegação ou de instalação real.
## OODA e incertezas
Nas provas relevantes, principalmente driver/nativo, migração e descarte de anexos,
registrar hipótese, critério de sucesso e invocação antes de executar. Registrar
observação, interpretação e próxima ação após o resultado; reconsiderar antes de
repetir uma hipótese falha. Usar os registros de experimentos do Plan quando úteis,
sem impor um ritual de quatro fases a toda alteração.
Ajustar esquema, índices, transações e build dentro da DEC. Se um resultado
questionar a decisão, registrar a preocupação, continuar investigações autorizadas
e rever a DEC com aprovação aplicável antes da execução afetada.
## Verificação e registro mínimo
Durante a execução deste Work, respeitar o protocolo que está em uso. Registrar
resultados reais e evidência mínima necessária para completar os steps; não usar
a futura política de limpeza para apagar evidências legadas ou simular gates.
Verificar continuidade entre processos, integridade referencial, rollback,
concorrência local com espera limitada, autoridade humana, gates e anexos
temporários, migração repetível e operação sem Git. Provas nativas usam somente
artefatos de build e projetos descartáveis.
Comandos candidatos à validação, ajustados ao resultado e ao código final:
- `./gradlew test` e `./gradlew check` para a suíte e arquitetura do projeto.
- `python3 scripts/test-install-native.py` para fixtures do instalador.
- `./gradlew nativeCompile` e tarefas de distribuição para construir o pacote.
- `bash scripts/native-smoke.sh <caminho-absoluto-do-build>` em projetos descartáveis.
Esses comandos são planejados, não executados na criação do Plan. Preservar os
gates específicos do projeto e adicionais do Work definidos na execução. Logs de
trabalho podem ser temporários; guardar na memória somente o necessário ao contrato.
## Conclusão
Todos os steps obrigatórios devem satisfazer seus critérios, com a DEC aceita e
sem experimentos ou preocupações pendentes. A entrega é código, documentação,
pacote preparado e resultados de verificação. Não depende de instalar a nova
versão no ambiente em uso. Encaminhar ao WRK-000C um cenário reproduzível com
comandos, versão, volume e ambiente, sem declarar resolvido o problema de atraso.
@@ -0,0 +1,452 @@
---
schemaVersion: 1
id: "PLN-0001"
workId: "WRK-000D"
title: "Implementar memória de engenharia local em SQLite sem instalação ativa"
decisions:
- "DEC-0001"
steps:
- id: "TSK-0001"
title: "Mapear contrato, dados legados e cenários de migração"
description: "Inspecionar WorkService, serviços de Discussion/Decision/Plan/Agent,\
\ coordenadores e VerificationService. Mapear registros, referências, revisões,\
\ hashes, recibos e bootstrap para tabelas e regras do backend SQLite, preservando\
\ conteúdo e autoridade. Selecionar fixtures existentes de compatibilidade, workflows\
\ e importação como corpus; usar apenas cópias descartáveis. Identificar checks\
\ e pontos de retenção sem realizar benchmark conclusivo do WRK-000C."
acceptanceCriteria:
- "Mapeamento cobre entidades persistidas, IDs locais ao Work, referências, revisõ\
es, aprovações e casos de conclusão legada com hashes/recibos."
- "Corpus representativo e resultados esperados de continuidade/migração estão definidos\
\ antes da conversão, incluindo dados inválidos e estados interrompidos."
- "Limites de instalação, migração de consumidores e preservação do workspace atual\
\ estão explícitos e respeitados."
dependsOn: []
status: "COMPLETED"
result: "Contrato e legado mapeados em docs/sqlite-migration-design.md; corpus e\
\ casos de falha/retry definidos antes da migração. Baseline: 45 testes em seis\
\ classes passaram, hashes congelados conferidos e fontes históricas intactas.\
\ Sem instalação ou migração real."
evidence:
- "ART-0001"
updatedAt: "2026-11-22T12:00:26.700050Z"
- id: "TSK-0002"
title: "Provar driver SQLite em JVM e Native Image"
description: "Avaliar Xerial SQLite JDBC e fixar versão compatível com Java, Gradle\
\ e GraalVM do projeto. Registrar hipótese, critério e invocação antes da prova.\
\ Criar, gravar, ler e reabrir uma base descartável em processos JVM e nativos.\
\ Verificar carregamento da biblioteca distribuída ao lado do nativo; sqlite3\
\ será ferramenta de diagnóstico do pacote. Construir e executar somente artefatos\
\ descartáveis, sem instalação real."
acceptanceCriteria:
- "Driver e versão selecionados demonstram persistência e reabertura em JVM e Native\
\ Image na plataforma alvo."
- "Biblioteca do pacote é encontrada por caminho controlado e não depende acidentalmente\
\ do SQLite global ou de extração repetida não planejada."
- "Hipótese, resultado e limitações da prova estão registrados; instalação ativa\
\ e projetos consumidores não foram alterados."
dependsOn:
- "TSK-0001"
status: "COMPLETED"
result: "Prova JVM e Native Image passou create/read/write/reopen, UTF-8, rollback\
\ e dependência da biblioteca do pacote; sem instalação ativa."
evidence:
- "ART-0002"
updatedAt: "2026-11-22T12:16:52.149066Z"
- id: "TSK-0003"
title: "Implementar esquema, conexões e transações SQLite"
description: "Criar infraestrutura de persistência local em .ai-engineering/aie.db\
\ com esquema versionado, tabelas tipadas, índices e relações. Habilitar integridade\
\ referencial em cada conexão, delimitar unidade transacional por operação coerente\
\ e usar leitura consistente. Definir journal/durabilidade e espera limitada de\
\ escrita com diagnóstico. Preservar limites de módulos; serviços aninhados devem\
\ compartilhar a transação aplicável."
acceptanceCriteria:
- "Esquema e índices atendem ao mapeamento sem BLOB/base64 ou arquivos completos\
\ serializados em TEXT."
- "Falha em operação relacionada causa rollback; referências inválidas são recusadas\
\ e gravações concorrentes têm contenção limitada e diagnóstico útil."
- "Abertura de esquema incompatível é diagnosticada sem alterar dados; teste de\
\ leitura consistente cobre mudanças concorrentes locais."
dependsOn:
- "TSK-0001"
- "TSK-0002"
status: "COMPLETED"
result: "Infraestrutura SQLite validada: 12 testes de transação/integridade/concorrê\
ncia e arquitetura passaram; schema também criado e reaberto pelo Native Image.\
\ CLI de domínio e instalação ativa continuam intactos."
evidence:
- "ART-0003"
updatedAt: "2026-11-22T12:26:10.846492Z"
- id: "TSK-0004"
title: "Persistir Works e investigação no novo backend"
description: "Integrar Work, guidance e histórico de escolhas, discussões, tópicos,\
\ surveys, respostas e disposições à unidade de persistência. Preservar IDs existentes,\
\ semântica dos IDs locais, referências e histórico útil. Consultas selecionadas\
\ devem buscar o Work diretamente. Manter leitura legada delimitada para compatibilidade\
\ e migração; não manter duas fontes autoritativas para a mesma memória."
acceptanceCriteria:
- "Criar e retomar Work/discussão/survey em outro processo preserva conteúdo, histó\
rico de respostas e pendências."
- "Escolhas DIRECT/EXPLORATORY e autoridade humana mantêm as regras existentes,\
\ inclusive ausência de escolha e pedido específico de DEC."
- "Busca por Work e suas referências usa consultas com escopo adequado; alteraçõ\
es e referências relacionadas são transacionais."
dependsOn:
- "TSK-0003"
status: "COMPLETED"
result: "Works/investigação SQLite passaram 45 testes e retomada em outro JVM e\
\ nativo; referências transacionais, histórico e autoridade preservados."
evidence:
- "ART-0004"
updatedAt: "2026-11-22T12:43:38.166159Z"
- id: "TSK-0005"
title: "Persistir decisões, planos e experimentos"
description: "Integrar DecisionService e PlanService com revisões, aceitação, supersessã\
o, passos, dependências e experimentos. Preservar os dois ciclos e OODA, a autoridade\
\ de DEC/Plan e a distinção entre aprovação humana e promoção permitida por polí\
tica. Tratar operações que alteram registros relacionados em uma transação, sem\
\ reduzir os checks de domínio."
acceptanceCriteria:
- "Aprovação, revisão e supersessão preservam autoria e referências, sem fabricaç\
ão de aprovação ou edição silenciosa de decisão aceita."
- "Dependências e estados de passos, critérios de experimentos, preocupações com\
\ DEC e replanejamento conservam os bloqueios existentes."
- "Interrupção simulada não publica meia supersessão ou promoção parcial; retomada\
\ em outro processo preserva o contexto."
dependsOn:
- "TSK-0004"
status: "COMPLETED"
result: "Decisões/Plans/experimentos SQLite preservam autoridade, revisão, dependê\
ncias e rollback conjunto; 34 cenários distintos selecionados passaram ao final\
\ após ajuste textual de um teste."
evidence:
- "ART-0005"
updatedAt: "2026-11-22T12:54:10.341537Z"
- id: "TSK-0006"
title: "Integrar execuções de agentes e coordenação de EPICs"
description: "Persistir RUNs e seus dados operacionais mínimos, idempotência de\
\ requestId, referências aplicadas e diagnóstico. Integrar PlanCoordinator/EpicCoordinator,\
\ políticas e proveniência de conclusão, representando recibos internos como dados\
\ estruturados quando aplicável. Preservar a fronteira do adaptador: propostas\
\ não aprovam DEC, não respondem pelo humano nem executam comandos de repositó\
rio."
acceptanceCriteria:
- "Repetição idempotente de uma solicitação concluída não duplica registros; solicitaç\
ões divergentes e estados interrompidos são diagnosticados."
- "Políticas RESULTS/DECOMPOSITION, delegação, reabertura, propagação e conclusã\
o por Plans preservam autoridade e proveniência."
- "Resultados estruturados necessários permanecem; transporte bruto, ambiente e\
\ logs completos não viram acervo permanente no banco."
dependsOn:
- "TSK-0005"
status: "COMPLETED"
result: "RUNs/EPICs persistidos e coordenação preservada; 30 cenários distintos\
\ passaram, incluindo rollback integral e idempotência."
evidence:
- "ART-0006"
updatedAt: "2026-11-22T13:02:08.858215Z"
- id: "TSK-0007"
title: "Integrar gates do projeto e adicionais por Work"
description: "Representar gates obrigatórios do projeto e complementos do Work e\
\ conectar seus resultados aos checks e à entrega. Preservar avaliação externa\
\ e condições de qualidade, inclusive anexos exigidos. Registrar identificaçã\
o, procedimento/execução, estado avaliado, momento e resultado mínimo. Alteraç\
ões pertinentes invalidam a aplicação do resultado aos gates afetados; aprovaç\
ão humana não equivale a sucesso técnico."
acceptanceCriteria:
- "Gate obrigatório pendente, falho ou não executado bloqueia a entrega; gates adicionais\
\ do Work são considerados sem dispensar obrigatórios do projeto."
- "Resultados correspondem ao estado realmente avaliado e não satisfazem silenciosamente\
\ um gate após mudança relevante."
- "Checks existentes e anexos necessários continuam exigidos durante avaliação,\
\ sem introduzir executor autônomo ou retenção bruta obrigatória."
dependsOn:
- "TSK-0005"
- "TSK-0006"
status: "COMPLETED"
result: "Gates cumulativos bloqueiam entrega sem PASS atual; snapshots históricos\
\ preservados. 23 cenários focados passaram."
evidence:
- "ART-0007"
updatedAt: "2026-11-22T13:08:08.952170Z"
- id: "TSK-0008"
title: "Implementar anexos temporários e descarte após checks"
description: "Definir ciclo de vida de anexos e arquivos de execução no filesystem.\
\ Publicar arquivos completos, validar e registrar resultados mínimos antes do\
\ descarte; limpar elegíveis ao fim da execução. Proteger anexos ainda usados\
\ por checks pendentes e outputs solicitados. Recuperar falhas entre publicaçã\
o de arquivo, transação no banco e limpeza, distinguindo descarte legítimo de\
\ perda prematura. Não descartar artefatos legados deste workspace."
acceptanceCriteria:
- "Arquivos exigidos permanecem acessíveis até todos os checks dependentes terminarem,\
\ com resultado persistido antes da remoção."
- "Descarte automático preserva outputs solicitados e memória histórica; arquivo\
\ perdido antes da avaliação continua causando falha."
- "Interrupções nos pontos de publicação, registro e limpeza não fabricam sucesso\
\ e permitem recuperação sem remoção de entradas ainda necessárias."
dependsOn:
- "TSK-0007"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:05.800970Z"
- id: "TSK-0009"
title: "Adaptar verificação, status e contexto ao SQLite"
description: "Integrar VerificationService, CompatibilityService e projeções da\
\ CLI ao backend. Montar status, next-actions, context e readiness com consultas\
\ necessárias e resultados reutilizados na invocação; preservar contrato público\
\ quando compatível e informar mudanças. Separar resultado histórico com anexo\
\ descartado legitimamente de validação ativa. Manter diagnóstico de reparo e\
\ ausência de transições de estado em consultas."
acceptanceCriteria:
- "Consultas e contexto em processos novos preservam informações e autoridade e\
\ não promovem, migram ou concluem registros por leitura."
- "Anexos descartados legitimamente não invalidam histórico; corrupção e referê\
ncias ausentes não são tratadas como gates satisfeitos."
- "Caminhos selecionados não repetem varreduras/validações globais sem necessidade;\
\ saída e códigos de erro compatíveis são verificados."
dependsOn:
- "TSK-0004"
- "TSK-0005"
- "TSK-0006"
- "TSK-0008"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:13.390096Z"
- id: "TSK-0010"
title: "Implementar migração explícita e recuperável do legado"
description: "Criar comando público de prévia e aplicação da migração, sem conversã\
o em leituras ou atualização do instalador. Usar base de preparo e cópia de seguranç\
a da conversão, importação tipada transacional e verificação contra o corpus.\
\ Preservar IDs, conteúdo, aprovações, hashes, revisões e proveniência histórica\
\ sem despejar arquivos no banco. Ativar somente após sucesso; repetir ou recuperar\
\ interrupção sem duplicar. Executar apenas em fixtures/cópias descartáveis."
acceptanceCriteria:
- "Prévia não modifica o projeto; aplicação compara registros/contexto e ativa a\
\ base somente após validação completa."
- "Fixtures históricas, recibos, aprovações e referências preservam identidade/proveniê\
ncia; execução repetida não duplica conteúdo."
- "Falhas e interrupções deixam a fonte anterior recuperável e informam próxima\
\ ação; nenhum projeto real ou workspace canônico foi migrado."
dependsOn:
- "TSK-0001"
- "TSK-0009"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:21.074969Z"
- id: "TSK-0011"
title: "Atualizar init, descoberta e contrato de compatibilidade"
description: "Inicializar projetos locais em SQLite e deixar .ai-engineering ignorado\
\ pelo Git por padrão sem exigir Git. Preservar regras preexistentes e instruç\
ões fora do bloco gerido. Declarar backend e versões no contrato público, atualizar\
\ diagnóstico/onboard e evitar que base SQLite seja interpretada como workspace\
\ vazio por combinação incompatível. Manter tratamento explícito de projetos legados\
\ e previamente rastreados."
acceptanceCriteria:
- "Init cria projeto funcional sem Git, com estado local ignorado por padrão e bootstrap\
\ suficiente para humanos e agentes."
- "Reexecução preserva conteúdo/regras; não remove arquivos já rastreados nem converte\
\ legado automaticamente."
- "Versões e backend incompatíveis são recusados com diagnóstico acionável antes\
\ de escrita; documentação/entrypoints não induzem uso de CLI incompatível."
dependsOn:
- "TSK-0009"
- "TSK-0010"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:28.841960Z"
- id: "TSK-0012"
title: "Preparar pacote nativo e instalador conjunto sem ativação"
description: "Evoluir build/distribuição e scripts/install-native.sh para empacotar\
\ AIE nativo, biblioteca SQLite do driver e CLI sqlite3 num diretório configurá\
vel, com atalhos aie/ai-engineering e dados de projeto separados. Fixar componentes/plataformas\
\ e verificar pacote antes de ativação, preservando versão anterior em falhas.\
\ Testar instalador com ferramentas simuladas e destinos descartáveis; smoke usa\
\ build local. Não executar instalação real nem tocar ~/.local/bin ou dependê\
ncias ativas."
acceptanceCriteria:
- "Pacote contém componentes corretos e o build nativo acessa uma base descartá\
vel sem depender da instalação global."
- "Fixtures verificam diretórios configuráveis, atalhos, atualização conjunta e\
\ falha sem danificar instalação anterior simulada."
- "Nenhum binário, biblioteca ou atalho ativo é substituído e o instalador real\
\ não é executado; a ativação posterior continua dependente de instrução humana."
dependsOn:
- "TSK-0002"
- "TSK-0011"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:37.290314Z"
- id: "TSK-0013"
title: "Consolidar documentação e instruções do framework local"
description: "Atualizar README, docs de arquitetura/protocolo/compatibilidade/migraç\
ão e recursos de entrada para memória local, SQLite, gates e retenção mínima.\
\ Explicar anexos temporários, outputs entregues, migração explícita e recuperaç\
ão, pacote preparado e instalação adiada. Remover instruções que apresentem arquivos\
\ de Works como fonte principal nova ou Git como exigência. Preservar orientaç\
ões dos dois ciclos, OODA, DEC/Plan e aprovações."
acceptanceCriteria:
- "Documentação e recursos distribuídos descrevem o mesmo contrato e permitem inicializar/retomar\
\ um projeto sem Git."
- "Procedimento público de migração explica prévia, efeitos e recuperação sem depender\
\ de inspeção do código interno."
- "Limites de retenção e instalação, papel dos gates e recortes futuros estão claros;\
\ fontes e exemplos não alegam testes ou migrações reais não executados."
dependsOn:
- "TSK-0010"
- "TSK-0011"
- "TSK-0012"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:45.331995Z"
- id: "TSK-0014"
title: "Executar regressão integrada e encaminhar responsividade ao WRK-000C"
description: "Integrar as verificações das etapas e executar gates apropriados de\
\ testes/arquitetura, migração, concorrência e smoke JVM/nativo em ambientes descartá\
veis. Revisar continuidade e autoridade nos dois ciclos, anexos temporários, recuperaç\
ão e funcionamento sem Git. Consolidar resultados mínimos, resolver experimentos/preocupaç\
ões e entregar cenário reproduzível ao WRK-000C com comandos, versão, dados e\
\ ambiente. Não instalar o pacote nem declarar resolvido o atraso."
acceptanceCriteria:
- "Suíte relevante de domínio/integração/compatibilidade, fixtures do instalador\
\ e smoke nativo passam ou impedimentos são tratados antes da conclusão."
- "Falhas, rollback, concorrência, legado, gates e descarte legítimo foram verificados\
\ com resultados reais e sem alteração da instalação ativa ou consumidores."
- "Todos os steps e critérios da DEC estão satisfeitos, sem experimentos/preocupaç\
ões pendentes; WRK-000C recebe cenário para medição futura e permanece aberto."
dependsOn:
- "TSK-0013"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:53.421052Z"
status: "ACTIVE"
author: "Codex"
createdAt: "2026-11-22T11:52:06.993736Z"
revision: 32
previousHash: "597f19b6e0d50560cc7b2d47df01bd3bf141998edc85b594f02cced2f8164dd8"
updatedAt: "2026-11-22T13:08:08.952425Z"
updatedBy: "Codex"
changeReason: "Gates cumulativos bloqueiam entrega sem PASS atual; snapshots histó\
ricos preservados. 23 cenários focados passaram."
experiments:
- id: "EXP-0001"
stepId: "TSK-0002"
hypothesis: "SQLite JDBC pode criar, persistir e reabrir uma base em processos JVM\
\ e Native Image com biblioteca distribuída ao lado do executável."
successCriterion: "As duas formas executam create/read/write/reopen e rollback em\
\ diretório descartável; o nativo usa a biblioteca do pacote com extração temporá\
ria indisponível; nenhum binário ativo ou consumidor é alterado."
invocation: "./gradlew sqliteProbeClasses nativeSqliteProbeCompile; scripts/sqlite-probe.sh\
\ <build>; execução da classe de prova JVM e do binário de build em processos\
\ distintos"
retryOf: null
reconsideration: null
by: "Codex"
createdAt: "2026-11-22T12:10:00.110720Z"
outcome: "CONFIRMED"
observation: "JVM criou e reabriu a base com UTF-8 e rollback. Native Image GraalVM\
\ 25 criou e reabriu em processos independentes com biblioteca externa e extraç\
ão sem escrita; a cópia isolada sem biblioteca falhou."
interpretation: "Driver SQLite JDBC 3.54.1.0 e biblioteca distribuída ao lado do\
\ nativo funcionam na plataforma macOS arm64. Seleção inicial de JDK foi corrigida\
\ explicitamente; sem instalação real."
nextAction: "Implementar infraestrutura transacional e esquema local no TSK-0003."
evidence:
- "ART-0002"
questionsDecision: null
finishedAt: "2026-11-22T12:16:43.109268Z"
finishedBy: "Codex"
documentVersion: 2
---
# Implementar memória de engenharia local em SQLite
## Autoridade e objetivo
Executar a DEC-0001 do WRK-000D, aceita explicitamente por Nilton nesta conversa.
O resultado é um framework local de memória de engenharia por Work, com SQLite
por projeto, investigação e implementação orientadas por OODA, gates preservados,
anexos temporários e retenção mínima. A aprovação desta DEC mantém a instalação
real adiada.
Este Plan foi solicitado com decomposição em vários steps. Todos os steps começam
OPEN; a criação do Plan não constitui execução ou comprovação de resultado.
## Limites obrigatórios
- Não instalar nem substituir o AIE, SQLite, bibliotecas ou atalhos em uso.
- Não executar o instalador real contra HOME, ~/.local/bin ou outro destino ativo.
Sua validação usa fixtures com ferramentas simuladas e destinos descartáveis.
- Não migrar este workspace canônico ou projetos consumidores. Exercitar o novo
backend e a migração em fixtures e cópias descartáveis; ativação real depende de
instrução humana posterior específica.
- Preservar alterações preexistentes, IDs, conteúdo e proveniência legada,
aprovações, evidências históricas e instruções do projeto fora do bloco gerido.
- Não introduzir arquivos em BLOB/base64 ou TEXT equivalente, retenção extensa,
executor autônomo de repositório, colaboração distribuída ou integração Git LFS.
- Importação/exportação de Works/DECs e backup como funcionalidade ficam fora.
A cópia de segurança da migração é parte da recuperação da conversão.
- Código e outputs solicitados permanecem nos destinos de entrega apropriados.
- O WRK-000C permanece aberto para avaliar e tratar latência após esta mudança.
## Execução e dependências
Os 14 steps possuem dependências explícitas e critérios próprios. Mapear primeiro
o contrato e o legado; provar a integração SQLite/JVM/Native Image; depois construir
as transações e migrar os fluxos de domínio. Integrar gates e ciclo dos anexos antes
de consolidar as consultas, a migração pública e o bootstrap. Preparar distribuição
e documentação e concluir com regressão integrada e encaminhamento ao WRK-000C.
Não iniciar um step com dependências pendentes. Verificações focadas fazem parte
de cada mudança; a última etapa integra os cenários e não substitui essas verificações.
Steps independentes podem ser executados em ordem compatível, sem presumir
autorização de delegação ou de instalação real.
## OODA e incertezas
Nas provas relevantes, principalmente driver/nativo, migração e descarte de anexos,
registrar hipótese, critério de sucesso e invocação antes de executar. Registrar
observação, interpretação e próxima ação após o resultado; reconsiderar antes de
repetir uma hipótese falha. Usar os registros de experimentos do Plan quando úteis,
sem impor um ritual de quatro fases a toda alteração.
Ajustar esquema, índices, transações e build dentro da DEC. Se um resultado
questionar a decisão, registrar a preocupação, continuar investigações autorizadas
e rever a DEC com aprovação aplicável antes da execução afetada.
## Verificação e registro mínimo
Durante a execução deste Work, respeitar o protocolo que está em uso. Registrar
resultados reais e evidência mínima necessária para completar os steps; não usar
a futura política de limpeza para apagar evidências legadas ou simular gates.
Verificar continuidade entre processos, integridade referencial, rollback,
concorrência local com espera limitada, autoridade humana, gates e anexos
temporários, migração repetível e operação sem Git. Provas nativas usam somente
artefatos de build e projetos descartáveis.
Comandos candidatos à validação, ajustados ao resultado e ao código final:
- `./gradlew test` e `./gradlew check` para a suíte e arquitetura do projeto.
- `python3 scripts/test-install-native.py` para fixtures do instalador.
- `./gradlew nativeCompile` e tarefas de distribuição para construir o pacote.
- `bash scripts/native-smoke.sh <caminho-absoluto-do-build>` em projetos descartáveis.
Esses comandos são planejados, não executados na criação do Plan. Preservar os
gates específicos do projeto e adicionais do Work definidos na execução. Logs de
trabalho podem ser temporários; guardar na memória somente o necessário ao contrato.
## Conclusão
Todos os steps obrigatórios devem satisfazer seus critérios, com a DEC aceita e
sem experimentos ou preocupações pendentes. A entrega é código, documentação,
pacote preparado e resultados de verificação. Não depende de instalar a nova
versão no ambiente em uso. Encaminhar ao WRK-000C um cenário reproduzível com
comandos, versão, volume e ambiente, sem declarar resolvido o problema de atraso.
@@ -0,0 +1,453 @@
---
schemaVersion: 1
id: "PLN-0001"
workId: "WRK-000D"
title: "Implementar memória de engenharia local em SQLite sem instalação ativa"
decisions:
- "DEC-0001"
steps:
- id: "TSK-0001"
title: "Mapear contrato, dados legados e cenários de migração"
description: "Inspecionar WorkService, serviços de Discussion/Decision/Plan/Agent,\
\ coordenadores e VerificationService. Mapear registros, referências, revisões,\
\ hashes, recibos e bootstrap para tabelas e regras do backend SQLite, preservando\
\ conteúdo e autoridade. Selecionar fixtures existentes de compatibilidade, workflows\
\ e importação como corpus; usar apenas cópias descartáveis. Identificar checks\
\ e pontos de retenção sem realizar benchmark conclusivo do WRK-000C."
acceptanceCriteria:
- "Mapeamento cobre entidades persistidas, IDs locais ao Work, referências, revisõ\
es, aprovações e casos de conclusão legada com hashes/recibos."
- "Corpus representativo e resultados esperados de continuidade/migração estão definidos\
\ antes da conversão, incluindo dados inválidos e estados interrompidos."
- "Limites de instalação, migração de consumidores e preservação do workspace atual\
\ estão explícitos e respeitados."
dependsOn: []
status: "COMPLETED"
result: "Contrato e legado mapeados em docs/sqlite-migration-design.md; corpus e\
\ casos de falha/retry definidos antes da migração. Baseline: 45 testes em seis\
\ classes passaram, hashes congelados conferidos e fontes históricas intactas.\
\ Sem instalação ou migração real."
evidence:
- "ART-0001"
updatedAt: "2026-11-22T12:00:26.700050Z"
- id: "TSK-0002"
title: "Provar driver SQLite em JVM e Native Image"
description: "Avaliar Xerial SQLite JDBC e fixar versão compatível com Java, Gradle\
\ e GraalVM do projeto. Registrar hipótese, critério e invocação antes da prova.\
\ Criar, gravar, ler e reabrir uma base descartável em processos JVM e nativos.\
\ Verificar carregamento da biblioteca distribuída ao lado do nativo; sqlite3\
\ será ferramenta de diagnóstico do pacote. Construir e executar somente artefatos\
\ descartáveis, sem instalação real."
acceptanceCriteria:
- "Driver e versão selecionados demonstram persistência e reabertura em JVM e Native\
\ Image na plataforma alvo."
- "Biblioteca do pacote é encontrada por caminho controlado e não depende acidentalmente\
\ do SQLite global ou de extração repetida não planejada."
- "Hipótese, resultado e limitações da prova estão registrados; instalação ativa\
\ e projetos consumidores não foram alterados."
dependsOn:
- "TSK-0001"
status: "COMPLETED"
result: "Prova JVM e Native Image passou create/read/write/reopen, UTF-8, rollback\
\ e dependência da biblioteca do pacote; sem instalação ativa."
evidence:
- "ART-0002"
updatedAt: "2026-11-22T12:16:52.149066Z"
- id: "TSK-0003"
title: "Implementar esquema, conexões e transações SQLite"
description: "Criar infraestrutura de persistência local em .ai-engineering/aie.db\
\ com esquema versionado, tabelas tipadas, índices e relações. Habilitar integridade\
\ referencial em cada conexão, delimitar unidade transacional por operação coerente\
\ e usar leitura consistente. Definir journal/durabilidade e espera limitada de\
\ escrita com diagnóstico. Preservar limites de módulos; serviços aninhados devem\
\ compartilhar a transação aplicável."
acceptanceCriteria:
- "Esquema e índices atendem ao mapeamento sem BLOB/base64 ou arquivos completos\
\ serializados em TEXT."
- "Falha em operação relacionada causa rollback; referências inválidas são recusadas\
\ e gravações concorrentes têm contenção limitada e diagnóstico útil."
- "Abertura de esquema incompatível é diagnosticada sem alterar dados; teste de\
\ leitura consistente cobre mudanças concorrentes locais."
dependsOn:
- "TSK-0001"
- "TSK-0002"
status: "COMPLETED"
result: "Infraestrutura SQLite validada: 12 testes de transação/integridade/concorrê\
ncia e arquitetura passaram; schema também criado e reaberto pelo Native Image.\
\ CLI de domínio e instalação ativa continuam intactos."
evidence:
- "ART-0003"
updatedAt: "2026-11-22T12:26:10.846492Z"
- id: "TSK-0004"
title: "Persistir Works e investigação no novo backend"
description: "Integrar Work, guidance e histórico de escolhas, discussões, tópicos,\
\ surveys, respostas e disposições à unidade de persistência. Preservar IDs existentes,\
\ semântica dos IDs locais, referências e histórico útil. Consultas selecionadas\
\ devem buscar o Work diretamente. Manter leitura legada delimitada para compatibilidade\
\ e migração; não manter duas fontes autoritativas para a mesma memória."
acceptanceCriteria:
- "Criar e retomar Work/discussão/survey em outro processo preserva conteúdo, histó\
rico de respostas e pendências."
- "Escolhas DIRECT/EXPLORATORY e autoridade humana mantêm as regras existentes,\
\ inclusive ausência de escolha e pedido específico de DEC."
- "Busca por Work e suas referências usa consultas com escopo adequado; alteraçõ\
es e referências relacionadas são transacionais."
dependsOn:
- "TSK-0003"
status: "COMPLETED"
result: "Works/investigação SQLite passaram 45 testes e retomada em outro JVM e\
\ nativo; referências transacionais, histórico e autoridade preservados."
evidence:
- "ART-0004"
updatedAt: "2026-11-22T12:43:38.166159Z"
- id: "TSK-0005"
title: "Persistir decisões, planos e experimentos"
description: "Integrar DecisionService e PlanService com revisões, aceitação, supersessã\
o, passos, dependências e experimentos. Preservar os dois ciclos e OODA, a autoridade\
\ de DEC/Plan e a distinção entre aprovação humana e promoção permitida por polí\
tica. Tratar operações que alteram registros relacionados em uma transação, sem\
\ reduzir os checks de domínio."
acceptanceCriteria:
- "Aprovação, revisão e supersessão preservam autoria e referências, sem fabricaç\
ão de aprovação ou edição silenciosa de decisão aceita."
- "Dependências e estados de passos, critérios de experimentos, preocupações com\
\ DEC e replanejamento conservam os bloqueios existentes."
- "Interrupção simulada não publica meia supersessão ou promoção parcial; retomada\
\ em outro processo preserva o contexto."
dependsOn:
- "TSK-0004"
status: "COMPLETED"
result: "Decisões/Plans/experimentos SQLite preservam autoridade, revisão, dependê\
ncias e rollback conjunto; 34 cenários distintos selecionados passaram ao final\
\ após ajuste textual de um teste."
evidence:
- "ART-0005"
updatedAt: "2026-11-22T12:54:10.341537Z"
- id: "TSK-0006"
title: "Integrar execuções de agentes e coordenação de EPICs"
description: "Persistir RUNs e seus dados operacionais mínimos, idempotência de\
\ requestId, referências aplicadas e diagnóstico. Integrar PlanCoordinator/EpicCoordinator,\
\ políticas e proveniência de conclusão, representando recibos internos como dados\
\ estruturados quando aplicável. Preservar a fronteira do adaptador: propostas\
\ não aprovam DEC, não respondem pelo humano nem executam comandos de repositó\
rio."
acceptanceCriteria:
- "Repetição idempotente de uma solicitação concluída não duplica registros; solicitaç\
ões divergentes e estados interrompidos são diagnosticados."
- "Políticas RESULTS/DECOMPOSITION, delegação, reabertura, propagação e conclusã\
o por Plans preservam autoridade e proveniência."
- "Resultados estruturados necessários permanecem; transporte bruto, ambiente e\
\ logs completos não viram acervo permanente no banco."
dependsOn:
- "TSK-0005"
status: "COMPLETED"
result: "RUNs/EPICs persistidos e coordenação preservada; 30 cenários distintos\
\ passaram, incluindo rollback integral e idempotência."
evidence:
- "ART-0006"
updatedAt: "2026-11-22T13:02:08.858215Z"
- id: "TSK-0007"
title: "Integrar gates do projeto e adicionais por Work"
description: "Representar gates obrigatórios do projeto e complementos do Work e\
\ conectar seus resultados aos checks e à entrega. Preservar avaliação externa\
\ e condições de qualidade, inclusive anexos exigidos. Registrar identificaçã\
o, procedimento/execução, estado avaliado, momento e resultado mínimo. Alteraç\
ões pertinentes invalidam a aplicação do resultado aos gates afetados; aprovaç\
ão humana não equivale a sucesso técnico."
acceptanceCriteria:
- "Gate obrigatório pendente, falho ou não executado bloqueia a entrega; gates adicionais\
\ do Work são considerados sem dispensar obrigatórios do projeto."
- "Resultados correspondem ao estado realmente avaliado e não satisfazem silenciosamente\
\ um gate após mudança relevante."
- "Checks existentes e anexos necessários continuam exigidos durante avaliação,\
\ sem introduzir executor autônomo ou retenção bruta obrigatória."
dependsOn:
- "TSK-0005"
- "TSK-0006"
status: "COMPLETED"
result: "Gates cumulativos bloqueiam entrega sem PASS atual; snapshots históricos\
\ preservados. 23 cenários focados passaram."
evidence:
- "ART-0007"
updatedAt: "2026-11-22T13:08:08.952170Z"
- id: "TSK-0008"
title: "Implementar anexos temporários e descarte após checks"
description: "Definir ciclo de vida de anexos e arquivos de execução no filesystem.\
\ Publicar arquivos completos, validar e registrar resultados mínimos antes do\
\ descarte; limpar elegíveis ao fim da execução. Proteger anexos ainda usados\
\ por checks pendentes e outputs solicitados. Recuperar falhas entre publicaçã\
o de arquivo, transação no banco e limpeza, distinguindo descarte legítimo de\
\ perda prematura. Não descartar artefatos legados deste workspace."
acceptanceCriteria:
- "Arquivos exigidos permanecem acessíveis até todos os checks dependentes terminarem,\
\ com resultado persistido antes da remoção."
- "Descarte automático preserva outputs solicitados e memória histórica; arquivo\
\ perdido antes da avaliação continua causando falha."
- "Interrupções nos pontos de publicação, registro e limpeza não fabricam sucesso\
\ e permitem recuperação sem remoção de entradas ainda necessárias."
dependsOn:
- "TSK-0007"
status: "ACTIVE"
result: "Integrar anexos temporários, resultados mínimos e recuperação de descarte\
\ após os checks dependentes."
evidence: []
updatedAt: "2026-11-22T13:08:20.915778Z"
- id: "TSK-0009"
title: "Adaptar verificação, status e contexto ao SQLite"
description: "Integrar VerificationService, CompatibilityService e projeções da\
\ CLI ao backend. Montar status, next-actions, context e readiness com consultas\
\ necessárias e resultados reutilizados na invocação; preservar contrato público\
\ quando compatível e informar mudanças. Separar resultado histórico com anexo\
\ descartado legitimamente de validação ativa. Manter diagnóstico de reparo e\
\ ausência de transições de estado em consultas."
acceptanceCriteria:
- "Consultas e contexto em processos novos preservam informações e autoridade e\
\ não promovem, migram ou concluem registros por leitura."
- "Anexos descartados legitimamente não invalidam histórico; corrupção e referê\
ncias ausentes não são tratadas como gates satisfeitos."
- "Caminhos selecionados não repetem varreduras/validações globais sem necessidade;\
\ saída e códigos de erro compatíveis são verificados."
dependsOn:
- "TSK-0004"
- "TSK-0005"
- "TSK-0006"
- "TSK-0008"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:13.390096Z"
- id: "TSK-0010"
title: "Implementar migração explícita e recuperável do legado"
description: "Criar comando público de prévia e aplicação da migração, sem conversã\
o em leituras ou atualização do instalador. Usar base de preparo e cópia de seguranç\
a da conversão, importação tipada transacional e verificação contra o corpus.\
\ Preservar IDs, conteúdo, aprovações, hashes, revisões e proveniência histórica\
\ sem despejar arquivos no banco. Ativar somente após sucesso; repetir ou recuperar\
\ interrupção sem duplicar. Executar apenas em fixtures/cópias descartáveis."
acceptanceCriteria:
- "Prévia não modifica o projeto; aplicação compara registros/contexto e ativa a\
\ base somente após validação completa."
- "Fixtures históricas, recibos, aprovações e referências preservam identidade/proveniê\
ncia; execução repetida não duplica conteúdo."
- "Falhas e interrupções deixam a fonte anterior recuperável e informam próxima\
\ ação; nenhum projeto real ou workspace canônico foi migrado."
dependsOn:
- "TSK-0001"
- "TSK-0009"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:21.074969Z"
- id: "TSK-0011"
title: "Atualizar init, descoberta e contrato de compatibilidade"
description: "Inicializar projetos locais em SQLite e deixar .ai-engineering ignorado\
\ pelo Git por padrão sem exigir Git. Preservar regras preexistentes e instruç\
ões fora do bloco gerido. Declarar backend e versões no contrato público, atualizar\
\ diagnóstico/onboard e evitar que base SQLite seja interpretada como workspace\
\ vazio por combinação incompatível. Manter tratamento explícito de projetos legados\
\ e previamente rastreados."
acceptanceCriteria:
- "Init cria projeto funcional sem Git, com estado local ignorado por padrão e bootstrap\
\ suficiente para humanos e agentes."
- "Reexecução preserva conteúdo/regras; não remove arquivos já rastreados nem converte\
\ legado automaticamente."
- "Versões e backend incompatíveis são recusados com diagnóstico acionável antes\
\ de escrita; documentação/entrypoints não induzem uso de CLI incompatível."
dependsOn:
- "TSK-0009"
- "TSK-0010"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:28.841960Z"
- id: "TSK-0012"
title: "Preparar pacote nativo e instalador conjunto sem ativação"
description: "Evoluir build/distribuição e scripts/install-native.sh para empacotar\
\ AIE nativo, biblioteca SQLite do driver e CLI sqlite3 num diretório configurá\
vel, com atalhos aie/ai-engineering e dados de projeto separados. Fixar componentes/plataformas\
\ e verificar pacote antes de ativação, preservando versão anterior em falhas.\
\ Testar instalador com ferramentas simuladas e destinos descartáveis; smoke usa\
\ build local. Não executar instalação real nem tocar ~/.local/bin ou dependê\
ncias ativas."
acceptanceCriteria:
- "Pacote contém componentes corretos e o build nativo acessa uma base descartá\
vel sem depender da instalação global."
- "Fixtures verificam diretórios configuráveis, atalhos, atualização conjunta e\
\ falha sem danificar instalação anterior simulada."
- "Nenhum binário, biblioteca ou atalho ativo é substituído e o instalador real\
\ não é executado; a ativação posterior continua dependente de instrução humana."
dependsOn:
- "TSK-0002"
- "TSK-0011"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:37.290314Z"
- id: "TSK-0013"
title: "Consolidar documentação e instruções do framework local"
description: "Atualizar README, docs de arquitetura/protocolo/compatibilidade/migraç\
ão e recursos de entrada para memória local, SQLite, gates e retenção mínima.\
\ Explicar anexos temporários, outputs entregues, migração explícita e recuperaç\
ão, pacote preparado e instalação adiada. Remover instruções que apresentem arquivos\
\ de Works como fonte principal nova ou Git como exigência. Preservar orientaç\
ões dos dois ciclos, OODA, DEC/Plan e aprovações."
acceptanceCriteria:
- "Documentação e recursos distribuídos descrevem o mesmo contrato e permitem inicializar/retomar\
\ um projeto sem Git."
- "Procedimento público de migração explica prévia, efeitos e recuperação sem depender\
\ de inspeção do código interno."
- "Limites de retenção e instalação, papel dos gates e recortes futuros estão claros;\
\ fontes e exemplos não alegam testes ou migrações reais não executados."
dependsOn:
- "TSK-0010"
- "TSK-0011"
- "TSK-0012"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:45.331995Z"
- id: "TSK-0014"
title: "Executar regressão integrada e encaminhar responsividade ao WRK-000C"
description: "Integrar as verificações das etapas e executar gates apropriados de\
\ testes/arquitetura, migração, concorrência e smoke JVM/nativo em ambientes descartá\
veis. Revisar continuidade e autoridade nos dois ciclos, anexos temporários, recuperaç\
ão e funcionamento sem Git. Consolidar resultados mínimos, resolver experimentos/preocupaç\
ões e entregar cenário reproduzível ao WRK-000C com comandos, versão, dados e\
\ ambiente. Não instalar o pacote nem declarar resolvido o atraso."
acceptanceCriteria:
- "Suíte relevante de domínio/integração/compatibilidade, fixtures do instalador\
\ e smoke nativo passam ou impedimentos são tratados antes da conclusão."
- "Falhas, rollback, concorrência, legado, gates e descarte legítimo foram verificados\
\ com resultados reais e sem alteração da instalação ativa ou consumidores."
- "Todos os steps e critérios da DEC estão satisfeitos, sem experimentos/preocupaç\
ões pendentes; WRK-000C recebe cenário para medição futura e permanece aberto."
dependsOn:
- "TSK-0013"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:53.421052Z"
status: "ACTIVE"
author: "Codex"
createdAt: "2026-11-22T11:52:06.993736Z"
revision: 33
previousHash: "6ee53b10324a77c886e77ff889d54f35e6b573a229c3827836c7b92c8ff759c9"
updatedAt: "2026-11-22T13:08:20.915953Z"
updatedBy: "Codex"
changeReason: "Integrar anexos temporários, resultados mínimos e recuperação de descarte\
\ após os checks dependentes."
experiments:
- id: "EXP-0001"
stepId: "TSK-0002"
hypothesis: "SQLite JDBC pode criar, persistir e reabrir uma base em processos JVM\
\ e Native Image com biblioteca distribuída ao lado do executável."
successCriterion: "As duas formas executam create/read/write/reopen e rollback em\
\ diretório descartável; o nativo usa a biblioteca do pacote com extração temporá\
ria indisponível; nenhum binário ativo ou consumidor é alterado."
invocation: "./gradlew sqliteProbeClasses nativeSqliteProbeCompile; scripts/sqlite-probe.sh\
\ <build>; execução da classe de prova JVM e do binário de build em processos\
\ distintos"
retryOf: null
reconsideration: null
by: "Codex"
createdAt: "2026-11-22T12:10:00.110720Z"
outcome: "CONFIRMED"
observation: "JVM criou e reabriu a base com UTF-8 e rollback. Native Image GraalVM\
\ 25 criou e reabriu em processos independentes com biblioteca externa e extraç\
ão sem escrita; a cópia isolada sem biblioteca falhou."
interpretation: "Driver SQLite JDBC 3.54.1.0 e biblioteca distribuída ao lado do\
\ nativo funcionam na plataforma macOS arm64. Seleção inicial de JDK foi corrigida\
\ explicitamente; sem instalação real."
nextAction: "Implementar infraestrutura transacional e esquema local no TSK-0003."
evidence:
- "ART-0002"
questionsDecision: null
finishedAt: "2026-11-22T12:16:43.109268Z"
finishedBy: "Codex"
documentVersion: 2
---
# Implementar memória de engenharia local em SQLite
## Autoridade e objetivo
Executar a DEC-0001 do WRK-000D, aceita explicitamente por Nilton nesta conversa.
O resultado é um framework local de memória de engenharia por Work, com SQLite
por projeto, investigação e implementação orientadas por OODA, gates preservados,
anexos temporários e retenção mínima. A aprovação desta DEC mantém a instalação
real adiada.
Este Plan foi solicitado com decomposição em vários steps. Todos os steps começam
OPEN; a criação do Plan não constitui execução ou comprovação de resultado.
## Limites obrigatórios
- Não instalar nem substituir o AIE, SQLite, bibliotecas ou atalhos em uso.
- Não executar o instalador real contra HOME, ~/.local/bin ou outro destino ativo.
Sua validação usa fixtures com ferramentas simuladas e destinos descartáveis.
- Não migrar este workspace canônico ou projetos consumidores. Exercitar o novo
backend e a migração em fixtures e cópias descartáveis; ativação real depende de
instrução humana posterior específica.
- Preservar alterações preexistentes, IDs, conteúdo e proveniência legada,
aprovações, evidências históricas e instruções do projeto fora do bloco gerido.
- Não introduzir arquivos em BLOB/base64 ou TEXT equivalente, retenção extensa,
executor autônomo de repositório, colaboração distribuída ou integração Git LFS.
- Importação/exportação de Works/DECs e backup como funcionalidade ficam fora.
A cópia de segurança da migração é parte da recuperação da conversão.
- Código e outputs solicitados permanecem nos destinos de entrega apropriados.
- O WRK-000C permanece aberto para avaliar e tratar latência após esta mudança.
## Execução e dependências
Os 14 steps possuem dependências explícitas e critérios próprios. Mapear primeiro
o contrato e o legado; provar a integração SQLite/JVM/Native Image; depois construir
as transações e migrar os fluxos de domínio. Integrar gates e ciclo dos anexos antes
de consolidar as consultas, a migração pública e o bootstrap. Preparar distribuição
e documentação e concluir com regressão integrada e encaminhamento ao WRK-000C.
Não iniciar um step com dependências pendentes. Verificações focadas fazem parte
de cada mudança; a última etapa integra os cenários e não substitui essas verificações.
Steps independentes podem ser executados em ordem compatível, sem presumir
autorização de delegação ou de instalação real.
## OODA e incertezas
Nas provas relevantes, principalmente driver/nativo, migração e descarte de anexos,
registrar hipótese, critério de sucesso e invocação antes de executar. Registrar
observação, interpretação e próxima ação após o resultado; reconsiderar antes de
repetir uma hipótese falha. Usar os registros de experimentos do Plan quando úteis,
sem impor um ritual de quatro fases a toda alteração.
Ajustar esquema, índices, transações e build dentro da DEC. Se um resultado
questionar a decisão, registrar a preocupação, continuar investigações autorizadas
e rever a DEC com aprovação aplicável antes da execução afetada.
## Verificação e registro mínimo
Durante a execução deste Work, respeitar o protocolo que está em uso. Registrar
resultados reais e evidência mínima necessária para completar os steps; não usar
a futura política de limpeza para apagar evidências legadas ou simular gates.
Verificar continuidade entre processos, integridade referencial, rollback,
concorrência local com espera limitada, autoridade humana, gates e anexos
temporários, migração repetível e operação sem Git. Provas nativas usam somente
artefatos de build e projetos descartáveis.
Comandos candidatos à validação, ajustados ao resultado e ao código final:
- `./gradlew test` e `./gradlew check` para a suíte e arquitetura do projeto.
- `python3 scripts/test-install-native.py` para fixtures do instalador.
- `./gradlew nativeCompile` e tarefas de distribuição para construir o pacote.
- `bash scripts/native-smoke.sh <caminho-absoluto-do-build>` em projetos descartáveis.
Esses comandos são planejados, não executados na criação do Plan. Preservar os
gates específicos do projeto e adicionais do Work definidos na execução. Logs de
trabalho podem ser temporários; guardar na memória somente o necessário ao contrato.
## Conclusão
Todos os steps obrigatórios devem satisfazer seus critérios, com a DEC aceita e
sem experimentos ou preocupações pendentes. A entrega é código, documentação,
pacote preparado e resultados de verificação. Não depende de instalar a nova
versão no ambiente em uso. Encaminhar ao WRK-000C um cenário reproduzível com
comandos, versão, volume e ambiente, sem declarar resolvido o problema de atraso.
@@ -0,0 +1,474 @@
---
schemaVersion: 1
id: "PLN-0001"
workId: "WRK-000D"
title: "Implementar memória de engenharia local em SQLite sem instalação ativa"
decisions:
- "DEC-0001"
steps:
- id: "TSK-0001"
title: "Mapear contrato, dados legados e cenários de migração"
description: "Inspecionar WorkService, serviços de Discussion/Decision/Plan/Agent,\
\ coordenadores e VerificationService. Mapear registros, referências, revisões,\
\ hashes, recibos e bootstrap para tabelas e regras do backend SQLite, preservando\
\ conteúdo e autoridade. Selecionar fixtures existentes de compatibilidade, workflows\
\ e importação como corpus; usar apenas cópias descartáveis. Identificar checks\
\ e pontos de retenção sem realizar benchmark conclusivo do WRK-000C."
acceptanceCriteria:
- "Mapeamento cobre entidades persistidas, IDs locais ao Work, referências, revisõ\
es, aprovações e casos de conclusão legada com hashes/recibos."
- "Corpus representativo e resultados esperados de continuidade/migração estão definidos\
\ antes da conversão, incluindo dados inválidos e estados interrompidos."
- "Limites de instalação, migração de consumidores e preservação do workspace atual\
\ estão explícitos e respeitados."
dependsOn: []
status: "COMPLETED"
result: "Contrato e legado mapeados em docs/sqlite-migration-design.md; corpus e\
\ casos de falha/retry definidos antes da migração. Baseline: 45 testes em seis\
\ classes passaram, hashes congelados conferidos e fontes históricas intactas.\
\ Sem instalação ou migração real."
evidence:
- "ART-0001"
updatedAt: "2026-11-22T12:00:26.700050Z"
- id: "TSK-0002"
title: "Provar driver SQLite em JVM e Native Image"
description: "Avaliar Xerial SQLite JDBC e fixar versão compatível com Java, Gradle\
\ e GraalVM do projeto. Registrar hipótese, critério e invocação antes da prova.\
\ Criar, gravar, ler e reabrir uma base descartável em processos JVM e nativos.\
\ Verificar carregamento da biblioteca distribuída ao lado do nativo; sqlite3\
\ será ferramenta de diagnóstico do pacote. Construir e executar somente artefatos\
\ descartáveis, sem instalação real."
acceptanceCriteria:
- "Driver e versão selecionados demonstram persistência e reabertura em JVM e Native\
\ Image na plataforma alvo."
- "Biblioteca do pacote é encontrada por caminho controlado e não depende acidentalmente\
\ do SQLite global ou de extração repetida não planejada."
- "Hipótese, resultado e limitações da prova estão registrados; instalação ativa\
\ e projetos consumidores não foram alterados."
dependsOn:
- "TSK-0001"
status: "COMPLETED"
result: "Prova JVM e Native Image passou create/read/write/reopen, UTF-8, rollback\
\ e dependência da biblioteca do pacote; sem instalação ativa."
evidence:
- "ART-0002"
updatedAt: "2026-11-22T12:16:52.149066Z"
- id: "TSK-0003"
title: "Implementar esquema, conexões e transações SQLite"
description: "Criar infraestrutura de persistência local em .ai-engineering/aie.db\
\ com esquema versionado, tabelas tipadas, índices e relações. Habilitar integridade\
\ referencial em cada conexão, delimitar unidade transacional por operação coerente\
\ e usar leitura consistente. Definir journal/durabilidade e espera limitada de\
\ escrita com diagnóstico. Preservar limites de módulos; serviços aninhados devem\
\ compartilhar a transação aplicável."
acceptanceCriteria:
- "Esquema e índices atendem ao mapeamento sem BLOB/base64 ou arquivos completos\
\ serializados em TEXT."
- "Falha em operação relacionada causa rollback; referências inválidas são recusadas\
\ e gravações concorrentes têm contenção limitada e diagnóstico útil."
- "Abertura de esquema incompatível é diagnosticada sem alterar dados; teste de\
\ leitura consistente cobre mudanças concorrentes locais."
dependsOn:
- "TSK-0001"
- "TSK-0002"
status: "COMPLETED"
result: "Infraestrutura SQLite validada: 12 testes de transação/integridade/concorrê\
ncia e arquitetura passaram; schema também criado e reaberto pelo Native Image.\
\ CLI de domínio e instalação ativa continuam intactos."
evidence:
- "ART-0003"
updatedAt: "2026-11-22T12:26:10.846492Z"
- id: "TSK-0004"
title: "Persistir Works e investigação no novo backend"
description: "Integrar Work, guidance e histórico de escolhas, discussões, tópicos,\
\ surveys, respostas e disposições à unidade de persistência. Preservar IDs existentes,\
\ semântica dos IDs locais, referências e histórico útil. Consultas selecionadas\
\ devem buscar o Work diretamente. Manter leitura legada delimitada para compatibilidade\
\ e migração; não manter duas fontes autoritativas para a mesma memória."
acceptanceCriteria:
- "Criar e retomar Work/discussão/survey em outro processo preserva conteúdo, histó\
rico de respostas e pendências."
- "Escolhas DIRECT/EXPLORATORY e autoridade humana mantêm as regras existentes,\
\ inclusive ausência de escolha e pedido específico de DEC."
- "Busca por Work e suas referências usa consultas com escopo adequado; alteraçõ\
es e referências relacionadas são transacionais."
dependsOn:
- "TSK-0003"
status: "COMPLETED"
result: "Works/investigação SQLite passaram 45 testes e retomada em outro JVM e\
\ nativo; referências transacionais, histórico e autoridade preservados."
evidence:
- "ART-0004"
updatedAt: "2026-11-22T12:43:38.166159Z"
- id: "TSK-0005"
title: "Persistir decisões, planos e experimentos"
description: "Integrar DecisionService e PlanService com revisões, aceitação, supersessã\
o, passos, dependências e experimentos. Preservar os dois ciclos e OODA, a autoridade\
\ de DEC/Plan e a distinção entre aprovação humana e promoção permitida por polí\
tica. Tratar operações que alteram registros relacionados em uma transação, sem\
\ reduzir os checks de domínio."
acceptanceCriteria:
- "Aprovação, revisão e supersessão preservam autoria e referências, sem fabricaç\
ão de aprovação ou edição silenciosa de decisão aceita."
- "Dependências e estados de passos, critérios de experimentos, preocupações com\
\ DEC e replanejamento conservam os bloqueios existentes."
- "Interrupção simulada não publica meia supersessão ou promoção parcial; retomada\
\ em outro processo preserva o contexto."
dependsOn:
- "TSK-0004"
status: "COMPLETED"
result: "Decisões/Plans/experimentos SQLite preservam autoridade, revisão, dependê\
ncias e rollback conjunto; 34 cenários distintos selecionados passaram ao final\
\ após ajuste textual de um teste."
evidence:
- "ART-0005"
updatedAt: "2026-11-22T12:54:10.341537Z"
- id: "TSK-0006"
title: "Integrar execuções de agentes e coordenação de EPICs"
description: "Persistir RUNs e seus dados operacionais mínimos, idempotência de\
\ requestId, referências aplicadas e diagnóstico. Integrar PlanCoordinator/EpicCoordinator,\
\ políticas e proveniência de conclusão, representando recibos internos como dados\
\ estruturados quando aplicável. Preservar a fronteira do adaptador: propostas\
\ não aprovam DEC, não respondem pelo humano nem executam comandos de repositó\
rio."
acceptanceCriteria:
- "Repetição idempotente de uma solicitação concluída não duplica registros; solicitaç\
ões divergentes e estados interrompidos são diagnosticados."
- "Políticas RESULTS/DECOMPOSITION, delegação, reabertura, propagação e conclusã\
o por Plans preservam autoridade e proveniência."
- "Resultados estruturados necessários permanecem; transporte bruto, ambiente e\
\ logs completos não viram acervo permanente no banco."
dependsOn:
- "TSK-0005"
status: "COMPLETED"
result: "RUNs/EPICs persistidos e coordenação preservada; 30 cenários distintos\
\ passaram, incluindo rollback integral e idempotência."
evidence:
- "ART-0006"
updatedAt: "2026-11-22T13:02:08.858215Z"
- id: "TSK-0007"
title: "Integrar gates do projeto e adicionais por Work"
description: "Representar gates obrigatórios do projeto e complementos do Work e\
\ conectar seus resultados aos checks e à entrega. Preservar avaliação externa\
\ e condições de qualidade, inclusive anexos exigidos. Registrar identificaçã\
o, procedimento/execução, estado avaliado, momento e resultado mínimo. Alteraç\
ões pertinentes invalidam a aplicação do resultado aos gates afetados; aprovaç\
ão humana não equivale a sucesso técnico."
acceptanceCriteria:
- "Gate obrigatório pendente, falho ou não executado bloqueia a entrega; gates adicionais\
\ do Work são considerados sem dispensar obrigatórios do projeto."
- "Resultados correspondem ao estado realmente avaliado e não satisfazem silenciosamente\
\ um gate após mudança relevante."
- "Checks existentes e anexos necessários continuam exigidos durante avaliação,\
\ sem introduzir executor autônomo ou retenção bruta obrigatória."
dependsOn:
- "TSK-0005"
- "TSK-0006"
status: "COMPLETED"
result: "Gates cumulativos bloqueiam entrega sem PASS atual; snapshots históricos\
\ preservados. 23 cenários focados passaram."
evidence:
- "ART-0007"
updatedAt: "2026-11-22T13:08:08.952170Z"
- id: "TSK-0008"
title: "Implementar anexos temporários e descarte após checks"
description: "Definir ciclo de vida de anexos e arquivos de execução no filesystem.\
\ Publicar arquivos completos, validar e registrar resultados mínimos antes do\
\ descarte; limpar elegíveis ao fim da execução. Proteger anexos ainda usados\
\ por checks pendentes e outputs solicitados. Recuperar falhas entre publicaçã\
o de arquivo, transação no banco e limpeza, distinguindo descarte legítimo de\
\ perda prematura. Não descartar artefatos legados deste workspace."
acceptanceCriteria:
- "Arquivos exigidos permanecem acessíveis até todos os checks dependentes terminarem,\
\ com resultado persistido antes da remoção."
- "Descarte automático preserva outputs solicitados e memória histórica; arquivo\
\ perdido antes da avaliação continua causando falha."
- "Interrupções nos pontos de publicação, registro e limpeza não fabricam sucesso\
\ e permitem recuperação sem remoção de entradas ainda necessárias."
dependsOn:
- "TSK-0007"
status: "ACTIVE"
result: "Integrar anexos temporários, resultados mínimos e recuperação de descarte\
\ após os checks dependentes."
evidence: []
updatedAt: "2026-11-22T13:08:20.915778Z"
- id: "TSK-0009"
title: "Adaptar verificação, status e contexto ao SQLite"
description: "Integrar VerificationService, CompatibilityService e projeções da\
\ CLI ao backend. Montar status, next-actions, context e readiness com consultas\
\ necessárias e resultados reutilizados na invocação; preservar contrato público\
\ quando compatível e informar mudanças. Separar resultado histórico com anexo\
\ descartado legitimamente de validação ativa. Manter diagnóstico de reparo e\
\ ausência de transições de estado em consultas."
acceptanceCriteria:
- "Consultas e contexto em processos novos preservam informações e autoridade e\
\ não promovem, migram ou concluem registros por leitura."
- "Anexos descartados legitimamente não invalidam histórico; corrupção e referê\
ncias ausentes não são tratadas como gates satisfeitos."
- "Caminhos selecionados não repetem varreduras/validações globais sem necessidade;\
\ saída e códigos de erro compatíveis são verificados."
dependsOn:
- "TSK-0004"
- "TSK-0005"
- "TSK-0006"
- "TSK-0008"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:13.390096Z"
- id: "TSK-0010"
title: "Implementar migração explícita e recuperável do legado"
description: "Criar comando público de prévia e aplicação da migração, sem conversã\
o em leituras ou atualização do instalador. Usar base de preparo e cópia de seguranç\
a da conversão, importação tipada transacional e verificação contra o corpus.\
\ Preservar IDs, conteúdo, aprovações, hashes, revisões e proveniência histórica\
\ sem despejar arquivos no banco. Ativar somente após sucesso; repetir ou recuperar\
\ interrupção sem duplicar. Executar apenas em fixtures/cópias descartáveis."
acceptanceCriteria:
- "Prévia não modifica o projeto; aplicação compara registros/contexto e ativa a\
\ base somente após validação completa."
- "Fixtures históricas, recibos, aprovações e referências preservam identidade/proveniê\
ncia; execução repetida não duplica conteúdo."
- "Falhas e interrupções deixam a fonte anterior recuperável e informam próxima\
\ ação; nenhum projeto real ou workspace canônico foi migrado."
dependsOn:
- "TSK-0001"
- "TSK-0009"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:21.074969Z"
- id: "TSK-0011"
title: "Atualizar init, descoberta e contrato de compatibilidade"
description: "Inicializar projetos locais em SQLite e deixar .ai-engineering ignorado\
\ pelo Git por padrão sem exigir Git. Preservar regras preexistentes e instruç\
ões fora do bloco gerido. Declarar backend e versões no contrato público, atualizar\
\ diagnóstico/onboard e evitar que base SQLite seja interpretada como workspace\
\ vazio por combinação incompatível. Manter tratamento explícito de projetos legados\
\ e previamente rastreados."
acceptanceCriteria:
- "Init cria projeto funcional sem Git, com estado local ignorado por padrão e bootstrap\
\ suficiente para humanos e agentes."
- "Reexecução preserva conteúdo/regras; não remove arquivos já rastreados nem converte\
\ legado automaticamente."
- "Versões e backend incompatíveis são recusados com diagnóstico acionável antes\
\ de escrita; documentação/entrypoints não induzem uso de CLI incompatível."
dependsOn:
- "TSK-0009"
- "TSK-0010"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:28.841960Z"
- id: "TSK-0012"
title: "Preparar pacote nativo e instalador conjunto sem ativação"
description: "Evoluir build/distribuição e scripts/install-native.sh para empacotar\
\ AIE nativo, biblioteca SQLite do driver e CLI sqlite3 num diretório configurá\
vel, com atalhos aie/ai-engineering e dados de projeto separados. Fixar componentes/plataformas\
\ e verificar pacote antes de ativação, preservando versão anterior em falhas.\
\ Testar instalador com ferramentas simuladas e destinos descartáveis; smoke usa\
\ build local. Não executar instalação real nem tocar ~/.local/bin ou dependê\
ncias ativas."
acceptanceCriteria:
- "Pacote contém componentes corretos e o build nativo acessa uma base descartá\
vel sem depender da instalação global."
- "Fixtures verificam diretórios configuráveis, atalhos, atualização conjunta e\
\ falha sem danificar instalação anterior simulada."
- "Nenhum binário, biblioteca ou atalho ativo é substituído e o instalador real\
\ não é executado; a ativação posterior continua dependente de instrução humana."
dependsOn:
- "TSK-0002"
- "TSK-0011"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:37.290314Z"
- id: "TSK-0013"
title: "Consolidar documentação e instruções do framework local"
description: "Atualizar README, docs de arquitetura/protocolo/compatibilidade/migraç\
ão e recursos de entrada para memória local, SQLite, gates e retenção mínima.\
\ Explicar anexos temporários, outputs entregues, migração explícita e recuperaç\
ão, pacote preparado e instalação adiada. Remover instruções que apresentem arquivos\
\ de Works como fonte principal nova ou Git como exigência. Preservar orientaç\
ões dos dois ciclos, OODA, DEC/Plan e aprovações."
acceptanceCriteria:
- "Documentação e recursos distribuídos descrevem o mesmo contrato e permitem inicializar/retomar\
\ um projeto sem Git."
- "Procedimento público de migração explica prévia, efeitos e recuperação sem depender\
\ de inspeção do código interno."
- "Limites de retenção e instalação, papel dos gates e recortes futuros estão claros;\
\ fontes e exemplos não alegam testes ou migrações reais não executados."
dependsOn:
- "TSK-0010"
- "TSK-0011"
- "TSK-0012"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:45.331995Z"
- id: "TSK-0014"
title: "Executar regressão integrada e encaminhar responsividade ao WRK-000C"
description: "Integrar as verificações das etapas e executar gates apropriados de\
\ testes/arquitetura, migração, concorrência e smoke JVM/nativo em ambientes descartá\
veis. Revisar continuidade e autoridade nos dois ciclos, anexos temporários, recuperaç\
ão e funcionamento sem Git. Consolidar resultados mínimos, resolver experimentos/preocupaç\
ões e entregar cenário reproduzível ao WRK-000C com comandos, versão, dados e\
\ ambiente. Não instalar o pacote nem declarar resolvido o atraso."
acceptanceCriteria:
- "Suíte relevante de domínio/integração/compatibilidade, fixtures do instalador\
\ e smoke nativo passam ou impedimentos são tratados antes da conclusão."
- "Falhas, rollback, concorrência, legado, gates e descarte legítimo foram verificados\
\ com resultados reais e sem alteração da instalação ativa ou consumidores."
- "Todos os steps e critérios da DEC estão satisfeitos, sem experimentos/preocupaç\
ões pendentes; WRK-000C recebe cenário para medição futura e permanece aberto."
dependsOn:
- "TSK-0013"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:53.421052Z"
status: "ACTIVE"
author: "Codex"
createdAt: "2026-11-22T11:52:06.993736Z"
revision: 34
previousHash: "527e8276dd84f7b24c72b909831977a045ca5f8f8cc710733a39c4406662e6df"
updatedAt: "2026-11-22T13:12:55.720974Z"
updatedBy: "Codex"
changeReason: "Provar a fronteira entre resultado persistido e arquivo temporario\
\ antes da limpeza automatica."
experiments:
- id: "EXP-0001"
stepId: "TSK-0002"
hypothesis: "SQLite JDBC pode criar, persistir e reabrir uma base em processos JVM\
\ e Native Image com biblioteca distribuída ao lado do executável."
successCriterion: "As duas formas executam create/read/write/reopen e rollback em\
\ diretório descartável; o nativo usa a biblioteca do pacote com extração temporá\
ria indisponível; nenhum binário ativo ou consumidor é alterado."
invocation: "./gradlew sqliteProbeClasses nativeSqliteProbeCompile; scripts/sqlite-probe.sh\
\ <build>; execução da classe de prova JVM e do binário de build em processos\
\ distintos"
retryOf: null
reconsideration: null
by: "Codex"
createdAt: "2026-11-22T12:10:00.110720Z"
outcome: "CONFIRMED"
observation: "JVM criou e reabriu a base com UTF-8 e rollback. Native Image GraalVM\
\ 25 criou e reabriu em processos independentes com biblioteca externa e extraç\
ão sem escrita; a cópia isolada sem biblioteca falhou."
interpretation: "Driver SQLite JDBC 3.54.1.0 e biblioteca distribuída ao lado do\
\ nativo funcionam na plataforma macOS arm64. Seleção inicial de JDK foi corrigida\
\ explicitamente; sem instalação real."
nextAction: "Implementar infraestrutura transacional e esquema local no TSK-0003."
evidence:
- "ART-0002"
questionsDecision: null
finishedAt: "2026-11-22T12:16:43.109268Z"
finishedBy: "Codex"
- id: "EXP-0002"
stepId: "TSK-0008"
hypothesis: "Anexos temporarios podem ser descartados apos a conclusao sem perder\
\ resultados historicos ou aceitar entradas ausentes em novos checks."
successCriterion: "Fixtures confirmam retencao durante checks, limpeza apos commit,\
\ rollback sem apagar entradas, recuperacao de descarte interrompido e recusa\
\ de evidencia perdida ou aposentada em avaliacao atual."
invocation: "./gradlew test --tests *SqliteArtifactLifecycleTest --tests *SqliteCoordinationTest\
\ --tests *SqliteQualityGatesTest"
retryOf: null
reconsideration: null
by: "Codex"
createdAt: "2026-11-22T13:12:55.720771Z"
outcome: "OPEN"
observation: null
interpretation: null
nextAction: null
evidence: []
questionsDecision: null
finishedAt: null
finishedBy: null
documentVersion: 2
---
# Implementar memória de engenharia local em SQLite
## Autoridade e objetivo
Executar a DEC-0001 do WRK-000D, aceita explicitamente por Nilton nesta conversa.
O resultado é um framework local de memória de engenharia por Work, com SQLite
por projeto, investigação e implementação orientadas por OODA, gates preservados,
anexos temporários e retenção mínima. A aprovação desta DEC mantém a instalação
real adiada.
Este Plan foi solicitado com decomposição em vários steps. Todos os steps começam
OPEN; a criação do Plan não constitui execução ou comprovação de resultado.
## Limites obrigatórios
- Não instalar nem substituir o AIE, SQLite, bibliotecas ou atalhos em uso.
- Não executar o instalador real contra HOME, ~/.local/bin ou outro destino ativo.
Sua validação usa fixtures com ferramentas simuladas e destinos descartáveis.
- Não migrar este workspace canônico ou projetos consumidores. Exercitar o novo
backend e a migração em fixtures e cópias descartáveis; ativação real depende de
instrução humana posterior específica.
- Preservar alterações preexistentes, IDs, conteúdo e proveniência legada,
aprovações, evidências históricas e instruções do projeto fora do bloco gerido.
- Não introduzir arquivos em BLOB/base64 ou TEXT equivalente, retenção extensa,
executor autônomo de repositório, colaboração distribuída ou integração Git LFS.
- Importação/exportação de Works/DECs e backup como funcionalidade ficam fora.
A cópia de segurança da migração é parte da recuperação da conversão.
- Código e outputs solicitados permanecem nos destinos de entrega apropriados.
- O WRK-000C permanece aberto para avaliar e tratar latência após esta mudança.
## Execução e dependências
Os 14 steps possuem dependências explícitas e critérios próprios. Mapear primeiro
o contrato e o legado; provar a integração SQLite/JVM/Native Image; depois construir
as transações e migrar os fluxos de domínio. Integrar gates e ciclo dos anexos antes
de consolidar as consultas, a migração pública e o bootstrap. Preparar distribuição
e documentação e concluir com regressão integrada e encaminhamento ao WRK-000C.
Não iniciar um step com dependências pendentes. Verificações focadas fazem parte
de cada mudança; a última etapa integra os cenários e não substitui essas verificações.
Steps independentes podem ser executados em ordem compatível, sem presumir
autorização de delegação ou de instalação real.
## OODA e incertezas
Nas provas relevantes, principalmente driver/nativo, migração e descarte de anexos,
registrar hipótese, critério de sucesso e invocação antes de executar. Registrar
observação, interpretação e próxima ação após o resultado; reconsiderar antes de
repetir uma hipótese falha. Usar os registros de experimentos do Plan quando úteis,
sem impor um ritual de quatro fases a toda alteração.
Ajustar esquema, índices, transações e build dentro da DEC. Se um resultado
questionar a decisão, registrar a preocupação, continuar investigações autorizadas
e rever a DEC com aprovação aplicável antes da execução afetada.
## Verificação e registro mínimo
Durante a execução deste Work, respeitar o protocolo que está em uso. Registrar
resultados reais e evidência mínima necessária para completar os steps; não usar
a futura política de limpeza para apagar evidências legadas ou simular gates.
Verificar continuidade entre processos, integridade referencial, rollback,
concorrência local com espera limitada, autoridade humana, gates e anexos
temporários, migração repetível e operação sem Git. Provas nativas usam somente
artefatos de build e projetos descartáveis.
Comandos candidatos à validação, ajustados ao resultado e ao código final:
- `./gradlew test` e `./gradlew check` para a suíte e arquitetura do projeto.
- `python3 scripts/test-install-native.py` para fixtures do instalador.
- `./gradlew nativeCompile` e tarefas de distribuição para construir o pacote.
- `bash scripts/native-smoke.sh <caminho-absoluto-do-build>` em projetos descartáveis.
Esses comandos são planejados, não executados na criação do Plan. Preservar os
gates específicos do projeto e adicionais do Work definidos na execução. Logs de
trabalho podem ser temporários; guardar na memória somente o necessário ao contrato.
## Conclusão
Todos os steps obrigatórios devem satisfazer seus critérios, com a DEC aceita e
sem experimentos ou preocupações pendentes. A entrega é código, documentação,
pacote preparado e resultados de verificação. Não depende de instalar a nova
versão no ambiente em uso. Encaminhar ao WRK-000C um cenário reproduzível com
comandos, versão, volume e ambiente, sem declarar resolvido o problema de atraso.
@@ -0,0 +1,478 @@
---
schemaVersion: 1
id: "PLN-0001"
workId: "WRK-000D"
title: "Implementar memória de engenharia local em SQLite sem instalação ativa"
decisions:
- "DEC-0001"
steps:
- id: "TSK-0001"
title: "Mapear contrato, dados legados e cenários de migração"
description: "Inspecionar WorkService, serviços de Discussion/Decision/Plan/Agent,\
\ coordenadores e VerificationService. Mapear registros, referências, revisões,\
\ hashes, recibos e bootstrap para tabelas e regras do backend SQLite, preservando\
\ conteúdo e autoridade. Selecionar fixtures existentes de compatibilidade, workflows\
\ e importação como corpus; usar apenas cópias descartáveis. Identificar checks\
\ e pontos de retenção sem realizar benchmark conclusivo do WRK-000C."
acceptanceCriteria:
- "Mapeamento cobre entidades persistidas, IDs locais ao Work, referências, revisõ\
es, aprovações e casos de conclusão legada com hashes/recibos."
- "Corpus representativo e resultados esperados de continuidade/migração estão definidos\
\ antes da conversão, incluindo dados inválidos e estados interrompidos."
- "Limites de instalação, migração de consumidores e preservação do workspace atual\
\ estão explícitos e respeitados."
dependsOn: []
status: "COMPLETED"
result: "Contrato e legado mapeados em docs/sqlite-migration-design.md; corpus e\
\ casos de falha/retry definidos antes da migração. Baseline: 45 testes em seis\
\ classes passaram, hashes congelados conferidos e fontes históricas intactas.\
\ Sem instalação ou migração real."
evidence:
- "ART-0001"
updatedAt: "2026-11-22T12:00:26.700050Z"
- id: "TSK-0002"
title: "Provar driver SQLite em JVM e Native Image"
description: "Avaliar Xerial SQLite JDBC e fixar versão compatível com Java, Gradle\
\ e GraalVM do projeto. Registrar hipótese, critério e invocação antes da prova.\
\ Criar, gravar, ler e reabrir uma base descartável em processos JVM e nativos.\
\ Verificar carregamento da biblioteca distribuída ao lado do nativo; sqlite3\
\ será ferramenta de diagnóstico do pacote. Construir e executar somente artefatos\
\ descartáveis, sem instalação real."
acceptanceCriteria:
- "Driver e versão selecionados demonstram persistência e reabertura em JVM e Native\
\ Image na plataforma alvo."
- "Biblioteca do pacote é encontrada por caminho controlado e não depende acidentalmente\
\ do SQLite global ou de extração repetida não planejada."
- "Hipótese, resultado e limitações da prova estão registrados; instalação ativa\
\ e projetos consumidores não foram alterados."
dependsOn:
- "TSK-0001"
status: "COMPLETED"
result: "Prova JVM e Native Image passou create/read/write/reopen, UTF-8, rollback\
\ e dependência da biblioteca do pacote; sem instalação ativa."
evidence:
- "ART-0002"
updatedAt: "2026-11-22T12:16:52.149066Z"
- id: "TSK-0003"
title: "Implementar esquema, conexões e transações SQLite"
description: "Criar infraestrutura de persistência local em .ai-engineering/aie.db\
\ com esquema versionado, tabelas tipadas, índices e relações. Habilitar integridade\
\ referencial em cada conexão, delimitar unidade transacional por operação coerente\
\ e usar leitura consistente. Definir journal/durabilidade e espera limitada de\
\ escrita com diagnóstico. Preservar limites de módulos; serviços aninhados devem\
\ compartilhar a transação aplicável."
acceptanceCriteria:
- "Esquema e índices atendem ao mapeamento sem BLOB/base64 ou arquivos completos\
\ serializados em TEXT."
- "Falha em operação relacionada causa rollback; referências inválidas são recusadas\
\ e gravações concorrentes têm contenção limitada e diagnóstico útil."
- "Abertura de esquema incompatível é diagnosticada sem alterar dados; teste de\
\ leitura consistente cobre mudanças concorrentes locais."
dependsOn:
- "TSK-0001"
- "TSK-0002"
status: "COMPLETED"
result: "Infraestrutura SQLite validada: 12 testes de transação/integridade/concorrê\
ncia e arquitetura passaram; schema também criado e reaberto pelo Native Image.\
\ CLI de domínio e instalação ativa continuam intactos."
evidence:
- "ART-0003"
updatedAt: "2026-11-22T12:26:10.846492Z"
- id: "TSK-0004"
title: "Persistir Works e investigação no novo backend"
description: "Integrar Work, guidance e histórico de escolhas, discussões, tópicos,\
\ surveys, respostas e disposições à unidade de persistência. Preservar IDs existentes,\
\ semântica dos IDs locais, referências e histórico útil. Consultas selecionadas\
\ devem buscar o Work diretamente. Manter leitura legada delimitada para compatibilidade\
\ e migração; não manter duas fontes autoritativas para a mesma memória."
acceptanceCriteria:
- "Criar e retomar Work/discussão/survey em outro processo preserva conteúdo, histó\
rico de respostas e pendências."
- "Escolhas DIRECT/EXPLORATORY e autoridade humana mantêm as regras existentes,\
\ inclusive ausência de escolha e pedido específico de DEC."
- "Busca por Work e suas referências usa consultas com escopo adequado; alteraçõ\
es e referências relacionadas são transacionais."
dependsOn:
- "TSK-0003"
status: "COMPLETED"
result: "Works/investigação SQLite passaram 45 testes e retomada em outro JVM e\
\ nativo; referências transacionais, histórico e autoridade preservados."
evidence:
- "ART-0004"
updatedAt: "2026-11-22T12:43:38.166159Z"
- id: "TSK-0005"
title: "Persistir decisões, planos e experimentos"
description: "Integrar DecisionService e PlanService com revisões, aceitação, supersessã\
o, passos, dependências e experimentos. Preservar os dois ciclos e OODA, a autoridade\
\ de DEC/Plan e a distinção entre aprovação humana e promoção permitida por polí\
tica. Tratar operações que alteram registros relacionados em uma transação, sem\
\ reduzir os checks de domínio."
acceptanceCriteria:
- "Aprovação, revisão e supersessão preservam autoria e referências, sem fabricaç\
ão de aprovação ou edição silenciosa de decisão aceita."
- "Dependências e estados de passos, critérios de experimentos, preocupações com\
\ DEC e replanejamento conservam os bloqueios existentes."
- "Interrupção simulada não publica meia supersessão ou promoção parcial; retomada\
\ em outro processo preserva o contexto."
dependsOn:
- "TSK-0004"
status: "COMPLETED"
result: "Decisões/Plans/experimentos SQLite preservam autoridade, revisão, dependê\
ncias e rollback conjunto; 34 cenários distintos selecionados passaram ao final\
\ após ajuste textual de um teste."
evidence:
- "ART-0005"
updatedAt: "2026-11-22T12:54:10.341537Z"
- id: "TSK-0006"
title: "Integrar execuções de agentes e coordenação de EPICs"
description: "Persistir RUNs e seus dados operacionais mínimos, idempotência de\
\ requestId, referências aplicadas e diagnóstico. Integrar PlanCoordinator/EpicCoordinator,\
\ políticas e proveniência de conclusão, representando recibos internos como dados\
\ estruturados quando aplicável. Preservar a fronteira do adaptador: propostas\
\ não aprovam DEC, não respondem pelo humano nem executam comandos de repositó\
rio."
acceptanceCriteria:
- "Repetição idempotente de uma solicitação concluída não duplica registros; solicitaç\
ões divergentes e estados interrompidos são diagnosticados."
- "Políticas RESULTS/DECOMPOSITION, delegação, reabertura, propagação e conclusã\
o por Plans preservam autoridade e proveniência."
- "Resultados estruturados necessários permanecem; transporte bruto, ambiente e\
\ logs completos não viram acervo permanente no banco."
dependsOn:
- "TSK-0005"
status: "COMPLETED"
result: "RUNs/EPICs persistidos e coordenação preservada; 30 cenários distintos\
\ passaram, incluindo rollback integral e idempotência."
evidence:
- "ART-0006"
updatedAt: "2026-11-22T13:02:08.858215Z"
- id: "TSK-0007"
title: "Integrar gates do projeto e adicionais por Work"
description: "Representar gates obrigatórios do projeto e complementos do Work e\
\ conectar seus resultados aos checks e à entrega. Preservar avaliação externa\
\ e condições de qualidade, inclusive anexos exigidos. Registrar identificaçã\
o, procedimento/execução, estado avaliado, momento e resultado mínimo. Alteraç\
ões pertinentes invalidam a aplicação do resultado aos gates afetados; aprovaç\
ão humana não equivale a sucesso técnico."
acceptanceCriteria:
- "Gate obrigatório pendente, falho ou não executado bloqueia a entrega; gates adicionais\
\ do Work são considerados sem dispensar obrigatórios do projeto."
- "Resultados correspondem ao estado realmente avaliado e não satisfazem silenciosamente\
\ um gate após mudança relevante."
- "Checks existentes e anexos necessários continuam exigidos durante avaliação,\
\ sem introduzir executor autônomo ou retenção bruta obrigatória."
dependsOn:
- "TSK-0005"
- "TSK-0006"
status: "COMPLETED"
result: "Gates cumulativos bloqueiam entrega sem PASS atual; snapshots históricos\
\ preservados. 23 cenários focados passaram."
evidence:
- "ART-0007"
updatedAt: "2026-11-22T13:08:08.952170Z"
- id: "TSK-0008"
title: "Implementar anexos temporários e descarte após checks"
description: "Definir ciclo de vida de anexos e arquivos de execução no filesystem.\
\ Publicar arquivos completos, validar e registrar resultados mínimos antes do\
\ descarte; limpar elegíveis ao fim da execução. Proteger anexos ainda usados\
\ por checks pendentes e outputs solicitados. Recuperar falhas entre publicaçã\
o de arquivo, transação no banco e limpeza, distinguindo descarte legítimo de\
\ perda prematura. Não descartar artefatos legados deste workspace."
acceptanceCriteria:
- "Arquivos exigidos permanecem acessíveis até todos os checks dependentes terminarem,\
\ com resultado persistido antes da remoção."
- "Descarte automático preserva outputs solicitados e memória histórica; arquivo\
\ perdido antes da avaliação continua causando falha."
- "Interrupções nos pontos de publicação, registro e limpeza não fabricam sucesso\
\ e permitem recuperação sem remoção de entradas ainda necessárias."
dependsOn:
- "TSK-0007"
status: "ACTIVE"
result: "Integrar anexos temporários, resultados mínimos e recuperação de descarte\
\ após os checks dependentes."
evidence: []
updatedAt: "2026-11-22T13:08:20.915778Z"
- id: "TSK-0009"
title: "Adaptar verificação, status e contexto ao SQLite"
description: "Integrar VerificationService, CompatibilityService e projeções da\
\ CLI ao backend. Montar status, next-actions, context e readiness com consultas\
\ necessárias e resultados reutilizados na invocação; preservar contrato público\
\ quando compatível e informar mudanças. Separar resultado histórico com anexo\
\ descartado legitimamente de validação ativa. Manter diagnóstico de reparo e\
\ ausência de transições de estado em consultas."
acceptanceCriteria:
- "Consultas e contexto em processos novos preservam informações e autoridade e\
\ não promovem, migram ou concluem registros por leitura."
- "Anexos descartados legitimamente não invalidam histórico; corrupção e referê\
ncias ausentes não são tratadas como gates satisfeitos."
- "Caminhos selecionados não repetem varreduras/validações globais sem necessidade;\
\ saída e códigos de erro compatíveis são verificados."
dependsOn:
- "TSK-0004"
- "TSK-0005"
- "TSK-0006"
- "TSK-0008"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:13.390096Z"
- id: "TSK-0010"
title: "Implementar migração explícita e recuperável do legado"
description: "Criar comando público de prévia e aplicação da migração, sem conversã\
o em leituras ou atualização do instalador. Usar base de preparo e cópia de seguranç\
a da conversão, importação tipada transacional e verificação contra o corpus.\
\ Preservar IDs, conteúdo, aprovações, hashes, revisões e proveniência histórica\
\ sem despejar arquivos no banco. Ativar somente após sucesso; repetir ou recuperar\
\ interrupção sem duplicar. Executar apenas em fixtures/cópias descartáveis."
acceptanceCriteria:
- "Prévia não modifica o projeto; aplicação compara registros/contexto e ativa a\
\ base somente após validação completa."
- "Fixtures históricas, recibos, aprovações e referências preservam identidade/proveniê\
ncia; execução repetida não duplica conteúdo."
- "Falhas e interrupções deixam a fonte anterior recuperável e informam próxima\
\ ação; nenhum projeto real ou workspace canônico foi migrado."
dependsOn:
- "TSK-0001"
- "TSK-0009"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:21.074969Z"
- id: "TSK-0011"
title: "Atualizar init, descoberta e contrato de compatibilidade"
description: "Inicializar projetos locais em SQLite e deixar .ai-engineering ignorado\
\ pelo Git por padrão sem exigir Git. Preservar regras preexistentes e instruç\
ões fora do bloco gerido. Declarar backend e versões no contrato público, atualizar\
\ diagnóstico/onboard e evitar que base SQLite seja interpretada como workspace\
\ vazio por combinação incompatível. Manter tratamento explícito de projetos legados\
\ e previamente rastreados."
acceptanceCriteria:
- "Init cria projeto funcional sem Git, com estado local ignorado por padrão e bootstrap\
\ suficiente para humanos e agentes."
- "Reexecução preserva conteúdo/regras; não remove arquivos já rastreados nem converte\
\ legado automaticamente."
- "Versões e backend incompatíveis são recusados com diagnóstico acionável antes\
\ de escrita; documentação/entrypoints não induzem uso de CLI incompatível."
dependsOn:
- "TSK-0009"
- "TSK-0010"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:28.841960Z"
- id: "TSK-0012"
title: "Preparar pacote nativo e instalador conjunto sem ativação"
description: "Evoluir build/distribuição e scripts/install-native.sh para empacotar\
\ AIE nativo, biblioteca SQLite do driver e CLI sqlite3 num diretório configurá\
vel, com atalhos aie/ai-engineering e dados de projeto separados. Fixar componentes/plataformas\
\ e verificar pacote antes de ativação, preservando versão anterior em falhas.\
\ Testar instalador com ferramentas simuladas e destinos descartáveis; smoke usa\
\ build local. Não executar instalação real nem tocar ~/.local/bin ou dependê\
ncias ativas."
acceptanceCriteria:
- "Pacote contém componentes corretos e o build nativo acessa uma base descartá\
vel sem depender da instalação global."
- "Fixtures verificam diretórios configuráveis, atalhos, atualização conjunta e\
\ falha sem danificar instalação anterior simulada."
- "Nenhum binário, biblioteca ou atalho ativo é substituído e o instalador real\
\ não é executado; a ativação posterior continua dependente de instrução humana."
dependsOn:
- "TSK-0002"
- "TSK-0011"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:37.290314Z"
- id: "TSK-0013"
title: "Consolidar documentação e instruções do framework local"
description: "Atualizar README, docs de arquitetura/protocolo/compatibilidade/migraç\
ão e recursos de entrada para memória local, SQLite, gates e retenção mínima.\
\ Explicar anexos temporários, outputs entregues, migração explícita e recuperaç\
ão, pacote preparado e instalação adiada. Remover instruções que apresentem arquivos\
\ de Works como fonte principal nova ou Git como exigência. Preservar orientaç\
ões dos dois ciclos, OODA, DEC/Plan e aprovações."
acceptanceCriteria:
- "Documentação e recursos distribuídos descrevem o mesmo contrato e permitem inicializar/retomar\
\ um projeto sem Git."
- "Procedimento público de migração explica prévia, efeitos e recuperação sem depender\
\ de inspeção do código interno."
- "Limites de retenção e instalação, papel dos gates e recortes futuros estão claros;\
\ fontes e exemplos não alegam testes ou migrações reais não executados."
dependsOn:
- "TSK-0010"
- "TSK-0011"
- "TSK-0012"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:45.331995Z"
- id: "TSK-0014"
title: "Executar regressão integrada e encaminhar responsividade ao WRK-000C"
description: "Integrar as verificações das etapas e executar gates apropriados de\
\ testes/arquitetura, migração, concorrência e smoke JVM/nativo em ambientes descartá\
veis. Revisar continuidade e autoridade nos dois ciclos, anexos temporários, recuperaç\
ão e funcionamento sem Git. Consolidar resultados mínimos, resolver experimentos/preocupaç\
ões e entregar cenário reproduzível ao WRK-000C com comandos, versão, dados e\
\ ambiente. Não instalar o pacote nem declarar resolvido o atraso."
acceptanceCriteria:
- "Suíte relevante de domínio/integração/compatibilidade, fixtures do instalador\
\ e smoke nativo passam ou impedimentos são tratados antes da conclusão."
- "Falhas, rollback, concorrência, legado, gates e descarte legítimo foram verificados\
\ com resultados reais e sem alteração da instalação ativa ou consumidores."
- "Todos os steps e critérios da DEC estão satisfeitos, sem experimentos/preocupaç\
ões pendentes; WRK-000C recebe cenário para medição futura e permanece aberto."
dependsOn:
- "TSK-0013"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:53.421052Z"
status: "ACTIVE"
author: "Codex"
createdAt: "2026-11-22T11:52:06.993736Z"
revision: 35
previousHash: "9ab0a0a63415c87df7fb8b7fae4fa1141190fe125e322d423e4f8e4b0c2b02f6"
updatedAt: "2026-11-22T13:16:14.087901Z"
updatedBy: "Codex"
changeReason: "32 cenários distintos focados passaram em duas rodadas."
experiments:
- id: "EXP-0001"
stepId: "TSK-0002"
hypothesis: "SQLite JDBC pode criar, persistir e reabrir uma base em processos JVM\
\ e Native Image com biblioteca distribuída ao lado do executável."
successCriterion: "As duas formas executam create/read/write/reopen e rollback em\
\ diretório descartável; o nativo usa a biblioteca do pacote com extração temporá\
ria indisponível; nenhum binário ativo ou consumidor é alterado."
invocation: "./gradlew sqliteProbeClasses nativeSqliteProbeCompile; scripts/sqlite-probe.sh\
\ <build>; execução da classe de prova JVM e do binário de build em processos\
\ distintos"
retryOf: null
reconsideration: null
by: "Codex"
createdAt: "2026-11-22T12:10:00.110720Z"
outcome: "CONFIRMED"
observation: "JVM criou e reabriu a base com UTF-8 e rollback. Native Image GraalVM\
\ 25 criou e reabriu em processos independentes com biblioteca externa e extraç\
ão sem escrita; a cópia isolada sem biblioteca falhou."
interpretation: "Driver SQLite JDBC 3.54.1.0 e biblioteca distribuída ao lado do\
\ nativo funcionam na plataforma macOS arm64. Seleção inicial de JDK foi corrigida\
\ explicitamente; sem instalação real."
nextAction: "Implementar infraestrutura transacional e esquema local no TSK-0003."
evidence:
- "ART-0002"
questionsDecision: null
finishedAt: "2026-11-22T12:16:43.109268Z"
finishedBy: "Codex"
- id: "EXP-0002"
stepId: "TSK-0008"
hypothesis: "Anexos temporarios podem ser descartados apos a conclusao sem perder\
\ resultados historicos ou aceitar entradas ausentes em novos checks."
successCriterion: "Fixtures confirmam retencao durante checks, limpeza apos commit,\
\ rollback sem apagar entradas, recuperacao de descarte interrompido e recusa\
\ de evidencia perdida ou aposentada em avaliacao atual."
invocation: "./gradlew test --tests *SqliteArtifactLifecycleTest --tests *SqliteCoordinationTest\
\ --tests *SqliteQualityGatesTest"
retryOf: null
reconsideration: null
by: "Codex"
createdAt: "2026-11-22T13:12:55.720771Z"
outcome: "CONFIRMED"
observation: "Fixtures passaram retenção durante checks, descarte após commit, rollback\
\ e recuperação de interrupções; entrada perdida ou aposentada não satisfaz avaliaç\
ão atual."
interpretation: "Resultado estruturado e estado de descarte permitem retenção mí\
nima sem enfraquecer entradas obrigatórias. Originais legados preservados."
nextAction: "Integrar consultas, verificação e compatibilidade ao backend SQLite\
\ no TSK-0009."
evidence:
- "ART-0008"
questionsDecision: null
finishedAt: "2026-11-22T13:16:14.087721Z"
finishedBy: "Codex"
documentVersion: 2
---
# Implementar memória de engenharia local em SQLite
## Autoridade e objetivo
Executar a DEC-0001 do WRK-000D, aceita explicitamente por Nilton nesta conversa.
O resultado é um framework local de memória de engenharia por Work, com SQLite
por projeto, investigação e implementação orientadas por OODA, gates preservados,
anexos temporários e retenção mínima. A aprovação desta DEC mantém a instalação
real adiada.
Este Plan foi solicitado com decomposição em vários steps. Todos os steps começam
OPEN; a criação do Plan não constitui execução ou comprovação de resultado.
## Limites obrigatórios
- Não instalar nem substituir o AIE, SQLite, bibliotecas ou atalhos em uso.
- Não executar o instalador real contra HOME, ~/.local/bin ou outro destino ativo.
Sua validação usa fixtures com ferramentas simuladas e destinos descartáveis.
- Não migrar este workspace canônico ou projetos consumidores. Exercitar o novo
backend e a migração em fixtures e cópias descartáveis; ativação real depende de
instrução humana posterior específica.
- Preservar alterações preexistentes, IDs, conteúdo e proveniência legada,
aprovações, evidências históricas e instruções do projeto fora do bloco gerido.
- Não introduzir arquivos em BLOB/base64 ou TEXT equivalente, retenção extensa,
executor autônomo de repositório, colaboração distribuída ou integração Git LFS.
- Importação/exportação de Works/DECs e backup como funcionalidade ficam fora.
A cópia de segurança da migração é parte da recuperação da conversão.
- Código e outputs solicitados permanecem nos destinos de entrega apropriados.
- O WRK-000C permanece aberto para avaliar e tratar latência após esta mudança.
## Execução e dependências
Os 14 steps possuem dependências explícitas e critérios próprios. Mapear primeiro
o contrato e o legado; provar a integração SQLite/JVM/Native Image; depois construir
as transações e migrar os fluxos de domínio. Integrar gates e ciclo dos anexos antes
de consolidar as consultas, a migração pública e o bootstrap. Preparar distribuição
e documentação e concluir com regressão integrada e encaminhamento ao WRK-000C.
Não iniciar um step com dependências pendentes. Verificações focadas fazem parte
de cada mudança; a última etapa integra os cenários e não substitui essas verificações.
Steps independentes podem ser executados em ordem compatível, sem presumir
autorização de delegação ou de instalação real.
## OODA e incertezas
Nas provas relevantes, principalmente driver/nativo, migração e descarte de anexos,
registrar hipótese, critério de sucesso e invocação antes de executar. Registrar
observação, interpretação e próxima ação após o resultado; reconsiderar antes de
repetir uma hipótese falha. Usar os registros de experimentos do Plan quando úteis,
sem impor um ritual de quatro fases a toda alteração.
Ajustar esquema, índices, transações e build dentro da DEC. Se um resultado
questionar a decisão, registrar a preocupação, continuar investigações autorizadas
e rever a DEC com aprovação aplicável antes da execução afetada.
## Verificação e registro mínimo
Durante a execução deste Work, respeitar o protocolo que está em uso. Registrar
resultados reais e evidência mínima necessária para completar os steps; não usar
a futura política de limpeza para apagar evidências legadas ou simular gates.
Verificar continuidade entre processos, integridade referencial, rollback,
concorrência local com espera limitada, autoridade humana, gates e anexos
temporários, migração repetível e operação sem Git. Provas nativas usam somente
artefatos de build e projetos descartáveis.
Comandos candidatos à validação, ajustados ao resultado e ao código final:
- `./gradlew test` e `./gradlew check` para a suíte e arquitetura do projeto.
- `python3 scripts/test-install-native.py` para fixtures do instalador.
- `./gradlew nativeCompile` e tarefas de distribuição para construir o pacote.
- `bash scripts/native-smoke.sh <caminho-absoluto-do-build>` em projetos descartáveis.
Esses comandos são planejados, não executados na criação do Plan. Preservar os
gates específicos do projeto e adicionais do Work definidos na execução. Logs de
trabalho podem ser temporários; guardar na memória somente o necessário ao contrato.
## Conclusão
Todos os steps obrigatórios devem satisfazer seus critérios, com a DEC aceita e
sem experimentos ou preocupações pendentes. A entrega é código, documentação,
pacote preparado e resultados de verificação. Não depende de instalar a nova
versão no ambiente em uso. Encaminhar ao WRK-000C um cenário reproduzível com
comandos, versão, volume e ambiente, sem declarar resolvido o problema de atraso.
@@ -0,0 +1,480 @@
---
schemaVersion: 1
id: "PLN-0001"
workId: "WRK-000D"
title: "Implementar memória de engenharia local em SQLite sem instalação ativa"
decisions:
- "DEC-0001"
steps:
- id: "TSK-0001"
title: "Mapear contrato, dados legados e cenários de migração"
description: "Inspecionar WorkService, serviços de Discussion/Decision/Plan/Agent,\
\ coordenadores e VerificationService. Mapear registros, referências, revisões,\
\ hashes, recibos e bootstrap para tabelas e regras do backend SQLite, preservando\
\ conteúdo e autoridade. Selecionar fixtures existentes de compatibilidade, workflows\
\ e importação como corpus; usar apenas cópias descartáveis. Identificar checks\
\ e pontos de retenção sem realizar benchmark conclusivo do WRK-000C."
acceptanceCriteria:
- "Mapeamento cobre entidades persistidas, IDs locais ao Work, referências, revisõ\
es, aprovações e casos de conclusão legada com hashes/recibos."
- "Corpus representativo e resultados esperados de continuidade/migração estão definidos\
\ antes da conversão, incluindo dados inválidos e estados interrompidos."
- "Limites de instalação, migração de consumidores e preservação do workspace atual\
\ estão explícitos e respeitados."
dependsOn: []
status: "COMPLETED"
result: "Contrato e legado mapeados em docs/sqlite-migration-design.md; corpus e\
\ casos de falha/retry definidos antes da migração. Baseline: 45 testes em seis\
\ classes passaram, hashes congelados conferidos e fontes históricas intactas.\
\ Sem instalação ou migração real."
evidence:
- "ART-0001"
updatedAt: "2026-11-22T12:00:26.700050Z"
- id: "TSK-0002"
title: "Provar driver SQLite em JVM e Native Image"
description: "Avaliar Xerial SQLite JDBC e fixar versão compatível com Java, Gradle\
\ e GraalVM do projeto. Registrar hipótese, critério e invocação antes da prova.\
\ Criar, gravar, ler e reabrir uma base descartável em processos JVM e nativos.\
\ Verificar carregamento da biblioteca distribuída ao lado do nativo; sqlite3\
\ será ferramenta de diagnóstico do pacote. Construir e executar somente artefatos\
\ descartáveis, sem instalação real."
acceptanceCriteria:
- "Driver e versão selecionados demonstram persistência e reabertura em JVM e Native\
\ Image na plataforma alvo."
- "Biblioteca do pacote é encontrada por caminho controlado e não depende acidentalmente\
\ do SQLite global ou de extração repetida não planejada."
- "Hipótese, resultado e limitações da prova estão registrados; instalação ativa\
\ e projetos consumidores não foram alterados."
dependsOn:
- "TSK-0001"
status: "COMPLETED"
result: "Prova JVM e Native Image passou create/read/write/reopen, UTF-8, rollback\
\ e dependência da biblioteca do pacote; sem instalação ativa."
evidence:
- "ART-0002"
updatedAt: "2026-11-22T12:16:52.149066Z"
- id: "TSK-0003"
title: "Implementar esquema, conexões e transações SQLite"
description: "Criar infraestrutura de persistência local em .ai-engineering/aie.db\
\ com esquema versionado, tabelas tipadas, índices e relações. Habilitar integridade\
\ referencial em cada conexão, delimitar unidade transacional por operação coerente\
\ e usar leitura consistente. Definir journal/durabilidade e espera limitada de\
\ escrita com diagnóstico. Preservar limites de módulos; serviços aninhados devem\
\ compartilhar a transação aplicável."
acceptanceCriteria:
- "Esquema e índices atendem ao mapeamento sem BLOB/base64 ou arquivos completos\
\ serializados em TEXT."
- "Falha em operação relacionada causa rollback; referências inválidas são recusadas\
\ e gravações concorrentes têm contenção limitada e diagnóstico útil."
- "Abertura de esquema incompatível é diagnosticada sem alterar dados; teste de\
\ leitura consistente cobre mudanças concorrentes locais."
dependsOn:
- "TSK-0001"
- "TSK-0002"
status: "COMPLETED"
result: "Infraestrutura SQLite validada: 12 testes de transação/integridade/concorrê\
ncia e arquitetura passaram; schema também criado e reaberto pelo Native Image.\
\ CLI de domínio e instalação ativa continuam intactos."
evidence:
- "ART-0003"
updatedAt: "2026-11-22T12:26:10.846492Z"
- id: "TSK-0004"
title: "Persistir Works e investigação no novo backend"
description: "Integrar Work, guidance e histórico de escolhas, discussões, tópicos,\
\ surveys, respostas e disposições à unidade de persistência. Preservar IDs existentes,\
\ semântica dos IDs locais, referências e histórico útil. Consultas selecionadas\
\ devem buscar o Work diretamente. Manter leitura legada delimitada para compatibilidade\
\ e migração; não manter duas fontes autoritativas para a mesma memória."
acceptanceCriteria:
- "Criar e retomar Work/discussão/survey em outro processo preserva conteúdo, histó\
rico de respostas e pendências."
- "Escolhas DIRECT/EXPLORATORY e autoridade humana mantêm as regras existentes,\
\ inclusive ausência de escolha e pedido específico de DEC."
- "Busca por Work e suas referências usa consultas com escopo adequado; alteraçõ\
es e referências relacionadas são transacionais."
dependsOn:
- "TSK-0003"
status: "COMPLETED"
result: "Works/investigação SQLite passaram 45 testes e retomada em outro JVM e\
\ nativo; referências transacionais, histórico e autoridade preservados."
evidence:
- "ART-0004"
updatedAt: "2026-11-22T12:43:38.166159Z"
- id: "TSK-0005"
title: "Persistir decisões, planos e experimentos"
description: "Integrar DecisionService e PlanService com revisões, aceitação, supersessã\
o, passos, dependências e experimentos. Preservar os dois ciclos e OODA, a autoridade\
\ de DEC/Plan e a distinção entre aprovação humana e promoção permitida por polí\
tica. Tratar operações que alteram registros relacionados em uma transação, sem\
\ reduzir os checks de domínio."
acceptanceCriteria:
- "Aprovação, revisão e supersessão preservam autoria e referências, sem fabricaç\
ão de aprovação ou edição silenciosa de decisão aceita."
- "Dependências e estados de passos, critérios de experimentos, preocupações com\
\ DEC e replanejamento conservam os bloqueios existentes."
- "Interrupção simulada não publica meia supersessão ou promoção parcial; retomada\
\ em outro processo preserva o contexto."
dependsOn:
- "TSK-0004"
status: "COMPLETED"
result: "Decisões/Plans/experimentos SQLite preservam autoridade, revisão, dependê\
ncias e rollback conjunto; 34 cenários distintos selecionados passaram ao final\
\ após ajuste textual de um teste."
evidence:
- "ART-0005"
updatedAt: "2026-11-22T12:54:10.341537Z"
- id: "TSK-0006"
title: "Integrar execuções de agentes e coordenação de EPICs"
description: "Persistir RUNs e seus dados operacionais mínimos, idempotência de\
\ requestId, referências aplicadas e diagnóstico. Integrar PlanCoordinator/EpicCoordinator,\
\ políticas e proveniência de conclusão, representando recibos internos como dados\
\ estruturados quando aplicável. Preservar a fronteira do adaptador: propostas\
\ não aprovam DEC, não respondem pelo humano nem executam comandos de repositó\
rio."
acceptanceCriteria:
- "Repetição idempotente de uma solicitação concluída não duplica registros; solicitaç\
ões divergentes e estados interrompidos são diagnosticados."
- "Políticas RESULTS/DECOMPOSITION, delegação, reabertura, propagação e conclusã\
o por Plans preservam autoridade e proveniência."
- "Resultados estruturados necessários permanecem; transporte bruto, ambiente e\
\ logs completos não viram acervo permanente no banco."
dependsOn:
- "TSK-0005"
status: "COMPLETED"
result: "RUNs/EPICs persistidos e coordenação preservada; 30 cenários distintos\
\ passaram, incluindo rollback integral e idempotência."
evidence:
- "ART-0006"
updatedAt: "2026-11-22T13:02:08.858215Z"
- id: "TSK-0007"
title: "Integrar gates do projeto e adicionais por Work"
description: "Representar gates obrigatórios do projeto e complementos do Work e\
\ conectar seus resultados aos checks e à entrega. Preservar avaliação externa\
\ e condições de qualidade, inclusive anexos exigidos. Registrar identificaçã\
o, procedimento/execução, estado avaliado, momento e resultado mínimo. Alteraç\
ões pertinentes invalidam a aplicação do resultado aos gates afetados; aprovaç\
ão humana não equivale a sucesso técnico."
acceptanceCriteria:
- "Gate obrigatório pendente, falho ou não executado bloqueia a entrega; gates adicionais\
\ do Work são considerados sem dispensar obrigatórios do projeto."
- "Resultados correspondem ao estado realmente avaliado e não satisfazem silenciosamente\
\ um gate após mudança relevante."
- "Checks existentes e anexos necessários continuam exigidos durante avaliação,\
\ sem introduzir executor autônomo ou retenção bruta obrigatória."
dependsOn:
- "TSK-0005"
- "TSK-0006"
status: "COMPLETED"
result: "Gates cumulativos bloqueiam entrega sem PASS atual; snapshots históricos\
\ preservados. 23 cenários focados passaram."
evidence:
- "ART-0007"
updatedAt: "2026-11-22T13:08:08.952170Z"
- id: "TSK-0008"
title: "Implementar anexos temporários e descarte após checks"
description: "Definir ciclo de vida de anexos e arquivos de execução no filesystem.\
\ Publicar arquivos completos, validar e registrar resultados mínimos antes do\
\ descarte; limpar elegíveis ao fim da execução. Proteger anexos ainda usados\
\ por checks pendentes e outputs solicitados. Recuperar falhas entre publicaçã\
o de arquivo, transação no banco e limpeza, distinguindo descarte legítimo de\
\ perda prematura. Não descartar artefatos legados deste workspace."
acceptanceCriteria:
- "Arquivos exigidos permanecem acessíveis até todos os checks dependentes terminarem,\
\ com resultado persistido antes da remoção."
- "Descarte automático preserva outputs solicitados e memória histórica; arquivo\
\ perdido antes da avaliação continua causando falha."
- "Interrupções nos pontos de publicação, registro e limpeza não fabricam sucesso\
\ e permitem recuperação sem remoção de entradas ainda necessárias."
dependsOn:
- "TSK-0007"
status: "COMPLETED"
result: "Anexos temporários e recibos tipados integrados; EXP-0002 confirmado e\
\ 32 cenários distintos passaram."
evidence:
- "ART-0008"
updatedAt: "2026-11-22T13:16:27.036583Z"
- id: "TSK-0009"
title: "Adaptar verificação, status e contexto ao SQLite"
description: "Integrar VerificationService, CompatibilityService e projeções da\
\ CLI ao backend. Montar status, next-actions, context e readiness com consultas\
\ necessárias e resultados reutilizados na invocação; preservar contrato público\
\ quando compatível e informar mudanças. Separar resultado histórico com anexo\
\ descartado legitimamente de validação ativa. Manter diagnóstico de reparo e\
\ ausência de transições de estado em consultas."
acceptanceCriteria:
- "Consultas e contexto em processos novos preservam informações e autoridade e\
\ não promovem, migram ou concluem registros por leitura."
- "Anexos descartados legitimamente não invalidam histórico; corrupção e referê\
ncias ausentes não são tratadas como gates satisfeitos."
- "Caminhos selecionados não repetem varreduras/validações globais sem necessidade;\
\ saída e códigos de erro compatíveis são verificados."
dependsOn:
- "TSK-0004"
- "TSK-0005"
- "TSK-0006"
- "TSK-0008"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:13.390096Z"
- id: "TSK-0010"
title: "Implementar migração explícita e recuperável do legado"
description: "Criar comando público de prévia e aplicação da migração, sem conversã\
o em leituras ou atualização do instalador. Usar base de preparo e cópia de seguranç\
a da conversão, importação tipada transacional e verificação contra o corpus.\
\ Preservar IDs, conteúdo, aprovações, hashes, revisões e proveniência histórica\
\ sem despejar arquivos no banco. Ativar somente após sucesso; repetir ou recuperar\
\ interrupção sem duplicar. Executar apenas em fixtures/cópias descartáveis."
acceptanceCriteria:
- "Prévia não modifica o projeto; aplicação compara registros/contexto e ativa a\
\ base somente após validação completa."
- "Fixtures históricas, recibos, aprovações e referências preservam identidade/proveniê\
ncia; execução repetida não duplica conteúdo."
- "Falhas e interrupções deixam a fonte anterior recuperável e informam próxima\
\ ação; nenhum projeto real ou workspace canônico foi migrado."
dependsOn:
- "TSK-0001"
- "TSK-0009"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:21.074969Z"
- id: "TSK-0011"
title: "Atualizar init, descoberta e contrato de compatibilidade"
description: "Inicializar projetos locais em SQLite e deixar .ai-engineering ignorado\
\ pelo Git por padrão sem exigir Git. Preservar regras preexistentes e instruç\
ões fora do bloco gerido. Declarar backend e versões no contrato público, atualizar\
\ diagnóstico/onboard e evitar que base SQLite seja interpretada como workspace\
\ vazio por combinação incompatível. Manter tratamento explícito de projetos legados\
\ e previamente rastreados."
acceptanceCriteria:
- "Init cria projeto funcional sem Git, com estado local ignorado por padrão e bootstrap\
\ suficiente para humanos e agentes."
- "Reexecução preserva conteúdo/regras; não remove arquivos já rastreados nem converte\
\ legado automaticamente."
- "Versões e backend incompatíveis são recusados com diagnóstico acionável antes\
\ de escrita; documentação/entrypoints não induzem uso de CLI incompatível."
dependsOn:
- "TSK-0009"
- "TSK-0010"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:28.841960Z"
- id: "TSK-0012"
title: "Preparar pacote nativo e instalador conjunto sem ativação"
description: "Evoluir build/distribuição e scripts/install-native.sh para empacotar\
\ AIE nativo, biblioteca SQLite do driver e CLI sqlite3 num diretório configurá\
vel, com atalhos aie/ai-engineering e dados de projeto separados. Fixar componentes/plataformas\
\ e verificar pacote antes de ativação, preservando versão anterior em falhas.\
\ Testar instalador com ferramentas simuladas e destinos descartáveis; smoke usa\
\ build local. Não executar instalação real nem tocar ~/.local/bin ou dependê\
ncias ativas."
acceptanceCriteria:
- "Pacote contém componentes corretos e o build nativo acessa uma base descartá\
vel sem depender da instalação global."
- "Fixtures verificam diretórios configuráveis, atalhos, atualização conjunta e\
\ falha sem danificar instalação anterior simulada."
- "Nenhum binário, biblioteca ou atalho ativo é substituído e o instalador real\
\ não é executado; a ativação posterior continua dependente de instrução humana."
dependsOn:
- "TSK-0002"
- "TSK-0011"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:37.290314Z"
- id: "TSK-0013"
title: "Consolidar documentação e instruções do framework local"
description: "Atualizar README, docs de arquitetura/protocolo/compatibilidade/migraç\
ão e recursos de entrada para memória local, SQLite, gates e retenção mínima.\
\ Explicar anexos temporários, outputs entregues, migração explícita e recuperaç\
ão, pacote preparado e instalação adiada. Remover instruções que apresentem arquivos\
\ de Works como fonte principal nova ou Git como exigência. Preservar orientaç\
ões dos dois ciclos, OODA, DEC/Plan e aprovações."
acceptanceCriteria:
- "Documentação e recursos distribuídos descrevem o mesmo contrato e permitem inicializar/retomar\
\ um projeto sem Git."
- "Procedimento público de migração explica prévia, efeitos e recuperação sem depender\
\ de inspeção do código interno."
- "Limites de retenção e instalação, papel dos gates e recortes futuros estão claros;\
\ fontes e exemplos não alegam testes ou migrações reais não executados."
dependsOn:
- "TSK-0010"
- "TSK-0011"
- "TSK-0012"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:45.331995Z"
- id: "TSK-0014"
title: "Executar regressão integrada e encaminhar responsividade ao WRK-000C"
description: "Integrar as verificações das etapas e executar gates apropriados de\
\ testes/arquitetura, migração, concorrência e smoke JVM/nativo em ambientes descartá\
veis. Revisar continuidade e autoridade nos dois ciclos, anexos temporários, recuperaç\
ão e funcionamento sem Git. Consolidar resultados mínimos, resolver experimentos/preocupaç\
ões e entregar cenário reproduzível ao WRK-000C com comandos, versão, dados e\
\ ambiente. Não instalar o pacote nem declarar resolvido o atraso."
acceptanceCriteria:
- "Suíte relevante de domínio/integração/compatibilidade, fixtures do instalador\
\ e smoke nativo passam ou impedimentos são tratados antes da conclusão."
- "Falhas, rollback, concorrência, legado, gates e descarte legítimo foram verificados\
\ com resultados reais e sem alteração da instalação ativa ou consumidores."
- "Todos os steps e critérios da DEC estão satisfeitos, sem experimentos/preocupaç\
ões pendentes; WRK-000C recebe cenário para medição futura e permanece aberto."
dependsOn:
- "TSK-0013"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:53.421052Z"
status: "ACTIVE"
author: "Codex"
createdAt: "2026-11-22T11:52:06.993736Z"
revision: 36
previousHash: "b5b137e36f548e3e2b3e79c51f317f8b6d34a86637de3c9fb459d9589ecaddac"
updatedAt: "2026-11-22T13:16:27.036779Z"
updatedBy: "Codex"
changeReason: "Anexos temporários e recibos tipados integrados; EXP-0002 confirmado\
\ e 32 cenários distintos passaram."
experiments:
- id: "EXP-0001"
stepId: "TSK-0002"
hypothesis: "SQLite JDBC pode criar, persistir e reabrir uma base em processos JVM\
\ e Native Image com biblioteca distribuída ao lado do executável."
successCriterion: "As duas formas executam create/read/write/reopen e rollback em\
\ diretório descartável; o nativo usa a biblioteca do pacote com extração temporá\
ria indisponível; nenhum binário ativo ou consumidor é alterado."
invocation: "./gradlew sqliteProbeClasses nativeSqliteProbeCompile; scripts/sqlite-probe.sh\
\ <build>; execução da classe de prova JVM e do binário de build em processos\
\ distintos"
retryOf: null
reconsideration: null
by: "Codex"
createdAt: "2026-11-22T12:10:00.110720Z"
outcome: "CONFIRMED"
observation: "JVM criou e reabriu a base com UTF-8 e rollback. Native Image GraalVM\
\ 25 criou e reabriu em processos independentes com biblioteca externa e extraç\
ão sem escrita; a cópia isolada sem biblioteca falhou."
interpretation: "Driver SQLite JDBC 3.54.1.0 e biblioteca distribuída ao lado do\
\ nativo funcionam na plataforma macOS arm64. Seleção inicial de JDK foi corrigida\
\ explicitamente; sem instalação real."
nextAction: "Implementar infraestrutura transacional e esquema local no TSK-0003."
evidence:
- "ART-0002"
questionsDecision: null
finishedAt: "2026-11-22T12:16:43.109268Z"
finishedBy: "Codex"
- id: "EXP-0002"
stepId: "TSK-0008"
hypothesis: "Anexos temporarios podem ser descartados apos a conclusao sem perder\
\ resultados historicos ou aceitar entradas ausentes em novos checks."
successCriterion: "Fixtures confirmam retencao durante checks, limpeza apos commit,\
\ rollback sem apagar entradas, recuperacao de descarte interrompido e recusa\
\ de evidencia perdida ou aposentada em avaliacao atual."
invocation: "./gradlew test --tests *SqliteArtifactLifecycleTest --tests *SqliteCoordinationTest\
\ --tests *SqliteQualityGatesTest"
retryOf: null
reconsideration: null
by: "Codex"
createdAt: "2026-11-22T13:12:55.720771Z"
outcome: "CONFIRMED"
observation: "Fixtures passaram retenção durante checks, descarte após commit, rollback\
\ e recuperação de interrupções; entrada perdida ou aposentada não satisfaz avaliaç\
ão atual."
interpretation: "Resultado estruturado e estado de descarte permitem retenção mí\
nima sem enfraquecer entradas obrigatórias. Originais legados preservados."
nextAction: "Integrar consultas, verificação e compatibilidade ao backend SQLite\
\ no TSK-0009."
evidence:
- "ART-0008"
questionsDecision: null
finishedAt: "2026-11-22T13:16:14.087721Z"
finishedBy: "Codex"
documentVersion: 2
---
# Implementar memória de engenharia local em SQLite
## Autoridade e objetivo
Executar a DEC-0001 do WRK-000D, aceita explicitamente por Nilton nesta conversa.
O resultado é um framework local de memória de engenharia por Work, com SQLite
por projeto, investigação e implementação orientadas por OODA, gates preservados,
anexos temporários e retenção mínima. A aprovação desta DEC mantém a instalação
real adiada.
Este Plan foi solicitado com decomposição em vários steps. Todos os steps começam
OPEN; a criação do Plan não constitui execução ou comprovação de resultado.
## Limites obrigatórios
- Não instalar nem substituir o AIE, SQLite, bibliotecas ou atalhos em uso.
- Não executar o instalador real contra HOME, ~/.local/bin ou outro destino ativo.
Sua validação usa fixtures com ferramentas simuladas e destinos descartáveis.
- Não migrar este workspace canônico ou projetos consumidores. Exercitar o novo
backend e a migração em fixtures e cópias descartáveis; ativação real depende de
instrução humana posterior específica.
- Preservar alterações preexistentes, IDs, conteúdo e proveniência legada,
aprovações, evidências históricas e instruções do projeto fora do bloco gerido.
- Não introduzir arquivos em BLOB/base64 ou TEXT equivalente, retenção extensa,
executor autônomo de repositório, colaboração distribuída ou integração Git LFS.
- Importação/exportação de Works/DECs e backup como funcionalidade ficam fora.
A cópia de segurança da migração é parte da recuperação da conversão.
- Código e outputs solicitados permanecem nos destinos de entrega apropriados.
- O WRK-000C permanece aberto para avaliar e tratar latência após esta mudança.
## Execução e dependências
Os 14 steps possuem dependências explícitas e critérios próprios. Mapear primeiro
o contrato e o legado; provar a integração SQLite/JVM/Native Image; depois construir
as transações e migrar os fluxos de domínio. Integrar gates e ciclo dos anexos antes
de consolidar as consultas, a migração pública e o bootstrap. Preparar distribuição
e documentação e concluir com regressão integrada e encaminhamento ao WRK-000C.
Não iniciar um step com dependências pendentes. Verificações focadas fazem parte
de cada mudança; a última etapa integra os cenários e não substitui essas verificações.
Steps independentes podem ser executados em ordem compatível, sem presumir
autorização de delegação ou de instalação real.
## OODA e incertezas
Nas provas relevantes, principalmente driver/nativo, migração e descarte de anexos,
registrar hipótese, critério de sucesso e invocação antes de executar. Registrar
observação, interpretação e próxima ação após o resultado; reconsiderar antes de
repetir uma hipótese falha. Usar os registros de experimentos do Plan quando úteis,
sem impor um ritual de quatro fases a toda alteração.
Ajustar esquema, índices, transações e build dentro da DEC. Se um resultado
questionar a decisão, registrar a preocupação, continuar investigações autorizadas
e rever a DEC com aprovação aplicável antes da execução afetada.
## Verificação e registro mínimo
Durante a execução deste Work, respeitar o protocolo que está em uso. Registrar
resultados reais e evidência mínima necessária para completar os steps; não usar
a futura política de limpeza para apagar evidências legadas ou simular gates.
Verificar continuidade entre processos, integridade referencial, rollback,
concorrência local com espera limitada, autoridade humana, gates e anexos
temporários, migração repetível e operação sem Git. Provas nativas usam somente
artefatos de build e projetos descartáveis.
Comandos candidatos à validação, ajustados ao resultado e ao código final:
- `./gradlew test` e `./gradlew check` para a suíte e arquitetura do projeto.
- `python3 scripts/test-install-native.py` para fixtures do instalador.
- `./gradlew nativeCompile` e tarefas de distribuição para construir o pacote.
- `bash scripts/native-smoke.sh <caminho-absoluto-do-build>` em projetos descartáveis.
Esses comandos são planejados, não executados na criação do Plan. Preservar os
gates específicos do projeto e adicionais do Work definidos na execução. Logs de
trabalho podem ser temporários; guardar na memória somente o necessário ao contrato.
## Conclusão
Todos os steps obrigatórios devem satisfazer seus critérios, com a DEC aceita e
sem experimentos ou preocupações pendentes. A entrega é código, documentação,
pacote preparado e resultados de verificação. Não depende de instalar a nova
versão no ambiente em uso. Encaminhar ao WRK-000C um cenário reproduzível com
comandos, versão, volume e ambiente, sem declarar resolvido o problema de atraso.
@@ -0,0 +1,481 @@
---
schemaVersion: 1
id: "PLN-0001"
workId: "WRK-000D"
title: "Implementar memória de engenharia local em SQLite sem instalação ativa"
decisions:
- "DEC-0001"
steps:
- id: "TSK-0001"
title: "Mapear contrato, dados legados e cenários de migração"
description: "Inspecionar WorkService, serviços de Discussion/Decision/Plan/Agent,\
\ coordenadores e VerificationService. Mapear registros, referências, revisões,\
\ hashes, recibos e bootstrap para tabelas e regras do backend SQLite, preservando\
\ conteúdo e autoridade. Selecionar fixtures existentes de compatibilidade, workflows\
\ e importação como corpus; usar apenas cópias descartáveis. Identificar checks\
\ e pontos de retenção sem realizar benchmark conclusivo do WRK-000C."
acceptanceCriteria:
- "Mapeamento cobre entidades persistidas, IDs locais ao Work, referências, revisõ\
es, aprovações e casos de conclusão legada com hashes/recibos."
- "Corpus representativo e resultados esperados de continuidade/migração estão definidos\
\ antes da conversão, incluindo dados inválidos e estados interrompidos."
- "Limites de instalação, migração de consumidores e preservação do workspace atual\
\ estão explícitos e respeitados."
dependsOn: []
status: "COMPLETED"
result: "Contrato e legado mapeados em docs/sqlite-migration-design.md; corpus e\
\ casos de falha/retry definidos antes da migração. Baseline: 45 testes em seis\
\ classes passaram, hashes congelados conferidos e fontes históricas intactas.\
\ Sem instalação ou migração real."
evidence:
- "ART-0001"
updatedAt: "2026-11-22T12:00:26.700050Z"
- id: "TSK-0002"
title: "Provar driver SQLite em JVM e Native Image"
description: "Avaliar Xerial SQLite JDBC e fixar versão compatível com Java, Gradle\
\ e GraalVM do projeto. Registrar hipótese, critério e invocação antes da prova.\
\ Criar, gravar, ler e reabrir uma base descartável em processos JVM e nativos.\
\ Verificar carregamento da biblioteca distribuída ao lado do nativo; sqlite3\
\ será ferramenta de diagnóstico do pacote. Construir e executar somente artefatos\
\ descartáveis, sem instalação real."
acceptanceCriteria:
- "Driver e versão selecionados demonstram persistência e reabertura em JVM e Native\
\ Image na plataforma alvo."
- "Biblioteca do pacote é encontrada por caminho controlado e não depende acidentalmente\
\ do SQLite global ou de extração repetida não planejada."
- "Hipótese, resultado e limitações da prova estão registrados; instalação ativa\
\ e projetos consumidores não foram alterados."
dependsOn:
- "TSK-0001"
status: "COMPLETED"
result: "Prova JVM e Native Image passou create/read/write/reopen, UTF-8, rollback\
\ e dependência da biblioteca do pacote; sem instalação ativa."
evidence:
- "ART-0002"
updatedAt: "2026-11-22T12:16:52.149066Z"
- id: "TSK-0003"
title: "Implementar esquema, conexões e transações SQLite"
description: "Criar infraestrutura de persistência local em .ai-engineering/aie.db\
\ com esquema versionado, tabelas tipadas, índices e relações. Habilitar integridade\
\ referencial em cada conexão, delimitar unidade transacional por operação coerente\
\ e usar leitura consistente. Definir journal/durabilidade e espera limitada de\
\ escrita com diagnóstico. Preservar limites de módulos; serviços aninhados devem\
\ compartilhar a transação aplicável."
acceptanceCriteria:
- "Esquema e índices atendem ao mapeamento sem BLOB/base64 ou arquivos completos\
\ serializados em TEXT."
- "Falha em operação relacionada causa rollback; referências inválidas são recusadas\
\ e gravações concorrentes têm contenção limitada e diagnóstico útil."
- "Abertura de esquema incompatível é diagnosticada sem alterar dados; teste de\
\ leitura consistente cobre mudanças concorrentes locais."
dependsOn:
- "TSK-0001"
- "TSK-0002"
status: "COMPLETED"
result: "Infraestrutura SQLite validada: 12 testes de transação/integridade/concorrê\
ncia e arquitetura passaram; schema também criado e reaberto pelo Native Image.\
\ CLI de domínio e instalação ativa continuam intactos."
evidence:
- "ART-0003"
updatedAt: "2026-11-22T12:26:10.846492Z"
- id: "TSK-0004"
title: "Persistir Works e investigação no novo backend"
description: "Integrar Work, guidance e histórico de escolhas, discussões, tópicos,\
\ surveys, respostas e disposições à unidade de persistência. Preservar IDs existentes,\
\ semântica dos IDs locais, referências e histórico útil. Consultas selecionadas\
\ devem buscar o Work diretamente. Manter leitura legada delimitada para compatibilidade\
\ e migração; não manter duas fontes autoritativas para a mesma memória."
acceptanceCriteria:
- "Criar e retomar Work/discussão/survey em outro processo preserva conteúdo, histó\
rico de respostas e pendências."
- "Escolhas DIRECT/EXPLORATORY e autoridade humana mantêm as regras existentes,\
\ inclusive ausência de escolha e pedido específico de DEC."
- "Busca por Work e suas referências usa consultas com escopo adequado; alteraçõ\
es e referências relacionadas são transacionais."
dependsOn:
- "TSK-0003"
status: "COMPLETED"
result: "Works/investigação SQLite passaram 45 testes e retomada em outro JVM e\
\ nativo; referências transacionais, histórico e autoridade preservados."
evidence:
- "ART-0004"
updatedAt: "2026-11-22T12:43:38.166159Z"
- id: "TSK-0005"
title: "Persistir decisões, planos e experimentos"
description: "Integrar DecisionService e PlanService com revisões, aceitação, supersessã\
o, passos, dependências e experimentos. Preservar os dois ciclos e OODA, a autoridade\
\ de DEC/Plan e a distinção entre aprovação humana e promoção permitida por polí\
tica. Tratar operações que alteram registros relacionados em uma transação, sem\
\ reduzir os checks de domínio."
acceptanceCriteria:
- "Aprovação, revisão e supersessão preservam autoria e referências, sem fabricaç\
ão de aprovação ou edição silenciosa de decisão aceita."
- "Dependências e estados de passos, critérios de experimentos, preocupações com\
\ DEC e replanejamento conservam os bloqueios existentes."
- "Interrupção simulada não publica meia supersessão ou promoção parcial; retomada\
\ em outro processo preserva o contexto."
dependsOn:
- "TSK-0004"
status: "COMPLETED"
result: "Decisões/Plans/experimentos SQLite preservam autoridade, revisão, dependê\
ncias e rollback conjunto; 34 cenários distintos selecionados passaram ao final\
\ após ajuste textual de um teste."
evidence:
- "ART-0005"
updatedAt: "2026-11-22T12:54:10.341537Z"
- id: "TSK-0006"
title: "Integrar execuções de agentes e coordenação de EPICs"
description: "Persistir RUNs e seus dados operacionais mínimos, idempotência de\
\ requestId, referências aplicadas e diagnóstico. Integrar PlanCoordinator/EpicCoordinator,\
\ políticas e proveniência de conclusão, representando recibos internos como dados\
\ estruturados quando aplicável. Preservar a fronteira do adaptador: propostas\
\ não aprovam DEC, não respondem pelo humano nem executam comandos de repositó\
rio."
acceptanceCriteria:
- "Repetição idempotente de uma solicitação concluída não duplica registros; solicitaç\
ões divergentes e estados interrompidos são diagnosticados."
- "Políticas RESULTS/DECOMPOSITION, delegação, reabertura, propagação e conclusã\
o por Plans preservam autoridade e proveniência."
- "Resultados estruturados necessários permanecem; transporte bruto, ambiente e\
\ logs completos não viram acervo permanente no banco."
dependsOn:
- "TSK-0005"
status: "COMPLETED"
result: "RUNs/EPICs persistidos e coordenação preservada; 30 cenários distintos\
\ passaram, incluindo rollback integral e idempotência."
evidence:
- "ART-0006"
updatedAt: "2026-11-22T13:02:08.858215Z"
- id: "TSK-0007"
title: "Integrar gates do projeto e adicionais por Work"
description: "Representar gates obrigatórios do projeto e complementos do Work e\
\ conectar seus resultados aos checks e à entrega. Preservar avaliação externa\
\ e condições de qualidade, inclusive anexos exigidos. Registrar identificaçã\
o, procedimento/execução, estado avaliado, momento e resultado mínimo. Alteraç\
ões pertinentes invalidam a aplicação do resultado aos gates afetados; aprovaç\
ão humana não equivale a sucesso técnico."
acceptanceCriteria:
- "Gate obrigatório pendente, falho ou não executado bloqueia a entrega; gates adicionais\
\ do Work são considerados sem dispensar obrigatórios do projeto."
- "Resultados correspondem ao estado realmente avaliado e não satisfazem silenciosamente\
\ um gate após mudança relevante."
- "Checks existentes e anexos necessários continuam exigidos durante avaliação,\
\ sem introduzir executor autônomo ou retenção bruta obrigatória."
dependsOn:
- "TSK-0005"
- "TSK-0006"
status: "COMPLETED"
result: "Gates cumulativos bloqueiam entrega sem PASS atual; snapshots históricos\
\ preservados. 23 cenários focados passaram."
evidence:
- "ART-0007"
updatedAt: "2026-11-22T13:08:08.952170Z"
- id: "TSK-0008"
title: "Implementar anexos temporários e descarte após checks"
description: "Definir ciclo de vida de anexos e arquivos de execução no filesystem.\
\ Publicar arquivos completos, validar e registrar resultados mínimos antes do\
\ descarte; limpar elegíveis ao fim da execução. Proteger anexos ainda usados\
\ por checks pendentes e outputs solicitados. Recuperar falhas entre publicaçã\
o de arquivo, transação no banco e limpeza, distinguindo descarte legítimo de\
\ perda prematura. Não descartar artefatos legados deste workspace."
acceptanceCriteria:
- "Arquivos exigidos permanecem acessíveis até todos os checks dependentes terminarem,\
\ com resultado persistido antes da remoção."
- "Descarte automático preserva outputs solicitados e memória histórica; arquivo\
\ perdido antes da avaliação continua causando falha."
- "Interrupções nos pontos de publicação, registro e limpeza não fabricam sucesso\
\ e permitem recuperação sem remoção de entradas ainda necessárias."
dependsOn:
- "TSK-0007"
status: "COMPLETED"
result: "Anexos temporários e recibos tipados integrados; EXP-0002 confirmado e\
\ 32 cenários distintos passaram."
evidence:
- "ART-0008"
updatedAt: "2026-11-22T13:16:27.036583Z"
- id: "TSK-0009"
title: "Adaptar verificação, status e contexto ao SQLite"
description: "Integrar VerificationService, CompatibilityService e projeções da\
\ CLI ao backend. Montar status, next-actions, context e readiness com consultas\
\ necessárias e resultados reutilizados na invocação; preservar contrato público\
\ quando compatível e informar mudanças. Separar resultado histórico com anexo\
\ descartado legitimamente de validação ativa. Manter diagnóstico de reparo e\
\ ausência de transições de estado em consultas."
acceptanceCriteria:
- "Consultas e contexto em processos novos preservam informações e autoridade e\
\ não promovem, migram ou concluem registros por leitura."
- "Anexos descartados legitimamente não invalidam histórico; corrupção e referê\
ncias ausentes não são tratadas como gates satisfeitos."
- "Caminhos selecionados não repetem varreduras/validações globais sem necessidade;\
\ saída e códigos de erro compatíveis são verificados."
dependsOn:
- "TSK-0004"
- "TSK-0005"
- "TSK-0006"
- "TSK-0008"
status: "ACTIVE"
result: "Adaptar consultas, contexto, status e diagnóstico de integridade ao SQLite\
\ sem varredura global para ler um Work."
evidence: []
updatedAt: "2026-11-22T13:16:40.765836Z"
- id: "TSK-0010"
title: "Implementar migração explícita e recuperável do legado"
description: "Criar comando público de prévia e aplicação da migração, sem conversã\
o em leituras ou atualização do instalador. Usar base de preparo e cópia de seguranç\
a da conversão, importação tipada transacional e verificação contra o corpus.\
\ Preservar IDs, conteúdo, aprovações, hashes, revisões e proveniência histórica\
\ sem despejar arquivos no banco. Ativar somente após sucesso; repetir ou recuperar\
\ interrupção sem duplicar. Executar apenas em fixtures/cópias descartáveis."
acceptanceCriteria:
- "Prévia não modifica o projeto; aplicação compara registros/contexto e ativa a\
\ base somente após validação completa."
- "Fixtures históricas, recibos, aprovações e referências preservam identidade/proveniê\
ncia; execução repetida não duplica conteúdo."
- "Falhas e interrupções deixam a fonte anterior recuperável e informam próxima\
\ ação; nenhum projeto real ou workspace canônico foi migrado."
dependsOn:
- "TSK-0001"
- "TSK-0009"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:21.074969Z"
- id: "TSK-0011"
title: "Atualizar init, descoberta e contrato de compatibilidade"
description: "Inicializar projetos locais em SQLite e deixar .ai-engineering ignorado\
\ pelo Git por padrão sem exigir Git. Preservar regras preexistentes e instruç\
ões fora do bloco gerido. Declarar backend e versões no contrato público, atualizar\
\ diagnóstico/onboard e evitar que base SQLite seja interpretada como workspace\
\ vazio por combinação incompatível. Manter tratamento explícito de projetos legados\
\ e previamente rastreados."
acceptanceCriteria:
- "Init cria projeto funcional sem Git, com estado local ignorado por padrão e bootstrap\
\ suficiente para humanos e agentes."
- "Reexecução preserva conteúdo/regras; não remove arquivos já rastreados nem converte\
\ legado automaticamente."
- "Versões e backend incompatíveis são recusados com diagnóstico acionável antes\
\ de escrita; documentação/entrypoints não induzem uso de CLI incompatível."
dependsOn:
- "TSK-0009"
- "TSK-0010"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:28.841960Z"
- id: "TSK-0012"
title: "Preparar pacote nativo e instalador conjunto sem ativação"
description: "Evoluir build/distribuição e scripts/install-native.sh para empacotar\
\ AIE nativo, biblioteca SQLite do driver e CLI sqlite3 num diretório configurá\
vel, com atalhos aie/ai-engineering e dados de projeto separados. Fixar componentes/plataformas\
\ e verificar pacote antes de ativação, preservando versão anterior em falhas.\
\ Testar instalador com ferramentas simuladas e destinos descartáveis; smoke usa\
\ build local. Não executar instalação real nem tocar ~/.local/bin ou dependê\
ncias ativas."
acceptanceCriteria:
- "Pacote contém componentes corretos e o build nativo acessa uma base descartá\
vel sem depender da instalação global."
- "Fixtures verificam diretórios configuráveis, atalhos, atualização conjunta e\
\ falha sem danificar instalação anterior simulada."
- "Nenhum binário, biblioteca ou atalho ativo é substituído e o instalador real\
\ não é executado; a ativação posterior continua dependente de instrução humana."
dependsOn:
- "TSK-0002"
- "TSK-0011"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:37.290314Z"
- id: "TSK-0013"
title: "Consolidar documentação e instruções do framework local"
description: "Atualizar README, docs de arquitetura/protocolo/compatibilidade/migraç\
ão e recursos de entrada para memória local, SQLite, gates e retenção mínima.\
\ Explicar anexos temporários, outputs entregues, migração explícita e recuperaç\
ão, pacote preparado e instalação adiada. Remover instruções que apresentem arquivos\
\ de Works como fonte principal nova ou Git como exigência. Preservar orientaç\
ões dos dois ciclos, OODA, DEC/Plan e aprovações."
acceptanceCriteria:
- "Documentação e recursos distribuídos descrevem o mesmo contrato e permitem inicializar/retomar\
\ um projeto sem Git."
- "Procedimento público de migração explica prévia, efeitos e recuperação sem depender\
\ de inspeção do código interno."
- "Limites de retenção e instalação, papel dos gates e recortes futuros estão claros;\
\ fontes e exemplos não alegam testes ou migrações reais não executados."
dependsOn:
- "TSK-0010"
- "TSK-0011"
- "TSK-0012"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:45.331995Z"
- id: "TSK-0014"
title: "Executar regressão integrada e encaminhar responsividade ao WRK-000C"
description: "Integrar as verificações das etapas e executar gates apropriados de\
\ testes/arquitetura, migração, concorrência e smoke JVM/nativo em ambientes descartá\
veis. Revisar continuidade e autoridade nos dois ciclos, anexos temporários, recuperaç\
ão e funcionamento sem Git. Consolidar resultados mínimos, resolver experimentos/preocupaç\
ões e entregar cenário reproduzível ao WRK-000C com comandos, versão, dados e\
\ ambiente. Não instalar o pacote nem declarar resolvido o atraso."
acceptanceCriteria:
- "Suíte relevante de domínio/integração/compatibilidade, fixtures do instalador\
\ e smoke nativo passam ou impedimentos são tratados antes da conclusão."
- "Falhas, rollback, concorrência, legado, gates e descarte legítimo foram verificados\
\ com resultados reais e sem alteração da instalação ativa ou consumidores."
- "Todos os steps e critérios da DEC estão satisfeitos, sem experimentos/preocupaç\
ões pendentes; WRK-000C recebe cenário para medição futura e permanece aberto."
dependsOn:
- "TSK-0013"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:53.421052Z"
status: "ACTIVE"
author: "Codex"
createdAt: "2026-11-22T11:52:06.993736Z"
revision: 37
previousHash: "80e71191e1c96555d747935774d05dbef8cdf58e405bb20281d8d2145e2546b4"
updatedAt: "2026-11-22T13:16:40.766019Z"
updatedBy: "Codex"
changeReason: "Adaptar consultas, contexto, status e diagnóstico de integridade ao\
\ SQLite sem varredura global para ler um Work."
experiments:
- id: "EXP-0001"
stepId: "TSK-0002"
hypothesis: "SQLite JDBC pode criar, persistir e reabrir uma base em processos JVM\
\ e Native Image com biblioteca distribuída ao lado do executável."
successCriterion: "As duas formas executam create/read/write/reopen e rollback em\
\ diretório descartável; o nativo usa a biblioteca do pacote com extração temporá\
ria indisponível; nenhum binário ativo ou consumidor é alterado."
invocation: "./gradlew sqliteProbeClasses nativeSqliteProbeCompile; scripts/sqlite-probe.sh\
\ <build>; execução da classe de prova JVM e do binário de build em processos\
\ distintos"
retryOf: null
reconsideration: null
by: "Codex"
createdAt: "2026-11-22T12:10:00.110720Z"
outcome: "CONFIRMED"
observation: "JVM criou e reabriu a base com UTF-8 e rollback. Native Image GraalVM\
\ 25 criou e reabriu em processos independentes com biblioteca externa e extraç\
ão sem escrita; a cópia isolada sem biblioteca falhou."
interpretation: "Driver SQLite JDBC 3.54.1.0 e biblioteca distribuída ao lado do\
\ nativo funcionam na plataforma macOS arm64. Seleção inicial de JDK foi corrigida\
\ explicitamente; sem instalação real."
nextAction: "Implementar infraestrutura transacional e esquema local no TSK-0003."
evidence:
- "ART-0002"
questionsDecision: null
finishedAt: "2026-11-22T12:16:43.109268Z"
finishedBy: "Codex"
- id: "EXP-0002"
stepId: "TSK-0008"
hypothesis: "Anexos temporarios podem ser descartados apos a conclusao sem perder\
\ resultados historicos ou aceitar entradas ausentes em novos checks."
successCriterion: "Fixtures confirmam retencao durante checks, limpeza apos commit,\
\ rollback sem apagar entradas, recuperacao de descarte interrompido e recusa\
\ de evidencia perdida ou aposentada em avaliacao atual."
invocation: "./gradlew test --tests *SqliteArtifactLifecycleTest --tests *SqliteCoordinationTest\
\ --tests *SqliteQualityGatesTest"
retryOf: null
reconsideration: null
by: "Codex"
createdAt: "2026-11-22T13:12:55.720771Z"
outcome: "CONFIRMED"
observation: "Fixtures passaram retenção durante checks, descarte após commit, rollback\
\ e recuperação de interrupções; entrada perdida ou aposentada não satisfaz avaliaç\
ão atual."
interpretation: "Resultado estruturado e estado de descarte permitem retenção mí\
nima sem enfraquecer entradas obrigatórias. Originais legados preservados."
nextAction: "Integrar consultas, verificação e compatibilidade ao backend SQLite\
\ no TSK-0009."
evidence:
- "ART-0008"
questionsDecision: null
finishedAt: "2026-11-22T13:16:14.087721Z"
finishedBy: "Codex"
documentVersion: 2
---
# Implementar memória de engenharia local em SQLite
## Autoridade e objetivo
Executar a DEC-0001 do WRK-000D, aceita explicitamente por Nilton nesta conversa.
O resultado é um framework local de memória de engenharia por Work, com SQLite
por projeto, investigação e implementação orientadas por OODA, gates preservados,
anexos temporários e retenção mínima. A aprovação desta DEC mantém a instalação
real adiada.
Este Plan foi solicitado com decomposição em vários steps. Todos os steps começam
OPEN; a criação do Plan não constitui execução ou comprovação de resultado.
## Limites obrigatórios
- Não instalar nem substituir o AIE, SQLite, bibliotecas ou atalhos em uso.
- Não executar o instalador real contra HOME, ~/.local/bin ou outro destino ativo.
Sua validação usa fixtures com ferramentas simuladas e destinos descartáveis.
- Não migrar este workspace canônico ou projetos consumidores. Exercitar o novo
backend e a migração em fixtures e cópias descartáveis; ativação real depende de
instrução humana posterior específica.
- Preservar alterações preexistentes, IDs, conteúdo e proveniência legada,
aprovações, evidências históricas e instruções do projeto fora do bloco gerido.
- Não introduzir arquivos em BLOB/base64 ou TEXT equivalente, retenção extensa,
executor autônomo de repositório, colaboração distribuída ou integração Git LFS.
- Importação/exportação de Works/DECs e backup como funcionalidade ficam fora.
A cópia de segurança da migração é parte da recuperação da conversão.
- Código e outputs solicitados permanecem nos destinos de entrega apropriados.
- O WRK-000C permanece aberto para avaliar e tratar latência após esta mudança.
## Execução e dependências
Os 14 steps possuem dependências explícitas e critérios próprios. Mapear primeiro
o contrato e o legado; provar a integração SQLite/JVM/Native Image; depois construir
as transações e migrar os fluxos de domínio. Integrar gates e ciclo dos anexos antes
de consolidar as consultas, a migração pública e o bootstrap. Preparar distribuição
e documentação e concluir com regressão integrada e encaminhamento ao WRK-000C.
Não iniciar um step com dependências pendentes. Verificações focadas fazem parte
de cada mudança; a última etapa integra os cenários e não substitui essas verificações.
Steps independentes podem ser executados em ordem compatível, sem presumir
autorização de delegação ou de instalação real.
## OODA e incertezas
Nas provas relevantes, principalmente driver/nativo, migração e descarte de anexos,
registrar hipótese, critério de sucesso e invocação antes de executar. Registrar
observação, interpretação e próxima ação após o resultado; reconsiderar antes de
repetir uma hipótese falha. Usar os registros de experimentos do Plan quando úteis,
sem impor um ritual de quatro fases a toda alteração.
Ajustar esquema, índices, transações e build dentro da DEC. Se um resultado
questionar a decisão, registrar a preocupação, continuar investigações autorizadas
e rever a DEC com aprovação aplicável antes da execução afetada.
## Verificação e registro mínimo
Durante a execução deste Work, respeitar o protocolo que está em uso. Registrar
resultados reais e evidência mínima necessária para completar os steps; não usar
a futura política de limpeza para apagar evidências legadas ou simular gates.
Verificar continuidade entre processos, integridade referencial, rollback,
concorrência local com espera limitada, autoridade humana, gates e anexos
temporários, migração repetível e operação sem Git. Provas nativas usam somente
artefatos de build e projetos descartáveis.
Comandos candidatos à validação, ajustados ao resultado e ao código final:
- `./gradlew test` e `./gradlew check` para a suíte e arquitetura do projeto.
- `python3 scripts/test-install-native.py` para fixtures do instalador.
- `./gradlew nativeCompile` e tarefas de distribuição para construir o pacote.
- `bash scripts/native-smoke.sh <caminho-absoluto-do-build>` em projetos descartáveis.
Esses comandos são planejados, não executados na criação do Plan. Preservar os
gates específicos do projeto e adicionais do Work definidos na execução. Logs de
trabalho podem ser temporários; guardar na memória somente o necessário ao contrato.
## Conclusão
Todos os steps obrigatórios devem satisfazer seus critérios, com a DEC aceita e
sem experimentos ou preocupações pendentes. A entrega é código, documentação,
pacote preparado e resultados de verificação. Não depende de instalar a nova
versão no ambiente em uso. Encaminhar ao WRK-000C um cenário reproduzível com
comandos, versão, volume e ambiente, sem declarar resolvido o problema de atraso.
@@ -0,0 +1,482 @@
---
schemaVersion: 1
id: "PLN-0001"
workId: "WRK-000D"
title: "Implementar memória de engenharia local em SQLite sem instalação ativa"
decisions:
- "DEC-0001"
steps:
- id: "TSK-0001"
title: "Mapear contrato, dados legados e cenários de migração"
description: "Inspecionar WorkService, serviços de Discussion/Decision/Plan/Agent,\
\ coordenadores e VerificationService. Mapear registros, referências, revisões,\
\ hashes, recibos e bootstrap para tabelas e regras do backend SQLite, preservando\
\ conteúdo e autoridade. Selecionar fixtures existentes de compatibilidade, workflows\
\ e importação como corpus; usar apenas cópias descartáveis. Identificar checks\
\ e pontos de retenção sem realizar benchmark conclusivo do WRK-000C."
acceptanceCriteria:
- "Mapeamento cobre entidades persistidas, IDs locais ao Work, referências, revisõ\
es, aprovações e casos de conclusão legada com hashes/recibos."
- "Corpus representativo e resultados esperados de continuidade/migração estão definidos\
\ antes da conversão, incluindo dados inválidos e estados interrompidos."
- "Limites de instalação, migração de consumidores e preservação do workspace atual\
\ estão explícitos e respeitados."
dependsOn: []
status: "COMPLETED"
result: "Contrato e legado mapeados em docs/sqlite-migration-design.md; corpus e\
\ casos de falha/retry definidos antes da migração. Baseline: 45 testes em seis\
\ classes passaram, hashes congelados conferidos e fontes históricas intactas.\
\ Sem instalação ou migração real."
evidence:
- "ART-0001"
updatedAt: "2026-11-22T12:00:26.700050Z"
- id: "TSK-0002"
title: "Provar driver SQLite em JVM e Native Image"
description: "Avaliar Xerial SQLite JDBC e fixar versão compatível com Java, Gradle\
\ e GraalVM do projeto. Registrar hipótese, critério e invocação antes da prova.\
\ Criar, gravar, ler e reabrir uma base descartável em processos JVM e nativos.\
\ Verificar carregamento da biblioteca distribuída ao lado do nativo; sqlite3\
\ será ferramenta de diagnóstico do pacote. Construir e executar somente artefatos\
\ descartáveis, sem instalação real."
acceptanceCriteria:
- "Driver e versão selecionados demonstram persistência e reabertura em JVM e Native\
\ Image na plataforma alvo."
- "Biblioteca do pacote é encontrada por caminho controlado e não depende acidentalmente\
\ do SQLite global ou de extração repetida não planejada."
- "Hipótese, resultado e limitações da prova estão registrados; instalação ativa\
\ e projetos consumidores não foram alterados."
dependsOn:
- "TSK-0001"
status: "COMPLETED"
result: "Prova JVM e Native Image passou create/read/write/reopen, UTF-8, rollback\
\ e dependência da biblioteca do pacote; sem instalação ativa."
evidence:
- "ART-0002"
updatedAt: "2026-11-22T12:16:52.149066Z"
- id: "TSK-0003"
title: "Implementar esquema, conexões e transações SQLite"
description: "Criar infraestrutura de persistência local em .ai-engineering/aie.db\
\ com esquema versionado, tabelas tipadas, índices e relações. Habilitar integridade\
\ referencial em cada conexão, delimitar unidade transacional por operação coerente\
\ e usar leitura consistente. Definir journal/durabilidade e espera limitada de\
\ escrita com diagnóstico. Preservar limites de módulos; serviços aninhados devem\
\ compartilhar a transação aplicável."
acceptanceCriteria:
- "Esquema e índices atendem ao mapeamento sem BLOB/base64 ou arquivos completos\
\ serializados em TEXT."
- "Falha em operação relacionada causa rollback; referências inválidas são recusadas\
\ e gravações concorrentes têm contenção limitada e diagnóstico útil."
- "Abertura de esquema incompatível é diagnosticada sem alterar dados; teste de\
\ leitura consistente cobre mudanças concorrentes locais."
dependsOn:
- "TSK-0001"
- "TSK-0002"
status: "COMPLETED"
result: "Infraestrutura SQLite validada: 12 testes de transação/integridade/concorrê\
ncia e arquitetura passaram; schema também criado e reaberto pelo Native Image.\
\ CLI de domínio e instalação ativa continuam intactos."
evidence:
- "ART-0003"
updatedAt: "2026-11-22T12:26:10.846492Z"
- id: "TSK-0004"
title: "Persistir Works e investigação no novo backend"
description: "Integrar Work, guidance e histórico de escolhas, discussões, tópicos,\
\ surveys, respostas e disposições à unidade de persistência. Preservar IDs existentes,\
\ semântica dos IDs locais, referências e histórico útil. Consultas selecionadas\
\ devem buscar o Work diretamente. Manter leitura legada delimitada para compatibilidade\
\ e migração; não manter duas fontes autoritativas para a mesma memória."
acceptanceCriteria:
- "Criar e retomar Work/discussão/survey em outro processo preserva conteúdo, histó\
rico de respostas e pendências."
- "Escolhas DIRECT/EXPLORATORY e autoridade humana mantêm as regras existentes,\
\ inclusive ausência de escolha e pedido específico de DEC."
- "Busca por Work e suas referências usa consultas com escopo adequado; alteraçõ\
es e referências relacionadas são transacionais."
dependsOn:
- "TSK-0003"
status: "COMPLETED"
result: "Works/investigação SQLite passaram 45 testes e retomada em outro JVM e\
\ nativo; referências transacionais, histórico e autoridade preservados."
evidence:
- "ART-0004"
updatedAt: "2026-11-22T12:43:38.166159Z"
- id: "TSK-0005"
title: "Persistir decisões, planos e experimentos"
description: "Integrar DecisionService e PlanService com revisões, aceitação, supersessã\
o, passos, dependências e experimentos. Preservar os dois ciclos e OODA, a autoridade\
\ de DEC/Plan e a distinção entre aprovação humana e promoção permitida por polí\
tica. Tratar operações que alteram registros relacionados em uma transação, sem\
\ reduzir os checks de domínio."
acceptanceCriteria:
- "Aprovação, revisão e supersessão preservam autoria e referências, sem fabricaç\
ão de aprovação ou edição silenciosa de decisão aceita."
- "Dependências e estados de passos, critérios de experimentos, preocupações com\
\ DEC e replanejamento conservam os bloqueios existentes."
- "Interrupção simulada não publica meia supersessão ou promoção parcial; retomada\
\ em outro processo preserva o contexto."
dependsOn:
- "TSK-0004"
status: "COMPLETED"
result: "Decisões/Plans/experimentos SQLite preservam autoridade, revisão, dependê\
ncias e rollback conjunto; 34 cenários distintos selecionados passaram ao final\
\ após ajuste textual de um teste."
evidence:
- "ART-0005"
updatedAt: "2026-11-22T12:54:10.341537Z"
- id: "TSK-0006"
title: "Integrar execuções de agentes e coordenação de EPICs"
description: "Persistir RUNs e seus dados operacionais mínimos, idempotência de\
\ requestId, referências aplicadas e diagnóstico. Integrar PlanCoordinator/EpicCoordinator,\
\ políticas e proveniência de conclusão, representando recibos internos como dados\
\ estruturados quando aplicável. Preservar a fronteira do adaptador: propostas\
\ não aprovam DEC, não respondem pelo humano nem executam comandos de repositó\
rio."
acceptanceCriteria:
- "Repetição idempotente de uma solicitação concluída não duplica registros; solicitaç\
ões divergentes e estados interrompidos são diagnosticados."
- "Políticas RESULTS/DECOMPOSITION, delegação, reabertura, propagação e conclusã\
o por Plans preservam autoridade e proveniência."
- "Resultados estruturados necessários permanecem; transporte bruto, ambiente e\
\ logs completos não viram acervo permanente no banco."
dependsOn:
- "TSK-0005"
status: "COMPLETED"
result: "RUNs/EPICs persistidos e coordenação preservada; 30 cenários distintos\
\ passaram, incluindo rollback integral e idempotência."
evidence:
- "ART-0006"
updatedAt: "2026-11-22T13:02:08.858215Z"
- id: "TSK-0007"
title: "Integrar gates do projeto e adicionais por Work"
description: "Representar gates obrigatórios do projeto e complementos do Work e\
\ conectar seus resultados aos checks e à entrega. Preservar avaliação externa\
\ e condições de qualidade, inclusive anexos exigidos. Registrar identificaçã\
o, procedimento/execução, estado avaliado, momento e resultado mínimo. Alteraç\
ões pertinentes invalidam a aplicação do resultado aos gates afetados; aprovaç\
ão humana não equivale a sucesso técnico."
acceptanceCriteria:
- "Gate obrigatório pendente, falho ou não executado bloqueia a entrega; gates adicionais\
\ do Work são considerados sem dispensar obrigatórios do projeto."
- "Resultados correspondem ao estado realmente avaliado e não satisfazem silenciosamente\
\ um gate após mudança relevante."
- "Checks existentes e anexos necessários continuam exigidos durante avaliação,\
\ sem introduzir executor autônomo ou retenção bruta obrigatória."
dependsOn:
- "TSK-0005"
- "TSK-0006"
status: "COMPLETED"
result: "Gates cumulativos bloqueiam entrega sem PASS atual; snapshots históricos\
\ preservados. 23 cenários focados passaram."
evidence:
- "ART-0007"
updatedAt: "2026-11-22T13:08:08.952170Z"
- id: "TSK-0008"
title: "Implementar anexos temporários e descarte após checks"
description: "Definir ciclo de vida de anexos e arquivos de execução no filesystem.\
\ Publicar arquivos completos, validar e registrar resultados mínimos antes do\
\ descarte; limpar elegíveis ao fim da execução. Proteger anexos ainda usados\
\ por checks pendentes e outputs solicitados. Recuperar falhas entre publicaçã\
o de arquivo, transação no banco e limpeza, distinguindo descarte legítimo de\
\ perda prematura. Não descartar artefatos legados deste workspace."
acceptanceCriteria:
- "Arquivos exigidos permanecem acessíveis até todos os checks dependentes terminarem,\
\ com resultado persistido antes da remoção."
- "Descarte automático preserva outputs solicitados e memória histórica; arquivo\
\ perdido antes da avaliação continua causando falha."
- "Interrupções nos pontos de publicação, registro e limpeza não fabricam sucesso\
\ e permitem recuperação sem remoção de entradas ainda necessárias."
dependsOn:
- "TSK-0007"
status: "COMPLETED"
result: "Anexos temporários e recibos tipados integrados; EXP-0002 confirmado e\
\ 32 cenários distintos passaram."
evidence:
- "ART-0008"
updatedAt: "2026-11-22T13:16:27.036583Z"
- id: "TSK-0009"
title: "Adaptar verificação, status e contexto ao SQLite"
description: "Integrar VerificationService, CompatibilityService e projeções da\
\ CLI ao backend. Montar status, next-actions, context e readiness com consultas\
\ necessárias e resultados reutilizados na invocação; preservar contrato público\
\ quando compatível e informar mudanças. Separar resultado histórico com anexo\
\ descartado legitimamente de validação ativa. Manter diagnóstico de reparo e\
\ ausência de transições de estado em consultas."
acceptanceCriteria:
- "Consultas e contexto em processos novos preservam informações e autoridade e\
\ não promovem, migram ou concluem registros por leitura."
- "Anexos descartados legitimamente não invalidam histórico; corrupção e referê\
ncias ausentes não são tratadas como gates satisfeitos."
- "Caminhos selecionados não repetem varreduras/validações globais sem necessidade;\
\ saída e códigos de erro compatíveis são verificados."
dependsOn:
- "TSK-0004"
- "TSK-0005"
- "TSK-0006"
- "TSK-0008"
status: "COMPLETED"
result: "Consultas e verificação usam SQLite e snapshots consistentes; 15 testes\
\ focados passaram e compatibilidade legada preservada."
evidence:
- "ART-0009"
updatedAt: "2026-11-22T13:23:23.962895Z"
- id: "TSK-0010"
title: "Implementar migração explícita e recuperável do legado"
description: "Criar comando público de prévia e aplicação da migração, sem conversã\
o em leituras ou atualização do instalador. Usar base de preparo e cópia de seguranç\
a da conversão, importação tipada transacional e verificação contra o corpus.\
\ Preservar IDs, conteúdo, aprovações, hashes, revisões e proveniência histórica\
\ sem despejar arquivos no banco. Ativar somente após sucesso; repetir ou recuperar\
\ interrupção sem duplicar. Executar apenas em fixtures/cópias descartáveis."
acceptanceCriteria:
- "Prévia não modifica o projeto; aplicação compara registros/contexto e ativa a\
\ base somente após validação completa."
- "Fixtures históricas, recibos, aprovações e referências preservam identidade/proveniê\
ncia; execução repetida não duplica conteúdo."
- "Falhas e interrupções deixam a fonte anterior recuperável e informam próxima\
\ ação; nenhum projeto real ou workspace canônico foi migrado."
dependsOn:
- "TSK-0001"
- "TSK-0009"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:21.074969Z"
- id: "TSK-0011"
title: "Atualizar init, descoberta e contrato de compatibilidade"
description: "Inicializar projetos locais em SQLite e deixar .ai-engineering ignorado\
\ pelo Git por padrão sem exigir Git. Preservar regras preexistentes e instruç\
ões fora do bloco gerido. Declarar backend e versões no contrato público, atualizar\
\ diagnóstico/onboard e evitar que base SQLite seja interpretada como workspace\
\ vazio por combinação incompatível. Manter tratamento explícito de projetos legados\
\ e previamente rastreados."
acceptanceCriteria:
- "Init cria projeto funcional sem Git, com estado local ignorado por padrão e bootstrap\
\ suficiente para humanos e agentes."
- "Reexecução preserva conteúdo/regras; não remove arquivos já rastreados nem converte\
\ legado automaticamente."
- "Versões e backend incompatíveis são recusados com diagnóstico acionável antes\
\ de escrita; documentação/entrypoints não induzem uso de CLI incompatível."
dependsOn:
- "TSK-0009"
- "TSK-0010"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:28.841960Z"
- id: "TSK-0012"
title: "Preparar pacote nativo e instalador conjunto sem ativação"
description: "Evoluir build/distribuição e scripts/install-native.sh para empacotar\
\ AIE nativo, biblioteca SQLite do driver e CLI sqlite3 num diretório configurá\
vel, com atalhos aie/ai-engineering e dados de projeto separados. Fixar componentes/plataformas\
\ e verificar pacote antes de ativação, preservando versão anterior em falhas.\
\ Testar instalador com ferramentas simuladas e destinos descartáveis; smoke usa\
\ build local. Não executar instalação real nem tocar ~/.local/bin ou dependê\
ncias ativas."
acceptanceCriteria:
- "Pacote contém componentes corretos e o build nativo acessa uma base descartá\
vel sem depender da instalação global."
- "Fixtures verificam diretórios configuráveis, atalhos, atualização conjunta e\
\ falha sem danificar instalação anterior simulada."
- "Nenhum binário, biblioteca ou atalho ativo é substituído e o instalador real\
\ não é executado; a ativação posterior continua dependente de instrução humana."
dependsOn:
- "TSK-0002"
- "TSK-0011"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:37.290314Z"
- id: "TSK-0013"
title: "Consolidar documentação e instruções do framework local"
description: "Atualizar README, docs de arquitetura/protocolo/compatibilidade/migraç\
ão e recursos de entrada para memória local, SQLite, gates e retenção mínima.\
\ Explicar anexos temporários, outputs entregues, migração explícita e recuperaç\
ão, pacote preparado e instalação adiada. Remover instruções que apresentem arquivos\
\ de Works como fonte principal nova ou Git como exigência. Preservar orientaç\
ões dos dois ciclos, OODA, DEC/Plan e aprovações."
acceptanceCriteria:
- "Documentação e recursos distribuídos descrevem o mesmo contrato e permitem inicializar/retomar\
\ um projeto sem Git."
- "Procedimento público de migração explica prévia, efeitos e recuperação sem depender\
\ de inspeção do código interno."
- "Limites de retenção e instalação, papel dos gates e recortes futuros estão claros;\
\ fontes e exemplos não alegam testes ou migrações reais não executados."
dependsOn:
- "TSK-0010"
- "TSK-0011"
- "TSK-0012"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:45.331995Z"
- id: "TSK-0014"
title: "Executar regressão integrada e encaminhar responsividade ao WRK-000C"
description: "Integrar as verificações das etapas e executar gates apropriados de\
\ testes/arquitetura, migração, concorrência e smoke JVM/nativo em ambientes descartá\
veis. Revisar continuidade e autoridade nos dois ciclos, anexos temporários, recuperaç\
ão e funcionamento sem Git. Consolidar resultados mínimos, resolver experimentos/preocupaç\
ões e entregar cenário reproduzível ao WRK-000C com comandos, versão, dados e\
\ ambiente. Não instalar o pacote nem declarar resolvido o atraso."
acceptanceCriteria:
- "Suíte relevante de domínio/integração/compatibilidade, fixtures do instalador\
\ e smoke nativo passam ou impedimentos são tratados antes da conclusão."
- "Falhas, rollback, concorrência, legado, gates e descarte legítimo foram verificados\
\ com resultados reais e sem alteração da instalação ativa ou consumidores."
- "Todos os steps e critérios da DEC estão satisfeitos, sem experimentos/preocupaç\
ões pendentes; WRK-000C recebe cenário para medição futura e permanece aberto."
dependsOn:
- "TSK-0013"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:53.421052Z"
status: "ACTIVE"
author: "Codex"
createdAt: "2026-11-22T11:52:06.993736Z"
revision: 38
previousHash: "21edbd058479e7846f79a7244342c0813c38ce52129ffb34174e0e828cdd6eac"
updatedAt: "2026-11-22T13:23:23.963086Z"
updatedBy: "Codex"
changeReason: "Consultas e verificação usam SQLite e snapshots consistentes; 15 testes\
\ focados passaram e compatibilidade legada preservada."
experiments:
- id: "EXP-0001"
stepId: "TSK-0002"
hypothesis: "SQLite JDBC pode criar, persistir e reabrir uma base em processos JVM\
\ e Native Image com biblioteca distribuída ao lado do executável."
successCriterion: "As duas formas executam create/read/write/reopen e rollback em\
\ diretório descartável; o nativo usa a biblioteca do pacote com extração temporá\
ria indisponível; nenhum binário ativo ou consumidor é alterado."
invocation: "./gradlew sqliteProbeClasses nativeSqliteProbeCompile; scripts/sqlite-probe.sh\
\ <build>; execução da classe de prova JVM e do binário de build em processos\
\ distintos"
retryOf: null
reconsideration: null
by: "Codex"
createdAt: "2026-11-22T12:10:00.110720Z"
outcome: "CONFIRMED"
observation: "JVM criou e reabriu a base com UTF-8 e rollback. Native Image GraalVM\
\ 25 criou e reabriu em processos independentes com biblioteca externa e extraç\
ão sem escrita; a cópia isolada sem biblioteca falhou."
interpretation: "Driver SQLite JDBC 3.54.1.0 e biblioteca distribuída ao lado do\
\ nativo funcionam na plataforma macOS arm64. Seleção inicial de JDK foi corrigida\
\ explicitamente; sem instalação real."
nextAction: "Implementar infraestrutura transacional e esquema local no TSK-0003."
evidence:
- "ART-0002"
questionsDecision: null
finishedAt: "2026-11-22T12:16:43.109268Z"
finishedBy: "Codex"
- id: "EXP-0002"
stepId: "TSK-0008"
hypothesis: "Anexos temporarios podem ser descartados apos a conclusao sem perder\
\ resultados historicos ou aceitar entradas ausentes em novos checks."
successCriterion: "Fixtures confirmam retencao durante checks, limpeza apos commit,\
\ rollback sem apagar entradas, recuperacao de descarte interrompido e recusa\
\ de evidencia perdida ou aposentada em avaliacao atual."
invocation: "./gradlew test --tests *SqliteArtifactLifecycleTest --tests *SqliteCoordinationTest\
\ --tests *SqliteQualityGatesTest"
retryOf: null
reconsideration: null
by: "Codex"
createdAt: "2026-11-22T13:12:55.720771Z"
outcome: "CONFIRMED"
observation: "Fixtures passaram retenção durante checks, descarte após commit, rollback\
\ e recuperação de interrupções; entrada perdida ou aposentada não satisfaz avaliaç\
ão atual."
interpretation: "Resultado estruturado e estado de descarte permitem retenção mí\
nima sem enfraquecer entradas obrigatórias. Originais legados preservados."
nextAction: "Integrar consultas, verificação e compatibilidade ao backend SQLite\
\ no TSK-0009."
evidence:
- "ART-0008"
questionsDecision: null
finishedAt: "2026-11-22T13:16:14.087721Z"
finishedBy: "Codex"
documentVersion: 2
---
# Implementar memória de engenharia local em SQLite
## Autoridade e objetivo
Executar a DEC-0001 do WRK-000D, aceita explicitamente por Nilton nesta conversa.
O resultado é um framework local de memória de engenharia por Work, com SQLite
por projeto, investigação e implementação orientadas por OODA, gates preservados,
anexos temporários e retenção mínima. A aprovação desta DEC mantém a instalação
real adiada.
Este Plan foi solicitado com decomposição em vários steps. Todos os steps começam
OPEN; a criação do Plan não constitui execução ou comprovação de resultado.
## Limites obrigatórios
- Não instalar nem substituir o AIE, SQLite, bibliotecas ou atalhos em uso.
- Não executar o instalador real contra HOME, ~/.local/bin ou outro destino ativo.
Sua validação usa fixtures com ferramentas simuladas e destinos descartáveis.
- Não migrar este workspace canônico ou projetos consumidores. Exercitar o novo
backend e a migração em fixtures e cópias descartáveis; ativação real depende de
instrução humana posterior específica.
- Preservar alterações preexistentes, IDs, conteúdo e proveniência legada,
aprovações, evidências históricas e instruções do projeto fora do bloco gerido.
- Não introduzir arquivos em BLOB/base64 ou TEXT equivalente, retenção extensa,
executor autônomo de repositório, colaboração distribuída ou integração Git LFS.
- Importação/exportação de Works/DECs e backup como funcionalidade ficam fora.
A cópia de segurança da migração é parte da recuperação da conversão.
- Código e outputs solicitados permanecem nos destinos de entrega apropriados.
- O WRK-000C permanece aberto para avaliar e tratar latência após esta mudança.
## Execução e dependências
Os 14 steps possuem dependências explícitas e critérios próprios. Mapear primeiro
o contrato e o legado; provar a integração SQLite/JVM/Native Image; depois construir
as transações e migrar os fluxos de domínio. Integrar gates e ciclo dos anexos antes
de consolidar as consultas, a migração pública e o bootstrap. Preparar distribuição
e documentação e concluir com regressão integrada e encaminhamento ao WRK-000C.
Não iniciar um step com dependências pendentes. Verificações focadas fazem parte
de cada mudança; a última etapa integra os cenários e não substitui essas verificações.
Steps independentes podem ser executados em ordem compatível, sem presumir
autorização de delegação ou de instalação real.
## OODA e incertezas
Nas provas relevantes, principalmente driver/nativo, migração e descarte de anexos,
registrar hipótese, critério de sucesso e invocação antes de executar. Registrar
observação, interpretação e próxima ação após o resultado; reconsiderar antes de
repetir uma hipótese falha. Usar os registros de experimentos do Plan quando úteis,
sem impor um ritual de quatro fases a toda alteração.
Ajustar esquema, índices, transações e build dentro da DEC. Se um resultado
questionar a decisão, registrar a preocupação, continuar investigações autorizadas
e rever a DEC com aprovação aplicável antes da execução afetada.
## Verificação e registro mínimo
Durante a execução deste Work, respeitar o protocolo que está em uso. Registrar
resultados reais e evidência mínima necessária para completar os steps; não usar
a futura política de limpeza para apagar evidências legadas ou simular gates.
Verificar continuidade entre processos, integridade referencial, rollback,
concorrência local com espera limitada, autoridade humana, gates e anexos
temporários, migração repetível e operação sem Git. Provas nativas usam somente
artefatos de build e projetos descartáveis.
Comandos candidatos à validação, ajustados ao resultado e ao código final:
- `./gradlew test` e `./gradlew check` para a suíte e arquitetura do projeto.
- `python3 scripts/test-install-native.py` para fixtures do instalador.
- `./gradlew nativeCompile` e tarefas de distribuição para construir o pacote.
- `bash scripts/native-smoke.sh <caminho-absoluto-do-build>` em projetos descartáveis.
Esses comandos são planejados, não executados na criação do Plan. Preservar os
gates específicos do projeto e adicionais do Work definidos na execução. Logs de
trabalho podem ser temporários; guardar na memória somente o necessário ao contrato.
## Conclusão
Todos os steps obrigatórios devem satisfazer seus critérios, com a DEC aceita e
sem experimentos ou preocupações pendentes. A entrega é código, documentação,
pacote preparado e resultados de verificação. Não depende de instalar a nova
versão no ambiente em uso. Encaminhar ao WRK-000C um cenário reproduzível com
comandos, versão, volume e ambiente, sem declarar resolvido o problema de atraso.
@@ -0,0 +1,483 @@
---
schemaVersion: 1
id: "PLN-0001"
workId: "WRK-000D"
title: "Implementar memória de engenharia local em SQLite sem instalação ativa"
decisions:
- "DEC-0001"
steps:
- id: "TSK-0001"
title: "Mapear contrato, dados legados e cenários de migração"
description: "Inspecionar WorkService, serviços de Discussion/Decision/Plan/Agent,\
\ coordenadores e VerificationService. Mapear registros, referências, revisões,\
\ hashes, recibos e bootstrap para tabelas e regras do backend SQLite, preservando\
\ conteúdo e autoridade. Selecionar fixtures existentes de compatibilidade, workflows\
\ e importação como corpus; usar apenas cópias descartáveis. Identificar checks\
\ e pontos de retenção sem realizar benchmark conclusivo do WRK-000C."
acceptanceCriteria:
- "Mapeamento cobre entidades persistidas, IDs locais ao Work, referências, revisõ\
es, aprovações e casos de conclusão legada com hashes/recibos."
- "Corpus representativo e resultados esperados de continuidade/migração estão definidos\
\ antes da conversão, incluindo dados inválidos e estados interrompidos."
- "Limites de instalação, migração de consumidores e preservação do workspace atual\
\ estão explícitos e respeitados."
dependsOn: []
status: "COMPLETED"
result: "Contrato e legado mapeados em docs/sqlite-migration-design.md; corpus e\
\ casos de falha/retry definidos antes da migração. Baseline: 45 testes em seis\
\ classes passaram, hashes congelados conferidos e fontes históricas intactas.\
\ Sem instalação ou migração real."
evidence:
- "ART-0001"
updatedAt: "2026-11-22T12:00:26.700050Z"
- id: "TSK-0002"
title: "Provar driver SQLite em JVM e Native Image"
description: "Avaliar Xerial SQLite JDBC e fixar versão compatível com Java, Gradle\
\ e GraalVM do projeto. Registrar hipótese, critério e invocação antes da prova.\
\ Criar, gravar, ler e reabrir uma base descartável em processos JVM e nativos.\
\ Verificar carregamento da biblioteca distribuída ao lado do nativo; sqlite3\
\ será ferramenta de diagnóstico do pacote. Construir e executar somente artefatos\
\ descartáveis, sem instalação real."
acceptanceCriteria:
- "Driver e versão selecionados demonstram persistência e reabertura em JVM e Native\
\ Image na plataforma alvo."
- "Biblioteca do pacote é encontrada por caminho controlado e não depende acidentalmente\
\ do SQLite global ou de extração repetida não planejada."
- "Hipótese, resultado e limitações da prova estão registrados; instalação ativa\
\ e projetos consumidores não foram alterados."
dependsOn:
- "TSK-0001"
status: "COMPLETED"
result: "Prova JVM e Native Image passou create/read/write/reopen, UTF-8, rollback\
\ e dependência da biblioteca do pacote; sem instalação ativa."
evidence:
- "ART-0002"
updatedAt: "2026-11-22T12:16:52.149066Z"
- id: "TSK-0003"
title: "Implementar esquema, conexões e transações SQLite"
description: "Criar infraestrutura de persistência local em .ai-engineering/aie.db\
\ com esquema versionado, tabelas tipadas, índices e relações. Habilitar integridade\
\ referencial em cada conexão, delimitar unidade transacional por operação coerente\
\ e usar leitura consistente. Definir journal/durabilidade e espera limitada de\
\ escrita com diagnóstico. Preservar limites de módulos; serviços aninhados devem\
\ compartilhar a transação aplicável."
acceptanceCriteria:
- "Esquema e índices atendem ao mapeamento sem BLOB/base64 ou arquivos completos\
\ serializados em TEXT."
- "Falha em operação relacionada causa rollback; referências inválidas são recusadas\
\ e gravações concorrentes têm contenção limitada e diagnóstico útil."
- "Abertura de esquema incompatível é diagnosticada sem alterar dados; teste de\
\ leitura consistente cobre mudanças concorrentes locais."
dependsOn:
- "TSK-0001"
- "TSK-0002"
status: "COMPLETED"
result: "Infraestrutura SQLite validada: 12 testes de transação/integridade/concorrê\
ncia e arquitetura passaram; schema também criado e reaberto pelo Native Image.\
\ CLI de domínio e instalação ativa continuam intactos."
evidence:
- "ART-0003"
updatedAt: "2026-11-22T12:26:10.846492Z"
- id: "TSK-0004"
title: "Persistir Works e investigação no novo backend"
description: "Integrar Work, guidance e histórico de escolhas, discussões, tópicos,\
\ surveys, respostas e disposições à unidade de persistência. Preservar IDs existentes,\
\ semântica dos IDs locais, referências e histórico útil. Consultas selecionadas\
\ devem buscar o Work diretamente. Manter leitura legada delimitada para compatibilidade\
\ e migração; não manter duas fontes autoritativas para a mesma memória."
acceptanceCriteria:
- "Criar e retomar Work/discussão/survey em outro processo preserva conteúdo, histó\
rico de respostas e pendências."
- "Escolhas DIRECT/EXPLORATORY e autoridade humana mantêm as regras existentes,\
\ inclusive ausência de escolha e pedido específico de DEC."
- "Busca por Work e suas referências usa consultas com escopo adequado; alteraçõ\
es e referências relacionadas são transacionais."
dependsOn:
- "TSK-0003"
status: "COMPLETED"
result: "Works/investigação SQLite passaram 45 testes e retomada em outro JVM e\
\ nativo; referências transacionais, histórico e autoridade preservados."
evidence:
- "ART-0004"
updatedAt: "2026-11-22T12:43:38.166159Z"
- id: "TSK-0005"
title: "Persistir decisões, planos e experimentos"
description: "Integrar DecisionService e PlanService com revisões, aceitação, supersessã\
o, passos, dependências e experimentos. Preservar os dois ciclos e OODA, a autoridade\
\ de DEC/Plan e a distinção entre aprovação humana e promoção permitida por polí\
tica. Tratar operações que alteram registros relacionados em uma transação, sem\
\ reduzir os checks de domínio."
acceptanceCriteria:
- "Aprovação, revisão e supersessão preservam autoria e referências, sem fabricaç\
ão de aprovação ou edição silenciosa de decisão aceita."
- "Dependências e estados de passos, critérios de experimentos, preocupações com\
\ DEC e replanejamento conservam os bloqueios existentes."
- "Interrupção simulada não publica meia supersessão ou promoção parcial; retomada\
\ em outro processo preserva o contexto."
dependsOn:
- "TSK-0004"
status: "COMPLETED"
result: "Decisões/Plans/experimentos SQLite preservam autoridade, revisão, dependê\
ncias e rollback conjunto; 34 cenários distintos selecionados passaram ao final\
\ após ajuste textual de um teste."
evidence:
- "ART-0005"
updatedAt: "2026-11-22T12:54:10.341537Z"
- id: "TSK-0006"
title: "Integrar execuções de agentes e coordenação de EPICs"
description: "Persistir RUNs e seus dados operacionais mínimos, idempotência de\
\ requestId, referências aplicadas e diagnóstico. Integrar PlanCoordinator/EpicCoordinator,\
\ políticas e proveniência de conclusão, representando recibos internos como dados\
\ estruturados quando aplicável. Preservar a fronteira do adaptador: propostas\
\ não aprovam DEC, não respondem pelo humano nem executam comandos de repositó\
rio."
acceptanceCriteria:
- "Repetição idempotente de uma solicitação concluída não duplica registros; solicitaç\
ões divergentes e estados interrompidos são diagnosticados."
- "Políticas RESULTS/DECOMPOSITION, delegação, reabertura, propagação e conclusã\
o por Plans preservam autoridade e proveniência."
- "Resultados estruturados necessários permanecem; transporte bruto, ambiente e\
\ logs completos não viram acervo permanente no banco."
dependsOn:
- "TSK-0005"
status: "COMPLETED"
result: "RUNs/EPICs persistidos e coordenação preservada; 30 cenários distintos\
\ passaram, incluindo rollback integral e idempotência."
evidence:
- "ART-0006"
updatedAt: "2026-11-22T13:02:08.858215Z"
- id: "TSK-0007"
title: "Integrar gates do projeto e adicionais por Work"
description: "Representar gates obrigatórios do projeto e complementos do Work e\
\ conectar seus resultados aos checks e à entrega. Preservar avaliação externa\
\ e condições de qualidade, inclusive anexos exigidos. Registrar identificaçã\
o, procedimento/execução, estado avaliado, momento e resultado mínimo. Alteraç\
ões pertinentes invalidam a aplicação do resultado aos gates afetados; aprovaç\
ão humana não equivale a sucesso técnico."
acceptanceCriteria:
- "Gate obrigatório pendente, falho ou não executado bloqueia a entrega; gates adicionais\
\ do Work são considerados sem dispensar obrigatórios do projeto."
- "Resultados correspondem ao estado realmente avaliado e não satisfazem silenciosamente\
\ um gate após mudança relevante."
- "Checks existentes e anexos necessários continuam exigidos durante avaliação,\
\ sem introduzir executor autônomo ou retenção bruta obrigatória."
dependsOn:
- "TSK-0005"
- "TSK-0006"
status: "COMPLETED"
result: "Gates cumulativos bloqueiam entrega sem PASS atual; snapshots históricos\
\ preservados. 23 cenários focados passaram."
evidence:
- "ART-0007"
updatedAt: "2026-11-22T13:08:08.952170Z"
- id: "TSK-0008"
title: "Implementar anexos temporários e descarte após checks"
description: "Definir ciclo de vida de anexos e arquivos de execução no filesystem.\
\ Publicar arquivos completos, validar e registrar resultados mínimos antes do\
\ descarte; limpar elegíveis ao fim da execução. Proteger anexos ainda usados\
\ por checks pendentes e outputs solicitados. Recuperar falhas entre publicaçã\
o de arquivo, transação no banco e limpeza, distinguindo descarte legítimo de\
\ perda prematura. Não descartar artefatos legados deste workspace."
acceptanceCriteria:
- "Arquivos exigidos permanecem acessíveis até todos os checks dependentes terminarem,\
\ com resultado persistido antes da remoção."
- "Descarte automático preserva outputs solicitados e memória histórica; arquivo\
\ perdido antes da avaliação continua causando falha."
- "Interrupções nos pontos de publicação, registro e limpeza não fabricam sucesso\
\ e permitem recuperação sem remoção de entradas ainda necessárias."
dependsOn:
- "TSK-0007"
status: "COMPLETED"
result: "Anexos temporários e recibos tipados integrados; EXP-0002 confirmado e\
\ 32 cenários distintos passaram."
evidence:
- "ART-0008"
updatedAt: "2026-11-22T13:16:27.036583Z"
- id: "TSK-0009"
title: "Adaptar verificação, status e contexto ao SQLite"
description: "Integrar VerificationService, CompatibilityService e projeções da\
\ CLI ao backend. Montar status, next-actions, context e readiness com consultas\
\ necessárias e resultados reutilizados na invocação; preservar contrato público\
\ quando compatível e informar mudanças. Separar resultado histórico com anexo\
\ descartado legitimamente de validação ativa. Manter diagnóstico de reparo e\
\ ausência de transições de estado em consultas."
acceptanceCriteria:
- "Consultas e contexto em processos novos preservam informações e autoridade e\
\ não promovem, migram ou concluem registros por leitura."
- "Anexos descartados legitimamente não invalidam histórico; corrupção e referê\
ncias ausentes não são tratadas como gates satisfeitos."
- "Caminhos selecionados não repetem varreduras/validações globais sem necessidade;\
\ saída e códigos de erro compatíveis são verificados."
dependsOn:
- "TSK-0004"
- "TSK-0005"
- "TSK-0006"
- "TSK-0008"
status: "COMPLETED"
result: "Consultas e verificação usam SQLite e snapshots consistentes; 15 testes\
\ focados passaram e compatibilidade legada preservada."
evidence:
- "ART-0009"
updatedAt: "2026-11-22T13:23:23.962895Z"
- id: "TSK-0010"
title: "Implementar migração explícita e recuperável do legado"
description: "Criar comando público de prévia e aplicação da migração, sem conversã\
o em leituras ou atualização do instalador. Usar base de preparo e cópia de seguranç\
a da conversão, importação tipada transacional e verificação contra o corpus.\
\ Preservar IDs, conteúdo, aprovações, hashes, revisões e proveniência histórica\
\ sem despejar arquivos no banco. Ativar somente após sucesso; repetir ou recuperar\
\ interrupção sem duplicar. Executar apenas em fixtures/cópias descartáveis."
acceptanceCriteria:
- "Prévia não modifica o projeto; aplicação compara registros/contexto e ativa a\
\ base somente após validação completa."
- "Fixtures históricas, recibos, aprovações e referências preservam identidade/proveniê\
ncia; execução repetida não duplica conteúdo."
- "Falhas e interrupções deixam a fonte anterior recuperável e informam próxima\
\ ação; nenhum projeto real ou workspace canônico foi migrado."
dependsOn:
- "TSK-0001"
- "TSK-0009"
status: "ACTIVE"
result: "Implementar prévia, migração explícita, comparação e recuperação somente\
\ em fixtures descartáveis."
evidence: []
updatedAt: "2026-11-22T13:23:38.291996Z"
- id: "TSK-0011"
title: "Atualizar init, descoberta e contrato de compatibilidade"
description: "Inicializar projetos locais em SQLite e deixar .ai-engineering ignorado\
\ pelo Git por padrão sem exigir Git. Preservar regras preexistentes e instruç\
ões fora do bloco gerido. Declarar backend e versões no contrato público, atualizar\
\ diagnóstico/onboard e evitar que base SQLite seja interpretada como workspace\
\ vazio por combinação incompatível. Manter tratamento explícito de projetos legados\
\ e previamente rastreados."
acceptanceCriteria:
- "Init cria projeto funcional sem Git, com estado local ignorado por padrão e bootstrap\
\ suficiente para humanos e agentes."
- "Reexecução preserva conteúdo/regras; não remove arquivos já rastreados nem converte\
\ legado automaticamente."
- "Versões e backend incompatíveis são recusados com diagnóstico acionável antes\
\ de escrita; documentação/entrypoints não induzem uso de CLI incompatível."
dependsOn:
- "TSK-0009"
- "TSK-0010"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:28.841960Z"
- id: "TSK-0012"
title: "Preparar pacote nativo e instalador conjunto sem ativação"
description: "Evoluir build/distribuição e scripts/install-native.sh para empacotar\
\ AIE nativo, biblioteca SQLite do driver e CLI sqlite3 num diretório configurá\
vel, com atalhos aie/ai-engineering e dados de projeto separados. Fixar componentes/plataformas\
\ e verificar pacote antes de ativação, preservando versão anterior em falhas.\
\ Testar instalador com ferramentas simuladas e destinos descartáveis; smoke usa\
\ build local. Não executar instalação real nem tocar ~/.local/bin ou dependê\
ncias ativas."
acceptanceCriteria:
- "Pacote contém componentes corretos e o build nativo acessa uma base descartá\
vel sem depender da instalação global."
- "Fixtures verificam diretórios configuráveis, atalhos, atualização conjunta e\
\ falha sem danificar instalação anterior simulada."
- "Nenhum binário, biblioteca ou atalho ativo é substituído e o instalador real\
\ não é executado; a ativação posterior continua dependente de instrução humana."
dependsOn:
- "TSK-0002"
- "TSK-0011"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:37.290314Z"
- id: "TSK-0013"
title: "Consolidar documentação e instruções do framework local"
description: "Atualizar README, docs de arquitetura/protocolo/compatibilidade/migraç\
ão e recursos de entrada para memória local, SQLite, gates e retenção mínima.\
\ Explicar anexos temporários, outputs entregues, migração explícita e recuperaç\
ão, pacote preparado e instalação adiada. Remover instruções que apresentem arquivos\
\ de Works como fonte principal nova ou Git como exigência. Preservar orientaç\
ões dos dois ciclos, OODA, DEC/Plan e aprovações."
acceptanceCriteria:
- "Documentação e recursos distribuídos descrevem o mesmo contrato e permitem inicializar/retomar\
\ um projeto sem Git."
- "Procedimento público de migração explica prévia, efeitos e recuperação sem depender\
\ de inspeção do código interno."
- "Limites de retenção e instalação, papel dos gates e recortes futuros estão claros;\
\ fontes e exemplos não alegam testes ou migrações reais não executados."
dependsOn:
- "TSK-0010"
- "TSK-0011"
- "TSK-0012"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:45.331995Z"
- id: "TSK-0014"
title: "Executar regressão integrada e encaminhar responsividade ao WRK-000C"
description: "Integrar as verificações das etapas e executar gates apropriados de\
\ testes/arquitetura, migração, concorrência e smoke JVM/nativo em ambientes descartá\
veis. Revisar continuidade e autoridade nos dois ciclos, anexos temporários, recuperaç\
ão e funcionamento sem Git. Consolidar resultados mínimos, resolver experimentos/preocupaç\
ões e entregar cenário reproduzível ao WRK-000C com comandos, versão, dados e\
\ ambiente. Não instalar o pacote nem declarar resolvido o atraso."
acceptanceCriteria:
- "Suíte relevante de domínio/integração/compatibilidade, fixtures do instalador\
\ e smoke nativo passam ou impedimentos são tratados antes da conclusão."
- "Falhas, rollback, concorrência, legado, gates e descarte legítimo foram verificados\
\ com resultados reais e sem alteração da instalação ativa ou consumidores."
- "Todos os steps e critérios da DEC estão satisfeitos, sem experimentos/preocupaç\
ões pendentes; WRK-000C recebe cenário para medição futura e permanece aberto."
dependsOn:
- "TSK-0013"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:53.421052Z"
status: "ACTIVE"
author: "Codex"
createdAt: "2026-11-22T11:52:06.993736Z"
revision: 39
previousHash: "c72704d869495ed44491a9992cf7ee1bba00c4225ed4456bbfd3de1f187b43ec"
updatedAt: "2026-11-22T13:23:38.292184Z"
updatedBy: "Codex"
changeReason: "Implementar prévia, migração explícita, comparação e recuperação somente\
\ em fixtures descartáveis."
experiments:
- id: "EXP-0001"
stepId: "TSK-0002"
hypothesis: "SQLite JDBC pode criar, persistir e reabrir uma base em processos JVM\
\ e Native Image com biblioteca distribuída ao lado do executável."
successCriterion: "As duas formas executam create/read/write/reopen e rollback em\
\ diretório descartável; o nativo usa a biblioteca do pacote com extração temporá\
ria indisponível; nenhum binário ativo ou consumidor é alterado."
invocation: "./gradlew sqliteProbeClasses nativeSqliteProbeCompile; scripts/sqlite-probe.sh\
\ <build>; execução da classe de prova JVM e do binário de build em processos\
\ distintos"
retryOf: null
reconsideration: null
by: "Codex"
createdAt: "2026-11-22T12:10:00.110720Z"
outcome: "CONFIRMED"
observation: "JVM criou e reabriu a base com UTF-8 e rollback. Native Image GraalVM\
\ 25 criou e reabriu em processos independentes com biblioteca externa e extraç\
ão sem escrita; a cópia isolada sem biblioteca falhou."
interpretation: "Driver SQLite JDBC 3.54.1.0 e biblioteca distribuída ao lado do\
\ nativo funcionam na plataforma macOS arm64. Seleção inicial de JDK foi corrigida\
\ explicitamente; sem instalação real."
nextAction: "Implementar infraestrutura transacional e esquema local no TSK-0003."
evidence:
- "ART-0002"
questionsDecision: null
finishedAt: "2026-11-22T12:16:43.109268Z"
finishedBy: "Codex"
- id: "EXP-0002"
stepId: "TSK-0008"
hypothesis: "Anexos temporarios podem ser descartados apos a conclusao sem perder\
\ resultados historicos ou aceitar entradas ausentes em novos checks."
successCriterion: "Fixtures confirmam retencao durante checks, limpeza apos commit,\
\ rollback sem apagar entradas, recuperacao de descarte interrompido e recusa\
\ de evidencia perdida ou aposentada em avaliacao atual."
invocation: "./gradlew test --tests *SqliteArtifactLifecycleTest --tests *SqliteCoordinationTest\
\ --tests *SqliteQualityGatesTest"
retryOf: null
reconsideration: null
by: "Codex"
createdAt: "2026-11-22T13:12:55.720771Z"
outcome: "CONFIRMED"
observation: "Fixtures passaram retenção durante checks, descarte após commit, rollback\
\ e recuperação de interrupções; entrada perdida ou aposentada não satisfaz avaliaç\
ão atual."
interpretation: "Resultado estruturado e estado de descarte permitem retenção mí\
nima sem enfraquecer entradas obrigatórias. Originais legados preservados."
nextAction: "Integrar consultas, verificação e compatibilidade ao backend SQLite\
\ no TSK-0009."
evidence:
- "ART-0008"
questionsDecision: null
finishedAt: "2026-11-22T13:16:14.087721Z"
finishedBy: "Codex"
documentVersion: 2
---
# Implementar memória de engenharia local em SQLite
## Autoridade e objetivo
Executar a DEC-0001 do WRK-000D, aceita explicitamente por Nilton nesta conversa.
O resultado é um framework local de memória de engenharia por Work, com SQLite
por projeto, investigação e implementação orientadas por OODA, gates preservados,
anexos temporários e retenção mínima. A aprovação desta DEC mantém a instalação
real adiada.
Este Plan foi solicitado com decomposição em vários steps. Todos os steps começam
OPEN; a criação do Plan não constitui execução ou comprovação de resultado.
## Limites obrigatórios
- Não instalar nem substituir o AIE, SQLite, bibliotecas ou atalhos em uso.
- Não executar o instalador real contra HOME, ~/.local/bin ou outro destino ativo.
Sua validação usa fixtures com ferramentas simuladas e destinos descartáveis.
- Não migrar este workspace canônico ou projetos consumidores. Exercitar o novo
backend e a migração em fixtures e cópias descartáveis; ativação real depende de
instrução humana posterior específica.
- Preservar alterações preexistentes, IDs, conteúdo e proveniência legada,
aprovações, evidências históricas e instruções do projeto fora do bloco gerido.
- Não introduzir arquivos em BLOB/base64 ou TEXT equivalente, retenção extensa,
executor autônomo de repositório, colaboração distribuída ou integração Git LFS.
- Importação/exportação de Works/DECs e backup como funcionalidade ficam fora.
A cópia de segurança da migração é parte da recuperação da conversão.
- Código e outputs solicitados permanecem nos destinos de entrega apropriados.
- O WRK-000C permanece aberto para avaliar e tratar latência após esta mudança.
## Execução e dependências
Os 14 steps possuem dependências explícitas e critérios próprios. Mapear primeiro
o contrato e o legado; provar a integração SQLite/JVM/Native Image; depois construir
as transações e migrar os fluxos de domínio. Integrar gates e ciclo dos anexos antes
de consolidar as consultas, a migração pública e o bootstrap. Preparar distribuição
e documentação e concluir com regressão integrada e encaminhamento ao WRK-000C.
Não iniciar um step com dependências pendentes. Verificações focadas fazem parte
de cada mudança; a última etapa integra os cenários e não substitui essas verificações.
Steps independentes podem ser executados em ordem compatível, sem presumir
autorização de delegação ou de instalação real.
## OODA e incertezas
Nas provas relevantes, principalmente driver/nativo, migração e descarte de anexos,
registrar hipótese, critério de sucesso e invocação antes de executar. Registrar
observação, interpretação e próxima ação após o resultado; reconsiderar antes de
repetir uma hipótese falha. Usar os registros de experimentos do Plan quando úteis,
sem impor um ritual de quatro fases a toda alteração.
Ajustar esquema, índices, transações e build dentro da DEC. Se um resultado
questionar a decisão, registrar a preocupação, continuar investigações autorizadas
e rever a DEC com aprovação aplicável antes da execução afetada.
## Verificação e registro mínimo
Durante a execução deste Work, respeitar o protocolo que está em uso. Registrar
resultados reais e evidência mínima necessária para completar os steps; não usar
a futura política de limpeza para apagar evidências legadas ou simular gates.
Verificar continuidade entre processos, integridade referencial, rollback,
concorrência local com espera limitada, autoridade humana, gates e anexos
temporários, migração repetível e operação sem Git. Provas nativas usam somente
artefatos de build e projetos descartáveis.
Comandos candidatos à validação, ajustados ao resultado e ao código final:
- `./gradlew test` e `./gradlew check` para a suíte e arquitetura do projeto.
- `python3 scripts/test-install-native.py` para fixtures do instalador.
- `./gradlew nativeCompile` e tarefas de distribuição para construir o pacote.
- `bash scripts/native-smoke.sh <caminho-absoluto-do-build>` em projetos descartáveis.
Esses comandos são planejados, não executados na criação do Plan. Preservar os
gates específicos do projeto e adicionais do Work definidos na execução. Logs de
trabalho podem ser temporários; guardar na memória somente o necessário ao contrato.
## Conclusão
Todos os steps obrigatórios devem satisfazer seus critérios, com a DEC aceita e
sem experimentos ou preocupações pendentes. A entrega é código, documentação,
pacote preparado e resultados de verificação. Não depende de instalar a nova
versão no ambiente em uso. Encaminhar ao WRK-000C um cenário reproduzível com
comandos, versão, volume e ambiente, sem declarar resolvido o problema de atraso.
@@ -0,0 +1,504 @@
---
schemaVersion: 1
id: "PLN-0001"
workId: "WRK-000D"
title: "Implementar memória de engenharia local em SQLite sem instalação ativa"
decisions:
- "DEC-0001"
steps:
- id: "TSK-0001"
title: "Mapear contrato, dados legados e cenários de migração"
description: "Inspecionar WorkService, serviços de Discussion/Decision/Plan/Agent,\
\ coordenadores e VerificationService. Mapear registros, referências, revisões,\
\ hashes, recibos e bootstrap para tabelas e regras do backend SQLite, preservando\
\ conteúdo e autoridade. Selecionar fixtures existentes de compatibilidade, workflows\
\ e importação como corpus; usar apenas cópias descartáveis. Identificar checks\
\ e pontos de retenção sem realizar benchmark conclusivo do WRK-000C."
acceptanceCriteria:
- "Mapeamento cobre entidades persistidas, IDs locais ao Work, referências, revisõ\
es, aprovações e casos de conclusão legada com hashes/recibos."
- "Corpus representativo e resultados esperados de continuidade/migração estão definidos\
\ antes da conversão, incluindo dados inválidos e estados interrompidos."
- "Limites de instalação, migração de consumidores e preservação do workspace atual\
\ estão explícitos e respeitados."
dependsOn: []
status: "COMPLETED"
result: "Contrato e legado mapeados em docs/sqlite-migration-design.md; corpus e\
\ casos de falha/retry definidos antes da migração. Baseline: 45 testes em seis\
\ classes passaram, hashes congelados conferidos e fontes históricas intactas.\
\ Sem instalação ou migração real."
evidence:
- "ART-0001"
updatedAt: "2026-11-22T12:00:26.700050Z"
- id: "TSK-0002"
title: "Provar driver SQLite em JVM e Native Image"
description: "Avaliar Xerial SQLite JDBC e fixar versão compatível com Java, Gradle\
\ e GraalVM do projeto. Registrar hipótese, critério e invocação antes da prova.\
\ Criar, gravar, ler e reabrir uma base descartável em processos JVM e nativos.\
\ Verificar carregamento da biblioteca distribuída ao lado do nativo; sqlite3\
\ será ferramenta de diagnóstico do pacote. Construir e executar somente artefatos\
\ descartáveis, sem instalação real."
acceptanceCriteria:
- "Driver e versão selecionados demonstram persistência e reabertura em JVM e Native\
\ Image na plataforma alvo."
- "Biblioteca do pacote é encontrada por caminho controlado e não depende acidentalmente\
\ do SQLite global ou de extração repetida não planejada."
- "Hipótese, resultado e limitações da prova estão registrados; instalação ativa\
\ e projetos consumidores não foram alterados."
dependsOn:
- "TSK-0001"
status: "COMPLETED"
result: "Prova JVM e Native Image passou create/read/write/reopen, UTF-8, rollback\
\ e dependência da biblioteca do pacote; sem instalação ativa."
evidence:
- "ART-0002"
updatedAt: "2026-11-22T12:16:52.149066Z"
- id: "TSK-0003"
title: "Implementar esquema, conexões e transações SQLite"
description: "Criar infraestrutura de persistência local em .ai-engineering/aie.db\
\ com esquema versionado, tabelas tipadas, índices e relações. Habilitar integridade\
\ referencial em cada conexão, delimitar unidade transacional por operação coerente\
\ e usar leitura consistente. Definir journal/durabilidade e espera limitada de\
\ escrita com diagnóstico. Preservar limites de módulos; serviços aninhados devem\
\ compartilhar a transação aplicável."
acceptanceCriteria:
- "Esquema e índices atendem ao mapeamento sem BLOB/base64 ou arquivos completos\
\ serializados em TEXT."
- "Falha em operação relacionada causa rollback; referências inválidas são recusadas\
\ e gravações concorrentes têm contenção limitada e diagnóstico útil."
- "Abertura de esquema incompatível é diagnosticada sem alterar dados; teste de\
\ leitura consistente cobre mudanças concorrentes locais."
dependsOn:
- "TSK-0001"
- "TSK-0002"
status: "COMPLETED"
result: "Infraestrutura SQLite validada: 12 testes de transação/integridade/concorrê\
ncia e arquitetura passaram; schema também criado e reaberto pelo Native Image.\
\ CLI de domínio e instalação ativa continuam intactos."
evidence:
- "ART-0003"
updatedAt: "2026-11-22T12:26:10.846492Z"
- id: "TSK-0004"
title: "Persistir Works e investigação no novo backend"
description: "Integrar Work, guidance e histórico de escolhas, discussões, tópicos,\
\ surveys, respostas e disposições à unidade de persistência. Preservar IDs existentes,\
\ semântica dos IDs locais, referências e histórico útil. Consultas selecionadas\
\ devem buscar o Work diretamente. Manter leitura legada delimitada para compatibilidade\
\ e migração; não manter duas fontes autoritativas para a mesma memória."
acceptanceCriteria:
- "Criar e retomar Work/discussão/survey em outro processo preserva conteúdo, histó\
rico de respostas e pendências."
- "Escolhas DIRECT/EXPLORATORY e autoridade humana mantêm as regras existentes,\
\ inclusive ausência de escolha e pedido específico de DEC."
- "Busca por Work e suas referências usa consultas com escopo adequado; alteraçõ\
es e referências relacionadas são transacionais."
dependsOn:
- "TSK-0003"
status: "COMPLETED"
result: "Works/investigação SQLite passaram 45 testes e retomada em outro JVM e\
\ nativo; referências transacionais, histórico e autoridade preservados."
evidence:
- "ART-0004"
updatedAt: "2026-11-22T12:43:38.166159Z"
- id: "TSK-0005"
title: "Persistir decisões, planos e experimentos"
description: "Integrar DecisionService e PlanService com revisões, aceitação, supersessã\
o, passos, dependências e experimentos. Preservar os dois ciclos e OODA, a autoridade\
\ de DEC/Plan e a distinção entre aprovação humana e promoção permitida por polí\
tica. Tratar operações que alteram registros relacionados em uma transação, sem\
\ reduzir os checks de domínio."
acceptanceCriteria:
- "Aprovação, revisão e supersessão preservam autoria e referências, sem fabricaç\
ão de aprovação ou edição silenciosa de decisão aceita."
- "Dependências e estados de passos, critérios de experimentos, preocupações com\
\ DEC e replanejamento conservam os bloqueios existentes."
- "Interrupção simulada não publica meia supersessão ou promoção parcial; retomada\
\ em outro processo preserva o contexto."
dependsOn:
- "TSK-0004"
status: "COMPLETED"
result: "Decisões/Plans/experimentos SQLite preservam autoridade, revisão, dependê\
ncias e rollback conjunto; 34 cenários distintos selecionados passaram ao final\
\ após ajuste textual de um teste."
evidence:
- "ART-0005"
updatedAt: "2026-11-22T12:54:10.341537Z"
- id: "TSK-0006"
title: "Integrar execuções de agentes e coordenação de EPICs"
description: "Persistir RUNs e seus dados operacionais mínimos, idempotência de\
\ requestId, referências aplicadas e diagnóstico. Integrar PlanCoordinator/EpicCoordinator,\
\ políticas e proveniência de conclusão, representando recibos internos como dados\
\ estruturados quando aplicável. Preservar a fronteira do adaptador: propostas\
\ não aprovam DEC, não respondem pelo humano nem executam comandos de repositó\
rio."
acceptanceCriteria:
- "Repetição idempotente de uma solicitação concluída não duplica registros; solicitaç\
ões divergentes e estados interrompidos são diagnosticados."
- "Políticas RESULTS/DECOMPOSITION, delegação, reabertura, propagação e conclusã\
o por Plans preservam autoridade e proveniência."
- "Resultados estruturados necessários permanecem; transporte bruto, ambiente e\
\ logs completos não viram acervo permanente no banco."
dependsOn:
- "TSK-0005"
status: "COMPLETED"
result: "RUNs/EPICs persistidos e coordenação preservada; 30 cenários distintos\
\ passaram, incluindo rollback integral e idempotência."
evidence:
- "ART-0006"
updatedAt: "2026-11-22T13:02:08.858215Z"
- id: "TSK-0007"
title: "Integrar gates do projeto e adicionais por Work"
description: "Representar gates obrigatórios do projeto e complementos do Work e\
\ conectar seus resultados aos checks e à entrega. Preservar avaliação externa\
\ e condições de qualidade, inclusive anexos exigidos. Registrar identificaçã\
o, procedimento/execução, estado avaliado, momento e resultado mínimo. Alteraç\
ões pertinentes invalidam a aplicação do resultado aos gates afetados; aprovaç\
ão humana não equivale a sucesso técnico."
acceptanceCriteria:
- "Gate obrigatório pendente, falho ou não executado bloqueia a entrega; gates adicionais\
\ do Work são considerados sem dispensar obrigatórios do projeto."
- "Resultados correspondem ao estado realmente avaliado e não satisfazem silenciosamente\
\ um gate após mudança relevante."
- "Checks existentes e anexos necessários continuam exigidos durante avaliação,\
\ sem introduzir executor autônomo ou retenção bruta obrigatória."
dependsOn:
- "TSK-0005"
- "TSK-0006"
status: "COMPLETED"
result: "Gates cumulativos bloqueiam entrega sem PASS atual; snapshots históricos\
\ preservados. 23 cenários focados passaram."
evidence:
- "ART-0007"
updatedAt: "2026-11-22T13:08:08.952170Z"
- id: "TSK-0008"
title: "Implementar anexos temporários e descarte após checks"
description: "Definir ciclo de vida de anexos e arquivos de execução no filesystem.\
\ Publicar arquivos completos, validar e registrar resultados mínimos antes do\
\ descarte; limpar elegíveis ao fim da execução. Proteger anexos ainda usados\
\ por checks pendentes e outputs solicitados. Recuperar falhas entre publicaçã\
o de arquivo, transação no banco e limpeza, distinguindo descarte legítimo de\
\ perda prematura. Não descartar artefatos legados deste workspace."
acceptanceCriteria:
- "Arquivos exigidos permanecem acessíveis até todos os checks dependentes terminarem,\
\ com resultado persistido antes da remoção."
- "Descarte automático preserva outputs solicitados e memória histórica; arquivo\
\ perdido antes da avaliação continua causando falha."
- "Interrupções nos pontos de publicação, registro e limpeza não fabricam sucesso\
\ e permitem recuperação sem remoção de entradas ainda necessárias."
dependsOn:
- "TSK-0007"
status: "COMPLETED"
result: "Anexos temporários e recibos tipados integrados; EXP-0002 confirmado e\
\ 32 cenários distintos passaram."
evidence:
- "ART-0008"
updatedAt: "2026-11-22T13:16:27.036583Z"
- id: "TSK-0009"
title: "Adaptar verificação, status e contexto ao SQLite"
description: "Integrar VerificationService, CompatibilityService e projeções da\
\ CLI ao backend. Montar status, next-actions, context e readiness com consultas\
\ necessárias e resultados reutilizados na invocação; preservar contrato público\
\ quando compatível e informar mudanças. Separar resultado histórico com anexo\
\ descartado legitimamente de validação ativa. Manter diagnóstico de reparo e\
\ ausência de transições de estado em consultas."
acceptanceCriteria:
- "Consultas e contexto em processos novos preservam informações e autoridade e\
\ não promovem, migram ou concluem registros por leitura."
- "Anexos descartados legitimamente não invalidam histórico; corrupção e referê\
ncias ausentes não são tratadas como gates satisfeitos."
- "Caminhos selecionados não repetem varreduras/validações globais sem necessidade;\
\ saída e códigos de erro compatíveis são verificados."
dependsOn:
- "TSK-0004"
- "TSK-0005"
- "TSK-0006"
- "TSK-0008"
status: "COMPLETED"
result: "Consultas e verificação usam SQLite e snapshots consistentes; 15 testes\
\ focados passaram e compatibilidade legada preservada."
evidence:
- "ART-0009"
updatedAt: "2026-11-22T13:23:23.962895Z"
- id: "TSK-0010"
title: "Implementar migração explícita e recuperável do legado"
description: "Criar comando público de prévia e aplicação da migração, sem conversã\
o em leituras ou atualização do instalador. Usar base de preparo e cópia de seguranç\
a da conversão, importação tipada transacional e verificação contra o corpus.\
\ Preservar IDs, conteúdo, aprovações, hashes, revisões e proveniência histórica\
\ sem despejar arquivos no banco. Ativar somente após sucesso; repetir ou recuperar\
\ interrupção sem duplicar. Executar apenas em fixtures/cópias descartáveis."
acceptanceCriteria:
- "Prévia não modifica o projeto; aplicação compara registros/contexto e ativa a\
\ base somente após validação completa."
- "Fixtures históricas, recibos, aprovações e referências preservam identidade/proveniê\
ncia; execução repetida não duplica conteúdo."
- "Falhas e interrupções deixam a fonte anterior recuperável e informam próxima\
\ ação; nenhum projeto real ou workspace canônico foi migrado."
dependsOn:
- "TSK-0001"
- "TSK-0009"
status: "ACTIVE"
result: "Implementar prévia, migração explícita, comparação e recuperação somente\
\ em fixtures descartáveis."
evidence: []
updatedAt: "2026-11-22T13:23:38.291996Z"
- id: "TSK-0011"
title: "Atualizar init, descoberta e contrato de compatibilidade"
description: "Inicializar projetos locais em SQLite e deixar .ai-engineering ignorado\
\ pelo Git por padrão sem exigir Git. Preservar regras preexistentes e instruç\
ões fora do bloco gerido. Declarar backend e versões no contrato público, atualizar\
\ diagnóstico/onboard e evitar que base SQLite seja interpretada como workspace\
\ vazio por combinação incompatível. Manter tratamento explícito de projetos legados\
\ e previamente rastreados."
acceptanceCriteria:
- "Init cria projeto funcional sem Git, com estado local ignorado por padrão e bootstrap\
\ suficiente para humanos e agentes."
- "Reexecução preserva conteúdo/regras; não remove arquivos já rastreados nem converte\
\ legado automaticamente."
- "Versões e backend incompatíveis são recusados com diagnóstico acionável antes\
\ de escrita; documentação/entrypoints não induzem uso de CLI incompatível."
dependsOn:
- "TSK-0009"
- "TSK-0010"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:28.841960Z"
- id: "TSK-0012"
title: "Preparar pacote nativo e instalador conjunto sem ativação"
description: "Evoluir build/distribuição e scripts/install-native.sh para empacotar\
\ AIE nativo, biblioteca SQLite do driver e CLI sqlite3 num diretório configurá\
vel, com atalhos aie/ai-engineering e dados de projeto separados. Fixar componentes/plataformas\
\ e verificar pacote antes de ativação, preservando versão anterior em falhas.\
\ Testar instalador com ferramentas simuladas e destinos descartáveis; smoke usa\
\ build local. Não executar instalação real nem tocar ~/.local/bin ou dependê\
ncias ativas."
acceptanceCriteria:
- "Pacote contém componentes corretos e o build nativo acessa uma base descartá\
vel sem depender da instalação global."
- "Fixtures verificam diretórios configuráveis, atalhos, atualização conjunta e\
\ falha sem danificar instalação anterior simulada."
- "Nenhum binário, biblioteca ou atalho ativo é substituído e o instalador real\
\ não é executado; a ativação posterior continua dependente de instrução humana."
dependsOn:
- "TSK-0002"
- "TSK-0011"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:37.290314Z"
- id: "TSK-0013"
title: "Consolidar documentação e instruções do framework local"
description: "Atualizar README, docs de arquitetura/protocolo/compatibilidade/migraç\
ão e recursos de entrada para memória local, SQLite, gates e retenção mínima.\
\ Explicar anexos temporários, outputs entregues, migração explícita e recuperaç\
ão, pacote preparado e instalação adiada. Remover instruções que apresentem arquivos\
\ de Works como fonte principal nova ou Git como exigência. Preservar orientaç\
ões dos dois ciclos, OODA, DEC/Plan e aprovações."
acceptanceCriteria:
- "Documentação e recursos distribuídos descrevem o mesmo contrato e permitem inicializar/retomar\
\ um projeto sem Git."
- "Procedimento público de migração explica prévia, efeitos e recuperação sem depender\
\ de inspeção do código interno."
- "Limites de retenção e instalação, papel dos gates e recortes futuros estão claros;\
\ fontes e exemplos não alegam testes ou migrações reais não executados."
dependsOn:
- "TSK-0010"
- "TSK-0011"
- "TSK-0012"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:45.331995Z"
- id: "TSK-0014"
title: "Executar regressão integrada e encaminhar responsividade ao WRK-000C"
description: "Integrar as verificações das etapas e executar gates apropriados de\
\ testes/arquitetura, migração, concorrência e smoke JVM/nativo em ambientes descartá\
veis. Revisar continuidade e autoridade nos dois ciclos, anexos temporários, recuperaç\
ão e funcionamento sem Git. Consolidar resultados mínimos, resolver experimentos/preocupaç\
ões e entregar cenário reproduzível ao WRK-000C com comandos, versão, dados e\
\ ambiente. Não instalar o pacote nem declarar resolvido o atraso."
acceptanceCriteria:
- "Suíte relevante de domínio/integração/compatibilidade, fixtures do instalador\
\ e smoke nativo passam ou impedimentos são tratados antes da conclusão."
- "Falhas, rollback, concorrência, legado, gates e descarte legítimo foram verificados\
\ com resultados reais e sem alteração da instalação ativa ou consumidores."
- "Todos os steps e critérios da DEC estão satisfeitos, sem experimentos/preocupaç\
ões pendentes; WRK-000C recebe cenário para medição futura e permanece aberto."
dependsOn:
- "TSK-0013"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:53.421052Z"
status: "ACTIVE"
author: "Codex"
createdAt: "2026-11-22T11:52:06.993736Z"
revision: 40
previousHash: "17e0bf43f565c0c1b6c512729b0609f1d76991f486d5e7acde4011a7675054f2"
updatedAt: "2026-11-22T13:28:47.295686Z"
updatedBy: "Codex"
changeReason: "Verificar importacao tipada, guarda de compatibilidade e fronteiras\
\ de recuperacao antes de disponibilizar conversao."
experiments:
- id: "EXP-0001"
stepId: "TSK-0002"
hypothesis: "SQLite JDBC pode criar, persistir e reabrir uma base em processos JVM\
\ e Native Image com biblioteca distribuída ao lado do executável."
successCriterion: "As duas formas executam create/read/write/reopen e rollback em\
\ diretório descartável; o nativo usa a biblioteca do pacote com extração temporá\
ria indisponível; nenhum binário ativo ou consumidor é alterado."
invocation: "./gradlew sqliteProbeClasses nativeSqliteProbeCompile; scripts/sqlite-probe.sh\
\ <build>; execução da classe de prova JVM e do binário de build em processos\
\ distintos"
retryOf: null
reconsideration: null
by: "Codex"
createdAt: "2026-11-22T12:10:00.110720Z"
outcome: "CONFIRMED"
observation: "JVM criou e reabriu a base com UTF-8 e rollback. Native Image GraalVM\
\ 25 criou e reabriu em processos independentes com biblioteca externa e extraç\
ão sem escrita; a cópia isolada sem biblioteca falhou."
interpretation: "Driver SQLite JDBC 3.54.1.0 e biblioteca distribuída ao lado do\
\ nativo funcionam na plataforma macOS arm64. Seleção inicial de JDK foi corrigida\
\ explicitamente; sem instalação real."
nextAction: "Implementar infraestrutura transacional e esquema local no TSK-0003."
evidence:
- "ART-0002"
questionsDecision: null
finishedAt: "2026-11-22T12:16:43.109268Z"
finishedBy: "Codex"
- id: "EXP-0002"
stepId: "TSK-0008"
hypothesis: "Anexos temporarios podem ser descartados apos a conclusao sem perder\
\ resultados historicos ou aceitar entradas ausentes em novos checks."
successCriterion: "Fixtures confirmam retencao durante checks, limpeza apos commit,\
\ rollback sem apagar entradas, recuperacao de descarte interrompido e recusa\
\ de evidencia perdida ou aposentada em avaliacao atual."
invocation: "./gradlew test --tests *SqliteArtifactLifecycleTest --tests *SqliteCoordinationTest\
\ --tests *SqliteQualityGatesTest"
retryOf: null
reconsideration: null
by: "Codex"
createdAt: "2026-11-22T13:12:55.720771Z"
outcome: "CONFIRMED"
observation: "Fixtures passaram retenção durante checks, descarte após commit, rollback\
\ e recuperação de interrupções; entrada perdida ou aposentada não satisfaz avaliaç\
ão atual."
interpretation: "Resultado estruturado e estado de descarte permitem retenção mí\
nima sem enfraquecer entradas obrigatórias. Originais legados preservados."
nextAction: "Integrar consultas, verificação e compatibilidade ao backend SQLite\
\ no TSK-0009."
evidence:
- "ART-0008"
questionsDecision: null
finishedAt: "2026-11-22T13:16:14.087721Z"
finishedBy: "Codex"
- id: "EXP-0003"
stepId: "TSK-0010"
hypothesis: "Migracao explicita com base preparada e originais preservados conserva\
\ hashes e autoridade, e recupera falhas sem duplicar dados."
successCriterion: "Corpus legado e Works ativos preservam DTOs, hashes, aprovacoes\
\ e historicos; fixtures interrompidas retomam ou revertem com seguranca; escrita\
\ nova impede rollback destrutivo."
invocation: "./gradlew test --tests *StorageMigrationTest --tests *CompatibilityTest\
\ --tests *SqliteQueriesTest"
retryOf: null
reconsideration: null
by: "Codex"
createdAt: "2026-11-22T13:28:47.295494Z"
outcome: "OPEN"
observation: null
interpretation: null
nextAction: null
evidence: []
questionsDecision: null
finishedAt: null
finishedBy: null
documentVersion: 2
---
# Implementar memória de engenharia local em SQLite
## Autoridade e objetivo
Executar a DEC-0001 do WRK-000D, aceita explicitamente por Nilton nesta conversa.
O resultado é um framework local de memória de engenharia por Work, com SQLite
por projeto, investigação e implementação orientadas por OODA, gates preservados,
anexos temporários e retenção mínima. A aprovação desta DEC mantém a instalação
real adiada.
Este Plan foi solicitado com decomposição em vários steps. Todos os steps começam
OPEN; a criação do Plan não constitui execução ou comprovação de resultado.
## Limites obrigatórios
- Não instalar nem substituir o AIE, SQLite, bibliotecas ou atalhos em uso.
- Não executar o instalador real contra HOME, ~/.local/bin ou outro destino ativo.
Sua validação usa fixtures com ferramentas simuladas e destinos descartáveis.
- Não migrar este workspace canônico ou projetos consumidores. Exercitar o novo
backend e a migração em fixtures e cópias descartáveis; ativação real depende de
instrução humana posterior específica.
- Preservar alterações preexistentes, IDs, conteúdo e proveniência legada,
aprovações, evidências históricas e instruções do projeto fora do bloco gerido.
- Não introduzir arquivos em BLOB/base64 ou TEXT equivalente, retenção extensa,
executor autônomo de repositório, colaboração distribuída ou integração Git LFS.
- Importação/exportação de Works/DECs e backup como funcionalidade ficam fora.
A cópia de segurança da migração é parte da recuperação da conversão.
- Código e outputs solicitados permanecem nos destinos de entrega apropriados.
- O WRK-000C permanece aberto para avaliar e tratar latência após esta mudança.
## Execução e dependências
Os 14 steps possuem dependências explícitas e critérios próprios. Mapear primeiro
o contrato e o legado; provar a integração SQLite/JVM/Native Image; depois construir
as transações e migrar os fluxos de domínio. Integrar gates e ciclo dos anexos antes
de consolidar as consultas, a migração pública e o bootstrap. Preparar distribuição
e documentação e concluir com regressão integrada e encaminhamento ao WRK-000C.
Não iniciar um step com dependências pendentes. Verificações focadas fazem parte
de cada mudança; a última etapa integra os cenários e não substitui essas verificações.
Steps independentes podem ser executados em ordem compatível, sem presumir
autorização de delegação ou de instalação real.
## OODA e incertezas
Nas provas relevantes, principalmente driver/nativo, migração e descarte de anexos,
registrar hipótese, critério de sucesso e invocação antes de executar. Registrar
observação, interpretação e próxima ação após o resultado; reconsiderar antes de
repetir uma hipótese falha. Usar os registros de experimentos do Plan quando úteis,
sem impor um ritual de quatro fases a toda alteração.
Ajustar esquema, índices, transações e build dentro da DEC. Se um resultado
questionar a decisão, registrar a preocupação, continuar investigações autorizadas
e rever a DEC com aprovação aplicável antes da execução afetada.
## Verificação e registro mínimo
Durante a execução deste Work, respeitar o protocolo que está em uso. Registrar
resultados reais e evidência mínima necessária para completar os steps; não usar
a futura política de limpeza para apagar evidências legadas ou simular gates.
Verificar continuidade entre processos, integridade referencial, rollback,
concorrência local com espera limitada, autoridade humana, gates e anexos
temporários, migração repetível e operação sem Git. Provas nativas usam somente
artefatos de build e projetos descartáveis.
Comandos candidatos à validação, ajustados ao resultado e ao código final:
- `./gradlew test` e `./gradlew check` para a suíte e arquitetura do projeto.
- `python3 scripts/test-install-native.py` para fixtures do instalador.
- `./gradlew nativeCompile` e tarefas de distribuição para construir o pacote.
- `bash scripts/native-smoke.sh <caminho-absoluto-do-build>` em projetos descartáveis.
Esses comandos são planejados, não executados na criação do Plan. Preservar os
gates específicos do projeto e adicionais do Work definidos na execução. Logs de
trabalho podem ser temporários; guardar na memória somente o necessário ao contrato.
## Conclusão
Todos os steps obrigatórios devem satisfazer seus critérios, com a DEC aceita e
sem experimentos ou preocupações pendentes. A entrega é código, documentação,
pacote preparado e resultados de verificação. Não depende de instalar a nova
versão no ambiente em uso. Encaminhar ao WRK-000C um cenário reproduzível com
comandos, versão, volume e ambiente, sem declarar resolvido o problema de atraso.
@@ -0,0 +1,507 @@
---
schemaVersion: 1
id: "PLN-0001"
workId: "WRK-000D"
title: "Implementar memória de engenharia local em SQLite sem instalação ativa"
decisions:
- "DEC-0001"
steps:
- id: "TSK-0001"
title: "Mapear contrato, dados legados e cenários de migração"
description: "Inspecionar WorkService, serviços de Discussion/Decision/Plan/Agent,\
\ coordenadores e VerificationService. Mapear registros, referências, revisões,\
\ hashes, recibos e bootstrap para tabelas e regras do backend SQLite, preservando\
\ conteúdo e autoridade. Selecionar fixtures existentes de compatibilidade, workflows\
\ e importação como corpus; usar apenas cópias descartáveis. Identificar checks\
\ e pontos de retenção sem realizar benchmark conclusivo do WRK-000C."
acceptanceCriteria:
- "Mapeamento cobre entidades persistidas, IDs locais ao Work, referências, revisõ\
es, aprovações e casos de conclusão legada com hashes/recibos."
- "Corpus representativo e resultados esperados de continuidade/migração estão definidos\
\ antes da conversão, incluindo dados inválidos e estados interrompidos."
- "Limites de instalação, migração de consumidores e preservação do workspace atual\
\ estão explícitos e respeitados."
dependsOn: []
status: "COMPLETED"
result: "Contrato e legado mapeados em docs/sqlite-migration-design.md; corpus e\
\ casos de falha/retry definidos antes da migração. Baseline: 45 testes em seis\
\ classes passaram, hashes congelados conferidos e fontes históricas intactas.\
\ Sem instalação ou migração real."
evidence:
- "ART-0001"
updatedAt: "2026-11-22T12:00:26.700050Z"
- id: "TSK-0002"
title: "Provar driver SQLite em JVM e Native Image"
description: "Avaliar Xerial SQLite JDBC e fixar versão compatível com Java, Gradle\
\ e GraalVM do projeto. Registrar hipótese, critério e invocação antes da prova.\
\ Criar, gravar, ler e reabrir uma base descartável em processos JVM e nativos.\
\ Verificar carregamento da biblioteca distribuída ao lado do nativo; sqlite3\
\ será ferramenta de diagnóstico do pacote. Construir e executar somente artefatos\
\ descartáveis, sem instalação real."
acceptanceCriteria:
- "Driver e versão selecionados demonstram persistência e reabertura em JVM e Native\
\ Image na plataforma alvo."
- "Biblioteca do pacote é encontrada por caminho controlado e não depende acidentalmente\
\ do SQLite global ou de extração repetida não planejada."
- "Hipótese, resultado e limitações da prova estão registrados; instalação ativa\
\ e projetos consumidores não foram alterados."
dependsOn:
- "TSK-0001"
status: "COMPLETED"
result: "Prova JVM e Native Image passou create/read/write/reopen, UTF-8, rollback\
\ e dependência da biblioteca do pacote; sem instalação ativa."
evidence:
- "ART-0002"
updatedAt: "2026-11-22T12:16:52.149066Z"
- id: "TSK-0003"
title: "Implementar esquema, conexões e transações SQLite"
description: "Criar infraestrutura de persistência local em .ai-engineering/aie.db\
\ com esquema versionado, tabelas tipadas, índices e relações. Habilitar integridade\
\ referencial em cada conexão, delimitar unidade transacional por operação coerente\
\ e usar leitura consistente. Definir journal/durabilidade e espera limitada de\
\ escrita com diagnóstico. Preservar limites de módulos; serviços aninhados devem\
\ compartilhar a transação aplicável."
acceptanceCriteria:
- "Esquema e índices atendem ao mapeamento sem BLOB/base64 ou arquivos completos\
\ serializados em TEXT."
- "Falha em operação relacionada causa rollback; referências inválidas são recusadas\
\ e gravações concorrentes têm contenção limitada e diagnóstico útil."
- "Abertura de esquema incompatível é diagnosticada sem alterar dados; teste de\
\ leitura consistente cobre mudanças concorrentes locais."
dependsOn:
- "TSK-0001"
- "TSK-0002"
status: "COMPLETED"
result: "Infraestrutura SQLite validada: 12 testes de transação/integridade/concorrê\
ncia e arquitetura passaram; schema também criado e reaberto pelo Native Image.\
\ CLI de domínio e instalação ativa continuam intactos."
evidence:
- "ART-0003"
updatedAt: "2026-11-22T12:26:10.846492Z"
- id: "TSK-0004"
title: "Persistir Works e investigação no novo backend"
description: "Integrar Work, guidance e histórico de escolhas, discussões, tópicos,\
\ surveys, respostas e disposições à unidade de persistência. Preservar IDs existentes,\
\ semântica dos IDs locais, referências e histórico útil. Consultas selecionadas\
\ devem buscar o Work diretamente. Manter leitura legada delimitada para compatibilidade\
\ e migração; não manter duas fontes autoritativas para a mesma memória."
acceptanceCriteria:
- "Criar e retomar Work/discussão/survey em outro processo preserva conteúdo, histó\
rico de respostas e pendências."
- "Escolhas DIRECT/EXPLORATORY e autoridade humana mantêm as regras existentes,\
\ inclusive ausência de escolha e pedido específico de DEC."
- "Busca por Work e suas referências usa consultas com escopo adequado; alteraçõ\
es e referências relacionadas são transacionais."
dependsOn:
- "TSK-0003"
status: "COMPLETED"
result: "Works/investigação SQLite passaram 45 testes e retomada em outro JVM e\
\ nativo; referências transacionais, histórico e autoridade preservados."
evidence:
- "ART-0004"
updatedAt: "2026-11-22T12:43:38.166159Z"
- id: "TSK-0005"
title: "Persistir decisões, planos e experimentos"
description: "Integrar DecisionService e PlanService com revisões, aceitação, supersessã\
o, passos, dependências e experimentos. Preservar os dois ciclos e OODA, a autoridade\
\ de DEC/Plan e a distinção entre aprovação humana e promoção permitida por polí\
tica. Tratar operações que alteram registros relacionados em uma transação, sem\
\ reduzir os checks de domínio."
acceptanceCriteria:
- "Aprovação, revisão e supersessão preservam autoria e referências, sem fabricaç\
ão de aprovação ou edição silenciosa de decisão aceita."
- "Dependências e estados de passos, critérios de experimentos, preocupações com\
\ DEC e replanejamento conservam os bloqueios existentes."
- "Interrupção simulada não publica meia supersessão ou promoção parcial; retomada\
\ em outro processo preserva o contexto."
dependsOn:
- "TSK-0004"
status: "COMPLETED"
result: "Decisões/Plans/experimentos SQLite preservam autoridade, revisão, dependê\
ncias e rollback conjunto; 34 cenários distintos selecionados passaram ao final\
\ após ajuste textual de um teste."
evidence:
- "ART-0005"
updatedAt: "2026-11-22T12:54:10.341537Z"
- id: "TSK-0006"
title: "Integrar execuções de agentes e coordenação de EPICs"
description: "Persistir RUNs e seus dados operacionais mínimos, idempotência de\
\ requestId, referências aplicadas e diagnóstico. Integrar PlanCoordinator/EpicCoordinator,\
\ políticas e proveniência de conclusão, representando recibos internos como dados\
\ estruturados quando aplicável. Preservar a fronteira do adaptador: propostas\
\ não aprovam DEC, não respondem pelo humano nem executam comandos de repositó\
rio."
acceptanceCriteria:
- "Repetição idempotente de uma solicitação concluída não duplica registros; solicitaç\
ões divergentes e estados interrompidos são diagnosticados."
- "Políticas RESULTS/DECOMPOSITION, delegação, reabertura, propagação e conclusã\
o por Plans preservam autoridade e proveniência."
- "Resultados estruturados necessários permanecem; transporte bruto, ambiente e\
\ logs completos não viram acervo permanente no banco."
dependsOn:
- "TSK-0005"
status: "COMPLETED"
result: "RUNs/EPICs persistidos e coordenação preservada; 30 cenários distintos\
\ passaram, incluindo rollback integral e idempotência."
evidence:
- "ART-0006"
updatedAt: "2026-11-22T13:02:08.858215Z"
- id: "TSK-0007"
title: "Integrar gates do projeto e adicionais por Work"
description: "Representar gates obrigatórios do projeto e complementos do Work e\
\ conectar seus resultados aos checks e à entrega. Preservar avaliação externa\
\ e condições de qualidade, inclusive anexos exigidos. Registrar identificaçã\
o, procedimento/execução, estado avaliado, momento e resultado mínimo. Alteraç\
ões pertinentes invalidam a aplicação do resultado aos gates afetados; aprovaç\
ão humana não equivale a sucesso técnico."
acceptanceCriteria:
- "Gate obrigatório pendente, falho ou não executado bloqueia a entrega; gates adicionais\
\ do Work são considerados sem dispensar obrigatórios do projeto."
- "Resultados correspondem ao estado realmente avaliado e não satisfazem silenciosamente\
\ um gate após mudança relevante."
- "Checks existentes e anexos necessários continuam exigidos durante avaliação,\
\ sem introduzir executor autônomo ou retenção bruta obrigatória."
dependsOn:
- "TSK-0005"
- "TSK-0006"
status: "COMPLETED"
result: "Gates cumulativos bloqueiam entrega sem PASS atual; snapshots históricos\
\ preservados. 23 cenários focados passaram."
evidence:
- "ART-0007"
updatedAt: "2026-11-22T13:08:08.952170Z"
- id: "TSK-0008"
title: "Implementar anexos temporários e descarte após checks"
description: "Definir ciclo de vida de anexos e arquivos de execução no filesystem.\
\ Publicar arquivos completos, validar e registrar resultados mínimos antes do\
\ descarte; limpar elegíveis ao fim da execução. Proteger anexos ainda usados\
\ por checks pendentes e outputs solicitados. Recuperar falhas entre publicaçã\
o de arquivo, transação no banco e limpeza, distinguindo descarte legítimo de\
\ perda prematura. Não descartar artefatos legados deste workspace."
acceptanceCriteria:
- "Arquivos exigidos permanecem acessíveis até todos os checks dependentes terminarem,\
\ com resultado persistido antes da remoção."
- "Descarte automático preserva outputs solicitados e memória histórica; arquivo\
\ perdido antes da avaliação continua causando falha."
- "Interrupções nos pontos de publicação, registro e limpeza não fabricam sucesso\
\ e permitem recuperação sem remoção de entradas ainda necessárias."
dependsOn:
- "TSK-0007"
status: "COMPLETED"
result: "Anexos temporários e recibos tipados integrados; EXP-0002 confirmado e\
\ 32 cenários distintos passaram."
evidence:
- "ART-0008"
updatedAt: "2026-11-22T13:16:27.036583Z"
- id: "TSK-0009"
title: "Adaptar verificação, status e contexto ao SQLite"
description: "Integrar VerificationService, CompatibilityService e projeções da\
\ CLI ao backend. Montar status, next-actions, context e readiness com consultas\
\ necessárias e resultados reutilizados na invocação; preservar contrato público\
\ quando compatível e informar mudanças. Separar resultado histórico com anexo\
\ descartado legitimamente de validação ativa. Manter diagnóstico de reparo e\
\ ausência de transições de estado em consultas."
acceptanceCriteria:
- "Consultas e contexto em processos novos preservam informações e autoridade e\
\ não promovem, migram ou concluem registros por leitura."
- "Anexos descartados legitimamente não invalidam histórico; corrupção e referê\
ncias ausentes não são tratadas como gates satisfeitos."
- "Caminhos selecionados não repetem varreduras/validações globais sem necessidade;\
\ saída e códigos de erro compatíveis são verificados."
dependsOn:
- "TSK-0004"
- "TSK-0005"
- "TSK-0006"
- "TSK-0008"
status: "COMPLETED"
result: "Consultas e verificação usam SQLite e snapshots consistentes; 15 testes\
\ focados passaram e compatibilidade legada preservada."
evidence:
- "ART-0009"
updatedAt: "2026-11-22T13:23:23.962895Z"
- id: "TSK-0010"
title: "Implementar migração explícita e recuperável do legado"
description: "Criar comando público de prévia e aplicação da migração, sem conversã\
o em leituras ou atualização do instalador. Usar base de preparo e cópia de seguranç\
a da conversão, importação tipada transacional e verificação contra o corpus.\
\ Preservar IDs, conteúdo, aprovações, hashes, revisões e proveniência histórica\
\ sem despejar arquivos no banco. Ativar somente após sucesso; repetir ou recuperar\
\ interrupção sem duplicar. Executar apenas em fixtures/cópias descartáveis."
acceptanceCriteria:
- "Prévia não modifica o projeto; aplicação compara registros/contexto e ativa a\
\ base somente após validação completa."
- "Fixtures históricas, recibos, aprovações e referências preservam identidade/proveniê\
ncia; execução repetida não duplica conteúdo."
- "Falhas e interrupções deixam a fonte anterior recuperável e informam próxima\
\ ação; nenhum projeto real ou workspace canônico foi migrado."
dependsOn:
- "TSK-0001"
- "TSK-0009"
status: "ACTIVE"
result: "Implementar prévia, migração explícita, comparação e recuperação somente\
\ em fixtures descartáveis."
evidence: []
updatedAt: "2026-11-22T13:23:38.291996Z"
- id: "TSK-0011"
title: "Atualizar init, descoberta e contrato de compatibilidade"
description: "Inicializar projetos locais em SQLite e deixar .ai-engineering ignorado\
\ pelo Git por padrão sem exigir Git. Preservar regras preexistentes e instruç\
ões fora do bloco gerido. Declarar backend e versões no contrato público, atualizar\
\ diagnóstico/onboard e evitar que base SQLite seja interpretada como workspace\
\ vazio por combinação incompatível. Manter tratamento explícito de projetos legados\
\ e previamente rastreados."
acceptanceCriteria:
- "Init cria projeto funcional sem Git, com estado local ignorado por padrão e bootstrap\
\ suficiente para humanos e agentes."
- "Reexecução preserva conteúdo/regras; não remove arquivos já rastreados nem converte\
\ legado automaticamente."
- "Versões e backend incompatíveis são recusados com diagnóstico acionável antes\
\ de escrita; documentação/entrypoints não induzem uso de CLI incompatível."
dependsOn:
- "TSK-0009"
- "TSK-0010"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:28.841960Z"
- id: "TSK-0012"
title: "Preparar pacote nativo e instalador conjunto sem ativação"
description: "Evoluir build/distribuição e scripts/install-native.sh para empacotar\
\ AIE nativo, biblioteca SQLite do driver e CLI sqlite3 num diretório configurá\
vel, com atalhos aie/ai-engineering e dados de projeto separados. Fixar componentes/plataformas\
\ e verificar pacote antes de ativação, preservando versão anterior em falhas.\
\ Testar instalador com ferramentas simuladas e destinos descartáveis; smoke usa\
\ build local. Não executar instalação real nem tocar ~/.local/bin ou dependê\
ncias ativas."
acceptanceCriteria:
- "Pacote contém componentes corretos e o build nativo acessa uma base descartá\
vel sem depender da instalação global."
- "Fixtures verificam diretórios configuráveis, atalhos, atualização conjunta e\
\ falha sem danificar instalação anterior simulada."
- "Nenhum binário, biblioteca ou atalho ativo é substituído e o instalador real\
\ não é executado; a ativação posterior continua dependente de instrução humana."
dependsOn:
- "TSK-0002"
- "TSK-0011"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:37.290314Z"
- id: "TSK-0013"
title: "Consolidar documentação e instruções do framework local"
description: "Atualizar README, docs de arquitetura/protocolo/compatibilidade/migraç\
ão e recursos de entrada para memória local, SQLite, gates e retenção mínima.\
\ Explicar anexos temporários, outputs entregues, migração explícita e recuperaç\
ão, pacote preparado e instalação adiada. Remover instruções que apresentem arquivos\
\ de Works como fonte principal nova ou Git como exigência. Preservar orientaç\
ões dos dois ciclos, OODA, DEC/Plan e aprovações."
acceptanceCriteria:
- "Documentação e recursos distribuídos descrevem o mesmo contrato e permitem inicializar/retomar\
\ um projeto sem Git."
- "Procedimento público de migração explica prévia, efeitos e recuperação sem depender\
\ de inspeção do código interno."
- "Limites de retenção e instalação, papel dos gates e recortes futuros estão claros;\
\ fontes e exemplos não alegam testes ou migrações reais não executados."
dependsOn:
- "TSK-0010"
- "TSK-0011"
- "TSK-0012"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:45.331995Z"
- id: "TSK-0014"
title: "Executar regressão integrada e encaminhar responsividade ao WRK-000C"
description: "Integrar as verificações das etapas e executar gates apropriados de\
\ testes/arquitetura, migração, concorrência e smoke JVM/nativo em ambientes descartá\
veis. Revisar continuidade e autoridade nos dois ciclos, anexos temporários, recuperaç\
ão e funcionamento sem Git. Consolidar resultados mínimos, resolver experimentos/preocupaç\
ões e entregar cenário reproduzível ao WRK-000C com comandos, versão, dados e\
\ ambiente. Não instalar o pacote nem declarar resolvido o atraso."
acceptanceCriteria:
- "Suíte relevante de domínio/integração/compatibilidade, fixtures do instalador\
\ e smoke nativo passam ou impedimentos são tratados antes da conclusão."
- "Falhas, rollback, concorrência, legado, gates e descarte legítimo foram verificados\
\ com resultados reais e sem alteração da instalação ativa ou consumidores."
- "Todos os steps e critérios da DEC estão satisfeitos, sem experimentos/preocupaç\
ões pendentes; WRK-000C recebe cenário para medição futura e permanece aberto."
dependsOn:
- "TSK-0013"
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-22T11:53:53.421052Z"
status: "ACTIVE"
author: "Codex"
createdAt: "2026-11-22T11:52:06.993736Z"
revision: 41
previousHash: "6d5f8ba4831db9324b1c4e6ff4f6bf283dca6ef081bd981814c1a21b1e311878"
updatedAt: "2026-11-22T13:38:19.181502Z"
updatedBy: "Codex"
changeReason: "Prova concluída somente com fixtures temporárias."
experiments:
- id: "EXP-0001"
stepId: "TSK-0002"
hypothesis: "SQLite JDBC pode criar, persistir e reabrir uma base em processos JVM\
\ e Native Image com biblioteca distribuída ao lado do executável."
successCriterion: "As duas formas executam create/read/write/reopen e rollback em\
\ diretório descartável; o nativo usa a biblioteca do pacote com extração temporá\
ria indisponível; nenhum binário ativo ou consumidor é alterado."
invocation: "./gradlew sqliteProbeClasses nativeSqliteProbeCompile; scripts/sqlite-probe.sh\
\ <build>; execução da classe de prova JVM e do binário de build em processos\
\ distintos"
retryOf: null
reconsideration: null
by: "Codex"
createdAt: "2026-11-22T12:10:00.110720Z"
outcome: "CONFIRMED"
observation: "JVM criou e reabriu a base com UTF-8 e rollback. Native Image GraalVM\
\ 25 criou e reabriu em processos independentes com biblioteca externa e extraç\
ão sem escrita; a cópia isolada sem biblioteca falhou."
interpretation: "Driver SQLite JDBC 3.54.1.0 e biblioteca distribuída ao lado do\
\ nativo funcionam na plataforma macOS arm64. Seleção inicial de JDK foi corrigida\
\ explicitamente; sem instalação real."
nextAction: "Implementar infraestrutura transacional e esquema local no TSK-0003."
evidence:
- "ART-0002"
questionsDecision: null
finishedAt: "2026-11-22T12:16:43.109268Z"
finishedBy: "Codex"
- id: "EXP-0002"
stepId: "TSK-0008"
hypothesis: "Anexos temporarios podem ser descartados apos a conclusao sem perder\
\ resultados historicos ou aceitar entradas ausentes em novos checks."
successCriterion: "Fixtures confirmam retencao durante checks, limpeza apos commit,\
\ rollback sem apagar entradas, recuperacao de descarte interrompido e recusa\
\ de evidencia perdida ou aposentada em avaliacao atual."
invocation: "./gradlew test --tests *SqliteArtifactLifecycleTest --tests *SqliteCoordinationTest\
\ --tests *SqliteQualityGatesTest"
retryOf: null
reconsideration: null
by: "Codex"
createdAt: "2026-11-22T13:12:55.720771Z"
outcome: "CONFIRMED"
observation: "Fixtures passaram retenção durante checks, descarte após commit, rollback\
\ e recuperação de interrupções; entrada perdida ou aposentada não satisfaz avaliaç\
ão atual."
interpretation: "Resultado estruturado e estado de descarte permitem retenção mí\
nima sem enfraquecer entradas obrigatórias. Originais legados preservados."
nextAction: "Integrar consultas, verificação e compatibilidade ao backend SQLite\
\ no TSK-0009."
evidence:
- "ART-0008"
questionsDecision: null
finishedAt: "2026-11-22T13:16:14.087721Z"
finishedBy: "Codex"
- id: "EXP-0003"
stepId: "TSK-0010"
hypothesis: "Migracao explicita com base preparada e originais preservados conserva\
\ hashes e autoridade, e recupera falhas sem duplicar dados."
successCriterion: "Corpus legado e Works ativos preservam DTOs, hashes, aprovacoes\
\ e historicos; fixtures interrompidas retomam ou revertem com seguranca; escrita\
\ nova impede rollback destrutivo."
invocation: "./gradlew test --tests *StorageMigrationTest --tests *CompatibilityTest\
\ --tests *SqliteQueriesTest"
retryOf: null
reconsideration: null
by: "Codex"
createdAt: "2026-11-22T13:28:47.295494Z"
outcome: "CONFIRMED"
observation: "Após corrigir presença de listas nulas e limpeza de staging, 34 testes\
\ finais passaram; cinco fronteiras recuperadas e hashes históricos preservados."
interpretation: "Importação tipada com fontes externas e ativação protegida conserva\
\ autoridade e permite recuperação sem duplicação; novas gravações impedem rollback\
\ com perda."
nextAction: "Consolidar init SQLite e contrato de armazenamento local no TSK-0011."
evidence:
- "ART-0010"
questionsDecision: null
finishedAt: "2026-11-22T13:38:19.181293Z"
finishedBy: "Codex"
documentVersion: 2
---
# Implementar memória de engenharia local em SQLite
## Autoridade e objetivo
Executar a DEC-0001 do WRK-000D, aceita explicitamente por Nilton nesta conversa.
O resultado é um framework local de memória de engenharia por Work, com SQLite
por projeto, investigação e implementação orientadas por OODA, gates preservados,
anexos temporários e retenção mínima. A aprovação desta DEC mantém a instalação
real adiada.
Este Plan foi solicitado com decomposição em vários steps. Todos os steps começam
OPEN; a criação do Plan não constitui execução ou comprovação de resultado.
## Limites obrigatórios
- Não instalar nem substituir o AIE, SQLite, bibliotecas ou atalhos em uso.
- Não executar o instalador real contra HOME, ~/.local/bin ou outro destino ativo.
Sua validação usa fixtures com ferramentas simuladas e destinos descartáveis.
- Não migrar este workspace canônico ou projetos consumidores. Exercitar o novo
backend e a migração em fixtures e cópias descartáveis; ativação real depende de
instrução humana posterior específica.
- Preservar alterações preexistentes, IDs, conteúdo e proveniência legada,
aprovações, evidências históricas e instruções do projeto fora do bloco gerido.
- Não introduzir arquivos em BLOB/base64 ou TEXT equivalente, retenção extensa,
executor autônomo de repositório, colaboração distribuída ou integração Git LFS.
- Importação/exportação de Works/DECs e backup como funcionalidade ficam fora.
A cópia de segurança da migração é parte da recuperação da conversão.
- Código e outputs solicitados permanecem nos destinos de entrega apropriados.
- O WRK-000C permanece aberto para avaliar e tratar latência após esta mudança.
## Execução e dependências
Os 14 steps possuem dependências explícitas e critérios próprios. Mapear primeiro
o contrato e o legado; provar a integração SQLite/JVM/Native Image; depois construir
as transações e migrar os fluxos de domínio. Integrar gates e ciclo dos anexos antes
de consolidar as consultas, a migração pública e o bootstrap. Preparar distribuição
e documentação e concluir com regressão integrada e encaminhamento ao WRK-000C.
Não iniciar um step com dependências pendentes. Verificações focadas fazem parte
de cada mudança; a última etapa integra os cenários e não substitui essas verificações.
Steps independentes podem ser executados em ordem compatível, sem presumir
autorização de delegação ou de instalação real.
## OODA e incertezas
Nas provas relevantes, principalmente driver/nativo, migração e descarte de anexos,
registrar hipótese, critério de sucesso e invocação antes de executar. Registrar
observação, interpretação e próxima ação após o resultado; reconsiderar antes de
repetir uma hipótese falha. Usar os registros de experimentos do Plan quando úteis,
sem impor um ritual de quatro fases a toda alteração.
Ajustar esquema, índices, transações e build dentro da DEC. Se um resultado
questionar a decisão, registrar a preocupação, continuar investigações autorizadas
e rever a DEC com aprovação aplicável antes da execução afetada.
## Verificação e registro mínimo
Durante a execução deste Work, respeitar o protocolo que está em uso. Registrar
resultados reais e evidência mínima necessária para completar os steps; não usar
a futura política de limpeza para apagar evidências legadas ou simular gates.
Verificar continuidade entre processos, integridade referencial, rollback,
concorrência local com espera limitada, autoridade humana, gates e anexos
temporários, migração repetível e operação sem Git. Provas nativas usam somente
artefatos de build e projetos descartáveis.
Comandos candidatos à validação, ajustados ao resultado e ao código final:
- `./gradlew test` e `./gradlew check` para a suíte e arquitetura do projeto.
- `python3 scripts/test-install-native.py` para fixtures do instalador.
- `./gradlew nativeCompile` e tarefas de distribuição para construir o pacote.
- `bash scripts/native-smoke.sh <caminho-absoluto-do-build>` em projetos descartáveis.
Esses comandos são planejados, não executados na criação do Plan. Preservar os
gates específicos do projeto e adicionais do Work definidos na execução. Logs de
trabalho podem ser temporários; guardar na memória somente o necessário ao contrato.
## Conclusão
Todos os steps obrigatórios devem satisfazer seus critérios, com a DEC aceita e
sem experimentos ou preocupações pendentes. A entrega é código, documentação,
pacote preparado e resultados de verificação. Não depende de instalar a nova
versão no ambiente em uso. Encaminhar ao WRK-000C um cenário reproduzível com
comandos, versão, volume e ambiente, sem declarar resolvido o problema de atraso.

Some files were not shown because too many files have changed in this diff Show More