@williamthorsen/toolbelt.git 0.3.1 → 0.4.1

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,41 @@
2
2
 
3
3
  All notable changes to this project will be documented in this file.
4
4
 
5
+ ## 0.4.1 — 2026-09-17
6
+
7
+ ### Dependency updates
8
+
9
+ - Bumped `@williamthorsen/toolbelt.strings` to 8.0.1
10
+
11
+ ## 0.4.0 — 2026-09-15
12
+
13
+ ### 🎉 Features
14
+
15
+ - 🚨 **Breaking:** Move createTempTree from toolbelt.filesystem to toolbelt.testing (#313)
16
+
17
+ - Moves `CreateTempTreeOptions` and the `TempTree` handle to `@williamthorsen/toolbelt.testing/candidate` along with `createTempTree`.
18
+
19
+ 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.
20
+
21
+ ### ⚙️ Tooling
22
+
23
+ - Remove the stale repo-local cliff.toml and normalize changelog titles (#327)
24
+
25
+ - 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`.
26
+ - Excludes commits without a ticket prefix from future changelog entries.
27
+ - 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.
28
+ - 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.
29
+
30
+ ### 📚 Documentation
31
+
32
+ - Align prose with plain-speech doctrine and writing conventions (#306)
33
+
34
+ - Copy-edits prose across the repo: comments, test names, package READMEs, and `AGENTS.md`.
35
+ - Rewrites a few user-facing strings as well, among them `configure-project`'s help text and the errors from `parseProjectSpec`, `securityCommands`, and `hashString`.
36
+
5
37
  ## 0.3.1 — 2026-09-06
6
38
 
7
- ### Bug fixes
39
+ ### 🐛 Bug fixes
8
40
 
9
41
  - Point every package bin at a committed wrapper (#296)
10
42
 
@@ -15,7 +47,7 @@ All notable changes to this project will be documented in this file.
15
47
  - 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
48
  - 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
49
 
18
- ### Documentation
50
+ ### 📚 Documentation
19
51
 
20
52
  - Repair reduced object relatives in the READMEs and AGENTS.md (#263)
21
53
 
@@ -27,7 +59,7 @@ All notable changes to this project will be documented in this file.
27
59
 
28
60
  ## 0.3.0 — 2026-08-30
29
61
 
30
- ### Features
62
+ ### 🎉 Features
31
63
 
32
64
  - Add a tb-git CLI for branch-number and ticket-ref (#250)
33
65
 
@@ -35,7 +67,7 @@ All notable changes to this project will be documented in this file.
35
67
 
36
68
  ## 0.2.0 — 2026-08-28
37
69
 
38
- ### Features
70
+ ### 🎉 Features
39
71
 
40
72
  - Add findBranchTicketRef and deriveBranchNumber to toolbelt.git (#239)
41
73
 
@@ -43,7 +75,7 @@ All notable changes to this project will be documented in this file.
43
75
 
44
76
  `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
77
 
46
- ### Internal
78
+ ### 🏗️ Internal features
47
79
 
48
80
  - Scaffold toolbelt.git for git utilities (#235)
49
81
 
package/README.md CHANGED
@@ -2,20 +2,7 @@
2
2
 
3
3
  Utilities for working with git.
4
4
 
5
- <!-- section:release-notes -->
6
- ## Release notes — v0.3.1 (2026-09-06)
7
-
8
- ### Bug fixes
9
-
10
- - Point every package bin at a committed wrapper (#296)
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.
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.
18
- <!-- /section:release-notes -->
5
+ <!-- section:release-notes --><!-- /section:release-notes -->
19
6
 
20
7
  ## Installation
21
8
 
@@ -34,7 +21,7 @@ pnpm add --global @williamthorsen/toolbelt.git # puts tb-git on PATH
34
21
  npx @williamthorsen/toolbelt.git branch-number # or run it without installing
35
22
  ```
36
23
 
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 ...`.
24
+ 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
25
 
39
26
  `tb-git --help`, each subcommand's `--help`, and `tb-git --version` report the surface and the installed version.
40
27
 
@@ -85,7 +72,7 @@ With no `<branch>`, both subcommands resolve the checked-out branch with `git br
85
72
  | `1` | `ticket-ref` found no ticket in the branch name; both streams are empty |
86
73
  | `2` | Usage or validation error, with the message on stderr |
87
74
 
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`.
75
+ 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
76
 
90
77
  ```sh
91
78
  if ref=$(tb-git ticket-ref); then
@@ -118,11 +105,11 @@ findBranchTicketRef('232_add-widget');
118
105
  // { id: '232', number: 232 }
119
106
  ```
120
107
 
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.
108
+ 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
109
 
123
110
  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
111
 
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.
112
+ 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
113
 
127
114
  ```ts
128
115
  findBranchTicketRef('mac-22/add-widget');
@@ -137,7 +124,7 @@ findBranchTicketRef('feat-2', { key: 'mac' });
137
124
 
138
125
  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
126
 
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`.
127
+ 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
128
 
142
129
  ## `deriveBranchNumber`
143
130
 
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.1",
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.1"
49
49
  },
50
50
  "devDependencies": {
51
- "@williamthorsen/toolbelt.filesystem": "0.8.3"
51
+ "@williamthorsen/toolbelt.testing": "0.6.1"
52
52
  },
53
53
  "engines": {
54
54
  "node": ">=24.0.0"