waterplane 0.0.1 → 0.1.6

package/node_modules/@waterplane/shared/dist/clihealth/healthrecord.js

@@ -0,0 +1,367 @@
+// Cut from clihealth.ts (move only): the record, capturing a sample, observing, re-arming and the verdict sentence
+// The one door stays `./clihealth.js`; this slice imports its siblings directly, never the barrel.
+import { SAMPLE_CAP, VIA_CAP } from "./healththresholds.js";
+import { signalSpec, thresholdsFor } from "./healthcatalog.js";
+export function emptyHealth() {
+    return { version: null, versionSeenAt: null, signals: {} };
+}
+export function blankSignal(id, version) {
+    return {
+        id,
+        version,
+        lastGoodAt: null,
+        lastMissAt: null,
+        misses: 0,
+        missStreakSince: null,
+        window: [],
+        totalGood: 0,
+        totalMiss: 0,
+    };
+}
+// ── Capturing a sample, without capturing a secret ──────────────────────
+/**
+ * A sample as a SHAPE — the structure of the input, and none of its characters.
+ *
+ * Used wherever the failing input is prose somebody wrote. It is less than a
+ * line of text and more than nothing, and it is exactly what most of these
+ * parses were reasoning about in the first place: a probe cut from the head of
+ * a prompt fails differently for one line and for forty, and a log record that
+ * parses to zero turns is a different bug at 200 bytes than at 2 MB.
+ */
+export function shapeOf(text) {
+    if (!text)
+        return "empty";
+    const lines = text.split("\n");
+    let longest = 0;
+    for (const l of lines)
+        if (l.length > longest)
+            longest = l.length;
+    return `${lines.length} line${lines.length === 1 ? "" : "s"}, ${text.length} chars, longest line ${longest}`;
+}
+/** Home directories, so a sample never carries the account name. */
+const HOME_RE = /\/(?:Users|home)\/[^/\s]+/g;
+const EMAIL_RE = /\b[\w.+-]+@[\w-]+\.[\w.-]+\b/g;
+const URL_CREDS_RE = /(\b[a-z][a-z0-9+.-]*:\/\/)[^\s/@]+@/gi;
+/**
+ * `token: …`, `api-key=…`, `Authorization: Bearer …` — the value, whatever it
+ * is, is not something a health readout needs.
+ *
+ * The optional scheme word is not decoration: `Authorization: Bearer <token>`
+ * puts a word between the colon and the secret, so consuming a single `\S+`
+ * eats "Bearer" and leaves the credential standing in the sample.
+ */
+const SECRET_ASSIGN_RE = /\b(tokens?|secrets?|passwds?|passwords?|api[-_ ]?keys?|apikeys?|authorization|auth|bearer|cookies?|credentials?)\b\s*[:=]\s*(?:(?:bearer|basic|token|jwt)\s+)?\S+/gi;
+/**
+ * A long unbroken opaque run.
+ *
+ * The catch-all, and the only rule here that works on a credential format
+ * nobody has thought of yet: no legible line contains twenty-four characters of
+ * base64-ish text with no separator, and every key ever issued does. `/` is
+ * deliberately out of the class so a long path is not mistaken for one.
+ */
+const OPAQUE_RE = /[A-Za-z0-9_+=-]{24,}/g;
+/**
+ * Redact and cap a `line` sample.
+ *
+ * Applied by `observe()` rather than offered as a helper, for the reason stated
+ * on `SampleMode`: the call site that leaks is always the one written later.
+ */
+export function redactSample(raw, cap = SAMPLE_CAP) {
+    const s = redactRow(raw.replace(/\s+/g, " ").trim());
+    return s.length > cap ? s.slice(0, cap - 1) + "…" : s;
+}
+/** `redactSample`'s rules with the layout kept: a fixture grid is read by column. */
+export function redactRow(row) {
+    let s = row.replace(URL_CREDS_RE, "$1<redacted>@");
+    s = s.replace(SECRET_ASSIGN_RE, (_m, k) => `${k}=<redacted>`);
+    s = s.replace(EMAIL_RE, "<email>");
+    s = s.replace(HOME_RE, "~");
+    return s.replace(OPAQUE_RE, (m) => `<redacted:${m.length}>`);
+}
+/** Store a failing input the way this signal is allowed to store it. */
+export function captureSample(id, raw) {
+    return signalSpec(id).capture === "line" ? redactSample(raw) : shapeOf(raw);
+}
+/**
+ * Record one observation against a signal.
+ *
+ * Mutates the record in place and returns it. Deliberately not a copy: this is
+ * called from the delivery path and from a prompt check that runs about twice a
+ * second, and a readout whose bookkeeping is the expensive part is the failure
+ * mode `nettraffic.ts` names — the measurement must never be the cost of the
+ * thing measured. The store that owns the object is the one that persists it.
+ */
+export function observe(health, id, outcome, opts) {
+    let sig = health.signals[id];
+    if (!sig)
+        sig = health.signals[id] = blankSignal(id, health.version);
+    // Belt and braces: a record stamped with another version has already been
+    // invalidated by the fact of the change, whether or not anybody called
+    // `noteCliVersion` first.
+    if (sig.version !== health.version)
+        sig = health.signals[id] = rearmForVersion(sig, health.version, opts.at);
+    const th = thresholdsFor(id);
+    const good = outcome === "good";
+    sig.window.push({ at: opts.at, ok: good, ...(outcome === "fallback" ? { fallback: true } : {}) });
+    while (sig.window.length > th.rateWindow)
+        sig.window.shift();
+    if (good) {
+        sig.lastGoodAt = opts.at;
+        sig.misses = 0;
+        sig.missStreakSince = null;
+        sig.totalGood++;
+        return sig;
+    }
+    sig.lastMissAt = opts.at;
+    if (sig.misses === 0)
+        sig.missStreakSince = opts.at;
+    sig.misses++;
+    sig.totalMiss++;
+    if (outcome === "fallback") {
+        sig.lastFallbackAt = opts.at;
+        if (opts.via)
+            sig.via = opts.via.slice(0, VIA_CAP);
+    }
+    if (opts.raw != null) {
+        sig.sample = captureSample(id, opts.raw);
+        sig.sampleAt = opts.at;
+    }
+    return sig;
+}
+// ── Re-arming on a version change ───────────────────────────────────────
+/**
+ * A new `claude` makes every heuristic's history a statement about a program
+ * that is no longer running, so the history is CLEARED and the signal returns
+ * to `unknown`.
+ *
+ * Both directions of keeping it are wrong, which is what settles the question:
+ *
+ *   • Keep the GOODS and a signal that broke on the upgrade reads `healthy` off
+ *     yesterday's successes — masking the single most likely cause of a break
+ *     with the history that predates it.
+ *   • Keep the MISSES and a signal the upgrade just fixed stays red until
+ *     somebody notices, which is the permanent-mark problem `SIGNAL_FORGET_MS`
+ *     exists to avoid.
+ *
+ * `unknown` is the only honest state for a heuristic against a binary it has
+ * never been tried on, and it is a state this file is careful to keep distinct
+ * from `healthy` precisely so it can be used here.
+ *
+ * What survives is one breadcrumb: the version we came from and the verdict it
+ * ended on, because "this went red at the upgrade to 2.1.4" is the sentence
+ * that names a cause, and it cannot be reconstructed from an empty record.
+ */
+export function rearmForVersion(sig, version, now) {
+    const prior = signalVerdict(sig, now).verdict;
+    return {
+        ...blankSignal(sig.id, version),
+        priorVersion: sig.version,
+        priorVerdict: prior,
+    };
+}
+/**
+ * Tell the record which `claude` is installed.
+ *
+ * Returns whether it CHANGED, because a version change is worth announcing on
+ * its own — it is the most likely explanation for whatever the readout says
+ * next, and saying so once beforehand is cheaper than working it out afterwards
+ * from ten signals that all went `unknown` at the same minute.
+ */
+export function noteCliVersion(health, version, now) {
+    const from = health.version;
+    health.versionSeenAt = now;
+    if (from === version)
+        return { changed: false, from };
+    health.version = version;
+    health.versionChangedAt = now;
+    for (const id of Object.keys(health.signals)) {
+        health.signals[id] = rearmForVersion(health.signals[id], version, now);
+    }
+    // A first sighting on a fresh record is not a change anybody needs told
+    // about: there is no history to have invalidated.
+    return { changed: from !== null, from };
+}
+// ── A person clearing what they have read ───────────────────────────────
+/**
+ * Drop every miss at or before `through` — the newest miss the person was
+ * SHOWN when they tapped clear — and keep everything after it.
+ *
+ * Bounded by an instant the reader saw rather than by the moment the host
+ * receives the tap, so a clear that arrives late can only remove what was on
+ * the screen: a miss that landed after the board was drawn still counts, and
+ * still turns the row amber. What goes is the window's old misses, the streak,
+ * and the fallback/sample breadcrumbs stamped inside the cleared span; the
+ * all-time totals stay, because they were never a warning.
+ *
+ * After a clear the signal is NOT called working off a good that predates it —
+ * that good was already on the board beside the misses the person dismissed.
+ * Until a fresh good arrives the verdict is `unknown`, said as "cleared" in
+ * `healthSentence`; a clear is the person's call about what they read, never
+ * evidence that the heuristic works.
+ */
+export function clearSeen(sig, through) {
+    if (!Number.isFinite(through))
+        return sig;
+    const window = sig.window.filter((o) => o.at > through);
+    let misses = sig.misses;
+    let missStreakSince = sig.missStreakSince;
+    if (sig.lastMissAt == null || sig.lastMissAt <= through) {
+        misses = 0;
+        missStreakSince = null;
+    }
+    else if (missStreakSince != null && missStreakSince <= through) {
+        // The streak runs on past the cleared instant: keep only its tail.
+        let n = 0;
+        for (let i = window.length - 1; i >= 0 && !window[i].ok; i--)
+            n++;
+        misses = n;
+        missStreakSince = n ? window[window.length - n].at : null;
+    }
+    const out = {
+        ...sig,
+        window,
+        misses,
+        missStreakSince,
+        clearedAt: Math.max(sig.clearedAt ?? 0, through),
+    };
+    if (out.lastFallbackAt != null && out.lastFallbackAt <= through) {
+        delete out.lastFallbackAt;
+        delete out.via;
+    }
+    if (out.sampleAt != null && out.sampleAt <= through) {
+        delete out.sampleAt;
+        delete out.sample;
+    }
+    return out;
+}
+/**
+ * The one rule. Pure: a record, the clock, and the signal's own thresholds.
+ *
+ * Order is the argument. Nothing observed outranks everything (an empty record
+ * cannot be graded); silence outranks a stale verdict (a red mark from
+ * yesterday is not a fact about today); a streak outranks a rate (five in a row
+ * is sharper evidence than a fraction, and it is what a genuinely broken regex
+ * looks like); and `healthy` is only ever reached by having actually seen the
+ * thing work.
+ */
+export function signalVerdict(sig, now, override) {
+    const th = { ...thresholdsFor(sig.id), ...(override ?? {}) };
+    const newest = Math.max(sig.lastGoodAt ?? 0, sig.lastMissAt ?? 0) || null;
+    const inWindow = sig.window.filter((o) => now - o.at <= th.rateMaxAgeMs);
+    const samples = inWindow.length;
+    const failed = inWindow.reduce((n, o) => n + (o.ok ? 0 : 1), 0);
+    const rate = samples >= th.rateMinSamples ? failed / samples : null;
+    const oldestInWindow = samples ? inWindow[0].at : null;
+    const base = { misses: sig.misses, samples, failed, rate };
+    if (newest == null) {
+        return { ...base, verdict: "unknown", because: "no-observations", since: null };
+    }
+    if (now - newest > th.forgetMs) {
+        return { ...base, verdict: "unknown", because: "gone-quiet", since: newest };
+    }
+    if (sig.misses >= th.brokenMisses) {
+        return { ...base, verdict: "broken", because: "misses", since: sig.missStreakSince };
+    }
+    if (rate != null && rate >= th.rateBroken) {
+        return { ...base, verdict: "broken", because: "rate", since: oldestInWindow };
+    }
+    if (sig.misses >= th.degradedMisses) {
+        return { ...base, verdict: "degraded", because: "misses", since: sig.missStreakSince };
+    }
+    if (rate != null && rate >= th.rateDegraded) {
+        return { ...base, verdict: "degraded", because: "rate", since: oldestInWindow };
+    }
+    if (sig.lastGoodAt != null && sig.lastGoodAt > (sig.clearedAt ?? -Infinity)) {
+        return { ...base, verdict: "healthy", because: "confirmed", since: sig.lastGoodAt };
+    }
+    // Seen only failing, but not often enough to call it. Not healthy — nothing
+    // here has ever worked — and not degraded either, on one bad moment.
+    return { ...base, verdict: "unknown", because: "no-observations", since: newest };
+}
+// ── One sentence, generated once ────────────────────────────────────────
+/**
+ * A duration, compactly.
+ *
+ * Compact units ("12m", "3h", "2d") rather than prose, for two reasons: they
+ * pluralize nothing, so the sentence has one form and a test can pin it; and
+ * they match every other readout in this app, which says "250 ms" and "54
+ * lost" rather than spelling numbers out.
+ */
+export function agoText(ms) {
+    if (!Number.isFinite(ms) || ms < 60_000)
+        return "<1m";
+    const m = Math.floor(ms / 60_000);
+    if (m < 60)
+        return `${m}m`;
+    const h = Math.floor(m / 60);
+    if (h < 48)
+        return `${h}h`;
+    return `${Math.floor(h / 24)}d`;
+}
+/**
+ * One sentence about one signal: which signal, since when, how many misses, and
+ * what it last saw.
+ *
+ * Generated here so the host's notification body, the phone's badge and a log
+ * line cannot word the same fact three ways — the same argument
+ * `budgetReasonText` and `blockedReasonText` are made from. It answers for every
+ * verdict, including the healthy one, so no caller ever has a reason to write
+ * its own.
+ */
+export function healthSentence(sig, now) {
+    const spec = signalSpec(sig.id);
+    const c = signalVerdict(sig, now);
+    const sample = sig.sample
+        ? spec.capture === "line"
+            ? ` Last input: “${sig.sample}”.`
+            : ` Last input: ${sig.sample}.`
+        : "";
+    const lastGood = sig.lastGoodAt != null ? `last confirmed ${agoText(now - sig.lastGoodAt)} ago` : "never confirmed at all";
+    switch (c.because) {
+        case "confirmed":
+            return `${spec.name} is working — ${lastGood}.`;
+        case "no-observations":
+            if (sig.clearedAt != null) {
+                return `${spec.name}: you cleared its misses up to ${agoText(now - sig.clearedAt)} ago, and it has not been seen working since — unknown until the next check.`;
+            }
+            return sig.priorVersion
+                ? `${spec.name} has not been checked since claude ${sig.version ?? "?"} — its history was cleared when the CLI changed from ${sig.priorVersion}.`
+                : `${spec.name} has not been checked yet.`;
+        case "gone-quiet":
+            return `${spec.name} has gone quiet — nothing observed for ${agoText(now - (c.since ?? now))}, so its state is unknown.`;
+        case "misses":
+            return `${spec.name} is ${c.verdict} — ${c.misses} misses in a row over the last ${agoText(now - (c.since ?? now))}, ${lastGood}.${sample}`;
+        case "rate":
+            return `${spec.name} is ${c.verdict} — ${c.failed} of the last ${c.samples} failed (${Math.round((c.rate ?? 0) * 100)}%) over the last ${agoText(now - (c.since ?? now))}, ${lastGood}.${sample}`;
+    }
+}
+/**
+ * Has the primary rule been CONFIRMED since the instant this breadcrumb was
+ * stamped?
+ *
+ * The record keeps `via`, `sample` and their stamps for ever, and it should:
+ * "this is the line that stopped matching" is the actionable half of the whole
+ * feature, and deleting it on the next success throws away the only evidence
+ * anybody could act on. But keeping it and RENDERING it in the present tense
+ * are different things, and the board was doing the second: a signal reading
+ * `healthy`, last confirmed 32 minutes ago, still wore *Falling back to the
+ * weaker flag* over a captured screen from four days earlier. Read literally
+ * that says the app is standing on its fallback right now — the exact wrong
+ * answer for the one screen whose entire job is to stop a fallback becoming
+ * permanent without anybody being told.
+ *
+ * The predicate is a fact, not a threshold, which is why there is no age
+ * constant here: a `good` observation IS the primary rule running and working,
+ * so one stamped after the fallback settles the question outright. Everything
+ * else in this file that fades with time (`rateMaxAgeMs`, `forgetMs`) is
+ * guessing from silence; this is not guessing.
+ *
+ * `>=` rather than `>` because both stamps come from one `opts.at` per
+ * observation and a tie means the good is at worst the same moment — and a
+ * caller that batches a good and a fallback into one instant has already said
+ * the primary rule answered.
+ */
+export function supersededByGood(sig, at) {
+    return at != null && sig.lastGoodAt != null && sig.lastGoodAt >= at;
+}
+//# sourceMappingURL=healthrecord.js.map

package/node_modules/@waterplane/shared/dist/clihealth/healthrecord.js.map

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

package/node_modules/@waterplane/shared/dist/clihealth/healthrollup.d.ts

@@ -0,0 +1,36 @@
+import { type CliSignalId } from "./healthcatalog.js";
+import { type SignalRecord, type CliHealth, type HealthVerdict } from "./healthrecord.js";
+export interface HealthRollup {
+    /** The worst verdict on the board — what a badge shows. */
+    verdict: HealthVerdict;
+    broken: CliSignalId[];
+    degraded: CliSignalId[];
+    unknown: CliSignalId[];
+    /** One sentence per unhealthy signal, worst first. */
+    lines: string[];
+    version: string | null;
+}
+/** Signals that are not healthy, worst first — the list a sheet renders and the
+ *  list a notification is cut from. `unknown` is included: a probe nobody has
+ *  been able to run is a thing to say, just not a thing to alarm on. */
+export declare function unhealthySignals(health: CliHealth, now: number): SignalRecord[];
+/**
+ * The whole board as one answer.
+ *
+ * `unknown` never drags the rollup down past a healthy signal, and that is a
+ * deliberate call: several of these are exercised rarely, so a badge that goes
+ * grey whenever one of them has not fired today is a badge that is always grey,
+ * i.e. one nobody reads (see the argument on `DEGRADED_MISSES`). The unknown
+ * signals are still LISTED — they are just not an alarm.
+ */
+export declare function healthRollup(health: CliHealth, now: number): HealthRollup;
+/**
+ * Sanitize a record that came off disk or off the wire.
+ *
+ * Same posture as `cleanBudget` and `cleanIntentRow`: a stored file is not a
+ * trusted value. Unknown signal ids are dropped (a signal deleted from the
+ * catalog must not keep occupying a row), windows are re-capped, and every
+ * number is coerced — a hand-edited `misses: 9999` would otherwise pin a
+ * permanent `broken` with no way back through the UI.
+ */
+export declare function cleanHealth(raw: unknown): CliHealth;

package/node_modules/@waterplane/shared/dist/clihealth/healthrollup.js

@@ -0,0 +1,123 @@
+// Cut from clihealth.ts (move only): the rollup and the read off disk
+// The one door stays `./clihealth.js`; this slice imports its siblings directly, never the barrel.
+import { VIA_CAP } from "./healththresholds.js";
+import { CLI_SIGNALS, thresholdsFor } from "./healthcatalog.js";
+import { emptyHealth, redactSample, signalVerdict, healthSentence } from "./healthrecord.js";
+/** Signals that are not healthy, worst first — the list a sheet renders and the
+ *  list a notification is cut from. `unknown` is included: a probe nobody has
+ *  been able to run is a thing to say, just not a thing to alarm on. */
+export function unhealthySignals(health, now) {
+    const rank = { broken: 0, degraded: 1, unknown: 2, healthy: 3 };
+    return Object.values(health.signals)
+        .filter((s) => signalVerdict(s, now).verdict !== "healthy")
+        .sort((a, b) => rank[signalVerdict(a, now).verdict] - rank[signalVerdict(b, now).verdict]);
+}
+/**
+ * The whole board as one answer.
+ *
+ * `unknown` never drags the rollup down past a healthy signal, and that is a
+ * deliberate call: several of these are exercised rarely, so a badge that goes
+ * grey whenever one of them has not fired today is a badge that is always grey,
+ * i.e. one nobody reads (see the argument on `DEGRADED_MISSES`). The unknown
+ * signals are still LISTED — they are just not an alarm.
+ */
+export function healthRollup(health, now) {
+    const broken = [];
+    const degraded = [];
+    const unknown = [];
+    let anyHealthy = false;
+    for (const s of Object.values(health.signals)) {
+        const v = signalVerdict(s, now).verdict;
+        if (v === "broken")
+            broken.push(s.id);
+        else if (v === "degraded")
+            degraded.push(s.id);
+        else if (v === "unknown")
+            unknown.push(s.id);
+        else
+            anyHealthy = true;
+    }
+    const verdict = broken.length
+        ? "broken"
+        : degraded.length
+            ? "degraded"
+            : anyHealthy
+                ? "healthy"
+                : "unknown";
+    return {
+        verdict,
+        broken,
+        degraded,
+        unknown,
+        lines: unhealthySignals(health, now)
+            .filter((s) => signalVerdict(s, now).verdict !== "unknown")
+            .map((s) => healthSentence(s, now)),
+        version: health.version,
+    };
+}
+// ── Off disk ────────────────────────────────────────────────────────────
+/**
+ * Sanitize a record that came off disk or off the wire.
+ *
+ * Same posture as `cleanBudget` and `cleanIntentRow`: a stored file is not a
+ * trusted value. Unknown signal ids are dropped (a signal deleted from the
+ * catalog must not keep occupying a row), windows are re-capped, and every
+ * number is coerced — a hand-edited `misses: 9999` would otherwise pin a
+ * permanent `broken` with no way back through the UI.
+ */
+export function cleanHealth(raw) {
+    const r = (raw ?? {});
+    const out = emptyHealth();
+    out.version = typeof r.version === "string" && r.version ? r.version.slice(0, 40) : null;
+    out.versionSeenAt = num(r.versionSeenAt);
+    if (num(r.versionChangedAt) != null)
+        out.versionChangedAt = num(r.versionChangedAt);
+    const sigs = (r.signals ?? {});
+    for (const spec of CLI_SIGNALS) {
+        const s = sigs[spec.id];
+        if (!s || typeof s !== "object")
+            continue;
+        const th = thresholdsFor(spec.id);
+        const window = Array.isArray(s.window)
+            ? s.window
+                .filter((o) => !!o && typeof o === "object" && Number.isFinite(o.at))
+                .map((o) => ({ at: Number(o.at), ok: o.ok === true, ...(o.fallback ? { fallback: true } : {}) }))
+                .slice(-th.rateWindow)
+            : [];
+        const rec = {
+            id: spec.id,
+            version: typeof s.version === "string" && s.version ? s.version.slice(0, 40) : null,
+            lastGoodAt: num(s.lastGoodAt),
+            lastMissAt: num(s.lastMissAt),
+            misses: Math.max(0, Math.min(9_999, Math.round(Number(s.misses) || 0))),
+            missStreakSince: num(s.missStreakSince),
+            window,
+            totalGood: Math.max(0, Math.round(Number(s.totalGood) || 0)),
+            totalMiss: Math.max(0, Math.round(Number(s.totalMiss) || 0)),
+        };
+        if (num(s.lastFallbackAt) != null)
+            rec.lastFallbackAt = num(s.lastFallbackAt);
+        if (typeof s.via === "string" && s.via)
+            rec.via = s.via.slice(0, VIA_CAP);
+        // Re-redacted on the way in: the file is hand-editable, and a sample that
+        // was pasted in by hand has never been through `observe`.
+        if (typeof s.sample === "string" && s.sample)
+            rec.sample = redactSample(s.sample);
+        if (num(s.sampleAt) != null)
+            rec.sampleAt = num(s.sampleAt);
+        if (typeof s.priorVersion === "string" && s.priorVersion)
+            rec.priorVersion = s.priorVersion.slice(0, 40);
+        if (num(s.clearedAt) != null)
+            rec.clearedAt = num(s.clearedAt);
+        if (s.priorVerdict && ["healthy", "degraded", "broken", "unknown"].includes(s.priorVerdict)) {
+            rec.priorVerdict = s.priorVerdict;
+        }
+        out.signals[spec.id] = rec;
+    }
+    return out;
+}
+function num(v) {
+    const n = Number(v);
+    return Number.isFinite(n) && n > 0 ? n : null;
+}
+//# sourceMappingURL=healthrollup.js.map

package/node_modules/@waterplane/shared/dist/clihealth/healthrollup.js.map

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

package/node_modules/@waterplane/shared/dist/clihealth/healththresholds.d.ts

@@ -0,0 +1,101 @@
+/**
+ * Consecutive misses before a signal reads `degraded`.
+ *
+ * Two, not one. Each of these misses is already narrow and already
+ * user-visible by construction — the host records one only where the app
+ * actually lost something (a question box that never reached the phone, a
+ * delivery it could not confirm), not on every failed regex of a detector that
+ * runs twice a second. But one miss is still a moment: a screen captured
+ * mid-repaint, a session two seconds into booting, a log file that appears
+ * 200 ms late. Two in a row is a pattern.
+ */
+export declare const DEGRADED_MISSES = 2;
+/**
+ * Consecutive misses before a signal reads `broken`.
+ *
+ * Five. A heuristic that has failed five times running against five separate
+ * inputs is not having a bad moment — nothing in this app retries a heuristic
+ * five times for one input — and `broken` is the word that should send somebody
+ * to look at the regex.
+ */
+export declare const BROKEN_MISSES = 5;
+/**
+ * Observations kept for the rolling rate, per signal.
+ *
+ * COUNT-based rather than time-based, and the reason is the shape of the
+ * traffic: a fan-out fires twenty deliveries in a minute and a quiet afternoon
+ * fires two in eight hours. Any fixed time window is therefore either empty
+ * (and says nothing when it matters) or enormous (and averages Monday into
+ * Wednesday). "Of the last twenty deliveries, how many were confirmed?" is the
+ * question a human actually asks, and it is count-shaped.
+ *
+ * Twenty, because the failure this exists to catch was 22%: at a window of 20
+ * that is four or five bad rows, which trips inside one working session, while
+ * still being wide enough that two bad deliveries in a row (a laptop that
+ * slept, a session still booting) do not.
+ */
+export declare const RATE_WINDOW = 20;
+/**
+ * Fewest observations before a rate is allowed to mean anything.
+ *
+ * One miss out of two is 50% and is not a fact about anything. Below this the
+ * rate is reported as `null` and the verdict falls back to the streak rules —
+ * never to `healthy` on the strength of a rate nobody has enough samples for.
+ */
+export declare const RATE_MIN_SAMPLES = 8;
+/**
+ * Miss fraction at which a rate reads `degraded` — one in five.
+ *
+ * Set at or below the level that already happened: the measured week ran at
+ * 22%, undetected. An alarm calibrated above the failure it was created by is
+ * a decoration. Below one in five, an integration that scrapes a terminal is
+ * doing roughly what it was designed to do and the app's own recovery paths
+ * (`settle.ts`, `opendeliveries.ts`) absorb the rest.
+ */
+export declare const RATE_DEGRADED = 0.2;
+/** Miss fraction at which a rate reads `broken` — half of everything. At this
+ *  point the fallback IS the code path, and calling that "degraded" understates
+ *  it: the primary has stopped working and nobody has said so. */
+export declare const RATE_BROKEN = 0.5;
+/**
+ * How old an observation may be and still count toward the rate.
+ *
+ * Twelve hours. A rate is a claim about the state of the integration NOW; long
+ * enough that this morning's fan-out still informs this afternoon's screen,
+ * short enough that a bad Monday can never be the reason Wednesday is red.
+ * Aged-out observations still count for `lastGoodAt`/`lastMissAt` — they are
+ * dropped from the RATE, not from the history.
+ */
+export declare const RATE_MAX_AGE_MS: number;
+/**
+ * How long a signal keeps its verdict once nothing at all is observed.
+ *
+ * A day. These paths are exercised many times a day when they are exercised at
+ * all, so silence for a whole day means the path was not TAKEN — not that it
+ * was fixed. Going quiet therefore returns a signal to `unknown`, which is a
+ * third thing: not green, not red, "I have not been able to check". Without
+ * this a single bad afternoon three weeks ago leaves a permanent red mark, and
+ * a permanent mark is one nobody reads.
+ *
+ * Overridden per signal for the ones that are legitimately rare (a usage block
+ * can be weeks apart) — see `CLI_SIGNALS`.
+ */
+export declare const SIGNAL_FORGET_MS: number;
+/** Characters of a captured sample that are kept. Long enough to hold the row a
+ *  matcher was matching against plus its neighbours; short enough that two
+ *  hundred persisted signals stay a small file. */
+export declare const SAMPLE_CAP = 240;
+/** Characters of a fallback label. It is a literal from the call site, never
+ *  data — the cap is for a call site that forgets that. */
+export declare const VIA_CAP = 60;
+export interface HealthThresholds {
+    degradedMisses: number;
+    brokenMisses: number;
+    rateWindow: number;
+    rateMinSamples: number;
+    rateDegraded: number;
+    rateBroken: number;
+    rateMaxAgeMs: number;
+    forgetMs: number;
+}
+export declare const DEFAULT_THRESHOLDS: HealthThresholds;