`,\n `${esc(s.title)}

`,\n `${esc(meta(s))} · thread

${esc(s.summary)}

`,\n `

What HN is saying

`,\n );\n\n if (s.discussion.lead) {\n parts.push(`

${esc(s.discussion.lead)}

`);\n }\n\n parts.push(`

${esc(p.label)}

${label}${esc(p.text)}

`);\n\n parts.push(\n `

from ${s.commentsRead} comments and replies

/, else the whole document. */\nfunction mainContent(html: string): string {\n for (const t of [\"article\", \"main\"]) {\n const blocks = [...html.matchAll(new RegExp(`<${t}\\\\b[^>]*>([\\\\s\\\\S]*?)`, \"gi\"))]\n .map((m) => m[1])\n .sort((a, b) => b.length - a.length);\n if (blocks[0] && blocks[0].length > 500) return blocks[0];\n }\n return html.match(/]*>([\\s\\S]*?)<\\/body>/i)?.[1] ?? html;\n}\n\nexport async function fetchArticleText(url: string, maxChars: number): Promise {\n try {\n const res = await fetch(url, {\n headers: { \"user-agent\": USER_AGENT, accept: \"text/html,application/xhtml+xml\" },\n redirect: \"follow\",\n signal: AbortSignal.timeout(FETCH_TIMEOUT_MS),\n });\n if (!res.ok) return null;\n\n const type = res.headers.get(\"content-type\") ?? \"\";\n if (!/text\\/html|application\\/xhtml/i.test(type)) {\n await res.body?.cancel();\n return null;\n }\n const length = Number(res.headers.get(\"content-length\"));\n if (Number.isFinite(length) && length > MAX_BYTES) {\n await res.body?.cancel();\n return null;\n }\n\n const html = (await res.text()).slice(0, MAX_BYTES);\n const text = htmlToText(mainContent(html.replace(BOILERPLATE, \" \")));\n\n // Too short to be a real article — cookie wall, JS-only page, paywall stub\n if (text.length < 400) return null;\n return text.slice(0, maxChars);\n } catch {\n return null;\n }\n}\n",[224],"045b5582-2a10-4bdf-ba81-b4c97533cf6e","README.md","6dfc4c34-a257-11f1-9a7b-1607ee4eb77e",65,["D",1787865023038],8,"# hn-digest\n\nA daily email of the **top 5** Hacker News front-page stories, each with a summary of the\nlinked page and a summary of what the top comments are arguing about.\n\nSource is the official [HN Firebase API](https://github.com/HackerNews/API) — keyless and\nunauthenticated. Two cron jobs:\n\n| File | Schedule | Job |\n| --- | --- | --- |\n| `collect.ts` | hourly, `:07` | Record what's on the front page |\n| `main.ts` | `07:00 UTC` | Pick the top 5 and email them |\n\n## Why two jobs\n\n`topstories.json` is a live snapshot, so a single daily poll would miss anything that\npeaked overnight and fell off. The collector records every front-page story hourly into\n`hn-digest:pool`, keeping high-water marks for score and comment count. The digest then\npicks the highest **peak** score of the past 36 hours — a genuine top-of-day, not\nwhatever happened to be up at 07:00.\n\n## How the digest run works\n\n1. `pick()` takes the 5 highest-peak-score pool entries not already emailed.\n2. Each story is refetched for its live score and its `kids` list. **`kids` is in HN's own\n rank order** — comments carry no score in the API, so this is the only signal for \"top\n comment\". Algolia's `children` is chronological and `hnrss.org/item?id=` is\n reverse-chronological, so neither can rank.\n3. **Replies are fetched too** — 10 top-level comments, each with up to 3 replies (~25-35\n comments per story). This is not optional polish. Reply count tracks contention: on the\n Nvidia/Hugging Face thread the three most-replied top comments were \"what are they\n buying exactly?\" (11 replies), \"what is the business model?\" (12) and a prediction about\n banning quantized models (19). Top-level alone made the digest report *questions HN\n asked* instead of *what HN concluded* — the answers were all one level down. The prompt\n marks replies as replies so they aren't read as independent opinions.\n4. `article.ts` fetches the linked page and extracts text. Failures (paywalls, JS-only\n pages, video, PDFs) leave the summary leaning on the comments, and it says so. Ask/Show\n HN self-posts use the post body instead.\n5. `summarize.ts` makes one Claude call per story. No comments means no discussion section\n rather than an invented one. The discussion comes back as a framing line plus labelled\n bullets, parsed into `Discussion { lead, points[] }` — the shape follows the thread, so\n a genuine disagreement gets opposing bullets while a pile of corrections doesn't get\n forced into a fake two-sided split. `parseDiscussion` falls back to keeping the prose as\n a single unlabelled point if the model returns no bullets.\n6. `render.ts` builds the HTML + plain-text email, sent via `std/email`.\n7. The seen-set is written **after** the send succeeds, and only for stories that made it\n into the email. Anything that failed is retried on the next run. A blob read failure\n aborts the run rather than re-sending everything.\n\n## Env vars\n\n| Key | Required | Purpose |\n| --- | --- | --- |\n| `ANTHROPIC_API_KEY` | yes | Claude API |\n| `DIGEST_TO` | no | Recipient. Defaults to the val owner's address. |\n| `DIGEST_DRY_RUN` | no | `1` logs the email instead of sending it. |\n\n## Cost\n\nFive Claude calls a day on `claude-sonnet-5` — roughly **$2/month**.\n\n`claude-haiku-4-5` was measured against Sonnet on identical input for the same five\nstories and lost on specifics: it missed the Microduck's motor count, loop rate and\nlicence, missed three of the six argument threads on the Cloudflare post, and got the\nReachy Mini licence wrong. Haiku costs about $1/month less. Not worth it here, but the\n`model` argument to `summarize()` makes the comparison easy to re-run.\n\nThe collector makes ~31 HN API calls an hour; the digest makes ~5 × 31. All free.\n\n## Tuning\n\nKnobs at the top of `main.ts`: `DIGEST_SIZE`, `MIN_SCORE`, `MAX_AGE_HOURS`,\n`TOP_COMMENTS`, `REPLIES_PER_COMMENT`, `ARTICLE_MAX_CHARS`. `WATCH_TOP` and `POOL_TTL_DAYS` are in\n`collect.ts`. Prompt and tone live in `SYSTEM` in `summarize.ts`.\n",[231],"pulls","branches","forks","envVars",{"_245":35,"_247":92},"connections",{"_245":92,"_246":92},"count","unfilledCount","emptyCount",{"_28":230,"_13":231,"_59":232,"_38":-5,"_30":31,"_165":233,"_167":168,"_32":286,"_34":235,"_62":50,"_170":236,"_64":24,"_172":-5,"_259":287,"_130":288},{"_28":223,"_13":224,"_59":225,"_38":-5,"_30":31,"_165":226,"_167":168,"_32":283,"_34":193,"_62":76,"_170":228,"_64":24,"_172":-5,"_259":284,"_130":285},{"_28":216,"_13":217,"_59":218,"_38":-5,"_30":31,"_165":219,"_167":168,"_32":280,"_34":92,"_62":63,"_170":221,"_64":24,"_172":-5,"_259":281,"_130":282},{"_28":209,"_13":210,"_59":211,"_38":-5,"_30":31,"_165":212,"_167":168,"_32":277,"_34":35,"_62":76,"_170":214,"_64":24,"_172":-5,"_259":278,"_130":279},{"_28":202,"_13":203,"_59":204,"_38":-5,"_30":31,"_165":205,"_167":168,"_32":274,"_34":92,"_62":76,"_170":207,"_64":24,"_172":-5,"_259":275,"_130":276},{"_28":196,"_13":61,"_59":60,"_38":-5,"_30":31,"_165":197,"_167":168,"_32":271,"_34":199,"_62":63,"_170":200,"_64":24,"_172":-5,"_259":272,"_130":273},{"_28":188,"_13":189,"_59":190,"_38":-5,"_30":31,"_165":191,"_167":168,"_32":268,"_34":193,"_62":76,"_170":194,"_64":24,"_172":-5,"_259":269,"_130":270},{"_28":181,"_13":182,"_59":183,"_38":-5,"_30":31,"_165":184,"_167":168,"_32":265,"_34":35,"_62":76,"_170":186,"_64":24,"_172":-5,"_259":266,"_130":267},{"_28":174,"_13":175,"_59":176,"_38":-5,"_30":31,"_165":115,"_167":168,"_32":262,"_34":178,"_62":76,"_170":179,"_64":24,"_172":-5,"_259":263,"_130":264},{"_28":162,"_13":163,"_59":164,"_38":-5,"_30":31,"_165":166,"_167":168,"_32":258,"_34":92,"_62":76,"_170":171,"_64":24,"_172":-5,"_259":260,"_130":261},["D",1787863854757],"children",[],[163],["D",1788205851780],[],[175],["D",1787863898404],[],[182],["D",1787864951620],[],[189],["D",1787864990917],[],[61],["D",1787863849452],[],[203],["D",1787864744015],[],[210],["D",1787863922615],[],[217],["D",1787863924903],[],[224],["D",1787865023038],[],[231],["D",1787862662938],["D",1789545036283],{"_11":12,"_129":67},{"_11":12,"_124":125,"_66":67,"_25":65,"_126":127,"_128":24},{"_34":115,"_13":16,"_28":31,"_116":77,"_117":-5,"_118":-5,"_119":-5,"_120":-5,"_121":-5,"_122":14,"_123":12},"ctx",{"_48":-5,"_149":327,"_328":329,"_330":331,"_332":24,"_333":24,"_334":24,"_335":168,"_336":-5,"_337":-7,"_338":-7,"_339":92,"_340":24,"_341":24,"_342":-5,"_343":24,"_344":24,"_345":24,"_346":-5},"ENV",{"_298":299,"_300":301,"_302":16,"_303":304,"_305":306,"_307":308,"_309":310,"_311":312,"_313":314,"_315":316,"_317":318,"_319":320,"_321":322,"_323":324,"_325":326},"REACT_APP_SENTRY_DSN","https://586020d86f05489db63a554690acf1e9@o1398359.ingest.sentry.io/6724499","RENDER_GIT_COMMIT","fdb67791413f4386b4dbf18f354029a617f6160f","RENDER_GIT_BRANCH","POSTHOG_API_TOKEN","phc_nmoyuAkStEZuUp69rYlg1DZgrIt19Gx0Y4Hwf8tGgJP","POSTHOG_API_HOST","https://wart.val.town","WEB_API_TEMPLATE","https://{val}.web.val.run","APP_URL","https://www.val.town","MODULE_URL","https://esm.town","VANITY_WEB_API_TEMPLATE","https://{label}.val.run/","DENOLS_URL","https://lsp.val.town","NODE_ENV","production","CLOUDFLARE_TURNSTILE_SITE_KEY","0x4AAAAAACtaIZJH7s9rBMZ6","GOOGLE_CLIENT_ID","875989696899-jtsqkhlbdv5jrlsk8631p7ipjg3c6o62.apps.googleusercontent.com","STRIPE_PUBLISHABLE_KEY","pk_live_51N2zvWEpZTTLipIkVEwXrUG9AT0yeOOEYxszarZT1jpsZV58Ly6wlg3SltZpHN26CUalOBmUSY7adQRQiSkCZz2500qSXNkf8Y","API_URL","https://api.val.town",[],"preferencesKeybindings","default","preferencesTheme","light","preferencesFixers","preferencesCopilot","preferencesSelectionAi","preferencesCloseBrackets","preferencesChatPanelState","preferencesDprint","preferencesDenofmt","notificationCount","flagDenols","isBusinessOrgMember","businessOrgHandle","isBusinessOrgAdmin","isHigherTownieTier","navCollapsed","currentOrgId"]

History