`,\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",[237],"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",[244],"pulls","branches","forks","envVars",{"_258":195,"_260":26},"connections",{"_258":26,"_259":26},"count","unfilledCount","emptyCount",{"_34":243,"_13":244,"_65":245,"_44":-5,"_36":37,"_175":246,"_177":88,"_38":299,"_40":248,"_67":21,"_179":249,"_69":24,"_181":-5,"_272":300,"_17":301},{"_34":236,"_13":237,"_65":238,"_44":-5,"_36":37,"_175":239,"_177":88,"_38":296,"_40":203,"_67":68,"_179":241,"_69":24,"_181":-5,"_272":297,"_17":298},{"_34":229,"_13":230,"_65":231,"_44":-5,"_36":37,"_175":232,"_177":88,"_38":293,"_40":26,"_67":212,"_179":234,"_69":24,"_181":-5,"_272":294,"_17":295},{"_34":222,"_13":223,"_65":224,"_44":-5,"_36":37,"_175":225,"_177":88,"_38":290,"_40":195,"_67":68,"_179":227,"_69":24,"_181":-5,"_272":291,"_17":292},{"_34":215,"_13":216,"_65":217,"_44":-5,"_36":37,"_175":218,"_177":88,"_38":287,"_40":26,"_67":68,"_179":220,"_69":24,"_181":-5,"_272":288,"_17":289},{"_34":206,"_13":207,"_65":208,"_44":-5,"_36":37,"_175":209,"_177":88,"_38":284,"_40":211,"_67":212,"_179":213,"_69":24,"_181":-5,"_272":285,"_17":286},{"_34":198,"_13":199,"_65":200,"_44":-5,"_36":37,"_175":201,"_177":88,"_38":281,"_40":203,"_67":68,"_179":204,"_69":24,"_181":-5,"_272":282,"_17":283},{"_34":190,"_13":191,"_65":192,"_44":-5,"_36":37,"_175":193,"_177":88,"_38":278,"_40":195,"_67":68,"_179":196,"_69":24,"_181":-5,"_272":279,"_17":280},{"_34":183,"_13":184,"_65":185,"_44":-5,"_36":37,"_175":127,"_177":88,"_38":275,"_40":187,"_67":68,"_179":188,"_69":24,"_181":-5,"_272":276,"_17":277},{"_34":172,"_13":173,"_65":174,"_44":-5,"_36":37,"_175":176,"_177":88,"_38":271,"_40":26,"_67":68,"_179":180,"_69":24,"_181":-5,"_272":273,"_17":274},["D",1787863854757],"children",[],[173],["D",1788205851780],[],[184],["D",1787863898404],[],[191],["D",1787864951620],[],[199],["D",1787864990917],[],[207],["D",1787863849452],[],[216],["D",1787864744015],[],[223],["D",1787863922615],[],[230],["D",1787863924903],[],[237],["D",1787865023038],[],[244],["D",1787862662938],["D",1789545036283],{"_11":12,"_141":72},{"_11":12,"_136":137,"_71":72,"_30":70,"_138":139,"_140":24},{"_40":127,"_13":16,"_34":37,"_128":90,"_129":-5,"_130":-5,"_131":-5,"_132":-5,"_133":-5,"_134":14,"_135":12},"ctx",{"_55":-5,"_159":340,"_341":342,"_343":344,"_345":24,"_346":24,"_347":24,"_348":88,"_349":-5,"_350":-7,"_351":-7,"_352":26,"_353":24,"_354":24,"_355":-5,"_356":24,"_357":24,"_358":24,"_359":-5},"ENV",{"_311":312,"_313":314,"_315":16,"_316":317,"_318":319,"_320":321,"_322":323,"_324":325,"_326":327,"_328":329,"_330":331,"_332":333,"_334":335,"_336":337,"_338":339},"REACT_APP_SENTRY_DSN","https://586020d86f05489db63a554690acf1e9@o1398359.ingest.sentry.io/6724499","RENDER_GIT_COMMIT","e87eb04e707cf64e7e532c8e8ec395f209e17f15","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 · _compare.ts