feat: add remote ask event contract

Inspired-by: @S1M0N38 in PR #6

docs/README.md

@@ -5,7 +5,8 @@ This folder keeps only the documentation needed to understand and maintain the e
 ## Files
 
 - `configuration.md` — source of truth for configuring pi-ask keymaps, behaviour, and `/answer` extraction
-- `contract.md` — external behavior, full tool payload/result details, and UX guarantees
+- `contract.md` — external behavior, tool payload/result details, and UX guarantees
+- `remote-events.md` — local inter-extension event contract, bridge examples, and smoke-test steps
 - `architecture.md` — module boundaries and invariants
 - `../skills/ask-user/SKILL.md` — auto-bundled agent-side decision-gate guidance; enabled by default, but can be disabled via `pi config`; inspired by https://github.com/edlsh/pi-ask-user
 
@@ -13,6 +14,7 @@ This folder keeps only the documentation needed to understand and maintain the e
 
 - start with `configuration.md` for config-editing rules
 - read `contract.md` for behavior
+- read `remote-events.md` for local bridge/event integration
 - read `architecture.md` for code layout
 
 ## Local test run