Go to file
Krzysztof kuhy Rudnicki 6cd3470502 Add the Claude meal estimator
estimate_meal(text, photo) -> Estimate runs Claude through
claude_agent_sdk in an isolated CLAUDE_CONFIG_DIR: a copy of the access
token (no refresh token, no MCP tokens) and the diet-food skill, never
kuhy's ~/.claude. The skill text is the system prompt; the closest curated
and derived food-bank rows ride in the user message; the photo is an image
block; the answer is constrained by a JSON schema and validated again.

Failure paths, all fail closed (an EstimateError code, nothing logged):
- no host login, CLI/API error, bad transport: estimate_failed
- more than 45 s: estimate_timeout
- no object, missing/mistyped field, NaN/inf/negative/absurd number,
  grams 0, blank or long desc: estimate_invalid
- neither text nor photo: ValueError before any model call
- failed token refresh is logged, the call then fails as estimate_failed

Live smoke (scratch HOME, nothing logged): "2 jajka sadzone i kromka
chleba" -> 315 kcal in 4.3 s.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01WzxdWZHWP4KZ6x5TcXDBFC
2026-11-17 21:05:41 +01:00
.github/workflows chore: bump deps to newest stable 2026-11-01 20:12:24 +01:00
app Add the Claude meal estimator 2026-11-17 21:05:41 +01:00
diet_guard Add the Claude meal estimator 2026-11-17 21:05:41 +01:00
docs Add the Claude relay contract 2026-11-17 20:55:50 +01:00
packaging/aur Launcher: label DietGuard (Android, desktop entry, PKGBUILD), icon fitted to the shared 340px ink circle 2026-10-23 14:36:31 +02:00
prompts Move TODOs to todo app 2026-11-02 11:18:13 +01:00
scripts Add Claude relay seams and entry points 2026-11-17 21:02:35 +01:00
skills/diet-food Add the Claude meal estimator 2026-11-17 21:05:41 +01:00
tests/fixtures Add the Claude relay contract 2026-11-17 20:55:50 +01:00
.fvmrc chore: bump deps to newest stable 2026-11-01 20:12:24 +01:00
.gitignore feat: import Kuchnia Wikinga catering deliveries into the food bank 2026-08-22 23:04:22 +02:00
.mcp.json Add MCP server exposing diet status + a gated log_meal 2026-07-10 21:36:46 +02:00
.pre-commit-config.yaml Add Claude relay seams and entry points 2026-11-17 21:02:35 +01:00
AGENTS.md Bring three files back under 250 lines 2026-11-16 09:28:02 +01:00
CLAUDE.md docs: record the narrow-pull split and the interactive-path rules 2026-08-21 13:39:24 +02:00
dependency-freshness.allowlist.yaml Allow material_ui 1.11.0 behind sync_settings_ui 2026-11-17 21:02:30 +01:00
diet-guard-gate.service slots: minute-of-day consumers (phase 2 of 3: Python side) 2026-10-10 19:53:39 +02:00
diet-guard-gate.timer slots: minute-of-day consumers (phase 2 of 3: Python side) 2026-10-10 19:53:39 +02:00
diet-guard-sync.service Add cross-device log sync (Python half of Milestone 3) 2026-06-22 19:36:27 +02:00
DOCS-dopamine-ux.md Move TODOs to todo app 2026-11-02 11:18:13 +01:00
install.sh slots: minute-of-day consumers (phase 2 of 3: Python side) 2026-10-10 19:53:39 +02:00
LICENSE Add MIT LICENSE 2026-08-09 22:49:29 +02:00
pyproject.toml Add Claude relay seams and entry points 2026-11-17 21:02:35 +01:00
README.md slots: minute-of-day consumers (phase 2 of 3: Python side) 2026-10-10 19:53:39 +02:00
requirements.txt Add Claude relay seams and entry points 2026-11-17 21:02:35 +01:00

diet_guard

A log-to-unlock gate: locks the desktop until a meal is logged once a meal slot (08:00 / 12:00 / 16:00 / 20:00) has elapsed without one, and tracks a sealed daily calorie/macro budget.

Install

bash install.sh

This installs the package + dependencies into system Python's user site-packages (the systemd service runs /usr/bin/python directly, not a venv — see CLAUDE.md), installs the systemd user timer, seals your daily budget, and locks the budget file immutable.

Usage

python -m diet_guard init          # one-time: compute and seal today's budget
python -m diet_guard gate --demo   # test the lock window (safe, closeable)
python -m diet_guard averages      # weekly/monthly average kcal vs budget

Averages

averages prints the mean kcal/day for this week, last week, this month and last month, each labelled under / slightly over / very over.

Three rules make the number honest, and all three are mirrored in the phone app and the gate's History tab:

  • the mean is over logged days only -- a day you forgot to log is not a zero-calorie day, and averaging it in as one would make every gap in the log read as "well under budget";
  • the yardstick is the mean of the budgets that applied on those same days, not today's budget, so editing the budget never retroactively reclassifies a past week (same reason the calendar uses .budget_history);
  • today is excluded -- every period ends at yesterday, because a half-logged today drags the mean far enough to flip the band. On a Monday "this week" therefore reports no logged days yet rather than a flattering number.

The band boundaries are the calendar's own (at or under budget / up to 20% over / more than 20% over), so a period and its day cells can never disagree about what "over" means.

The timer runs the gate automatically every ~15 minutes; no manual invocation is needed once installed.

MCP server

An optional Model Context Protocol server lets an MCP client (Claude Code and its subagents) query today's intake and log meals as typed tools instead of shelling out to the CLI. It runs in its own venv (~/.venvs/diet-guard-mcp) so the mcp SDK never touches the dependency-light system/CLI python path.

Tools:

  • get_status — today's consumed kcal + macros, the consumption band (on track / approaching limit / OVER BUDGET, or none when no budget is sealed), plus due / logged / current meal slots.
  • list_today — today's logged meals (description, kcal, macros, source, slot).
  • get_slots — the day's fixed meal slots and the current one.
  • get_averages — average kcal/day for this/last week and this/last month, each with its band (under / slightly_over / very_over). Returns the intake and the band only — never the period's average budget.
  • log_meal(description, grams=, kcal=, protein=, carbs=, fat=, slot=, confirm=False) — gated write: with confirm=False it previews the resolved nutrition and target slot and mutates nothing; only confirm=True appends the entry. The gate is intrinsic — never add this tool to a permission allowlist, since a client's auto-approve mode would otherwise bypass the human confirmation.

The read tools deliberately never expose the raw daily budget number (only the qualitative band), nor the sealed .budget file, the shared HMAC key, or the sync token — the budget stays hidden by design.

Setup:

bash scripts/setup_mcp.sh   # create the venv and install diet_guard[mcp]

Then restart Claude Code in this repo and approve the project MCP server (registered in .mcp.json).

Development

python -m venv .venv && .venv/bin/pip install -r requirements.txt
.venv/bin/pre-commit install && .venv/bin/pre-commit install --hook-type pre-push
.venv/bin/python -m pytest diet_guard/tests/ --cov=diet_guard --cov-branch --cov-fail-under=100

See CLAUDE.md for scheduling details and production deployment gotchas, and docs/DOCS-design.md for the original feature spec.