feat: complete SHD MCP plugin workflows and widget

2026-08-24 17:25:38 +03:00
parent 39fb5c02b7
commit 08cf3672a4
86 changed files with 1707 additions and 5 deletions
@@ -0,0 +1,23 @@
+---
+name: shd-realtime-activity
+description: Use when the user asks to inspect SHD realtime events, start or terminate a realtime session, or review operational activity and audit history.
+---
+
+# SHD realtime and activity
+
+See `references/realtime-contract.md` for session lifecycle and event handling.
+
+## Read and observe
+
+- Resolve the authorized project/module scope before reading events or audit
+  history.
+- Use bounded event reads and preserve event IDs, cursors and timestamps.
+- Distinguish historical audit records from a live realtime session; do not
+  claim that an event stream is complete when it was truncated or disconnected.
+
+## Session lifecycle
+
+Starting or terminating a realtime session is a stateful operation. Require an
+explicit request, retain the returned session ID and scope, avoid duplicate
+starts on retry, and terminate only the requested session. Report connection
+or terminal state rather than fabricating an event.