📜 MASTER DOCUMENT 458

Carrot Watcher · Operating Doctrine

"You can't watch the form 24/7. The Watcher does. This is the document that explains it."

Sealed 02 May 2026Build #76Sovereign-only consoleLibrary only

§1 · What it is

The Carrot Watcher is the sovereign-side console at /carrot-watcher. Every supplier that fills the public intake at /carrot-intake arrives here in real time. The page polls the database every 10 seconds and surfaces new submissions with a flash animation so they can't be missed.

It is the operator's eye on the front door of The Carrot. Without it the public intake would be a one-way drop-box. With it, every submission is a tracked obligation — grabbed, contacted, kit-sent, completed, archived.

§2 · How to operate it

Daily flow (5 minutes)

  1. Open /carrot-watcher. The unread badge in the header pulses orange if anything is waiting.
  2. Click any supplier name to open the detail modal. Read everything in one screen.
  3. Hit Grab on any new submission to take ownership (status flips to In Review).
  4. If verified: Send Carrot Kit queues the welcome email; Mark Complete closes it.
  5. If something is off: Mark Action Needed flags it red so it can't be lost.
  6. Add notes any time — every note is timestamped and audit-logged.

Filters

Status (New · Review · Action · Complete) · Source (Website · QR · API) · free-text search across name/email/material. Filters are debounced 300ms and update without page reload.

The H.BLUE log stream

The right-side panel polls /api/carrot/watcher/log every 8 seconds and shows the last 50 events: form submissions, grabs, kits sent, status changes, notes. Nothing happens silently.

§3 · Functions exposed

EndpointMethodPurpose
/api/carrot/watcher/listGETFilterable submission list + counter stats
/api/carrot/watcher/get/<id>GETSingle submission + H.BLUE insights
/api/carrot/watcher/grab/<id>POSTAssign to current admin · status → review
/api/carrot/watcher/status/<id>POSTSet status (new / review / action / complete)
/api/carrot/watcher/send-kit/<id>POSTQueue Carrot Kit email · stamps kit_sent_at
/api/carrot/watcher/note/<id>POSTAppend a note to the audit trail
/api/carrot/watcher/delete/<id>POSTRemove (sovereign only)
/api/carrot/watcher/logGETLast 50 H.BLUE events for the sidebar
/api/carrot/watcher/seedPOSTInsert demo rows for testing

§4 · How it helps now

§5 · How it helps in the future

§6 · How to make it better

  1. Real WebSocket. Current implementation polls every 10s. Swap to a WebSocket on /ws/carrot-stream for sub-second arrival animation.
  2. Email + SMS triggers. Wire the Send Carrot Kit action into a real SMTP relay; add SMS for high-priority alerts.
  3. Sound + browser notifications. The "ding" + Notification API hooks are stubbed in the template — enable per-operator setting.
  4. H.BLUE insights upgrade. Currently shows known-supplier + lifetime value. Add: average response time, conversion rate, last-contact decay, fraud-pattern matches.
  5. Bulk operations. Multi-select rows and grab/complete in batches.
  6. Export. CSV download of filtered list (the dPRN Console already has this — port the same pattern).
  7. Mobile view. Current grid collapses but isn't optimised — tap-targets need 48px minimum.

§7 · Connected MDs

"You cannot manage what you do not see. The intake is the door. The Watcher is the eye. The eye is the doctrine. The doctrine is: no submission is dropped." — MD-458 · sealed 02 May 2026
🟢 Open Watcher 🟡 Public Intake 🔴 dPRN Console 📜 MD-459 📜 MD-460 🥕 Carrot Hub 📚 Library
SOVEREIGN CO-PILOT
Property or not · Tonnes or not · Always speaking
LIVE
05:00 BRIEF 12:00 PULSE 18:00 WRAP 21:00 COVENANT
Initialising sovereign voice...
CircularOS™ · dPRN™ · 40 Meals™ · B66 Smethwick · Jermaine Murphy
HANDSHAKE — witnesses
Handshake sealed.