terrain-scout

Contract-only intake extractor for a terrain skin. Runs locally in your repository. Your source code never leaves your machine.

npx terrain-scout --key <intake-key>

What it uploads

• Schema shapes (Prisma models, SQL CREATE TABLE DDL, model field names)
• Endpoint signatures (POST /api/orders — route and method, never the handler)
• Type/interface/enum declarations
• UI vocabulary (the labels your interface already shows its users)
• A two-level directory outline, your README's opening, dependency names

What it never uploads

Function bodies, implementation code, credentials, data, file contents. Extraction happens on your machine; only the shapes above are sent.

Trust, verifiable

The full artifact is written to .terrain-scout/artifact.json before anything is uploaded — open it and read exactly what would leave. Nothing is sent until you confirm (or pass --yes). --dry-run extracts without uploading at all.

npx terrain-scout [dir]              # extract + confirm + upload
  --key <key>        intake key from your studio contact (or TERRAIN_SCOUT_KEY env)
  --note "..."       optional color: what piles up, what you wish you could see
  --dry-run          extract locally, upload nothing
  --yes              skip the confirmation prompt
  --server <url>     override the intake server

After upload you get back the domain brief — what the studio understood about your operation from the shapes alone. If it reads wrong, say so; the brief drives the design.

Node 18+. Zero dependencies.