用途:Runtime Monitor 用于真实工作负载监控,而非笼统的状态检查。它围绕 joelclaw CLI 与 pi TUI 监控扩展,观察 ADR-0217 工作负载在 Redis 队列、Restate、Dkron 以及过渡期 Inngest 上的运行情况。
主要能力:提供规范的操作入口,包括 joelclaw jobs status、joelclaw queue depth、joelclaw queue control status、joelclaw queue observe、joelclaw restate status、joelclaw restate cron status,以及 pi 扩展工具 runtime_jobs_monitor。pi 扩展还暴露 inngest_send 与 inngest_runs。
使用方式:先加载 system-architecture;若构建或修改监控组件/TUI,加载 pi-tui-design;CLI 操作流程加载 joelclaw。首查用 joelclaw jobs status --hours 1 --count 10,判断系统当前能否承接更多工作、队列/运行时层是否健康、Dkron 是否存活、过渡期 Inngest 是否仍健康。队列排查用 joelclaw queue depth、joelclaw queue control status --hours 1、joelclaw queue observe --hours 1、joelclaw queue stats --since <iso|ms>。运行时底层排查用 joelclaw restate status、joelclaw restate cron status、joelclaw runs --count 20 --hours 1。pi 监控可用 {"action":"start","interval":5,"report":true} 启动后台轮询并绘制 TUI 组件,{"action":"status"} 获取最新快照,{"action":"stop"} 停止轮询并发送最终摘要。
适用场景:需要判断运行时能否承接更多工作、定位队列层问题、检查 Restate/Dkron/Inngest 状态,或在 pi TUI 中持续观察工作负载变化时。
限制:joelclaw jobs status 是聚合事实来源,除非命令有误,不要手工重建同一视图;若其输出嘈杂或误导,应报告缺陷并使用有界底层证据,仅在实现范围内才修改 CLI。TUI 组件行必须用 pi-tui 的 truncateToWidth / visibleWidth 按终端宽度截断,否则窄终端会导致 Pi 崩溃。过渡期 Inngest 保持可见,但当 Restate、队列与 Dkron 是真实工作负载路径时不应主导叙述。只报告已证实的结论;若监控仅编译通过而未实际使用,应如实说明。