@williamthorsen/toolbelt.git 0.3.1 → 0.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -2,9 +2,35 @@
2
2
 
3
3
  All notable changes to this project will be documented in this file.
4
4
 
5
+ ## 0.4.0 — 2026-09-15
6
+
7
+ ### 🎉 Features
8
+
9
+ - 🚨 **Breaking:** Move createTempTree from toolbelt.filesystem to toolbelt.testing (#313)
10
+
11
+ - Moves `CreateTempTreeOptions` and the `TempTree` handle to `@williamthorsen/toolbelt.testing/candidate` along with `createTempTree`.
12
+
13
+ Migration: Import `createTempTree`, `CreateTempTreeOptions`, and `TempTree` from `@williamthorsen/toolbelt.testing/candidate`, and declare `@williamthorsen/toolbelt.testing` in the manifest that declared `@williamthorsen/toolbelt.filesystem` for them.
14
+
15
+ ### ⚙️ Tooling
16
+
17
+ - Remove the stale repo-local cliff.toml and normalize changelog titles (#327)
18
+
19
+ - Stops `release-kit prepare` from printing a "skipped due to grouping error(s)" warning for each releasable workspace by letting it resolve the git-cliff template bundled with release-kit, previously overridden by the root `cliff.toml`.
20
+ - Excludes commits without a ticket prefix from future changelog entries.
21
+ - Renames the section titles in every `packages/*/.meta/changelog.json`, except `Dependency updates`, to the headings of release-kit's work-type taxonomy, such as "🎉 Features" and "🏗️ Internal features", and regenerates each `CHANGELOG.md` so that release-kit orders existing and new sections by the same rule.
22
+ - Causes the next `release-kit prepare` to plan patch releases of `dstructs`, `hof`, and `sets`, which had no other commits since their last release, because the changelog commit touches every workspace.
23
+
24
+ ### 📚 Documentation
25
+
26
+ - Align prose with plain-speech doctrine and writing conventions (#306)
27
+
28
+ - Copy-edits prose across the repo: comments, test names, package READMEs, and `AGENTS.md`.
29
+ - Rewrites a few user-facing strings as well, among them `configure-project`'s help text and the errors from `parseProjectSpec`, `securityCommands`, and `hashString`.
30
+
5
31
  ## 0.3.1 — 2026-09-06
6
32
 
7
- ### Bug fixes
33
+ ### 🐛 Bug fixes
8
34
 
9
35
  - Point every package bin at a committed wrapper (#296)
10
36
 
@@ -15,7 +41,7 @@ All notable changes to this project will be documented in this file.
15
41
  - Fixes an issue where `tb-secret set` and `tb-jira auth set` failed with `EAGAIN: resource temporarily unavailable` when the producer of a piped credential delayed its first byte, as `tb-secret get`, `op read`, and `gh auth token` all do.
16
42
  - Stops `tb-secret`, `tb-jira`, and `tb-git` from crashing with an unhandled `EPIPE` when the reader on their stdout or stderr exits first, so that `tb-secret get | head -1` ends quietly, as a program that ignores `SIGPIPE` does.
17
43
 
18
- ### Documentation
44
+ ### 📚 Documentation
19
45
 
20
46
  - Repair reduced object relatives in the READMEs and AGENTS.md (#263)
21
47
 
@@ -27,7 +53,7 @@ All notable changes to this project will be documented in this file.
27
53
 
28
54
  ## 0.3.0 — 2026-08-30
29
55
 
30
- ### Features
56
+ ### 🎉 Features
31
57
 
32
58
  - Add a tb-git CLI for branch-number and ticket-ref (#250)
33
59
 
@@ -35,7 +61,7 @@ All notable changes to this project will be documented in this file.
35
61
 
36
62
  ## 0.2.0 — 2026-08-28
37
63
 
38
- ### Features
64
+ ### 🎉 Features
39
65
 
40
66
  - Add findBranchTicketRef and deriveBranchNumber to toolbelt.git (#239)
41
67
 
@@ -43,7 +69,7 @@ All notable changes to this project will be documented in this file.
43
69
 
44
70
  `findBranchTicketRef` extracts the ticket ID encoded in a branch name. `deriveBranchNumber` relies on it to give every branch a stable number: the ticket's if the branch name includes one, and otherwise a `hashString` digest of the name. The number is bounded by the caller-specified range.
45
71
 
46
- ### Internal
72
+ ### 🏗️ Internal features
47
73
 
48
74
  - Scaffold toolbelt.git for git utilities (#235)
49
75
 
package/README.md CHANGED
@@ -3,18 +3,15 @@
3
3
  Utilities for working with git.
4
4
 
5
5
  <!-- section:release-notes -->
6
- ## Release notes — v0.3.1 (2026-09-06)
6
+ ## Release notes — v0.4.0 (2026-09-15)
7
7
 
8
- ### Bug fixes
8
+ ### 🎉 Features
9
9
 
10
- - Point every package bin at a committed wrapper (#296)
10
+ - 🚨 **Breaking:** Move createTempTree from toolbelt.filesystem to toolbelt.testing (#313)
11
11
 
12
- - Points the `tb-git`, `tb-jira`, and `tb-secret` commands at committed wrappers under each package's `bin/`, so the target exists when the package manager links the command rather than only after a build.
12
+ - Moves `CreateTempTreeOptions` and the `TempTree` handle to `@williamthorsen/toolbelt.testing/candidate` along with `createTempTree`.
13
13
 
14
- - Fix piped-stdin reads and unhandled EPIPE in the CLIs (#301)
15
-
16
- - Fixes an issue where `tb-secret set` and `tb-jira auth set` failed with `EAGAIN: resource temporarily unavailable` when the producer of a piped credential delayed its first byte, as `tb-secret get`, `op read`, and `gh auth token` all do.
17
- - Stops `tb-secret`, `tb-jira`, and `tb-git` from crashing with an unhandled `EPIPE` when the reader on their stdout or stderr exits first, so that `tb-secret get | head -1` ends quietly, as a program that ignores `SIGPIPE` does.
14
+ Migration: Import `createTempTree`, `CreateTempTreeOptions`, and `TempTree` from `@williamthorsen/toolbelt.testing/candidate`, and declare `@williamthorsen/toolbelt.testing` in the manifest that declared `@williamthorsen/toolbelt.filesystem` for them.
18
15
  <!-- /section:release-notes -->
19
16
 
20
17
  ## Installation
@@ -34,7 +31,7 @@ pnpm add --global @williamthorsen/toolbelt.git # puts tb-git on PATH
34
31
  npx @williamthorsen/toolbelt.git branch-number # or run it without installing
35
32
  ```
36
33
 
37
- The short `npx` form works because the package declares exactly one bin, which npm falls back to whatever its name. Were a second bin added, the invocation would become `npx --package @williamthorsen/toolbelt.git tb-git ...`.
34
+ The short `npx` form works because the package declares exactly one bin, which npm falls back to, whatever its name. Were a second bin added, the invocation would become `npx --package @williamthorsen/toolbelt.git tb-git ...`.
38
35
 
39
36
  `tb-git --help`, each subcommand's `--help`, and `tb-git --version` report the surface and the installed version.
40
37
 
@@ -85,7 +82,7 @@ With no `<branch>`, both subcommands resolve the checked-out branch with `git br
85
82
  | `1` | `ticket-ref` found no ticket in the branch name; both streams are empty |
86
83
  | `2` | Usage or validation error, with the message on stderr |
87
84
 
88
- A bound, offset, or key rejected by the library exits `2` carrying the message that it raises. So does an empty option value, so `--min "$PORT_MIN"` with `PORT_MIN` unset fails instead of bounding at `0`.
85
+ A bound, offset, or key rejected by the library exits `2`, reporting the message that it raises. So does an empty option value, so `--min "$PORT_MIN"` with `PORT_MIN` unset fails instead of bounding at `0`.
89
86
 
90
87
  ```sh
91
88
  if ref=$(tb-git ticket-ref); then
@@ -118,11 +115,11 @@ findBranchTicketRef('232_add-widget');
118
115
  // { id: '232', number: 232 }
119
116
  ```
120
117
 
121
- A ref must begin a segment. `/` and `_` both delimit one, so an author prefix and a worktree-safe spelling parse alike, and the leftmost segment carrying a ref wins. Anchoring to a segment is what keeps a kebab-case description from reading as a ticket: `feat/add-widget-2` encodes none, because `widget` follows a hyphen rather than a separator.
118
+ A ref must begin a segment. `/` and `_` both delimit one, so an author prefix and a worktree-safe spelling parse alike, and the leftmost segment with a ref wins. Anchoring to a segment keeps a kebab-case description from reading as a ticket: `feat/add-widget-2` encodes none, because `widget` follows a hyphen rather than a separator.
122
119
 
123
120
  Two forms are recognized, each taking an optional `.N` revisit suffix. A **keyed** ref is a Jira-style key and number, the key matching Jira's own rule of a letter followed by letters and digits. A **bare-numeric** ref is the number alone. `id` and `key` are emitted uppercased, since a branch name may be lowercase but the ticket that it names is `MAC-22`.
124
121
 
125
- By default a key must be uppercase, which is what Jira permits and the only property separating a real key from an ordinary word: without it, `feat-2` would read as ticket `FEAT-2`. Declaring the project's own key through `key` is both more permissive and more precise, since it then matches in any casing and is the only key that matches at all.
122
+ By default a key must be uppercase, which Jira permits and which is the only property separating a real key from an ordinary word: Without it, `feat-2` would read as ticket `FEAT-2`. Declaring the project's own key through `key` is both more permissive and more precise, since it then matches in any casing and is the only key that matches at all.
126
123
 
127
124
  ```ts
128
125
  findBranchTicketRef('mac-22/add-widget');
@@ -137,7 +134,7 @@ findBranchTicketRef('feat-2', { key: 'mac' });
137
134
 
138
135
  The bare-numeric form stays active whether or not a key is declared. A `RangeError` names the fault when `key` is not a well-formed key, which would otherwise match nothing at all.
139
136
 
140
- A trailing `-N` is not read as a sub-ID, being indistinguishable from a description: `232-3-column-layout` carries no revisit. Neither suffix affects `number`.
137
+ A trailing `-N` is not read as a sub-ID, being indistinguishable from a description: `232-3-column-layout` has no revisit. Neither suffix affects `number`.
141
138
 
142
139
  ## `deriveBranchNumber`
143
140
 
package/bin/tb-git.js CHANGED
@@ -1,6 +1,6 @@
1
1
  #!/usr/bin/env node
2
2
 
3
- // Imports only node builtins: a top-level import resolves before the gate below runs, so an unresolvable
3
+ // Imports only node builtins: A top-level import resolves before the gate below runs, so an unresolvable
4
4
  // dependency would replace this file's build-first message with ERR_MODULE_NOT_FOUND.
5
5
  import { existsSync } from 'node:fs';
6
6
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@williamthorsen/toolbelt.git",
3
- "version": "0.3.1",
3
+ "version": "0.4.0",
4
4
  "description": "Utilities for working with git",
5
5
  "keywords": [
6
6
  "esm",
@@ -45,10 +45,10 @@
45
45
  "dist/*"
46
46
  ],
47
47
  "dependencies": {
48
- "@williamthorsen/toolbelt.strings": "7.2.0"
48
+ "@williamthorsen/toolbelt.strings": "8.0.0"
49
49
  },
50
50
  "devDependencies": {
51
- "@williamthorsen/toolbelt.filesystem": "0.8.3"
51
+ "@williamthorsen/toolbelt.testing": "0.6.0"
52
52
  },
53
53
  "engines": {
54
54
  "node": ">=24.0.0"