Third release. Taskrail gains read-only insight into tracked work — status,
stats, and coverage report progress, aggregate metrics, and spec-linkage
without touching state — plus a spec command family for inspecting and
authoring specs, unblock to release blocked tasks, and Windows install via
WinGet. The core CLI stays provider- and tooling-independent.
Added
taskrail spec— spec command family.spec activate <version>repoints the
active spec inSTATE.mdand re-validates (the CLI-only writer of the active
spec);spec listandspec show <version>(with--anchorsforspec_ref
values) inspect specs read-only;spec add <version>scaffolds a new spec.
Completion completes spec versions and<path>#<anchor>values. Supports--json.taskrail coverage— advisory read-only spec-linkage analysis: per-area
decomposition and implementation coverage, a reverse map of the covering task
id(s), orphan tasks, and a drift summary.--min <pct>opts into CI gating;
--area <anchor>narrows to one area. Never writes state or failsvalidate.
Supports--json.taskrail status— read-only snapshot: active spec, task counts, the next
eligible task (marked not persisted), blockers, last verification, and a
coverage/drift summary. Leaves the working tree clean. Supports--json.taskrail stats— read-only aggregate metrics: status distribution, blocked
ratio, spec coverage, and dependency shape.--format dot|mermaidexports the
task dependency DAG instead. Leaves the working tree clean. Supports--json.taskrail unblock <task-id>— return a blocked task to todo so it re-enters
nextselection and drop itsSTATE.mdblocker entry (others keep theirs);
--reasonappends a note. Supports--json.- Windows install via WinGet:
winget install Tessariq.Taskrail(amd64/arm64),
with Windows.zipassets on the GitHub Release. Availability follows a
moderated PR tomicrosoft/winget-pkgs.
Changed
taskrail init --with-skillsnow also installs theautonomous-recovery,
autonomous-manual-test, andtaskrail-specskills;--forcereinstalls the
embedded skills over existing copies, backing up any locally-modified file
first. Still opt-in and non-destructive by default.- Shipped agent skills now invoke the CLI through
${TASKRAIL:-taskrail}; set
TASKRAIL=/path/to/taskrailto override (it resolves to the installed binary
otherwise). taskrail repairalso reconciles astatus_summaryleft stale against a single
in_progresstask; stillSTATE.md-only and dry run by default.- CLI file-read errors now name a repo-relative path instead of the absolute
repository location.
Fixed
taskrail task newnow allocates the next id from the highest numeric prefix
across bare and slug-suffixed ids, so all-slug-suffixed repos no longer restart
atT-001and collide;validatenow flags two files sharing a numeric prefix.taskrail blocknow keeps every blocked task's reason inSTATE.mdinstead of
overwriting the list with only the most recent.taskrail completenow leavesstatus_summaryasblockedwhen other tasks
remain blocked, instead of resetting toidle.