# Palimpsest

Address-radius neighbourhood history and colour reports for New York City.
One street address in, one cited, geo-verified report out, covering a 0.5-mile radius.

## Machine access

- Create a report: POST https://pre-build-insights.lovable.app/api/v1/reports
  body: {"address": "350 W 42nd St, New York, NY 10036", "radius_m": 805}
  returns: {"id", "slug", "status", "urls": {"html", "json", "status"}, "run_url"}
- Build a queued report: POST https://pre-build-insights.lovable.app/api/public/pipeline/run  body: {"id": "<report id>"}
- Poll status: GET https://pre-build-insights.lovable.app/api/v1/reports/{id}
- Report as HTML (server-rendered, no JavaScript needed): https://pre-build-insights.lovable.app/r/{slug}
- Report as JSON (same data): https://pre-build-insights.lovable.app/r/{slug}/json
- JSON Schema: https://pre-build-insights.lovable.app/schema.json

## Scrape contract

HTML and JSON are rendered from one document, so they cannot disagree.
Target ids and data-* attributes, never class names.

- <main id="report"> carries data-report-id, data-status, data-progress, data-lat, data-lon,
  data-radius-m, data-city, data-bbl, data-schema-version, data-generated-at.
- Each <section> carries data-section (summary, origins, timeline, treatment, vice,
  dark_history, folklore, sources), data-empty, data-fact-count.
- Each fact <li> carries data-fact-ref, data-precision, data-distance-m, data-category,
  data-folklore, data-confidence.
- Narrative paragraphs carry data-paragraph and data-fact-refs.
- <link rel="alternate" type="application/json"> points at the JSON twin.
- schema.org Place + ItemList is embedded as JSON-LD.

## Guarantees and limits

- Every rendered claim has a source URL and a location-precision label:
  ADDRESS, IN_RADIUS, NEARBY or NEIGHBORHOOD. Unverifiable claims are never rendered.
- A report returns HTTP 200 with all eight sections present from the moment it is created;
  unfinished sections carry data-empty="true".
- No safety score, no neighbourhood rating, no demographic data, no victim names.
- New York City only.