@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 +31 -5
- package/README.md +10 -13
- package/bin/tb-git.js +1 -1
- package/package.json +3 -3
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.
|
|
6
|
+
## Release notes — v0.4.0 (2026-09-15)
|
|
7
7
|
|
|
8
|
-
###
|
|
8
|
+
### 🎉 Features
|
|
9
9
|
|
|
10
|
-
-
|
|
10
|
+
- 🚨 **Breaking:** Move createTempTree from toolbelt.filesystem to toolbelt.testing (#313)
|
|
11
11
|
|
|
12
|
-
-
|
|
12
|
+
- Moves `CreateTempTreeOptions` and the `TempTree` handle to `@williamthorsen/toolbelt.testing/candidate` along with `createTempTree`.
|
|
13
13
|
|
|
14
|
-
|
|
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
|
|
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
|
|
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
|
|
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`
|
|
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:
|
|
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
|
+
"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": "
|
|
48
|
+
"@williamthorsen/toolbelt.strings": "8.0.0"
|
|
49
49
|
},
|
|
50
50
|
"devDependencies": {
|
|
51
|
-
"@williamthorsen/toolbelt.
|
|
51
|
+
"@williamthorsen/toolbelt.testing": "0.6.0"
|
|
52
52
|
},
|
|
53
53
|
"engines": {
|
|
54
54
|
"node": ">=24.0.0"
|