waterplane 0.0.1 → 0.1.11

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

@@ -0,0 +1,154 @@
+// healthindex/score: The absolute score: per-entry scores, alerts, the capped headline, the weekly series. Barrel: ../healthindex.ts (read the header there).
+import { HEALTH_ENTRIES, HEALTH_GOOD, HEALTH_SCORE_CAP_GAP, HEALTH_ALERT_WARN, HEALTH_ALERT_SEVERE } from "./types.js";
+import { healthScore, healthWeeks, healthContextGood, healthEntryReadings, centralOf, treeOf, DAY_MS } from "./readings.js";
+const daysBetween = (a, b) => Math.round((Date.parse(`${b}T00:00:00Z`) - Date.parse(`${a}T00:00:00Z`)) / DAY_MS);
+// ── words: one wording for the phone and VS Code ────────────────────────────
+/** A whole number with thousands separators, locale-free: `8,397`. */
+const commas = (n) => Math.round(n).toString().replace(/\B(?=(\d{3})+(?!\d))/g, ",");
+const pct = (x) => `${Math.round(x * 100)}%`;
+const oneDp = (x) => (Math.round(x * 10) / 10).toFixed(1);
+/** Plain names for an entry, as the cap sentence names it. */
+export const HEALTH_ENTRY_LABEL = {
+    size: "file length",
+    retouch: "re-touches",
+    hatches: "escape hatches",
+    context: "CLAUDE.md + skill descriptions",
+    untested: "untested modules",
+};
+function alertText(level, subject, value, good, path) {
+    const body = (() => {
+        switch (subject) {
+            case "max":
+                return `${path ?? "the longest file"} is ${commas(value)} lines (good: under ${commas(good)})`;
+            case "lineMean":
+                return `the average line sits in a file of ${commas(value)} lines (good: under ${commas(good)})`;
+            case "retouch":
+                return `${pct(value)} of recent file edits rework the edit before (good: under ${pct(good)})`;
+            case "hatches":
+                return `${oneDp(value)} unexplained escape hatches per 1,000 lines (good: under ${oneDp(good)})`;
+            case "context":
+                return `CLAUDE.md + skill descriptions are ${commas(value)} chars (good: under ${commas(good)})`;
+            case "untested":
+                return `${pct(value)} of source files have no test reaching them (good: under ${pct(good)})`;
+        }
+    })();
+    return `${level}: ${body}`;
+}
+function alertOf(entry, subject, value, good, path) {
+    const score = healthScore(value, good);
+    if (!(score < HEALTH_ALERT_WARN))
+        return null;
+    const level = score < HEALTH_ALERT_SEVERE ? "severe" : "warn";
+    const p = path ?? undefined;
+    return { level, entry, subject, value, good, score, ...(p ? { path: p } : {}), text: alertText(level, subject, value, good, p) };
+}
+/**
+ * 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 function healthCapWords(s) {
+    if (!s.cappedBy || !(s.value < s.mean))
+        return null;
+    const worst = Math.round(s.value - HEALTH_SCORE_CAP_GAP);
+    return `Capped at ${Math.round(s.value)} by ${HEALTH_ENTRY_LABEL[s.cappedBy]} (${worst} of 100): the entries average ${Math.round(s.mean)}, and the score stays within ${HEALTH_SCORE_CAP_GAP} of its worst entry.`;
+}
+/** One week's score from its readings; null when any enabled entry is absent, or none is enabled. */
+function scoreWeek(r, disabled, contextWarnChars) {
+    const enabled = HEALTH_ENTRIES.filter((e) => !disabled.includes(e));
+    if (enabled.length === 0 || enabled.some((e) => r.values[e] === undefined))
+        return null;
+    const ctxGood = healthContextGood(contextWarnChars);
+    const scores = {};
+    let sizeParts = null;
+    const alerts = [];
+    for (const e of enabled) {
+        const v = r.values[e];
+        if (e === "size") {
+            const m = r.max;
+            sizeParts = {
+                lineMean: { value: v, score: healthScore(v, HEALTH_GOOD.lineMean) },
+                max: { value: m.value, score: healthScore(m.value, HEALTH_GOOD.max), path: m.path },
+            };
+            scores.size = Math.sqrt(sizeParts.lineMean.score * sizeParts.max.score);
+            // Size alerts on its sub-readings: the blend is under a line only if one
+            // of them is, and the sub-reading is what can be named.
+            const a1 = alertOf("size", "lineMean", v, HEALTH_GOOD.lineMean);
+            const a2 = alertOf("size", "max", m.value, HEALTH_GOOD.max, m.path);
+            if (a1)
+                alerts.push(a1);
+            if (a2)
+                alerts.push(a2);
+            continue;
+        }
+        const good = e === "context" ? ctxGood : HEALTH_GOOD[e];
+        scores[e] = healthScore(v, good);
+        const a = alertOf(e, e, v, good);
+        if (a)
+            alerts.push(a);
+    }
+    const n = enabled.length;
+    // A score of 0 cannot occur (good > 0, value finite), so ln is finite.
+    const mean = Math.exp(enabled.reduce((s, e) => s + Math.log(scores[e]), 0) / n);
+    let worst = enabled[0];
+    for (const e of enabled)
+        if (scores[e] < scores[worst])
+            worst = e;
+    const capped = scores[worst] + HEALTH_SCORE_CAP_GAP;
+    const index = Math.min(mean, capped);
+    alerts.sort((a, b) => a.score - b.score);
+    return { index, mean, scores, sizeParts, cappedBy: capped < mean ? worst : null, alerts, enabled };
+}
+/**
+ * The scored series. `null` when no week has every enabled entry — no score
+ * is no series, never a number nobody measured.
+ */
+export function healthIndex(rows, contextWarnChars) {
+    const points = [];
+    for (const { week, row } of healthWeeks(rows)) {
+        const c = centralOf(row);
+        const readings = healthEntryReadings(row);
+        const s = scoreWeek(readings, c.disabled, contextWarnChars);
+        if (!s)
+            continue;
+        const prereg = typeof row.prereg === "string" ? row.prereg : null;
+        const prev = points[points.length - 1];
+        const base = {
+            week, index: s.index, mean: s.mean, scores: s.scores, sizeParts: s.sizeParts,
+            cappedBy: s.cappedBy, alerts: s.alerts, values: readings.values, prereg,
+            central: c.fp, disabled: c.disabled, overridden: c.overridden, tree: treeOf(row),
+        };
+        if (!prev) {
+            points.push({ ...base, gap: false, lnLink: null, comparable: 0, contributions: {}, spanDays: null });
+            continue;
+        }
+        const spanDays = daysBetween(prev.week, week);
+        const gapReason = prev.prereg !== prereg ? "prereg" : prev.central !== c.fp ? "central" : null;
+        if (gapReason) {
+            points.push({ ...base, gap: true, lnLink: null, comparable: 0, contributions: {}, spanDays, gapReason });
+            continue;
+        }
+        // Same fingerprint ⇒ same enabled set, so every entry is in both weeks.
+        const n = s.enabled.length;
+        const contributions = {};
+        for (const e of s.enabled) {
+            const a = prev.scores[e];
+            const b = s.scores[e];
+            if (a !== undefined && b !== undefined)
+                contributions[e] = (prev.mean * (Math.log(b) - Math.log(a))) / n;
+        }
+        points.push({
+            ...base, gap: false, lnLink: Math.log(s.index / prev.index), comparable: n, contributions, spanDays,
+        });
+    }
+    if (points.length === 0)
+        return null;
+    return { baselineWeek: points[0].week, points };
+}
+/** One row by the SAME formula a week uses (`scoreWeek`); null when an enabled entry is absent. */
+export function healthRowScore(row, contextWarnChars) {
+    const s = scoreWeek(healthEntryReadings(row), centralOf(row).disabled, contextWarnChars);
+    return s ? { index: s.index, mean: s.mean, scores: s.scores, cappedBy: s.cappedBy } : null;
+}
+/** One scored commit (a series row) for the phone's commits axis. No lnLink, contributions or move. */
+//# sourceMappingURL=score.js.map

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

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

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

@@ -0,0 +1,206 @@
+export declare const HEALTH_ENTRIES: readonly ["size", "retouch", "hatches", "context", "untested"];
+export type HealthEntry = (typeof HEALTH_ENTRIES)[number];
+/**
+ * The GOOD value of each reading — at or under it, the entry scores 100.
+ * Opinion, and PROVISIONAL: picked by the owner from the repos on this
+ * desktop on 2026-10-17, not a published standard. `retouch` most of all (a
+ * fortnight's rework rate has no long record behind it yet). A repo that
+ * disagrees overrides the value it is compared with (`central`), never these.
+ * `context` has none here: its good line IS the repo's own warn line
+ * (`contextweight.ts`): the setup sheet calls a repo lean under it, so the index
+ * must not call the same repo unhealthy.
+ */
+export declare const HEALTH_GOOD: {
+    /** Line-weighted mean file length, lines. */
+    readonly lineMean: 500;
+    /** Longest source file, lines. */
+    readonly max: 1000;
+    /** Share of source-file edits that rework the previous edit. Provisional. */
+    readonly retouch: 0.15;
+    /** UNEXPLAINED escape hatches per 1,000 source lines. */
+    readonly hatches: 2;
+    /** Share of source files no test reaches. */
+    readonly untested: 0.2;
+};
+/**
+ * Context's good line, as a share of the repo's warn line: all of it. The setup
+ * sheet calibrated that line so a well-organised repo is NOT flagged; a good
+ * line at half of it made the two instruments disagree about one number.
+ */
+export declare const HEALTH_CONTEXT_GOOD_SHARE = 1;
+/** The headline never sits more than this many points above its worst entry. */
+export declare const HEALTH_SCORE_CAP_GAP = 30;
+/** An entry scoring under this is a `warn` alert… */
+export declare const HEALTH_ALERT_WARN = 50;
+/** …and under this a `severe` one. */
+export declare const HEALTH_ALERT_SEVERE = 25;
+/** Links of history needed before a move is called at all. */
+export declare const HEALTH_INDEX_MIN_WEEKS = 8;
+/** Prior rolling four-week windows needed before a MONTH move is called. */
+export declare const HEALTH_INDEX_MIN_MONTH_WINDOWS = 4;
+/** Width of the month horizon, in weekly points. */
+export declare const HEALTH_INDEX_MONTH_WEEKS = 4;
+/** A move must sit below this percentile of its own past to be a drop… */
+export declare const HEALTH_INDEX_LOW_PCT = 10;
+/** …or above this one to be a rise. */
+export declare const HEALTH_INDEX_HIGH_PCT = 90;
+/** …AND move the score by at least this many points. */
+export declare const HEALTH_INDEX_MIN_POINTS = 2;
+/**
+ * The context-weight warn line when the repo has none of its own: the setup
+ * checklist's `DEFAULT_CONTEXT_LIMITS.maxChars` (`contextweight.ts`), restated
+ * as a literal so this module carries no import cycle through the index.
+ * Pinned equal to it by the test.
+ */
+export declare const HEALTH_INDEX_DEFAULT_WARN_CHARS = 16000;
+/** The engine's `context.reason` for a tree with no CLAUDE.md (`metrics/context.mjs`; a tools test pins the two equal). */
+export declare const HEALTH_NO_CLAUDE_MD = "no CLAUDE.md at this commit";
+/**
+ * The fields of one series row this module reads. Everything is optional
+ * because a row is parsed JSON: a family can be absent (`{value: null,
+ * reason}`) or missing outright, and either way that entry is absent.
+ */
+export interface HealthSeriesRow {
+    sha?: string;
+    day: string;
+    ts: number;
+    batch?: boolean;
+    prereg?: string;
+    size?: {
+        value?: {
+            p95?: unknown;
+            max?: unknown;
+            maxPath?: unknown;
+            lineMean?: unknown;
+        } | null;
+    } | null;
+    retouch?: {
+        value?: {
+            rate?: unknown;
+        } | null;
+    } | null;
+    hatches?: {
+        value?: Record<string, unknown> | null;
+    } | null;
+    context?: {
+        value?: {
+            claudeMdChars?: unknown;
+            descChars?: unknown;
+        } | null;
+        reason?: unknown;
+    } | null;
+    untested?: {
+        value?: unknown[] | null;
+    } | null;
+    classics?: {
+        value?: {
+            loc?: unknown;
+            files?: unknown;
+        } | null;
+    } | null;
+    /** The repo's disables and overrides in force on this row; absent = none. */
+    central?: HealthRowCentral | null;
+}
+/** `row.central` — written by the engine's `central.mjs`. */
+export interface HealthRowCentral {
+    /** Fingerprint of what was APPLIED on this row; "" (or absent) = nothing. */
+    fp?: unknown;
+    disabled?: Record<string, {
+        why?: unknown;
+    } | null> | null;
+    override?: Record<string, {
+        value?: unknown;
+        why?: unknown;
+    } | null> | null;
+}
+/** Size's two sub-readings, each with its value and score. */
+export interface HealthSizeParts {
+    lineMean: {
+        value: number;
+        score: number;
+    };
+    max: {
+        value: number;
+        score: number;
+        path: string | null;
+    };
+}
+/** Which reading an alert is about: an entry, or one of size's two sub-readings. */
+export type HealthAlertSubject = Exclude<HealthEntry, "size"> | "lineMean" | "max";
+export interface HealthAlert {
+    level: "warn" | "severe";
+    /** The entry the alert counts against (`size` for both sub-readings). */
+    entry: HealthEntry;
+    subject: HealthAlertSubject;
+    /** The value read (after any override) and its good line. */
+    value: number;
+    good: number;
+    score: number;
+    /** The longest file's path, on a `max` alert where the engine named it. */
+    path?: string;
+    /** One sentence: `severe: lib/a.dart is 8,397 lines (good: under 1,000)`. */
+    text: string;
+}
+export interface HealthIndexPoint {
+    /** The ISO week's Monday, `YYYY-MM-DD` (UTC). */
+    week: string;
+    /** The headline SCORE, 0–100: `min(mean, worst + HEALTH_SCORE_CAP_GAP)`. */
+    index: number;
+    /** Geometric mean of the enabled entries' scores, before the cap. */
+    mean: number;
+    /** Each enabled entry's score, 0–100. */
+    scores: Partial<Record<HealthEntry, number>>;
+    /** Size's two sub-readings; null where size is disabled. */
+    sizeParts: HealthSizeParts | null;
+    /** The worst entry when the cap set the headline (`index < mean`), else null. */
+    cappedBy: HealthEntry | null;
+    /** Every entry or size sub-reading under `HEALTH_ALERT_WARN`, worst first. */
+    alerts: HealthAlert[];
+    /** A prereg or `central` change since the previous scored week: the score
+     *  stands as measured, but the link is not used to call a move. */
+    gap: boolean;
+    /** `ln(index / previous index)`; `null` on the first scored week and on a gap. */
+    lnLink: number | null;
+    /** How many entries the contributions split the mean's move over (0 on the first week and a gap). */
+    comparable: number;
+    /**
+     * Each entry's share of the MEAN's move, in LOG POINTS:
+     * `prevMean · (ln s_cur − ln s_prev) / n`. Log points are what is additive —
+     * the terms of a geometric mean add in log space — so these sum EXACTLY to
+     * `prevMean · ln(mean / prevMean)`. Negative = that entry's score fell
+     * (its metric rose). The cap is explained apart, by `cappedBy`.
+     */
+    contributions: Partial<Record<HealthEntry, number>>;
+    /** The values read this week (after any override); size's is `lineMean`. */
+    values: Partial<Record<HealthEntry, number>>;
+    prereg: string | null;
+    /**
+     * Days since the previous SCORED week (Monday to Monday, so a multiple of
+     * 7); null on the first. A week with no commit has no row, and a week with a
+     * partial basket has no score, so a link over 7 days spans weeks with no
+     * score — a reader should be told before reading it as one week's move.
+     */
+    spanDays: number | null;
+    /** Why a gap was marked: the engine's definition moved, or the repo's own
+     *  `central` config moved. (`nothing` is no longer produced: every scored
+     *  week has every enabled entry.) */
+    gapReason?: "prereg" | "central" | "nothing";
+    /** The repo's `central` fingerprint this week; "" = none applied. */
+    central: string;
+    /** Entries the repo disabled this week — out of the mean, not absent readings. */
+    disabled: HealthEntry[];
+    /** Entries whose value this week is the repo's override, not the engine's. */
+    overridden: HealthEntry[];
+    /** Source files and lines this week (`classics`), so growth can be stated;
+     *  null where that reading was absent. */
+    tree: {
+        files: number;
+        loc: number;
+    } | null;
+}
+export interface HealthIndexSeries {
+    /** The first SCORED week — no longer a "100", just where the line starts. */
+    baselineWeek: string;
+    /** One point per scored week, oldest first. */
+    points: HealthIndexPoint[];
+}

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

@@ -0,0 +1,58 @@
+// healthindex/types: The vocabulary: entries, GOOD values and thresholds, the row and point DTOs. Barrel: ../healthindex.ts (read the header there).
+export const HEALTH_ENTRIES = ["size", "retouch", "hatches", "context", "untested"];
+/**
+ * The GOOD value of each reading — at or under it, the entry scores 100.
+ * Opinion, and PROVISIONAL: picked by the owner from the repos on this
+ * desktop on 2026-10-17, not a published standard. `retouch` most of all (a
+ * fortnight's rework rate has no long record behind it yet). A repo that
+ * disagrees overrides the value it is compared with (`central`), never these.
+ * `context` has none here: its good line IS the repo's own warn line
+ * (`contextweight.ts`): the setup sheet calls a repo lean under it, so the index
+ * must not call the same repo unhealthy.
+ */
+export const HEALTH_GOOD = {
+    /** Line-weighted mean file length, lines. */
+    lineMean: 500,
+    /** Longest source file, lines. */
+    max: 1_000,
+    /** Share of source-file edits that rework the previous edit. Provisional. */
+    retouch: 0.15,
+    /** UNEXPLAINED escape hatches per 1,000 source lines. */
+    hatches: 2.0,
+    /** Share of source files no test reaches. */
+    untested: 0.2,
+};
+/**
+ * Context's good line, as a share of the repo's warn line: all of it. The setup
+ * sheet calibrated that line so a well-organised repo is NOT flagged; a good
+ * line at half of it made the two instruments disagree about one number.
+ */
+export const HEALTH_CONTEXT_GOOD_SHARE = 1.0;
+/** The headline never sits more than this many points above its worst entry. */
+export const HEALTH_SCORE_CAP_GAP = 30;
+/** An entry scoring under this is a `warn` alert… */
+export const HEALTH_ALERT_WARN = 50;
+/** …and under this a `severe` one. */
+export const HEALTH_ALERT_SEVERE = 25;
+/** Links of history needed before a move is called at all. */
+export const HEALTH_INDEX_MIN_WEEKS = 8;
+/** Prior rolling four-week windows needed before a MONTH move is called. */
+export const HEALTH_INDEX_MIN_MONTH_WINDOWS = 4;
+/** Width of the month horizon, in weekly points. */
+export const HEALTH_INDEX_MONTH_WEEKS = 4;
+/** A move must sit below this percentile of its own past to be a drop… */
+export const HEALTH_INDEX_LOW_PCT = 10;
+/** …or above this one to be a rise. */
+export const HEALTH_INDEX_HIGH_PCT = 90;
+/** …AND move the score by at least this many points. */
+export const HEALTH_INDEX_MIN_POINTS = 2;
+/**
+ * The context-weight warn line when the repo has none of its own: the setup
+ * checklist's `DEFAULT_CONTEXT_LIMITS.maxChars` (`contextweight.ts`), restated
+ * as a literal so this module carries no import cycle through the index.
+ * Pinned equal to it by the test.
+ */
+export const HEALTH_INDEX_DEFAULT_WARN_CHARS = 16_000;
+/** The engine's `context.reason` for a tree with no CLAUDE.md (`metrics/context.mjs`; a tools test pins the two equal). */
+export const HEALTH_NO_CLAUDE_MD = "no CLAUDE.md at this commit";
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/healthindex/types.ts"],"names":[],"mappings":"AAAA,qJAAqJ;AACrJ,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,UAAU,CAAU,CAAC;AAG7F;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,6CAA6C;IAC7C,QAAQ,EAAE,GAAG;IACb,kCAAkC;IAClC,GAAG,EAAE,KAAK;IACV,6EAA6E;IAC7E,OAAO,EAAE,IAAI;IACb,yDAAyD;IACzD,OAAO,EAAE,GAAG;IACZ,6CAA6C;IAC7C,QAAQ,EAAE,GAAG;CACL,CAAC;AACX;;;;GAIG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,GAAG,CAAC;AAC7C,gFAAgF;AAChF,MAAM,CAAC,MAAM,oBAAoB,GAAG,EAAE,CAAC;AACvC,qDAAqD;AACrD,MAAM,CAAC,MAAM,iBAAiB,GAAG,EAAE,CAAC;AACpC,sCAAsC;AACtC,MAAM,CAAC,MAAM,mBAAmB,GAAG,EAAE,CAAC;AACtC,8DAA8D;AAC9D,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC;AACxC,4EAA4E;AAC5E,MAAM,CAAC,MAAM,8BAA8B,GAAG,CAAC,CAAC;AAChD,oDAAoD;AACpD,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC;AAC1C,0EAA0E;AAC1E,MAAM,CAAC,MAAM,oBAAoB,GAAG,EAAE,CAAC;AACvC,uCAAuC;AACvC,MAAM,CAAC,MAAM,qBAAqB,GAAG,EAAE,CAAC;AACxC,wDAAwD;AACxD,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC;AACzC;;;;;GAKG;AACH,MAAM,CAAC,MAAM,+BAA+B,GAAG,MAAM,CAAC;AACtD,2HAA2H;AAC3H,MAAM,CAAC,MAAM,mBAAmB,GAAG,6BAA6B,CAAC"}

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

@@ -0,0 +1,26 @@
+import { type HealthIndexPoint } from "./types.js";
+/** How far back "vs 12 weeks ago" looks, in weeks. */
+export declare const HEALTH_INDEX_VS_WEEKS = 12;
+export interface HealthIndexVs {
+    /** `now.index / then.index` — 1.05 is five percent healthier. */
+    ratio: number;
+    /** Score points between the two (`now − then`). */
+    delta: number;
+    then: HealthIndexPoint;
+    now: HealthIndexPoint;
+    /** Weeks actually between the two points — `weeks` asked or more, since a
+     *  week nobody measured has no point. The UI names `then.week`. */
+    weeks: number;
+}
+/**
+ * "Vs 12 weeks ago": the score at `points[at]` (default the latest) against
+ * the LATEST measured point at least `weeks` earlier — however much further
+ * back that is, because a week with no commit has no row and the honest
+ * comparison names the week it actually used (`then.week`, `weeks`). Null
+ * only when no point sits that far back (a series younger than the horizon).
+ *
+ * Both ends are absolute scores, so the ratio is simply the two numbers —
+ * including any prereg or `central` change between them (the point's `gap`
+ * says one happened; the caller decides whether to say so).
+ */
+export declare function healthIndexVs(points: readonly HealthIndexPoint[], weeks?: number, at?: number): HealthIndexVs | null;

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

@@ -0,0 +1,38 @@
+import { DAY_MS } from "./readings.js";
+/** How far back "vs 12 weeks ago" looks, in weeks. */
+export const HEALTH_INDEX_VS_WEEKS = 12;
+/**
+ * "Vs 12 weeks ago": the score at `points[at]` (default the latest) against
+ * the LATEST measured point at least `weeks` earlier — however much further
+ * back that is, because a week with no commit has no row and the honest
+ * comparison names the week it actually used (`then.week`, `weeks`). Null
+ * only when no point sits that far back (a series younger than the horizon).
+ *
+ * Both ends are absolute scores, so the ratio is simply the two numbers —
+ * including any prereg or `central` change between them (the point's `gap`
+ * says one happened; the caller decides whether to say so).
+ */
+export function healthIndexVs(points, weeks = HEALTH_INDEX_VS_WEEKS, at = points.length - 1) {
+    const now = points[at];
+    if (!now || !(weeks > 0) || !Number.isFinite(now.index))
+        return null;
+    const nowT = Date.parse(`${now.week}T00:00:00Z`);
+    const target = nowT - weeks * 7 * DAY_MS;
+    for (let i = at - 1; i >= 0; i--) {
+        const t = Date.parse(`${points[i].week}T00:00:00Z`);
+        if (t > target)
+            continue;
+        const then = points[i];
+        if (!(then.index > 0))
+            return null;
+        return {
+            ratio: now.index / then.index,
+            delta: now.index - then.index,
+            then,
+            now,
+            weeks: Math.round((nowT - t) / (7 * DAY_MS)),
+        };
+    }
+    return null;
+}
+//# sourceMappingURL=vs.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"vs.js","sourceRoot":"","sources":["../../src/healthindex/vs.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAEvC,sDAAsD;AACtD,MAAM,CAAC,MAAM,qBAAqB,GAAG,EAAE,CAAC;AAcxC;;;;;;;;;;GAUG;AACH,MAAM,UAAU,aAAa,CAC3B,MAAmC,EACnC,QAAgB,qBAAqB,EACrC,KAAa,MAAM,CAAC,MAAM,GAAG,CAAC;IAE9B,MAAM,GAAG,GAAG,MAAM,CAAC,EAAE,CAAC,CAAC;IACvB,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACrE,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,IAAI,YAAY,CAAC,CAAC;IACjD,MAAM,MAAM,GAAG,IAAI,GAAG,KAAK,GAAG,CAAC,GAAG,MAAM,CAAC;IACzC,KAAK,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QACjC,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,YAAY,CAAC,CAAC;QACpD,IAAI,CAAC,GAAG,MAAM;YAAE,SAAS;QACzB,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;QACvB,IAAI,CAAC,CAAC,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC;YAAE,OAAO,IAAI,CAAC;QACnC,OAAO;YACL,KAAK,EAAE,GAAG,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK;YAC7B,KAAK,EAAE,GAAG,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK;YAC7B,IAAI;YACJ,GAAG;YACH,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC;SAC7C,CAAC;IACJ,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

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

@@ -0,0 +1,28 @@
+import { type HealthIndexPoint } from "./types.js";
+import { type HealthMove } from "./move.js";
+/** A signed whole number with a real minus sign: `−4`, `+3`, `±0`. */
+export declare function signedPoints(n: number): string;
+export interface HealthWords {
+    /** Short label for the repo row: `Health 94 −4`. */
+    chip: string;
+    /** `Health score 94 (−4 this week)`. */
+    title: string;
+    /** Names the (at most two) metrics that carried the move, or "" when none can be named. */
+    body: string;
+}
+/**
+ * When the latest measured week happened, worded against the week it is now:
+ * `this week` only when they are the same ISO week — a week with no commit has
+ * no point, so the newest one can be months old — else `in the week of <Monday>`.
+ * `currentWeek` absent = the caller did not say, and the claim falls back to
+ * naming the week (never a `this week` nobody checked).
+ */
+export declare function healthWeekWhen(week: string, currentWeek?: string | null): string;
+/**
+ * The notification and chip wording for a called move. `null` when there is
+ * nothing to say (no move called, or no points) — a sentence is never written
+ * around a null. `currentWeek` (the ISO week's Monday, `isoWeekOf(today)`)
+ * decides whether the latest point may be called "this week".
+ */
+export declare function healthMoveWords(points: readonly HealthIndexPoint[], move: HealthMove, currentWeek?: string | null): HealthWords | null;
+/** What `RepoTarget.healthIndex` carries. */

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

@@ -0,0 +1,69 @@
+// healthindex/words: One wording of a move for the phone and VS Code. Barrel: ../healthindex.ts (read the header there).
+import { HEALTH_ENTRIES, HEALTH_INDEX_MONTH_WEEKS } from "./types.js";
+const ENTRY_WORDS = {
+    size: ["files grew longer", "files got shorter"],
+    retouch: ["more re-touched files", "fewer re-touched files"],
+    hatches: ["more escape hatches", "fewer escape hatches"],
+    context: ["CLAUDE.md + skill descriptions grew", "CLAUDE.md + skill descriptions shrank"],
+    untested: ["more untested modules", "fewer untested modules"],
+};
+/** A signed whole number with a real minus sign: `−4`, `+3`, `±0`. */
+export function signedPoints(n) {
+    const r = Math.round(n);
+    if (r === 0)
+        return "±0";
+    return r < 0 ? `−${-r}` : `+${r}`;
+}
+/**
+ * When the latest measured week happened, worded against the week it is now:
+ * `this week` only when they are the same ISO week — a week with no commit has
+ * no point, so the newest one can be months old — else `in the week of <Monday>`.
+ * `currentWeek` absent = the caller did not say, and the claim falls back to
+ * naming the week (never a `this week` nobody checked).
+ */
+export function healthWeekWhen(week, currentWeek) {
+    return currentWeek && week === currentWeek ? "this week" : `in the week of ${week}`;
+}
+/**
+ * The notification and chip wording for a called move. `null` when there is
+ * nothing to say (no move called, or no points) — a sentence is never written
+ * around a null. `currentWeek` (the ISO week's Monday, `isoWeekOf(today)`)
+ * decides whether the latest point may be called "this week".
+ */
+export function healthMoveWords(points, move, currentWeek) {
+    const last = points[points.length - 1];
+    if (!last || !move.kind || !move.horizon || move.delta === null)
+        return null;
+    const value = Math.round(last.index);
+    const span = move.horizon === "week" ? 1 : HEALTH_INDEX_MONTH_WEEKS;
+    const latest = currentWeek && last.week === currentWeek;
+    const when = move.horizon === "week"
+        ? healthWeekWhen(last.week, currentWeek)
+        : latest ? "over four weeks" : `over the four weeks to ${last.week}`;
+    const sums = {};
+    for (const p of points.slice(-span)) {
+        for (const e of HEALTH_ENTRIES) {
+            const c = p.contributions[e];
+            if (c !== undefined)
+                sums[e] = (sums[e] ?? 0) + c;
+        }
+    }
+    const sign = move.kind === "drop" ? -1 : 1;
+    const top = HEALTH_ENTRIES
+        .filter((e) => (sums[e] ?? 0) * sign > 0)
+        .sort((a, b) => Math.abs(sums[b] ?? 0) - Math.abs(sums[a] ?? 0))
+        .slice(0, 2)
+        .map((e) => `${ENTRY_WORDS[e][move.kind === "drop" ? 0 : 1]} (${signedPoints(sums[e] ?? 0)})`);
+    const verb = move.kind === "drop" ? "slipped" : "rose";
+    const pts = Math.abs(Math.round(move.delta));
+    const body = top.length
+        ? `The score ${verb} ${pts} point${pts === 1 ? "" : "s"} ${when}: ${top.join(", ")}.`
+        : `The score ${verb} ${pts} point${pts === 1 ? "" : "s"} ${when}.`;
+    return {
+        chip: `Health ${value} ${signedPoints(move.delta)}`,
+        title: `Health score ${value} (${signedPoints(move.delta)} ${when})`,
+        body,
+    };
+}
+/** What `RepoTarget.healthIndex` carries. */
+//# sourceMappingURL=words.js.map

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

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