Importação de Código

Spec §10 / §21.3.2: uma execução de migração de código / tune-collab começa de um repositório real (clonado via od project import ou um caminho fornecido pelo usuário). Este átomo transforma o checkout bruto em um registro normalizado no disco que átomos subsequentes (design-extract, rewrite-plan, patch-edit) operam. O objetivo é parar de percorrer a árvore a cada turno — o agente lê code/index.json uma vez e confia no snapshot até a próxima reimportação explícita.

Entradas

Saída

project-cwd/
└── code/
    ├── index.json         # { files: { path, size, language, imports[] }[], packageJson?, lockfileKind, framework, styleSystem }
    ├── components.json    # detected components with file path + props snapshot
    ├── routes.json        # detected routing model (next/app, react-router, vite-router, …)
    └── meta.json          # { repoPath, gitSha, walkedAt, atomDigest, walkBudgetMs }

code/index.json é a entrada que todo outro átomo da Fase 7 lê. A percorribilidade respeita a opção budgetMs do executor (padrão 60s) para que monorepos grandes não queimem uma execução inteira na importação.

Convergência

O átomo é concluído quando code/index.json existe e contém pelo menos uma entrada. Repositórios vazios abortam com um evento de erro claro para que o usuário reimporte.

Antipadrões que o fragmento de prompt proíbe

• Percorrer node_modules / .git / .next / dist / build (registro em code/index.json.skipped[] com motivo).
• Inferir um framework de um único arquivo; exigir pelo menos a dep declarada de package.json + a presença de uma configuração de build (next.config.*, vite.config.*, etc.).
• Tratar importações comentadas como arestas ativas.

Status

Implementado pelo executor daemon em apps/daemon/src/plugins/atoms/code-import.ts. O walker impõe suas exclusões e orçamento de tempo, detecta evidências de framework e grava code/index.json.