Sign in once with your founder account. Your session persists — after this, every customer's database is one click away.
src/backend/core/report_renderer.py); click any block to open the
mechanics that build it. Anatomy read from the code 2026-08-14 — every claim
carries a file:line; where page and code disagree, the code wins.
Live tools: internal generator ·
public page ·
the archive abovereport_renderer.py:98-357). Gold chips are scoring weights out of 100.
Teal chips are the pipeline stages that feed the block.| Channel | Weight | Door |
|---|---|---|
| google_business | 25 | 1 — Google profile |
| reviews | 20 | 1 — Google profile |
| website | 15 | 2 — Your website |
| seo (local search) | 15 | 4 — Local listings |
| social | 10 | 3 — Facebook & social |
| content | 10 | 3 — Facebook & social |
| competitive | 5 | 4 — Local listings |
| web_presence (citations) | shown, unweighted | 4 — Local listings |
Weights: CHANNEL_WEIGHTS
client_report.py:198-206. web_presence renders a bar but never moves the overall.
Overall is renormalised over what was MEASURED (:365-375):
overall = Σ(score × weight/10, OK lanes) × 100 / Σ(weight, OK lanes)
A dark lane shrinks the denominator instead of counting as zero.
_lane(key, score, ok)
(:232-234) carrying a status beside the number. A Places miss is unknown, not
absent — google_business scores a real 0 only on confirmed_absent (:268-272).
Website scores a real 0 only when health says none: no site AND search ran (:250-253).publishable(scores) (:384-404) — permission to show a report,
applied by every caller, never by the pipeline:
google_business, reviews) unknown → refuse.refund_due and serves a refund page, never a report (audit_product_routes.py:244-253).web_search(q) — the report's reading lane (:376-437)
engine=google, gl=au) — a 200 with zero hits is still a reading.ddgs, region au-en) — last resort; dead from the VPS historically.([], "").[] + "serp" means
we looked, nothing is there; [] + "" means we could not look.
"That difference is the whole honesty gate" (:382-387) — DDG dying quietly
once had owners told "nobody mentions you".find_businesses(q) — the identity picker (:468-502)
Merge ranks fuzzy-name hits first, then source
(places < google_local < website < … < directory), deduped on
name+host (_merge :344-373). _fuzzy_name_hit (:91-106)
demands every meaningful query token appear in the name — Shine is not Gardens.
place_by_id is the exactness escape hatch once an identity is picked.
spotlight_search picks the identity, spotlight_generate runs the
pipeline, gates on publishable, stores to client_reports, drafts the Gmail cover
(Haiku writes the words; the attachment is the same renderer as /reports/view).
Public funnel /reports/spotlight is the same pipeline + identity carry + 3/hr IP limit.
brenda_spotlight.py — deliberately NOT the pipeline: three cheap steps
(rep_find / rep_rivals / rep_rank) on the raw search lanes, fired at build time to fill the
dead air while Vivian writes. Obeys the same law by marking steps skipped,
never "no presence found". Stamped onto place.spotlight_before.
skills.run_site_spotlight — full pipeline with the picked identity; raises
SpotlightUnreadable rather than freezing a dark scan as the Day-0 baseline.
Snapshots (compact_spotlight_snapshot) carry a verified stamp so
pre-honesty history is never plotted as comparable.
audit_product_routes.py — the thinnest wrapper: pipeline → publishable
→ store → render (public mode). The gate is wired to the till: unpublishable =
refund_due + refund page.
dbdesk.net intake queues scans into spotlight_queue — the list at the top of
this tab. Report goes to the claiming email only; worked BY HAND until
spotlight-report-engine goes green. The $800 welcome reveals the quietly-built site.
03-24 born as the client report engine (search → select → generate, same day) · 03-25 voice-driven in 30s · 03-28 PDFs · 03-30 public promo lane + /admin/spotlights ("help, not a sales funnel") · 03-31 AI Readiness, second free tool · 07-25 the honesty rework: unknown never zero, identity carried, runs kept as a timeline · 07-27 onto the laptop bridge · 08-14 the front-door offer: report free by email, $800 reveals the build.
{business} {site_url} {office_link}
{office_door}