spec/examples/README.md

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	Happy path — clean PET bottle correctly routed to NYC blue bin. No guardrail; no fallback.
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	A6 save — model proposed general_waste for a contaminated diagnostic; guardrail overrode it.
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	Laptop routed to the SAFE Disposal e-waste collection event.
passport-06-cd-concrete-with-recovery-value.json	Construction & Demolition — concrete chunk with economic + environmental value.
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