@tallyrelease/core 0.3.0 → 0.3.1

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## [0.3.1](https://github.com/abinnovision/tallyrelease/compare/core-v0.3.0...core-v0.3.1) (2026-10-16)
+
+
+### Bug Fixes
+
+* **core:** count prereleases from a unit's introduction without a line base ([#48](https://github.com/abinnovision/tallyrelease/issues/48)) ([06a591b](https://github.com/abinnovision/tallyrelease/commit/06a591b3522cf60ce5bde56e393f464617ffa101))
+
 ## [0.3.0](https://github.com/abinnovision/tally-release/compare/core-v0.2.0...core-v0.3.0) (2026-10-16)
 
 

package/README.md

@@ -1,6 +1,6 @@
 # @tallyrelease/core
 
-Pure planning core and plugin contract for [tallyrelease](https://github.com/abinnovision/tally-release). It does no I/O: files and git are read through the injected `ReadonlyFs`, `Ctx` and `GitReader`.
+Pure planning core and plugin contract for [tallyrelease](https://github.com/abinnovision/tallyrelease). It does no I/O: files and git are read through the injected `ReadonlyFs`, `Ctx` and `GitReader`.
 
 Most users want [`@tallyrelease/cli`](https://www.npmjs.com/package/@tallyrelease/cli) instead. Install this package to write an ecosystem plugin or to embed the planner.
 
@@ -22,7 +22,7 @@ export const example = definePlugin({
 });
 ```
 
-See `Plugin` in [`src/plugin.ts`](https://github.com/abinnovision/tally-release/blob/main/packages/core/src/plugin.ts) for the available hooks (`discover`, `edges`, `inputs`, `versionFiles`, `schemes`, `intent`).
+See `Plugin` in [`src/plugin.ts`](https://github.com/abinnovision/tallyrelease/blob/main/packages/core/src/plugin.ts) for the available hooks (`discover`, `edges`, `inputs`, `versionFiles`, `schemes`, `intent`).
 
 ## Testing
 

package/dist/explain.d.ts

@@ -25,6 +25,8 @@ export interface UnitExplanation {
         name: string;
         members: string[];
     } | null;
+    /** Origin of the prerelease counter without a line base; see `UnitFacts`. */
+    introduced: string | null;
     /** What set `unit.next`: the bump, the initial version or a Release-As value. */
     nextSource: "bump" | "initial" | "release-as" | null;
     /** Changed unit files (reason `direct`) or changed global inputs (`global`). */

package/dist/explain.js

@@ -52,6 +52,7 @@ export const explainUnit = async (workspace, git, { unit: id, ...opts }) => {
         plan,
         unit,
         group: group ? { name: group.name, members: [...group.members] } : null,
+        introduced: unitFacts?.introduced ?? null,
         nextSource: releases.get(id)?.nextSource ?? null,
         files,
         changes,

package/dist/facts.d.ts

@@ -40,6 +40,15 @@ export interface UnitFacts {
     readonly fromTag: UnitTag | null;
     /** Highest stable tag on head's first-parent chain. */
     readonly lineBaseTag: UnitTag | null;
+    /**
+     * Without a line base and with a root other than `.`: the oldest commit on
+     * head's first-parent chain that touches the unit root.
+     */
+    readonly introduced: string | null;
+    /**
+     * First-parent commits since the line base; without one, since and
+     * including `introduced`, else `total`.
+     */
     readonly sinceLineBase: number;
     readonly total: number;
     /** Changes since the base tag attributed to this unit, core commit order. */
@@ -61,6 +70,7 @@ export interface GroupFacts {
     readonly baseTag: UnitTag | null;
     /** Highest stable member tag on head's first-parent chain. */
     readonly lineBaseTag: UnitTag | null;
+    /** Without a line base, the max over the members. */
     readonly sinceLineBase: number;
 }
 /** Git and intent data of every released unit, collected before release math. */

package/dist/facts.js

@@ -156,6 +156,20 @@ export const collectPlanFacts = async (workspace, git, opts) => {
         }
         return a.sha !== b.sha && (await isAncestor(a.sha, b.sha)) ? b : a;
     };
+    /** Counter since the line base; without one, since the unit's introduction. */
+    const lineCount = async (root, lineBaseTag) => {
+        if (lineBaseTag) {
+            return {
+                introduced: null,
+                sinceLineBase: await countSince(lineBaseTag.sha),
+            };
+        }
+        const introduced = root === "." ? null : await git.introduced(root, head);
+        return {
+            introduced,
+            sinceLineBase: introduced === null ? total : (await countSince(introduced)) + 1,
+        };
+    };
     const bases = new Map();
     for (const unit of workspace.units) {
         const matched = tags.get(unit.id);
@@ -173,9 +187,14 @@ export const collectPlanFacts = async (workspace, git, opts) => {
                 break;
             }
         }
-        bases.set(unit.id, { scheme, baseTag: stable.at(-1) ?? null, lineBaseTag });
+        bases.set(unit.id, {
+            scheme,
+            baseTag: stable.at(-1) ?? null,
+            lineBaseTag,
+            // eslint-disable-next-line no-await-in-loop -- one git call per unit
+            ...(await lineCount(unit.root, lineBaseTag)),
+        });
     }
-    const sinceLine = async (tag) => tag ? await countSince(tag.sha) : total;
     const groups = [];
     for (const { name, members } of workspace.groups) {
         let baseTag = null;
@@ -194,8 +213,10 @@ export const collectPlanFacts = async (workspace, git, opts) => {
             members,
             baseTag,
             lineBaseTag,
-            // eslint-disable-next-line no-await-in-loop -- memoized per line base
-            sinceLineBase: await sinceLine(lineBaseTag),
+            sinceLineBase: lineBaseTag
+                ? // eslint-disable-next-line no-await-in-loop -- memoized per line base
+                    await countSince(lineBaseTag.sha)
+                : Math.max(0, ...members.map((id) => bases.get(id)?.sinceLineBase ?? 0)),
         });
     }
     const groupOf = new Map(groups.flatMap((g) => g.members.map((id) => [id, g])));
@@ -206,7 +227,7 @@ export const collectPlanFacts = async (workspace, git, opts) => {
         if (!matched || !own) {
             continue;
         }
-        const { baseTag, lineBaseTag } = own;
+        const { baseTag, lineBaseTag, introduced, sinceLineBase } = own;
         const group = groupOf.get(unit.id);
         const fromTag = group ? group.baseTag : baseTag;
         const rangeBase = group &&
@@ -227,8 +248,8 @@ export const collectPlanFacts = async (workspace, git, opts) => {
             baseTag,
             fromTag,
             lineBaseTag,
-            // eslint-disable-next-line no-await-in-loop -- memoized per line base
-            sinceLineBase: await sinceLine(lineBaseTag),
+            introduced,
+            sinceLineBase,
             total,
             changes: changes.filter((c) => c.units.includes(unit.id)),
             releaseAs: changes.flatMap(({ change }) => (change.releaseAs ?? [])

package/dist/plugin.d.ts

@@ -55,6 +55,12 @@ export interface GitReader {
     countFirstParent: (from: string | null, to: string) => MaybePromise<number>;
     /** Tree-to-tree changed paths without rename detection, sorted. */
     diffFiles: (from: string, to: string) => MaybePromise<readonly string[]>;
+    /**
+     * Oldest commit on the first-parent chain of `to` whose diff to its first
+     * parent (the empty tree for a root commit) touches a file under directory
+     * `path`; null if none.
+     */
+    introduced: (path: string, to: string) => MaybePromise<string | null>;
 }
 export interface TagRef {
     name: string;

package/dist/testing.d.ts

@@ -52,5 +52,6 @@ export type ReaderFactory = (dag: Dag) => MaybePromise<{
  * chain, c branches from b and merges into m, d renames pkg/x.ts to pkg/y.ts,
  * f adds a path with a quote, a tab and a non-ASCII character, g is empty and
  * h carries footers. `a` has a later committer date than b, c and d.
+ * `introduced` runs on its own fixture.
  */
 export declare const gitReaderConformance: (makeReader: ReaderFactory) => void;

package/dist/testing.js

@@ -43,6 +43,26 @@ const CONFORMANCE_DAG = {
         { name: "side", commit: "c" },
     ],
 };
+/**
+ * First-parent chain r - s - t - u - m - v; k branches from r and merges into
+ * m. s adds pkg/ab, t adds pkg/a, u deletes it and v re-adds it. k adds side
+ * and gone, m drops gone and v adds it again.
+ */
+const INTRODUCED_DAG = {
+    commits: [
+        { id: "r", files: { "lib/r.ts": "r\n" } },
+        { id: "s", files: { "pkg/ab/x.ts": "s\n" } },
+        {
+            id: "k",
+            parents: ["r"],
+            files: { "side/k.ts": "k\n", "gone/x.ts": "k\n" },
+        },
+        { id: "t", parents: ["s"], files: { "pkg/a/x.ts": "t\n" } },
+        { id: "u", files: { "pkg/a/x.ts": null } },
+        { id: "m", parents: ["u", "k"], files: { "gone/x.ts": null } },
+        { id: "v", files: { "pkg/a/x.ts": "v\n", "gone/x.ts": "v\n" } },
+    ],
+};
 /** In-memory `ReadonlyFs` over a path-to-content map. */
 export const memoryFs = (files) => {
     const paths = Object.keys(files).sort(compare);
@@ -171,6 +191,13 @@ export const memoryGit = (dag) => {
             return firstParentChain(to).filter((n) => !skip.has(n.id)).length;
         },
         diffFiles: (from, to) => changed(node(from).tree, node(to).tree),
+        introduced: (path, to) => {
+            const under = (p) => p === path || p.startsWith(`${path}/`);
+            const intro = firstParentChain(to)
+                .reverse()
+                .find((n) => changed(n.parents[0] === undefined ? new Map() : node(n.parents[0]).tree, n.tree).some(under));
+            return intro?.id ?? null;
+        },
         tree: (ref) => Object.fromEntries(node(ref).tree),
         parents: (ref) => [...node(ref).parents],
     };
@@ -180,6 +207,7 @@ export const memoryGit = (dag) => {
  * chain, c branches from b and merges into m, d renames pkg/x.ts to pkg/y.ts,
  * f adds a path with a quote, a tab and a non-ASCII character, g is empty and
  * h carries footers. `a` has a later committer date than b, c and d.
+ * `introduced` runs on its own fixture.
  */
 export const gitReaderConformance = (makeReader) => {
     describe("GitReader conformance", () => {
@@ -290,5 +318,29 @@ export const gitReaderConformance = (makeReader) => {
                 [ODD_PATH],
             ]);
         });
+        describe("introduced", () => {
+            let intro;
+            let introSha;
+            const introduced = async (path) => await intro.introduced(path, introSha("v"));
+            beforeAll(async () => {
+                ({ git: intro, sha: introSha } = await makeReader(INTRODUCED_DAG));
+            });
+            it("finds the commit that adds a path on the chain", async () => {
+                expect(await introduced("lib")).toBe(introSha("r"));
+                expect(await introduced("pkg/ab")).toBe(introSha("s"));
+            });
+            it("attributes a path added on a side branch to the merge", async () => {
+                expect(await introduced("side")).toBe(introSha("m"));
+            });
+            it("matches whole directories and keeps the oldest commit", async () => {
+                expect(await introduced("pkg/a")).toBe(introSha("t"));
+            });
+            it("skips a merge identical to its first parent for the path", async () => {
+                expect(await introduced("gone")).toBe(introSha("v"));
+            });
+            it("returns null for a path no commit touches", async () => {
+                expect(await introduced("missing")).toBeNull();
+            });
+        });
     });
 };

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "@tallyrelease/core",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "description": "Pure planning core of tallyrelease",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/abinnovision/tally-release.git",
+    "url": "git+https://github.com/abinnovision/tallyrelease.git",
     "directory": "packages/core"
   },
   "license": "Apache-2.0",