nx_vizsla_bills.nx

nx_vizsla_bills.nx -- NISHI VIZSLA: the recurring BILLS / payables tracker. Operator directive 2026-06-14: "manage all our bills". V1 budget tracks money HISTORY; this tracks the recurring OBLIGATIONS -- what is due, when, how much, and whether THIS month is paid -- so a bill is never silently missed. Inherits the CID-ledger / civil-date substrate from V4 (nx_vizsla_relate). THEORY AS DATA (bills.txt): payees, amounts, due-days, autopay are all file content (law 11/25) -- adding/retuning a bill is an edit, never a recompile. Commands (argv[1]): load <bill_log> <prefix> [segid] PAID rows -> canonical records -> CID keys "bill:nxc1-..." on seg_store (additive, idempotent by construction). status <prefix> <bills> <today> per bill: next due date + is THIS month paid -> PAID / UPCOMING / DUE / OVERDUE, + owed_cents for everything unpaid. today via argv = deterministic. File formats (line records, # comments): bills: CONF soon_days <n> BILL <id> <payee> <amount_cents> <due_day> MONTHLY <AUTO|MANUAL> (due_day 1..28; only MONTHLY this rung -- other cadences fail loud) bill_log: PAID <date> <bill-id> <amount_cents> <note> (date YYYY-MM-DD) "Paid this month" = a PAID record for that bill dated in today's calendar month. due_this_month = (today.year, today.month, due_day). state: PAID (paid this month) -> next due = next month else days_until = due_this_month - today: days_until < 0 -> OVERDUE 0 <= days_until <= soon -> DUE days_until > soon -> UPCOMING owed_cents = sum of every UNPAID bill's amount (due+overdue+upcoming) = what you still owe this month. autopay shown (AUTO = no action) but money still counts as owed until recorded paid. Determinism: stdout has no clocks (today via argv). Loud-fail: missing files, cadence != MONTHLY, autopay not AUTO/MANUAL, malformed dates/days = exit 1. EXCEED (honest, feature-class): consumer bill apps silo reminders from the money ledger; here bills + budget + the relationship/notes brief share ONE additive tamper-evident substrate and surface together in the daily digest.