Merge dev → main (automated)

.pi/test-config.json

@@ -2,5 +2,6 @@
   "suiteCommands": [
     "npm --silent test -- tests/cli",
     "npm --silent test -- tests/unit"
-  ]
+  ],
+  "timeoutPerCommand": 1800
 }

CHANGELOG.md

@@ -1,5 +1,41 @@
 # Changelog
 
+## v1.0.21 (2026-10-13)
+> **Release focus:** This release focuses on making the worklist more reliable and complete, ensuring blocked, in-progress, and reworked items always appear and that data refreshes instantly. It also fixes several crashes and data-loss issues that could occur when saving changes during conflicts or busy periods, and improves recovery behaviour when AI providers or long outages interrupt queued jobs.
+### Features
+- The README now clearly explains this is a Herdr extension for managing teams of AI agents, with Worklog as shared project memory. (WL-0MV16PXJ6003FEYT)
+- In-progress tasks now always appear in your work list, even when many items await review. (WL-0MV6KV22S004NYIU)
+- The work items list now updates within seconds when an agent makes changes. (WL-0MV02VA29009WBEN)
+- Release notes can now include a custom call-to-action message. (WL-0MUWEPN6X0044R43)
+- Long outages now retry less often, so recovery is smoother and less disruptive. (WL-0MUY9GDPG0062NWF)
+- Queued jobs now resume automatically when AI providers recover, instead of piling on more requests. (WL-0MV54ZP3Y00514Y9)
+- Blocked tasks now appear in the worklist so you can see what's holding up your backlog. (WL-0MV6TFX0600145M2)
+- Stale in-progress tasks now automatically return to the right queue. (WL-0MTF5WO2Q008B8US)
+- Worklist data now refreshes instantly when you return to the tab, so you always see up-to-date info. (WL-0MTF5WO1N0088P5P)
+- Finished items no longer stay marked critical, so urgent lists show only work that still needs attention. (WL-0MSJM4EIV001A0V9)
+### Bug Fixes
+- Your item updates now stay safe even when another session syncs at the same time. (WL-0MUVSQ4EO00092E7)
+- Fixed a crash that could strand your committed work when saving while others changed the same files. (WL-0MV533YSW004D1E1)
+- Fixed a crash that could lose your progress when saving changes during busy periods. (WL-0MV5FAZCQ006EHWE)
+- Fixed a crash that could lose your work when saving changes during a conflict. (WL-0MV569DDI003CCF1)
+- Prevents a crash when your changes are pushed after someone else updates the same branch. (WL-0MV5FDJE30088GGY)
+- Blocked items now always appear in your default worklist, so release-blocking tasks can't be hidden. (WL-0MV71WBHB007D8ZE)
+- Blocked items now appear in the review queue so nothing release-blocking goes unseen. (WL-0MV70XY6D008013C)
+- Rejecting an item for rework no longer changes its priority. (WL-0MUUAEDAU001GT1L)
+- Test runs no longer send fake release notifications to Discord. (WL-0MUYA98Z8003HU8X)
+- Your completed work is no longer lost when another change lands at the same time. (WL-0MUYTCF4L000FX3M)
+- High-priority items now appear first in the In Review list, so you can triage the most important work first. (WL-0MUWDW0N6003KF6G)
+- Tests now finish reliably instead of hanging when output is piped. (WL-0MUYTCF4D000WVKR)
+- Finishing work no longer fails when your branch is behind, so your progress stays safe. (WL-0MV5LY0J8005FKTZ)
+- Items in review that are being reworked now always appear in your list. (WL-0MV6JGVPH009YDXB)
+### Other
+- Removed duplicate tests to keep the game running smoothly and reliably. (WL-0MV28X3BT0079JM3)
+- Audits now run faster in off-peak hours by using spare capacity. (WL-0MUFD33FT0080OD5)
+- Tests are now more reliable, so bugs get caught faster and fixes ship sooner. (WL-0MV28X3SL005R5KX)
+- Improves game stability and performance through ongoing code cleanup. (WL-0MSS3380K0002ZVO)
+- Removed a leftover plugin that caused warnings, so your plugin list is now clean. (WL-0MSRG4828007ITI4)
+- Clearer docs help operators keep worklists accurate and stable. (WL-0MTF5WNZV003JKMJ)
+
 ## v1.0.20 (2026-10-09)
 > **Release focus:** This release focuses on reliability and resilience across agent sessions, fixing issues that could cause stalled work, shared slots, and interrupted sessions while adding automatic retries for connection errors and unavailable AI providers. It also improves day-to-day usability with multi-item deletion, a dedicated work item tab, an interview "Thinking…" indicator, and clearer guidance from the review queue and doctor.
 ### Features

CLI.md

@@ -180,6 +180,12 @@ Priority downgrade cascade:
 - When an item's priority is downgraded away from `critical` (to `high`, `medium`, or `low`), any direct children still at `critical` priority are automatically downgraded to `high` so that a non-critical parent has no critical subtasks. Children already at `high` or below are left untouched.
 - In JSON mode, the downgraded children are reported in a `downgradedChildren` array. In human-readable mode, a summary line like `[Downgraded 2 child(ren) from critical to high]` is printed.
 
+Terminal priority auto-downgrade (WL-0MSJM4EIV001A0V9):
+
+- When an item with `critical` priority transitions to a terminal state — `status` `completed` or `stage` `in_review` — its priority is automatically downgraded to `high`, so finished work stops competing with genuinely urgent open items. Closing via `wl close` is also a terminal transition and downgrades `critical` to `high`.
+- Only an actual transition triggers the downgrade: editing an item that is already terminal does not rewrite its priority. Non-critical priorities (`high`, `medium`, `low`) are never modified, and non-terminal transitions (e.g. `--stage plan_complete`) leave `critical` intact.
+- In JSON mode the downgraded item is reported in a `downgradedItem` field. In human-readable mode a summary line like `[Downgraded priority of WL-ABC123 from critical to high]` is printed.
+
 Example:
 
 ```sh
@@ -437,6 +443,13 @@ This is an audit gate leak; re-audit it or record a deliberate exception with
 `wl close --force` bypasses the warning and records a durable waiver on an uncovered
 `in_review` root, so the bypass is auditable.
 
+**Terminal priority auto-downgrade (WL-0MSJM4EIV001A0V9):** Closing is a terminal
+transition, so a `critical` item is automatically downgraded to `high`. When a subtree is
+closed recursively or with `--force`, every closed descendant that was `critical` is
+downgraded too; non-critical priorities are left untouched. The JSON result object
+reports the downgraded items in a `downgradedItems` array, and human-readable mode prints
+a summary line like `[Downgraded 1 item from critical to high]`.
+
 **Output format (recursive close):** When the audit-gated recursive close path is triggered:
 
 - **Human-readable output** reports the count of successfully closed descendants:

README.md

@@ -1,15 +1,18 @@
 # Worklog
 
-A lightweight, Git-friendly issue tracker designed for AI agents and development teams. Track hierarchical work items with a CLI or REST API -- all backed by SQLite with JSONL-based Git syncing.
+A [Herdr](https://herdr.dev) extension that assists with the management and orchestration of teams of AI agents. It browses and selects work from the backlog, dispatches agents into panes, tracks their live status, and releases claims abandoned by agents that have gone away.
+
+At the heart of that orchestration is **Worklog**: a lightweight, Git-friendly issue tracker that also serves as the project's history. Every work item records its description, acceptance criteria, and comment trail, so each agent gets the relevant context for the job it is given. Track hierarchical work items with a CLI or REST API — all backed by SQLite with JSONL-based Git syncing.
 
 ## Features
 
-- **CLI + API**: Manage work items from the command line or a REST API
-- **Git-Friendly Syncing**: JSONL format enables seamless team collaboration via Git with automatic conflict resolution
-- **Hierarchical Work Items**: Parent-child relationships for organizing epics, features, and tasks
-- **Plugin System**: Extend the CLI with custom commands (see [Plugin Guide](PLUGIN_GUIDE.md))
+- **Herdr Orchestration**: Browse and select work items, dispatch Pi agent panes, track live agent status, and self-heal abandoned `in_progress` claims from a Herdr pane (see [Herdr plugin](packages/herdr/README.md))
 - **AI Agent Integration**: Pi agent plugin modules that auto-load into every session — activity indicator, session health, model/provider display, guardrails, error recovery (`/retry`), and skill-path tool (see [Pi extension](packages/tui/extensions/README.md)).
 - **Heartbeat Skill**: Automated work item monitoring via the Pi agent — run `/skill:heartbeat` to flag items needing producer review or to audit completed items for closure readiness (see [skill/heartbeat/SKILL.md](skill/heartbeat/SKILL.md)).
+- **Hierarchical Work Items**: Parent-child relationships for organizing epics, features, and tasks
+- **Plugin System**: Extend the CLI with custom commands (see [Plugin Guide](PLUGIN_GUIDE.md))
+- **CLI + API**: Manage work items from the command line or a REST API
+- **Git-Friendly Syncing**: JSONL format enables seamless team collaboration via Git with automatic conflict resolution
 - **Multi-Project Support**: Custom prefixes for issue IDs per project
 
 ## Installation
@@ -163,6 +166,7 @@ You can get a lot of value from using Worklog as a memory for your agents. But y
 | [docs/dev/wl-process-healthcheck.md](docs/dev/wl-process-healthcheck.md) | wl process healthcheck watchdog usage (cron/systemd, thresholds) |
 | [docs/dev/audit-debug-log-retention.md](docs/dev/audit-debug-log-retention.md) | Audit debug log retention policy + runbook: sweep locations/thresholds, dry-run/`--apply`/`--check`, cron install/removal, safety guarantees |
 | [docs/dev/downtime-dispatcher.md](docs/dev/downtime-dispatcher.md) | Leader-election + shared-coordination downtime dispatcher architecture (herdr); critical-first dispatch tier + freeze split-by-skill; automated per-project tabs (one tab per work-item prefix) and interactive item-ID-tab placement (invoking workspace, fail-open) |
+| [docs/dev/test-suite-baseline.md](docs/dev/test-suite-baseline.md) | Pre-change test file count and suite runtime baseline for the legacy `test/` deduplication epic (reproducible commands + metrics) |
 | [docs/pane-triage-skill.md](docs/pane-triage-skill.md) | Approval-gated pane-triage skill and the cross-language pane-close bridge that exposes the shared classifier to Python skills |
 
 ## Tutorials