story-kit: create 298_story_bot_htop_command_with_live_updating_process_dashboard

This commit is contained in:
Dave
2026-03-19 09:36:14 +00:00
parent 7a5a56f211
commit 597e6bf1c3
2 changed files with 23 additions and 20 deletions

View File

@@ -1,20 +0,0 @@
---
name: "Improve bot status command formatting"
---
# Story 297: Improve bot status command formatting
## User Story
As a user reading the bot's status output in Matrix, I want to see clean story numbers and titles (not filenames), with agent assignments shown inline, so that the output is easy to scan at a glance.
## Acceptance Criteria
- [ ] Status output shows story number and title (e.g. '293 — Register all bot commands') not the full filename stem
- [ ] Each story shows which agent is working on it if one is assigned (e.g. 'coder-1 (sonnet)')
- [ ] Stories with no agent assigned show no agent info rather than cluttering the output
- [ ] Output is compact and scannable in a Matrix chat window
## Out of Scope
- TBD

View File

@@ -0,0 +1,23 @@
---
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
## Out of Scope
- TBD