harnessgap 0.1.0

package/dist/cli.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,25 @@
+import type { Config } from './types.js';
+/**
+ * Typed error for config problems. Carries a clean human-readable message only;
+ * the CLI is responsible for printing the message without leaking the stack.
+ */
+export declare class ConfigError extends Error {
+    constructor(message: string);
+}
+/**
+ * The exact §7 defaults. Later tasks depend on these values verbatim.
+ */
+export declare const DEFAULT_CONFIG: Config;
+/**
+ * Parse a duration string like "30d" / "12h" / "5m" / "10s" into milliseconds.
+ * `undefined` and empty string mean "no window" and return `Infinity`.
+ * Throws `ConfigError` on unparseable input.
+ */
+export declare function parseDuration(s: string | undefined): number;
+/**
+ * Load and validate a config. With no `path`, looks for `.harnessgap.yml` in
+ * the cwd; if absent, returns `DEFAULT_CONFIG`. Deep-merges the file over the
+ * defaults (arrays replace). Throws `ConfigError` on: unreadable file, YAML
+ * parse error, unknown top-level keys, or out-of-range numeric fields.
+ */
+export declare function loadConfig(path?: string): Config;

package/dist/config.js

@@ -0,0 +1,191 @@
+import { readFileSync } from 'node:fs';
+import { resolve } from 'node:path';
+import { parse } from 'yaml';
+/**
+ * Typed error for config problems. Carries a clean human-readable message only;
+ * the CLI is responsible for printing the message without leaking the stack.
+ */
+export class ConfigError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'ConfigError';
+    }
+}
+/**
+ * The exact §7 defaults. Later tasks depend on these values verbatim.
+ */
+export const DEFAULT_CONFIG = {
+    detector: {
+        thresholds_as: 'percentile',
+        flag_pct: 90,
+        bootstrap_session_floor: 30,
+        bootstrap_flag_pct: 70,
+        reread_threshold: 5,
+        correction_window_ms: 120000,
+        signal_weights: {
+            explore_ratio: 1,
+            reread: 1,
+            failure_streak: 1,
+            corrections: 1,
+            abandonment: 0.5,
+            oscillation: 1.2,
+            wall_clock_per_line: 1,
+        },
+        bootstrap_thresholds: {
+            explore_ratio: 10,
+            reread: 5,
+            failure_streak: 3,
+            corrections: 2,
+            abandonment: true,
+            oscillation: 2,
+            wall_clock_per_line_ms: 300000,
+        },
+    },
+    areas: {
+        ignore: ['node_modules', 'build', 'target', 'dist', '.git', '.next', 'vendor'],
+        min_weight: 0.4,
+        min_depth: 2,
+        touch_weights: { edit: 3, read: 2, exec: 1 },
+        tail_fraction: 0.25,
+        explore_ratio_min: 0.8,
+        suppress_abandonment_when_no_exec: true,
+        test_cmd_patterns: [
+            'test',
+            'spec',
+            'pytest',
+            'npm test',
+            'npm run test',
+            'make',
+            'cargo test',
+            'go test',
+            'jest',
+            'vitest',
+        ],
+    },
+};
+const DURATION_RE = /^(\d+)([dhms])$/;
+/**
+ * Parse a duration string like "30d" / "12h" / "5m" / "10s" into milliseconds.
+ * `undefined` and empty string mean "no window" and return `Infinity`.
+ * Throws `ConfigError` on unparseable input.
+ */
+export function parseDuration(s) {
+    if (s === undefined || s === '')
+        return Infinity;
+    const m = DURATION_RE.exec(s);
+    if (!m)
+        throw new ConfigError(`Invalid duration: ${JSON.stringify(s)}`);
+    const n = Number(m[1]);
+    switch (m[2]) {
+        case 'd':
+            return n * 24 * 60 * 60 * 1000;
+        case 'h':
+            return n * 60 * 60 * 1000;
+        case 'm':
+            return n * 60 * 1000;
+        case 's':
+            return n * 1000;
+        default:
+            // Unreachable: regex guarantees one of d/h/m/s.
+            throw new ConfigError(`Invalid duration: ${JSON.stringify(s)}`);
+    }
+}
+const KNOWN_TOP_KEYS = new Set(['detector', 'areas']);
+function isPlainObject(v) {
+    return typeof v === 'object' && v !== null && !Array.isArray(v);
+}
+function isEnoent(e) {
+    return (typeof e === 'object' &&
+        e !== null &&
+        'code' in e &&
+        e.code === 'ENOENT');
+}
+/**
+ * Deep-merge `override` over `base`. Objects merge recursively; arrays and
+ * primitives replace (arrays do NOT concatenate).
+ */
+function deepMerge(base, override) {
+    if (!isPlainObject(override)) {
+        return override;
+    }
+    if (!isPlainObject(base)) {
+        return { ...override };
+    }
+    const result = { ...base };
+    for (const [k, v] of Object.entries(override)) {
+        if (k in base && isPlainObject(base[k]) && isPlainObject(v)) {
+            result[k] = deepMerge(base[k], v);
+        }
+        else {
+            result[k] = v;
+        }
+    }
+    return result;
+}
+function validateConfig(cfg) {
+    const d = cfg.detector;
+    if (d.flag_pct < 0 || d.flag_pct > 100) {
+        throw new ConfigError(`detector.flag_pct must be in [0,100], got ${d.flag_pct}`);
+    }
+    if (d.bootstrap_session_floor < 1) {
+        throw new ConfigError(`detector.bootstrap_session_floor must be >= 1, got ${d.bootstrap_session_floor}`);
+    }
+    for (const [k, v] of Object.entries(d.signal_weights)) {
+        if (v < 0) {
+            throw new ConfigError(`detector.signal_weights.${k} must be >= 0, got ${v}`);
+        }
+    }
+    const tw = cfg.areas.touch_weights;
+    for (const [k, v] of Object.entries(tw)) {
+        if (v < 0) {
+            throw new ConfigError(`areas.touch_weights.${k} must be >= 0, got ${v}`);
+        }
+    }
+    const mw = cfg.areas.min_weight;
+    if (mw < 0 || mw > 1) {
+        throw new ConfigError(`areas.min_weight must be in [0,1], got ${mw}`);
+    }
+}
+/**
+ * Load and validate a config. With no `path`, looks for `.harnessgap.yml` in
+ * the cwd; if absent, returns `DEFAULT_CONFIG`. Deep-merges the file over the
+ * defaults (arrays replace). Throws `ConfigError` on: unreadable file, YAML
+ * parse error, unknown top-level keys, or out-of-range numeric fields.
+ */
+export function loadConfig(path) {
+    const target = path ?? resolve('.harnessgap.yml');
+    let raw;
+    try {
+        raw = readFileSync(target, 'utf8');
+    }
+    catch (e) {
+        // No path given and default file absent -> fail-open with defaults.
+        if (path === undefined && isEnoent(e)) {
+            return structuredClone(DEFAULT_CONFIG);
+        }
+        throw new ConfigError(`Cannot read config file: ${path ?? '.harnessgap.yml'}`);
+    }
+    let parsed;
+    try {
+        parsed = parse(raw);
+    }
+    catch (e) {
+        throw new ConfigError(`YAML parse error in ${path ?? '.harnessgap.yml'}: ${e.message}`);
+    }
+    // Empty file -> nothing to override -> defaults.
+    if (parsed === null || parsed === undefined) {
+        return structuredClone(DEFAULT_CONFIG);
+    }
+    if (!isPlainObject(parsed)) {
+        throw new ConfigError('Config must be a YAML object at the top level');
+    }
+    for (const k of Object.keys(parsed)) {
+        if (!KNOWN_TOP_KEYS.has(k)) {
+            throw new ConfigError(`Unknown config key: ${k}`);
+        }
+    }
+    const merged = deepMerge(DEFAULT_CONFIG, parsed);
+    validateConfig(merged);
+    return structuredClone(merged);
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/detector/areas.d.ts

@@ -0,0 +1,13 @@
+import type { Config, NormalizedEvent } from '../types.js';
+interface Area {
+    key: string;
+    weight: number;
+}
+/**
+ * Localize the areas touched by a session. See task-12 brief for the 5-step
+ * algorithm. Returns the deepest qualifying directories (repo-relative,
+ * forward-slash paths), each with `weight` = dir weight / total touch-weight in
+ * [0,1]. Returns `[]` when no directory qualifies (session is unlocalized).
+ */
+export declare function localizeAreas(events: NormalizedEvent[], cfg: Config): Area[];
+export {};

package/dist/detector/areas.js

@@ -0,0 +1,95 @@
+// Pure area localization: clusters a session's touched files into path-prefix
+// areas using touch-weights, rolls up to ancestor directories, and returns the
+// deepest qualifying directories (each capturing >= min_weight of the session's
+// total touch-weight, at depth >= min_depth). No I/O, no mutation of inputs.
+/**
+ * Localize the areas touched by a session. See task-12 brief for the 5-step
+ * algorithm. Returns the deepest qualifying directories (repo-relative,
+ * forward-slash paths), each with `weight` = dir weight / total touch-weight in
+ * [0,1]. Returns `[]` when no directory qualifies (session is unlocalized).
+ */
+export function localizeAreas(events, cfg) {
+    const tw = cfg.areas.touch_weights;
+    const ignore = new Set(cfg.areas.ignore);
+    // Step 1: accumulate touch-weight per non-ignored file. Ignored paths
+    // (first segment in cfg.areas.ignore) contribute 0 weight — to files AND
+    // to the session total.
+    const fileWeights = new Map();
+    let total = 0;
+    for (const e of events) {
+        const w = touchWeight(e.tool, tw);
+        if (w === 0)
+            continue;
+        for (const f of e.input_digest.files) {
+            if (isIgnored(f, ignore))
+                continue;
+            fileWeights.set(f, (fileWeights.get(f) ?? 0) + w);
+            total += w;
+        }
+    }
+    if (total === 0)
+        return [];
+    // Step 2: roll up to ancestor directories. Each ancestor dir's weight = sum
+    // of weights of all files beneath it (transitively). For a file with segments
+    // [s0, s1, ..., sN], the ancestor dirs are s0, s0/s1, ..., s0/.../s(N-1).
+    const dirWeights = new Map();
+    for (const [file, w] of fileWeights) {
+        const segs = file.split('/');
+        for (let i = 1; i < segs.length; i++) {
+            const dir = segs.slice(0, i).join('/');
+            dirWeights.set(dir, (dirWeights.get(dir) ?? 0) + w);
+        }
+    }
+    // Step 3: candidates = dirs at depth >= min_depth capturing >= min_weight of
+    // total. Depth = number of `/`-separated segments from repo root.
+    const minWeight = cfg.areas.min_weight;
+    const minDepth = cfg.areas.min_depth;
+    const candidates = [];
+    for (const [dir, w] of dirWeights) {
+        if (dir.split('/').length < minDepth)
+            continue;
+        const fraction = w / total;
+        if (fraction < minWeight)
+            continue;
+        candidates.push({ key: dir, weight: fraction });
+    }
+    if (candidates.length === 0)
+        return [];
+    // Step 4: deepest pruning — drop any candidate that has a qualifying
+    // descendant. A descendant of D is any other candidate whose key starts with
+    // `D + '/'`. Siblings (no ancestor relationship) are both kept.
+    const result = [];
+    for (const c of candidates) {
+        const prefix = c.key + '/';
+        let hasDescendant = false;
+        for (const other of candidates) {
+            if (other.key !== c.key && other.key.startsWith(prefix)) {
+                hasDescendant = true;
+                break;
+            }
+        }
+        if (!hasDescendant)
+            result.push(c);
+    }
+    result.sort((a, b) => a.key.localeCompare(b.key));
+    return result;
+}
+/** Touch-weight for a tool kind: edit→3, read→2, exec→1; null/other→0. */
+function touchWeight(tool, tw) {
+    switch (tool) {
+        case 'edit':
+            return tw.edit;
+        case 'read':
+            return tw.read;
+        case 'exec':
+            return tw.exec;
+        default:
+            return 0;
+    }
+}
+/** True when the path's first `/`-separated segment is in the ignore set. */
+function isIgnored(path, ignore) {
+    const first = path.split('/', 1)[0] ?? '';
+    return ignore.has(first);
+}
+//# sourceMappingURL=areas.js.map

package/dist/detector/areas.js.map

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

package/dist/detector/index.d.ts

@@ -0,0 +1,14 @@
+import type { Config, NormalizedEnvelope, StruggleRecord } from '../types.js';
+/**
+ * Run the full detector pipeline over a batch of envelopes.
+ *
+ * 1. Compute signals per envelope (collect the full `SignalValues[]`).
+ * 2. Call `scoreSessions` ONCE with the full array (percentile needs the whole
+ *    set to rank sessions against each other).
+ * 3. Per envelope: compute areas and assemble the `StruggleRecord`.
+ *
+ * Returns records in envelope order. The chosen `mode` is consistent across all
+ * records (`scoreSessions` picks one mode for the whole set); read it from any
+ * record's `mode` field. Empty envelopes → `[]` (no throw).
+ */
+export declare function runDetector(envelopes: NormalizedEnvelope[], cfg: Config, forceBootstrap: boolean): StruggleRecord[];

package/dist/detector/index.js

@@ -0,0 +1,31 @@
+// Detector orchestration: ties signals + scoring + areas together into one
+// StruggleRecord per envelope. Pure: no I/O, no mutation of inputs.
+//
+// Orchestration order matters: percentile scoring needs the FULL signals set,
+// so signals are computed for every envelope first, then `scoreSessions` is
+// called ONCE with the whole array, then per-envelope areas + assembly run.
+import { computeSignals } from './signals.js';
+import { scoreSessions } from './scoring.js';
+import { localizeAreas } from './areas.js';
+import { assembleStruggleRecord } from './record.js';
+/**
+ * Run the full detector pipeline over a batch of envelopes.
+ *
+ * 1. Compute signals per envelope (collect the full `SignalValues[]`).
+ * 2. Call `scoreSessions` ONCE with the full array (percentile needs the whole
+ *    set to rank sessions against each other).
+ * 3. Per envelope: compute areas and assemble the `StruggleRecord`.
+ *
+ * Returns records in envelope order. The chosen `mode` is consistent across all
+ * records (`scoreSessions` picks one mode for the whole set); read it from any
+ * record's `mode` field. Empty envelopes → `[]` (no throw).
+ */
+export function runDetector(envelopes, cfg, forceBootstrap) {
+    const signals = envelopes.map((e) => computeSignals(e.events, cfg));
+    const scores = scoreSessions({ signals, cfg, forceBootstrap });
+    return envelopes.map((env, i) => {
+        const areas = localizeAreas(env.events, cfg);
+        return assembleStruggleRecord(env, signals[i], scores[i], areas);
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/detector/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/detector/index.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,oEAAoE;AACpE,EAAE;AACF,8EAA8E;AAC9E,4EAA4E;AAC5E,4EAA4E;AAG5E,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAErD;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,WAAW,CACzB,SAA+B,EAC/B,GAAW,EACX,cAAuB;IAEvB,MAAM,OAAO,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,cAAc,CAAC,CAAC,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC;IACpE,MAAM,MAAM,GAAG,aAAa,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,cAAc,EAAE,CAAC,CAAC;IAE/D,OAAO,SAAS,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE;QAC9B,MAAM,KAAK,GAAG,aAAa,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QAC7C,OAAO,sBAAsB,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;IACnE,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/detector/record.d.ts

@@ -0,0 +1,24 @@
+import type { NormalizedEnvelope, ScoringMode, SignalValues, StruggleRecord } from '../types.js';
+/** Score shape produced by `scoreSessions` (composite accepted, not stored). */
+interface SessionScore {
+    score_pct: number;
+    mode: ScoringMode;
+    flagged: boolean;
+    composite: number;
+}
+/** Area shape produced by `localizeAreas`. */
+interface Area {
+    key: string;
+    weight: number;
+}
+/**
+ * Assemble a `StruggleRecord` by pure projection.
+ *
+ * - `signals`: raw `SignalValues` as-is (including nulls/booleans/raw counts).
+ * - `score_pct`/`mode`/`flagged`: from `score` (composite is NOT stored).
+ * - `truncated`/`event_count`/`started_at`/`duration_ms`/`session_id`/`repo`:
+ *   from `envelope`.
+ * - `areas`: from the `areas` arg.
+ */
+export declare function assembleStruggleRecord(envelope: NormalizedEnvelope, signals: SignalValues, score: SessionScore, areas: Area[]): StruggleRecord;
+export {};

package/dist/detector/record.js

@@ -0,0 +1,29 @@
+// Pure struggle-record projection. Assembles a StruggleRecord from its inputs
+// without transformation: `signals` stored as-is (raw, including nulls/booleans);
+// envelope fields copied verbatim; score fields projected (composite dropped —
+// not on StruggleRecord). No I/O, no mutation of inputs.
+/**
+ * Assemble a `StruggleRecord` by pure projection.
+ *
+ * - `signals`: raw `SignalValues` as-is (including nulls/booleans/raw counts).
+ * - `score_pct`/`mode`/`flagged`: from `score` (composite is NOT stored).
+ * - `truncated`/`event_count`/`started_at`/`duration_ms`/`session_id`/`repo`:
+ *   from `envelope`.
+ * - `areas`: from the `areas` arg.
+ */
+export function assembleStruggleRecord(envelope, signals, score, areas) {
+    return {
+        session_id: envelope.session_id,
+        repo: envelope.repo,
+        started_at: envelope.started_at,
+        duration_ms: envelope.duration_ms,
+        score_pct: score.score_pct,
+        mode: score.mode,
+        flagged: score.flagged,
+        truncated: envelope.truncated,
+        event_count: envelope.event_count,
+        areas,
+        signals,
+    };
+}
+//# sourceMappingURL=record.js.map

package/dist/detector/record.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"record.js","sourceRoot":"","sources":["../../src/detector/record.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,kFAAkF;AAClF,+EAA+E;AAC/E,yDAAyD;AAuBzD;;;;;;;;GAQG;AACH,MAAM,UAAU,sBAAsB,CACpC,QAA4B,EAC5B,OAAqB,EACrB,KAAmB,EACnB,KAAa;IAEb,OAAO;QACL,UAAU,EAAE,QAAQ,CAAC,UAAU;QAC/B,IAAI,EAAE,QAAQ,CAAC,IAAI;QACnB,UAAU,EAAE,QAAQ,CAAC,UAAU;QAC/B,WAAW,EAAE,QAAQ,CAAC,WAAW;QACjC,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,SAAS,EAAE,QAAQ,CAAC,SAAS;QAC7B,WAAW,EAAE,QAAQ,CAAC,WAAW;QACjC,KAAK;QACL,OAAO;KACR,CAAC;AACJ,CAAC"}

package/dist/detector/scoring.d.ts

@@ -0,0 +1,21 @@
+import type { Config, ScoringMode, SignalValues } from '../types.js';
+interface SessionScore {
+    score_pct: number;
+    mode: ScoringMode;
+    flagged: boolean;
+    composite: number;
+}
+/**
+ * Score a batch of sessions. Pure: no I/O, no mutation of inputs. Returns one
+ * result per session, in input order.
+ *
+ * Mode precedence: `forceBootstrap` → bootstrap; else
+ * `thresholds_as === "absolute"` → bootstrap; else
+ * `signals.length < bootstrap_session_floor` → bootstrap; else percentile.
+ */
+export declare function scoreSessions(input: {
+    signals: SignalValues[];
+    cfg: Config;
+    forceBootstrap: boolean;
+}): SessionScore[];
+export {};

package/dist/detector/scoring.js

@@ -0,0 +1,140 @@
+// Pure scorer: percentile-of-composites and bootstrap modes. No I/O, no mutation.
+// The seven signals, mapped from their `SignalValues` field to the (differently
+// named) weight and threshold keys. Only `explore_ratio` and
+// `wall_clock_per_line_ms` are nullable.
+const SIGNAL_SPECS = [
+    { field: 'explore_ratio', weightKey: 'explore_ratio', thresholdKey: 'explore_ratio', boolean: false },
+    { field: 'reread', weightKey: 'reread', thresholdKey: 'reread', boolean: false },
+    { field: 'failure_streak', weightKey: 'failure_streak', thresholdKey: 'failure_streak', boolean: false },
+    { field: 'corrections', weightKey: 'corrections', thresholdKey: 'corrections', boolean: false },
+    { field: 'abandonment', weightKey: 'abandonment', thresholdKey: 'abandonment', boolean: true },
+    { field: 'oscillation', weightKey: 'oscillation', thresholdKey: 'oscillation', boolean: false },
+    { field: 'wall_clock_per_line_ms', weightKey: 'wall_clock_per_line', thresholdKey: 'wall_clock_per_line_ms', boolean: false },
+];
+/**
+ * Score a batch of sessions. Pure: no I/O, no mutation of inputs. Returns one
+ * result per session, in input order.
+ *
+ * Mode precedence: `forceBootstrap` → bootstrap; else
+ * `thresholds_as === "absolute"` → bootstrap; else
+ * `signals.length < bootstrap_session_floor` → bootstrap; else percentile.
+ */
+export function scoreSessions(input) {
+    const { signals, cfg, forceBootstrap } = input;
+    const mode = selectMode(signals.length, cfg, forceBootstrap);
+    if (mode === 'bootstrap') {
+        return signals.map((s) => bootstrapScore(s, cfg));
+    }
+    return percentileModeScore(signals, cfg);
+}
+function selectMode(n, cfg, forceBootstrap) {
+    if (forceBootstrap)
+        return 'bootstrap';
+    if (cfg.detector.thresholds_as === 'absolute')
+        return 'bootstrap';
+    if (n < cfg.detector.bootstrap_session_floor)
+        return 'bootstrap';
+    return 'percentile';
+}
+/**
+ * Percentile rank of the value at `index` within `values`:
+ * `(count strictly less than v) / (n−1) * 100` when n>1, else 0.
+ * Tied values each get `(count strictly less) / (n−1) * 100`.
+ */
+function percentileRank(values, index) {
+    const n = values.length;
+    if (n <= 1)
+        return 0;
+    const v = values[index];
+    let less = 0;
+    for (let i = 0; i < n; i++) {
+        if (values[i] < v)
+            less += 1;
+    }
+    return (less / (n - 1)) * 100;
+}
+function percentileModeScore(signals, cfg) {
+    const n = signals.length;
+    const weights = cfg.detector.signal_weights;
+    // Per-session percentile rank for each numeric signal. Nullable signals are
+    // ranked only among sessions with non-null values; null sessions get no rank
+    // entry and are excluded from that signal's composite contribution.
+    const ranks = signals.map(() => ({}));
+    for (const spec of SIGNAL_SPECS) {
+        if (spec.boolean)
+            continue; // abandonment contributes 0/100 directly
+        const indices = [];
+        const values = [];
+        for (let i = 0; i < n; i++) {
+            const v = signals[i][spec.field];
+            if (v === null)
+                continue;
+            indices.push(i);
+            values.push(v);
+        }
+        const m = values.length;
+        if (m === 0)
+            continue; // all null — no contribution from this signal
+        for (let j = 0; j < m; j++) {
+            ranks[indices[j]][spec.weightKey] = percentileRank(values, j);
+        }
+    }
+    const composites = signals.map((s, i) => {
+        let weightSum = 0;
+        let weighted = 0;
+        for (const spec of SIGNAL_SPECS) {
+            const v = s[spec.field];
+            if (v === null)
+                continue;
+            const w = weights[spec.weightKey];
+            weightSum += w;
+            const contribution = spec.boolean ? (v ? 100 : 0) : (ranks[i][spec.weightKey] ?? 0);
+            weighted += contribution * w;
+        }
+        // Guard: if every weighted signal is null/absent, composite is 0.
+        if (weightSum === 0)
+            return 0;
+        return weighted / weightSum;
+    });
+    return composites.map((composite, i) => {
+        const scorePct = percentileRank(composites, i);
+        return {
+            score_pct: scorePct,
+            mode: 'percentile',
+            flagged: scorePct >= cfg.detector.flag_pct,
+            composite,
+        };
+    });
+}
+function bootstrapScore(s, cfg) {
+    const weights = cfg.detector.signal_weights;
+    const thresholds = cfg.detector.bootstrap_thresholds;
+    let weightSum = 0;
+    let weighted = 0;
+    let trippedCount = 0;
+    for (const spec of SIGNAL_SPECS) {
+        const v = s[spec.field];
+        if (v === null)
+            continue; // null signals neither trip nor count toward weights
+        const w = weights[spec.weightKey];
+        weightSum += w;
+        const threshold = thresholds[spec.thresholdKey];
+        const tripped = spec.boolean
+            ? v === true && threshold === true
+            : v >= threshold;
+        if (tripped) {
+            trippedCount += 1;
+            // composite is on a 0–100 scale: tripped contributes 100 × weight.
+            weighted += 100 * w;
+        }
+    }
+    const composite = weightSum === 0 ? 0 : weighted / weightSum;
+    const flagged = composite >= cfg.detector.bootstrap_flag_pct || trippedCount >= 2;
+    return {
+        score_pct: composite,
+        mode: 'bootstrap',
+        flagged,
+        composite,
+    };
+}
+//# sourceMappingURL=scoring.js.map

package/dist/detector/scoring.js.map

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

package/dist/detector/signals.d.ts

@@ -0,0 +1,6 @@
+import type { Config, NormalizedEvent, SignalValues } from '../types.js';
+/**
+ * Compute all detector signals for a normalized event stream. Pure: no I/O,
+ * no mutation of inputs. See field contracts in `types.ts` / the design spec.
+ */
+export declare function computeSignals(events: NormalizedEvent[], cfg: Config): SignalValues;