tanuki-telemetry 1.3.7 → 1.3.8

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tanuki-telemetry",
-  "version": "1.3.7",
+  "version": "1.3.8",
   "description": "Workflow monitor and telemetry dashboard for Claude Code autonomous agents",
   "type": "module",
   "bin": {

package/skills/monitor.md

@@ -0,0 +1,87 @@
+---
+description: |
+  Autonomous workspace monitoring. Checks inbox + workspace screens on a recurring interval and takes action when sessions complete — dispatches queued work, restarts stalled sessions, reports status.
+allowed-tools: Bash, Read, Glob, Grep, CronCreate, CronDelete, AskUserQuestion, mcp__telemetry__*
+---
+
+# /monitor — Autonomous Workspace Monitoring
+
+You are a monitoring daemon for the coordinator. You check workspace status periodically and take action when needed.
+
+## Arguments
+
+- No args → monitor all active workspaces every 5 minutes
+- `<interval>` → custom interval (e.g., `2m`, `10m`)
+- `stop` → cancel all monitoring crons
+
+## On Invoke
+
+### 1. Discover active workspaces
+```bash
+cmux list-workspaces
+```
+For each non-coordinator workspace, get the Claude surface:
+```bash
+cmux list-pane-surfaces --workspace "workspace:N"
+```
+
+### 2. Set up the monitoring cron
+```
+CronCreate({
+  cron: "*/5 * * * *",  // or custom interval
+  prompt: "MONITOR CHECK: Read coordinator inbox and check all workspace screens",
+  recurring: true
+})
+```
+
+### 3. On each cron fire
+
+#### Check inbox
+```bash
+cat ~/.claude/coordinator-inbox.jsonl 2>/dev/null | tail -10
+```
+
+#### For each active workspace, check screen
+```bash
+cmux read-screen --workspace "workspace:N" --surface surface:X --lines 5
+```
+
+#### Determine status
+| Signal | Status | Action |
+|--------|--------|--------|
+| `esc to interrupt` | Working | No action needed |
+| `❯` prompt only (idle) | Finished or stuck | Check inbox for completion event |
+| `session_end` in inbox | Completed | Dispatch next queued task if any |
+| Same screen for 3+ checks | Possibly stuck | Nudge: "Are you still working? If stuck, /clear and retry." |
+| Error visible on screen | Failed | Log error, notify coordinator |
+
+#### If a workspace completed
+1. Read the inbox for details
+2. Check git log for new commits
+3. If there's a queued task for that workspace, dispatch it
+4. Clear processed inbox messages
+5. Log status to telemetry
+
+#### If a workspace seems stuck
+1. Check if it's waiting on something (Inngest job, API call, build)
+2. If idle for 3+ checks with no progress, send a nudge
+3. If nudge doesn't help after 2 more checks, restart the session
+
+### 4. Status report
+Every 30 minutes (or 6 checks), output a summary:
+```
+MONITOR STATUS:
+- ws:8 (CDD Marathon): Working, 3 commits since last report
+- ws:11 (Import Fix): Completed, dispatched next task
+- Inbox: 2 messages processed
+```
+
+## Stopping
+To stop monitoring:
+```
+CronDelete <job-id>
+```
+Or invoke `/monitor stop` which deletes all monitoring crons.
+
+## Key principle
+**Don't just observe — act.** If a workspace finishes and there's queued work, dispatch it immediately. If a workspace is stuck, nudge it. The coordinator shouldn't have to manually check — that's your job.

package/src/dashboard.ts

@@ -489,6 +489,7 @@ app.get("/api/artifacts/by-id/:id", (req, res) => {
     artifact.stored_path,
     artifact.file_path,
     artifact.file_path?.replace(/^.*?outputs\//, "/data/"),
+    artifact.file_path?.replace(/^.*?\.tanuki\/data\//, "/data/"),
   ].filter(Boolean) as string[];
 
   for (const candidate of candidates) {
@@ -501,7 +502,7 @@ app.get("/api/artifacts/by-id/:id", (req, res) => {
     }
   }
 
-  res.status(404).json({ error: "Artifact file not found on disk" });
+  res.status(404).json({ error: "Artifact file not found on disk", candidates });
 });
 
 // Serve screenshot by database ID — self-contained, doesn't need volume path mapping
@@ -527,6 +528,7 @@ app.get("/api/screenshots/by-id/:id", (req, res) => {
     screenshot.stored_path,
     screenshot.file_path,
     screenshot.file_path?.replace(/^.*?outputs\//, "/data/"),
+    screenshot.file_path?.replace(/^.*?\.tanuki\/data\//, "/data/"),
   ].filter(Boolean) as string[];
 
   for (const candidate of candidates) {