@opencodehub/ingestion 0.1.0

package/dist/pipeline/phases/temporal-helpers/branch-divergence.js

@@ -0,0 +1,96 @@
+/**
+ * Branch divergence — counts `ahead` and `behind` commits relative to the
+ * configured base branch, plus the list of files uniquely touched by the
+ * ahead commits.
+ *
+ * Uses two git subprocesses per branch:
+ *   1. `git rev-list --left-right --count <base>...<ref>` → tab-separated
+ *      pair "behind<TAB>ahead".
+ *   2. `git log <base>..<ref> --name-only --format=` → newline-separated
+ *      file paths, deduplicated in first-seen order.
+ *
+ * The caller supplies the base branch name (typically `main`) and the list
+ * of candidate head refs. The function fails open: any git error leaves the
+ * affected branch's entry absent from the returned map.
+ */
+import { execFile } from "node:child_process";
+import { promisify } from "node:util";
+const execFileAsync = promisify(execFile);
+const DEFAULT_MAX_OVERLAP_FILES = 100;
+const DEFAULT_MAX_BUFFER = 64 * 1024 * 1024; // 64 MB
+/**
+ * List local branches via `git for-each-ref refs/heads/`. Returns short ref
+ * names sorted lexicographically so downstream iteration is deterministic.
+ */
+export async function listLocalBranches(repoPath) {
+    try {
+        const { stdout } = await execFileAsync("git", ["for-each-ref", "--format=%(refname:short)", "refs/heads/"], { cwd: repoPath, maxBuffer: DEFAULT_MAX_BUFFER });
+        const names = stdout
+            .split("\n")
+            .map((s) => s.trim())
+            .filter((s) => s.length > 0);
+        return [...names].sort();
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Compute divergence for each branch relative to `baseBranch`.
+ *
+ * Branches equal to the base or failing to resolve are omitted from the
+ * result map.
+ */
+export async function computeBranchDivergence(opts) {
+    const { repoPath, baseBranch, branches } = opts;
+    const overlapCap = opts.maxOverlapFiles ?? DEFAULT_MAX_OVERLAP_FILES;
+    const entries = new Map();
+    for (const ref of branches) {
+        if (ref === baseBranch)
+            continue;
+        const count = await revListLeftRight(repoPath, baseBranch, ref);
+        if (count === undefined)
+            continue;
+        const overlap = await aheadFiles(repoPath, baseBranch, ref, overlapCap);
+        entries.set(ref, { ahead: count.ahead, behind: count.behind, overlapFiles: overlap });
+    }
+    return { entries };
+}
+async function revListLeftRight(repoPath, base, ref) {
+    try {
+        const { stdout } = await execFileAsync("git", ["rev-list", "--left-right", "--count", `${base}...${ref}`], { cwd: repoPath, maxBuffer: DEFAULT_MAX_BUFFER });
+        const trimmed = stdout.trim();
+        const parts = trimmed.split(/\s+/);
+        if (parts.length !== 2)
+            return undefined;
+        const behind = Number(parts[0]);
+        const ahead = Number(parts[1]);
+        if (!Number.isFinite(behind) || !Number.isFinite(ahead))
+            return undefined;
+        return { ahead, behind };
+    }
+    catch {
+        return undefined;
+    }
+}
+async function aheadFiles(repoPath, base, ref, cap) {
+    try {
+        const { stdout } = await execFileAsync("git", ["log", `${base}..${ref}`, "--name-only", "--format="], { cwd: repoPath, maxBuffer: DEFAULT_MAX_BUFFER });
+        const seen = new Set();
+        for (const line of stdout.split("\n")) {
+            const path = line.trim();
+            if (path.length === 0)
+                continue;
+            if (seen.has(path))
+                continue;
+            seen.add(path);
+            if (seen.size >= cap)
+                break;
+        }
+        return [...seen].sort();
+    }
+    catch {
+        return [];
+    }
+}
+//# sourceMappingURL=branch-divergence.js.map

package/dist/pipeline/phases/temporal-helpers/branch-divergence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"branch-divergence.js","sourceRoot":"","sources":["../../../../src/pipeline/phases/temporal-helpers/branch-divergence.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,MAAM,aAAa,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;AAE1C,MAAM,yBAAyB,GAAG,GAAG,CAAC;AACtC,MAAM,kBAAkB,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC,CAAC,QAAQ;AAmBrD;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,QAAgB;IACtD,IAAI,CAAC;QACH,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,aAAa,CACpC,KAAK,EACL,CAAC,cAAc,EAAE,2BAA2B,EAAE,aAAa,CAAC,EAC5D,EAAE,GAAG,EAAE,QAAQ,EAAE,SAAS,EAAE,kBAAkB,EAAE,CACjD,CAAC;QACF,MAAM,KAAK,GAAG,MAAM;aACjB,KAAK,CAAC,IAAI,CAAC;aACX,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;aACpB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QAC/B,OAAO,CAAC,GAAG,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC;IAC3B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,IAA6B;IAE7B,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC;IAChD,MAAM,UAAU,GAAG,IAAI,CAAC,eAAe,IAAI,yBAAyB,CAAC;IACrE,MAAM,OAAO,GAAG,IAAI,GAAG,EAAiC,CAAC;IACzD,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;QAC3B,IAAI,GAAG,KAAK,UAAU;YAAE,SAAS;QACjC,MAAM,KAAK,GAAG,MAAM,gBAAgB,CAAC,QAAQ,EAAE,UAAU,EAAE,GAAG,CAAC,CAAC;QAChE,IAAI,KAAK,KAAK,SAAS;YAAE,SAAS;QAClC,MAAM,OAAO,GAAG,MAAM,UAAU,CAAC,QAAQ,EAAE,UAAU,EAAE,GAAG,EAAE,UAAU,CAAC,CAAC;QACxE,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,CAAC,CAAC;IACxF,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,CAAC;AACrB,CAAC;AAED,KAAK,UAAU,gBAAgB,CAC7B,QAAgB,EAChB,IAAY,EACZ,GAAW;IAEX,IAAI,CAAC;QACH,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,aAAa,CACpC,KAAK,EACL,CAAC,UAAU,EAAE,cAAc,EAAE,SAAS,EAAE,GAAG,IAAI,MAAM,GAAG,EAAE,CAAC,EAC3D,EAAE,GAAG,EAAE,QAAQ,EAAE,SAAS,EAAE,kBAAkB,EAAE,CACjD,CAAC;QACF,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC;QAC9B,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACnC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,SAAS,CAAC;QACzC,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QAChC,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QAC/B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;YAAE,OAAO,SAAS,CAAC;QAC1E,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IAC3B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,KAAK,UAAU,UAAU,CACvB,QAAgB,EAChB,IAAY,EACZ,GAAW,EACX,GAAW;IAEX,IAAI,CAAC;QACH,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,aAAa,CACpC,KAAK,EACL,CAAC,KAAK,EAAE,GAAG,IAAI,KAAK,GAAG,EAAE,EAAE,aAAa,EAAE,WAAW,CAAC,EACtD,EAAE,GAAG,EAAE,QAAQ,EAAE,SAAS,EAAE,kBAAkB,EAAE,CACjD,CAAC;QACF,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;QAC/B,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;YACtC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;YACzB,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;gBAAE,SAAS;YAChC,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC;gBAAE,SAAS;YAC7B,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YACf,IAAI,IAAI,CAAC,IAAI,IAAI,GAAG;gBAAE,MAAM;QAC9B,CAAC;QACD,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;IAC1B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC"}

package/dist/pipeline/phases/temporal-helpers/churn-decay.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Exponentially-decayed churn weighting.
+ *
+ * Given a committer timestamp (epoch seconds) and a reference "now" (also
+ * epoch seconds), return the decay weight applied to the commit's lines
+ * changed. A 90-day half-life is the default: a 0-day-old commit contributes
+ * 1.0× its line count, a 90-day-old commit contributes 0.5×, and a 180-day-
+ * old commit contributes 0.25×.
+ *
+ * Future-dated commits (timestamps after `now`) are clamped to 0 age so the
+ * weight never exceeds 1.0.
+ */
+export declare const DEFAULT_CHURN_HALF_LIFE_DAYS = 90;
+/**
+ * Compute the decay weight in [0, 1] for a commit's churn contribution.
+ *
+ * @param commitCtEpochSec committer timestamp in epoch seconds
+ * @param nowEpochSec reference "now" timestamp in epoch seconds
+ * @param halfLifeDays half-life; must be positive
+ */
+export declare function decayWeight(commitCtEpochSec: number, nowEpochSec: number, halfLifeDays?: number): number;
+//# sourceMappingURL=churn-decay.d.ts.map

package/dist/pipeline/phases/temporal-helpers/churn-decay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"churn-decay.d.ts","sourceRoot":"","sources":["../../../../src/pipeline/phases/temporal-helpers/churn-decay.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,eAAO,MAAM,4BAA4B,KAAK,CAAC;AAG/C;;;;;;GAMG;AACH,wBAAgB,WAAW,CACzB,gBAAgB,EAAE,MAAM,EACxB,WAAW,EAAE,MAAM,EACnB,YAAY,GAAE,MAAqC,GAClD,MAAM,CASR"}

package/dist/pipeline/phases/temporal-helpers/churn-decay.js

@@ -0,0 +1,32 @@
+/**
+ * Exponentially-decayed churn weighting.
+ *
+ * Given a committer timestamp (epoch seconds) and a reference "now" (also
+ * epoch seconds), return the decay weight applied to the commit's lines
+ * changed. A 90-day half-life is the default: a 0-day-old commit contributes
+ * 1.0× its line count, a 90-day-old commit contributes 0.5×, and a 180-day-
+ * old commit contributes 0.25×.
+ *
+ * Future-dated commits (timestamps after `now`) are clamped to 0 age so the
+ * weight never exceeds 1.0.
+ */
+export const DEFAULT_CHURN_HALF_LIFE_DAYS = 90;
+const SECONDS_PER_DAY = 86_400;
+/**
+ * Compute the decay weight in [0, 1] for a commit's churn contribution.
+ *
+ * @param commitCtEpochSec committer timestamp in epoch seconds
+ * @param nowEpochSec reference "now" timestamp in epoch seconds
+ * @param halfLifeDays half-life; must be positive
+ */
+export function decayWeight(commitCtEpochSec, nowEpochSec, halfLifeDays = DEFAULT_CHURN_HALF_LIFE_DAYS) {
+    if (halfLifeDays <= 0) {
+        throw new Error("decayWeight: halfLifeDays must be > 0");
+    }
+    const rawAgeSec = nowEpochSec - commitCtEpochSec;
+    const ageSec = rawAgeSec < 0 ? 0 : rawAgeSec;
+    const ageDays = ageSec / SECONDS_PER_DAY;
+    const lambda = Math.LN2 / halfLifeDays;
+    return Math.exp(-lambda * ageDays);
+}
+//# sourceMappingURL=churn-decay.js.map

package/dist/pipeline/phases/temporal-helpers/churn-decay.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"churn-decay.js","sourceRoot":"","sources":["../../../../src/pipeline/phases/temporal-helpers/churn-decay.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,MAAM,CAAC,MAAM,4BAA4B,GAAG,EAAE,CAAC;AAC/C,MAAM,eAAe,GAAG,MAAM,CAAC;AAE/B;;;;;;GAMG;AACH,MAAM,UAAU,WAAW,CACzB,gBAAwB,EACxB,WAAmB,EACnB,eAAuB,4BAA4B;IAEnD,IAAI,YAAY,IAAI,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;IAC3D,CAAC;IACD,MAAM,SAAS,GAAG,WAAW,GAAG,gBAAgB,CAAC;IACjD,MAAM,MAAM,GAAG,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC7C,MAAM,OAAO,GAAG,MAAM,GAAG,eAAe,CAAC;IACzC,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,GAAG,YAAY,CAAC;IACvC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,MAAM,GAAG,OAAO,CAAC,CAAC;AACrC,CAAC"}

package/dist/pipeline/phases/temporal-helpers/conventional-commits.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Conventional-Commits subject-line classifier.
+ *
+ * Only the subject line is inspected — the canonical spec places the type
+ * prefix there. The grammar accepted is the de-facto commitlint subset:
+ *   `<type>(<scope>)?!?: <description>`
+ * where `<type>` is one of the 11 types named in the spec (plus `revert`).
+ */
+/**
+ * Return the lowercase type token for a Conventional-Commit subject, or
+ * `undefined` if the subject is non-conforming.
+ */
+export declare function classifyConventionalType(subject: string): string | undefined;
+/**
+ * Return a sort-stable histogram copy keyed by type.
+ *
+ * Sorting guarantees downstream JSON serialisation is byte-stable regardless
+ * of insertion order.
+ */
+export declare function sortedHistogram(hist: ReadonlyMap<string, number>): Record<string, number>;
+//# sourceMappingURL=conventional-commits.d.ts.map

package/dist/pipeline/phases/temporal-helpers/conventional-commits.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conventional-commits.d.ts","sourceRoot":"","sources":["../../../../src/pipeline/phases/temporal-helpers/conventional-commits.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAM5E;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAOzF"}

package/dist/pipeline/phases/temporal-helpers/conventional-commits.js

@@ -0,0 +1,37 @@
+/**
+ * Conventional-Commits subject-line classifier.
+ *
+ * Only the subject line is inspected — the canonical spec places the type
+ * prefix there. The grammar accepted is the de-facto commitlint subset:
+ *   `<type>(<scope>)?!?: <description>`
+ * where `<type>` is one of the 11 types named in the spec (plus `revert`).
+ */
+const CONVENTIONAL_COMMIT_RE = /^(feat|fix|docs|style|refactor|perf|test|build|ci|chore|revert)(\([^)]+\))?!?:/i;
+/**
+ * Return the lowercase type token for a Conventional-Commit subject, or
+ * `undefined` if the subject is non-conforming.
+ */
+export function classifyConventionalType(subject) {
+    const match = CONVENTIONAL_COMMIT_RE.exec(subject);
+    if (match === null)
+        return undefined;
+    const type = match[1];
+    if (type === undefined)
+        return undefined;
+    return type.toLowerCase();
+}
+/**
+ * Return a sort-stable histogram copy keyed by type.
+ *
+ * Sorting guarantees downstream JSON serialisation is byte-stable regardless
+ * of insertion order.
+ */
+export function sortedHistogram(hist) {
+    const keys = [...hist.keys()].sort();
+    const out = {};
+    for (const k of keys) {
+        out[k] = hist.get(k) ?? 0;
+    }
+    return out;
+}
+//# sourceMappingURL=conventional-commits.js.map

package/dist/pipeline/phases/temporal-helpers/conventional-commits.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conventional-commits.js","sourceRoot":"","sources":["../../../../src/pipeline/phases/temporal-helpers/conventional-commits.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,sBAAsB,GAC1B,iFAAiF,CAAC;AAEpF;;;GAGG;AACH,MAAM,UAAU,wBAAwB,CAAC,OAAe;IACtD,MAAM,KAAK,GAAG,sBAAsB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACnD,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,SAAS,CAAC;IACrC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IACtB,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IACzC,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC;AAC5B,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,IAAiC;IAC/D,MAAM,IAAI,GAAG,CAAC,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACrC,MAAM,GAAG,GAA2B,EAAE,CAAC;IACvC,KAAK,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;QACrB,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/pipeline/phases/temporal-helpers/gini.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Gini inequality coefficient and bus-factor proxy.
+ *
+ * The Gini coefficient is computed on a sorted contribution vector using the
+ * O(n log n) mean-rank identity, which avoids the O(n^2) pairwise loop while
+ * remaining numerically stable:
+ *
+ *   G = (2 * Σᵢ i·x[i]) / (n · Σx) − (n + 1) / n
+ *
+ * with `i` 1-indexed after ascending sort. G = 0 when all values are equal
+ * and approaches 1 as inequality grows.
+ *
+ * Bus factor collapses inequality into an integer head-count proxy. The
+ * corrected formula (see research notes) is:
+ *
+ *   busFactor = max(1, min(n, 1 + round((1 - G) · (n - 1))))
+ *
+ * which returns 1 for a single author, `n` for perfectly uniform contribution,
+ * and 1 for a highly-skewed distribution.
+ */
+/**
+ * Compute the Gini coefficient for a vector of non-negative contribution
+ * counts. Zero, empty, and all-equal inputs all yield 0.
+ */
+export declare function gini(counts: readonly number[]): number;
+/**
+ * Derive the bus factor from a per-contributor count vector.
+ *
+ * Returns 1 when the vector is empty or contains only zero totals.
+ */
+export declare function busFactor(counts: readonly number[]): number;
+//# sourceMappingURL=gini.d.ts.map

package/dist/pipeline/phases/temporal-helpers/gini.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gini.d.ts","sourceRoot":"","sources":["../../../../src/pipeline/phases/temporal-helpers/gini.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH;;;GAGG;AACH,wBAAgB,IAAI,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAwBtD;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAa3D"}

package/dist/pipeline/phases/temporal-helpers/gini.js

@@ -0,0 +1,78 @@
+/**
+ * Gini inequality coefficient and bus-factor proxy.
+ *
+ * The Gini coefficient is computed on a sorted contribution vector using the
+ * O(n log n) mean-rank identity, which avoids the O(n^2) pairwise loop while
+ * remaining numerically stable:
+ *
+ *   G = (2 * Σᵢ i·x[i]) / (n · Σx) − (n + 1) / n
+ *
+ * with `i` 1-indexed after ascending sort. G = 0 when all values are equal
+ * and approaches 1 as inequality grows.
+ *
+ * Bus factor collapses inequality into an integer head-count proxy. The
+ * corrected formula (see research notes) is:
+ *
+ *   busFactor = max(1, min(n, 1 + round((1 - G) · (n - 1))))
+ *
+ * which returns 1 for a single author, `n` for perfectly uniform contribution,
+ * and 1 for a highly-skewed distribution.
+ */
+/**
+ * Compute the Gini coefficient for a vector of non-negative contribution
+ * counts. Zero, empty, and all-equal inputs all yield 0.
+ */
+export function gini(counts) {
+    const n = counts.length;
+    if (n === 0)
+        return 0;
+    let sum = 0;
+    for (const v of counts) {
+        if (v < 0) {
+            throw new Error("gini: contribution counts must be non-negative");
+        }
+        sum += v;
+    }
+    if (sum === 0)
+        return 0;
+    // Ascending sort without mutating caller input.
+    const sorted = [...counts].sort((a, b) => a - b);
+    let weighted = 0;
+    for (let i = 0; i < n; i += 1) {
+        // i is 0-indexed here; the mean-rank identity expects 1-indexed ranks.
+        weighted += (i + 1) * (sorted[i] ?? 0);
+    }
+    const g = (2 * weighted) / (n * sum) - (n + 1) / n;
+    // Numerical clamp: floating-point error can produce tiny negatives or
+    // slight overshoot past 1.
+    if (g < 0)
+        return 0;
+    if (g > 1)
+        return 1;
+    return g;
+}
+/**
+ * Derive the bus factor from a per-contributor count vector.
+ *
+ * Returns 1 when the vector is empty or contains only zero totals.
+ */
+export function busFactor(counts) {
+    const n = counts.length;
+    if (n === 0)
+        return 1;
+    // Drop zero-count contributors so "n" reflects actual touchers.
+    const active = counts.filter((c) => c > 0);
+    const m = active.length;
+    if (m === 0)
+        return 1;
+    if (m === 1)
+        return 1;
+    const g = gini(active);
+    const raw = 1 + Math.round((1 - g) * (m - 1));
+    if (raw < 1)
+        return 1;
+    if (raw > m)
+        return m;
+    return raw;
+}
+//# sourceMappingURL=gini.js.map

package/dist/pipeline/phases/temporal-helpers/gini.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gini.js","sourceRoot":"","sources":["../../../../src/pipeline/phases/temporal-helpers/gini.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH;;;GAGG;AACH,MAAM,UAAU,IAAI,CAAC,MAAyB;IAC5C,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC;IACxB,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IACtB,IAAI,GAAG,GAAG,CAAC,CAAC;IACZ,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;QACvB,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;YACV,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;QACpE,CAAC;QACD,GAAG,IAAI,CAAC,CAAC;IACX,CAAC;IACD,IAAI,GAAG,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IACxB,gDAAgD;IAChD,MAAM,MAAM,GAAG,CAAC,GAAG,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACjD,IAAI,QAAQ,GAAG,CAAC,CAAC;IACjB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QAC9B,uEAAuE;QACvE,QAAQ,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IACzC,CAAC;IACD,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;IACnD,sEAAsE;IACtE,2BAA2B;IAC3B,IAAI,CAAC,GAAG,CAAC;QAAE,OAAO,CAAC,CAAC;IACpB,IAAI,CAAC,GAAG,CAAC;QAAE,OAAO,CAAC,CAAC;IACpB,OAAO,CAAC,CAAC;AACX,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,SAAS,CAAC,MAAyB;IACjD,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC;IACxB,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IACtB,gEAAgE;IAChE,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAC3C,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC;IACxB,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IACtB,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IACtB,MAAM,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;IACvB,MAAM,GAAG,GAAG,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IAC9C,IAAI,GAAG,GAAG,CAAC;QAAE,OAAO,CAAC,CAAC;IACtB,IAAI,GAAG,GAAG,CAAC;QAAE,OAAO,CAAC,CAAC;IACtB,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/pipeline/phases/temporal-helpers/revert-detect.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Revert detection — three orthogonal regex vectors.
+ *
+ * A commit is a revert if ANY of the three tests match:
+ *   1. Subject begins with `Revert "…"` (default `git revert`).
+ *   2. Body contains a `This reverts commit <sha>` line (default body form).
+ *   3. Body contains the `--reference` form `This reverts <sha>[ (subject, date)]`.
+ *
+ * OR-logic plus a `.test` short-circuit guarantees each commit is counted at
+ * most once, even if the subject and body both announce the revert.
+ */
+/** Return true iff a commit's subject or body identifies it as a revert. */
+export declare function isRevertCommit(subject: string, body: string): boolean;
+//# sourceMappingURL=revert-detect.d.ts.map

package/dist/pipeline/phases/temporal-helpers/revert-detect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"revert-detect.d.ts","sourceRoot":"","sources":["../../../../src/pipeline/phases/temporal-helpers/revert-detect.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAMH,4EAA4E;AAC5E,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAKrE"}

package/dist/pipeline/phases/temporal-helpers/revert-detect.js

@@ -0,0 +1,25 @@
+/**
+ * Revert detection — three orthogonal regex vectors.
+ *
+ * A commit is a revert if ANY of the three tests match:
+ *   1. Subject begins with `Revert "…"` (default `git revert`).
+ *   2. Body contains a `This reverts commit <sha>` line (default body form).
+ *   3. Body contains the `--reference` form `This reverts <sha>[ (subject, date)]`.
+ *
+ * OR-logic plus a `.test` short-circuit guarantees each commit is counted at
+ * most once, even if the subject and body both announce the revert.
+ */
+const REVERT_SUBJECT_RE = /^Revert "/;
+const REVERT_BODY_DEFAULT_RE = /This reverts commit ([0-9a-f]+)/m;
+const REVERT_BODY_REFERENCE_RE = /This reverts ([0-9a-f]+)(?:\s*\(([^)]+)\))?/m;
+/** Return true iff a commit's subject or body identifies it as a revert. */
+export function isRevertCommit(subject, body) {
+    if (REVERT_SUBJECT_RE.test(subject))
+        return true;
+    if (REVERT_BODY_DEFAULT_RE.test(body))
+        return true;
+    if (REVERT_BODY_REFERENCE_RE.test(body))
+        return true;
+    return false;
+}
+//# sourceMappingURL=revert-detect.js.map

package/dist/pipeline/phases/temporal-helpers/revert-detect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"revert-detect.js","sourceRoot":"","sources":["../../../../src/pipeline/phases/temporal-helpers/revert-detect.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,MAAM,iBAAiB,GAAG,WAAW,CAAC;AACtC,MAAM,sBAAsB,GAAG,kCAAkC,CAAC;AAClE,MAAM,wBAAwB,GAAG,8CAA8C,CAAC;AAEhF,4EAA4E;AAC5E,MAAM,UAAU,cAAc,CAAC,OAAe,EAAE,IAAY;IAC1D,IAAI,iBAAiB,CAAC,IAAI,CAAC,OAAO,CAAC;QAAE,OAAO,IAAI,CAAC;IACjD,IAAI,sBAAsB,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IACnD,IAAI,wBAAwB,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IACrD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/pipeline/phases/temporal-helpers/test-pair.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Per-language test-pair heuristics.
+ *
+ * Given a source file relative path, return candidate test-file relative
+ * paths whose touches should be cross-referenced for the `testRatio` signal.
+ * Also provides a cheap `isTestFile` predicate so source files that are
+ * themselves test files short-circuit the candidate lookup with ratio=1.
+ *
+ * All paths are POSIX-separated and relative to repo root.
+ */
+/** Heuristic check: is `relPath` a test file? */
+export declare function isTestFile(relPath: string): boolean;
+/**
+ * Return the set of candidate test-file relative paths paired with the given
+ * source file. Unknown languages yield an empty array.
+ */
+export declare function pairedTestCandidates(relPath: string): readonly string[];
+//# sourceMappingURL=test-pair.d.ts.map

package/dist/pipeline/phases/temporal-helpers/test-pair.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-pair.d.ts","sourceRoot":"","sources":["../../../../src/pipeline/phases/temporal-helpers/test-pair.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,iDAAiD;AACjD,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAwBnD;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAoDvE"}

package/dist/pipeline/phases/temporal-helpers/test-pair.js

@@ -0,0 +1,119 @@
+/**
+ * Per-language test-pair heuristics.
+ *
+ * Given a source file relative path, return candidate test-file relative
+ * paths whose touches should be cross-referenced for the `testRatio` signal.
+ * Also provides a cheap `isTestFile` predicate so source files that are
+ * themselves test files short-circuit the candidate lookup with ratio=1.
+ *
+ * All paths are POSIX-separated and relative to repo root.
+ */
+/** Heuristic check: is `relPath` a test file? */
+export function isTestFile(relPath) {
+    const base = baseName(relPath);
+    const dir = dirName(relPath);
+    // Any segment named `tests`, `test`, or `__tests__` under the path root.
+    const segs = relPath.split("/");
+    for (const s of segs) {
+        if (s === "tests" || s === "test" || s === "__tests__")
+            return true;
+    }
+    // Python convention.
+    if (/^test_.+\.py$/.test(base))
+        return true;
+    if (/^.+_test\.py$/.test(base))
+        return true;
+    // Go convention.
+    if (/^.+_test\.go$/.test(base))
+        return true;
+    // TS/JS/Rust conventions.
+    if (/^.+\.(test|spec)\.(ts|tsx|js|jsx|mjs|cjs)$/.test(base))
+        return true;
+    // Java: *Test.java.
+    if (/^.+Test\.java$/.test(base))
+        return true;
+    // C#: *Tests.cs or *.Tests.cs
+    if (/^.+Tests\.cs$/.test(base))
+        return true;
+    if (/^.+\.Tests\.cs$/.test(base))
+        return true;
+    // Keep dir in mind for Rust suffix heuristic — Rust inline tests are
+    // indistinguishable from production, so we mark only explicit `tests/` dirs.
+    if (dir.endsWith("/tests") || dir === "tests")
+        return true;
+    return false;
+}
+/**
+ * Return the set of candidate test-file relative paths paired with the given
+ * source file. Unknown languages yield an empty array.
+ */
+export function pairedTestCandidates(relPath) {
+    if (isTestFile(relPath))
+        return [];
+    const base = baseName(relPath);
+    const dir = dirName(relPath);
+    const ext = extOf(base);
+    const stem = base.slice(0, base.length - ext.length - 1); // strip ".ext"
+    if (stem.length === 0)
+        return [];
+    const out = new Set();
+    const prefix = dir === "" ? "" : `${dir}/`;
+    const addWithStem = (ts, newExt) => {
+        out.add(`${prefix}${ts}.${newExt}`);
+    };
+    switch (ext) {
+        case "ts":
+        case "tsx":
+        case "js":
+        case "jsx":
+        case "mjs":
+        case "cjs":
+            addWithStem(`${stem}.test`, ext);
+            addWithStem(`${stem}.spec`, ext);
+            break;
+        case "py":
+            // Same-directory variants.
+            out.add(`${prefix}test_${stem}.py`);
+            out.add(`${prefix}${stem}_test.py`);
+            // tests/ sibling.
+            out.add(`tests/test_${stem}.py`);
+            break;
+        case "go":
+            out.add(`${prefix}${stem}_test.go`);
+            break;
+        case "rs":
+            // Inline `#[cfg(test)]` is unreliable to detect from git metadata; look
+            // for a sibling `tests/<stem>.rs` under a `tests/` directory at repo
+            // root.
+            out.add(`tests/${stem}.rs`);
+            break;
+        case "java":
+            out.add(`${prefix}${capitalize(stem)}Test.java`);
+            break;
+        case "cs":
+            out.add(`${prefix}${capitalize(stem)}Tests.cs`);
+            out.add(`${prefix}${capitalize(stem)}.Tests.cs`);
+            break;
+        default:
+            break;
+    }
+    return [...out].sort();
+}
+function baseName(p) {
+    const idx = p.lastIndexOf("/");
+    return idx < 0 ? p : p.slice(idx + 1);
+}
+function dirName(p) {
+    const idx = p.lastIndexOf("/");
+    return idx < 0 ? "" : p.slice(0, idx);
+}
+function extOf(base) {
+    const idx = base.lastIndexOf(".");
+    return idx < 0 ? "" : base.slice(idx + 1);
+}
+function capitalize(s) {
+    if (s.length === 0)
+        return s;
+    return s.charAt(0).toUpperCase() + s.slice(1);
+}
+//# sourceMappingURL=test-pair.js.map

package/dist/pipeline/phases/temporal-helpers/test-pair.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-pair.js","sourceRoot":"","sources":["../../../../src/pipeline/phases/temporal-helpers/test-pair.ts"],"names":[],"mappings":"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"}

package/dist/pipeline/phases/temporal.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Temporal phase — derives 12 per-file git signals from two shared `git log`
+ * subprocesses plus one optional branch-divergence pass.
+ *
+ * Pipeline position: depends on `scan` only; runs in parallel with other
+ * structural phases. Mutates the shared KnowledgeGraph by looking up each
+ * scanned File node and cloning it with the 12 temporal properties attached.
+ *
+ * Design constraints:
+ *   - Subprocess budget ≤3 (main log dump, name-status dump, branch pass).
+ *     Per-file `git log --follow` for signal 9 is opt-in; when enabled it
+ *     breaks the budget — we cap it at `maxRenameFollowFiles` to bound cost.
+ *   - Fail-open: any git error, malformed output, or missing history yields
+ *     a no-signal outcome rather than a phase failure.
+ *   - Deterministic: all output records are constructed in sorted-relPath
+ *     order, and map-keyed records are sorted before emission.
+ *   - `options.skipGit === true` is a kill switch that returns an empty
+ *     result so the graphHash remains stable without temporal data.
+ */
+import type { PipelinePhase } from "../types.js";
+export declare const TEMPORAL_PHASE_NAME: "temporal";
+/**
+ * Augmentation to `PipelineOptions` understood by this phase.
+ *
+ * These are read via `ctx.options as TemporalOptions` — the shared
+ * `PipelineOptions` interface deliberately stays small. Any phase-specific
+ * knobs pass through verbatim.
+ */
+export interface TemporalOptions {
+    readonly temporalWindowDays?: number;
+    readonly temporalChurnHalfLifeDays?: number;
+    readonly temporalBaseBranch?: string;
+    readonly temporalMaxRenameFollow?: number;
+    /**
+     * Reference "now" timestamp in epoch seconds for decay calculations.
+     * Providing this makes fixture tests time-independent. Defaults to
+     * `Date.now() / 1000`.
+     */
+    readonly temporalNowEpochSec?: number;
+}
+/** One commit's file-touch manifest, exposed for reuse by downstream phases. */
+export interface TemporalCommitManifest {
+    readonly sha: string;
+    readonly files: readonly string[];
+    /** Committer time (epoch seconds). Used by the cochange phase to emit `last_cocommit_at`. */
+    readonly ct: number;
+}
+export interface TemporalOutput {
+    readonly signalsEmitted: number;
+    readonly filesSkipped: number;
+    readonly windowDays: number;
+    readonly subprocessCount: number;
+    /**
+     * Per-commit file-touch lists assembled from the shared `git log
+     * --name-status` dump. Dependents (e.g. the `cochange` phase) consume
+     * this instead of re-spawning git. Ordered by sha for determinism.
+     *
+     * Files are restricted to paths present in the scan output and are the
+     * post-rename paths from `--name-status`. Empty when temporal was
+     * short-circuited (e.g. `skipGit`, git failure, empty history).
+     */
+    readonly commitFileLists: readonly TemporalCommitManifest[];
+}
+export declare const temporalPhase: PipelinePhase<TemporalOutput>;
+//# sourceMappingURL=temporal.d.ts.map

package/dist/pipeline/phases/temporal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"temporal.d.ts","sourceRoot":"","sources":["../../../src/pipeline/phases/temporal.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAKH,OAAO,KAAK,EAAmB,aAAa,EAAE,MAAM,aAAa,CAAC;AAiBlE,eAAO,MAAM,mBAAmB,EAAG,UAAmB,CAAC;AAYvD;;;;;;GAMG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,yBAAyB,CAAC,EAAE,MAAM,CAAC;IAC5C,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,uBAAuB,CAAC,EAAE,MAAM,CAAC;IAC1C;;;;OAIG;IACH,QAAQ,CAAC,mBAAmB,CAAC,EAAE,MAAM,CAAC;CACvC;AAED,gFAAgF;AAChF,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,6FAA6F;IAC7F,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC;;;;;;;;OAQG;IACH,QAAQ,CAAC,eAAe,EAAE,SAAS,sBAAsB,EAAE,CAAC;CAC7D;AAED,eAAO,MAAM,aAAa,EAAE,aAAa,CAAC,cAAc,CAUvD,CAAC"}