Assign and dispatch tasks to agents

CHANGELOG.md

@@ -1,6 +1,72 @@
 # Changelog
 
-One `## vX.Y.Z` section per release, newest first, with `## Unreleased
+One `## vX.Y.Z` section per release, newest first, with `## Unreleased` on top. Inside a
+section the subsections are, in this order and only when non-empty: `### Breaking`,
+`### Added`, `### Changed`, `### Fixed`. Every user-visible change lands here in the PR
+that makes it, written for a user, not a contributor: omit demo alignment, CI wiring,
+review history, and other maintainer-only work. On release the version's section becomes
+the GitHub release notes verbatim.
+
+Each change is one line of at most 30 words; details live in the docs. A fix to something
+first added in the same Unreleased section is not an entry: edit that entry instead.
+
+## Unreleased
+
+### Breaking
+
+- Store format 6: assignees, dispatch, blocks, reviews, after, paper trail, wider undo. Older tsk refuses it; to roll back, restore the `tsk.json.v5` copy.
+
+### Added
+
+- Agent profiles in `config.toml`. The first board open writes a commented starter with examples for Claude Code, Codex, Pi, and Grok.
+- Agent prompts: `prompt_append` adds to the default prompt, and `[project."<path>"]` adds per-repository lines and `review_on`. `tsk dispatch T12 --show-prompt` previews it.
+- Assign a task to an agent profile, yourself, or a named person with `@`, `!a name`, or `--assignee`. Only an agent dispatches. `v` on Projects shows one assignee's tasks.
+- Dispatch: in Herdr, starting an assigned project task (`ctrl+s`, `tsk status T12 started`, `tsk dispatch`) launches its agent in its own Git worktree and workspace. Windows: preview.
+- Set the branch a dispatch starts from with `!b branch`, the task page's Base field, or `tsk add`/`tsk edit --base`; otherwise it is the repository's default branch.
+- A dispatched task whose agent is gone asks before relaunching in the same worktree (`--again` in the CLI). Starting a marked set opens one card listing what launches.
+- Completing a dispatched task offers to remove its worktree and merged branch; with `gh`, squash and rebase merges count. `tsk clean` does the same from a script.
+- `m` on the cleanup card merges the task's pull request with `gh`, then completes the task and cleans up. `[merge] method` in `config.toml` picks the method; CLI: `--merge`.
+- Block with a reason: `ctrl+b` asks why and what you need. Answer on the task page, under the row (`r`), or with `tsk reply`. Unblocking sends replies to the agent.
+- Review with checks: `ctrl+r` asks what was done and what to check. Mark checks, give feedback (`r`, `tsk reply`), then approve (`ctrl+d`) or send back (`ctrl+s`).
+- Change who a block or review waits on, keeping its replies: `w` on its task page, palette **set waiting on…**, or `tsk edit --on`.
+- A blocked or review row addressed to you shows the asker's words on a dim line under it. `z` hides these lines, leaving `✉`; `[board] messages` sets the default.
+- Paper trail: the task page lists who did what, newest first, below the steps, and drops created and updated dates from its footer. `tsk list T12` shows it as `activity`.
+- After: a task can wait for other tasks in any project (`!w T202`, the After field, `tsk edit --after`). When the last one is done, a waiting ready task starts.
+- Agents block and hand back for review with `tsk status`, and use `tsk dispatch`, `tsk clean`, and `tsk reply`. Agent skill 1.6.0 covers them; `tsk update` refreshes installed copies.
+- `ctrl+u` undoes status changes, step changes, and archiving; a marked set is one step. Undoing a start that launched an agent leaves the agent running. Thanks @LukasGold (#173).
+- Group and sort by assignee with `g` and `s` or `tsk list --group assignee` and `--sort assignee`. The `t` filter gains an `@assignees` tab.
+- `[board]` in `config.toml` sets the group and sort a fresh desk or project board opens with, and `me` the name the board calls you.
+- Back up tasks and `config.toml` to git on every save or daily. `tsk backup setup` makes a private GitHub repository with `gh`; `tsk backup add <git-url>` adds any other.
+- `tsk edit --append-notes` adds text below a task's notes after a blank line, without rewriting them.
+- `tsk setup` also installs the `tsk-coordinator` skill: your agent can brief builder agents, gate their pull requests with a review, live-test, and report back on the board.
+- `tsk restore` lists the newest 20 backed-up versions per machine (`--all` for every one) and puts the one you pick back, keeping the replaced store.
+- Sort the project picker and the Projects view by name or age with `s`. Both list projects A–Z by name by default. Thanks @LukasGold (#250).
+
+### Changed
+
+- `ctrl+b` and `ctrl+r` open the block and review cards; `Enter` on an empty card still blocks or sets review at once.
+- A footer too narrow for its actions drops whole actions, least likely first, instead of cutting the last one with `…`.
+- Board footers show `: commands` next to `? help`, and the task page's action bar ends with it; clicking it opens the command palette.
+- Word jumps match macOS Option+arrow: `alt+→` or `ctrl+→` lands at the end of the next word, `alt+←` or `ctrl+←` at the start of the previous one.
+- A row whose title wraps above an open peek or live line shows a dim `│` beside each wrapped line, so the row reads as one block.
+- Help, footers, and the palette name each action verb first and in full (`ctrl+b` **block / unblock**). Help's **SURFACE CONTROLS** group is renamed **PICKERS & EDITING**.
+- The archived-project launch card puts each option on its own line; `↑`/`↓` and `Enter` pick one, as on the cleanup card.
+- `ctrl+s` starts a blocked task, closing its block; one `ctrl+u` reopens it. On a task it cannot start, the status row says why. Thanks @LukasGold (#252).
+
+### Fixed
+
+- `tsk help capture` and `tsk capture --help` print the capture reference instead of failing or opening the popup.
+- `ctrl+u` names what it undid or why it refused, and undoing a done puts back the task's earlier status instead of open. Thanks @LukasGold (#173).
+- Saving a task with a step's text cleared reopens that step with `text required` on its row, as for an empty new step. Thanks @LukasGold (#173).
+- A project reached through a symlinked path, such as `/tmp/repo` and `/private/tmp/repo` on macOS, is one project.
+- With tasks marked, `Esc` in the thread or view picker closes the picker and keeps the marks.
+- With tasks marked, `ctrl+b` and `ctrl+r` skip done tasks, as starting does, and the status row counts them.
+- `Esc` on a selected Thread on the task page cancels only the thread, not the whole edit.
+- `ctrl+x` in a new step's row discards that row, instead of removing the step above it or deleting a task.
+- `tsk steps` takes `--` before step text that starts with `-`, as `tsk reply` does.
+- `tsk trash restore` gives a task the next free number when another task holds its old one, so no two tasks share a number.
+- `tsk capture --state-dir <dir>` saves into that store instead of the default one; any other argument is refused.
+- Notes keep underscores inside words, such as `file_name`, instead of turning them into emphasis.
 
 ## v0.12.0