docket 0.31.0

Added

• DOCKET_HOOKS=off silences the pre-edit hook and the session briefing's feature, update and merge notices. The briefing still prints the ledger.

docket 0.30.0

Changed

• The pre-edit hook tells the agent to start a feature when a session edits its third distinct file outside .docket/ and no feature is open, once per session.
• The docket-feature skill triggers before a change reaches its third file, and finishing within the turn no longer exempts a change from a feature.
• The no-feature briefing hint says to start a feature before editing further, instead of only when the work continues past the session.

docket 0.29.0

Changed

• docket context exits 0 on an unreadable ledger and prints the error with a pointer to docket check, so the session hook still tells the agent something. Every other command keeps exiting nonzero.
• --evidence accepts a value that parses as non-object JSON, such as an issue number, as a plain reference.
• docket construct retries 429, 5xx, timeouts and connection errors by status code and exception class, honours Retry-After up to 60 seconds, and no longer stacks SDK retries on its own. Schema violations and truncated output are not retried.
• docket construct skips a document over 200,000 characters with a message naming it, reports truncated model output as its own error, and fences the document body in the prompt as data.
• docket construct dates a document from git before its own Date: line or filename; --review marks dates that did not come from git.
• The installer writes the PATH line to the first existing of ~/.bash_profile, ~/.bash_login and ~/.profile for bash on macOS, honours ZDOTDIR for zsh, and appends the line at apply time instead of rewriting the file.
• Uninstall removes only Cursor and Copilot hook entries whose command equals the one the installer writes. Entries an older release wrote with a different command string are left in place.
• The launcher resolves the latest release tag once and downloads the checksums and installer from it, with a 30-second socket timeout.
• The ledger guard hook follows a plain cd DIR through a command chain, treats globs under .docket/ that could match a docket file as the ledger, and no longer asks on >/dev/null or 2>&1 redirects.
• The docket skill marks more than one --supports set, --depends-on and the derived blocked state as experimental.
• docket imports a subcommand's module only when that subcommand runs.

Fixed

• A record containing U+2028, U+2029 or U+0085 made every later read of the ledger or feature store fail. Every JSONL reader now splits on newline only.
• --dry-run no longer creates the ledger lock file or its directory.
• docket construct reports a provider response with no text block as an error instead of crashing.

docket 0.28.0

Changed

• docket graph --web is a new page with two views. Timeline, the default, lists records by time with git branches drawn as lanes and link chips in place of arrows; pills at the top and bottom edge point to linked records scrolled out of view. Graph draws readable cards laid out by ELK, with right-angled edges, and lists records with no relation beside the canvas. "Show lineage" opens one record's supersession chain and direct links as a fitted subgraph.
• The page searches all records with ⌘K or Ctrl+K, keeps the view, lineage, selection, direction and filters in the URL, and has light, dark and system themes.

Removed

• The web view's Force, Radial and Circular engines, its grouping, and its focus and hops controls; lineage replaces focus. docket export keeps --group, --focus, --hops and --include-orphans.
• /api/graph no longer returns DOT and ignores query parameters. The vendored Graphviz WASM is no longer shipped.

docket 0.27.0

Added

• docket context prints a one-line hint above the records when no feature is open and the working tree has uncommitted changes outside .docket/. The hint tells the agent to load the docket-feature skill if the work continues past the session. A clean tree, changes only under .docket/, or any git failure prints nothing.

Changed

• The docket-feature skill description now names its triggers (work that outlasts the session or goes to another agent, resuming such work, closing it), and the docket skill points to it.

docket 0.26.0

Changed

• Breaking: schema 3 numbers each kind on its own, so claims are c1…, decisions d1… and questions q1…. Every record in an existing ledger is renumbered once, retired records included, and keeps its schema 2 ID in migrated_from. Old IDs stay searchable and no command resolves them. Every collaborator must upgrade docket and the plugin before merging a migrated ledger, because 0.25.x cannot read schema 3 and its session hook reports an error. Each project runs docket migrate once and commits the result.
• Each branch migrates itself before it merges. The merge driver refuses a ledger or features side that is still at an older schema, names the branch to migrate, and leaves conflict markers; abort the merge, migrate that branch, commit, and merge again.
• A merge or docket rebase now rewrites c, d and q IDs mentioned in a record's prose along with its relations, and matching ignores those IDs so a record merged under a new number is not appended twice.
• docket migrate runs every step from the ledger's schema to the current one, so a schema 1 ledger reaches schema 3 in one run. It prints a summary by default and, with --dry-run, the per-record report, every prose field it would rewrite and every ID it would leave as written. It keeps the original at ledger.jsonl.schemaN, where N is the starting schema. --map and --emit-map apply to schema 1 only.
• The migration rewrites .docket/features.jsonl and .docket/archive/features-*.jsonl to the new IDs and moves their schema to 2.
• docket check compares ID order per kind, and on a ledger older than the running docket prints the migrate instruction once.
• The pre-edit hook asks before an edit to any ledger.jsonl.schemaN backup, not only .schema1.

Added

• docket migrate --rewrite FILE... rewrites ID citations in the named files in the same run. Each file must be tracked by git and have no uncommitted changes. With --dry-run it lists the files and counts and writes nothing. It is refused on a ledger already at schema 3.
• docket list --where was:ID finds a record by the ID it had before a migration, and docket show ID names that command for an ID that no longer exists.
• list --json and show --json drop migrated_from along with legacy unless --legacy is passed.
• The session hook prints the migrate instruction on stdout, with exit 0, when the ledger is older than the running docket, so the agent sees it. Any other ledger error still prints on stderr with exit 1.

docket 0.25.1

Fixed

• The 0.25.0 release build failed on a terminal banner test that assumed colour was off, so 0.25.0 was tagged but never published. 0.25.1 is the first release carrying the 0.25.0 changes.

docket 0.24.0

Added

• docket graph --web serves a live, localhost-only browser view of the relation graph, with --port N to pick the port.
• The w key in the terminal graph viewer opens the web view for the current filter.
• docket export --group none|kind|scope draws boxes around records, and --focus ID --hops N draws only a record and the records within N relation steps of it.
• The docket graph --web page has a Layout popover for engine, direction and grouping, and a "Focus here" control in the record drawer. Layout state is kept in the URL query string.

Changed

• docket export --format dot packs disconnected clusters into a grid and tags nodes and edges with class attributes.

docket 0.23.0

Changed

• docket export replaces docket graph --format, which is removed with no alias. --format defaults to mermaid, and --out, --detail, --direction and --superseded moved with it. graph is now only the viewer and the text renderer.

docket 0.22.1

Changed

• The user guides cover 0.21 and 0.22: supersession reasons in Recording decisions, a "Records that need review" section and the export borders in Reading your ledger, and the merge driver in Sharing and maintenance.