Extração do Figma

Especificação §10 / §21.3.1: o cenário de migração do Figma começa com um URL de arquivo do Figma + um token OAuth. Este átomo transforma esse par no registro autoritativo em disco em que as fases subsequentes (token-map, generate, critique) operam.

Entradas

Saída

O átomo escreve um extrato determinístico em formato JSON sob o diretório de trabalho do projeto (cwd):

project-cwd/
├── figma/
│   ├── tree.json        # canonical node tree (id / type / parent / children / box / fills / text)
│   ├── tokens.json      # color + typography + spacing tokens lifted off the file
│   ├── assets/          # rasterised exports of every leaf node that the file marks for export
│   │   └── <node-id>.<png|svg|webp>
│   └── meta.json        # { fileUrl, version, lastModified, exportedAt, atomDigest }

figma/tree.json é o pivô canônico para cada átomo downstream. figma/tokens.json é a entrada para token-map. assets/ é a entrada para a fase de mídia de generate.

Convergência

O átomo é concluído quando figma/tree.json existe e não está vazio. O avaliador until lê figma.tree.nodes >= 1; se o arquivo Figma estiver vazio ou o token OAuth expirado, o átomo emite um evento de erro claro e a execução é abortada (o usuário corrige a autenticação ou escolhe um arquivo diferente).

Antipadrões que o fragmento de prompt proíbe

• Sintetizar uma árvore a partir de capturas de tela quando o caminho OAuth falhou — sempre solicite novamente ao usuário; nunca invente IDs de nó.
• Ignorar tipos de nó não suportados silenciosamente; registre-os em meta.json.unsupportedNodes[] para que o humano possa auditar as lacunas.
• Tratar instâncias de componentes como duplicatas; registre os links componentRef para que token-map possa desduplicar no limite correto.

Status

Implementado pelo daemon runner em apps/daemon/src/plugins/atoms/figma-extract.ts. Ele busca e percorre a árvore REST do Figma, registra nós não suportados, eleva tokens e rasteriza ativos suportados.