Promote referenced drafts deterministically with system provenance, causal Plan links, supersession history and recovery from publication failures. Preserve direct human approval and historical records. Add JVM and native regression coverage and update the portable protocol. Record the WRK-0007 importer decision and six-step plan, and complete WRK-0008 with verification evidence.
8.2 KiB
schemaVersion, id, workId, title, context, approach, alternatives, rationale, risks, acceptanceCriteria, approvalStatus, author, createdAt, evidence, revision, previousHash, updatedAt, updatedBy, changeReason, approvals, revises, supersededBy, documentVersion
| schemaVersion | id | workId | title | context | approach | alternatives | rationale | risks | acceptanceCriteria | approvalStatus | author | createdAt | evidence | revision | previousHash | updatedAt | updatedBy | changeReason | approvals | revises | supersededBy | documentVersion | ||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 1 | DEC-0001 | WRK-0007 | Importar DSCs com agendas abertas preservando conteúdo e proveniência | Migrar discussões com AGDs open de uma ou várias origens DF independentes sob a umbrella AIE, com um Work por DSC. Escopo e recomendações explicitamente refinados com o usuário. | Importação determinística sem LLM, preservação integral e originais como evidência, identidade origem + DSC, targets no Work, prévia explicada e reimportação sem sobrescrita. | Preservar a unidade e o conteúdo das discussões, distinguir IDs locais entre projetos e permitir seleção e reimportação verificáveis. | ACCEPTED | codex | 2026-11-16T11:36:24.986836Z |
|
2 | 985cf64780706a0dcd286e8093912a49f34d033b6339f91b218e473e471673d1 | 2026-11-16T11:41:26.102091Z | user | O usuário pediu gerar o Plan a partir da DEC-0001 e esclareceu explicitamente que esse pedido aprova a DEC, que não deve continuar DRAFT. Aprovação registrada antes da criação do Plan vinculado. |
|
null | null | 2 |
Importar DSCs com agendas abertas do Discussion Framework
Contexto
O AI Engineering precisa receber discussões ainda abertas de projetos que usam o Discussion Framework (DF). Uma umbrella AIE pode abranger vários projetos, cada um com sua própria árvore discussion/ e seus próprios IDs locais.
O objeto de importação é a DSC, com somente suas agendas AGD em estado open. A correção explícita do usuário substitui o escopo inicial de importar DECs. A coleta local identificou o índice NDJSON, os arquivos Markdown e os limites do validador DF; ART-0001 a ART-0006 preservam os fatos e a evolução do escopo.
O usuário aprovou seguir as recomendações de preservar conteúdo integral, identificar origem + DSC, explicar a seleção na prévia, validar duas origens com IDs repetidos e manter a primeira versão determinística, sem LLM. Esta DEC consolida essas escolhas para orientar a implementação.
Decisão
1. Seleção de DSCs e agendas
Ler discussion/index.ndjson de cada projeto-fonte e selecionar registros type=discussion com pelo menos uma entrada no array agendas cujo estado seja open. Importar somente as AGDs abertas dessa discussão, lendo seus arquivos em discussion/workflow/agendas/.
Uma DSC sem agenda aberta não gera Work. A condição open aplica-se à AGD; o estado agregado da DSC não substitui essa condição. Não é necessário existir DEC nem seguir ref_agenda de uma DEC para localizar as agendas.
Criar um Work AIE em estado OPEN por DSC de origem, agrupando nele todas as suas agendas abertas. Não importar DECs, planos ou conclusões históricas como novos artefatos de decisão, execução ou entrega.
2. Preservação de conteúdo e proveniência
Preservar integralmente o conteúdo das agendas selecionadas no espaço de refinamento do Work, incluindo contexto, perguntas, opções e discussão. Manter os originais como evidência do Work, com identificação da origem, IDs e caminhos de origem e hashes dos conteúdos coletados.
A importação não resume nem reinterpreta as agendas. A presença de perguntas, recomendações ou campos de resolução na origem não cria automaticamente respostas humanas, aprovações ou decisões AIE. O refinamento poderá ocorrer depois, dentro do Work.
Manter os arquivos dos projetos-fonte intactos.
3. Umbrella, identidade e targets
Tratar cada árvore DF como uma origem independente sob a umbrella AIE. Identificar a discussão importada pela combinação da identidade do projeto-fonte com o ID da DSC, preservando também a identificação de cada AGD dentro dessa origem.
IDs como DSC-0001 e AGD-0001 podem repetir entre origens. A importação deve distingui-los e gerar IDs AIE pelo mecanismo normal do destino.
Descrever no Work os targets da tarefa, preservando os dados e referências efetivamente disponíveis na origem e na associação do projeto-fonte à umbrella. Não inventar um esquema multiprojeto no DF nem criar automaticamente um projeto AIE separado para cada origem.
4. Prévia e validação
Antes de aplicar a importação, apresentar quais origens foram lidas, quais DSCs gerarão Works, quais AGDs serão incluídas e quais itens foram ignorados, com seus motivos. Apresentar erros, colisões e divergências de forma associada aos IDs e arquivos afetados.
Verificar os arquivos referenciados e a consistência entre índice, front matter e vínculos relevantes. Uma divergência entre índice e Markdown deve ser diagnosticada; não se escolhe silenciosamente a representação que permita importar o item.
Lotes com dados inválidos ou referências não resolvidas ficam bloqueados até a resolução dos erros. A validação do DF, isoladamente, não substitui essas verificações: os probes da coleta demonstraram divergências e referências quebradas que ela não detecta.
5. Reimportação
Usar identidade de origem + DSC e os registros de proveniência para reconhecer importações anteriores. Conteúdo idêntico não cria Works duplicados nem duplica agendas ou evidências no Work existente.
Alterações ou colisões devem ser apresentadas para revisão. Não sobrescrever conteúdo importado ou refinado no AIE, não criar revisões silenciosas e não excluir conteúdo previamente importado porque a origem mudou de estado.
6. Implementação determinística
A primeira versão usa leitura, seleção, validação, identificação e publicação determinísticas, sem chamadas a LLM. O conteúdo é preservado na importação e refinado posteriormente pelos mecanismos normais do AIE.
Justificativa
Um Work por DSC preserva a unidade da discussão e evita fragmentação quando há várias agendas abertas. A identidade composta permite reunir projetos com contadores locais iguais. Preservar os originais e o conteúdo integral mantém rastreabilidade e evita perder perguntas ou alternativas durante a migração.
A prévia torna a seleção verificável antes de gravar os Works. O comportamento conservador na reimportação protege o refinamento feito no destino. A execução determinística permite reproduzir e testar os resultados sem interpretação de modelo.
Critérios de verificação da implementação
- Uma origem simples importa apenas DSCs com AGDs open e preserva integralmente cada agenda selecionada e sua evidência original.
- Duas origens independentes sob a umbrella, com IDs DSC/AGD coincidentes, geram Works distintos e targets de origem identificáveis.
- Uma DSC com várias agendas gera um Work contendo somente as AGDs open; agendas review, accepted, done ou abandoned ficam fora. Uma DSC sem AGD open não gera Work.
- A seleção não exige DEC e não usa o estado da DSC como substituto do estado das agendas.
- A prévia explica itens incluídos e ignorados. Arquivos ausentes, referências inválidas e divergências entre índice e Markdown bloqueiam o lote.
- Uma segunda importação idêntica não altera ou duplica o conteúdo anterior. Mudanças e colisões são reportadas sem sobrescrita.
- Arquivos-fonte permanecem intactos e nenhuma chamada a LLM é necessária para importar.
Referências
- WRK-0007: objetivo, restrições e critérios atuais.
- SVY-0001: respostas humanas e histórico de refinamento; interpretar conforme a correção de escopo da DSC-0008.
- DSC-0008 e ART-0006: escopo corrente de DSCs com agendas abertas.
- DSC-0009: solicitação humana de seguir as recomendações e gerar esta DEC.
- ART-0001 a ART-0005: levantamento técnico e correções históricas; regras antigas sobre importar DECs foram substituídas.
- Aprovação explícita das recomendações pelo usuário nesta sessão: “vamos seguir as recomendacoes, podemos gerar uma DEC?”