---
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