`, 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",{"_111":110,"_38":56,"_119":101,"_33":120,"_13":14,"_121":-5,"_11":122,"_123":124,"_125":126,"_127":128,"_129":130,"_27":-5,"_131":-5,"_132":-5,"_133":31,"_134":135,"_136":70,"_137":-5,"_138":-5,"_139":140},"routes/_app.x.$handle.$name.branch.$branch.version.$version.diff",{"_11":12,"_13":14,"_15":16,"_17":18,"_19":-5},"project",{"_54":55,"_38":56,"_42":57,"_58":-5,"_59":31,"_60":61,"_62":61,"_63":64,"_65":-5,"_19":66,"_67":68,"_69":70,"_71":-5,"_72":-5,"_73":74,"_75":76,"_77":78,"_79":80,"_81":82,"_83":-5,"_84":85,"_86":85,"_87":88,"_89":88,"_90":88,"_91":85,"_92":85,"_93":94,"_95":96,"_97":98,"_99":31},"version",47,"changes",[25,26],"aiChatInfo",{"_20":21,"_22":-5,"_23":-5,"_24":-5},"userId","aiChatMessageId","735176c0-7384-4a9c-a4ed-f8b6b3904eaa","aiChatThreadId","aiChatThreadUserId","aiChatThreadTitle",{"_27":47,"_29":-7,"_30":31,"_32":31,"_33":48,"_35":48},{"_27":28,"_29":-7,"_30":31,"_32":31,"_33":34,"_35":34},"file",{"_36":37,"_38":34,"_39":40,"_41":-5,"_42":43,"_44":14,"_45":46,"_30":31},"previous","deleted",false,"deletedHere","path","cron","latestPath","fileId","b9bc53b3-78bb-4672-b27a-17d3d4af376b","name","fileType","directory","content","createdAt",["D",1788493780394],"branchVersion","branchId","faea9245-6732-47d9-a1a2-3550998bc296",{"_36":49,"_38":50,"_39":51,"_41":52,"_42":53,"_44":14,"_45":46,"_30":31},"cron/hunt.ts","a828a7f6-a813-11f1-8400-1607ee4eb77e","hunt.ts","interval","// cron/hunt.ts\n// Scheduled hunt poller. Runs every interval; pulls genuine inquiries from the\n// configured real source (DLX_HUNT_URL) into the pipeline. Safe to run\n// repeatedly — duplicates are skipped by the unique email constraint.\nimport { hunt } from \"../backend/hunt.ts\";\n\nexport default async function (interval: Interval) {\n await hunt(interval.lastRunAt ?? new Date());\n}\n",["D",1788493780394],"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",{"_111":110,"_118":-5},"org",{"_111":110,"_112":113,"_114":-5,"_19":-5,"_115":116,"_117":31},"branch",{"_13":100,"_38":101,"_54":46,"_102":55,"_103":-5,"_104":-5,"_105":-5,"_106":-5,"_107":-5,"_108":56,"_109":110},"isOwned",88,"main","projectId","forkedBranchId","forkedBranchVersion","forkedProjectPrivacy","forkedProjectId","forkedProjectOrgId","projectName","userHandle","dlxdesigns","handle","displayName","DLXdesigns ","avatar","tier","free","canRestrictVals","profileImageUrl","branchName","","adoptOrgId",{"_54":55,"_38":56,"_42":397,"_58":-5,"_59":31,"_60":61,"_62":61,"_63":64,"_65":-5,"_19":66,"_67":68,"_69":70,"_71":-5,"_72":-5,"_73":74,"_75":76,"_77":78,"_79":80,"_81":398,"_83":-5,"_84":85,"_86":85,"_87":88,"_89":88,"_90":88,"_91":85,"_92":85,"_93":399,"_95":400,"_97":401,"_99":31},"tree",[218,225,227,229,237,239,241,242,243],"files",[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,243],"counts",{"_208":74,"_209":173,"_210":74,"_211":212,"_213":214},"contents",[141,142,143,144,145,146,147,148,149],"upstreamProject","upstreamBranch","emptyEnvVars","flags",[],"hasHttpFiles","grants","orgs","customDomains",{},{"_54":203,"_38":204,"_36":205,"_152":-5,"_45":46,"_44":156,"_154":70,"_42":206,"_13":74,"_39":40,"_41":-5,"_30":31,"_159":-5,"_33":207},{"_54":200,"_38":34,"_36":37,"_152":-5,"_45":46,"_44":14,"_154":70,"_42":201,"_13":74,"_39":40,"_41":-5,"_30":31,"_159":-5,"_33":202},{"_54":194,"_38":195,"_36":196,"_152":-5,"_45":46,"_44":197,"_154":70,"_42":198,"_13":74,"_39":40,"_41":-5,"_30":31,"_159":-5,"_33":199},{"_54":189,"_38":190,"_36":191,"_152":-5,"_45":46,"_44":173,"_154":70,"_42":192,"_13":74,"_39":40,"_41":-5,"_30":31,"_159":-5,"_33":193},{"_54":183,"_38":184,"_36":185,"_152":-5,"_45":46,"_44":186,"_154":70,"_42":187,"_13":74,"_39":40,"_41":-5,"_30":31,"_159":-5,"_33":188},{"_54":177,"_38":178,"_36":179,"_152":-5,"_45":46,"_44":180,"_154":70,"_42":181,"_13":74,"_39":40,"_41":-5,"_30":31,"_159":-5,"_33":182},{"_54":170,"_38":171,"_36":172,"_152":-5,"_45":46,"_44":173,"_154":70,"_42":174,"_13":74,"_39":27,"_41":175,"_30":31,"_159":-5,"_33":176},{"_54":162,"_38":163,"_36":164,"_152":-5,"_45":46,"_44":165,"_154":31,"_42":166,"_13":167,"_39":27,"_41":168,"_30":31,"_159":-5,"_33":169},{"_54":150,"_38":151,"_36":68,"_152":-5,"_45":46,"_44":153,"_154":31,"_42":155,"_13":156,"_39":157,"_41":158,"_30":31,"_159":160,"_33":161},"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",[151],"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",[163],"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 · v47