`,\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",[],[374],"045b5582-2a10-4bdf-ba81-b4c97533cf6e","README.md","6dfc4c34-a257-11f1-9a7b-1607ee4eb77e",65,["D",1787865023038],"# 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",[],[382],["D",1787862662938],["D",1789545036283],{"_11":12,"_260":85},{"_11":12,"_255":256,"_84":85,"_30":83,"_257":258,"_259":24},{"_54":246,"_13":16,"_48":51,"_247":209,"_248":-5,"_249":-5,"_250":-5,"_251":-5,"_252":-5,"_253":14,"_254":12},"ctx",{"_68":-5,"_279":427,"_428":429,"_430":431,"_432":24,"_433":24,"_434":24,"_435":285,"_436":-5,"_437":-7,"_438":-7,"_439":26,"_440":24,"_441":24,"_442":-5,"_443":24,"_444":24,"_445":24,"_446":-5},"ENV",{"_398":399,"_400":401,"_402":16,"_403":404,"_405":406,"_407":408,"_409":410,"_411":412,"_413":414,"_415":416,"_417":418,"_419":420,"_421":422,"_423":424,"_425":426},"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 · main.ts