`elite-dangerous-planet-analyser`¶

Audience: Agent

Headless HTTP service — no hosted UI. Accepts a StellarForge id64 and/or partial planet facts; returns exploration scan credit breakdown and optional lifeform predictions.

Stack¶

Bun + Elysia in api/. Depends on @howfe/stellar-forge-helper, @howfe/elite-dangerous-event-types.

API¶

GET /health — liveness ({ status: 'ok' }).

POST /v1/analyze — JSON body:

bodyId (optional) — id64 decimal string
planet (optional) — partial scan/discovery fields; at least one of bodyId or planet required. You can omit top-level bodyId when planet includes systemAddress + bodyId (game body index).
options.includeLifeforms — bio prediction

Response (high level): merged planet facts (input + SPANSH when fetched), scanValues (honk / FSS / DSS credit lines), optional lifeforms with exobiologyFirstSale heuristic — see api/src/types.ts and project README.md.

Scan credits¶

Payout matrix transcribed from Explorer § Scan Values (Fandom wiki, Beyond 3.3). See DOC_CONVENTIONS.md and curated data from other Elite Dangerous tools.

Bonuses suppressed when body is already discovered, mapped, or has confirmed exobiology on SPANSH.

Lifeforms¶

Spawn rules: SrvSurvey bio-criteria (vendored JSON + TypeScript evaluator in repo). Attribution: elite-dangerous-planet-analyser/api/src/bio/SOURCES.md.
Sale values: Vista Genomics § Sale value (Fandom wiki, transcribed to bioSaleValues.json).

External data¶

SPANSH body/system lookups only via https://api-cache.howfe.org?url=... (server-side).

Runtime URL¶

Usage	Default
Deployed API	`https://edpa.howfe.org` (Traefik — `README.md` and `docker-compose.yaml` in the app repository)

Run locally¶

cd elite-dangerous-planet-analyser/api
bun install
bun run dev

Agent notes¶

Not a Tauri app; not an embeddable hosted UI — no HOSTED_APP_CONTRACT manifest required for v1.
Golden tests may compare totals loosely to SPANSH estimates; SPANSH is not authoritative for payout math.

elite-dangerous-planet-analyser¶