# PlantAR: Permaculture AR Landscape Planner

> High-performance Progressive Web Application (PWA) with WebXR Augmented Reality, procedural 3D canopy simulations, and permaculture ecological zone validation (Zones 0–5, Type 1 Error prevention, companion guild stacking).

## Primary Interfaces
- [PlantAR WebXR Studio](https://plantar.creuzer.com/): Real-time interactive 3D/AR yard planner, 2-tap baseline orientation, mature canopy spread overlays, and QR handoff.
- [WebMCP Discovery Manifest](https://plantar.creuzer.com/.well-known/webmcp.json): Machine-readable W3C WebMCP tool specifications for autonomous and browsing agents.
- [Permaculture Plant Catalog](https://plantar.creuzer.com/data/plants.json): Seed catalog containing 6 ecological species across 5 vertical layers (Canopy, Understory, Shrub, Herbaceous, Groundcover).

## Permaculture Engine Rules & Invariants
- **Zone 0 (Foundation & Structures)**: Mandatory foundation clearance derived from mature canopy and root radii (e.g., 6.0m minimum clearance for Red Maple *Acer rubrum*).
- **Zoning (Zones 1–5)**: High-maintenance kitchen herbs belong in Zone 1 (≤8m from Zone 0); orchards and nut trees belong in Zones 2–3 (8–60m).
- **Guild Stacking**: Different vertical layers within canopy footprints trigger Guild Synergy bonuses (e.g., nitrogen-fixing White Clover under Dwarf Apple), not errors. Overcrowding only triggers on same-layer canopy overlaps >35%.
- **Micro-Topography (ΔY)**: Elevation depressions with ΔY < -0.40m trigger waterlogging warnings for drought-preferring species.
- **Cross-Platform Handoff**: URL-hash encoding `#plan=<url_safe_base64_json>` enables lossless site plan exchange between desktop 3D simulation and mobile outdoor AR.