# Matter Passport — Example Library

Reference Passports produced by running the **real MIE pipeline** (validator → calibration → hazard auto-flagger → do_not guardrail) on synthetic model outputs designed to exercise each platform primitive. Every file in this directory is schema-valid against `spec/matter-passport-v0.1.schema.json`. Released CC0-1.0 alongside the schema.

Volatile fields (timestamp, content_hash, passport_id) are stabilized to deterministic placeholders so the files are stable under git.

| File | Demonstrates |
|---|---|
| [`passport-01-domestic-pet-bottle.json`](passport-01-domestic-pet-bottle.json) | Happy path — clean PET bottle correctly routed to NYC blue bin. No guardrail; no fallback. |
| [`passport-02-medical-sharps-hazards-auto-flagged.json`](passport-02-medical-sharps-hazards-auto-flagged.json) | A6 regression — model emitted only sharps_injury_risk; the auto-flagger appends biohazard. |
| [`passport-03-medical-glucose-strip-guardrail-fires.json`](passport-03-medical-glucose-strip-guardrail-fires.json) | A6 save — model proposed general_waste for a contaminated diagnostic; guardrail overrode it. |
| [`passport-04-ev-18650-cell.json`](passport-04-ev-18650-cell.json) | EV cell with state-of-health estimate and class-implied thermal_runaway_risk auto-flag. |
| [`passport-05-ewaste-laptop.json`](passport-05-ewaste-laptop.json) | Laptop routed to the SAFE Disposal e-waste collection event. |
| [`passport-06-cd-concrete-with-recovery-value.json`](passport-06-cd-concrete-with-recovery-value.json) | Construction & Demolition — concrete chunk with economic + environmental value. |
| [`passport-07-textile-denim.json`](passport-07-textile-denim.json) | Higg-MSI-aligned taxonomy — denim routed to fiber recycler (Cotton Inc Blue Jeans Go Green). |

## How these were generated

```
uv run python scripts/generate_example_passports.py
```

The script runs each scenario's synthetic model output through the actual
`matter.engine.MIE` pipeline. Anything that lands in these files is exactly
what consumers would see from a real runtime — so you can use them as fixtures
for SDK tests, UI mockups, or downstream validators.

## Decision references

- D012 — JSON + enum validator
- D015 — calibration (`spec/calibration_v1.json`)
- D018 + D020 — do_not guardrail (`spec/safety_rules_v1.json`)
- D019 — class-implied hazard auto-flagger (`spec/hazard_flags_v1.json`)
- D023 — schema v0.1 frozen for CC0