the-custodian/workplans/CUST-WP-0056-daily-todo-md-stale-review.md
codex 346dc8d23b
All checks were successful
CI Smoke / host-smoke (push) Successful in 1s
CI Smoke / container-smoke (push) Successful in 2s
Sync CUST-WP-0056 State Hub workstream and task IDs
2026-07-08 14:42:53 +02:00

60 lines
No EOL
1.6 KiB
Markdown

---
id: CUST-WP-0056
type: workplan
title: "Daily TODO.md Stale Review via activity-core"
domain: custodian
repo: the-custodian
status: finished
owner: codex
topic_slug: custodian
created: "2026-07-08"
updated: "2026-07-08"
state_hub_workstream_id: "2175f964-021c-4a2e-b2e7-1fe5d1a90ce1"
---
# CUST-WP-0056 — Daily TODO.md Stale Review via activity-core
## Goal
Automate daily review of workstation `TODO.md` files that have not changed in
6+ days. TODO.md is a pragmatic interruption buffer; stale files should be
reviewed and durable items promoted to workplans (ADR-001).
## State Hub scan endpoint
```task
id: CUST-WP-0056-T01
status: done
priority: high
state_hub_task_id: "4bf871d0-1520-4d1a-810e-e30f7fa8cd10"
```
- `GET /repos/todo-md-staleness?stale_days=6` on State Hub
- Scans active registered repos with accessible `local_path`
- Returns repos whose `TODO.md` mtime is older than the threshold
## activity-core resolver and schedule
```task
id: CUST-WP-0056-T02
status: done
priority: high
state_hub_task_id: "252ef449-11ab-4867-b0b0-5d2750aa01ef"
```
- Resolver query `todo_md_staleness` in activity-core `state_hub.py`
- ActivityDefinition `daily-todo-md-stale-review.md` — cron `30 8 * * *` Berlin
- Emits one review task per stale repo; progress event `todo_md_stale_review`
## Retire STATUS.md pattern
```task
id: CUST-WP-0056-T03
status: done
priority: medium
state_hub_task_id: "da496029-5364-42ac-8a87-fd16d3263103"
```
- Confirmed no `STATE.md` files across workstation repos
- Removed erroneous `STATUS.md` from net-kingdom; `SCOPE.md` remains canonical
- README orientation points to SCOPE.md only