Files
HealthLog/src/__tests__/recurrence-course-anchor-guard.test.ts
T
Marc-André Bombeck 5720b70e8e test(guards): drop the removed chip ledger from the course-anchor builders
The cadence chips no longer build a recurrence context of their own; they tally the compliance ledger, whose adapter is already on the list.
2026-10-20 05:33:21 +02:00

123 lines
4.2 KiB
TypeScript

/**
* v1.40 (#1024) — the course rule for a rolling anchor is opt-in.
*
* An intake whose next rolling dose falls before `startsOn` belongs to an
* earlier medication course and must not anchor the current one. That rule
* is only right where `startsOn` IS a course start. A measurement or booster
* reminder passes its anchor date in the same field, and the rule once made a
* booster fourteen years overdue come due "later today". So the rule applies
* only when the context declares `rollingAnchor: "courseStart"`.
*
* This guard enumerates every place in `src` that builds a
* `RecurrenceContext` literal and holds two lists against it: every
* medication builder declares the course start, every other builder does
* not. A new builder lands in neither list and fails until someone decides
* which it is. The scan asserts a floor on what it found, so a matcher that
* stopped matching fails instead of agreeing with an empty tree.
*
* Limit, stated: a literal passed straight to the engine without the
* `RecurrenceContext` annotation is invisible here. Every medication path
* today goes through one of the annotated builders below.
*/
import { readdirSync, readFileSync } from "node:fs";
import { join, relative, resolve } from "node:path";
import { describe, expect, it } from "vitest";
const SRC = resolve(__dirname, "..");
const ROOT = resolve(SRC, "..");
/** Medication builders: `startsOn` is a course start. */
const MEDICATION_BUILDERS = [
"src/lib/analytics/compliance/adapters.ts",
"src/lib/medications/scheduling/cadence.ts",
"src/lib/medications/scheduling/worker-helpers.ts",
];
/** Builders whose `startsOn` is an anchor date, never a course start. */
const NON_MEDICATION_BUILDERS = ["src/lib/measurement-reminders/scheduling.ts"];
const DECLARATION =
/(\)\s*:\s*RecurrenceContext\s*\{|:\s*RecurrenceContext\s*=\s*\{)/g;
function sourceFiles(dir: string): string[] {
return readdirSync(dir, { withFileTypes: true }).flatMap((entry) => {
const full = join(dir, entry.name);
if (entry.isDirectory()) {
return entry.name === "generated" || entry.name === "__tests__"
? []
: sourceFiles(full);
}
return /\.tsx?$/.test(entry.name) ? [full] : [];
});
}
/** The body of the object literal (or function body) opened at `open`. */
function blockAt(text: string, open: number): string {
let depth = 0;
for (let i = open; i < text.length; i += 1) {
if (text[i] === "{") depth += 1;
if (text[i] === "}") {
depth -= 1;
if (depth === 0) return text.slice(open, i + 1);
}
}
return text.slice(open);
}
interface Builder {
file: string;
declaresCourseStart: boolean;
}
function builders(): Builder[] {
const out: Builder[] = [];
for (const file of sourceFiles(SRC)) {
const text = readFileSync(file, "utf8");
for (const m of text.matchAll(DECLARATION)) {
const open = m.index! + m[0].length - 1;
out.push({
file: relative(ROOT, file),
declaresCourseStart: /rollingAnchor\s*:\s*"courseStart"/.test(
blockAt(text, open),
),
});
}
}
return out;
}
describe("the rolling course anchor is opt-in", () => {
it("finds the builders it judges (no vacuous pass)", () => {
const found = builders();
expect(found.length).toBeGreaterThanOrEqual(5);
// The matcher sees an annotated literal and a typed return.
expect([
...`const c: RecurrenceContext = { a: 1 };\nfunction f(): RecurrenceContext {\n return {};\n}`.matchAll(
DECLARATION,
),
]).toHaveLength(2);
});
it("puts every builder on exactly one of the two lists", () => {
const files = [...new Set(builders().map((b) => b.file))].sort();
expect(files).toEqual(
[...MEDICATION_BUILDERS, ...NON_MEDICATION_BUILDERS].sort(),
);
});
it("has every medication builder declare the course start", () => {
const missing = builders().filter(
(b) => MEDICATION_BUILDERS.includes(b.file) && !b.declaresCourseStart,
);
expect(missing).toEqual([]);
});
it("keeps every other builder on the default (the last intake anchors)", () => {
const declaring = builders().filter(
(b) => NON_MEDICATION_BUILDERS.includes(b.file) && b.declaresCourseStart,
);
expect(declaring).toEqual([]);
});
});