diet-guard/diet_guard/_cli_claude.py
Krzysztof kuhy Rudnicki 642467dc1d Add the Claude relay worker
python -m diet_guard claude-worker serves the phone's meal requests from
RTDB (rtdb_relay RequestServer, one SSE stream, reconnects with backoff):
validate, estimate with Claude, log through the signed log with
source=claude under the oldest due slot (normal mode: nearest slot of the
phone's hint), write the sealed result, delete only the request payload,
then publish in the background. diet-guard-claude.service (Restart=on-failure,
WantedBy=default.target) is installed by install.sh and started once the
worker's own Firebase session exists. Nothing is deployed by this commit.

Failure paths:
- narrow peer pull fails (sync locked/unreachable): fail closed, no claim, no
  answer, no model call; the request stays pending, retried every 30 s
- e2e key locked, no passphrase, no session: fail closed, nothing read or
  written; the worker waits and retries every 60 s
- bad body, request older than 24 h (or no created): fail closed, an error
  result, nothing logged
- Claude failure/timeout/invalid JSON: fail closed, an error result with
  retry, nothing logged
- crash between log and result, or a duplicate event: idempotent, the entry
  id is uuid5 of the rid and is looked up (tombstones included) before the
  model call
- request payload delete, old-answer cleanup and the post-answer publish
  failing: fail open on purpose (logged only); the answer and the local
  entry are already durable
- due mode with nothing due: falls back to slot_for_log, not an error

New log helpers log_meal_as / find_entry; log_meal's body is split into
_entry_fields / _store_entry with the same output. The gate and CLI import
none of the worker's dependencies at load time.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01WzxdWZHWP4KZ6x5TcXDBFC
2026-11-17 21:15:08 +01:00

30 lines
994 B
Python

"""CLI handler for the ``claude-worker`` subcommand.
The relay worker needs ``claude_agent_sdk``, ``rtdb_relay`` and ``httpx``,
which system Python only gains after the install step. Importing the worker
here would make every command (the gate included) fail at load time on a
machine that has not run it -- the 2026-06-19 outage shape -- so the worker
module is imported only when this subcommand actually runs.
"""
from __future__ import annotations
from importlib import import_module
from typing import TYPE_CHECKING
if TYPE_CHECKING:
import argparse
def register_claude_subparser(sub: argparse._SubParsersAction) -> None:
"""Register the ``claude-worker`` subcommand on ``sub``."""
sub.add_parser(
"claude-worker",
help="Serve the phone's 'send to Claude' meal requests (long-running).",
)
def cmd_claude_worker() -> int:
"""Run the relay worker until it is stopped; its exit code."""
return import_module("diet_guard._claude_relay").main()