@skastr0/pulsar-core 0.1.0

package/dist/scoring-engine-git-run.d.ts

@@ -0,0 +1,7 @@
+import { Effect } from "effect";
+interface RunGitOpts<E> {
+    readonly onFail: (message: string) => E;
+}
+export declare const runGit: <E>(cwd: string, args: ReadonlyArray<string>, opts: RunGitOpts<E>) => Effect.Effect<string, E>;
+export {};
+//# sourceMappingURL=scoring-engine-git-run.d.ts.map

package/dist/scoring-engine-git-run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scoring-engine-git-run.d.ts","sourceRoot":"","sources":["../src/scoring-engine-git-run.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAE/B,UAAU,UAAU,CAAC,CAAC;IACpB,QAAQ,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,CAAC,CAAA;CACxC;AAED,eAAO,MAAM,MAAM,GAAI,CAAC,EACtB,KAAK,MAAM,EACX,MAAM,aAAa,CAAC,MAAM,CAAC,EAC3B,MAAM,UAAU,CAAC,CAAC,CAAC,KAClB,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAiCtB,CAAA"}

package/dist/scoring-engine-git-run.js

@@ -0,0 +1,32 @@
+import { spawn } from "node:child_process";
+import { Effect } from "effect";
+export const runGit = (cwd, args, opts) => Effect.tryPromise({
+    try: (signal) => new Promise((resolve, reject) => {
+        const child = spawn("git", args, { cwd });
+        let stdout = "";
+        let stderr = "";
+        const onAbort = () => {
+            child.kill("SIGTERM");
+        };
+        signal.addEventListener("abort", onAbort, { once: true });
+        child.stdout.on("data", (chunk) => {
+            stdout += chunk.toString();
+        });
+        child.stderr.on("data", (chunk) => {
+            stderr += chunk.toString();
+        });
+        child.on("error", (err) => {
+            signal.removeEventListener("abort", onAbort);
+            reject(err);
+        });
+        child.on("close", (code) => {
+            signal.removeEventListener("abort", onAbort);
+            if (code === 0)
+                resolve(stdout);
+            else
+                reject(new Error(`git ${args.join(" ")} exited with code ${code}: ${stderr.trim()}`));
+        });
+    }),
+    catch: (cause) => opts.onFail(cause instanceof Error ? cause.message : String(cause)),
+});
+//# sourceMappingURL=scoring-engine-git-run.js.map

package/dist/scoring-engine-git-run.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scoring-engine-git-run.js","sourceRoot":"","sources":["../src/scoring-engine-git-run.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAA;AAC1C,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAM/B,MAAM,CAAC,MAAM,MAAM,GAAG,CACpB,GAAW,EACX,IAA2B,EAC3B,IAAmB,EACO,EAAE,CAC5B,MAAM,CAAC,UAAU,CAAC;IAChB,GAAG,EAAE,CAAC,MAAM,EAAE,EAAE,CACd,IAAI,OAAO,CAAS,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACtC,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,EAAE,IAAqB,EAAE,EAAE,GAAG,EAAE,CAAC,CAAA;QAC1D,IAAI,MAAM,GAAG,EAAE,CAAA;QACf,IAAI,MAAM,GAAG,EAAE,CAAA;QACf,MAAM,OAAO,GAAG,GAAG,EAAE;YACnB,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;QACvB,CAAC,CAAA;QACD,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAA;QACzD,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE;YAChC,MAAM,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAA;QAC5B,CAAC,CAAC,CAAA;QACF,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE;YAChC,MAAM,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAA;QAC5B,CAAC,CAAC,CAAA;QACF,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;YACxB,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;YAC5C,MAAM,CAAC,GAAG,CAAC,CAAA;QACb,CAAC,CAAC,CAAA;QACF,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;YACzB,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;YAC5C,IAAI,IAAI,KAAK,CAAC;gBAAE,OAAO,CAAC,MAAM,CAAC,CAAA;;gBAE7B,MAAM,CACJ,IAAI,KAAK,CACP,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,qBAAqB,IAAI,KAAK,MAAM,CAAC,IAAI,EAAE,EAAE,CACnE,CACF,CAAA;QACL,CAAC,CAAC,CAAA;IACJ,CAAC,CAAC;IACJ,KAAK,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;CACtF,CAAC,CAAA"}

package/dist/scoring-engine-git-worktree.d.ts

@@ -0,0 +1,9 @@
+import { Effect } from "effect";
+import { type ScoringEngineError } from "./errors.js";
+export declare const canUseCurrentWorktreeForCommit: (repoPath: string, sha: string) => Effect.Effect<boolean>;
+/**
+ * Acquire a worktree at the given commit. Tears it down on scope exit —
+ * whether via normal completion, failure, or interruption.
+ */
+export declare const acquireWorktree: (repoPath: string, sha: string) => Effect.Effect<string, ScoringEngineError, import("effect/Scope").Scope>;
+//# sourceMappingURL=scoring-engine-git-worktree.d.ts.map

package/dist/scoring-engine-git-worktree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scoring-engine-git-worktree.d.ts","sourceRoot":"","sources":["../src/scoring-engine-git-worktree.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAC/B,OAAO,EAGL,KAAK,kBAAkB,EACxB,MAAM,aAAa,CAAA;AAGpB,eAAO,MAAM,8BAA8B,GACzC,UAAU,MAAM,EAChB,KAAK,MAAM,KACV,MAAM,CAAC,MAAM,CAAC,OAAO,CA4BpB,CAAA;AAEJ;;;GAGG;AACH,eAAO,MAAM,eAAe,GAC1B,UAAU,MAAM,EAChB,KAAK,MAAM,KACV,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,kBAAkB,EAAE,OAAO,cAAc,EAAE,KAAK,CAsEtE,CAAA"}

package/dist/scoring-engine-git-worktree.js

@@ -0,0 +1,83 @@
+import { mkdtemp, rm } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { Effect } from "effect";
+import { WorktreeCreateFailed, WorktreeRemoveFailed, } from "./errors.js";
+import { runGit } from "./scoring-engine-git-run.js";
+export const canUseCurrentWorktreeForCommit = (repoPath, sha) => Effect.gen(function* () {
+    const head = yield* Effect.either(runGit(repoPath, ["rev-parse", "HEAD"], {
+        onFail: (message) => new Error(message),
+    }));
+    if (head._tag === "Left")
+        return false;
+    if (head.right.trim() !== sha)
+        return false;
+    const status = yield* Effect.either(runGit(repoPath, [
+        "status",
+        "--porcelain=v1",
+        "--untracked-files=all",
+        "--",
+        ".",
+        ":!.pulsar/cache",
+    ], {
+        onFail: (message) => new Error(message),
+    }));
+    if (status._tag === "Left")
+        return false;
+    return status.right.trim().length === 0;
+});
+/**
+ * Acquire a worktree at the given commit. Tears it down on scope exit —
+ * whether via normal completion, failure, or interruption.
+ */
+export const acquireWorktree = (repoPath, sha) => Effect.acquireRelease(Effect.gen(function* () {
+    const prefix = join(tmpdir(), `pulsar-worktree-${sha.slice(0, 12)}-`);
+    const dir = yield* Effect.tryPromise({
+        try: () => mkdtemp(prefix),
+        catch: (cause) => new WorktreeCreateFailed({
+            repoPath,
+            sha,
+            message: `mkdtemp failed: ${String(cause)}`,
+        }),
+    });
+    // `git worktree add` requires the target to not exist — mkdtemp
+    // just created it, so remove before add.
+    yield* Effect.tryPromise({
+        try: () => rm(dir, { recursive: true, force: true }),
+        catch: (cause) => new WorktreeCreateFailed({
+            repoPath,
+            sha,
+            message: `prep cleanup failed: ${String(cause)}`,
+        }),
+    });
+    yield* runGit(repoPath, ["worktree", "prune"], {
+        onFail: (msg) => new WorktreeCreateFailed({
+            repoPath,
+            sha,
+            message: `git worktree prune failed: ${msg}`,
+        }),
+    });
+    yield* runGit(repoPath, ["worktree", "add", "--detach", "--force", dir, sha], {
+        onFail: (msg) => new WorktreeCreateFailed({ repoPath, sha, message: msg }),
+    });
+    return dir;
+}), (dir) => Effect.gen(function* () {
+    // Release must not fail loudly — swallow so interruption still
+    // finalizes. We log a warning on remove failure.
+    const removed = yield* Effect.either(runGit(repoPath, ["worktree", "remove", "--force", dir], {
+        onFail: (msg) => new WorktreeRemoveFailed({ worktreePath: dir, message: msg }),
+    }));
+    if (removed._tag === "Left") {
+        yield* Effect.logWarning(`worktree remove failed for ${dir}: ${removed.left.message}`);
+        // Best-effort filesystem cleanup when `git worktree remove` fails
+        // (e.g. the worktree directory is gone already).
+        yield* Effect.promise(() => rm(dir, { recursive: true, force: true }));
+    }
+    yield* Effect.either(runGit(repoPath, ["worktree", "prune"], {
+        onFail: (msg) => new WorktreeRemoveFailed({
+            worktreePath: dir,
+            message: `git worktree prune failed: ${msg}`,
+        }),
+    }));
+}));
+//# sourceMappingURL=scoring-engine-git-worktree.js.map

package/dist/scoring-engine-git-worktree.js.map

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

package/dist/scoring-engine-git.d.ts

@@ -0,0 +1,5 @@
+export { computeContentHash, computeGitRevisionContextHash, computeWorktreeContentHash, } from "./scoring-engine-git-content-hash.js";
+export { collectWorktreeChangedHunks } from "./scoring-engine-git-diff.js";
+export { resolveRange } from "./scoring-engine-git-range.js";
+export { acquireWorktree, canUseCurrentWorktreeForCommit, } from "./scoring-engine-git-worktree.js";
+//# sourceMappingURL=scoring-engine-git.d.ts.map

package/dist/scoring-engine-git.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scoring-engine-git.d.ts","sourceRoot":"","sources":["../src/scoring-engine-git.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAClB,6BAA6B,EAC7B,0BAA0B,GAC3B,MAAM,sCAAsC,CAAA;AAC7C,OAAO,EAAE,2BAA2B,EAAE,MAAM,8BAA8B,CAAA;AAC1E,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAA;AAC5D,OAAO,EACL,eAAe,EACf,8BAA8B,GAC/B,MAAM,kCAAkC,CAAA"}

package/dist/scoring-engine-git.js

@@ -0,0 +1,5 @@
+export { computeContentHash, computeGitRevisionContextHash, computeWorktreeContentHash, } from "./scoring-engine-git-content-hash.js";
+export { collectWorktreeChangedHunks } from "./scoring-engine-git-diff.js";
+export { resolveRange } from "./scoring-engine-git-range.js";
+export { acquireWorktree, canUseCurrentWorktreeForCommit, } from "./scoring-engine-git-worktree.js";
+//# sourceMappingURL=scoring-engine-git.js.map

package/dist/scoring-engine-git.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scoring-engine-git.js","sourceRoot":"","sources":["../src/scoring-engine-git.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAClB,6BAA6B,EAC7B,0BAA0B,GAC3B,MAAM,sCAAsC,CAAA;AAC7C,OAAO,EAAE,2BAA2B,EAAE,MAAM,8BAA8B,CAAA;AAC1E,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAA;AAC5D,OAAO,EACL,eAAe,EACf,8BAA8B,GAC/B,MAAM,kCAAkC,CAAA"}

package/dist/scoring-engine-layer.d.ts

@@ -0,0 +1,12 @@
+import { Layer } from "effect";
+import type { Registry } from "./registry.js";
+import { ScoringEngineTag, type PackLayerFactory } from "./scoring-engine-contract.js";
+import { type ScoringEngineOptions } from "./scoring-engine-runtime.js";
+import type { PulsarVector } from "./vector.js";
+/**
+ * Build the scoring engine layer. The registry is frozen at layer
+ * construction; the cache is created once and shared across every
+ * commit scored by this engine instance.
+ */
+export declare const ScoringEngineLayer: (registry: Registry, packLayerFactory: PackLayerFactory, vector?: PulsarVector, options?: ScoringEngineOptions) => Layer.Layer<ScoringEngineTag>;
+//# sourceMappingURL=scoring-engine-layer.d.ts.map

package/dist/scoring-engine-layer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scoring-engine-layer.d.ts","sourceRoot":"","sources":["../src/scoring-engine-layer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAU,KAAK,EAAE,MAAM,QAAQ,CAAA;AACtC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAC7C,OAAO,EACL,gBAAgB,EAChB,KAAK,gBAAgB,EACtB,MAAM,8BAA8B,CAAA;AAOrC,OAAO,EAIL,KAAK,oBAAoB,EAC1B,MAAM,6BAA6B,CAAA;AAKpC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAE/C;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,GAC7B,UAAU,QAAQ,EAClB,kBAAkB,gBAAgB,EAClC,SAAS,YAAY,EACrB,UAAU,oBAAoB,KAC7B,KAAK,CAAC,KAAK,CAAC,gBAAgB,CAyC5B,CAAA"}

package/dist/scoring-engine-layer.js

@@ -0,0 +1,48 @@
+import { Effect, Layer } from "effect";
+import { ScoringEngineTag, } from "./scoring-engine-contract.js";
+import { makeObserveCommit, makeObserveRange, makeObserveWithCache, makeObserveWorktree, } from "./scoring-engine-observe.js";
+import { makeEngineInternals, makeRunWithEnvironment, makeWithCommitWorktree, } from "./scoring-engine-runtime.js";
+import { makeScoreCommit, makeScoreRange, } from "./scoring-engine-score.js";
+/**
+ * Build the scoring engine layer. The registry is frozen at layer
+ * construction; the cache is created once and shared across every
+ * commit scored by this engine instance.
+ */
+export const ScoringEngineLayer = (registry, packLayerFactory, vector, options) => Layer.effect(ScoringEngineTag, Effect.gen(function* () {
+    const internals = yield* makeEngineInternals(packLayerFactory, options);
+    const runWithEnvironment = makeRunWithEnvironment(internals);
+    const withCommitWorktree = makeWithCommitWorktree();
+    const observeWithCache = makeObserveWithCache(internals.cacheRef, options);
+    const scoreCommit = makeScoreCommit({
+        registry,
+        vector,
+        internals,
+        runWithEnvironment,
+        withCommitWorktree,
+    });
+    const observeCommit = makeObserveCommit({
+        registry,
+        vector,
+        options,
+        internals,
+        runWithEnvironment,
+        withCommitWorktree,
+        observeWithCache,
+    });
+    return ScoringEngineTag.of({
+        scoreCommit,
+        scoreRange: makeScoreRange(scoreCommit),
+        observeCommit,
+        observeWorktree: makeObserveWorktree({
+            registry,
+            vector,
+            options,
+            internals,
+            runWithEnvironment,
+            observeWithCache,
+            observeCommit,
+        }),
+        observeRange: makeObserveRange(observeCommit),
+    });
+}));
+//# sourceMappingURL=scoring-engine-layer.js.map

package/dist/scoring-engine-layer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scoring-engine-layer.js","sourceRoot":"","sources":["../src/scoring-engine-layer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAA;AAEtC,OAAO,EACL,gBAAgB,GAEjB,MAAM,8BAA8B,CAAA;AACrC,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EAChB,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,6BAA6B,CAAA;AACpC,OAAO,EACL,mBAAmB,EACnB,sBAAsB,EACtB,sBAAsB,GAEvB,MAAM,6BAA6B,CAAA;AACpC,OAAO,EACL,eAAe,EACf,cAAc,GACf,MAAM,2BAA2B,CAAA;AAGlC;;;;GAIG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAChC,QAAkB,EAClB,gBAAkC,EAClC,MAAqB,EACrB,OAA8B,EACC,EAAE,CACjC,KAAK,CAAC,MAAM,CACV,gBAAgB,EAChB,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IAClB,MAAM,SAAS,GAAG,KAAK,CAAC,CAAC,mBAAmB,CAAC,gBAAgB,EAAE,OAAO,CAAC,CAAA;IACvE,MAAM,kBAAkB,GAAG,sBAAsB,CAAC,SAAS,CAAC,CAAA;IAC5D,MAAM,kBAAkB,GAAG,sBAAsB,EAAE,CAAA;IACnD,MAAM,gBAAgB,GAAG,oBAAoB,CAAC,SAAS,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAA;IAC1E,MAAM,WAAW,GAAG,eAAe,CAAC;QAClC,QAAQ;QACR,MAAM;QACN,SAAS;QACT,kBAAkB;QAClB,kBAAkB;KACnB,CAAC,CAAA;IACF,MAAM,aAAa,GAAG,iBAAiB,CAAC;QACtC,QAAQ;QACR,MAAM;QACN,OAAO;QACP,SAAS;QACT,kBAAkB;QAClB,kBAAkB;QAClB,gBAAgB;KACjB,CAAC,CAAA;IAEF,OAAO,gBAAgB,CAAC,EAAE,CAAC;QACzB,WAAW;QACX,UAAU,EAAE,cAAc,CAAC,WAAW,CAAC;QACvC,aAAa;QACb,eAAe,EAAE,mBAAmB,CAAC;YACnC,QAAQ;YACR,MAAM;YACN,OAAO;YACP,SAAS;YACT,kBAAkB;YAClB,gBAAgB;YAChB,aAAa;SACd,CAAC;QACF,YAAY,EAAE,gBAAgB,CAAC,aAAa,CAAC;KAC9C,CAAC,CAAA;AACJ,CAAC,CAAC,CACH,CAAA"}

package/dist/scoring-engine-observe.d.ts

@@ -0,0 +1,50 @@
+import { Effect } from "effect";
+import { type CacheKey, type SignalCache } from "./cache.js";
+import type { ChangedHunk } from "./context.js";
+import type { ScoringEngineError } from "./errors.js";
+import { type ObserverOutput } from "./observer.js";
+import type { Registry } from "./registry.js";
+import type { EngineInternals, RunWithEnvironment, WithCommitWorktree } from "./scoring-engine-runtime.js";
+import type { PulsarVector } from "./vector.js";
+type ObserveWithCache = (key: CacheKey, runFresh: () => Effect.Effect<ObserverOutput, ScoringEngineError, never>) => Effect.Effect<{
+    readonly result: ObserverOutput;
+    readonly cacheHit: boolean;
+}, ScoringEngineError, never>;
+type ObserveCommit = (repoPath: string, sha: string) => Effect.Effect<ObserverOutput, ScoringEngineError, never>;
+type ObserveWorktree = (repoPath: string, headSha: string, worktreeOptions?: {
+    readonly changedHunks?: ReadonlyArray<ChangedHunk>;
+}) => Effect.Effect<ObserverOutput, ScoringEngineError, never>;
+type ObserveRange = (repoPath: string, fromSha: string, toSha: string, options?: {
+    concurrency?: number;
+}) => Effect.Effect<ReadonlyArray<{
+    readonly sha: string;
+    readonly result: ObserverOutput;
+}>, ScoringEngineError, never>;
+interface ObserveEngineOptions {
+    readonly observerProfile?: boolean;
+    readonly timeSeriesWriter?: {
+        readonly appendObservation: (sha: string, observerOutput: ObserverOutput) => Effect.Effect<unknown, ScoringEngineError, never>;
+    };
+}
+export declare const makeObserveWithCache: (cacheRef: SignalCache, options?: ObserveEngineOptions) => ObserveWithCache;
+export declare const makeObserveCommit: (args: {
+    readonly registry: Registry;
+    readonly vector: PulsarVector | undefined;
+    readonly options: ObserveEngineOptions | undefined;
+    readonly internals: EngineInternals;
+    readonly runWithEnvironment: RunWithEnvironment;
+    readonly withCommitWorktree: WithCommitWorktree;
+    readonly observeWithCache: ObserveWithCache;
+}) => ObserveCommit;
+export declare const makeObserveWorktree: (args: {
+    readonly registry: Registry;
+    readonly vector: PulsarVector | undefined;
+    readonly options: ObserveEngineOptions | undefined;
+    readonly internals: EngineInternals;
+    readonly runWithEnvironment: RunWithEnvironment;
+    readonly observeWithCache: ObserveWithCache;
+    readonly observeCommit: ObserveCommit;
+}) => ObserveWorktree;
+export declare const makeObserveRange: (observeCommit: ObserveCommit) => ObserveRange;
+export {};
+//# sourceMappingURL=scoring-engine-observe.d.ts.map

package/dist/scoring-engine-observe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scoring-engine-observe.d.ts","sourceRoot":"","sources":["../src/scoring-engine-observe.ts"],"names":[],"mappings":"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"}

package/dist/scoring-engine-observe.js

@@ -0,0 +1,77 @@
+import { Effect } from "effect";
+import { cacheKeyString, } from "./cache.js";
+import { observe } from "./observer.js";
+import { loadCanonicalReferenceDataEntries } from "./reference-data-loader.js";
+import { computeObserverConfigHash, computeReferenceVersionHash, fromCachedObserverOutput, hashChangedHunks, OBSERVER_CACHE_SIGNAL_ID, toCachedObserverOutput, nowMs, withRuntimeEnvironmentProfile, } from "./scoring-engine-observer-cache.js";
+import { canUseCurrentWorktreeForCommit, collectWorktreeChangedHunks, computeContentHash, computeGitRevisionContextHash, computeWorktreeContentHash, resolveRange, } from "./scoring-engine-git.js";
+const GIT_REVISION_CONTEXT_CACHE_DEPENDENCY = "git-revision-context";
+export const makeObserveWithCache = (cacheRef, options) => (key, runFresh) => Effect.gen(function* () {
+    const cached = yield* cacheRef.getTiered(key, { tier: 1 });
+    const profile = options?.observerProfile === true;
+    const cacheHit = !profile && (cached.status === "hit" || cached.status === "stale");
+    if (cacheHit)
+        return { result: fromCachedObserverOutput(cached.value), cacheHit };
+    const runtimeStartedAt = nowMs();
+    const result = yield* runFresh().pipe(Effect.map((fresh) => profile ? withRuntimeEnvironmentProfile(fresh, nowMs() - runtimeStartedAt) : fresh), Effect.tap((fresh) => profile ? Effect.void : cacheRef.setTiered(key, toCachedObserverOutput(fresh), { tier: 1 })));
+    return { result, cacheHit };
+});
+export const makeObserveCommit = (args) => Effect.fn("ScoringEngine.observeCommit")(function* (repoPath, sha) {
+    yield* Effect.annotateCurrentSpan("sha", sha);
+    const { result, cacheHit, key } = yield* args.withCommitWorktree(repoPath, sha, (worktreePath) => Effect.gen(function* () {
+        const contentHash = yield* observerContentHash(args.registry, repoPath, worktreePath, sha);
+        return yield* observeCommitInWorktree({ ...args, repoPath, sha, worktreePath, contentHash });
+    }));
+    yield* Effect.annotateCurrentSpan("cacheKey", cacheKeyString(key));
+    yield* Effect.annotateCurrentSpan("cacheHit", cacheHit);
+    if (args.options?.timeSeriesWriter !== undefined) {
+        yield* args.options.timeSeriesWriter.appendObservation(sha, result);
+    }
+    return result;
+});
+const observeCommitInWorktree = (args) => Effect.gen(function* () {
+    const calibrationContext = yield* args.internals.resolveCalibrationContext(args.worktreePath);
+    const referenceEntries = yield* loadCanonicalReferenceDataEntries(args.worktreePath);
+    const key = observerCacheKey(args, calibrationContext?.fingerprint, referenceEntries);
+    const observed = yield* args.observeWithCache(key, () => args.runWithEnvironment(args.worktreePath, args.sha, [], calibrationContext, (EnvLayer) => Effect.provide(observe(args.registry, args.vector, { profile: args.options?.observerProfile === true }), EnvLayer)));
+    return { ...observed, key };
+});
+const observerCacheKey = (args, calibrationFingerprint, referenceEntries) => ({
+    signalId: OBSERVER_CACHE_SIGNAL_ID,
+    contentHash: args.contentHash,
+    configHash: computeObserverConfigHash(args.registry, args.vector, calibrationFingerprint, computeReferenceVersionHash(referenceEntries)),
+});
+export const makeObserveWorktree = (args) => Effect.fn("ScoringEngine.observeWorktree")(function* (repoPath, headSha, worktreeOptions) {
+    yield* Effect.annotateCurrentSpan("sha", headSha);
+    const cleanHead = yield* canUseCurrentWorktreeForCommit(repoPath, headSha);
+    if (cleanHead)
+        return yield* args.observeCommit(repoPath, headSha);
+    const changedHunks = worktreeOptions?.changedHunks ?? (yield* collectWorktreeChangedHunks(repoPath));
+    const baseContentHash = `${yield* computeWorktreeContentHash(repoPath)}:${hashChangedHunks(changedHunks)}`;
+    const contentHash = yield* appendObserverRevisionContext(args.registry, repoPath, baseContentHash);
+    const calibrationContext = yield* args.internals.resolveCalibrationContext(repoPath);
+    const referenceEntries = yield* loadCanonicalReferenceDataEntries(repoPath);
+    const key = observerCacheKey({ ...args, contentHash }, calibrationContext?.fingerprint, referenceEntries);
+    const { result, cacheHit } = yield* args.observeWithCache(key, () => args.runWithEnvironment(repoPath, headSha, changedHunks, calibrationContext, (EnvLayer) => Effect.provide(observe(args.registry, args.vector, { profile: args.options?.observerProfile === true }), EnvLayer)));
+    yield* Effect.annotateCurrentSpan("cacheKey", cacheKeyString(key));
+    yield* Effect.annotateCurrentSpan("cacheHit", cacheHit);
+    return result;
+});
+const observerContentHash = (registry, repoPath, worktreePath, sha) => Effect.gen(function* () {
+    const contentHash = yield* computeContentHash(repoPath, sha);
+    return yield* appendObserverRevisionContext(registry, worktreePath, contentHash);
+});
+const appendObserverRevisionContext = (registry, worktreePath, contentHash) => Effect.gen(function* () {
+    if (!registry.sorted.some((signal) => signal.cacheDependencies?.includes(GIT_REVISION_CONTEXT_CACHE_DEPENDENCY))) {
+        return contentHash;
+    }
+    const revisionContextHash = yield* computeGitRevisionContextHash(worktreePath);
+    return `${contentHash}:${GIT_REVISION_CONTEXT_CACHE_DEPENDENCY}:${revisionContextHash}`;
+});
+export const makeObserveRange = (observeCommit) => Effect.fn("ScoringEngine.observeRange")(function* (repoPath, fromSha, toSha, options) {
+    yield* Effect.annotateCurrentSpan("fromSha", fromSha);
+    yield* Effect.annotateCurrentSpan("toSha", toSha);
+    const shas = yield* resolveRange(repoPath, fromSha, toSha);
+    yield* Effect.annotateCurrentSpan("commitCount", shas.length);
+    return yield* Effect.forEach(shas, (sha) => observeCommit(repoPath, sha).pipe(Effect.map((result) => ({ sha, result }))), { concurrency: options?.concurrency ?? 4 });
+});
+//# sourceMappingURL=scoring-engine-observe.js.map

package/dist/scoring-engine-observe.js.map

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

package/dist/scoring-engine-observer-cache.d.ts

@@ -0,0 +1,36 @@
+import type { ChangedHunk } from "./context.js";
+import { type ObserverOutput } from "./observer.js";
+import type { Registry } from "./registry.js";
+import type { SignalRunResult } from "./runner.js";
+import { type PulsarVector } from "./vector.js";
+export declare const OBSERVER_CACHE_SIGNAL_ID = "__observer__";
+export { nowMs } from "./observer-time.js";
+export interface CachedObserverOutput {
+    readonly observer_semantics?: ObserverOutput["observer_semantics"];
+    readonly categories: ObserverOutput["categories"];
+    readonly minimum: ObserverOutput["minimum"];
+    readonly weighted_mean: ObserverOutput["weighted_mean"];
+    readonly readiness?: ObserverOutput["readiness"];
+    readonly hard_gate_status: ObserverOutput["hard_gate_status"];
+    readonly hard_gate_violations: ObserverOutput["hard_gate_violations"];
+    readonly inactiveSignals: ObserverOutput["inactiveSignals"];
+    readonly signalResults: ReadonlyArray<SignalRunResult>;
+    readonly signalMetadata?: ObserverOutput["signalMetadata"];
+    readonly calibration?: ObserverOutput["calibration"];
+}
+export declare const computeObserverConfigHash: (registry: Registry, vector: PulsarVector | undefined, calibrationFingerprint?: string, referenceVersionHash?: string) => string;
+export declare const toCachedObserverOutput: (result: ObserverOutput) => CachedObserverOutput;
+export declare const fromCachedObserverOutput: (cached: CachedObserverOutput) => ObserverOutput;
+export declare const computeReferenceVersionHash: (referenceEntries: ReadonlyMap<string, unknown>) => string;
+export declare const hashChangedHunks: (changedHunks: ReadonlyArray<ChangedHunk>) => string;
+export declare const mergeCachedResultMetadata: (result: SignalRunResult, cached: {
+    readonly status: "hit" | "miss" | "stale";
+    readonly effectiveConfidence?: number;
+    readonly entry?: {
+        readonly tier: number;
+        readonly baseConfidence: number;
+        readonly computedAt: string;
+    };
+}) => SignalRunResult;
+export declare const withRuntimeEnvironmentProfile: (output: ObserverOutput, environmentDurationMs: number) => ObserverOutput;
+//# sourceMappingURL=scoring-engine-observer-cache.d.ts.map

package/dist/scoring-engine-observer-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scoring-engine-observer-cache.d.ts","sourceRoot":"","sources":["../src/scoring-engine-observer-cache.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAC/C,OAAO,EAEL,KAAK,cAAc,EACpB,MAAM,eAAe,CAAA;AAEtB,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAC7C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAElD,OAAO,EAOL,KAAK,YAAY,EAClB,MAAM,aAAa,CAAA;AAEpB,eAAO,MAAM,wBAAwB,iBAAiB,CAAA;AAEtD,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAA;AAE1C,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,cAAc,CAAC,oBAAoB,CAAC,CAAA;IAClE,QAAQ,CAAC,UAAU,EAAE,cAAc,CAAC,YAAY,CAAC,CAAA;IACjD,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC,SAAS,CAAC,CAAA;IAC3C,QAAQ,CAAC,aAAa,EAAE,cAAc,CAAC,eAAe,CAAC,CAAA;IACvD,QAAQ,CAAC,SAAS,CAAC,EAAE,cAAc,CAAC,WAAW,CAAC,CAAA;IAChD,QAAQ,CAAC,gBAAgB,EAAE,cAAc,CAAC,kBAAkB,CAAC,CAAA;IAC7D,QAAQ,CAAC,oBAAoB,EAAE,cAAc,CAAC,sBAAsB,CAAC,CAAA;IACrE,QAAQ,CAAC,eAAe,EAAE,cAAc,CAAC,iBAAiB,CAAC,CAAA;IAC3D,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC,eAAe,CAAC,CAAA;IACtD,QAAQ,CAAC,cAAc,CAAC,EAAE,cAAc,CAAC,gBAAgB,CAAC,CAAA;IAC1D,QAAQ,CAAC,WAAW,CAAC,EAAE,cAAc,CAAC,aAAa,CAAC,CAAA;CACrD;AAKD,eAAO,MAAM,yBAAyB,GACpC,UAAU,QAAQ,EAClB,QAAQ,YAAY,GAAG,SAAS,EAChC,yBAAyB,MAAM,EAC/B,uBAAuB,MAAM,KAC5B,MAqCF,CAAA;AAED,eAAO,MAAM,sBAAsB,GAAI,QAAQ,cAAc,KAAG,oBAY9D,CAAA;AAEF,eAAO,MAAM,wBAAwB,GAAI,QAAQ,oBAAoB,KAAG,cAYtE,CAAA;AAEF,eAAO,MAAM,2BAA2B,GACtC,kBAAkB,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,KAC7C,MAKF,CAAA;AAED,eAAO,MAAM,gBAAgB,GAAI,cAAc,aAAa,CAAC,WAAW,CAAC,KAAG,MAO3E,CAAA;AAED,eAAO,MAAM,yBAAyB,GACpC,QAAQ,eAAe,EACvB,QAAQ;IACN,QAAQ,CAAC,MAAM,EAAE,KAAK,GAAG,MAAM,GAAG,OAAO,CAAA;IACzC,QAAQ,CAAC,mBAAmB,CAAC,EAAE,MAAM,CAAA;IACrC,QAAQ,CAAC,KAAK,CAAC,EAAE;QACf,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;QACrB,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAA;QAC/B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;KAC5B,CAAA;CACF,KACA,eAmBF,CAAA;AAED,eAAO,MAAM,6BAA6B,GACxC,QAAQ,cAAc,EACtB,uBAAuB,MAAM,KAC5B,cAkBF,CAAA"}

package/dist/scoring-engine-observer-cache.js

@@ -0,0 +1,115 @@
+import { createHash } from "node:crypto";
+import { OBSERVER_OUTPUT_SEMANTICS, } from "./observer.js";
+import { roundRuntimeMs } from "./observer-time.js";
+import { stableStringify } from "./scoring-engine-contract.js";
+import { categoryAggregationConfigOf, factorOverridesOf, isActive as vectorIsActive, readinessConfigOf, resolvedConfig as vectorResolvedConfig, weightOf as vectorWeightOf, } from "./vector.js";
+export const OBSERVER_CACHE_SIGNAL_ID = "__observer__";
+export { nowMs } from "./observer-time.js";
+const OBSERVER_AGGREGATION_CACHE_VERSION = "observer-aggregation-v4-category-pressure-applicability";
+export const computeObserverConfigHash = (registry, vector, calibrationFingerprint, referenceVersionHash) => {
+    const activeSignals = registry.sorted
+        .filter((signal) => vectorIsActive(signal, vector))
+        .map((signal) => [
+        signal.id,
+        {
+            category: signal.category,
+            config: vectorResolvedConfig(signal, signal.defaultConfig, vector),
+            cacheVersion: signal.cacheVersion ?? null,
+            enforcement: signal.enforcement,
+            factorDefinitions: signal.factorDefinitions ?? [],
+            factorOverrides: factorOverridesOf(signal, vector),
+            kind: signal.kind,
+            normalizationGroup: signal.normalizationGroup ?? null,
+            tier: signal.tier,
+            weight: vectorWeightOf(signal, vector),
+        },
+    ]);
+    const observerConfig = {
+        diffTimeIntegration: vector?.observer?.diffTimeIntegration ?? true,
+        categoryAggregation: categoryAggregationConfigOf(vector),
+        readiness: readinessConfigOf(vector),
+    };
+    const optionalFingerprints = {
+        ...(calibrationFingerprint !== undefined ? { calibrationFingerprint } : {}),
+        ...(referenceVersionHash !== undefined ? { referenceVersionHash } : {}),
+    };
+    return createHash("sha256")
+        .update(stableStringify({
+        activeSignals,
+        ...optionalFingerprints,
+        observerAggregationVersion: OBSERVER_AGGREGATION_CACHE_VERSION,
+        observerConfig,
+    }))
+        .digest("hex");
+};
+export const toCachedObserverOutput = (result) => ({
+    observer_semantics: result.observer_semantics,
+    categories: result.categories,
+    minimum: result.minimum,
+    weighted_mean: result.weighted_mean,
+    ...(result.readiness !== undefined ? { readiness: result.readiness } : {}),
+    hard_gate_status: result.hard_gate_status,
+    hard_gate_violations: result.hard_gate_violations,
+    inactiveSignals: result.inactiveSignals,
+    signalResults: [...result.signalResults.values()],
+    ...(result.signalMetadata !== undefined ? { signalMetadata: result.signalMetadata } : {}),
+    ...(result.calibration !== undefined ? { calibration: result.calibration } : {}),
+});
+export const fromCachedObserverOutput = (cached) => ({
+    observer_semantics: cached.observer_semantics ?? OBSERVER_OUTPUT_SEMANTICS,
+    categories: cached.categories,
+    minimum: cached.minimum,
+    weighted_mean: cached.weighted_mean,
+    ...(cached.readiness !== undefined ? { readiness: cached.readiness } : {}),
+    hard_gate_status: cached.hard_gate_status,
+    hard_gate_violations: cached.hard_gate_violations,
+    inactiveSignals: cached.inactiveSignals,
+    signalResults: new Map(cached.signalResults.map((result) => [result.signalId, result])),
+    ...(cached.signalMetadata !== undefined ? { signalMetadata: cached.signalMetadata } : {}),
+    ...(cached.calibration !== undefined ? { calibration: cached.calibration } : {}),
+});
+export const computeReferenceVersionHash = (referenceEntries) => {
+    const normalized = [...referenceEntries.entries()].sort(([left], [right]) => left.localeCompare(right));
+    return createHash("sha256").update(stableStringify(normalized)).digest("hex");
+};
+export const hashChangedHunks = (changedHunks) => {
+    const normalized = [...changedHunks].sort((left, right) => `${left.file}:${left.oldStart}:${left.newStart}`.localeCompare(`${right.file}:${right.oldStart}:${right.newStart}`));
+    return createHash("sha256").update(stableStringify(normalized)).digest("hex");
+};
+export const mergeCachedResultMetadata = (result, cached) => {
+    if (cached.effectiveConfidence === undefined ||
+        cached.entry === undefined ||
+        cached.entry.tier !== 3) {
+        return result;
+    }
+    return {
+        ...result,
+        metadata: {
+            ...(result.metadata ?? {}),
+            effectiveConfidence: cached.effectiveConfidence,
+            baseConfidence: cached.entry.baseConfidence,
+            computedAt: cached.entry.computedAt,
+            stale: cached.status === "stale",
+        },
+    };
+};
+export const withRuntimeEnvironmentProfile = (output, environmentDurationMs) => {
+    if (output.runtimeProfile === undefined)
+        return output;
+    const totalMs = roundRuntimeMs(environmentDurationMs);
+    const observerMs = output.runtimeProfile.totalMs;
+    const setupMs = roundRuntimeMs(totalMs - observerMs);
+    return {
+        ...output,
+        runtimeProfile: {
+            ...output.runtimeProfile,
+            totalMs,
+            stages: {
+                ...(output.runtimeProfile.stages ?? {}),
+                "environment-setup": { durationMs: setupMs },
+                observer: { durationMs: observerMs },
+            },
+        },
+    };
+};
+//# sourceMappingURL=scoring-engine-observer-cache.js.map

package/dist/scoring-engine-observer-cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scoring-engine-observer-cache.js","sourceRoot":"","sources":["../src/scoring-engine-observer-cache.ts"],"names":[],"mappings":"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"}

package/dist/scoring-engine-runtime.d.ts

@@ -0,0 +1,25 @@
+import { Effect, Layer } from "effect";
+import { SignalCacheTag, type CacheConfig } from "./cache.js";
+import { type ResolvedCalibrationContext } from "./calibration.js";
+import { type ChangedHunk } from "./context.js";
+import type { ScoringEngineError } from "./errors.js";
+import type { PackLayerFactory } from "./scoring-engine-contract.js";
+import type { TimeSeriesWriter } from "./time-series.js";
+export interface ScoringEngineOptions {
+    readonly timeSeriesWriter?: TimeSeriesWriter;
+    readonly cacheConfig?: CacheConfig;
+    readonly observerProfile?: boolean;
+    readonly calibrationContext?: ResolvedCalibrationContext;
+    readonly calibrationContextForWorktree?: (worktreePath: string) => Effect.Effect<ResolvedCalibrationContext | undefined, unknown, never>;
+}
+export interface EngineInternals {
+    readonly cacheRef: typeof SignalCacheTag.Service;
+    readonly resolveCalibrationContext: (worktreePath: string) => Effect.Effect<ResolvedCalibrationContext | undefined, never, never>;
+    readonly makeEnvLayer: (worktreePath: string, sha: string, referenceEntries: ReadonlyMap<string, unknown>, calibrationContext: ResolvedCalibrationContext | undefined, changedHunks?: ReadonlyArray<ChangedHunk>) => Layer.Layer<any, unknown, never>;
+}
+export type RunWithEnvironment = <A, E>(worktreePath: string, sha: string, changedHunks: ReadonlyArray<ChangedHunk>, calibrationContext: ResolvedCalibrationContext | undefined, runInWorktree: (envLayer: Layer.Layer<any, unknown, never>, referenceEntries: ReadonlyMap<string, unknown>) => Effect.Effect<A, E, never>) => Effect.Effect<A, E | ScoringEngineError, never>;
+export type WithCommitWorktree = <A, E>(repoPath: string, sha: string, runInWorktree: (worktreePath: string) => Effect.Effect<A, E, never>) => Effect.Effect<A, E | ScoringEngineError, never>;
+export declare const makeEngineInternals: (packLayerFactory: PackLayerFactory, options?: ScoringEngineOptions) => Effect.Effect<EngineInternals, never, never>;
+export declare const makeRunWithEnvironment: (internals: EngineInternals) => RunWithEnvironment;
+export declare const makeWithCommitWorktree: () => WithCommitWorktree;
+//# sourceMappingURL=scoring-engine-runtime.d.ts.map

package/dist/scoring-engine-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scoring-engine-runtime.d.ts","sourceRoot":"","sources":["../src/scoring-engine-runtime.ts"],"names":[],"mappings":"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"}