timmy
4cc5f4f7b1
Field finding #67: a hard/lumpy (Bristol 1-2) entry now asks a short follow-up before saving — difficult to pass, soreness, visible red blood, truly black/sticky/tarry versus dark brown, and dehydration. Every answer is user-reported and starts unanswered; nothing is inferred from the photo, and answering "dark brown" never silently escalates as black stool. A confirmed red-flag answer writes the same symptom flag manual logging already uses, so the existing deterministic escalation is the only escalation path. Mild reports get concise non-diagnostic self-care that states the photo cannot rule out bleeding, and it is withdrawn whenever a red flag is confirmed. - src/followup.js: pure follow-up contract (9 unit tests, tests/followup.test.js) - app.js + styles.css: follow-up block on the safety step for Type 1-2 entries only - tests/followup.acceptance.mjs: browser acceptance incl. that the AI suggestion surface still contains no symptom wording - CI + release builder gates: npm run test:followup, syntax checks, manifest gate - scripts/record_release_demo.mjs: records the real follow-up, mild guidance, and the black/tarry alert handoff with synthetic data
4.4 KiB
Timmy the Talking Turd — Product Brief
Promise
Your intelligent pooping pal. Timmy makes bowel tracking private, quick, funny, and useful without pretending a consumer photo is a medical diagnosis.
Product wedge
Most stool trackers are sterile diaries. Most AI-health demos overclaim. Timmy combines:
- a memorable character users actually return to;
- a ten-second Bristol-type log;
- an optional private photo attached to the entry;
- longitudinal, plain-language pattern summaries;
- a free-text Timmy conversation backed by an authenticated server-side Hermes Agent;
- fail-safe symptom escalation;
- user-owned export and one-tap deletion.
MVP we can make real now
- Installable mobile-first PWA.
- All records and optional photos remain in this browser's local storage.
- Manual Bristol type 1–7 selection with clinically grounded groupings.
- Color, urgency, discomfort, note, and urgent-symptom capture.
- Calendar/history and deterministic pattern summary.
- Photo-first capture that can send one compressed image, after explicit consent, to a configured multimodal AI provider.
- AI prefills only the visible Bristol form and color, shows confidence, and requires confirmation.
- A three-destination mobile shell with one dominant photo action and progressive disclosure.
- Smart free-text chat with local fallback and an optional fully tool-capable Hermes backend behind exact-origin authentication.
- Portable JSON export and delete-all control.
- A Timmy voice that is playful about logging and serious about red flags.
- A short user-reported follow-up after a hard/lumpy (Bristol 1–2) log: difficulty passing, soreness, visible blood, truly black/tarry versus dark brown, and hydration. Mild reports receive proportionate non-diagnostic self-care; a confirmed red flag routes into the existing deterministic escalation, and dark brown is never silently escalated as black stool.
Honest AI boundary
The assisted-analysis release uses a general-purpose multimodal model to suggest only visible form and color. It is not clinically validated, never fills urgency, discomfort, symptoms, causes, treatment, or disease, and fails closed when confidence is low. Every suggestion requires user confirmation.
A production-grade image model still needs a consented, clinically labeled dataset; validation across lighting, toilets, skin tones, medications and diets; abstention when uncertain; privacy/security review; and likely medical-regulatory counsel if disease claims are ever introduced. Timmy should never clear a food, rule out disease, or replace professional care.
Hermes chat does not expand the medical claim. Confirmed text-only ledger fields may be sent only after the user connects to the authenticated backend; photos are excluded. The browser cannot choose tools, models, providers, work directories, or internal sessions. Deterministic urgent-symptom guidance runs before chat and remains available when Hermes is offline.
Audience
- People managing constipation, diarrhea, IBS-like patterns, diet changes, medications, or a clinician-requested bowel diary.
- Parents/caregivers need a distinct consent and child-safety flow; not in this MVP.
Tone contract
- Funny: names, microcopy, streaks, and encouragement.
- Never funny: blood, black/dark-red stool, severe/constant abdominal pain, vomiting, fever, inability to pass gas, unexplained weight loss, or emergencies.
- Never say a food is "safe" from stool history.
Evidence anchors
- Continence Health Australia: Bristol types 1–2 indicate constipation, 3–4 are healthy/easy to pass, and 5–7 indicate diarrhea or urgency: https://www.continence.org.au/about-incontinence/bowel-incontinence/bristol-stool-chart/
- NHS: black/dark-red stool or bloody diarrhea warrants urgent help; non-stop or heavy bleeding is an emergency: https://www.nhs.uk/conditions/bleeding-from-the-bottom-rectal-bleeding/
- NIDDK: constipation plus rectal bleeding, blood in stool, constant abdominal pain, inability to pass gas, vomiting, fever, or unintentional weight loss warrants prompt medical care: https://www.niddk.nih.gov/health-information/digestive-diseases/constipation/symptoms-causes
Success metrics
- Median log completion under 20 seconds.
- Seven-day retention and logs per active user.
- Export completion and deletion reliability.
- Zero diagnostic or food-clearance claims.
- Red-flag flow always interrupts the playful UI with unambiguous action guidance.