specs scan crashes with "Cannot create a string longer than 0x1fffffe8 characters" on large Figma files

[emhaas]

Sub-project

cli

Problem

specs scan crashes with "Cannot create a string longer than 0x1fffffe8 characters" on large Figma files

Expected behavior

Manifest written to data/XYComponentLibrary.manifest.md

Actual behavior

Root cause (hypothesis): The CLI reads the entire .file.json payload into a single JS string before parsing. For very large files, this exceeds the V8 string length limit (~512MB). Switching to a streaming JSON parser (e.g. stream-json) or using JSON.parse on a Buffer instead of a decoded string would fix this.

Steps to reproduce

• Configure a source pointing to a large Figma component library XYComponentLibrary
• Run specs fetch --only XYComponentLibrary --no-geometry — download succeeds (file is ~500MB+ JSON)
• Run specs scan --source XYComponentLibrary

Acceptance criteria

No response

Additional context

Environment: Windows 11, Node.js v22.20.0, corporate network with TLS inspection
CLI version: 0.27.0

[nathanacurtis]

Thanks for reporting!

I've not run into this issue before since Figma files across my demos, clients, and test fixtures have not been that big. I'll look into how it may be possible to simulate this, although creating a test fixture to match may prove challenging.