`, favicon, and body of `Root()` to\nmatch your app's existing `index.html`, and stamp anything else your shell\nreferences directly (images, css) with `immutableFileUrl()`.\n\n1. Create `frontend/root.tsx`:\n\n```tsx\n/** @jsxImportSource npm:hono@4/jsx */\nimport { raw } from \"npm:hono@4/html\";\nimport { immutableFileUrl } from \"https://esm.town/v/std/utils/index.ts\";\n\n// The HTML shell for the app. It is never cached, so immutableFileUrl can stamp\n// the current val version into each asset URL — the browser caches those\n// immutably, and publishing the val changes the URLs, refetching exactly once.\nexport function Root() {\n return (\n <>\n {raw(\"<!DOCTYPE html>\")}\n <html lang=\"en\">\n <head>\n <meta charSet=\"UTF-8\" />\n <meta name=\"viewport\" content=\"width=device-width, initial-scale=1.0\" />\n <title>React Hono Val Town Starter

[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10},"actionData","errors","root",{"_402":403,"_404":405},"routes/_app.x.$handle.$name",{"_106":105,"_38":51,"_114":96,"_33":115,"_13":14,"_116":-5,"_11":117,"_118":119,"_120":121,"_122":123,"_124":125,"_26":-5,"_126":-5,"_127":-5,"_128":31,"_129":130,"_131":65,"_132":-5,"_133":-5,"_134":135},"routes/_app.x.$handle.$name.branch.$branch.version.$version.diff",{"_11":12,"_13":14,"_15":16,"_17":18,"_19":-5},"project",{"_49":50,"_38":51,"_44":52,"_53":-5,"_54":31,"_55":56,"_57":56,"_58":59,"_60":-5,"_19":61,"_62":63,"_64":65,"_66":-5,"_67":-5,"_68":69,"_70":71,"_72":73,"_74":75,"_76":77,"_78":-5,"_79":80,"_81":80,"_82":83,"_84":83,"_85":83,"_86":80,"_87":80,"_88":89,"_90":91,"_92":93,"_94":31},"version",48,"changes",[25],"aiChatInfo",{"_20":21,"_22":-5,"_23":-5,"_24":-5},"userId","aiChatMessageId","735176c0-7384-4a9c-a4ed-f8b6b3904eaa","aiChatThreadId","aiChatThreadUserId","aiChatThreadTitle",{"_26":27,"_28":29,"_30":31,"_32":31,"_33":34,"_35":34},"file",{"_36":37,"_38":39,"_40":26,"_41":43,"_44":45,"_46":14,"_47":48,"_30":31},"previous",{"_36":37,"_38":39,"_40":26,"_41":42},"deleted",false,"deletedHere","path","database/schema.sql","latestPath","fileId","8257134c-a7b3-11f1-a292-1607ee4eb77e","name","schema.sql","fileType","content","-- =============================================================================\n-- DLX Designs — verified leads (Supabase / PostgreSQL schema)\n-- Run this in the Supabase SQL editor (Dashboard > SQL > New query) to create\n-- the table the val mirrors verified leads into. The val's native SQLite store\n-- works even without Supabase; setting SUPABASE_URL + SUPABASE_SERVICE_ROLE_KEY\n-- on the val turns this table into a live mirror.\n-- =============================================================================\n\ncreate extension if not exists pgcrypto;\n\ncreate table if not exists public.dlx_verified_leads (\n id uuid primary key default gen_random_uuid(),\n name text not null,\n gmail text not null unique,\n score integer not null default 0 check (score between 0 and 100),\n source text not null default '',\n signal text not null default '',\n created_at timestamptz not null default now()\n);\n\n-- Fast sort for the \"highest intent first\" dashboard view.\ncreate index if not exists dlx_verified_leads_score_idx\n on public.dlx_verified_leads(score desc);\n\n-- Row Level Security: lock it down so only service-role (token) calls can\n-- write/read until you opt into a per-user policy. Using the anon key from the\n-- browser WILL be blocked by default — that is intentional.\nalter table public.dlx_verified_leads enable row level security;\n","-- =============================================================================\n-- DLX Designs — verified leads (Supabase / PostgreSQL schema)\n-- Run this in the Supabase SQL editor (Dashboard > SQL > New query) to create\n-- the table the val mirrors verified leads + pipeline state into. The val's\n-- native SQLite store works even without Supabase; setting SUPABASE_URL +\n-- SUPABASE_SERVICE_ROLE_KEY turns this table into a live mirror.\n-- =============================================================================\n\ncreate extension if not exists pgcrypto;\n\ncreate table if not exists public.dlx_verified_leads (\n id uuid primary key default gen_random_uuid(),\n name text not null,\n gmail text not null unique,\n phone text not null default '',\n score integer not null default 0 check (score between 0 and 100),\n source text not null default '',\n source_url text not null default '',\n evidence text not null default '',\n signal text not null default '',\n action text not null default '',\n status text not null default 'new',\n history jsonb not null default '[]'::jsonb,\n created_at timestamptz not null default now(),\n updated_at timestamptz not null default now()\n);\n\n-- Fast sorts: strongest opportunities first, then newest.\ncreate index if not exists dlx_verified_leads_score_idx\n on public.dlx_verified_leads(score desc);\ncreate index if not exists dlx_verified_leads_created_idx\n on public.dlx_verified_leads(created_at desc);\ncreate index if not exists dlx_verified_leads_status_idx\n on public.dlx_verified_leads(status);\ncreate index if not exists dlx_verified_leads_source_idx\n on public.dlx_verified_leads(source);\n\n-- Row Level Security: lock it down so only service-role (token) calls can\n-- read/write until you opt into per-user policies. Using the anon key from the\n-- browser WILL be blocked by default — intentional (this is internal data).\nalter table public.dlx_verified_leads enable row level security;\n","createdAt",["D",1788493785335],"branchVersion","branchId","faea9245-6732-47d9-a1a2-3550998bc296","id","d2f8de76-3d02-4949-8a06-2f7cc759dae3","dlx-lead-engine",["D",1788452396724],"deletedAt","legacyEnvVars","privacy","public","httpPrivacy","description","DLX Designs lead qualification engine + React dashboard","imageUrl","0e434874-725d-4e49-bc72-a0c364fc943f","pinnedFileId","01a06811-df40-730d-85ee-1ae96a373bd7","pinPreview",true,"pinMigrated","screenshotVersion","likeCount",0,"orgId","01a04e8e-cc2d-73ad-9a1b-036254519f63","tursoName","d2f8de763d0249498a062f7cc759dae3","tursoHostname","d2f8de763d0249498a062f7cc759dae3-val-town.aws-us-east-2.turso.io","tursoMeasuredAt",["D",1789494036282],"pinned","userPerm","r","valPerm","blobPerm","rw","emailPerm","sqlitePerm","projectPerm","telemetryPerm","user",{"_106":105,"_113":-5},"org",{"_106":105,"_107":108,"_109":-5,"_19":-5,"_110":111,"_112":31},"branch",{"_13":95,"_38":96,"_49":48,"_97":50,"_98":-5,"_99":-5,"_100":-5,"_101":-5,"_102":-5,"_103":51,"_104":105},"isOwned",88,"main","projectId","forkedBranchId","forkedBranchVersion","forkedProjectPrivacy","forkedProjectId","forkedProjectOrgId","projectName","userHandle","dlxdesigns","handle","displayName","DLXdesigns ","avatar","tier","free","canRestrictVals","profileImageUrl","branchName","","adoptOrgId",{"_49":50,"_38":51,"_44":397,"_53":-5,"_54":31,"_55":56,"_57":56,"_58":59,"_60":-5,"_19":61,"_62":63,"_64":65,"_66":-5,"_67":-5,"_68":69,"_70":71,"_72":73,"_74":75,"_76":398,"_78":-5,"_79":80,"_81":80,"_82":83,"_84":83,"_85":83,"_86":80,"_87":80,"_88":399,"_90":400,"_92":401,"_94":31},"tree",[217,224,226,228,236,238,240,241,242],"files",[217,218,219,220,221,222,223,224,225,226,227,228,229,230,231,232,233,234,235,236,237,238,239,240,241,242],"counts",{"_207":69,"_208":168,"_209":69,"_210":211,"_212":213},"contents",[136,137,138,139,140,141,142,143,144],"upstreamProject","upstreamBranch","emptyEnvVars","flags",[],"hasHttpFiles","grants","orgs","customDomains",{},{"_49":202,"_38":203,"_36":204,"_147":-5,"_47":48,"_46":151,"_149":65,"_44":205,"_13":69,"_40":177,"_41":-5,"_30":31,"_154":-5,"_33":206},{"_49":196,"_38":197,"_36":198,"_147":-5,"_47":48,"_46":199,"_149":65,"_44":200,"_13":69,"_40":177,"_41":-5,"_30":31,"_154":-5,"_33":201},{"_49":190,"_38":191,"_36":192,"_147":-5,"_47":48,"_46":193,"_149":65,"_44":194,"_13":69,"_40":177,"_41":-5,"_30":31,"_154":-5,"_33":195},{"_49":185,"_38":186,"_36":187,"_147":-5,"_47":48,"_46":168,"_149":65,"_44":188,"_13":69,"_40":177,"_41":-5,"_30":31,"_154":-5,"_33":189},{"_49":179,"_38":180,"_36":181,"_147":-5,"_47":48,"_46":182,"_149":65,"_44":183,"_13":69,"_40":177,"_41":-5,"_30":31,"_154":-5,"_33":184},{"_49":172,"_38":173,"_36":174,"_147":-5,"_47":48,"_46":175,"_149":65,"_44":176,"_13":69,"_40":177,"_41":-5,"_30":31,"_154":-5,"_33":178},{"_49":165,"_38":166,"_36":167,"_147":-5,"_47":48,"_46":168,"_149":65,"_44":169,"_13":69,"_40":26,"_41":170,"_30":31,"_154":-5,"_33":171},{"_49":157,"_38":158,"_36":159,"_147":-5,"_47":48,"_46":160,"_149":31,"_44":161,"_13":162,"_40":26,"_41":163,"_30":31,"_154":-5,"_33":164},{"_49":145,"_38":146,"_36":63,"_147":-5,"_47":48,"_46":148,"_149":31,"_44":150,"_13":151,"_40":152,"_41":153,"_30":31,"_154":155,"_33":156},"078d1310-f866-41a3-b441-d5ea9c48b732","index.ts","parentId",39,"latest",["D",1788493730982],3,"http","import { parseVal, serveImmutableFile } from \"https://esm.town/v/std/utils/index.ts\";\nimport { Hono } from \"npm:hono\";\nimport { Root } from \"./frontend/root.tsx\";\nimport {\n listLeads,\n setLeadStatus,\n stageDistribution,\n topSources,\n topSignals,\n} from \"./lib/store.ts\";\nimport { ingestLead } from \"./backend/worker/ingest.ts\";\nimport { nextStage } from \"./backend/pipeline.ts\";\n\nconst app = new Hono();\n\n// Serve the (never-cached) HTML shell at the root and as the dashboard\napp.get(\"/\", (c) => c.html(Root()));\napp.get(\"/dashboard\", (c) => c.html(Root()));\n\n// Serve frontend files at the version-addressed URLs Root() stamps, cached immutably\napp.get(\"/__immutable/*\", (c) => serveImmutableFile(c.req.path));\n\n// View source redirect\napp.get(\"/source\", (c) => c.redirect(parseVal().links.self.val));\n\n// --- Lead API -----------------------------------------------------------\n\n// GET verified (already-qualified) leads for the dashboard\napp.get(\"/api/leads\", async (c) => {\n const leads = await listLeads(100);\n return c.json(leads);\n});\n\n// POST an inbound lead: { name, gmail, message, source }\n// Runs the strict qualification engine. Only high-intent leads are stored;\n// budget seekers and duplicates are rejected (422) and never persisted.\napp.post(\"/api/ingest\", async (c) => {\n const body = await c.req.json().catch(() => undefined);\n const outcome = await ingestLead((body as object) ?? {});\n return c.json(outcome, outcome.decision === \"reject\" ? 422 : 201);\n});\n\n// Move a lead forward in the pipeline (or set any valid stage).\n// Automatically advances when no stage body is given (\"next\").\napp.post(\"/api/leads/:id/status\", async (c) => {\n const id = c.req.param(\"id\");\n const body = (await c.req.json().catch(() => undefined)) as\n | { stage?: unknown; note?: unknown }\n | undefined;\n const lead = await listLeads(200);\n const existing = lead.find((l) => l.id === id);\n if (!existing) return c.json({ error: \"lead not found\" }, 404);\n\n let target: string;\n if (body?.stage) {\n target = String(body.stage);\n } else {\n const nxt = nextStage(existing.status as never);\n if (!nxt) return c.json({ error: \"terminal stage\", lead: existing });\n target = nxt;\n }\n\n const updated = await setLeadStatus(id, target, String(body?.note ?? \"\"));\n return c.json(updated ?? { error: \"lead not found\" }, updated ? 200 : 404);\n});\n\n// Analytics — what actually converts (learn layer).\napp.get(\"/api/analytics\", async (c) => {\n const [stages, sources, signals] = await Promise.all([\n stageDistribution(),\n topSources(8),\n topSignals(8),\n ]);\n return c.json({ stages, sources, signals });\n});\n\n// Unwrap and rethrow Hono errors as the original error\n// If you delete this, all errors will be \"Internal Server Error\"\napp.onError((err) => Promise.reject(err));\n\n// HTTP vals expect an exported \"fetch handler\"\n// This is how you \"run the server\" in Val Town with Hono\nexport default app.fetch;\n","label","dlx-leads",[146],"672f2da4-3b61-4b97-823b-a4dc275a39f2","README.md","01a06811-df40-730d-85ee-161b7548ebf9",32,["D",1788493439215],11,"# DLX Designs · Verified Lead Intelligence Engine\n\nProduction-ready lead-generation and **strict qualification** engine for DLX\nDesigns — a luxury bespoke traditional menswear brand targeting high-net-worth\nclients, grooms and corporate executives in Lagos & Abeokuta, Nigeria.\n\nIt ingests real inbound traffic, filters out low-budget seekers with strict\nsemantic rules, stores only verified high-intent leads, and renders them as\nscored lead cards in a live dashboard.\n\n> **Live dashboard:** [Try the app](url:index.ts)\n> **Ingest endpoint:** `POST /api/ingest`\n\n## Architecture\n\n```mermaid\ngraph LR\n Inbound[\"Web form / corridor
(blog, IG, ads)\"] -->|\"POST /api/ingest\"| Qual[\"Qualifier
backend/worker/qualifier.ts\"]\n Qual -->|\"hard reject\"| X[\"Low budget → dropped
never stored\"]\n Qual -->|\"optional\"| LLM[\"AI refine
(free tier, optional)\"]\n Qual -->|\"pass ≥ 50\"| Store[\"SQLite store
lib/store.ts\"]\n Store -->|\"optional mirror\"| Supabase[\"Supabase
dlx_verified_leads\"]\n Store -->|\"GET /api/leads\"| UI[\"React dashboard
frontend/\"]\n```\n\n- **Dashboard:** client-side React + Hono backend (App Router-equivalent), Twind/Tailwind styling.\n- **Database:** val-scoped PostgreSQL-compatible SQLite. **Supabase mirror optional.**\n- **Qualifier:** deterministic heuristic (zero-config) + optional free-tier AI refinement.\n\n## The strict qualification engine\n\nRuns in `backend/worker/qualifier.ts` and never fabricates data.\n\n**Layer 1 — hard disqualifiers (instant reject):** `cheap`, `affordable`,\n`under 20k`/`20k`, `discount`, `thrift`, `okirika`.\n\n**Layer 2 — scoring matrix (0–100):** baseline 25, high-tier signals add points —\n`bespoke` +18, `groom`/`chieftaincy` +20, `cashmere` +15, `wedding` +14,\n`3-piece` +12, `executive` +14, `lekki`/`victoria island` +10, `lagos`/`abeokuta`\n+6, etc. **Pass threshold: ≥ 50.** Sub-threshold leads are rejected.\n\n**Layer 3 — AI refinement (optional, zero-config by default):** the engine is\n**deterministic-first** — the strict heuristic above is authoritative and needs\n**no AI key, no external call, no cost**, so no provider can ever block it. If\nyou add a free-tier key, that provider refines the score and writes a natural\nbuying signal (tried in order: `GEMINI_API_KEY`, `GROQ_API_KEY`, `OPENAI_API_KEY`).\nA provider failing just falls back to the heuristic — never an error.\n\n### Endpoints\n\n| Method | Path | Purpose |\n| --- | --- | --- |\n| `GET` | `/` | Dashboard |\n| `GET` | `/dashboard` | Dashboard (alias) |\n| `GET` | `/api/leads` | Verified leads (JSON) |\n| `POST` | `/api/ingest` | Ingest & qualify an inbound lead — 201 on pass, 422 on reject |\n\n`POST /api/ingest` request body:\n\n```json\n{\n \"name\": \"Oluwatosin Adeyemi\",\n \"gmail\": \"tosin@example.com\",\n \"source\": \"nigerianmenswear.com\",\n \"message\": \"I need a bespoke 3-piece groom suit for my chieftaincy ceremony in Abeokuta\"\n}\n```\n\nOnly passing leads persist. Rejected and duplicate leads are returned (422) and\nnever stored.\n\n## Configuration (environment variables)\n\nEverything runs out of the box with **zero environment variables**. The\nqualification engine is fully deterministic. The following optional keys unlock\nthe AI refinement layer (free tiers are preferred — none require billing) and\nthe Supabase mirror:\n\n- **`GEMINI_API_KEY`** — free tier (Google AI Studio key, no card required). Recommended.\n- **`GROQ_API_KEY`** — free tier. Ignored unless Gemini is absent or fails.\n- **`OPENAI_API_KEY`** — requires active OpenAI billing; only used as a last resort.\n- **`SUPABASE_URL`** + **`SUPABASE_SERVICE_ROLE_KEY`** — mirror verified leads to\n your Supabase `dlx_verified_leads` table (native SQLite store stays authoritative).\n\n👉 Add GEMINI_API_KEY here: https://www.val.town/x/dlxdesigns/dlx-lead-engine/environment-variables?key=GEMINI_API_KEY\n👉 Add GROQ_API_KEY here: https://www.val.town/x/dlxdesigns/dlx-lead-engine/environment-variables?key=GROQ_API_KEY\n👉 Add OPENAI_API_KEY here: https://www.val.town/x/dlxdesigns/dlx-lead-engine/environment-variables?key=OPENAI_API_KEY\n👉 Add SUPABASE_URL here: https://www.val.town/x/dlxdesigns/dlx-lead-engine/environment-variables?key=SUPABASE_URL\n👉 Add SUPABASE_SERVICE_ROLE_KEY here: https://www.val.town/x/dlxdesigns/dlx-lead-engine/environment-variables?key=SUPABASE_SERVICE_ROLE_KEY\n\n### Supabase setup (optional)\n\nCreate the mirror table by running [`database/schema.sql`](database/schema.sql)\nin the Supabase SQL editor. The table uses `gen_random_uuid()` ids, enforces a\n`score BETWEEN 0 AND 100` check, has a `gmail UNIQUE` constraint, and enables\nRow-Level Security (locked to service-role access by default). The val writes\nvia PostgREST with the service-role key and `resolution=merge-duplicates`.\n\n## File structure\n\n```\ndatabase/\n schema.sql ← Supabase/PostgreSQL schema (mirror table)\nbackend/worker/\n qualifier.ts ← strict qualification engine (disqualifiers + scoring)\n ingest.ts ← ingest worker (bridge inbound → store)\n llm.ts ← optional AI adapter (free tier Gemini / Groq / OpenAI)\nlib/\n store.ts ← SQLite persistence + Supabase mirror\nfrontend/\n components/App.tsx ← dashboard layout + empty state\n components/LeadCard.tsx ← individual verified-lead card\nscripts/\n selftest.ts ← end-to-end qualifier + store self-test\nindex.ts ← Hono HTTP backend (dashboard + /api/*)\n```\n\n## Integrity guarantees\n\n- **No hardcoded, fake, or mock contacts anywhere.** Every record comes from a\n real `POST /api/ingest` submission that passed strict qualification.\n- Empty store → dashboard shows *“Awaiting live inbound high-intent signals…”*,\n never fake cards.\n- Duplicate emails are rejected (UNIQUE), budget seekers are dropped, sub-50\n intent is dropped.\n\n## Running the self-test\n\n`scripts/selftest.ts` exercises the full pipeline with synthetic example inputs\n(high-intent pass, low-budget reject, no-signal reject, duplicate reject) and is\nsafe to run repeatedly.\n",[158],"a130fa68-e89b-4e79-b351-ae119f51052e","CHANGELOG.md","01a06811-df40-730d-85ee-12df63d9ba38",1,["D",1788452396724],"# Changelog\n\n## 2026-07-30 — Immutable asset caching\n\nFrontend files are now served at version-addressed URLs\n(`/__immutable/45/frontend/index.tsx`) with\n`Cache-Control: public, max-age=31536000, immutable`, so repeat visits load the\nwhole client graph from the browser cache — roughly 3× faster (~665ms → ~157ms\nmeasured). Publishing your val bumps its version, which changes every URL, so\ncaches invalidate automatically. Old-version URLs return 404 after a publish\n(like Next.js build assets); a reload picks up the new version.\n\nWhat changed in the template:\n\n- `frontend/index.html` → [`frontend/root.tsx`](/frontend/root.tsx): the HTML\n shell is now JSX and stamps asset URLs with `immutableFileUrl()`\n- [`index.ts`](/index.ts): serves `Root()` at `/`, and one\n `app.get(\"/__immutable/*\", (c) => serveImmutableFile(c.req.path))` route\n serves all frontend files\n\n### Upgrading an existing remix\n\nYour copy of this template doesn't update automatically. Two options:\n\n**Minimal (most of the benefit):** point both routes at `serveImmutableFile` —\nyour existing bare URLs redirect into versioned space, the new route serves\nthem, and the whole module graph gets cached (costs one redirect per page view):\n\n```ts\nimport { serveImmutableFile } from \"https://esm.town/v/std/utils/index.ts\";\n\napp.get(\"/__immutable/*\", (c) => serveImmutableFile(c.req.path));\napp.get(\"/frontend/**/*\", (c) => serveImmutableFile(c.req.path)); // was serveFile\n```\n\n**Full upgrade (also removes the redirect):** three self-contained steps —\nno other files needed. Adjust the ``, favicon, and body of `Root()` to\nmatch your app's existing `index.html`, and stamp anything else your shell\nreferences directly (images, css) with `immutableFileUrl()`.\n\n1. Create `frontend/root.tsx`:\n\n```tsx\n/** @jsxImportSource npm:hono@4/jsx */\nimport { raw } from \"npm:hono@4/html\";\nimport { immutableFileUrl } from \"https://esm.town/v/std/utils/index.ts\";\n\n// The HTML shell for the app. It is never cached, so immutableFileUrl can stamp\n// the current val version into each asset URL — the browser caches those\n// immutably, and publishing the val changes the URLs, refetching exactly once.\nexport function Root() {\n return (\n <>\n {raw(\"<!DOCTYPE html>\")}\n <html lang=\"en\">\n <head>\n <meta charSet=\"UTF-8\" />\n <meta name=\"viewport\" content=\"width=device-width, initial-scale=1.0\" />\n <title>React Hono Val Town Starter\n

Diff · v48