An agent sandbox bind-mounts /dev/null over protected paths such as .bashrc and files inside .claude/, so make patch refused a tree that was clean outside the sandbox. Untracked character devices cannot be committed, so the check skips them and lists only what blocks the release. Untracked files are listed one by one rather than with --directory, since the collapsed .claude/ entry is not a device.
2.7 KiB
2.7 KiB
Committing and Releasing
The commit convention and the version bump that goes with it.
Git Workflow
- Commit format:
([ticketID]) [short description] - Use
--fixupfor incremental changes - Test before moving to reviewing status
Version Bumps
- Before every commit, decide whether the change warrants a version bump in
Cargo.toml - Always ask the user to confirm the bump and its kind before making it — never bump silently, and never skip the question because the answer looks obvious
make patch,make minorandmake majordo the mechanics, run after the commit is in: each bumpsCargo.tomland theworklaneentry inCargo.lock, appends, and bump to <version>to the commit's subject, folds the bump into that commit, and tags it. Bumping by hand is how a version comes to be left untagged, which is what the one action is for. It refuses on a dirty tree, on an already-taggedHEADand on aHEADthat is already pushed, since each of those makes the amend lose work, orphan a tag or need a force push- Untracked character devices do not make the tree dirty. An agent sandbox bind-mounts
/dev/nullover protected paths such as.bashrc,.gitconfigand files inside.claude/, so git sees untracked entries that do not exist outside the sandbox, andmake patchrefused a clean tree. A device cannot be committed, so the check skips them. Untracked files are listed one by one rather than with--directory: the collapsed.claude/entry is a directory, not a device, and kept the refusal alive - Pre-1.0, so: patch for fixes and internal changes, minor for a new command, flag or changed output, major only for a deliberate 1.0
- Changed output means the CLI's output. That is the surface scripts and agents read, so a changed listing, message or exit code is a minor. A change to what the board draws is a patch however visible it is, since nothing consumes the frame. See The Board View
- Settling output that shipped one version ago is a patch, not a second minor. 0.15.1 changed the relation mark 0.15.0 had just introduced, and 0.15.2 added the status mark beside it: the minor was the arrival of a marked relations block, and settling what it marks belongs to that. Three minors in an hour would tell anyone reading the tags that there were three features
- No bump for docs-only, tests-only or
--fixupcommits - When one body of work spans several commits, bump once on the final commit rather than on each
- Every bump gets a matching annotated tag,
v<version>, on the bump commit — a bumped version is never left untagged - Tag locally only; never push a tag unless asked
worklane --versionreports the crate version alongside the build sha, so the bump is what makes one release distinguishable from another