github MrLesk/Backlog.md v1.48.0

3 hours ago

v1.48.0

Added

  • Task types — new type field on tasks, supported end-to-end: core model & persistence (#720), CLI (#747), MCP task_create/task_edit (#728), type filtering (#748), TUI board & detail views (#750), and web UI display/editing (#751)
  • Task deep links/tasks/:id URLs in board and list views, with hardening for task identity, focus, and legacy ID routes (#755 by @u-ichi)
  • Duplicate task ID detection and recovery — warns about duplicate IDs (#632 by @brooksc, #740) with a human-first backlog doctor repair flow (#749); the warning now also appears persistently in the interactive TUI task list (#781)
  • User-defined priority values beyond high/medium/low via config (#743)
  • Deterministic checklist editing — repeatable --acceptance-criteria replaces the whole checklist (commas preserved as content), --ac stays additive, new --clear-ac for atomic clears, ambiguous flag combinations rejected, malformed AC/DoD markers fail closed with repair guidance (#779)
  • --exclude-status filtering for task list and search (#745)
  • Creation-date sorting in the board column menu (#744) and ordinal sorting in task list views (#645 by @raincrossgazette)
  • Unassigned-task filtering in CLI and MCP (#725)
  • --plain support for doc view (#729 by @dleopold)
  • Folder grouping for docs in the web UI (#674 by @zhuohoudeputao)
  • Config option to hide empty board status columns (#660 by @napter)
  • Port-congestion handling for backlog browser — offers the next free port instead of failing (#651 by @lenucksi)
  • Version metadata embedded in shipped agent instruction files (#726)

Changed

  • dateFormat config is honored consistently in displays (#722); task dates display consistently as UTC in TUI, plain output, and MCP (#672)
  • Browser UI bundling modernized to a Bun-native full-stack build; the compiled binary embeds the React app and assets directly from source (#737)
  • Browser label filters sorted alphabetically (#742); web milestone cards sorted in creation order (#644 by @raincrossgazette)
  • Acceptance criteria numbers shown in browser task detail (#714)

Fixed

  • Port availability probe was a no-op on macOS, so port-congestion handling never triggered and two backlog browser instances could silently share a port (#780)
  • Duplicate task ID warnings were invisible in the default interactive TUI task-list view (#781)
  • Block-style YAML lists for statuses/labels/types/priorities were silently ignored in config.yml; config set guidance for list keys referenced a nonexistent command (#782)
  • Subtask ordering in "All Tasks" ID sort (#741)
  • TUI completion status not updating (#708, #724)
  • Stale ContentStore refreshes overwriting newer state (#757)
  • updated_date no longer bumped by ordinal-only reorders (#715)
  • In-document markdown hash links (#713)
  • Unsaved web drafts preserved across file refreshes (#705)
  • Task ID allocation across git worktrees (#710); cross-branch task hydration commit pinning (#696 by @rvdbreemen); committed worktree branch cache refresh (#706)
  • Binary resolution on Apple Silicon under Rosetta/arch mismatch (#721)
  • EEXIST errors in ensureBacklogStructure on Windows OneDrive (#656 by @GregoryFerraz)
  • Repeated task edit label flags (#693)

Docs & agent guidance

  • Added the Backlog.md manifesto; README reworked into a landing page centered on the review-surface value proposition
  • Agent workflow guidance: just-in-time implementation planning (#776), stronger emphasis on reading detailed guides (#718), better experience for weaker local models (#735), npx backlog.md usage (#717), shell quoting for literal backticks (#704), issue-first PR process (#703)

Internal

  • Test-reliability program (#758#777): real CLI surface coverage, deterministic teardown, observable synchronization instead of polling, suite splits
  • CI: faster test workflow and Windows timeout fixes (#738, #739); MCP milestone mutation timeout eliminated (#759)

Don't miss a new Backlog.md release

NewReleases is sending notifications on new releases.