@williamthorsen/toolbelt.packaging 0.6.3 โ†’ 0.7.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.
@@ -0,0 +1,371 @@
1
+ [
2
+ {
3
+ "version": "0.7.0",
4
+ "date": "2026-10-25",
5
+ "sections": [
6
+ {
7
+ "title": "๐ŸŽ‰ Features",
8
+ "audience": "all",
9
+ "items": [
10
+ {
11
+ "description": "Adds the structured changelog `.meta/changelog.json` to each package's npm tarball, beside `CHANGELOG.md`. (#398)",
12
+ "hash": "2ce82cd51b7b78270274ae9318c2bc726eb09cf0",
13
+ "entry": 1
14
+ }
15
+ ]
16
+ },
17
+ {
18
+ "title": "โ™ป๏ธ Refactoring",
19
+ "audience": "dev",
20
+ "items": [
21
+ {
22
+ "description": "Replaces hand-rolled error descriptions, `instanceof Error` checks on caught values, record guards, directory ascents, and first-letter capitalization in package source with `describeError`, `isError`, `isRecord`, `isRecordOrArray`, `listDirectoryChain`, and `capitalize`, and declares each helper's package from another workspace as a `workspace:*` runtime dependency of the package that adopts it. (#400)",
23
+ "hash": "dc681ce947df9aebf203f9457b10bc8afd2adec1",
24
+ "entry": 1
25
+ }
26
+ ]
27
+ },
28
+ {
29
+ "title": "๐Ÿงช Tests",
30
+ "audience": "dev",
31
+ "items": [
32
+ {
33
+ "description": "Rewrites the array-join fixtures and the untagged multi-line template fixtures in the readiness and parser tests as `dedent` templates that render the same text, and declares `@williamthorsen/toolbelt.strings` as a devDependency of each package that now imports `dedent` in its tests. (#401)",
34
+ "hash": "3453f00005619f771b84ba0263bf5c40df8b2795",
35
+ "entry": 1
36
+ }
37
+ ]
38
+ }
39
+ ]
40
+ },
41
+ {
42
+ "version": "0.6.4",
43
+ "date": "2026-10-24",
44
+ "sections": [
45
+ {
46
+ "title": "๐Ÿ“ฆ Dependencies",
47
+ "audience": "dev",
48
+ "items": [
49
+ {
50
+ "description": "Upgrade dependencies to latest compatible versions (#391)",
51
+ "body": "Upgrades Node.js, pnpm, and the repository's dependencies to their latest compatible releases, which clears the three dev advisories that failed `nmr audit`. The upgrade to `@williamthorsen/eslint-config-typescript` 20.1.3 adds unicorn lint rules, and the code is adapted to them in the same change.",
52
+ "hash": "7ecdab12fec8c866d54cef4c072b90376664ece0"
53
+ }
54
+ ]
55
+ }
56
+ ]
57
+ },
58
+ {
59
+ "version": "0.6.3",
60
+ "date": "2026-10-09",
61
+ "sections": [
62
+ {
63
+ "title": "๐ŸŽ‰ Features",
64
+ "audience": "all",
65
+ "items": [
66
+ {
67
+ "description": "Add a ReadyUp kit recommending toolbelt.cli over hand-rolled argument parsing (#367)",
68
+ "body": "Adds a ReadyUp adoption kit to `@williamthorsen/toolbelt.cli` that reports, through `rdy run --packages`, each call to `node:util`'s `parseArgs` and each function that compares arguments against flag names by hand. Includes `bin/` and `src/bin/` in the kit's sweep, which the other toolbelt kits exempt, because a command-line runner usually lives there.",
69
+ "hash": "9ba17df22caf393c492f3452ee5cabaa6850391d"
70
+ }
71
+ ]
72
+ },
73
+ {
74
+ "title": "๐Ÿ“š Documentation",
75
+ "audience": "dev",
76
+ "items": [
77
+ {
78
+ "description": "Updates each kit README to show `rdy run --sources` and a `sources: ['npm:โ€ฆ']` config example, and states that this spelling needs readyup 0.40.0 or later. (#371)",
79
+ "hash": "e4f5c2e65a0d62bbf3ea215566c8cc7aff3b5ec6",
80
+ "entry": 2
81
+ }
82
+ ]
83
+ }
84
+ ]
85
+ },
86
+ {
87
+ "version": "0.6.2",
88
+ "date": "2026-10-02",
89
+ "sections": [
90
+ {
91
+ "title": "๐Ÿ“š Documentation",
92
+ "audience": "dev",
93
+ "items": [
94
+ {
95
+ "description": "Sweep the repository's comments against the comment discipline (#353)",
96
+ "body": "Sweeps the comments in every authored source file against the comment discipline. The sweep cuts comments that restate the code or narrate history, corrects descriptions that contradicted the code, and adds descriptions to declarations that lacked one. It also tags the exported tier functions and classes that lacked `@category` and `@stage`, and corrects test titles that misstated their tests.",
97
+ "hash": "a63031711563d43c6909609fad4feccfe497e5d1"
98
+ },
99
+ {
100
+ "description": "Revises READMEs, doc comments, and test names across the repository to follow the current `plain-speech` and writing-preference rules. (#354)",
101
+ "hash": "b4e08eede95e052f4c27db2640ed6515df14baf4",
102
+ "entry": 1
103
+ },
104
+ {
105
+ "description": "Rewords the help text and messages printed by `tb-jira`, `tb-node`, and `tb-secret`, and the advice and skip reasons reported by the adoption kits, to follow the same writing conventions. (#354)",
106
+ "hash": "b4e08eede95e052f4c27db2640ed6515df14baf4",
107
+ "entry": 2
108
+ }
109
+ ]
110
+ }
111
+ ]
112
+ },
113
+ {
114
+ "version": "0.6.0",
115
+ "date": "2026-09-15",
116
+ "sections": [
117
+ {
118
+ "title": "๐ŸŽ‰ Features",
119
+ "audience": "all",
120
+ "items": [
121
+ {
122
+ "description": "Move createTempTree from toolbelt.filesystem to toolbelt.testing (#313)",
123
+ "body": "- Moves `CreateTempTreeOptions` and the `TempTree` handle to `@williamthorsen/toolbelt.testing/candidate` along with `createTempTree`.\n\nMigration: 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.",
124
+ "breaking": true,
125
+ "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.",
126
+ "hash": "857dc50b69084af6de51cb557c0e54e0083e375d"
127
+ },
128
+ {
129
+ "description": "Add a ReadyUp adoption kit reporting hand-rolled package.json searches (#322)",
130
+ "body": "- Adds a ReadyUp adoption kit to `@williamthorsen/toolbelt.packaging` that recommends `findPackageRoot`, `resolveSelfVersion`, or `findProjectRoot` in place of a hand-rolled loop checking each ancestor directory for `package.json`.",
131
+ "hash": "4b31630255bfcf33106eb43c52b3ee1b5a753de8"
132
+ },
133
+ {
134
+ "description": "Read a directory walk's probed name through a binding or constant (#324)",
135
+ "body": "- Extends the ReadyUp adoption kit in `@williamthorsen/toolbelt.packaging` to recommend `findPackageRoot` or `resolveSelfVersion` for a hand-rolled `package.json` search that checks for the file through a variable declared once inside its loop and never reassigned there, or through a string constant declared once in the same file.\n- Stops the kit in `@williamthorsen/toolbelt.filesystem` from reporting such a search, which it previously treated as a generic directory walk.",
136
+ "hash": "59abc905f869bf251d2fb422ffb09b85f1e0e263"
137
+ },
138
+ {
139
+ "description": "Report hand-rolled dedents in the strings adoption kit (#330)",
140
+ "body": "- Adds `no-joined-line-array`, which reports an array of string or template literals that spans several lines and is joined with a newline.\n- Adds `no-layout-breaking-template`, which reports an untagged template literal whose later lines drop below the indentation of the line on which it opens.",
141
+ "hash": "5aa43ad1bb403642a6236e557bbe73af24891a66"
142
+ }
143
+ ]
144
+ },
145
+ {
146
+ "title": "๐Ÿงช Tests",
147
+ "audience": "dev",
148
+ "items": [
149
+ {
150
+ "description": "Move the rdy run report reader into the adoption test utilities (#323)",
151
+ "body": "- Replaces the `rdy run --json` report reader copied into each of the twelve `pragma-suppression.tool.test.ts` suites with `listKitCheckReports`, a helper added to `@williamthorsen/toolbelt.adoption/test-utils` that runs a package's compiled kit over a fixture repo and returns its check reports, so a change to the shape of readyup's report needs one edit rather than twelve.\n- Fixes the error thrown for a kit that does not load: Each copy discarded the load error recorded by `rdy` on the kit's entry and threw \"the run reported no adoption checks\", and the helper throws with `rdy`'s own message instead.",
152
+ "hash": "16a542b74f2bf5a06ef7f6390144e55cdc1930f2"
153
+ }
154
+ ]
155
+ },
156
+ {
157
+ "title": "โš™๏ธ Tooling",
158
+ "audience": "dev",
159
+ "items": [
160
+ {
161
+ "description": "Remove the stale repo-local cliff.toml and normalize changelog titles (#327)",
162
+ "body": "- 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`.\n- Excludes commits without a ticket prefix from future changelog entries.\n- 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.\n- 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.",
163
+ "hash": "2b3c4fe7a08f210adb66f4a4f5bfedc011908d36"
164
+ }
165
+ ]
166
+ },
167
+ {
168
+ "title": "๐Ÿ“š Documentation",
169
+ "audience": "dev",
170
+ "items": [
171
+ {
172
+ "description": "Align prose with plain-speech doctrine and writing conventions (#306)",
173
+ "body": "- Copy-edits prose across the repo: comments, test names, package READMEs, and `AGENTS.md`.\n- Rewrites a few user-facing strings as well, among them `configure-project`'s help text and the errors from `parseProjectSpec`, `securityCommands`, and `hashString`.",
174
+ "hash": "ab9c5a84a25e5084986733ecc79b88be9b9c7ef1"
175
+ }
176
+ ]
177
+ }
178
+ ]
179
+ },
180
+ {
181
+ "version": "0.5.5",
182
+ "date": "2026-09-06",
183
+ "sections": [
184
+ {
185
+ "title": "๐Ÿ“š Documentation",
186
+ "audience": "dev",
187
+ "items": [
188
+ {
189
+ "description": "Repair reduced object relatives in passages recurring across files (#262)",
190
+ "body": "Repairs the reduced object relative in the prose passages that recur across more than one file, in package READMEs, source comments, test titles, and the ReadyUp kits' check messages.",
191
+ "hash": "10e13b1b2e0d9b98b4924db5ecb86fcae08eb56b"
192
+ },
193
+ {
194
+ "description": "Repair reduced object relatives in the READMEs and AGENTS.md (#263)",
195
+ "body": "Repairs the reduced object relative in `AGENTS.md`, the root `README.md`, and the package READMEs.",
196
+ "hash": "0154bf51519c318d77e92fb5e8d8fbf9db9470ce"
197
+ },
198
+ {
199
+ "description": "Repair the repository's prose and record every rejection's ground (#290)",
200
+ "body": "Applies one repo-wide `revise-prose` sweep across the repository's READMEs, `AGENTS.md`, source comments, doc descriptions, and test names.",
201
+ "hash": "e04e58fb6172a585a9207d363f96c9e481031baf"
202
+ }
203
+ ]
204
+ }
205
+ ]
206
+ },
207
+ {
208
+ "version": "0.5.4",
209
+ "date": "2026-08-30",
210
+ "sections": [
211
+ {
212
+ "title": "Dependency updates",
213
+ "audience": "dev",
214
+ "items": [{ "description": "Bumped `@williamthorsen/toolbelt.filesystem` to 0.8.2" }]
215
+ }
216
+ ]
217
+ },
218
+ {
219
+ "version": "0.5.3",
220
+ "date": "2026-08-28",
221
+ "sections": [
222
+ {
223
+ "title": "Dependency updates",
224
+ "audience": "dev",
225
+ "items": [{ "description": "Bumped `@williamthorsen/toolbelt.filesystem` to 0.8.1" }]
226
+ }
227
+ ]
228
+ },
229
+ {
230
+ "version": "0.5.2",
231
+ "date": "2026-08-24",
232
+ "sections": [
233
+ {
234
+ "title": "Dependency updates",
235
+ "audience": "dev",
236
+ "items": [{ "description": "Bumped `@williamthorsen/toolbelt.filesystem` to 0.8.0" }]
237
+ }
238
+ ]
239
+ },
240
+ {
241
+ "version": "0.5.1",
242
+ "date": "2026-08-21",
243
+ "sections": [
244
+ {
245
+ "title": "Dependency updates",
246
+ "audience": "dev",
247
+ "items": [{ "description": "Bumped `@williamthorsen/toolbelt.filesystem` to 0.7.0" }]
248
+ }
249
+ ]
250
+ },
251
+ {
252
+ "version": "0.5.0",
253
+ "date": "2026-08-16",
254
+ "sections": [
255
+ {
256
+ "title": "๐ŸŽ‰ Features",
257
+ "audience": "all",
258
+ "items": [
259
+ {
260
+ "description": "Add `pointCwdAt`, a scope-bound cwd pointer (#178)",
261
+ "body": "Adds `pointCwdAt` to `@williamthorsen/toolbelt.testing/candidate`, a `Disposable` that points `process.cwd()` at a directory for the enclosing scope and restores the prior state when the scope exits.\n\nRestoration is by saved value rather than by spy, so scopes nest in any combination and neither `restoreMocks: true` nor a stray `vi.restoreAllMocks()` can point a suite back at the real working directory.",
262
+ "hash": "9f35d5286061345b16888fc0ef101b344b13085d"
263
+ }
264
+ ]
265
+ }
266
+ ]
267
+ },
268
+ {
269
+ "version": "0.4.0",
270
+ "date": "2026-08-15",
271
+ "sections": [
272
+ {
273
+ "title": "๐ŸŽ‰ Features",
274
+ "audience": "all",
275
+ "items": [
276
+ {
277
+ "description": "Promote createTempTree to the candidate tier with a caller-chosen prefix and binary entries (#148)",
278
+ "body": "Promotes `createTempTree` and `TempTree` to `@williamthorsen/toolbelt.filesystem/candidate`, adding two capabilities as they move: a caller-chosen prefix for the temporary directory's name, and file contents given as bytes. A prefix that would place the tree anywhere but directly inside the system temporary directory is rejected before anything is created.\n\nMigration: `createTempTree` and `TempTree` are imported from `@williamthorsen/toolbelt.filesystem/candidate` rather than `/proposed`.",
279
+ "breaking": true,
280
+ "migration": "`createTempTree` and `TempTree` are imported from `@williamthorsen/toolbelt.filesystem/candidate` rather than `/proposed`.",
281
+ "hash": "f0885cc49b3bcc8ab1585bb690e4ec779593235e"
282
+ }
283
+ ]
284
+ }
285
+ ]
286
+ },
287
+ {
288
+ "version": "0.3.1",
289
+ "date": "2026-08-13",
290
+ "sections": [
291
+ {
292
+ "title": "โš™๏ธ Tooling",
293
+ "audience": "dev",
294
+ "items": [
295
+ {
296
+ "description": "Remove redundant .gitignore files",
297
+ "hash": "d9bf7346a95b497e439398163202ca75deb48d1c"
298
+ },
299
+ {
300
+ "description": "Populate manifest metadata and adopt a pnpm catalog (#140)",
301
+ "body": "Adopts a pnpm catalog to avoid specifying the version of a common dependency in multiple places. Separately, fixes violations of newly activated `package-json` lint rules. Missing values have been added to `package.json` fields across the repo, and package descriptions are improved.",
302
+ "hash": "e01eff7c4af4a492b04b86762043565b408d6bea"
303
+ }
304
+ ]
305
+ }
306
+ ]
307
+ },
308
+ {
309
+ "version": "0.3.0",
310
+ "date": "2026-08-12",
311
+ "sections": [
312
+ {
313
+ "title": "๐ŸŽ‰ Features",
314
+ "audience": "all",
315
+ "items": [
316
+ {
317
+ "description": "Rename get* functions by return kind and verb specificity (#119)",
318
+ "body": "Renames thirteen functions across various packages to align with a consistent naming pattern.",
319
+ "breaking": true,
320
+ "hash": "eda0269aff5da9f97ba69ad17b9f381a0e248d5e"
321
+ }
322
+ ]
323
+ },
324
+ {
325
+ "title": "โ™ป๏ธ Refactoring",
326
+ "audience": "dev",
327
+ "items": [
328
+ {
329
+ "description": "Align stray modules with layout and TypeScript conventions (#118)",
330
+ "body": "Aligns all packages with code-layout and annotation conventions, ending a handful of long-standing exceptions. Documentation has been updated to make the conventions clear.",
331
+ "hash": "03fe37b2f5159348053db9cc21c5915b6847c26f"
332
+ }
333
+ ]
334
+ }
335
+ ]
336
+ },
337
+ {
338
+ "version": "0.2.0",
339
+ "date": "2026-08-08",
340
+ "sections": [
341
+ {
342
+ "title": "๐ŸŽ‰ Features",
343
+ "audience": "all",
344
+ "items": [
345
+ {
346
+ "description": "Scaffold toolbelt.packaging for project-layout utilities (#99)",
347
+ "body": "Adds `@williamthorsen/toolbelt.packaging`, a package scoped to package and project layout: where a package or project boundary begins, and what the manifest at that boundary declares. It exports nothing yet.",
348
+ "hash": "0cafd158a59535135033aabe051101e0ecb3af1b"
349
+ },
350
+ {
351
+ "description": "Add findPackageRoot, getSelfVersion, and findProjectRoot to toolbelt.packaging (#107)",
352
+ "body": "Adds a way for any module, whether it runs from a source tree or a compiled build, to identify the package that owns it and the version that package declares.\n\n`findProjectRoot` moves from `@williamthorsen/toolbelt.filesystem` to `@williamthorsen/toolbelt.packaging`. Callers of `loadConfigCascade` must now state where its upward search stops, rather than relying on a project root the function found for them.",
353
+ "breaking": true,
354
+ "hash": "dde45692f300586bc4154931edc483d49fc0defb"
355
+ }
356
+ ]
357
+ },
358
+ {
359
+ "title": "โš™๏ธ Tooling",
360
+ "audience": "dev",
361
+ "items": [
362
+ {
363
+ "description": "Use identical compiler settings for all packages (#105)",
364
+ "body": "All packages now have identical compiler settings, using the settings from the `@williamthorsen/tsconfig` base config without modification.",
365
+ "hash": "253af1cc885cb5d11e60b03221e2b38237874cf4"
366
+ }
367
+ ]
368
+ }
369
+ ]
370
+ }
371
+ ]
@@ -1,6 +1,6 @@
1
1
  /** @noformat -- @generated. Do not edit. Compiled by rdy. */
2
2
  /* eslint-disable */
3
- export const __readyupVersion = "0.40.0";
3
+ export const __readyupVersion = "0.43.0";
4
4
 
5
5
 
6
6
  // ../adoption/src/conventions/path-predicates.ts
@@ -71,10 +71,9 @@ function defineAdoptionKit(spec) {
71
71
  if (seen.has(id)) duplicated.add(id);
72
72
  seen.add(id);
73
73
  }
74
- if (duplicated.size > 0) {
75
- const ids = [...duplicated].toSorted().join(", ");
76
- throw new Error(`${spec.packageName}'s kit gives one id to more than one check: ${ids}`);
77
- }
74
+ if (duplicated.size === 0) return;
75
+ const ids = [...duplicated].toSorted().join(", ");
76
+ throw new Error(`${spec.packageName}'s kit gives one id to more than one check: ${ids}`);
78
77
  }
79
78
  function isSweptPath(path) {
80
79
  return sweptPathFilters.some((pathFilter) => pathFilter(path));
@@ -2,6 +2,14 @@
2
2
  "version": 1,
3
3
  "kits": [
4
4
  {
5
+ "checklistChecks": [
6
+ {
7
+ "checklist": "adoption",
8
+ "checks": [
9
+ "No source searches the directory chain for package.json by hand"
10
+ ]
11
+ }
12
+ ],
5
13
  "checklists": [
6
14
  "adoption"
7
15
  ],
@@ -19,7 +27,7 @@
19
27
  "path": "../../adoption/src/conventions/site-handoffs.ts"
20
28
  },
21
29
  {
22
- "hash": "e6e87602",
30
+ "hash": "7b9002b8",
23
31
  "kind": "module",
24
32
  "path": "../../adoption/src/kits/defineAdoptionKit.ts"
25
33
  },
@@ -44,7 +52,7 @@
44
52
  "path": "../../adoption/src/portable/listFunctionBodies.ts"
45
53
  },
46
54
  {
47
- "hash": "ce2e063d",
55
+ "hash": "1e9b8276",
48
56
  "kind": "module",
49
57
  "path": "../../adoption/src/portable/listTemplateLiterals.ts"
50
58
  },
@@ -81,10 +89,10 @@
81
89
  ],
82
90
  "name": "default",
83
91
  "path": "kits/default.js",
84
- "readyupVersion": "0.40.0",
92
+ "readyupVersion": "0.43.0",
85
93
  "source": "kits/default.ts",
86
94
  "sourceHash": "9b6938d1",
87
- "targetHash": "7ee14db9"
95
+ "targetHash": "ec65dcf4"
88
96
  }
89
97
  ]
90
98
  }
package/CHANGELOG.md CHANGED
@@ -2,8 +2,36 @@
2
2
 
3
3
  All notable changes to this project will be documented in this file.
4
4
 
5
+ ## 0.7.0 โ€” 2026-10-25
6
+
7
+ ### ๐ŸŽ‰ Features
8
+
9
+ - Adds the structured changelog `.meta/changelog.json` to each package's npm tarball, beside `CHANGELOG.md`. (#398)
10
+
11
+ ### โ™ป๏ธ Refactoring
12
+
13
+ - Replaces hand-rolled error descriptions, `instanceof Error` checks on caught values, record guards, directory ascents, and first-letter capitalization in package source with `describeError`, `isError`, `isRecord`, `isRecordOrArray`, `listDirectoryChain`, and `capitalize`, and declares each helper's package from another workspace as a `workspace:*` runtime dependency of the package that adopts it. (#400)
14
+
15
+ ### ๐Ÿงช Tests
16
+
17
+ - Rewrites the array-join fixtures and the untagged multi-line template fixtures in the readiness and parser tests as `dedent` templates that render the same text, and declares `@williamthorsen/toolbelt.strings` as a devDependency of each package that now imports `dedent` in its tests. (#401)
18
+
19
+ ## 0.6.4 โ€” 2026-10-24
20
+
21
+ ### ๐Ÿ“ฆ Dependencies
22
+
23
+ - Upgrade dependencies to latest compatible versions (#391)
24
+
25
+ Upgrades Node.js, pnpm, and the repository's dependencies to their latest compatible releases, which clears the three dev advisories that failed `nmr audit`. The upgrade to `@williamthorsen/eslint-config-typescript` 20.1.3 adds unicorn lint rules, and the code is adapted to them in the same change.
26
+
5
27
  ## 0.6.3 โ€” 2026-10-09
6
28
 
29
+ ### ๐ŸŽ‰ Features
30
+
31
+ - Add a ReadyUp kit recommending toolbelt.cli over hand-rolled argument parsing (#367)
32
+
33
+ Adds a ReadyUp adoption kit to `@williamthorsen/toolbelt.cli` that reports, through `rdy run --packages`, each call to `node:util`'s `parseArgs` and each function that compares arguments against flag names by hand. Includes `bin/` and `src/bin/` in the kit's sweep, which the other toolbelt kits exempt, because a command-line runner usually lives there.
34
+
7
35
  ### ๐Ÿ“š Documentation
8
36
 
9
37
  - Updates each kit README to show `rdy run --sources` and a `sources: ['npm:โ€ฆ']` config example, and states that this spelling needs readyup 0.40.0 or later. (#371)
@@ -12,6 +40,10 @@ All notable changes to this project will be documented in this file.
12
40
 
13
41
  ### ๐Ÿ“š Documentation
14
42
 
43
+ - Sweep the repository's comments against the comment discipline (#353)
44
+
45
+ Sweeps the comments in every authored source file against the comment discipline. The sweep cuts comments that restate the code or narrate history, corrects descriptions that contradicted the code, and adds descriptions to declarations that lacked one. It also tags the exported tier functions and classes that lacked `@category` and `@stage`, and corrects test titles that misstated their tests.
46
+
15
47
  - Revises READMEs, doc comments, and test names across the repository to follow the current `plain-speech` and writing-preference rules. (#354)
16
48
  - Rewords the help text and messages printed by `tb-jira`, `tb-node`, and `tb-secret`, and the advice and skip reasons reported by the adoption kits, to follow the same writing conventions. (#354)
17
49
 
package/README.md CHANGED
@@ -4,7 +4,13 @@
4
4
 
5
5
  Package and project layout utilities for TypeScript and JavaScript: where a package or project boundary begins, and what the manifest at that boundary declares.
6
6
 
7
- <!-- section:release-notes --><!-- /section:release-notes -->
7
+ <!-- section:release-notes -->
8
+ ## Release notes โ€” v0.7.0 (2026-10-25)
9
+
10
+ ### ๐ŸŽ‰ Features
11
+
12
+ - Adds the structured changelog `.meta/changelog.json` to each package's npm tarball, beside `CHANGELOG.md`. (#398)
13
+ <!-- /section:release-notes -->
8
14
 
9
15
  ## Installation
10
16
 
@@ -2,6 +2,7 @@ import fs from 'node:fs';
2
2
  import path from 'node:path';
3
3
  import { fileURLToPath } from 'node:url';
4
4
  import { listDirectoryChain } from '@williamthorsen/toolbelt.filesystem';
5
+ import { isRecord } from '@williamthorsen/toolbelt.objects';
5
6
  export function resolveOwningManifest(fromUrl) {
6
7
  const startDir = path.dirname(fileURLToPath(fromUrl));
7
8
  for (const dir of listDirectoryChain(startDir)) {
@@ -16,7 +17,7 @@ export function resolveOwningManifest(fromUrl) {
16
17
  throw new Error(`No package.json declaring a name was found at or above: ${fromUrl}`);
17
18
  }
18
19
  function isPackageManifest(value) {
19
- return typeof value === 'object' && value !== null && !Array.isArray(value);
20
+ return isRecord(value);
20
21
  }
21
22
  function readManifest(manifestPath) {
22
23
  let parsed;
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@williamthorsen/toolbelt.packaging",
3
- "version": "0.6.3",
3
+ "version": "0.7.0",
4
4
  "description": "Package and project layout utilities: where a package or project boundary begins, and what its manifest declares",
5
5
  "keywords": [
6
6
  "esm",
@@ -42,16 +42,19 @@
42
42
  ".readyup/kits/*.js",
43
43
  ".readyup/manifest.json",
44
44
  "dist/*",
45
- "CHANGELOG.md"
45
+ "CHANGELOG.md",
46
+ ".meta/changelog.json"
46
47
  ],
47
48
  "dependencies": {
48
- "@williamthorsen/toolbelt.filesystem": "0.9.3"
49
+ "@williamthorsen/toolbelt.filesystem": "0.10.0",
50
+ "@williamthorsen/toolbelt.objects": "4.4.0"
49
51
  },
50
52
  "devDependencies": {
51
53
  "@williamthorsen/toolbelt.adoption": "0.1.0",
52
- "@williamthorsen/toolbelt.testing": "0.6.3",
54
+ "@williamthorsen/toolbelt.strings": "8.1.0",
55
+ "@williamthorsen/toolbelt.testing": "0.8.0",
53
56
  "esbuild": "0.28.2",
54
- "readyup": "0.40.0"
57
+ "readyup": "0.43.0"
55
58
  },
56
59
  "engines": {
57
60
  "node": ">=24.0.0"