dave/storkit
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 7 Wiki Activity

story-kit: done 298_story_bot_htop_command_with_live_updating_process_dashboard

Browse Source
This commit is contained in:
Dave
2026-03-19 10:29:35 +00:00
parent 9ed80384d5
commit 99d301b467
1 changed files with 25 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

25
.story_kit/work/5_done/298_story_bot_htop_command_with_live_updating_process_dashboard.md Normal file
View File

@@ -0,0 +1,25 @@
---
name: "Bot htop command with live-updating process dashboard"
---
# Story 298: Bot htop command with live-updating process dashboard
## User Story
As a project owner in a Matrix room, I want to type "{bot_name} htop" and see a live-updating dashboard of system load and agent processes, so that I can monitor resource usage without needing terminal access.
## Acceptance Criteria
- [ ] '{bot_name} htop' sends an initial status message showing load average and per-agent process info (CPU, memory, story assignment)
- [ ] Message is edited every 5 seconds with updated stats
- [ ] Only shows processes related to the project (agent PIDs and their child process trees)
- [ ] '{bot_name} htop stop' stops the live updating and sends a final 'monitoring stopped' edit
- [ ] Works regardless of what language/toolchain the agents are using (monitors by PID tree, not by process name)
- [ ] Uses Matrix message editing (replacement events) to update in place
- [ ] Only one htop session per room at a time — a second '{bot_name} htop' stops the existing session and starts a fresh one
- [ ] Auto-stops after 5 minutes by default to prevent runaway editing
- [ ] Optional timeout override: '{bot_name} htop 10m' to set a custom duration
## Out of Scope
- TBD