Skip to content

v0.3.0

Latest

Choose a tag to compare

@github-actions github-actions released this 14 Jul 07:57

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 in STATE.md and re-validates (the CLI-only writer of the active
    spec); spec list and spec show <version> (with --anchors for spec_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 fails validate.
    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|mermaid exports 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
    next selection and drop its STATE.md blocker entry (others keep theirs);
    --reason appends a note. Supports --json.
  • Windows install via WinGet: winget install Tessariq.Taskrail (amd64/arm64),
    with Windows .zip assets on the GitHub Release. Availability follows a
    moderated PR to microsoft/winget-pkgs.

Changed

  • taskrail init --with-skills now also installs the autonomous-recovery,
    autonomous-manual-test, and taskrail-spec skills; --force reinstalls 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/taskrail to override (it resolves to the installed binary
    otherwise).
  • taskrail repair also reconciles a status_summary left stale against a single
    in_progress task; still STATE.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 new now allocates the next id from the highest numeric prefix
    across bare and slug-suffixed ids, so all-slug-suffixed repos no longer restart
    at T-001 and collide; validate now flags two files sharing a numeric prefix.
  • taskrail block now keeps every blocked task's reason in STATE.md instead of
    overwriting the list with only the most recent.
  • taskrail complete now leaves status_summary as blocked when other tasks
    remain blocked, instead of resetting to idle.