From 9f945cfb6ca7795664ab87f959827b1f9fcc2057 Mon Sep 17 00:00:00 2001
From: LIghtJUNction <lightjunction.me@gmail.com>
Date: Tue, 24 Mar 2026 16:12:25 +0800
Subject: [PATCH] docs: add runtime-status-star spec

---
 .../specs/runtime-status-star/spec.md         | 39 +++++++++++++++++++
 1 file changed, 39 insertions(+)
 create mode 100644 openspec/changes/abp-runtime-status-plugin/specs/runtime-status-star/spec.md

diff --git a/openspec/changes/abp-runtime-status-plugin/specs/runtime-status-star/spec.md b/openspec/changes/abp-runtime-status-plugin/specs/runtime-status-star/spec.md
new file mode 100644
index 000000000..3f9221b04
--- /dev/null
+++ b/openspec/changes/abp-runtime-status-plugin/specs/runtime-status-star/spec.md
@@ -0,0 +1,39 @@
+# Runtime Status Star Specification
+
+## ADDED Requirements
+
+### Requirement: RuntimeStatusStar provides diagnostic tools
+
+The RuntimeStatusStar SHALL provide callable tools that expose core runtime internal state for diagnostic purposes.
+
+#### Scenario: Get runtime status
+- **WHEN** ABP client calls `get_runtime_status` tool
+- **THEN** returns `{"running": bool, "uptime_seconds": float}`
+
+#### Scenario: Get protocol status
+- **WHEN** ABP client calls `get_protocol_status` tool
+- **THEN** returns status of each protocol client (lsp, mcp, acp, abp)
+
+#### Scenario: Get star registry
+- **WHEN** ABP client calls `get_star_registry` tool
+- **THEN** returns list of registered star names
+
+#### Scenario: Get stats
+- **WHEN** ABP client calls `get_stats` tool
+- **THEN** returns runtime statistics including message counts
+
+### Requirement: Auto-registration with orchestrator
+
+The RuntimeStatusStar SHALL be automatically registered with the orchestrator on initialization.
+
+#### Scenario: Orchestrator initialization
+- **WHEN** AstrbotOrchestrator is created
+- **THEN** RuntimeStatusStar instance is created and registered with name "runtime-status-star"
+
+### Requirement: Error handling
+
+The RuntimeStatusStar tools SHALL handle errors gracefully without exposing internal exceptions.
+
+#### Scenario: Orchestrator unavailable
+- **WHEN** orchestrator reference is None
+- **THEN** returns appropriate error message instead of raising exception