@grove-dev/core 0.12.0 → 0.14.0

package/dist/github-cache.js

@@ -0,0 +1,460 @@
+import { mkdir, readdir, readFile, writeFile } from 'node:fs/promises';
+import { basename, join, resolve } from 'node:path';
+import { parseDocument, parse as parseYaml } from 'yaml';
+import { z } from 'zod';
+import { DAY_MS } from './health-thresholds.js';
+/**
+ * The GitHub sync cache: one JSON file per record, owned by
+ * `grove sync github`.
+ *
+ * Records (`paths.recordsDir`) belong to curators and
+ * `paths.decisions` to reviewers. What the sync bot observes on GitHub
+ * — repository metadata, the derived health block, when it last
+ * succeeded and what went wrong since — lives here instead, so the
+ * three layers never write into each other and a sync PR only ever
+ * touches this directory.
+ *
+ * Every reader (build, validate, cleanup, README) resolves a record's
+ * `github` / `health` through {@link resolveRecordGithub}, with
+ * precedence cache > inline (legacy) > `paths.health`.
+ */
+export const GITHUB_CACHE_SCHEMA_VERSION = 1;
+/** How many failed or partial fetches a cache entry remembers. */
+export const GITHUB_CACHE_MAX_FAILURES = 5;
+/** Default for `sync.github.maxAgeDays`: older successful syncs are stale. */
+export const GITHUB_SYNC_MAX_AGE_DAYS = 14;
+/** `staleReason` of a health block resolved from a stale cache entry. */
+export const SYNC_STALE_REASON = 'sync_stale';
+const cacheSourceSchema = z.enum(['api', 'html']);
+const githubCacheFailureSchema = z.object({
+    at: z.string(),
+    source: cacheSourceSchema,
+    reason: z.string(),
+});
+export const githubCacheEntrySchema = z.object({
+    schemaVersion: z.literal(GITHUB_CACHE_SCHEMA_VERSION),
+    slug: z.string().min(1),
+    repoUrl: z.string().optional(),
+    /** Which fetch path delivered the data currently in `github`. */
+    source: cacheSourceSchema.optional(),
+    /** When the GitHub API last delivered a full refresh. Never moved by a failure or HTML fallback. */
+    lastSuccessAt: z.string().nullable().default(null),
+    /** Most recent failed fetches, oldest first, capped at {@link GITHUB_CACHE_MAX_FAILURES}. */
+    partialFailures: z.array(githubCacheFailureSchema).default([]),
+    /** Repository description as GitHub reports it. Not merged into the record. */
+    sourceDescription: z.string().optional(),
+    github: z.record(z.string(), z.unknown()).optional(),
+    health: z.record(z.string(), z.unknown()).optional(),
+});
+/**
+ * Absolute directory of the GitHub sync cache for a project. Falls
+ * back to the schema default for configs built by hand rather than
+ * through `defineConfig` / `loadConfig`.
+ */
+export function githubCacheDir(config, cwd = process.cwd()) {
+    return resolve(cwd, config.paths.githubCache ?? 'data/cache/github');
+}
+/**
+ * Read every `<slug>.json` under `paths.githubCache`. A missing
+ * directory is an empty cache; an unreadable file is reported in
+ * `errors` and left out of `entries`, so readers fall back to inline
+ * data for that record instead of failing the build.
+ */
+export async function loadGithubCache(config, cwd = process.cwd()) {
+    const dir = githubCacheDir(config, cwd);
+    const entries = new Map();
+    const errors = [];
+    const files = (await readdir(dir).catch(() => []))
+        .filter((file) => file.endsWith('.json'))
+        .sort();
+    for (const file of files) {
+        const slug = basename(file, '.json');
+        try {
+            const entry = githubCacheEntrySchema.parse(JSON.parse(await readFile(join(dir, file), 'utf8')));
+            if (entry.slug !== slug) {
+                errors.push({ file, message: `slug "${entry.slug}" does not match the file name` });
+                continue;
+            }
+            entries.set(slug, entry);
+        }
+        catch (err) {
+            const message = err instanceof z.ZodError
+                ? err.issues
+                    .map((issue) => `${issue.path.join('.') || '(root)'} ${issue.message}`)
+                    .join('; ')
+                : err.message;
+            errors.push({ file, message });
+        }
+    }
+    return { dir, entries, errors };
+}
+/** Freshness options from a project config, for {@link resolveRecordGithub}. */
+export function githubSyncFreshnessOptions(config) {
+    return { maxAgeDays: config.sync?.github?.maxAgeDays ?? GITHUB_SYNC_MAX_AGE_DAYS };
+}
+function day(iso) {
+    return iso.slice(0, 10);
+}
+/**
+ * Whether a cache entry's data can still be presented as current.
+ *
+ * A failed or partial sync keeps the previous values rather than
+ * blanking them, so the entry alone does not say whether they are
+ * fresh. It is stale when the newest `partialFailures[].at` is later
+ * than `lastSuccessAt`, when there is no `lastSuccessAt`, or when
+ * `lastSuccessAt` is older than `maxAgeDays`.
+ */
+export function githubSyncFreshness(entry, options = {}) {
+    const now = options.now ?? Date.now();
+    const maxAgeDays = options.maxAgeDays ?? GITHUB_SYNC_MAX_AGE_DAYS;
+    const success = entry.lastSuccessAt ? Date.parse(entry.lastSuccessAt) : Number.NaN;
+    const newestFailure = entry.partialFailures.reduce((newest, failure) => {
+        const at = Date.parse(failure.at);
+        if (Number.isNaN(at) || (newest && newest.at >= at))
+            return newest;
+        return { at, reason: failure.reason };
+    }, undefined);
+    if (newestFailure && (Number.isNaN(success) || newestFailure.at > success)) {
+        const since = Number.isNaN(success)
+            ? 'no successful sync on record'
+            : `last success ${day(entry.lastSuccessAt)}`;
+        return {
+            stale: true,
+            cause: 'failed_since_success',
+            detail: `GitHub sync failed on ${day(new Date(newestFailure.at).toISOString())} (${newestFailure.reason}); ${since}`,
+        };
+    }
+    if (Number.isNaN(success)) {
+        return {
+            stale: true,
+            cause: 'never_succeeded',
+            detail: 'GitHub sync has never completed a full API refresh for this record',
+        };
+    }
+    const ageDays = (now - success) / DAY_MS;
+    if (ageDays > maxAgeDays) {
+        return {
+            stale: true,
+            cause: 'too_old',
+            detail: `GitHub sync last succeeded ${Math.floor(ageDays)} days ago (${day(entry.lastSuccessAt)}), older than ${maxAgeDays} days`,
+        };
+    }
+    return { stale: false };
+}
+/**
+ * The health block to present for a stale cache entry: `status:
+ * unknown`, `staleReason: sync_stale`, low confidence, with the stale
+ * detail and the last synced status in `reasons`. Visibility and tier
+ * are kept — a sync outage must not hide or promote records.
+ */
+function staleSyncHealth(health, detail) {
+    const previous = typeof health.status === 'string' ? health.status : 'unknown';
+    return {
+        ...health,
+        status: 'unknown',
+        staleReason: SYNC_STALE_REASON,
+        confidence: 'low',
+        cleanupCandidate: false,
+        reasons: [detail, `Last synced status: ${previous}`],
+    };
+}
+function asObject(value) {
+    return value && typeof value === 'object' && !Array.isArray(value)
+        ? value
+        : undefined;
+}
+function sameInstant(a, b) {
+    if (typeof a === 'string' && typeof b === 'string') {
+        const ta = Date.parse(a);
+        const tb = Date.parse(b);
+        if (!Number.isNaN(ta) && !Number.isNaN(tb))
+            return ta === tb;
+    }
+    return a === b;
+}
+/** The observable GitHub signals a reader would show; sync bookkeeping is ignored. */
+function githubSignals(github) {
+    const repository = asObject(github.repository) ?? {};
+    return {
+        stars: repository.stargazers_count ?? github.stars,
+        forks: repository.forks_count ?? github.forks,
+        pushed_at: repository.pushed_at ?? github.pushedAt,
+        archived: repository.archived ?? github.archived,
+        license: asObject(repository.license)?.spdx_id ?? github.license,
+    };
+}
+const HEALTH_SIGNALS = ['status', 'tier', 'visibility'];
+function describe(value) {
+    return value === undefined ? 'unset' : String(value);
+}
+/**
+ * Field-level differences between a record's inline `github` /
+ * `health` and its cache entry. Only fields both sides know are
+ * compared — a value missing on one side is not a disagreement.
+ */
+export function githubCacheConflicts(record, entry) {
+    const conflicts = [];
+    if (!entry)
+        return conflicts;
+    const inlineGithub = asObject(record.github);
+    if (inlineGithub && entry.github) {
+        const inline = githubSignals(inlineGithub);
+        const cached = githubSignals(entry.github);
+        for (const field of Object.keys(inline)) {
+            const a = inline[field];
+            const b = cached[field];
+            if (a === undefined || a === null || b === undefined || b === null)
+                continue;
+            const equal = field === 'pushed_at' ? sameInstant(a, b) : a === b;
+            if (!equal)
+                conflicts.push(`github ${field} ${describe(a)} (inline) vs ${describe(b)} (cache)`);
+        }
+    }
+    const inlineHealth = asObject(record.health);
+    if (inlineHealth && entry.health) {
+        for (const field of HEALTH_SIGNALS) {
+            const a = inlineHealth[field];
+            const b = entry.health[field];
+            if (a === undefined || b === undefined || a === b)
+                continue;
+            conflicts.push(`health ${field} ${describe(a)} (inline) vs ${describe(b)} (cache)`);
+        }
+    }
+    return conflicts;
+}
+/**
+ * Resolve a raw record's `github` and `health` blocks: the cache entry
+ * wins for each block it carries, the record's own inline block is the
+ * legacy fallback. The input is not mutated.
+ *
+ * With `freshness`, a cached health block from a stale entry (see
+ * {@link githubSyncFreshness}) resolves as `status: unknown` with
+ * `staleReason: sync_stale`; the cache file itself keeps the old
+ * values as evidence. Every Grove reader passes it.
+ */
+export function resolveRecordGithub(record, entry, freshness) {
+    const out = { ...record };
+    let github = record.github === undefined ? 'none' : 'inline';
+    let health = record.health === undefined ? 'none' : 'inline';
+    let syncStale;
+    if (entry?.github) {
+        out.github = entry.github;
+        github = 'cache';
+    }
+    if (entry?.health) {
+        out.health = entry.health;
+        health = 'cache';
+        const fresh = freshness ? githubSyncFreshness(entry, freshness) : undefined;
+        if (fresh?.stale) {
+            syncStale = fresh;
+            out.health = staleSyncHealth(entry.health, fresh.detail);
+        }
+    }
+    return {
+        record: out,
+        github,
+        health,
+        conflicts: githubCacheConflicts(record, entry),
+        ...(syncStale ? { syncStale } : {}),
+    };
+}
+// ── Writing ────────────────────────────────────────────────────────
+const ENTRY_KEY_ORDER = [
+    'schemaVersion',
+    'slug',
+    'repoUrl',
+    'source',
+    'lastSuccessAt',
+    'partialFailures',
+    'sourceDescription',
+    'github',
+    'health',
+];
+/**
+ * Serialize a cache entry: fixed top-level key order, two-space
+ * indent, trailing newline. Nested blocks keep the order sync builds
+ * them in, so re-running sync on unchanged data rewrites the same bytes
+ * apart from its timestamps.
+ */
+export function serializeGithubCacheEntry(entry) {
+    const ordered = {};
+    for (const key of ENTRY_KEY_ORDER) {
+        if (entry[key] !== undefined)
+            ordered[key] = entry[key];
+    }
+    return `${JSON.stringify(ordered, null, 2)}\n`;
+}
+/**
+ * Write one cache entry to `<dir>/<slug>.json`. Returns false when the
+ * file already held exactly these bytes and was left alone.
+ */
+export async function writeGithubCacheEntry(dir, entry) {
+    const path = join(dir, `${entry.slug}.json`);
+    const text = serializeGithubCacheEntry(entry);
+    const existing = await readFile(path, 'utf8').catch(() => undefined);
+    if (existing === text)
+        return false;
+    await mkdir(dir, { recursive: true });
+    await writeFile(path, text, 'utf8');
+    return true;
+}
+/**
+ * Fold one sync attempt into the previous cache entry.
+ *
+ * - An API refresh replaces `github` (and `health` when given) and
+ *   moves `lastSuccessAt`.
+ * - An HTML fallback replaces `github` but not `lastSuccessAt`: it is a
+ *   partial refresh, and the API failure is recorded.
+ * - A failure keeps every previous value and only appends to
+ *   `partialFailures`, so stale data is never presented as fresh —
+ *   `lastSuccessAt` older than the newest failure says so.
+ */
+export function nextGithubCacheEntry(previous, attempt) {
+    const base = previous ?? {
+        schemaVersion: GITHUB_CACHE_SCHEMA_VERSION,
+        slug: attempt.slug,
+        lastSuccessAt: null,
+        partialFailures: [],
+    };
+    const partialFailures = [
+        ...base.partialFailures,
+        ...attempt.failures.map((failure) => ({ at: attempt.at, ...failure })),
+    ].slice(-GITHUB_CACHE_MAX_FAILURES);
+    const next = {
+        ...base,
+        schemaVersion: GITHUB_CACHE_SCHEMA_VERSION,
+        slug: attempt.slug,
+        ...(attempt.repoUrl ? { repoUrl: attempt.repoUrl } : {}),
+        partialFailures,
+    };
+    if (!attempt.source)
+        return next;
+    next.source = attempt.source;
+    if (attempt.github)
+        next.github = attempt.github;
+    if (attempt.health)
+        next.health = attempt.health;
+    if (attempt.sourceDescription)
+        next.sourceDescription = attempt.sourceDescription;
+    if (attempt.source === 'api')
+        next.lastSuccessAt = attempt.at;
+    return next;
+}
+/**
+ * Build a cache entry from the `github` / `health` blocks a record
+ * still carries inline (written by Grove ≤ 0.12). `lastSuccessAt` is
+ * only set when the inline block records an API sync — an HTML-only
+ * sync was never a full refresh.
+ */
+export function seedGithubCacheEntry(slug, record) {
+    const github = asObject(record.github);
+    const health = asObject(record.health);
+    const sync = asObject(github?.sync);
+    const source = cacheSourceSchema.safeParse(sync?.source);
+    const links = asObject(record.links);
+    const repoUrl = typeof record.repoUrl === 'string'
+        ? record.repoUrl
+        : typeof links?.github === 'string'
+            ? links.github
+            : undefined;
+    return {
+        schemaVersion: GITHUB_CACHE_SCHEMA_VERSION,
+        slug,
+        ...(repoUrl ? { repoUrl } : {}),
+        ...(source.success ? { source: source.data } : {}),
+        lastSuccessAt: source.success && source.data === 'api' && typeof sync?.syncedAt === 'string'
+            ? sync.syncedAt
+            : null,
+        partialFailures: [],
+        ...(github ? { github } : {}),
+        ...(health ? { health } : {}),
+    };
+}
+// ── Migration ──────────────────────────────────────────────────────
+const MIGRATED_KEYS = ['github', 'health'];
+const TOP_LEVEL_KEY = /^(?:"([^"]+)"|'([^']+)'|([^\s#:][^:]*?))\s*:(?:\s|$)/;
+function withoutKeys(value, keys) {
+    const obj = asObject(value);
+    if (!obj)
+        return value;
+    const out = { ...obj };
+    for (const key of keys)
+        delete out[key];
+    return out;
+}
+function sameData(a, b) {
+    return JSON.stringify(a) === JSON.stringify(b);
+}
+/**
+ * Remove top-level mapping keys from a YAML document's text, leaving
+ * every other byte alone: a block runs from its key line through the
+ * indented (or blank) lines that follow it. Comments at column 0 belong
+ * to whatever comes next and are kept. Falls back to a comment-
+ * preserving document edit if the line cut would change any other
+ * value.
+ */
+export function removeTopLevelYamlKeys(text, keys) {
+    const lines = text.split('\n');
+    const kept = [];
+    let dropping = false;
+    for (let i = 0; i < lines.length; i += 1) {
+        const line = lines[i] ?? '';
+        const atColumnZero = line.length > 0 && !/^\s/.test(line);
+        if (atColumnZero) {
+            const match = TOP_LEVEL_KEY.exec(line);
+            const key = match ? (match[1] ?? match[2] ?? match[3]) : undefined;
+            dropping = key !== undefined && keys.includes(key);
+            if (dropping)
+                continue;
+            kept.push(line);
+            continue;
+        }
+        if (dropping) {
+            if (line.trim() !== '')
+                continue;
+            // A blank line inside a dropped block goes with it only when the
+            // block continues after it.
+            const nextContent = lines.slice(i + 1).find((next) => next.trim() !== '');
+            if (nextContent !== undefined && /^\s/.test(nextContent))
+                continue;
+            dropping = false;
+        }
+        kept.push(line);
+    }
+    const cut = kept.join('\n');
+    const expected = withoutKeys(parseYaml(text, { schema: 'core' }), keys);
+    if (sameData(parseYaml(cut, { schema: 'core' }), expected))
+        return cut;
+    const doc = parseDocument(text, { schema: 'core' });
+    for (const key of keys)
+        doc.delete(key);
+    return doc.toString({ lineWidth: 100, singleQuote: false, defaultStringType: 'PLAIN' });
+}
+/**
+ * Codemod one record: move its inline `github` / `health` into a cache
+ * entry and strip them from the YAML text. An existing cache entry is
+ * newer than the inline copy, so it wins; inline blocks only fill what
+ * it lacks.
+ */
+export function migrateRecordGithub(slug, text, existing) {
+    const raw = asObject(parseYaml(text, { schema: 'core' })) ?? {};
+    const moved = MIGRATED_KEYS.filter((key) => raw[key] !== undefined);
+    if (moved.length === 0)
+        return { text, moved, conflicts: [] };
+    const seeded = seedGithubCacheEntry(slug, raw);
+    const entry = existing
+        ? {
+            ...existing,
+            ...(existing.repoUrl || !seeded.repoUrl ? {} : { repoUrl: seeded.repoUrl }),
+            ...(existing.github || !seeded.github ? {} : { github: seeded.github }),
+            ...(existing.health || !seeded.health ? {} : { health: seeded.health }),
+        }
+        : seeded;
+    return {
+        text: removeTopLevelYamlKeys(text, moved),
+        entry,
+        moved,
+        conflicts: githubCacheConflicts(raw, existing),
+    };
+}
+//# sourceMappingURL=github-cache.js.map

package/dist/github-cache.js.map

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

package/dist/health-thresholds.d.ts

@@ -0,0 +1,39 @@
+/**
+ * The one table of push-age cutoffs every Grove health classifier
+ * reads, so "stale" means the same thing in `classifyHealth`,
+ * `classifyRepositoryHealth` and the docs.
+ *
+ * The signal is GitHub's `pushed_at`: the last time anything was
+ * pushed to any branch. It is not commit activity, and old pushes do
+ * not make a project dead — so the reasons say "push", and every band
+ * past `active` means "a person should look", not a verdict.
+ */
+export declare const DAY_MS = 86400000;
+export type PushAgeBandId = 'active' | 'stale' | 'needs_review' | 'inactive';
+export interface PushAgeBand {
+    id: PushAgeBandId;
+    /** Inclusive upper bound in days since the last push. */
+    maxDays: number;
+    /** Stable machine-readable reason, `null` for the active band. */
+    staleReason: string | null;
+    /** Plain-language reason matching `staleReason`. */
+    reason: string;
+}
+/**
+ * Up to 6 months → active, 6–18 months → stale, 18–24 months →
+ * needs_review, over 24 months → inactive. Month edges are in days
+ * (183 / 548 / 730) and inclusive: a repo last pushed exactly 183 days
+ * ago is still active.
+ */
+export declare const PUSH_AGE_BANDS: readonly PushAgeBand[];
+/** Cutoffs by band id, for callers that compare one edge directly. */
+export declare const PUSH_AGE_MAX_DAYS: Readonly<Record<PushAgeBandId, number>>;
+/** A release within this many days counts as a recent release. */
+export declare const RECENT_RELEASE_WITHIN_DAYS = 365;
+/** Star count from which a repository counts as popular. */
+export declare const POPULAR_STARS = 500;
+/** Days between `value` and `now`; `Infinity` for a missing or unparseable date. */
+export declare function daysSince(value: string | null | undefined, now?: number): number;
+/** The band a push `days` ago falls in. A missing push date is `inactive`. */
+export declare function pushAgeBand(days: number): PushAgeBand;
+//# sourceMappingURL=health-thresholds.d.ts.map

package/dist/health-thresholds.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"health-thresholds.d.ts","sourceRoot":"","sources":["../src/health-thresholds.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,eAAO,MAAM,MAAM,WAAa,CAAC;AAEjC,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,OAAO,GAAG,cAAc,GAAG,UAAU,CAAC;AAE7E,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,aAAa,CAAC;IAClB,yDAAyD;IACzD,OAAO,EAAE,MAAM,CAAC;IAChB,kEAAkE;IAClE,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,oDAAoD;IACpD,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;GAKG;AACH,eAAO,MAAM,cAAc,EAAE,SAAS,WAAW,EAyBhD,CAAC;AAEF,sEAAsE;AACtE,eAAO,MAAM,iBAAiB,EAAE,QAAQ,CAAC,MAAM,CAAC,aAAa,EAAE,MAAM,CAAC,CAEpC,CAAC;AAEnC,kEAAkE;AAClE,eAAO,MAAM,0BAA0B,MAAM,CAAC;AAE9C,4DAA4D;AAC5D,eAAO,MAAM,aAAa,MAAM,CAAC;AAEjC,oFAAoF;AACpF,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAAE,GAAG,GAAE,MAAmB,GAAG,MAAM,CAK5F;AAED,8EAA8E;AAC9E,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAMrD"}

package/dist/health-thresholds.js

@@ -0,0 +1,68 @@
+/**
+ * The one table of push-age cutoffs every Grove health classifier
+ * reads, so "stale" means the same thing in `classifyHealth`,
+ * `classifyRepositoryHealth` and the docs.
+ *
+ * The signal is GitHub's `pushed_at`: the last time anything was
+ * pushed to any branch. It is not commit activity, and old pushes do
+ * not make a project dead — so the reasons say "push", and every band
+ * past `active` means "a person should look", not a verdict.
+ */
+export const DAY_MS = 86_400_000;
+/**
+ * Up to 6 months → active, 6–18 months → stale, 18–24 months →
+ * needs_review, over 24 months → inactive. Month edges are in days
+ * (183 / 548 / 730) and inclusive: a repo last pushed exactly 183 days
+ * ago is still active.
+ */
+export const PUSH_AGE_BANDS = [
+    {
+        id: 'active',
+        maxDays: 183,
+        staleReason: null,
+        reason: 'Pushed to within the last 6 months',
+    },
+    {
+        id: 'stale',
+        maxDays: 548,
+        staleReason: 'no_push_6_months',
+        reason: 'No push in the last 6 months',
+    },
+    {
+        id: 'needs_review',
+        maxDays: 730,
+        staleReason: 'no_push_18_months',
+        reason: 'No push in the last 18 months',
+    },
+    {
+        id: 'inactive',
+        maxDays: Number.POSITIVE_INFINITY,
+        staleReason: 'no_push_24_months',
+        reason: 'No push in the last 24 months',
+    },
+];
+/** Cutoffs by band id, for callers that compare one edge directly. */
+export const PUSH_AGE_MAX_DAYS = Object.fromEntries(PUSH_AGE_BANDS.map((band) => [band.id, band.maxDays]));
+/** A release within this many days counts as a recent release. */
+export const RECENT_RELEASE_WITHIN_DAYS = 365;
+/** Star count from which a repository counts as popular. */
+export const POPULAR_STARS = 500;
+/** Days between `value` and `now`; `Infinity` for a missing or unparseable date. */
+export function daysSince(value, now = Date.now()) {
+    if (!value)
+        return Number.POSITIVE_INFINITY;
+    const time = Date.parse(value);
+    if (Number.isNaN(time))
+        return Number.POSITIVE_INFINITY;
+    return (now - time) / DAY_MS;
+}
+/** The band a push `days` ago falls in. A missing push date is `inactive`. */
+export function pushAgeBand(days) {
+    for (const band of PUSH_AGE_BANDS) {
+        if (days <= band.maxDays)
+            return band;
+    }
+    // Unreachable: the last band's bound is Infinity. NaN lands here.
+    return PUSH_AGE_BANDS[PUSH_AGE_BANDS.length - 1];
+}
+//# sourceMappingURL=health-thresholds.js.map

package/dist/health-thresholds.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"health-thresholds.js","sourceRoot":"","sources":["../src/health-thresholds.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,MAAM,CAAC,MAAM,MAAM,GAAG,UAAU,CAAC;AAcjC;;;;;GAKG;AACH,MAAM,CAAC,MAAM,cAAc,GAA2B;IACpD;QACE,EAAE,EAAE,QAAQ;QACZ,OAAO,EAAE,GAAG;QACZ,WAAW,EAAE,IAAI;QACjB,MAAM,EAAE,oCAAoC;KAC7C;IACD;QACE,EAAE,EAAE,OAAO;QACX,OAAO,EAAE,GAAG;QACZ,WAAW,EAAE,kBAAkB;QAC/B,MAAM,EAAE,8BAA8B;KACvC;IACD;QACE,EAAE,EAAE,cAAc;QAClB,OAAO,EAAE,GAAG;QACZ,WAAW,EAAE,mBAAmB;QAChC,MAAM,EAAE,+BAA+B;KACxC;IACD;QACE,EAAE,EAAE,UAAU;QACd,OAAO,EAAE,MAAM,CAAC,iBAAiB;QACjC,WAAW,EAAE,mBAAmB;QAChC,MAAM,EAAE,+BAA+B;KACxC;CACF,CAAC;AAEF,sEAAsE;AACtE,MAAM,CAAC,MAAM,iBAAiB,GAA4C,MAAM,CAAC,WAAW,CAC1F,cAAc,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC,CACrB,CAAC;AAEnC,kEAAkE;AAClE,MAAM,CAAC,MAAM,0BAA0B,GAAG,GAAG,CAAC;AAE9C,4DAA4D;AAC5D,MAAM,CAAC,MAAM,aAAa,GAAG,GAAG,CAAC;AAEjC,oFAAoF;AACpF,MAAM,UAAU,SAAS,CAAC,KAAgC,EAAE,MAAc,IAAI,CAAC,GAAG,EAAE;IAClF,IAAI,CAAC,KAAK;QAAE,OAAO,MAAM,CAAC,iBAAiB,CAAC;IAC5C,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC/B,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC;QAAE,OAAO,MAAM,CAAC,iBAAiB,CAAC;IACxD,OAAO,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,MAAM,CAAC;AAC/B,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,KAAK,MAAM,IAAI,IAAI,cAAc,EAAE,CAAC;QAClC,IAAI,IAAI,IAAI,IAAI,CAAC,OAAO;YAAE,OAAO,IAAI,CAAC;IACxC,CAAC;IACD,kEAAkE;IAClE,OAAO,cAAc,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC,CAAgB,CAAC;AAClE,CAAC"}

package/dist/health.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"health.d.ts","sourceRoot":"","sources":["../src/health.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAA4B,MAAM,aAAa,CAAC;AASzF,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,cAAc,GAAG,WAAW,CA2F/E"}
+{"version":3,"file":"health.d.ts","sourceRoot":"","sources":["../src/health.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAA4B,MAAM,aAAa,CAAC;AAEzF,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,cAAc,GAAG,WAAW,CAqF/E"}