| # 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 |
| |
