# `@sitelensapi/reports`

Normalize, validate, summarize, render, and export SiteLens execution evidence. **Never** launches browsers.

**Audience:** runtime authors, CLI/MCP, and advanced integrators. Product overview: [sitelensapi.com/reports](https://sitelensapi.com/reports).

## Capabilities (0.4.1)

- Canonical `SiteLensReportV1` + manifest + portable ZIP
- Runtime validation + JSON Schema under `schemas/`
- Optional geographic capture metadata on `report.json` (public exit fields only; no proxy credentials)
- Offline HTML / Markdown (HTML on request)
- Inspect APIs: summarize, sections, failures, discovery
- Visual comparison ingest from compare sidecars
- Reporting-safe textual redaction
- Browser-safe entry: `@sitelensapi/reports/browser`

## Quick use

```ts
import {
  summarizeReport,
  getReportFailures,
  validateReport,
} from "@sitelensapi/reports";
```

## CLI (via `@sitelensapi/mcp`)

```bash
sitelens report list --json
sitelens report show --from ./runs/<id> --section failures
sitelens report render --from ./bundle --format html
```

Local viewer (no upload): [app.sitelensapi.com/tools/reports](https://app.sitelensapi.com/tools/reports)

## Privacy

Textual redaction before write/summary. Screenshot pixels are not redacted — warnings included. Local-first.