Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

Unreleased

0.2.1 - 2026-08-18

Fixed

• tkt init now teaches agents about backlog workflow, status transitions, and evidence-based closure
• Agent instructions generated by tkt init --all were missing --status backlog, --evidence, and promote/demote patterns — agents would create open tickets when intending to park work

0.2.0 - 2026-08-18

Added

• tkt init command to set up a project and deploy AI agent instructions in one step
• tkt doctor command to verify your setup is correct
• tkt doctor <path> to scan all your projects at once and report health
• tkt lint command to normalize ticket frontmatter style (quoting, field order, whitespace)
• tkt lint --check for CI — exits 1 if any file would change
• tkt validate --fix to automatically repair common ticket issues
• Validation criteria on tickets — define what "done" means at creation time
• Evidence on close — link proof to each criterion so reviewers see what was verified
• Configurable enforcement for validation evidence (warn, require, or off)
• tkt audit flags tickets closed without evidence when criteria were defined
• --dry-run flag on all mutation commands — preview what would happen without writing
• Global -o json flag — structured JSON output for all commands
• Structured error envelopes — machine-parseable errors with kind, message, hint, and exit code
• Error kind vocabulary (8 types) declared in tkt capabilities with retryable flags
• Self-update check — notifies when a newer version is available (once per day, non-blocking)
• Unified config cascade — user config provides global defaults, project config overrides per-repo
• close.allow_force config — disable the --force escape hatch project-wide or globally
• Git hash in --version output for dev build traceability (e.g., tkt 0.2.0 (ea047fb))
• Agent Plugins conformance — ships plugin.json and skills/tkt/SKILL.md per agentskills.io spec
• tkt doctor <path> now flags non-tkt git repos and supports --strict and -o json

Changed

• tkt config --show now reports the source of each resolved value (env/project/user/default)
• ready --json still works but -o json ready is now the canonical form
• Clearer README and crate description

Fixed

• Evidence gate: duplicate named evidence indices (e.g., 1=foo 1=bar) no longer bypass the complete-evidence requirement

0.1.0 - 2026-08-09

Added

• Frontier computation: tkt ready shows unblocked tickets sorted by priority
• Push-to-claim: atomic ticket allocation via git push with race detection
• Multi-level priority: urgent > high > medium > low (frontier sort order)
• Backlog status: park tickets outside the frontier with status: backlog
• Ticket lifecycle: tkt new, tkt claim, tkt close, tkt edit, tkt renumber
• Batch ticket creation: tkt batch for multiple tickets in one push
• Query with filters: tkt query --status open --priority high
• Blocked view: tkt blocked shows tickets with unsatisfied dependencies
• Validation: tkt validate checks for cycles, dangling deps, contract violations
• Audit: tkt audit for closure quality (unchecked ACs, missing resolutions, stale WIP)
• Plan sync: tkt sync-plan detects and fixes drift between tickets and plan documents
• ID collision resolution: tkt rebase auto-renumbers when upstream conflicts
• Agent discovery: tkt capabilities outputs JSON manifest of commands and workflows
• Per-project config: .tickets/config.toml for tunable behaviors (push, close, validate)
• User config: ~/.config/tkt/config.toml for debug mode and format preferences
• Color support: --color=always|never|auto, respects NO_COLOR (no-color.org)
• ASCII fallback: TKT_ASCII=1 for legacy terminals (✓→[ok], ✗→[err], ⚠→[warn])
• Spike branch awareness: auto-appends branch name to resolution on close
• Worktree support: works correctly from git worktrees
• Local-only telemetry: opt-in JSONL recording, never leaves your machine
• Debug mode: TKT_DEBUG=1|json for real-time diagnostics to stderr