figma-extract

# Figma extract Spec §10 / §21.3.1: the figma-migration scenario starts with a Figma file URL + an OAuth token. This atom turns that pair into the authoritative on-disk record subsequent stages (`token-map`, `generate`, `critique`) operate on. ## Inputs | Source | Required | Notes | | --- | --- | --- | | Figma file URL or `node-id` | yes | Provide via the `figma-oauth` GenUI surface or `od plugin apply --input fileUrl=…` | | Figma OAuth token | yes | Routed through `oauth-prompt` with `oauth.route='connector'` and `connectorId='figma'`; the daemon never stores the token in SQLite | ## Output The atom writes a deterministic, JSON-shaped extract under the project cwd: ```text 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` is the canonical pivot for every downstream atom. `figma/tokens.json` is the input to `token-map`. `assets/` is the input to `generate`'s media stage. ## Convergence The atom completes when `figma/tree.json` exists and is non-empty. The `until` evaluator reads `figma.tree.nodes >= 1`; if the figma file is empty or the OAuth token expired, the atom emits a clear error event and the run aborts (the user fixes auth or picks a different file). ## Anti-patterns the prompt fragment forbids - Synthesising a tree from screenshots when the OAuth path failed — always re-prompt the user; never make up node ids. - Dropping unsupported node types silently; record them in `meta.json.unsupportedNodes[]` so the human can audit gaps. - Treating component instances as duplicates; record `componentRef` links so `token-map` can de-duplicate at the right boundary. ## Status Implemented by the daemon runner in `apps/daemon/src/plugins/atoms/figma-extract.ts`. It fetches and walks the Figma REST tree, records unsupported nodes, lifts tokens, and rasterizes supported assets.