Skip to content

Commit 837c1af

Browse files
flashosophyflashosophy
committed
docs(tasks): document stale task health
Agent: Eva
1 parent fb2e9b1 commit 837c1af

1 file changed

Lines changed: 17 additions & 0 deletions

File tree

‎docs/cli/tasks.md‎

Lines changed: 17 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -45,6 +45,23 @@ openclaw tasks list [--runtime <name>] [--status <name>] [--json]
4545

4646
Lists tracked background tasks newest first.
4747

48+
Human-readable output annotates stale active records distinctly (`stale-run` /
49+
`stale-q`) while preserving the canonical lifecycle status in the task record.
50+
JSON output includes a `health` object on each task so Control UI and SDK
51+
consumers can surface the same distinction without parsing audit text:
52+
53+
```json
54+
{
55+
"status": "running",
56+
"health": {
57+
"displayStatus": "stale-run",
58+
"stale": true,
59+
"auditCodes": ["stale_running"],
60+
"maxAgeMs": 2400000
61+
}
62+
}
63+
```
64+
4865
### `show`
4966

5067
```bash

0 commit comments

Comments
 (0)