feat: initial monorepo with PRD, 12 ADRs, and plugin skeletons

2026-06-19 18:37:27 -04:00
commit fe434553a8
15 changed files with 599 additions and 0 deletions
@@ -0,0 +1,15 @@
+# ADR 5: @mention Detection via Zulip SDK
+
+**Date**: 2026-04-28
+
+### Decision
+Use the Zulip SDK's `mentioned_users` field in message events for @mention detection, with regex fallback for cleaning @mention artifacts from forwarded message text.
+
+### Context
+The Zulip event API provides `mentioned_users` — an array of user IDs that were @mentioned in the message. This is the most reliable detection mechanism (handles all @mention formats) and avoids fragile text parsing. Regex is only needed to strip the `@**Display Name**` markup from the forwarded message body.
+
+### Consequences
+- Zero false positives for @mention detection
+- Handles @all-bots, @everyone, and individual @mentions uniformly
+- Stripped message text is clean for agent consumption
+- SDK handles reconnection and backoff for the event stream