add poi type to feed item shape

AGENTS.md

@@ -0,0 +1,73 @@
+# agents.md
+
+This monorepo contains two cooperating apps that together provide a “Google Now on Glass” experience. The system is deliberately split so that heavy computation and data access live on the phone, while Glass remains a lightweight, glance-first client.
+
+---
+
+## IrisCompanion (iOS)
+
+**Role:** Context engine and system brain.
+
+**Responsibilities:**
+- Collect user context (location, time, calendar, environment).
+- Generate a small, ranked set of “Now” cards.
+- Decide what matters *right now* and suppress noise.
+- Act as the source of truth for card content and ordering.
+- Deliver updates to Glass over a low-power Bluetooth channel.
+
+**Design principles:**
+- Phone does the thinking; Glass does the displaying.
+- Strong throttling and expiry to avoid notification fatigue.
+- Cards are ephemeral and contextual, not a permanent feed.
+- Battery-conscious: push updates only when context changes.
+
+**What it is not:**
+- Not a UI-heavy app.
+- Not a timeline renderer.
+- Not dependent on Glass-specific UI concepts.
+
+---
+
+## IrisGlass (Google Glass Explorer)
+
+**Role:** Glanceable display and interaction surface.
+
+**Responsibilities:**
+- Maintain a lightweight connection to IrisCompanion.
+- Receive and cache the current “Now” state.
+- Present the most relevant card as a persistent Glass surface.
+- Recover automatically from disconnects.
+- Optionally expose limited interaction (dismiss, snooze).
+
+**Design principles:**
+- One primary surface, always available.
+- Fast to glance, minimal user effort.
+- No local decision-making about importance.
+- Prefer replacement over accumulation of cards.
+
+**What it is not:**
+- Not a launcher replacement.
+- Not a full feed manager.
+- Not a context engine.
+
+---
+
+## System Philosophy
+
+- **Single source of truth:** IrisCompanion decides; IrisGlass renders.
+- **Low noise:** Fewer cards, higher confidence.
+- **Glass-native:** Respect the timeline and LiveCard patterns.
+- **Battery first:** Bluetooth over Wi-Fi; minimal background work.
+- **Ephemeral by default:** Cards expire and disappear naturally.
+
+---
+
+## Evolution Notes
+
+- Early development may use fixture data and diagnostic UIs.
+- Additional card types can be added incrementally.
+- More advanced ranking or summarisation may be introduced later.
+- Timeline publishing should remain limited and intentional.
+
+End of file.
+