open-index/open-npm huggingface dataset:
npm package: @prisma_labs/atlas
Description: Repo-owned evidence toolkit for canonical product surfaces.
Latest version: 0.1.2

# Atlas

Atlas is a repo-owned evidence toolkit for canonical product surfaces.

Published consumer package:
- `@prisma_labs/atlas`

It is built for two first-class users:
- agents that need a cheap machine-readable index of screens, flows, and provenance
- humans that need a static browser of the product without manually running the app

Wave 1 modules:
- `core`
  schema, run-report contract, promotion/sweep lifecycle, provenance, drift
- `ui`
  static canonical screen evidence
- `flow`
  multi-step journey evidence, keyframes, contact sheets, poster frames, raw video/log refs
- `viewer-react`
  reusable browser for dense gallery browsing and relationship tracing
- `cli`
  stable commands for validation, render, promotion, sweep, and viewer build

This repo is the authoritative home for Atlas contracts, architecture, and adoption docs. Consumer repos keep only app-specific registry entries, capture wrappers, generated outputs, and operational policy.

Start here:
- [AGENT_ADOPTION.md](/Users/vabole/repos/atlas/AGENT_ADOPTION.md)
- [docs/ARCHITECTURE.md](/Users/vabole/repos/atlas/docs/ARCHITECTURE.md)
- [docs/OWNERSHIP.md](/Users/vabole/repos/atlas/docs/OWNERSHIP.md)
- [atlas/README.md](/Users/vabole/repos/atlas/atlas/README.md)

Preferred local commands:

```bash
bun install
bun run atlas:bootstrap
bun run atlas:test:core
bun run atlas:test:viewer-graph
bun run atlas:test:viewer-helpers
bun run atlas:test:viewer-build
bun run atlas:test
bun run atlas:validate
bun run atlas:render-index
bun run atlas:build-viewer
bun run check
```

Consumer install:

```bash
npm install --save-dev @prisma_labs/atlas
```

Consumer repos should depend on the published package by default. Use this repo
as the source of truth for Atlas development, contracts, docs, and releases.

Viewer source of truth:
- `atlas/viewer/src/`
- `atlas/viewer/dist/` is generated output and must not be edited directly
- consumer repos should rebuild viewer assets instead of patching bundled `dist` files by hand

Primary env/config surface:
- `ATLAS_PROJECT_ROOT`
- `ATLAS_ROOT`
- `ATLAS_VIEWER_SRC_ROOT`
- `ATLAS_VIEWER_TITLE`
- `ATLAS_VIEWER_DESCRIPTION`
- `ATLAS_DEVICE_INSTALL_SCRIPT`
- `ATLAS_SKIP_PUSH_CHECK`

Atlas assumes consumer registry entries provide `captureCommand` values that emit the run-report JSON contract consumed by the promotion and sweep scripts.

For device-sensitive flows, Atlas also ships:
- `scripts/observe-device-flow.sh`
- `scripts/install-connected-devices.sh` as a placeholder adapter

Consumer repos are expected to provide or override the device installer with app-specific logic.