Recover the operating picture when important veterinary changes are buried across fragmented clinic data.
Canonical result: a concise operator brief — what changed, why it matters, ranked actions, record-level evidence, and explicit human-judgment flags.
Maturity: fixture-backed + internally tested + browser-verified. No live practice-management system or paid model was called.
./scripts/bootstrap
./scripts/demo # http://127.0.0.1:3454
./scripts/verifyProof: proof/report.md
Wednesday 8am records (OR board, ICU census, Harborview referrals, AR, inbox) → deterministic synthesis with documented freshness windows and conflict detection → ranked recommendations with fixture record ids → no transfers, refunds, pricing changes, schedule mutations, or client messages → the owner acknowledges flags and acts off the evidence drawers.
Not a BI warehouse, agent OS, executive assistant, CRM, or workflow state machine. It is evidence-grounded synthesis for one independent specialty clinic.
| Kind | Examples |
|---|---|
| Authoritative facts | Fixture record ids, recordedAt, typed facts (counts, balances as stored) |
| Deterministic policy | Freshness windows, noise hold-out, ranking, forbidden autonomous acts |
| Model inference | Optional PROVIDER_MODE=real-provider adapter; default is the fixture composer. Schema-invalid or ungrounded output never becomes the brief |
| Human decisions | Acknowledge a flag; any schedule, money, or client communication |
Missing, stale (older than the window), or conflicting evidence is said plainly and flagged for a human. Numbers are copied from cited records; unsupported numerical claims fail eval.
| Kind | Window | Notes |
|---|---|---|
| appointment, capacity, census | 24 hours | Current board and headcount |
| communication, referral | 72 hours | Open pipeline / inbox |
| receivable | 7 days | Open AR; clinic-wide exports older than this are stale |
| client / pet | 30 days | Master data |
| historical tag | n/a | Closed facts (completed no-shows) stay usable as provenance |
| noise | held out | Marketing and vendor pitches never outrank capacity or no-show patterns |
Lakeside Veterinary, an independent specialty referral clinic (surgery and cardiology). The owner-operator needs a morning brief because the OR is overloaded, Harborview GP no-shows are repeating, and AR sources disagree.
Record store: data/store.json after a demo run. Domain: lib/domain/. Fixtures: lib/fixtures.ts. Evaluation goldens: tests/eval/scenarios.ts.
