v0.2.0
Second release. Taskrail builds on the stable v0.1.0 repo contract to make adoption
in existing repositories easy: guided retrofit, LLM-free import of rough notes into
spec/task drafts, opt-in shippable agent skills, a version-aware non-destructive
init, and conservative mechanical STATE.md repair — all while keeping the core
CLI provider- and tooling-independent.
Added
taskrail repair— reconcile mechanicalSTATE.mddrift (stalecurrent_task
pointer or task counts) against the task files. Dry run by default;--apply
rewritesSTATE.mdonly (never a task file) and re-validates. Judgement calls
(missingspec_ref, dependency cycles, multiple in_progress) are left to
validate. Supports--json.taskrail task new— scaffold a task file with the next free id. Requires
--titleand--spec-ref; supports--priority, repeatable--dep,--json.
Runsvalidate's checks at creation so an invalid task never lands.taskrail task new --follow-up <parent-id>— scaffold a follow-up: inherits the
parent'sspec_refand adds it as a dependency.taskrail import— build spec/task drafts from a markdown source without an LLM.
--to tasks|spec|planningpreviews a draft;--emit-promptprints a paste-ready
agent prompt;--apply <draft.json>validates and writes real files. Supports
--json. (--llmdeferred to v0.3.)taskrail retrofit [notes]— guided bootstrap for a non-standard repo: detect
layout, scaffold, and adopt reviewed notes as tracked work. Dry run by default;
--applyscaffolds without overwriting. Supports--json.taskrail init --with-skills— install the shippable tracked-work agent skills
(autonomous-backlog,autonomous-task,autonomous-verify,taskrail-repair,
taskrail-import,taskrail-retrofit). Opt-in; re-running never overwrites edits.taskrail initis now version-aware and non-destructive: writes a
.taskrail/config.ymllayout marker, adopts an existing v0.1.0 layout, and
migrates older layouts (dry run,--applyto write). Never rewrites human content.taskrail validatenow detects dependency cycles and committed references to
gitignoredplanning/artifacts/paths.- Homebrew install:
brew install tessariq/tap/taskrail(macOS and Linux).
Changed
taskrail import --applyis now atomic — pre-flights all checks before writing,
so a failing draft leaves the repo unchanged.taskrail verifyrecords a portable, path-free result in committedSTATE.md;
gitignored artifact paths no longer leak intorelevant_artifacts.taskrail initno longer pre-creates gitignored artifact directories;verify
creates them on demand.
Fixed
taskrail validateno longer fails on a fresh clone when the gitignored
planning/artifactstree is absent.