@avi2dg/checks 0.24.0 → 0.24.1

package/CHANGELOG.md

@@ -2,6 +2,14 @@
 
 Every release of `@avi2dg/checks`, newest first, written by the release from its conventional commits.
 
+## 0.24.1
+
+Released 2026-09-27.
+
+### Fixes
+
+- **scripts:** let checks-changelog release a repository that gains its version late [#79](https://github.com/avi2d/checks/pull/79)
+
 ## 0.24.0
 
 Released 2026-09-27.

package/docs/gates/checks-changelog.md

@@ -20,6 +20,7 @@ A release with no conventional commit worth listing keeps only its heading and i
 
 It reads `package.json`, `CHANGELOG.md` and the git history from the repository root.
 It finds releases in the version bumps of `package.json` across all of `HEAD` ancestry, so a checkout without tags writes the same file.
+It reads a commit whose `package.json` is missing or has no version as unversioned, so the commit that adds the version is the first release and a repository that adopts a version late still writes its changelog.
 It refuses a shallow checkout, since the releases reach back past its history.
 It refuses a `package.json` with no repository address, since each entry links its pull request under it.
 It refuses a repository address that is no `https` address once `git+`, a trailing slash and `.git` are dropped, since a pull request link needs one.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@avi2dg/checks",
-  "version": "0.24.0",
+  "version": "0.24.1",
   "description": "Deterministic checks shared across the captain's TypeScript repos",
   "license": "MIT",
   "repository": {

package/scripts/changelog-write.ts

@@ -24,9 +24,14 @@ const decodeManifestJson = Schema.decodeUnknownEffect(
   ),
 );
 
+const decodeVersionJson = Schema.decodeUnknownEffect(Schema.fromJsonString(Schema.Struct({ version: Schema.optional(Schema.String) })));
+
 const decodeManifest = (text: string, source: string) =>
   decodeManifestJson(text).pipe(Effect.mapError((cause) => new ChangelogUnreadable({ message: `${source}: ${cause.message}` })));
 
+const decodeVersion = (text: string, source: string) =>
+  decodeVersionJson(text).pipe(Effect.mapError((cause) => new ChangelogUnreadable({ message: `${source}: ${cause.message}` })));
+
 const today = DateTime.nowInCurrentZone.pipe(DateTime.withCurrentZoneLocal, Effect.map(DateTime.formatIsoDate));
 
 function repositoryWebUrl(repository: string): string | undefined {
@@ -38,7 +43,9 @@ function repositoryWebUrl(repository: string): string | undefined {
 }
 
 const versionAt = Effect.fn("versionAt")(function* (root: string, sha: string) {
-  return (yield* decodeManifest(yield* git(["show", `${sha}:${MANIFEST}`], root), `${MANIFEST} at ${sha}`)).version;
+  const blob = (yield* git(["ls-tree", "--object-only", sha, "--", MANIFEST], root)).trim();
+  if (blob === "") return undefined;
+  return (yield* decodeVersion(yield* git(["cat-file", "blob", blob], root), `${MANIFEST} at ${sha}`)).version;
 });
 
 const readBumps = Effect.fn("readBumps")(function* (root: string) {
@@ -51,6 +58,7 @@ const readBumps = Effect.fn("readBumps")(function* (root: string) {
     const [sha, date, parent] = line.split(FIELD);
     if (sha === undefined || date === undefined || parent === undefined) continue;
     const version = yield* versionAt(root, sha);
+    if (version === undefined) continue;
     if (parent === "" || (yield* versionAt(root, parent)) !== version) bumps.push({ sha, version, date });
   }
   return bumps;