tea-rags 0.9.0

package/build/core/trajectory/git/provider.js

@@ -0,0 +1,82 @@
+/**
+ * GitEnrichmentProvider — implements EnrichmentProvider for git trajectory metrics.
+ *
+ * Wires file-reader + chunk-reader + caches.
+ * Owns both the isomorphic-git pack cache (for readBlob/readCommit)
+ * and the HEAD-based enrichment result cache.
+ */
+import { existsSync } from "node:fs";
+import { join } from "node:path";
+import { resolveRepoRoot } from "../../adapters/git/client.js";
+import { gitFilters } from "./filters.js";
+import { GitEnrichmentCache } from "./infra/cache.js";
+import { buildChunkChurnMap } from "./infra/chunk-reader.js";
+import { buildFileSignalMap, buildFileSignalsForPaths } from "./infra/file-reader.js";
+import { assembleFileSignals } from "./infra/metrics/file-assembler.js";
+import { gitPayloadSignalDescriptors } from "./payload-signals.js";
+import { gitDerivedSignals } from "./rerank/derived-signals/index.js";
+import { GIT_PRESETS } from "./rerank/presets/index.js";
+const DEFAULT_PROVIDER_CONFIG = {
+    logMaxAgeMonths: 12,
+    logTimeoutMs: 60000,
+    chunkConcurrency: 10,
+    chunkMaxAgeMonths: 6,
+    chunkTimeoutMs: 120000,
+    chunkMaxFileLines: 10000,
+};
+export class GitEnrichmentProvider {
+    key = "git";
+    // ── Query-side contract ──
+    signals = gitPayloadSignalDescriptors;
+    derivedSignals = gitDerivedSignals;
+    filters = gitFilters;
+    presets = GIT_PRESETS;
+    squashOpts;
+    config;
+    constructor(config, squashOpts) {
+        this.config = { ...DEFAULT_PROVIDER_CONFIG, ...config };
+        this.squashOpts = squashOpts;
+        this.fileSignalTransform = (data, maxEndLine) => assembleFileSignals(data, maxEndLine, this.squashOpts);
+    }
+    resolveRoot(absolutePath) {
+        return resolveRepoRoot(absolutePath);
+    }
+    fileSignalTransform;
+    enrichmentCache = new GitEnrichmentCache();
+    isoGitCache = {};
+    lastFileResult = null;
+    async buildFileSignals(root, options) {
+        // Fast check: skip if not a git repo
+        if (!existsSync(join(root, ".git"))) {
+            return new Map();
+        }
+        let rawData;
+        if (options?.paths) {
+            rawData = await buildFileSignalsForPaths(root, options.paths, this.config.logTimeoutMs);
+        }
+        else {
+            rawData = await buildFileSignalMap(root, this.enrichmentCache, this.config.logMaxAgeMonths, this.config.logTimeoutMs);
+        }
+        this.lastFileResult = rawData;
+        // Return raw FileChurnData — coordinator/applier will call computeFileSignals
+        // with actual line count when applying per-file
+        const result = new Map();
+        for (const [path, churnData] of rawData) {
+            result.set(path, churnData);
+        }
+        return result;
+    }
+    async buildChunkSignals(root, chunkMap) {
+        const rawResult = await buildChunkChurnMap(root, chunkMap, this.enrichmentCache, this.isoGitCache, this.config.chunkConcurrency, this.config.chunkMaxAgeMonths, this.lastFileResult ?? undefined, this.squashOpts, this.config.chunkTimeoutMs, this.config.chunkMaxFileLines);
+        const result = new Map();
+        for (const [filePath, overlayMap] of rawResult) {
+            const chunkEntries = new Map();
+            for (const [chunkId, overlay] of overlayMap) {
+                chunkEntries.set(chunkId, overlay);
+            }
+            result.set(filePath, chunkEntries);
+        }
+        return result;
+    }
+}
+//# sourceMappingURL=provider.js.map

package/build/core/trajectory/git/provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.js","sourceRoot":"","sources":["../../../../src/core/trajectory/git/provider.ts"],"names":[],"mappings":"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"}

package/build/core/trajectory/git/rerank/constants.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Git trajectory reranking constants.
+ *
+ * Provider-specific configuration for dampening and alpha-blending thresholds.
+ * Generic algorithms (computeAlpha, blend, confidenceDampening) live in contracts/signal-utils.
+ */
+import type { DampeningConfig } from "../../../contracts/types/trajectory.js";
+/** Dampening config shared by all git file-level derived signals. */
+export declare const GIT_FILE_DAMPENING: DampeningConfig;
+//# sourceMappingURL=constants.d.ts.map

package/build/core/trajectory/git/rerank/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../../src/core/trajectory/git/rerank/constants.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wCAAwC,CAAC;AAE9E,qEAAqE;AACrE,eAAO,MAAM,kBAAkB,EAAE,eAAiE,CAAC"}

package/build/core/trajectory/git/rerank/constants.js

@@ -0,0 +1,9 @@
+/**
+ * Git trajectory reranking constants.
+ *
+ * Provider-specific configuration for dampening and alpha-blending thresholds.
+ * Generic algorithms (computeAlpha, blend, confidenceDampening) live in contracts/signal-utils.
+ */
+/** Dampening config shared by all git file-level derived signals. */
+export const GIT_FILE_DAMPENING = { key: "git.file.commitCount", percentile: 25 };
+//# sourceMappingURL=constants.js.map

package/build/core/trajectory/git/rerank/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../../../src/core/trajectory/git/rerank/constants.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,qEAAqE;AACrE,MAAM,CAAC,MAAM,kBAAkB,GAAoB,EAAE,GAAG,EAAE,sBAAsB,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC"}

package/build/core/trajectory/git/rerank/derived-signals/age.d.ts

@@ -0,0 +1,10 @@
+import type { DerivedSignalDescriptor } from "../../../../contracts/types/reranker.js";
+import type { ExtractContext } from "../../../../contracts/types/trajectory.js";
+export declare class AgeSignal implements DerivedSignalDescriptor {
+    readonly name = "age";
+    readonly description = "Direct age: older code scores higher. L3 blends chunk+file ageDays.";
+    readonly sources: string[];
+    readonly defaultBound = 365;
+    extract(rawSignals: Record<string, unknown>, ctx?: ExtractContext): number;
+}
+//# sourceMappingURL=age.d.ts.map

package/build/core/trajectory/git/rerank/derived-signals/age.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"age.d.ts","sourceRoot":"","sources":["../../../../../../src/core/trajectory/git/rerank/derived-signals/age.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,yCAAyC,CAAC;AACvF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2CAA2C,CAAC;AAGhF,qBAAa,SAAU,YAAW,uBAAuB;IACvD,QAAQ,CAAC,IAAI,SAAS;IACtB,QAAQ,CAAC,WAAW,yEAAyE;IAC7F,QAAQ,CAAC,OAAO,WAAqC;IACrD,QAAQ,CAAC,YAAY,OAAO;IAC5B,OAAO,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,CAAC,EAAE,cAAc,GAAG,MAAM;CAK3E"}

package/build/core/trajectory/git/rerank/derived-signals/age.js

@@ -0,0 +1,13 @@
+import { blendNormalized } from "./helpers.js";
+export class AgeSignal {
+    name = "age";
+    description = "Direct age: older code scores higher. L3 blends chunk+file ageDays.";
+    sources = ["file.ageDays", "chunk.ageDays"];
+    defaultBound = 365;
+    extract(rawSignals, ctx) {
+        const fb = ctx?.bounds?.["file.ageDays"] ?? this.defaultBound;
+        const cb = ctx?.bounds?.["chunk.ageDays"] ?? this.defaultBound;
+        return blendNormalized(rawSignals, "ageDays", fb, cb);
+    }
+}
+//# sourceMappingURL=age.js.map

package/build/core/trajectory/git/rerank/derived-signals/age.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"age.js","sourceRoot":"","sources":["../../../../../../src/core/trajectory/git/rerank/derived-signals/age.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE/C,MAAM,OAAO,SAAS;IACX,IAAI,GAAG,KAAK,CAAC;IACb,WAAW,GAAG,qEAAqE,CAAC;IACpF,OAAO,GAAG,CAAC,cAAc,EAAE,eAAe,CAAC,CAAC;IAC5C,YAAY,GAAG,GAAG,CAAC;IAC5B,OAAO,CAAC,UAAmC,EAAE,GAAoB;QAC/D,MAAM,EAAE,GAAG,GAAG,EAAE,MAAM,EAAE,CAAC,cAAc,CAAC,IAAI,IAAI,CAAC,YAAY,CAAC;QAC9D,MAAM,EAAE,GAAG,GAAG,EAAE,MAAM,EAAE,CAAC,eAAe,CAAC,IAAI,IAAI,CAAC,YAAY,CAAC;QAC/D,OAAO,eAAe,CAAC,UAAU,EAAE,SAAS,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;IACxD,CAAC;CACF"}

package/build/core/trajectory/git/rerank/derived-signals/block-penalty.d.ts

@@ -0,0 +1,10 @@
+import type { DerivedSignalDescriptor } from "../../../../contracts/types/reranker.js";
+import type { ExtractContext } from "../../../../contracts/types/trajectory.js";
+export declare class BlockPenaltySignal implements DerivedSignalDescriptor {
+    readonly name = "blockPenalty";
+    readonly description = "Data quality discount for block chunks: 1.0 if block without chunk data (alpha=0), 0 otherwise";
+    readonly sources: string[];
+    readonly inverted: true;
+    extract(rawSignals: Record<string, unknown>, _ctx?: ExtractContext): number;
+}
+//# sourceMappingURL=block-penalty.d.ts.map

package/build/core/trajectory/git/rerank/derived-signals/block-penalty.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"block-penalty.d.ts","sourceRoot":"","sources":["../../../../../../src/core/trajectory/git/rerank/derived-signals/block-penalty.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,yCAAyC,CAAC;AACvF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2CAA2C,CAAC;AAGhF,qBAAa,kBAAmB,YAAW,uBAAuB;IAChE,QAAQ,CAAC,IAAI,kBAAkB;IAC/B,QAAQ,CAAC,WAAW,oGAC+E;IACnG,QAAQ,CAAC,OAAO,WAA6C;IAC7D,QAAQ,CAAC,QAAQ,EAAG,IAAI,CAAU;IAClC,OAAO,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,EAAE,cAAc,GAAG,MAAM;CAW5E"}

package/build/core/trajectory/git/rerank/derived-signals/block-penalty.js

@@ -0,0 +1,20 @@
+import { hasChunkData, payloadAlpha } from "./helpers.js";
+export class BlockPenaltySignal {
+    name = "blockPenalty";
+    description = "Data quality discount for block chunks: 1.0 if block without chunk data (alpha=0), 0 otherwise";
+    sources = ["chunk.commitCount", "file.commitCount"];
+    inverted = true;
+    extract(rawSignals, _ctx) {
+        const { chunkType } = rawSignals;
+        if (chunkType !== "block")
+            return 0;
+        // If chunk-level git data exists, compute alpha to determine penalty
+        if (hasChunkData(rawSignals)) {
+            const alpha = payloadAlpha(rawSignals);
+            return 1.0 - alpha;
+        }
+        // No chunk data at all — full penalty
+        return 1.0;
+    }
+}
+//# sourceMappingURL=block-penalty.js.map

package/build/core/trajectory/git/rerank/derived-signals/block-penalty.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"block-penalty.js","sourceRoot":"","sources":["../../../../../../src/core/trajectory/git/rerank/derived-signals/block-penalty.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE1D,MAAM,OAAO,kBAAkB;IACpB,IAAI,GAAG,cAAc,CAAC;IACtB,WAAW,GAClB,gGAAgG,CAAC;IAC1F,OAAO,GAAG,CAAC,mBAAmB,EAAE,kBAAkB,CAAC,CAAC;IACpD,QAAQ,GAAG,IAAa,CAAC;IAClC,OAAO,CAAC,UAAmC,EAAE,IAAqB;QAChE,MAAM,EAAE,SAAS,EAAE,GAAG,UAAU,CAAC;QACjC,IAAI,SAAS,KAAK,OAAO;YAAE,OAAO,CAAC,CAAC;QACpC,qEAAqE;QACrE,IAAI,YAAY,CAAC,UAAU,CAAC,EAAE,CAAC;YAC7B,MAAM,KAAK,GAAG,YAAY,CAAC,UAAU,CAAC,CAAC;YACvC,OAAO,GAAG,GAAG,KAAK,CAAC;QACrB,CAAC;QACD,sCAAsC;QACtC,OAAO,GAAG,CAAC;IACb,CAAC;CACF"}

package/build/core/trajectory/git/rerank/derived-signals/bug-fix.d.ts

@@ -0,0 +1,12 @@
+import type { DerivedSignalDescriptor } from "../../../../contracts/types/reranker.js";
+import type { ExtractContext } from "../../../../contracts/types/trajectory.js";
+export declare class BugFixSignal implements DerivedSignalDescriptor {
+    readonly name = "bugFix";
+    readonly description = "Bug fix rate: code with more fix commits scores higher. L3 blends chunk+file bugFixRate.";
+    readonly sources: string[];
+    readonly defaultBound = 100;
+    readonly dampeningSource: import("../../../../contracts/types/trajectory.js").DampeningConfig;
+    private static readonly FALLBACK_THRESHOLD;
+    extract(rawSignals: Record<string, unknown>, ctx?: ExtractContext): number;
+}
+//# sourceMappingURL=bug-fix.d.ts.map

package/build/core/trajectory/git/rerank/derived-signals/bug-fix.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bug-fix.d.ts","sourceRoot":"","sources":["../../../../../../src/core/trajectory/git/rerank/derived-signals/bug-fix.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,yCAAyC,CAAC;AACvF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2CAA2C,CAAC;AAGhF,qBAAa,YAAa,YAAW,uBAAuB;IAC1D,QAAQ,CAAC,IAAI,YAAY;IACzB,QAAQ,CAAC,WAAW,8FAA8F;IAClH,QAAQ,CAAC,OAAO,WAA2C;IAC3D,QAAQ,CAAC,YAAY,OAAO;IAC5B,QAAQ,CAAC,eAAe,sEAAsB;IAC9C,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,kBAAkB,CAAK;IAC/C,OAAO,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,CAAC,EAAE,cAAc,GAAG,MAAM;CAQ3E"}

package/build/core/trajectory/git/rerank/derived-signals/bug-fix.js

@@ -0,0 +1,18 @@
+import { blendNormalized, confidenceDampening, fileNum, GIT_FILE_DAMPENING } from "./helpers.js";
+export class BugFixSignal {
+    name = "bugFix";
+    description = "Bug fix rate: code with more fix commits scores higher. L3 blends chunk+file bugFixRate.";
+    sources = ["file.bugFixRate", "chunk.bugFixRate"];
+    defaultBound = 100;
+    dampeningSource = GIT_FILE_DAMPENING;
+    static FALLBACK_THRESHOLD = 8;
+    extract(rawSignals, ctx) {
+        const fb = ctx?.bounds?.["file.bugFixRate"] ?? this.defaultBound;
+        const cb = ctx?.bounds?.["chunk.bugFixRate"] ?? this.defaultBound;
+        let value = blendNormalized(rawSignals, "bugFixRate", fb, cb);
+        const k = ctx?.dampeningThreshold ?? BugFixSignal.FALLBACK_THRESHOLD;
+        value *= confidenceDampening(fileNum(rawSignals, "commitCount"), k);
+        return value;
+    }
+}
+//# sourceMappingURL=bug-fix.js.map

package/build/core/trajectory/git/rerank/derived-signals/bug-fix.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bug-fix.js","sourceRoot":"","sources":["../../../../../../src/core/trajectory/git/rerank/derived-signals/bug-fix.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAEjG,MAAM,OAAO,YAAY;IACd,IAAI,GAAG,QAAQ,CAAC;IAChB,WAAW,GAAG,0FAA0F,CAAC;IACzG,OAAO,GAAG,CAAC,iBAAiB,EAAE,kBAAkB,CAAC,CAAC;IAClD,YAAY,GAAG,GAAG,CAAC;IACnB,eAAe,GAAG,kBAAkB,CAAC;IACtC,MAAM,CAAU,kBAAkB,GAAG,CAAC,CAAC;IAC/C,OAAO,CAAC,UAAmC,EAAE,GAAoB;QAC/D,MAAM,EAAE,GAAG,GAAG,EAAE,MAAM,EAAE,CAAC,iBAAiB,CAAC,IAAI,IAAI,CAAC,YAAY,CAAC;QACjE,MAAM,EAAE,GAAG,GAAG,EAAE,MAAM,EAAE,CAAC,kBAAkB,CAAC,IAAI,IAAI,CAAC,YAAY,CAAC;QAClE,IAAI,KAAK,GAAG,eAAe,CAAC,UAAU,EAAE,YAAY,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;QAC9D,MAAM,CAAC,GAAG,GAAG,EAAE,kBAAkB,IAAI,YAAY,CAAC,kBAAkB,CAAC;QACrE,KAAK,IAAI,mBAAmB,CAAC,OAAO,CAAC,UAAU,EAAE,aAAa,CAAC,EAAE,CAAC,CAAC,CAAC;QACpE,OAAO,KAAK,CAAC;IACf,CAAC"}

package/build/core/trajectory/git/rerank/derived-signals/burst-activity.d.ts

@@ -0,0 +1,10 @@
+import type { DerivedSignalDescriptor } from "../../../../contracts/types/reranker.js";
+import type { ExtractContext } from "../../../../contracts/types/trajectory.js";
+export declare class BurstActivitySignal implements DerivedSignalDescriptor {
+    readonly name = "burstActivity";
+    readonly description = "Recency-weighted commit frequency. L3 blends chunk+file recencyWeightedFreq.";
+    readonly sources: string[];
+    readonly defaultBound = 10;
+    extract(rawSignals: Record<string, unknown>, ctx?: ExtractContext): number;
+}
+//# sourceMappingURL=burst-activity.d.ts.map

package/build/core/trajectory/git/rerank/derived-signals/burst-activity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"burst-activity.d.ts","sourceRoot":"","sources":["../../../../../../src/core/trajectory/git/rerank/derived-signals/burst-activity.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,yCAAyC,CAAC;AACvF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2CAA2C,CAAC;AAGhF,qBAAa,mBAAoB,YAAW,uBAAuB;IACjE,QAAQ,CAAC,IAAI,mBAAmB;IAChC,QAAQ,CAAC,WAAW,kFAAkF;IACtG,QAAQ,CAAC,OAAO,WAA6D;IAC7E,QAAQ,CAAC,YAAY,MAAQ;IAC7B,OAAO,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,CAAC,EAAE,cAAc,GAAG,MAAM;CAK3E"}

package/build/core/trajectory/git/rerank/derived-signals/burst-activity.js

@@ -0,0 +1,13 @@
+import { blendNormalized } from "./helpers.js";
+export class BurstActivitySignal {
+    name = "burstActivity";
+    description = "Recency-weighted commit frequency. L3 blends chunk+file recencyWeightedFreq.";
+    sources = ["file.recencyWeightedFreq", "chunk.recencyWeightedFreq"];
+    defaultBound = 10.0;
+    extract(rawSignals, ctx) {
+        const fb = ctx?.bounds?.["file.recencyWeightedFreq"] ?? this.defaultBound;
+        const cb = ctx?.bounds?.["chunk.recencyWeightedFreq"] ?? this.defaultBound;
+        return blendNormalized(rawSignals, "recencyWeightedFreq", fb, cb);
+    }
+}
+//# sourceMappingURL=burst-activity.js.map

package/build/core/trajectory/git/rerank/derived-signals/burst-activity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"burst-activity.js","sourceRoot":"","sources":["../../../../../../src/core/trajectory/git/rerank/derived-signals/burst-activity.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE/C,MAAM,OAAO,mBAAmB;IACrB,IAAI,GAAG,eAAe,CAAC;IACvB,WAAW,GAAG,8EAA8E,CAAC;IAC7F,OAAO,GAAG,CAAC,0BAA0B,EAAE,2BAA2B,CAAC,CAAC;IACpE,YAAY,GAAG,IAAI,CAAC;IAC7B,OAAO,CAAC,UAAmC,EAAE,GAAoB;QAC/D,MAAM,EAAE,GAAG,GAAG,EAAE,MAAM,EAAE,CAAC,0BAA0B,CAAC,IAAI,IAAI,CAAC,YAAY,CAAC;QAC1E,MAAM,EAAE,GAAG,GAAG,EAAE,MAAM,EAAE,CAAC,2BAA2B,CAAC,IAAI,IAAI,CAAC,YAAY,CAAC;QAC3E,OAAO,eAAe,CAAC,UAAU,EAAE,qBAAqB,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;IACpE,CAAC;CACF"}

package/build/core/trajectory/git/rerank/derived-signals/chunk-churn.d.ts

@@ -0,0 +1,10 @@
+import type { DerivedSignalDescriptor } from "../../../../contracts/types/reranker.js";
+import type { ExtractContext } from "../../../../contracts/types/trajectory.js";
+export declare class ChunkChurnSignal implements DerivedSignalDescriptor {
+    readonly name = "chunkChurn";
+    readonly description = "Chunk-level commit count, dampened by alpha (coverage confidence).";
+    readonly sources: string[];
+    readonly defaultBound = 30;
+    extract(rawSignals: Record<string, unknown>, ctx?: ExtractContext): number;
+}
+//# sourceMappingURL=chunk-churn.d.ts.map

package/build/core/trajectory/git/rerank/derived-signals/chunk-churn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunk-churn.d.ts","sourceRoot":"","sources":["../../../../../../src/core/trajectory/git/rerank/derived-signals/chunk-churn.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,yCAAyC,CAAC;AACvF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2CAA2C,CAAC;AAGhF,qBAAa,gBAAiB,YAAW,uBAAuB;IAC9D,QAAQ,CAAC,IAAI,gBAAgB;IAC7B,QAAQ,CAAC,WAAW,wEAAwE;IAC5F,QAAQ,CAAC,OAAO,WAA6C;IAC7D,QAAQ,CAAC,YAAY,MAAM;IAC3B,OAAO,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,CAAC,EAAE,cAAc,GAAG,MAAM;CAM3E"}

package/build/core/trajectory/git/rerank/derived-signals/chunk-churn.js

@@ -0,0 +1,15 @@
+import { normalize } from "../../../../contracts/signal-utils.js";
+import { chunkNum, payloadAlpha } from "./helpers.js";
+export class ChunkChurnSignal {
+    name = "chunkChurn";
+    description = "Chunk-level commit count, dampened by alpha (coverage confidence).";
+    sources = ["chunk.commitCount", "file.commitCount"];
+    defaultBound = 30;
+    extract(rawSignals, ctx) {
+        const b = ctx?.bounds?.["chunk.commitCount"] ?? this.defaultBound;
+        const chunkCC = chunkNum(rawSignals, "commitCount");
+        const alpha = payloadAlpha(rawSignals);
+        return normalize(chunkCC, b) * alpha;
+    }
+}
+//# sourceMappingURL=chunk-churn.js.map

package/build/core/trajectory/git/rerank/derived-signals/chunk-churn.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunk-churn.js","sourceRoot":"","sources":["../../../../../../src/core/trajectory/git/rerank/derived-signals/chunk-churn.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,uCAAuC,CAAC;AAGlE,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAEtD,MAAM,OAAO,gBAAgB;IAClB,IAAI,GAAG,YAAY,CAAC;IACpB,WAAW,GAAG,oEAAoE,CAAC;IACnF,OAAO,GAAG,CAAC,mBAAmB,EAAE,kBAAkB,CAAC,CAAC;IACpD,YAAY,GAAG,EAAE,CAAC;IAC3B,OAAO,CAAC,UAAmC,EAAE,GAAoB;QAC/D,MAAM,CAAC,GAAG,GAAG,EAAE,MAAM,EAAE,CAAC,mBAAmB,CAAC,IAAI,IAAI,CAAC,YAAY,CAAC;QAClE,MAAM,OAAO,GAAG,QAAQ,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC;QACpD,MAAM,KAAK,GAAG,YAAY,CAAC,UAAU,CAAC,CAAC;QACvC,OAAO,SAAS,CAAC,OAAO,EAAE,CAAC,CAAC,GAAG,KAAK,CAAC;IACvC,CAAC;CACF"}

package/build/core/trajectory/git/rerank/derived-signals/chunk-relative-churn.d.ts

@@ -0,0 +1,10 @@
+import type { DerivedSignalDescriptor } from "../../../../contracts/types/reranker.js";
+import type { ExtractContext } from "../../../../contracts/types/trajectory.js";
+export declare class ChunkRelativeChurnSignal implements DerivedSignalDescriptor {
+    readonly name = "chunkRelativeChurn";
+    readonly description = "Chunk churn ratio: chunk's share of file-level churn, dampened by alpha.";
+    readonly sources: string[];
+    readonly defaultBound = 1;
+    extract(rawSignals: Record<string, unknown>, ctx?: ExtractContext): number;
+}
+//# sourceMappingURL=chunk-relative-churn.d.ts.map

package/build/core/trajectory/git/rerank/derived-signals/chunk-relative-churn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunk-relative-churn.d.ts","sourceRoot":"","sources":["../../../../../../src/core/trajectory/git/rerank/derived-signals/chunk-relative-churn.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,yCAAyC,CAAC;AACvF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2CAA2C,CAAC;AAGhF,qBAAa,wBAAyB,YAAW,uBAAuB;IACtE,QAAQ,CAAC,IAAI,wBAAwB;IACrC,QAAQ,CAAC,WAAW,8EAA8E;IAClG,QAAQ,CAAC,OAAO,WAA4C;IAC5D,QAAQ,CAAC,YAAY,KAAO;IAC5B,OAAO,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,CAAC,EAAE,cAAc,GAAG,MAAM;CAM3E"}

package/build/core/trajectory/git/rerank/derived-signals/chunk-relative-churn.js

@@ -0,0 +1,15 @@
+import { normalize } from "../../../../contracts/signal-utils.js";
+import { chunkNum, payloadAlpha } from "./helpers.js";
+export class ChunkRelativeChurnSignal {
+    name = "chunkRelativeChurn";
+    description = "Chunk churn ratio: chunk's share of file-level churn, dampened by alpha.";
+    sources = ["chunk.churnRatio", "file.commitCount"];
+    defaultBound = 1.0;
+    extract(rawSignals, ctx) {
+        const b = ctx?.bounds?.["chunk.churnRatio"] ?? this.defaultBound;
+        const chunkCR = chunkNum(rawSignals, "churnRatio");
+        const alpha = payloadAlpha(rawSignals);
+        return normalize(chunkCR, b) * alpha;
+    }
+}
+//# sourceMappingURL=chunk-relative-churn.js.map

package/build/core/trajectory/git/rerank/derived-signals/chunk-relative-churn.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunk-relative-churn.js","sourceRoot":"","sources":["../../../../../../src/core/trajectory/git/rerank/derived-signals/chunk-relative-churn.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,uCAAuC,CAAC;AAGlE,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAEtD,MAAM,OAAO,wBAAwB;IAC1B,IAAI,GAAG,oBAAoB,CAAC;IAC5B,WAAW,GAAG,0EAA0E,CAAC;IACzF,OAAO,GAAG,CAAC,kBAAkB,EAAE,kBAAkB,CAAC,CAAC;IACnD,YAAY,GAAG,GAAG,CAAC;IAC5B,OAAO,CAAC,UAAmC,EAAE,GAAoB;QAC/D,MAAM,CAAC,GAAG,GAAG,EAAE,MAAM,EAAE,CAAC,kBAAkB,CAAC,IAAI,IAAI,CAAC,YAAY,CAAC;QACjE,MAAM,OAAO,GAAG,QAAQ,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC;QACnD,MAAM,KAAK,GAAG,YAAY,CAAC,UAAU,CAAC,CAAC;QACvC,OAAO,SAAS,CAAC,OAAO,EAAE,CAAC,CAAC,GAAG,KAAK,CAAC;IACvC,CAAC;CACF"}

package/build/core/trajectory/git/rerank/derived-signals/churn.d.ts

@@ -0,0 +1,10 @@
+import type { DerivedSignalDescriptor } from "../../../../contracts/types/reranker.js";
+import type { ExtractContext } from "../../../../contracts/types/trajectory.js";
+export declare class ChurnSignal implements DerivedSignalDescriptor {
+    readonly name = "churn";
+    readonly description = "Direct commit count: frequently changed code scores higher. L3 blends chunk+file commitCount.";
+    readonly sources: string[];
+    readonly defaultBound = 50;
+    extract(rawSignals: Record<string, unknown>, ctx?: ExtractContext): number;
+}
+//# sourceMappingURL=churn.d.ts.map

package/build/core/trajectory/git/rerank/derived-signals/churn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"churn.d.ts","sourceRoot":"","sources":["../../../../../../src/core/trajectory/git/rerank/derived-signals/churn.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,yCAAyC,CAAC;AACvF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2CAA2C,CAAC;AAGhF,qBAAa,WAAY,YAAW,uBAAuB;IACzD,QAAQ,CAAC,IAAI,WAAW;IACxB,QAAQ,CAAC,WAAW,mGAC8E;IAClG,QAAQ,CAAC,OAAO,WAA6C;IAC7D,QAAQ,CAAC,YAAY,MAAM;IAC3B,OAAO,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,CAAC,EAAE,cAAc,GAAG,MAAM;CAK3E"}

package/build/core/trajectory/git/rerank/derived-signals/churn.js

@@ -0,0 +1,13 @@
+import { blendNormalized } from "./helpers.js";
+export class ChurnSignal {
+    name = "churn";
+    description = "Direct commit count: frequently changed code scores higher. L3 blends chunk+file commitCount.";
+    sources = ["file.commitCount", "chunk.commitCount"];
+    defaultBound = 50;
+    extract(rawSignals, ctx) {
+        const fb = ctx?.bounds?.["file.commitCount"] ?? this.defaultBound;
+        const cb = ctx?.bounds?.["chunk.commitCount"] ?? this.defaultBound;
+        return blendNormalized(rawSignals, "commitCount", fb, cb);
+    }
+}
+//# sourceMappingURL=churn.js.map

package/build/core/trajectory/git/rerank/derived-signals/churn.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"churn.js","sourceRoot":"","sources":["../../../../../../src/core/trajectory/git/rerank/derived-signals/churn.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE/C,MAAM,OAAO,WAAW;IACb,IAAI,GAAG,OAAO,CAAC;IACf,WAAW,GAClB,+FAA+F,CAAC;IACzF,OAAO,GAAG,CAAC,kBAAkB,EAAE,mBAAmB,CAAC,CAAC;IACpD,YAAY,GAAG,EAAE,CAAC;IAC3B,OAAO,CAAC,UAAmC,EAAE,GAAoB;QAC/D,MAAM,EAAE,GAAG,GAAG,EAAE,MAAM,EAAE,CAAC,kBAAkB,CAAC,IAAI,IAAI,CAAC,YAAY,CAAC;QAClE,MAAM,EAAE,GAAG,GAAG,EAAE,MAAM,EAAE,CAAC,mBAAmB,CAAC,IAAI,IAAI,CAAC,YAAY,CAAC;QACnE,OAAO,eAAe,CAAC,UAAU,EAAE,aAAa,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;IAC5D,CAAC;CACF"}

package/build/core/trajectory/git/rerank/derived-signals/density.d.ts

@@ -0,0 +1,12 @@
+import type { DerivedSignalDescriptor } from "../../../../contracts/types/reranker.js";
+import type { ExtractContext } from "../../../../contracts/types/trajectory.js";
+export declare class DensitySignal implements DerivedSignalDescriptor {
+    readonly name = "density";
+    readonly description = "Change density: commits per month. L3 blends chunk+file changeDensity.";
+    readonly sources: string[];
+    readonly defaultBound = 20;
+    readonly dampeningSource: import("../../../../contracts/types/trajectory.js").DampeningConfig;
+    private static readonly FALLBACK_THRESHOLD;
+    extract(rawSignals: Record<string, unknown>, ctx?: ExtractContext): number;
+}
+//# sourceMappingURL=density.d.ts.map

package/build/core/trajectory/git/rerank/derived-signals/density.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"density.d.ts","sourceRoot":"","sources":["../../../../../../src/core/trajectory/git/rerank/derived-signals/density.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,yCAAyC,CAAC;AACvF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2CAA2C,CAAC;AAGhF,qBAAa,aAAc,YAAW,uBAAuB;IAC3D,QAAQ,CAAC,IAAI,aAAa;IAC1B,QAAQ,CAAC,WAAW,4EAA4E;IAChG,QAAQ,CAAC,OAAO,WAAiD;IACjE,QAAQ,CAAC,YAAY,MAAM;IAC3B,QAAQ,CAAC,eAAe,sEAAsB;IAC9C,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,kBAAkB,CAAK;IAC/C,OAAO,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,CAAC,EAAE,cAAc,GAAG,MAAM;CAQ3E"}

package/build/core/trajectory/git/rerank/derived-signals/density.js

@@ -0,0 +1,18 @@
+import { blendNormalized, confidenceDampening, fileNum, GIT_FILE_DAMPENING } from "./helpers.js";
+export class DensitySignal {
+    name = "density";
+    description = "Change density: commits per month. L3 blends chunk+file changeDensity.";
+    sources = ["file.changeDensity", "chunk.changeDensity"];
+    defaultBound = 20;
+    dampeningSource = GIT_FILE_DAMPENING;
+    static FALLBACK_THRESHOLD = 5;
+    extract(rawSignals, ctx) {
+        const fb = ctx?.bounds?.["file.changeDensity"] ?? this.defaultBound;
+        const cb = ctx?.bounds?.["chunk.changeDensity"] ?? this.defaultBound;
+        let value = blendNormalized(rawSignals, "changeDensity", fb, cb);
+        const k = ctx?.dampeningThreshold ?? DensitySignal.FALLBACK_THRESHOLD;
+        value *= confidenceDampening(fileNum(rawSignals, "commitCount"), k);
+        return value;
+    }
+}
+//# sourceMappingURL=density.js.map

package/build/core/trajectory/git/rerank/derived-signals/density.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"density.js","sourceRoot":"","sources":["../../../../../../src/core/trajectory/git/rerank/derived-signals/density.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAEjG,MAAM,OAAO,aAAa;IACf,IAAI,GAAG,SAAS,CAAC;IACjB,WAAW,GAAG,wEAAwE,CAAC;IACvF,OAAO,GAAG,CAAC,oBAAoB,EAAE,qBAAqB,CAAC,CAAC;IACxD,YAAY,GAAG,EAAE,CAAC;IAClB,eAAe,GAAG,kBAAkB,CAAC;IACtC,MAAM,CAAU,kBAAkB,GAAG,CAAC,CAAC;IAC/C,OAAO,CAAC,UAAmC,EAAE,GAAoB;QAC/D,MAAM,EAAE,GAAG,GAAG,EAAE,MAAM,EAAE,CAAC,oBAAoB,CAAC,IAAI,IAAI,CAAC,YAAY,CAAC;QACpE,MAAM,EAAE,GAAG,GAAG,EAAE,MAAM,EAAE,CAAC,qBAAqB,CAAC,IAAI,IAAI,CAAC,YAAY,CAAC;QACrE,IAAI,KAAK,GAAG,eAAe,CAAC,UAAU,EAAE,eAAe,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;QACjE,MAAM,CAAC,GAAG,GAAG,EAAE,kBAAkB,IAAI,aAAa,CAAC,kBAAkB,CAAC;QACtE,KAAK,IAAI,mBAAmB,CAAC,OAAO,CAAC,UAAU,EAAE,aAAa,CAAC,EAAE,CAAC,CAAC,CAAC;QACpE,OAAO,KAAK,CAAC;IACf,CAAC"}

package/build/core/trajectory/git/rerank/derived-signals/helpers.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Git-specific payload accessors and blending helpers for derived signals.
+ *
+ * Supports both nested (git.file.*, git.chunk.*) and flat (git.*) payload formats.
+ * Generic algorithms (computeAlpha, blend, normalize, confidenceDampening)
+ * live in contracts/signal-utils.
+ */
+export { blend, computeAlpha, confidenceDampening, normalize } from "../../../../contracts/signal-utils.js";
+export { GIT_FILE_DAMPENING } from "../constants.js";
+export interface GitLike {
+    file?: Record<string, unknown>;
+    chunk?: Record<string, unknown>;
+    [key: string]: unknown;
+}
+/** Safely extract the git object from the payload. */
+export declare function getGit(payload: Record<string, unknown>): GitLike | undefined;
+/** Read a file-level field, checking nested first then flat. */
+export declare function fileField(payload: Record<string, unknown>, field: string): unknown;
+/** Read a file-level numeric field. */
+export declare function fileNum(payload: Record<string, unknown>, field: string): number;
+/**
+ * Read a chunk-level field, returning undefined if absent.
+ * Distinguishes between "field missing" and "field = 0" for correct blend semantics.
+ */
+export declare function chunkField(payload: Record<string, unknown>, field: string): number | undefined;
+/**
+ * Read a chunk-level numeric field (returns 0 for missing — use chunkField for undefined semantics).
+ */
+export declare function chunkNum(payload: Record<string, unknown>, field: string): number;
+/** Check if chunk-level data exists at all. */
+export declare function hasChunkData(payload: Record<string, unknown>): boolean;
+/** Get alpha from payload's chunk and file commit counts. */
+export declare function payloadAlpha(payload: Record<string, unknown>): number;
+/**
+ * Blend a file+chunk numeric signal using payload alpha.
+ * For signals where chunk-level data may not exist (e.g., ageDays, bugFixRate).
+ */
+export declare function blendSignal(payload: Record<string, unknown>, field: string): number;
+/**
+ * Normalize file and chunk values with per-source bounds, then alpha-blend.
+ * Each source is normalized to its own distribution before blending.
+ */
+export declare function blendNormalized(payload: Record<string, unknown>, field: string, fileBound: number, chunkBound: number): number;
+//# sourceMappingURL=helpers.d.ts.map

package/build/core/trajectory/git/rerank/derived-signals/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../../../../../src/core/trajectory/git/rerank/derived-signals/helpers.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,mBAAmB,EAAE,SAAS,EAAE,MAAM,uCAAuC,CAAC;AAE5G,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAMrD,MAAM,WAAW,OAAO;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,sDAAsD;AACtD,wBAAgB,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,GAAG,SAAS,CAI5E;AAED,gEAAgE;AAChE,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAYlF;AAED,uCAAuC;AACvC,wBAAgB,OAAO,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAG/E;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAM9F;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAEhF;AAED,+CAA+C;AAC/C,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAQtE;AAMD,6DAA6D;AAC7D,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAYrE;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAMnF;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,GACjB,MAAM,CAOR"}

package/build/core/trajectory/git/rerank/derived-signals/helpers.js

@@ -0,0 +1,112 @@
+/**
+ * Git-specific payload accessors and blending helpers for derived signals.
+ *
+ * Supports both nested (git.file.*, git.chunk.*) and flat (git.*) payload formats.
+ * Generic algorithms (computeAlpha, blend, normalize, confidenceDampening)
+ * live in contracts/signal-utils.
+ */
+import { blend, computeAlpha, normalize } from "../../../../contracts/signal-utils.js";
+// Re-export generic functions used directly by signal classes
+export { blend, computeAlpha, confidenceDampening, normalize } from "../../../../contracts/signal-utils.js";
+// Re-export git constants
+export { GIT_FILE_DAMPENING } from "../constants.js";
+/** Safely extract the git object from the payload. */
+export function getGit(payload) {
+    const { git } = payload;
+    if (git && typeof git === "object")
+        return git;
+    return undefined;
+}
+/** Read a file-level field, checking nested first then flat. */
+export function fileField(payload, field) {
+    const git = getGit(payload);
+    if (!git)
+        return undefined;
+    // Nested: git.file.<field>
+    if (git.file && typeof git.file === "object" && field in git.file) {
+        return git.file[field];
+    }
+    // Flat: git.<field>
+    if (field in git) {
+        return git[field];
+    }
+    return undefined;
+}
+/** Read a file-level numeric field. */
+export function fileNum(payload, field) {
+    const val = fileField(payload, field);
+    return typeof val === "number" ? val : 0;
+}
+/**
+ * Read a chunk-level field, returning undefined if absent.
+ * Distinguishes between "field missing" and "field = 0" for correct blend semantics.
+ */
+export function chunkField(payload, field) {
+    const git = getGit(payload);
+    if (!git?.chunk || typeof git.chunk !== "object")
+        return undefined;
+    if (!(field in git.chunk))
+        return undefined;
+    const val = git.chunk[field];
+    return typeof val === "number" ? val : undefined;
+}
+/**
+ * Read a chunk-level numeric field (returns 0 for missing — use chunkField for undefined semantics).
+ */
+export function chunkNum(payload, field) {
+    return chunkField(payload, field) ?? 0;
+}
+/** Check if chunk-level data exists at all. */
+export function hasChunkData(payload) {
+    const git = getGit(payload);
+    if (!git)
+        return false;
+    if (git.chunk && typeof git.chunk === "object") {
+        const { chunk } = git;
+        return chunk.commitCount !== undefined;
+    }
+    return false;
+}
+// ---------------------------------------------------------------------------
+// Blending helpers (compute alpha from payload)
+// ---------------------------------------------------------------------------
+/** Get alpha from payload's chunk and file commit counts. */
+export function payloadAlpha(payload) {
+    const chunkCC = chunkField(payload, "commitCount");
+    if (chunkCC === undefined || chunkCC <= 0)
+        return 0;
+    // Distinguish "file data absent" from "fileCount = 0":
+    // fileField returns undefined when git.file.commitCount doesn't exist,
+    // meaning chunk-only payload → trust chunk data fully (alpha = 1).
+    const rawFileCC = fileField(payload, "commitCount");
+    if (rawFileCC === undefined)
+        return 1;
+    const fileCC = typeof rawFileCC === "number" ? rawFileCC : 0;
+    return computeAlpha(chunkCC, fileCC);
+}
+/**
+ * Blend a file+chunk numeric signal using payload alpha.
+ * For signals where chunk-level data may not exist (e.g., ageDays, bugFixRate).
+ */
+export function blendSignal(payload, field) {
+    const fileVal = fileNum(payload, field);
+    const alpha = payloadAlpha(payload);
+    if (alpha === 0)
+        return fileVal;
+    const chunkVal = chunkField(payload, field);
+    return blend(chunkVal, fileVal, alpha);
+}
+/**
+ * Normalize file and chunk values with per-source bounds, then alpha-blend.
+ * Each source is normalized to its own distribution before blending.
+ */
+export function blendNormalized(payload, field, fileBound, chunkBound) {
+    const fileVal = normalize(fileNum(payload, field), fileBound);
+    const alpha = payloadAlpha(payload);
+    if (alpha === 0)
+        return fileVal;
+    const chunkVal = chunkField(payload, field);
+    const normalizedChunk = chunkVal !== undefined ? normalize(chunkVal, chunkBound) : fileVal;
+    return blend(normalizedChunk, fileVal, alpha);
+}
+//# sourceMappingURL=helpers.js.map

package/build/core/trajectory/git/rerank/derived-signals/helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../../../../../src/core/trajectory/git/rerank/derived-signals/helpers.ts"],"names":[],"mappings":"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"}