docs: refresh README + AGENTS + journal for end-of-day handoff

[Bytes0211]

Summary

Captures the May 2 work after PRs #2/#3/#4 merged so picking up cold in 2–3 days doesn't require re-discovering anything.

README.md — bumped from "M1–M7 complete... Next: M8" to "M1–M8 complete, Path A demo proven live". Stack updated (Telnyx, not Twilio). "Where things live" table refreshed. Pointer to developer/m8-live-demo-checklist.md for the deploy runbook.

AGENTS.md — current-state header rewritten. Five new convention bullets covering the gotchas agents commonly miss (CORS preflight, auth init bootstrap, branding location/access, customer-facing route ownership, Stripe-three-environments). New "Open follow-ups" section at the bottom listing the three known pre-launch items — admin chrome branding, kitchen "Ready" SMS, Path B Vapi — each with scope and estimated effort.

developer/developer-journal.md — new dated entry "May 2 (later)" covering PRs #3 + #4, the dialtone_menu PR #27 reversal, the SQL cleanup of orphaned test orders, and the doc refresh itself. Decisions section explains the design choices (columns vs separate table, RPC scoped by order_id, helpers extracted for testability, hexToRgba fallback). Follow-ups mirror AGENTS.md so the same plan is visible from both surfaces.

Test plan

• pnpm ci:fast green (220 unit tests, lint, typecheck)
• Docs only — no behavior change

🤖 Generated with Claude Code

Greptile Summary

Documentation-only end-of-day handoff refresh across three files. README and AGENTS.md are updated to reflect M8 Path A going live (cloud Supabase, Stripe/Telnyx/Cloudflare end-to-end validated), and developer-journal.md adds a dated entry narrating today's PRs, decisions, and the three scoped follow-ups. No code changes — all content is internally consistent and accurately cross-references the prior PRs.

Confidence Score: 5/5

Docs-only PR with no code changes — safe to merge as-is.

All three files are documentation updates with no code or configuration changes. Content is factually consistent across files, cross-references resolve to real artifacts in the repo, and the known issues are honestly scoped with effort estimates. No P0/P1/P2 findings identified.

No files require special attention.

Important Files Changed

Filename	Overview
README.md	Status bump from M1–M7 to M1–M8, stack corrected from Twilio to Telnyx, "Where things live" table refreshed with new artifacts, new Deploy section added — accurate and internally consistent
AGENTS.md	Current-state header rewritten for M8 live demo; five new convention bullets covering CORS, auth init, branding access, customer-facing route ownership, and Stripe env gotcha; new "Open follow-ups" section with scoped tasks and estimates
developer/developer-journal.md	New "May 2 (later)" journal entry documenting PRs #3 and #4, the dialtone_menu reversal, SQL cleanup of orphaned test orders, and the doc refresh — decisions and follow-ups align with AGENTS.md

_{Reviews (1): Last reviewed commit: "docs: refresh README + AGENTS + journal ..." | Re-trigger Greptile}