Skip to content

v0.2.0

Choose a tag to compare

@github-actions github-actions released this 07 Jul 17:25

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 mechanical STATE.md drift (stale current_task
    pointer or task counts) against the task files. Dry run by default; --apply
    rewrites STATE.md only (never a task file) and re-validates. Judgement calls
    (missing spec_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
    --title and --spec-ref; supports --priority, repeatable --dep, --json.
    Runs validate's checks at creation so an invalid task never lands.
  • taskrail task new --follow-up <parent-id> — scaffold a follow-up: inherits the
    parent's spec_ref and adds it as a dependency.
  • taskrail import — build spec/task drafts from a markdown source without an LLM.
    --to tasks|spec|planning previews a draft; --emit-prompt prints a paste-ready
    agent prompt; --apply <draft.json> validates and writes real files. Supports
    --json. (--llm deferred 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;
    --apply scaffolds 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 init is now version-aware and non-destructive: writes a
    .taskrail/config.yml layout marker, adopts an existing v0.1.0 layout, and
    migrates older layouts (dry run, --apply to write). Never rewrites human content.
  • taskrail validate now detects dependency cycles and committed references to
    gitignored planning/artifacts/ paths.
  • Homebrew install: brew install tessariq/tap/taskrail (macOS and Linux).

Changed

  • taskrail import --apply is now atomic — pre-flights all checks before writing,
    so a failing draft leaves the repo unchanged.
  • taskrail verify records a portable, path-free result in committed STATE.md;
    gitignored artifact paths no longer leak into relevant_artifacts.
  • taskrail init no longer pre-creates gitignored artifact directories; verify
    creates them on demand.

Fixed

  • taskrail validate no longer fails on a fresh clone when the gitignored
    planning/artifacts tree is absent.