# WRK-0007 — levantamento do Discussion Framework

Coleta realizada em 2026-11-16. O importer ainda não foi implementado nem executado.

## Origem e escopo verificados

- Repositório: `/Users/niltonconstantino/personal/workspace.personal/intrepid/discussion-framework`, equivalente a `../../intrepid/discussion-framework` a partir do workspace AIE atual. O caminho informado com apenas `../` não existe nesse workspace.
- Branch local: `master`; commit: `658d58e864f3f990e3e2e9b42ebd1a083a1b2221`.
- Distribuição Python `discussion-framework`, versão declarada `0.1.0`, Python >=3.11, sem dependência externa de execução declarada.
- Inspecionados README, pyproject.toml, todos os módulos de `src/discussion_framework` e `tests/test_cli.py`.
- Apenas o checkout local foi inspecionado; não houve fetch nem consulta remota.
- A origem já tinha `.DS_Store` e `src/.DS_Store` não rastreados. Todos os arquivos-fonte selecionados permaneceram com os mesmos SHA-256 antes/depois. Nenhum comando de mutação foi executado contra a origem.

## Esclarecimento humano sobre a umbrella

O usuário esclareceu: “nao existe multiprojeto no DF, o lance eh que o AIE pode ter varios projetos usando o DF (cada um com o seu) debaixo de sua umbrella.”

Portanto, não se procura um esquema multiprojeto dentro do DF. Cada projeto-fonte tem seu índice e sua árvore `discussion/`. A umbrella AIE reúne essas origens. Conforme ANS-0003, o Work deve descrever os targets da tarefa. Não está autorizado inventar uma configuração multiprojeto no DF ou criar automaticamente projetos AIE separados por origem.

## Contrato de armazenamento

`model.py:34` e `model.py:107`:

```text
<raiz-do-projeto>/discussion/index.ndjson
<raiz-do-projeto>/discussion/workflow/agendas/AGD-....md
<raiz-do-projeto>/discussion/workflow/decisions/DEC-....md
<raiz-do-projeto>/discussion/workflow/plans/PLN-....md
<raiz-do-projeto>/discussion/lessons/...
```

O índice UTF-8 contém um objeto JSON por linha; linhas vazias são ignoradas. O primeiro registro exige `type=meta` e contém `next_id` para DSC, AGD, DEC, PLN, LSN e CLSN. Os demais registros exigem `type=discussion`. Não há versão explícita de esquema no índice inicial.

Cada discussão tem `id`, `ticket`, `title`, `status`, datas, `tags` e arrays `agendas`, `decisions`, `plans`, `lessons`. Uma DEC indexada tem `id`, `file`, `status`, datas e `ref_agenda`. Um plano referencia decisões em `ref_decisions`. As referências ligam as DECs à discussão e aos planos relevantes; não basta varrer nomes de arquivos.

IDs e contadores são locais a cada árvore DF. Assim, duas origens podem ambas conter `DSC-0001` e `DEC-0001`: a identidade de importação precisa distinguir a origem, e a geração de IDs AIE deve seguir suas regras próprias. Esta é uma consequência do modelo, não uma política nova já aprovada.

`cli.py:173` aceita como raiz tanto o projeto quanto seu diretório `discussion/`, quando o índice existe. Não há descoberta recursiva de vários projetos nem registro de targets de projetos na CLI deste checkout.

## Conteúdo das DECs e targets

`commands.py:608` gera front matter com `id`, `ticket`, `title`, `status`, `created`, `ref_agenda`, `tags`; o corpo contém Context, Decision, Rationale, Implications, Propagation Targets e References.

Propagation Targets é prosa com categorias `specs`, `plans`, `code`, `tests`, `docs`. Isso não é um cadastro tipado de projetos/repositórios. O importer deve preservar o texto original. A descrição dos targets dos Works da umbrella precisa partir da origem e dos dados efetivamente fornecidos, preservando o requisito humano sem interpretar essas categorias como nomes de projetos.

O JSON de `inspect`/`context` é uma projeção dos metadados: não contém o corpo das DECs e não preserva campos arbitrários adicionais. Para preservar conteúdo e proveniência, é necessário ler os arquivos referenciados, além do índice. O template não é garantia de que documentos humanos usem somente aquelas seções.

## Estados: observados em código e reprodução temporária

| Etapa | Discussão | DEC | Plano |
|---|---|---|---|
| Agenda criada | open | ausente | ausente |
| DEC criada | in_progress | open | ausente |
| DEC aceita | in_progress | accepted | ausente |
| Plano criado | in_progress | accepted | open |
| Plano iniciado | in_progress | accepted | in_progress |
| Plano concluído | in_progress | accepted | done |
| Housekeeping | done | removida do índice | removido do índice |

Fontes: `commands.py:128` (add_decision), `:171` (accept_decision), `:188` (add_plan), `:231` (mark_plan), `:430` (housekeep). A tabela foi reproduzida pela CLI em dados sintéticos; o JSON da coleta registra cada etapa.

Os estados permitidos de plano são `open`, `review`, `accepted`, `in_progress`, `done`, `abandoned`. `completed` não é o literal usado por esta CLI; a conclusão usa `done`. A DEC não passa automaticamente para done quando seu plano termina. O estado in_progress da discussão começa antes da execução de um plano.

Consequência: filtrar apenas a discussão por open elimina DECs recém-criadas; filtrar apenas a DEC por accepted não distingue trabalho ainda não iniciado de trabalho concluído.

O usuário resolveu explicitamente a interpretação: “Não: importar exclusivamente DECs com status open, verificando também se a tarefa já começou ou terminou.” Portanto, accepted fica fora mesmo sem execução. O levantamento dos planos/referências serve para excluir tarefas iniciadas ou concluídas; não amplia o escopo para importar planos. Como in_progress da discussão é atribuído automaticamente na criação da DEC, esse valor isolado não prova execução de uma tarefa. A regra de leitura dos planos vinculados deve ser explicitada no desenho, incluindo vínculos ausentes ou contraditórios, sem presumir elegibilidade em dados ambíguos.

## Validação e preservação

`validation.py:16` verifica estrutura básica do índice, duplicação global de IDs dentro da origem, contadores, existência de arquivos exigidos e arquivos de workflow órfãos. Discussões done podem referenciar arquivos já removidos; housekeeping remove arquivos e esvazia os arrays de workflow.

Dois probes sintéticos mostraram que o validador retorna zero erros tanto quando o status no front matter diverge do índice quanto quando `ref_agenda` aponta para AGD inexistente. Logo, passar no validate do DF não prova consistência entre o conteúdo e o índice nem integridade dos vínculos.

Pontos técnicos a cobrir no desenho do importer, sujeitos à decisão de implementação: validar caminhos dentro da origem, campos/estados conhecidos, vínculos e divergências; preservar conteúdo e identificação de origem; distinguir colisões entre origens; associar reimportação à origem e ao conteúdo; verificar mudanças entre prévia e aplicação. Bloquear lotes inválidos e não sobrescrever em reimportações seguem as respostas humanas registradas. Preservar a origem é uma recomendação de desenho e foi respeitado nesta coleta.

## Verificações executadas

- Copiados somente arquivos selecionados do repositório para diretório temporário.
- Executado na cópia: `python3 -B -m unittest discover -s tests -v` — 9 testes passaram, incluindo concorrência na alocação de planos.
- Exercitado fluxo completo init → agenda → DEC open → DEC accepted → plano open → in_progress → done → housekeeping, somente em dados descartáveis.
- Reproduzidos os dois limites de validação descritos acima.
- Manifesto SHA-256 dos arquivos selecionados e estados coletados em `inspection.json`; log da suíte em `upstream-tests.log`; script de reprodução em `wrk7-inspect-discussion.py`.

## Próximo refinamento

Com os esclarecimentos sobre umbrella e filtro, o layout das origens e a seleção de produto estão identificados. Próximo passo: preparar o contrato de importação com fixtures de duas origens independentes, IDs coincidentes e casos de execução vinculada. Não foi feita importação em projeto consumidor real. Nada neste relatório aprova escolhas adicionais de implementação ou conclui o WRK-0007.
