waterplane 0.1.6 → 0.1.14

package/node_modules/@waterplane/shared/dist/healthindex/commits.js

@@ -0,0 +1,57 @@
+import { isoWeekOf, centralOf } from "./readings.js";
+import { healthRowScore } from "./score.js";
+/** Thin to ~`max`: each ISO week's LAST point stays; `ceil(n/max)`-long runs keep their min and max index. At most 2*max + weeks. */
+export function thinCommitPoints(points, max) {
+    if (points.length <= max)
+        return [...points];
+    const keep = new Set();
+    const lastOfWeek = new Map();
+    points.forEach((p, i) => lastOfWeek.set(p.week, i));
+    for (const i of lastOfWeek.values())
+        keep.add(i);
+    const run = Math.ceil(points.length / Math.max(1, max));
+    for (let a = 0; a < points.length; a += run) {
+        let lo = a, hi = a;
+        const end = Math.min(points.length, a + run);
+        for (let i = a; i < end; i++) {
+            if (points[i].index < points[lo].index)
+                lo = i;
+            if (points[i].index > points[hi].index)
+                hi = i;
+        }
+        keep.add(lo);
+        keep.add(hi);
+    }
+    return [...keep].sort((x, y) => x - y).map((i) => points[i]);
+}
+/** Every scorable row as a commit point, thinned to about `max`; `null` when no row scores. */
+export function healthIndexCommits(rows, contextWarnChars, max = 240) {
+    const sorted = rows.filter((r) => r && typeof r.ts === "number").sort((a, b) => a.ts - b.ts);
+    const all = [];
+    let prev = null;
+    for (const row of sorted) {
+        const week = isoWeekOf(row.day);
+        const s = week ? healthRowScore(row, contextWarnChars) : null;
+        if (!week || !s)
+            continue;
+        const prereg = typeof row.prereg === "string" ? row.prereg : null;
+        const central = centralOf(row).fp;
+        all.push({
+            sha7: typeof row.sha === "string" ? row.sha.slice(0, 7) : "",
+            day: row.day, ts: row.ts, week, index: s.index, mean: s.mean, cappedBy: s.cappedBy,
+            gap: prev !== null && (prev.prereg !== prereg || prev.central !== central),
+        });
+        prev = { prereg, central };
+    }
+    if (all.length === 0)
+        return null;
+    const points = thinCommitPoints(all, max);
+    return { points, total: all.length, thinned: points.length < all.length };
+}
+/** `absent` = an older host (no key), `none` = the host looked and nothing scores, else `present`. */
+export function healthCommitsAvailability(view) {
+    if (!view || view.commits === undefined)
+        return "absent";
+    return view.commits && view.commits.points.length > 0 ? "present" : "none";
+}
+//# sourceMappingURL=commits.js.map

package/node_modules/@waterplane/shared/dist/healthindex/commits.js.map

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

package/node_modules/@waterplane/shared/dist/healthindex/move.d.ts

@@ -0,0 +1,25 @@
+import { type HealthIndexPoint } from "./types.js";
+export interface HealthMove {
+    kind: "drop" | "rise" | null;
+    horizon: "week" | "month" | null;
+    /** Index points the horizon moved (latest − then); null when there is no comparable move to state. */
+    delta: number | null;
+    reason: string;
+}
+export interface HealthMoveOpts {
+    minWeeks?: number;
+    minMonthWindows?: number;
+    lowPct?: number;
+    highPct?: number;
+    minPoints?: number;
+}
+/**
+ * Whether the latest move is unusual for THIS repo: the week's link against
+ * the distribution of every earlier link, then (only if the week says nothing)
+ * the last four weeks against every earlier rolling four-week change. Both
+ * need the percentile AND a minimum number of points, so a dead-flat series
+ * cannot call a 0.1-point wobble a drop. Under `HEALTH_INDEX_MIN_WEEKS` links
+ * of history there is no distribution to stand on: `kind: null`, with why.
+ */
+export declare function assessHealthMove(points: readonly HealthIndexPoint[], opts?: HealthMoveOpts): HealthMove;
+/** Plain names for an entry's move: [0] when its metric rose (its score fell), [1] when it fell. */

package/node_modules/@waterplane/shared/dist/healthindex/move.js

@@ -0,0 +1,79 @@
+// healthindex/move: The move detector: a drop or rise called only against the series' own past. Barrel: ../healthindex.ts (read the header there).
+import { HEALTH_INDEX_MIN_WEEKS, HEALTH_INDEX_MIN_MONTH_WINDOWS, HEALTH_INDEX_MONTH_WEEKS, HEALTH_INDEX_LOW_PCT, HEALTH_INDEX_HIGH_PCT, HEALTH_INDEX_MIN_POINTS } from "./types.js";
+/** Linear-interpolated percentile (0–100) of a non-empty list. */
+function percentile(xs, p) {
+    const s = [...xs].sort((a, b) => a - b);
+    const pos = (p / 100) * (s.length - 1);
+    const lo = Math.floor(pos);
+    const hi = Math.ceil(pos);
+    return s[lo] + (s[hi] - s[lo]) * (pos - lo);
+}
+/**
+ * Whether the latest move is unusual for THIS repo: the week's link against
+ * the distribution of every earlier link, then (only if the week says nothing)
+ * the last four weeks against every earlier rolling four-week change. Both
+ * need the percentile AND a minimum number of points, so a dead-flat series
+ * cannot call a 0.1-point wobble a drop. Under `HEALTH_INDEX_MIN_WEEKS` links
+ * of history there is no distribution to stand on: `kind: null`, with why.
+ */
+export function assessHealthMove(points, opts = {}) {
+    const minWeeks = opts.minWeeks ?? HEALTH_INDEX_MIN_WEEKS;
+    const minMonth = opts.minMonthWindows ?? HEALTH_INDEX_MIN_MONTH_WINDOWS;
+    const lowPct = opts.lowPct ?? HEALTH_INDEX_LOW_PCT;
+    const highPct = opts.highPct ?? HEALTH_INDEX_HIGH_PCT;
+    const minPts = opts.minPoints ?? HEALTH_INDEX_MIN_POINTS;
+    const none = (reason, horizon = null, delta = null) => ({ kind: null, horizon, delta, reason });
+    const last = points[points.length - 1];
+    if (!last)
+        return none("no index yet");
+    const links = points.filter((p) => p.lnLink !== null);
+    if (links.length < minWeeks) {
+        return none(`${links.length} weekly link${links.length === 1 ? "" : "s"} so far; a move is called after ${minWeeks}`);
+    }
+    // Week: only when the latest point IS a link — a carried week moved nothing.
+    if (last.lnLink !== null) {
+        const prior = links.slice(0, -1).map((p) => p.lnLink);
+        const prevIndex = points[points.length - 2].index;
+        const delta = last.index - prevIndex;
+        if (last.lnLink < percentile(prior, lowPct) && -delta >= minPts) {
+            return { kind: "drop", horizon: "week", delta, reason: `the latest week's link sits below the ${lowPct}th percentile of ${prior.length} earlier weeks` };
+        }
+        if (last.lnLink > percentile(prior, highPct) && delta >= minPts) {
+            return { kind: "rise", horizon: "week", delta, reason: `the latest week's link sits above the ${highPct}th percentile of ${prior.length} earlier weeks` };
+        }
+    }
+    // Month: ln(index_t / index_{t-4}) against every earlier rolling window.
+    const W = HEALTH_INDEX_MONTH_WEEKS;
+    const t = points.length - 1;
+    if (t < W)
+        return none("too few weeks for a four-week reading");
+    // A window that spans a `gap` point compares two scores measured under
+    // different definitions: it is not a move. Skipped as history, and when the
+    // current window is one, no month move is called at all.
+    const spansGap = (j) => {
+        for (let k = j - W + 1; k <= j; k++)
+            if (points[k].gap)
+                return true;
+        return false;
+    };
+    if (spansGap(t))
+        return none("the last four weeks span a change of definition, so there is no month move to compare");
+    const windows = [];
+    for (let j = W; j < t; j++)
+        if (!spansGap(j))
+            windows.push(Math.log(points[j].index / points[j - W].index));
+    const monthDelta = last.index - points[t - W].index;
+    if (windows.length < minMonth) {
+        return none(`${windows.length} earlier four-week window${windows.length === 1 ? "" : "s"}; a month move is called after ${minMonth}`);
+    }
+    const ln = Math.log(last.index / points[t - W].index);
+    if (ln < percentile(windows, lowPct) && -monthDelta >= minPts) {
+        return { kind: "drop", horizon: "month", delta: monthDelta, reason: `the last four weeks sit below the ${lowPct}th percentile of ${windows.length} earlier four-week windows` };
+    }
+    if (ln > percentile(windows, highPct) && monthDelta >= minPts) {
+        return { kind: "rise", horizon: "month", delta: monthDelta, reason: `the last four weeks sit above the ${highPct}th percentile of ${windows.length} earlier four-week windows` };
+    }
+    return none("within this repo's usual range", null, last.lnLink !== null ? last.index - points[t - 1].index : null);
+}
+/** Plain names for an entry's move: [0] when its metric rose (its score fell), [1] when it fell. */
+//# sourceMappingURL=move.js.map

package/node_modules/@waterplane/shared/dist/healthindex/move.js.map

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

package/node_modules/@waterplane/shared/dist/healthindex/readings.d.ts

@@ -0,0 +1,53 @@
+import { type HealthEntry, type HealthSeriesRow } from "./types.js";
+/** `100 · min(1, good / value)`; a value at or under 0 is 100. */
+export declare function healthScore(value: number, good: number): number;
+/** The Monday (UTC) of the ISO week holding `day` (`YYYY-MM-DD`), or null for a malformed day. */
+export declare function isoWeekOf(day: string): string | null;
+/** The last row (greatest `ts`) of each ISO week, oldest week first. */
+export declare function healthWeeks(rows: readonly HealthSeriesRow[]): {
+    week: string;
+    row: HealthSeriesRow;
+}[];
+/** The good line of the context entry for a repo's warn line (null = the default). */
+export declare function healthContextGood(contextWarnChars: number | null): number;
+/** One week's readings: the five values (size's is `lineMean`), plus size's longest file. */
+export interface HealthEntryReadings {
+    values: Partial<Record<HealthEntry, number>>;
+    /** The longest file, read beside `lineMean`; absent where size is. */
+    max?: {
+        value: number;
+        path: string | null;
+    };
+}
+/**
+ * One week's values, raw (no epsilon, no floor — `min(1, good/value)` is
+ * finite for any value ≥ 0); an entry is absent where its reading is.
+ *
+ * - `size` is `lineMean` and needs `max` beside it; either missing ⇒ absent.
+ * - `untested` is a SHARE: `untested.count / classics.files` — the source-file
+ *   count of the same tree, which counts test files too, so the share is a
+ *   floor. A share and not the count, so a repo that grows does not read as
+ *   slipping just for having more modules.
+ * - `hatches` is UNEXPLAINED escapes per kLOC where the row classified them
+ *   (engine 2026-10-16a on); every occurrence on an older row.
+ * - `context` is `claudeMdChars + descChars`; `descChars` null (no counted
+ *   skills) counts as 0 descriptions.
+ */
+export declare function healthEntryReadings(row: HealthSeriesRow): HealthEntryReadings;
+/** The five values alone — `healthEntryReadings(row).values`. The warn line is not read here any more (scores read it). */
+export declare function healthEntryValues(row: HealthSeriesRow, _contextWarnChars?: number | null): Partial<Record<HealthEntry, number>>;
+/**
+ * What the repo applied on this row: its fingerprint and which entries it
+ * disabled or overrode. An entry both disabled and overridden reads disabled
+ * (the engine never writes both; a hand-edited row must not count twice).
+ */
+export declare function centralOf(row: HealthSeriesRow): {
+    fp: string;
+    disabled: HealthEntry[];
+    overridden: HealthEntry[];
+};
+export declare const DAY_MS = 86400000;
+export declare function treeOf(row: HealthSeriesRow): {
+    files: number;
+    loc: number;
+} | null;

package/node_modules/@waterplane/shared/dist/healthindex/readings.js

@@ -0,0 +1,154 @@
+// healthindex/readings: Rows to readings: ISO weeks, the per-entry values, the repo `central` override. Barrel: ../healthindex.ts (read the header there).
+import { HEALTH_ENTRIES, HEALTH_CONTEXT_GOOD_SHARE, HEALTH_INDEX_DEFAULT_WARN_CHARS, HEALTH_NO_CLAUDE_MD } from "./types.js";
+const posFinite = (v) => typeof v === "number" && Number.isFinite(v) && v > 0;
+const nonNegFinite = (v) => typeof v === "number" && Number.isFinite(v) && v >= 0;
+/** `100 · min(1, good / value)`; a value at or under 0 is 100. */
+export function healthScore(value, good) {
+    return value <= 0 ? 100 : 100 * Math.min(1, good / value);
+}
+/** The Monday (UTC) of the ISO week holding `day` (`YYYY-MM-DD`), or null for a malformed day. */
+export function isoWeekOf(day) {
+    if (typeof day !== "string" || !/^\d{4}-\d{2}-\d{2}$/.test(day))
+        return null;
+    const t = Date.parse(`${day}T00:00:00Z`);
+    if (!Number.isFinite(t) || new Date(t).toISOString().slice(0, 10) !== day)
+        return null;
+    const dow = (new Date(t).getUTCDay() + 6) % 7; // Monday = 0
+    return new Date(t - dow * 86_400_000).toISOString().slice(0, 10);
+}
+/** The last row (greatest `ts`) of each ISO week, oldest week first. */
+export function healthWeeks(rows) {
+    const byWeek = new Map();
+    for (const r of rows) {
+        if (!r || typeof r.ts !== "number")
+            continue;
+        const week = isoWeekOf(r.day);
+        if (!week)
+            continue;
+        const prev = byWeek.get(week);
+        if (!prev || r.ts >= prev.ts)
+            byWeek.set(week, r);
+    }
+    return [...byWeek.entries()].sort(([a], [b]) => (a < b ? -1 : a > b ? 1 : 0)).map(([week, row]) => ({ week, row }));
+}
+/** The good line of the context entry for a repo's warn line (null = the default). */
+export function healthContextGood(contextWarnChars) {
+    return HEALTH_CONTEXT_GOOD_SHARE * (posFinite(contextWarnChars) ? contextWarnChars : HEALTH_INDEX_DEFAULT_WARN_CHARS);
+}
+/**
+ * One week's values, raw (no epsilon, no floor — `min(1, good/value)` is
+ * finite for any value ≥ 0); an entry is absent where its reading is.
+ *
+ * - `size` is `lineMean` and needs `max` beside it; either missing ⇒ absent.
+ * - `untested` is a SHARE: `untested.count / classics.files` — the source-file
+ *   count of the same tree, which counts test files too, so the share is a
+ *   floor. A share and not the count, so a repo that grows does not read as
+ *   slipping just for having more modules.
+ * - `hatches` is UNEXPLAINED escapes per kLOC where the row classified them
+ *   (engine 2026-10-16a on); every occurrence on an older row.
+ * - `context` is `claudeMdChars + descChars`; `descChars` null (no counted
+ *   skills) counts as 0 descriptions.
+ */
+export function healthEntryReadings(row) {
+    const values = {};
+    let max;
+    const sz = row.size?.value;
+    // `max` is read on its own: an override REPLACES lineMean and keeps the
+    // engine's max, so it must not depend on the engine's lineMean being there.
+    // Where `max` is absent size is absent on BOTH paths (an override cannot
+    // invent the longest file); where only lineMean is absent, size is absent
+    // without an override and the override's value stands with the engine's max.
+    // A `max` left without a size value is dropped at the end.
+    if (sz && nonNegFinite(sz.max)) {
+        max = { value: sz.max, path: typeof sz.maxPath === "string" && sz.maxPath ? sz.maxPath : null };
+    }
+    if (sz && nonNegFinite(sz.lineMean) && max)
+        values.size = sz.lineMean;
+    const rate = row.retouch?.value?.rate;
+    if (nonNegFinite(rate))
+        values.retouch = rate;
+    const h = row.hatches;
+    const loc = row.classics?.value?.loc;
+    if (h?.value && typeof h.value === "object" && posFinite(loc)) {
+        let total = 0;
+        let ok = true;
+        if (h.split && typeof h.split === "object") {
+            if (nonNegFinite(h.split.unexplained))
+                total = h.split.unexplained;
+            else
+                ok = false;
+        }
+        else {
+            for (const v of Object.values(h.value)) {
+                if (!nonNegFinite(v)) {
+                    ok = false;
+                    break;
+                }
+                total += v;
+            }
+        }
+        if (ok)
+            values.hatches = total / (loc / 1000);
+    }
+    const ctx = row.context?.value;
+    const md = ctx?.claudeMdChars;
+    const desc = ctx?.descChars;
+    // No CLAUDE.md is nothing the repo loads every turn: 0, on the engine's exact words (its skills go unmeasured then).
+    if (!ctx && row.context?.reason === HEALTH_NO_CLAUDE_MD)
+        values.context = 0;
+    else if (nonNegFinite(md) && (desc === null || desc === undefined || nonNegFinite(desc)))
+        values.context = md + (typeof desc === "number" ? desc : 0);
+    const list = row.untested?.value;
+    const files = row.classics?.value?.files;
+    if (Array.isArray(list) && posFinite(files) && list.length <= files) {
+        values.untested = list.length / files;
+    }
+    // The repo's own say (`central`): a disabled entry is not in the basket at
+    // all; an override REPLACES the engine's value (for size, `lineMean` — the
+    // longest file stays measured), and a failed override is absent — never the
+    // engine's number standing in for the repo's.
+    const c = centralOf(row);
+    for (const e of c.disabled) {
+        delete values[e];
+        if (e === "size")
+            max = undefined;
+    }
+    for (const e of c.overridden) {
+        delete values[e];
+        const v = row.central?.override?.[e]?.value;
+        if (!nonNegFinite(v))
+            continue;
+        if (e === "size" && !max)
+            continue;
+        values[e] = v;
+    }
+    if (values.size === undefined)
+        max = undefined;
+    return max ? { values, max } : { values };
+}
+/** The five values alone — `healthEntryReadings(row).values`. The warn line is not read here any more (scores read it). */
+export function healthEntryValues(row, _contextWarnChars) {
+    return healthEntryReadings(row).values;
+}
+const isEntry = (k) => HEALTH_ENTRIES.includes(k);
+/**
+ * What the repo applied on this row: its fingerprint and which entries it
+ * disabled or overrode. An entry both disabled and overridden reads disabled
+ * (the engine never writes both; a hand-edited row must not count twice).
+ */
+export function centralOf(row) {
+    const c = row.central;
+    if (!c || typeof c !== "object")
+        return { fp: "", disabled: [], overridden: [] };
+    const fp = typeof c.fp === "string" ? c.fp : "";
+    const keysOf = (o) => o && typeof o === "object" ? Object.keys(o).filter(isEntry) : [];
+    const disabled = HEALTH_ENTRIES.filter((e) => keysOf(c.disabled).includes(e));
+    const overridden = HEALTH_ENTRIES.filter((e) => keysOf(c.override).includes(e) && !disabled.includes(e));
+    return { fp, disabled, overridden };
+}
+export const DAY_MS = 86_400_000;
+export function treeOf(row) {
+    const v = row.classics?.value;
+    return v && nonNegFinite(v.files) && nonNegFinite(v.loc) ? { files: v.files, loc: v.loc } : null;
+}
+//# sourceMappingURL=readings.js.map

package/node_modules/@waterplane/shared/dist/healthindex/readings.js.map

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

package/node_modules/@waterplane/shared/dist/healthindex/repoindex.d.ts

@@ -0,0 +1,41 @@
+import { type HealthEntry, type HealthIndexSeries } from "./types.js";
+import { type HealthCommitSeries } from "./commits.js";
+import { type HealthMove } from "./move.js";
+import { type HealthWords } from "./words.js";
+export interface RepoHealthIndex {
+    /** The latest headline score, 0–100. */
+    value: number;
+    /** The latest week's move in score points; null on a gap week or the first scored week. */
+    deltaWeek: number | null;
+    /** The latest week's Monday. */
+    week: string;
+    move: "drop" | "rise" | null;
+    /** The mean before the cap, so `healthCapWords` can be said from this summary alone. */
+    mean?: number;
+    /** The entry holding the score down when the cap set it, else null. */
+    cappedBy?: HealthEntry | null;
+    /** The worst alert level on the latest week; null when nothing is under the warn line. */
+    alert?: "warn" | "severe" | null;
+    /** That worst alert's sentence; null with it. */
+    alertText?: string | null;
+}
+/** The wire summary for one repo, or null where there is no index (the field stays ABSENT, never 0). */
+export declare function repoHealthIndexOf(series: HealthIndexSeries | null, move?: HealthMove | null): RepoHealthIndex | null;
+/**
+ * `GET /api/repos/:id/healthindex` — the whole scored series for the phone's
+ * chart (the latest point carries the alerts and `cappedBy`), the called move
+ * and its words. `series: null` + `reason` when there is no series file or no
+ * scored week yet; never a made-up number.
+ */
+export interface HealthIndexResponse {
+    series: HealthIndexSeries | null;
+    move: HealthMove | null;
+    words: HealthWords | null;
+    /** ISO time of the last weekly refresh this host ran for the repo, if any. */
+    lastRefresh: string | null;
+    reason?: string;
+    /** Context per request by ISO week (`healthspend.ts`); absent with no ledger (older host; VS Code before its first log scan). */
+    spend?: import("../healthspend.js").HealthSpendWeek[];
+    /** Scored commits, thinned. ABSENT only on an older host; null = no row scores (or no series). */
+    commits?: HealthCommitSeries | null;
+}

package/node_modules/@waterplane/shared/dist/healthindex/repoindex.js

@@ -0,0 +1,19 @@
+/** The wire summary for one repo, or null where there is no index (the field stays ABSENT, never 0). */
+export function repoHealthIndexOf(series, move) {
+    const pts = series?.points;
+    const last = pts?.[pts.length - 1];
+    if (!pts || !last)
+        return null;
+    const prev = pts[pts.length - 2];
+    return {
+        value: last.index,
+        deltaWeek: last.lnLink !== null && prev ? last.index - prev.index : null,
+        week: last.week,
+        move: move?.kind ?? null,
+        mean: last.mean,
+        cappedBy: last.cappedBy,
+        alert: last.alerts[0]?.level ?? null,
+        alertText: last.alerts[0]?.text ?? null,
+    };
+}
+//# sourceMappingURL=repoindex.js.map

package/node_modules/@waterplane/shared/dist/healthindex/repoindex.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"repoindex.js","sourceRoot":"","sources":["../../src/healthindex/repoindex.ts"],"names":[],"mappings":"AA2BA,wGAAwG;AACxG,MAAM,UAAU,iBAAiB,CAAC,MAAgC,EAAE,IAAwB;IAC1F,MAAM,GAAG,GAAG,MAAM,EAAE,MAAM,CAAC;IAC3B,MAAM,IAAI,GAAG,GAAG,EAAE,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACnC,IAAI,CAAC,GAAG,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAC;IAC/B,MAAM,IAAI,GAAG,GAAG,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACjC,OAAO;QACL,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,SAAS,EAAE,IAAI,CAAC,MAAM,KAAK,IAAI,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI;QACxE,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,IAAI,EAAE,IAAI,EAAE,IAAI,IAAI,IAAI;QACxB,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,IAAI,IAAI;QACpC,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,IAAI,IAAI,IAAI;KACxC,CAAC;AACJ,CAAC"}

package/node_modules/@waterplane/shared/dist/healthindex/score.d.ts

@@ -0,0 +1,26 @@
+import { type HealthEntry, type HealthSeriesRow, type HealthIndexSeries } from "./types.js";
+/** Plain names for an entry, as the cap sentence names it. */
+export declare const HEALTH_ENTRY_LABEL: Record<HealthEntry, string>;
+/**
+ * The cap, said once: `null` when the cap did not set the number. The worst
+ * entry's score is derived (`value − HEALTH_SCORE_CAP_GAP`), so the wire
+ * summary can be worded from its three fields alone.
+ */
+export declare function healthCapWords(s: {
+    value: number;
+    mean: number;
+    cappedBy: HealthEntry | null;
+}): string | null;
+/**
+ * The scored series. `null` when no week has every enabled entry — no score
+ * is no series, never a number nobody measured.
+ */
+export declare function healthIndex(rows: readonly HealthSeriesRow[], contextWarnChars: number | null): HealthIndexSeries | null;
+/** One row by the SAME formula a week uses (`scoreWeek`); null when an enabled entry is absent. */
+export declare function healthRowScore(row: HealthSeriesRow, contextWarnChars: number | null): {
+    index: number;
+    mean: number;
+    scores: Partial<Record<HealthEntry, number>>;
+    cappedBy: HealthEntry | null;
+} | null;
+/** One scored commit (a series row) for the phone's commits axis. No lnLink, contributions or move. */