dosewise-home 0.1.0__tar.gz

dosewise_home-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Dosewise Home
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

dosewise_home-0.1.0/PKG-INFO

@@ -0,0 +1,103 @@
+Metadata-Version: 2.4
+Name: dosewise-home
+Version: 0.1.0
+Summary: Local-first household medication schedule and refill planner
+Author: Dosewise Home
+License-Expression: MIT
+Keywords: medication,refill,health,household,planner
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Web Environment
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: Programming Language :: Python :: 3
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# Dosewise Home
+
+Dosewise Home is a local-first household medication schedule and refill planner. Paste a simple medication cabinet CSV, then get a same-week refill queue, daily dose timeline, and pharmacist conversation prompts without creating an account or uploading private health notes.
+
+![Dosewise Home dashboard](assets/screenshots/dosewise-home.svg)
+
+## Features
+
+- Runs locally from a small Python server and browser interface.
+- Imports comma, tab, semicolon, or pipe-delimited medication rows.
+- Estimates days left and prioritizes critical, soon, scheduled, and steady refills.
+- Builds a daily dose timeline from common instruction words like morning, dinner, bedtime, and night.
+- Flags plain-language review prompts for common household issues such as grapefruit cautions, duplicate acetaminophen, blood thinner review, and stacked sleep aids.
+- Copies a concise refill brief for a caregiver, pharmacy call, or household planning note.
+
+Dosewise Home organizes information only. It does not diagnose, prescribe, or replace medical advice from a clinician or pharmacist.
+
+## Installation
+
+Python 3.10 or newer is required.
+
+```bash
+git clone https://github.com/iwaheedsattar/dosewise-home.git
+cd dosewise-home
+python3 -m venv .venv
+source .venv/bin/activate
+python -m pip install -e .
+```
+
+## Usage
+
+Start the local app:
+
+```bash
+dosewise-home
+```
+
+Open [http://127.0.0.1:8765](http://127.0.0.1:8765), paste medication rows, and select **Build plan**.
+
+Example CSV:
+
+```csv
+name,owner,strength,instructions,quantity_left,doses_per_day,refill_date,notes
+Atorvastatin,Sam,20mg,Take one tablet with dinner,12,1,2026-07-03,Avoid grapefruit
+Lisinopril,Sam,10mg,Take every morning,24,1,2026-07-20,Blood pressure
+Acetaminophen Cold,Lee,500mg,Take at bedtime if needed,4,2,2026-06-30,Cold medicine
+```
+
+A fuller sample is available at `examples/household-medications.csv`.
+
+## CSV Columns
+
+Required columns:
+
+- `name`
+- `owner`
+- `strength`
+- `instructions`
+- `quantity_left`
+- `doses_per_day`
+
+Optional columns:
+
+- `refill_date` in `YYYY-MM-DD`, `MM/DD/YYYY`, or `MM/DD/YY` format
+- `notes`
+
+## Development
+
+Run tests:
+
+```bash
+python3 -m pytest
+```
+
+Run without installing:
+
+```bash
+python3 -m dosewise_home.server
+```
+
+## Roadmap
+
+- Add printable weekly pill-box sheets.
+- Add encrypted local browser storage for recurring household lists.
+- Add optional OCR import from prescription labels.
+- Add iCalendar reminders for refill windows.
+- Package as a signed desktop application.

dosewise_home-0.1.0/README.md

@@ -0,0 +1,87 @@
+# Dosewise Home
+
+Dosewise Home is a local-first household medication schedule and refill planner. Paste a simple medication cabinet CSV, then get a same-week refill queue, daily dose timeline, and pharmacist conversation prompts without creating an account or uploading private health notes.
+
+![Dosewise Home dashboard](assets/screenshots/dosewise-home.svg)
+
+## Features
+
+- Runs locally from a small Python server and browser interface.
+- Imports comma, tab, semicolon, or pipe-delimited medication rows.
+- Estimates days left and prioritizes critical, soon, scheduled, and steady refills.
+- Builds a daily dose timeline from common instruction words like morning, dinner, bedtime, and night.
+- Flags plain-language review prompts for common household issues such as grapefruit cautions, duplicate acetaminophen, blood thinner review, and stacked sleep aids.
+- Copies a concise refill brief for a caregiver, pharmacy call, or household planning note.
+
+Dosewise Home organizes information only. It does not diagnose, prescribe, or replace medical advice from a clinician or pharmacist.
+
+## Installation
+
+Python 3.10 or newer is required.
+
+```bash
+git clone https://github.com/iwaheedsattar/dosewise-home.git
+cd dosewise-home
+python3 -m venv .venv
+source .venv/bin/activate
+python -m pip install -e .
+```
+
+## Usage
+
+Start the local app:
+
+```bash
+dosewise-home
+```
+
+Open [http://127.0.0.1:8765](http://127.0.0.1:8765), paste medication rows, and select **Build plan**.
+
+Example CSV:
+
+```csv
+name,owner,strength,instructions,quantity_left,doses_per_day,refill_date,notes
+Atorvastatin,Sam,20mg,Take one tablet with dinner,12,1,2026-07-03,Avoid grapefruit
+Lisinopril,Sam,10mg,Take every morning,24,1,2026-07-20,Blood pressure
+Acetaminophen Cold,Lee,500mg,Take at bedtime if needed,4,2,2026-06-30,Cold medicine
+```
+
+A fuller sample is available at `examples/household-medications.csv`.
+
+## CSV Columns
+
+Required columns:
+
+- `name`
+- `owner`
+- `strength`
+- `instructions`
+- `quantity_left`
+- `doses_per_day`
+
+Optional columns:
+
+- `refill_date` in `YYYY-MM-DD`, `MM/DD/YYYY`, or `MM/DD/YY` format
+- `notes`
+
+## Development
+
+Run tests:
+
+```bash
+python3 -m pytest
+```
+
+Run without installing:
+
+```bash
+python3 -m dosewise_home.server
+```
+
+## Roadmap
+
+- Add printable weekly pill-box sheets.
+- Add encrypted local browser storage for recurring household lists.
+- Add optional OCR import from prescription labels.
+- Add iCalendar reminders for refill windows.
+- Package as a signed desktop application.

dosewise_home-0.1.0/dosewise_home/__init__.py

@@ -0,0 +1,3 @@
+"""Dosewise Home local medication planning tools."""
+
+__all__ = ["planner"]

dosewise_home-0.1.0/dosewise_home/planner.py

@@ -0,0 +1,209 @@
+from __future__ import annotations
+
+from dataclasses import dataclass
+from datetime import date, datetime, time, timedelta
+import csv
+import io
+import math
+import re
+from typing import Iterable
+
+
+DOSE_TIME_HINTS = {
+    "morning": time(8, 0),
+    "breakfast": time(8, 0),
+    "noon": time(12, 0),
+    "lunch": time(12, 30),
+    "afternoon": time(15, 0),
+    "evening": time(18, 0),
+    "dinner": time(18, 30),
+    "bedtime": time(21, 30),
+    "night": time(21, 30),
+}
+
+INTERACTION_RULES = [
+    {
+        "name": "Grapefruit caution",
+        "pattern": re.compile(r"\b(grapefruit|atorvastatin|simvastatin|lovastatin)\b", re.I),
+        "message": "Grapefruit can affect several common cholesterol medicines. Confirm food guidance with the prescriber or pharmacist.",
+    },
+    {
+        "name": "Duplicate acetaminophen",
+        "pattern": re.compile(r"\b(acetaminophen|paracetamol|tylenol|cold|flu)\b", re.I),
+        "message": "Cold and flu products may contain acetaminophen. Track total daily amount to avoid accidental duplication.",
+    },
+    {
+        "name": "Blood thinner reminder",
+        "pattern": re.compile(r"\b(warfarin|apixaban|rivaroxaban|dabigatran|aspirin|ibuprofen|naproxen)\b", re.I),
+        "message": "Blood thinners and anti-inflammatory pain relievers can need extra review before combining.",
+    },
+    {
+        "name": "Sedation stack",
+        "pattern": re.compile(r"\b(diphenhydramine|benadryl|zolpidem|melatonin|sleep|nighttime)\b", re.I),
+        "message": "Sleep aids and antihistamines can compound drowsiness. Use a shared household note before nighttime doses.",
+    },
+]
+
+
+@dataclass(frozen=True)
+class Medication:
+    name: str
+    owner: str
+    strength: str
+    instructions: str
+    quantity_left: float
+    doses_per_day: float
+    refill_date: date | None
+    notes: str = ""
+
+
+@dataclass(frozen=True)
+class RefillStatus:
+    medication: Medication
+    days_left: float
+    runout_date: date | None
+    urgency: str
+    message: str
+
+
+@dataclass(frozen=True)
+class ScheduleItem:
+    at: time
+    owner: str
+    medicine: str
+    strength: str
+    instructions: str
+
+
+def parse_date(value: str | None) -> date | None:
+    if not value:
+        return None
+    value = value.strip()
+    if not value:
+        return None
+    for fmt in ("%Y-%m-%d", "%m/%d/%Y", "%m/%d/%y"):
+        try:
+            return datetime.strptime(value, fmt).date()
+        except ValueError:
+            continue
+    raise ValueError(f"Unsupported date format: {value!r}")
+
+
+def parse_medications(text: str) -> list[Medication]:
+    stream = io.StringIO(text.strip())
+    sample = stream.read(2048)
+    stream.seek(0)
+    dialect = csv.Sniffer().sniff(sample, delimiters=",\t;|") if sample else csv.excel
+    reader = csv.DictReader(stream, dialect=dialect)
+    required = {"name", "owner", "strength", "instructions", "quantity_left", "doses_per_day"}
+    missing = required - {field.strip() for field in (reader.fieldnames or [])}
+    if missing:
+        raise ValueError(f"Missing columns: {', '.join(sorted(missing))}")
+
+    rows: list[Medication] = []
+    for row in reader:
+        if not any(row.values()):
+            continue
+        rows.append(
+            Medication(
+                name=(row.get("name") or "").strip(),
+                owner=(row.get("owner") or "Household").strip(),
+                strength=(row.get("strength") or "").strip(),
+                instructions=(row.get("instructions") or "").strip(),
+                quantity_left=float((row.get("quantity_left") or "0").strip()),
+                doses_per_day=max(float((row.get("doses_per_day") or "0").strip()), 0),
+                refill_date=parse_date(row.get("refill_date")),
+                notes=(row.get("notes") or "").strip(),
+            )
+        )
+    return rows
+
+
+def estimate_refills(medications: Iterable[Medication], today: date | None = None) -> list[RefillStatus]:
+    today = today or date.today()
+    statuses: list[RefillStatus] = []
+    for med in medications:
+        if med.doses_per_day <= 0:
+            days_left = math.inf
+            runout = None
+        else:
+            days_left = med.quantity_left / med.doses_per_day
+            runout = today + timedelta(days=max(math.floor(days_left), 0))
+
+        if days_left <= 3:
+            urgency = "critical"
+            message = "Call today or move to the front of the refill queue."
+        elif days_left <= 7:
+            urgency = "soon"
+            message = "Refill this week and confirm pickup or delivery timing."
+        elif med.refill_date and med.refill_date <= today + timedelta(days=7):
+            urgency = "scheduled"
+            message = "A refill date is approaching; verify the prescription is active."
+        else:
+            urgency = "steady"
+            message = "Supply looks stable for the next week."
+
+        statuses.append(RefillStatus(med, days_left, runout, urgency, message))
+    return sorted(statuses, key=lambda item: (item.days_left, item.medication.owner, item.medication.name))
+
+
+def infer_schedule(medications: Iterable[Medication]) -> list[ScheduleItem]:
+    items: list[ScheduleItem] = []
+    for med in medications:
+        text = f"{med.instructions} {med.notes}".lower()
+        matched = [slot for key, slot in DOSE_TIME_HINTS.items() if key in text]
+        if not matched:
+            matched = default_slots(med.doses_per_day)
+        for at in sorted(set(matched)):
+            items.append(ScheduleItem(at, med.owner, med.name, med.strength, med.instructions))
+    return sorted(items, key=lambda item: (item.at, item.owner, item.medicine))
+
+
+def default_slots(doses_per_day: float) -> list[time]:
+    if doses_per_day >= 3:
+        return [time(8, 0), time(14, 0), time(21, 0)]
+    if doses_per_day >= 2:
+        return [time(8, 0), time(20, 0)]
+    return [time(9, 0)]
+
+
+def find_cautions(medications: Iterable[Medication]) -> list[dict[str, str]]:
+    haystack = "\n".join(
+        f"{med.name} {med.instructions} {med.notes}" for med in medications
+    )
+    cautions = []
+    for rule in INTERACTION_RULES:
+        if rule["pattern"].search(haystack):
+            cautions.append({"name": rule["name"], "message": rule["message"]})
+    return cautions
+
+
+def build_plan(text: str, today: date | None = None) -> dict[str, object]:
+    medications = parse_medications(text)
+    refills = estimate_refills(medications, today=today)
+    schedule = infer_schedule(medications)
+    return {
+        "medications": [med.__dict__ | {"refill_date": med.refill_date.isoformat() if med.refill_date else ""} for med in medications],
+        "refills": [
+            {
+                "name": status.medication.name,
+                "owner": status.medication.owner,
+                "days_left": None if math.isinf(status.days_left) else round(status.days_left, 1),
+                "runout_date": status.runout_date.isoformat() if status.runout_date else "",
+                "urgency": status.urgency,
+                "message": status.message,
+            }
+            for status in refills
+        ],
+        "schedule": [
+            {
+                "time": item.at.strftime("%H:%M"),
+                "owner": item.owner,
+                "medicine": item.medicine,
+                "strength": item.strength,
+                "instructions": item.instructions,
+            }
+            for item in schedule
+        ],
+        "cautions": find_cautions(medications),
+    }

dosewise_home-0.1.0/dosewise_home/server.py

@@ -0,0 +1,50 @@
+from __future__ import annotations
+
+from http.server import ThreadingHTTPServer, SimpleHTTPRequestHandler
+from pathlib import Path
+import json
+import os
+import sys
+
+from .planner import build_plan
+
+
+WEB = Path(__file__).resolve().parent / "web"
+
+
+class DosewiseHandler(SimpleHTTPRequestHandler):
+    def __init__(self, *args, **kwargs):
+        super().__init__(*args, directory=str(WEB), **kwargs)
+
+    def do_POST(self) -> None:
+        if self.path != "/api/plan":
+            self.send_error(404)
+            return
+        length = int(self.headers.get("Content-Length", "0"))
+        payload = json.loads(self.rfile.read(length) or b"{}")
+        try:
+            plan = build_plan(payload.get("medications", ""))
+            self.send_json(200, plan)
+        except Exception as exc:
+            self.send_json(400, {"error": str(exc)})
+
+    def send_json(self, status: int, payload: object) -> None:
+        body = json.dumps(payload, indent=2).encode("utf-8")
+        self.send_response(status)
+        self.send_header("Content-Type", "application/json")
+        self.send_header("Content-Length", str(len(body)))
+        self.end_headers()
+        self.wfile.write(body)
+
+
+def main(argv: list[str] | None = None) -> int:
+    argv = argv or sys.argv[1:]
+    port = int(argv[0] if argv else os.environ.get("DOSEWISE_PORT", "8765"))
+    server = ThreadingHTTPServer(("127.0.0.1", port), DosewiseHandler)
+    print(f"Dosewise Home running at http://127.0.0.1:{port}")
+    server.serve_forever()
+    return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

dosewise_home-0.1.0/dosewise_home/web/app.js

@@ -0,0 +1,110 @@
+const sample = `name,owner,strength,instructions,quantity_left,doses_per_day,refill_date,notes
+Atorvastatin,Sam,20mg,Take one tablet with dinner,12,1,2026-07-03,Avoid grapefruit
+Lisinopril,Sam,10mg,Take every morning,24,1,2026-07-20,Blood pressure
+Acetaminophen Cold,Lee,500mg,Take at bedtime if needed,4,2,2026-06-30,Cold medicine
+Vitamin D,Maya,1000 IU,Take with breakfast,45,1,2026-08-15,Weekly pill box
+Melatonin,Lee,3mg,Take at night if needed,7,1,2026-07-05,Sleep aid`;
+
+const medications = document.querySelector("#medications");
+const planButton = document.querySelector("#plan-button");
+const sampleButton = document.querySelector("#sample-button");
+const copyButton = document.querySelector("#copy-button");
+const refills = document.querySelector("#refills");
+const schedule = document.querySelector("#schedule");
+const cautions = document.querySelector("#cautions");
+const totalMeds = document.querySelector("#total-meds");
+const urgentCount = document.querySelector("#urgent-count");
+const doseCount = document.querySelector("#dose-count");
+const queueStatus = document.querySelector("#queue-status");
+
+let currentPlan = null;
+
+function esc(value) {
+  return String(value ?? "").replace(/[&<>"']/g, (char) => ({
+    "&": "&amp;",
+    "<": "&lt;",
+    ">": "&gt;",
+    '"': "&quot;",
+    "'": "&#039;",
+  })[char]);
+}
+
+function render(plan) {
+  currentPlan = plan;
+  totalMeds.textContent = plan.medications.length;
+  urgentCount.textContent = plan.refills.filter((item) => ["critical", "soon"].includes(item.urgency)).length;
+  doseCount.textContent = plan.schedule.length;
+  queueStatus.textContent = plan.refills[0]?.urgency === "critical" ? "Action needed" : "Stable";
+
+  refills.innerHTML = plan.refills.length ? plan.refills.map((item) => `
+    <article class="refill">
+      <div>
+        <div class="title">${esc(item.name)} <span class="meta">for ${esc(item.owner)}</span></div>
+        <div class="meta">${item.days_left ?? "Unknown"} days left${item.runout_date ? ` · runs out around ${esc(item.runout_date)}` : ""}</div>
+        <div class="meta">${esc(item.message)}</div>
+      </div>
+      <span class="badge ${esc(item.urgency)}">${esc(item.urgency)}</span>
+    </article>
+  `).join("") : `<div class="empty">No refill rows yet.</div>`;
+
+  schedule.innerHTML = plan.schedule.length ? plan.schedule.map((item) => `
+    <div class="timeline-row">
+      <div class="time">${esc(item.time)}</div>
+      <div class="dose">
+        <div class="title">${esc(item.medicine)} <span class="meta">${esc(item.strength)}</span></div>
+        <div class="meta">${esc(item.owner)} · ${esc(item.instructions)}</div>
+      </div>
+    </div>
+  `).join("") : `<div class="empty">No schedule could be inferred from the current rows.</div>`;
+
+  cautions.innerHTML = plan.cautions.length ? plan.cautions.map((item) => `
+    <article class="caution">
+      <div>
+        <div class="title">${esc(item.name)}</div>
+        <div class="meta">${esc(item.message)}</div>
+      </div>
+      <span class="badge scheduled">review</span>
+    </article>
+  `).join("") : `<div class="empty">No built-in review notes matched this list.</div>`;
+}
+
+async function buildPlan() {
+  planButton.disabled = true;
+  planButton.textContent = "Planning...";
+  try {
+    const response = await fetch("/api/plan", {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({ medications: medications.value }),
+    });
+    const payload = await response.json();
+    if (!response.ok) throw new Error(payload.error || "Unable to build plan");
+    render(payload);
+  } catch (error) {
+    refills.innerHTML = `<div class="empty">${esc(error.message)}</div>`;
+  } finally {
+    planButton.disabled = false;
+    planButton.textContent = "Build plan";
+  }
+}
+
+function brief() {
+  if (!currentPlan) return "";
+  const refillLines = currentPlan.refills.map((item) => `- ${item.owner}: ${item.name} (${item.urgency}, ${item.days_left ?? "unknown"} days left)`);
+  const cautionLines = currentPlan.cautions.map((item) => `- ${item.name}: ${item.message}`);
+  return [`Dosewise Home brief`, "", "Refill queue:", ...refillLines, "", "Review notes:", ...cautionLines].join("\n");
+}
+
+planButton.addEventListener("click", buildPlan);
+sampleButton.addEventListener("click", () => {
+  medications.value = sample;
+  buildPlan();
+});
+copyButton.addEventListener("click", async () => {
+  await navigator.clipboard.writeText(brief());
+  copyButton.textContent = "Copied";
+  setTimeout(() => copyButton.textContent = "Copy brief", 1200);
+});
+
+medications.value = sample;
+buildPlan();

dosewise_home-0.1.0/dosewise_home/web/index.html

@@ -0,0 +1,77 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1" />
+    <title>Dosewise Home</title>
+    <link rel="stylesheet" href="/styles.css" />
+  </head>
+  <body>
+    <main class="app">
+      <section class="workspace">
+        <div class="panel input-panel">
+          <div>
+            <p class="eyebrow">Local household planner</p>
+            <h1>Dosewise Home</h1>
+            <p class="lede">
+              Turn a medicine cabinet list into a same-week refill queue, dose timeline, and household safety notes.
+            </p>
+          </div>
+
+          <label for="medications">Medication list</label>
+          <textarea id="medications" spellcheck="false"></textarea>
+          <div class="actions">
+            <button id="plan-button">Build plan</button>
+            <button id="sample-button" class="secondary">Reload sample</button>
+            <button id="copy-button" class="secondary">Copy brief</button>
+          </div>
+          <p class="notice">
+            This app organizes household information. It does not diagnose, prescribe, or replace a pharmacist or clinician.
+          </p>
+        </div>
+
+        <div class="results">
+          <section class="summary-strip">
+            <div>
+              <span id="total-meds">0</span>
+              <small>medicines</small>
+            </div>
+            <div>
+              <span id="urgent-count">0</span>
+              <small>urgent refills</small>
+            </div>
+            <div>
+              <span id="dose-count">0</span>
+              <small>daily moments</small>
+            </div>
+          </section>
+
+          <section class="panel">
+            <div class="panel-head">
+              <h2>Refill queue</h2>
+              <span id="queue-status">Ready</span>
+            </div>
+            <div id="refills" class="stack"></div>
+          </section>
+
+          <section class="panel">
+            <div class="panel-head">
+              <h2>Today timeline</h2>
+              <span>Estimated from instructions</span>
+            </div>
+            <div id="schedule" class="timeline"></div>
+          </section>
+
+          <section class="panel">
+            <div class="panel-head">
+              <h2>Review notes</h2>
+              <span>Pharmacy conversation prompts</span>
+            </div>
+            <div id="cautions" class="stack"></div>
+          </section>
+        </div>
+      </section>
+    </main>
+    <script src="/app.js"></script>
+  </body>
+</html>

dosewise_home-0.1.0/dosewise_home/web/styles.css

@@ -0,0 +1,309 @@
+:root {
+  color-scheme: light;
+  --ink: #20252b;
+  --muted: #65717e;
+  --line: #dce3e1;
+  --paper: #fbfaf6;
+  --panel: #ffffff;
+  --teal: #0f766e;
+  --blue: #245d8a;
+  --amber: #aa650c;
+  --red: #b42318;
+  --green: #28704a;
+  --shadow: 0 18px 50px rgba(31, 45, 50, 0.12);
+  font-family: Inter, ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif;
+}
+
+* {
+  box-sizing: border-box;
+}
+
+body {
+  margin: 0;
+  background:
+    linear-gradient(120deg, rgba(15, 118, 110, 0.08), rgba(36, 93, 138, 0.06)),
+    var(--paper);
+  color: var(--ink);
+}
+
+.app {
+  min-height: 100vh;
+  padding: 28px;
+}
+
+.workspace {
+  display: grid;
+  grid-template-columns: minmax(320px, 430px) minmax(0, 1fr);
+  gap: 20px;
+  max-width: 1320px;
+  margin: 0 auto;
+}
+
+.panel,
+.summary-strip {
+  background: var(--panel);
+  border: 1px solid var(--line);
+  border-radius: 8px;
+  box-shadow: var(--shadow);
+}
+
+.input-panel {
+  position: sticky;
+  top: 28px;
+  align-self: start;
+  padding: 24px;
+  display: grid;
+  gap: 16px;
+}
+
+.eyebrow {
+  color: var(--teal);
+  font-size: 0.78rem;
+  font-weight: 800;
+  letter-spacing: 0;
+  margin: 0 0 8px;
+  text-transform: uppercase;
+}
+
+h1,
+h2 {
+  margin: 0;
+  letter-spacing: 0;
+}
+
+h1 {
+  font-size: 2.4rem;
+  line-height: 1;
+}
+
+h2 {
+  font-size: 1rem;
+}
+
+.lede,
+.notice {
+  color: var(--muted);
+  line-height: 1.5;
+}
+
+.lede {
+  margin: 12px 0 0;
+}
+
+.notice {
+  margin: 0;
+  font-size: 0.88rem;
+}
+
+label {
+  font-weight: 750;
+  font-size: 0.9rem;
+}
+
+textarea {
+  width: 100%;
+  min-height: 390px;
+  resize: vertical;
+  border: 1px solid var(--line);
+  border-radius: 8px;
+  padding: 14px;
+  font: 0.9rem/1.5 ui-monospace, SFMono-Regular, Menlo, Consolas, monospace;
+  color: var(--ink);
+  background: #fcfdfc;
+}
+
+.actions {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 10px;
+}
+
+button {
+  min-height: 42px;
+  border: 0;
+  border-radius: 8px;
+  padding: 0 16px;
+  background: var(--teal);
+  color: white;
+  font-weight: 800;
+  cursor: pointer;
+}
+
+button.secondary {
+  background: #eef4f2;
+  color: var(--ink);
+  border: 1px solid var(--line);
+}
+
+.results {
+  display: grid;
+  gap: 18px;
+}
+
+.summary-strip {
+  display: grid;
+  grid-template-columns: repeat(3, 1fr);
+  overflow: hidden;
+}
+
+.summary-strip div {
+  padding: 20px;
+  border-right: 1px solid var(--line);
+}
+
+.summary-strip div:last-child {
+  border-right: 0;
+}
+
+.summary-strip span {
+  display: block;
+  font-size: 2rem;
+  font-weight: 850;
+  color: var(--blue);
+}
+
+.summary-strip small,
+.panel-head span {
+  color: var(--muted);
+  font-weight: 650;
+  font-size: 0.82rem;
+}
+
+.panel {
+  padding: 20px;
+}
+
+.panel-head {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: 14px;
+  margin-bottom: 14px;
+}
+
+.stack {
+  display: grid;
+  gap: 10px;
+}
+
+.refill,
+.caution {
+  display: grid;
+  grid-template-columns: minmax(0, 1fr) auto;
+  gap: 12px;
+  padding: 14px;
+  border: 1px solid var(--line);
+  border-radius: 8px;
+  background: #fcfdfc;
+}
+
+.title {
+  font-weight: 850;
+}
+
+.meta {
+  color: var(--muted);
+  margin-top: 3px;
+  font-size: 0.88rem;
+}
+
+.badge {
+  align-self: start;
+  border-radius: 999px;
+  padding: 5px 10px;
+  font-size: 0.75rem;
+  font-weight: 850;
+  text-transform: uppercase;
+}
+
+.critical {
+  color: var(--red);
+  background: #fff0ee;
+}
+
+.soon,
+.scheduled {
+  color: var(--amber);
+  background: #fff7e8;
+}
+
+.steady {
+  color: var(--green);
+  background: #ecf8f1;
+}
+
+.timeline {
+  display: grid;
+  gap: 0;
+  border: 1px solid var(--line);
+  border-radius: 8px;
+  overflow: hidden;
+}
+
+.timeline-row {
+  display: grid;
+  grid-template-columns: 82px minmax(0, 1fr);
+  min-height: 62px;
+  border-bottom: 1px solid var(--line);
+}
+
+.timeline-row:last-child {
+  border-bottom: 0;
+}
+
+.time {
+  display: grid;
+  place-items: center;
+  background: #f1f7f6;
+  color: var(--teal);
+  font-weight: 850;
+}
+
+.dose {
+  padding: 12px 14px;
+}
+
+.empty {
+  padding: 18px;
+  border: 1px dashed var(--line);
+  border-radius: 8px;
+  color: var(--muted);
+}
+
+@media (max-width: 920px) {
+  .app {
+    padding: 16px;
+  }
+
+  .workspace {
+    grid-template-columns: 1fr;
+  }
+
+  .input-panel {
+    position: static;
+  }
+}
+
+@media (max-width: 560px) {
+  h1 {
+    font-size: 2rem;
+  }
+
+  .summary-strip {
+    grid-template-columns: 1fr;
+  }
+
+  .summary-strip div {
+    border-right: 0;
+    border-bottom: 1px solid var(--line);
+  }
+
+  .summary-strip div:last-child {
+    border-bottom: 0;
+  }
+
+  .refill,
+  .caution {
+    grid-template-columns: 1fr;
+  }
+}

dosewise_home-0.1.0/dosewise_home.egg-info/PKG-INFO

@@ -0,0 +1,103 @@
+Metadata-Version: 2.4
+Name: dosewise-home
+Version: 0.1.0
+Summary: Local-first household medication schedule and refill planner
+Author: Dosewise Home
+License-Expression: MIT
+Keywords: medication,refill,health,household,planner
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Web Environment
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: Programming Language :: Python :: 3
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# Dosewise Home
+
+Dosewise Home is a local-first household medication schedule and refill planner. Paste a simple medication cabinet CSV, then get a same-week refill queue, daily dose timeline, and pharmacist conversation prompts without creating an account or uploading private health notes.
+
+![Dosewise Home dashboard](assets/screenshots/dosewise-home.svg)
+
+## Features
+
+- Runs locally from a small Python server and browser interface.
+- Imports comma, tab, semicolon, or pipe-delimited medication rows.
+- Estimates days left and prioritizes critical, soon, scheduled, and steady refills.
+- Builds a daily dose timeline from common instruction words like morning, dinner, bedtime, and night.
+- Flags plain-language review prompts for common household issues such as grapefruit cautions, duplicate acetaminophen, blood thinner review, and stacked sleep aids.
+- Copies a concise refill brief for a caregiver, pharmacy call, or household planning note.
+
+Dosewise Home organizes information only. It does not diagnose, prescribe, or replace medical advice from a clinician or pharmacist.
+
+## Installation
+
+Python 3.10 or newer is required.
+
+```bash
+git clone https://github.com/iwaheedsattar/dosewise-home.git
+cd dosewise-home
+python3 -m venv .venv
+source .venv/bin/activate
+python -m pip install -e .
+```
+
+## Usage
+
+Start the local app:
+
+```bash
+dosewise-home
+```
+
+Open [http://127.0.0.1:8765](http://127.0.0.1:8765), paste medication rows, and select **Build plan**.
+
+Example CSV:
+
+```csv
+name,owner,strength,instructions,quantity_left,doses_per_day,refill_date,notes
+Atorvastatin,Sam,20mg,Take one tablet with dinner,12,1,2026-07-03,Avoid grapefruit
+Lisinopril,Sam,10mg,Take every morning,24,1,2026-07-20,Blood pressure
+Acetaminophen Cold,Lee,500mg,Take at bedtime if needed,4,2,2026-06-30,Cold medicine
+```
+
+A fuller sample is available at `examples/household-medications.csv`.
+
+## CSV Columns
+
+Required columns:
+
+- `name`
+- `owner`
+- `strength`
+- `instructions`
+- `quantity_left`
+- `doses_per_day`
+
+Optional columns:
+
+- `refill_date` in `YYYY-MM-DD`, `MM/DD/YYYY`, or `MM/DD/YY` format
+- `notes`
+
+## Development
+
+Run tests:
+
+```bash
+python3 -m pytest
+```
+
+Run without installing:
+
+```bash
+python3 -m dosewise_home.server
+```
+
+## Roadmap
+
+- Add printable weekly pill-box sheets.
+- Add encrypted local browser storage for recurring household lists.
+- Add optional OCR import from prescription labels.
+- Add iCalendar reminders for refill windows.
+- Package as a signed desktop application.

dosewise_home-0.1.0/dosewise_home.egg-info/SOURCES.txt

@@ -0,0 +1,15 @@
+LICENSE
+README.md
+pyproject.toml
+dosewise_home/__init__.py
+dosewise_home/planner.py
+dosewise_home/server.py
+dosewise_home.egg-info/PKG-INFO
+dosewise_home.egg-info/SOURCES.txt
+dosewise_home.egg-info/dependency_links.txt
+dosewise_home.egg-info/entry_points.txt
+dosewise_home.egg-info/top_level.txt
+dosewise_home/web/app.js
+dosewise_home/web/index.html
+dosewise_home/web/styles.css
+tests/test_planner.py

dosewise_home-0.1.0/dosewise_home.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

dosewise_home-0.1.0/dosewise_home.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+dosewise-home = dosewise_home.server:main

dosewise_home-0.1.0/dosewise_home.egg-info/top_level.txt

@@ -0,0 +1 @@
+dosewise_home

dosewise_home-0.1.0/pyproject.toml

@@ -0,0 +1,28 @@
+[build-system]
+requires = ["setuptools>=68"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "dosewise-home"
+version = "0.1.0"
+description = "Local-first household medication schedule and refill planner"
+readme = "README.md"
+requires-python = ">=3.10"
+authors = [{ name = "Dosewise Home" }]
+license = "MIT"
+keywords = ["medication", "refill", "health", "household", "planner"]
+classifiers = [
+  "Development Status :: 3 - Alpha",
+  "Environment :: Web Environment",
+  "Intended Audience :: End Users/Desktop",
+  "Programming Language :: Python :: 3",
+]
+
+[project.scripts]
+dosewise-home = "dosewise_home.server:main"
+
+[tool.setuptools.packages.find]
+include = ["dosewise_home*"]
+
+[tool.setuptools.package-data]
+dosewise_home = ["web/*"]

dosewise_home-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

dosewise_home-0.1.0/tests/test_planner.py

@@ -0,0 +1,30 @@
+from datetime import date
+
+from dosewise_home.planner import build_plan, default_slots, parse_medications
+
+
+SAMPLE = """name,owner,strength,instructions,quantity_left,doses_per_day,refill_date,notes
+Atorvastatin,Sam,20mg,Take one tablet with dinner,12,1,2026-07-03,Avoid grapefruit
+Acetaminophen Cold,Lee,500mg,Take at bedtime if needed,4,2,2026-06-30,Cold medicine
+"""
+
+
+def test_parse_medications_reads_household_rows():
+    meds = parse_medications(SAMPLE)
+    assert len(meds) == 2
+    assert meds[0].owner == "Sam"
+    assert meds[1].quantity_left == 4
+
+
+def test_build_plan_prioritizes_low_supply_and_cautions():
+    plan = build_plan(SAMPLE, today=date(2026, 6, 27))
+    assert plan["refills"][0]["name"] == "Acetaminophen Cold"
+    assert plan["refills"][0]["urgency"] == "critical"
+    assert {item["name"] for item in plan["cautions"]} == {
+        "Grapefruit caution",
+        "Duplicate acetaminophen",
+    }
+
+
+def test_default_slots_match_daily_frequency():
+    assert [slot.strftime("%H:%M") for slot in default_slots(2)] == ["08:00", "20:00"]