${esc(e.title)}

[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10},"actionData","errors","root",{"_207":208,"_209":210},"routes/_app.x.$handle.$name",{"_11":12,"_13":14,"_15":16,"_18":19,"_17":-7,"_157":-5,"_20":158,"_22":159,"_160":161,"_162":163,"_26":164,"_24":165,"_166":-5,"_167":-5,"_168":52,"_169":170,"_171":43,"_172":-5,"_173":-5,"_174":175},"routes/_app.x.$handle.$name.branch.$branch.code.$",{"_11":12,"_13":14,"_15":16,"_17":-7,"_18":19,"_20":21,"_22":23,"_24":25,"_26":27,"_28":-5,"_29":-5,"_30":-5,"_31":-5,"_32":-5},"handle","ivryb","name","pg-essays-rss","branchName","main","version","path","scraper.ts","project",{"_33":100,"_13":14,"_44":101,"_102":-5,"_103":52,"_104":105,"_106":105,"_107":108,"_109":-5,"_110":111,"_112":83,"_113":43,"_114":-5,"_115":-5,"_116":65,"_117":118,"_119":120,"_121":122,"_123":124,"_125":-5,"_126":127,"_128":127,"_129":130,"_131":130,"_132":130,"_133":127,"_134":127,"_135":136,"_137":138,"_139":140,"_141":52},"tree",[55,56,57,58,59],"file",{"_33":34,"_13":19,"_35":36,"_37":-5,"_38":39,"_40":41,"_42":43,"_44":45,"_17":46,"_47":48,"_49":50,"_51":52,"_53":-5,"_18":54},"contents",[],"upstream","pull","ahead","behind","envVars","id","bbde1170-a930-438b-ab67-49886fad641c","fileId","232ef9e2-a052-11f1-969b-1607ee4eb77e","parentId","branchId","adc2f96c-f87b-444e-97b5-b08189b7e0e6","branchVersion",13,"latest",true,"createdAt",["D",1787723227835],4,"fileType","script","content","import { blob } from \"https://esm.town/v/std/blob/main.ts\";\n\nexport const BASE = \"https://paulgraham.com\";\n\n// Blob key holding the cached feed data. Using blob storage (not SQLite) keeps\n// the feed independent of the libsql client, which has been flaky on Deno.\nconst KEY = \"pg-essays-cache\";\n\ninterface CacheEntry {\n title: string;\n date: string | null;\n position: number;\n}\n\ninterface Cache {\n lastCheck: string | null;\n essays: Record;\n}\n\n// Files on paulgraham.com that are in articles.html but aren't essays.\nconst EXCLUDE = new Set([\n \"/index.html\",\n \"/bio.html\",\n \"/rss.html\",\n \"/rss.xml\",\n \"/feed.xml\",\n]);\n\nasync function readCache(): Promise {\n const c = await blob.getJSON(KEY);\n return c ?? { lastCheck: null, essays: {} };\n}\n\nasync function writeCache(c: Cache): Promise {\n await blob.setJSON(KEY, c);\n}\n\nasync function fetchIndexHtml(): Promise {\n const res = await fetch(`${BASE}/articles.html`);\n if (!res.ok) throw new Error(`articles.html: HTTP ${res.status}`);\n return await res.text();\n}\n\n/** Parse the ordered (newest-first) list of essay links from the index. */\nexport function parseIndex(html: string): { title: string; url: string }[] {\n const out: { title: string; url: string }[] = [];\n const re = /]*>([\\s\\S]*?)<\\/a>/gi;\n let m: RegExpExecArray | null;\n while ((m = re.exec(html)) !== null) {\n let href = m[1];\n const text = m[2].replace(/<[^>]+>/g, \"\").replace(/\\s+/g, \" \").trim();\n if (href.startsWith(BASE)) href = new URL(href).pathname;\n // Normalize bare relative hrefs (e.g. \"greatwork.html\") to \"/greatwork.html\".\n if (!href.startsWith(\"/\")) href = \"/\" + href.split(/[?#]/)[0];\n const clean = href.split(/[?#]/)[0];\n if (!clean.endsWith(\".html\")) continue;\n if (EXCLUDE.has(clean)) continue;\n if (!text) continue;\n out.push({ title: text, url: clean });\n }\n const seen = new Set();\n return out.filter((x) => (seen.has(x.url) ? false : (seen.add(x.url), true)));\n}\n\n/**\n * Best-effort publication date from Hacker News: the earliest paulgraham.com\n * submission of the essay. Returns an ISO string or null.\n */\nasync function hnDate(title: string): Promise {\n try {\n const q = encodeURIComponent(title);\n const res = await fetch(\n `https://hn.algolia.com/api/v1/search?query=${q}&tags=story&hitsPerPage=50`,\n );\n if (!res.ok) return null;\n const data = await res.json();\n const hits: any[] = data.hits ?? [];\n let min: number | null = null;\n for (const h of hits) {\n let host = \"\";\n try {\n host = h.url ? new URL(h.url).hostname : \"\";\n } catch {\n host = \"\";\n }\n if (host === \"paulgraham.com\" || host.endsWith(\".paulgraham.com\")) {\n if (typeof h.created_at_i === \"number\" &&\n (min === null || h.created_at_i < min)) {\n min = h.created_at_i;\n }\n }\n }\n if (min === null) return null;\n return new Date(min * 1000).toISOString();\n } catch {\n return null;\n }\n}\n\n/** Run a list of async tasks with limited concurrency. */\nasync function mapLimit(\n items: T[],\n limit: number,\n fn: (item: T) => Promise,\n): Promise {\n const out: R[] = new Array(items.length);\n let next = 0;\n async function worker() {\n while (next < items.length) {\n const idx = next++;\n out[idx] = await fn(items[idx]);\n }\n }\n const workers = Array.from({ length: Math.min(limit, items.length) }, worker);\n await Promise.all(workers);\n return out;\n}\n\n/**\n * Refresh the cache: fetch the index, add any new essays (resolving their\n * dates), and backfill essays that still lack a date.\n */\nexport async function refresh(): Promise {\n const cache = await readCache();\n\n const html = await fetchIndexHtml();\n const list = parseIndex(html);\n\n // New essays plus known essays that are still missing a date.\n const needDate: { title: string; url: string; position: number }[] = [];\n for (let i = 0; i < list.length; i++) {\n const e = list[i];\n const existing = cache.essays[e.url];\n if (!existing || existing.date === null) {\n needDate.push({ title: e.title, url: e.url, position: i });\n }\n }\n\n const dated = await mapLimit(needDate, 8, async (e) => ({\n ...e,\n date: await hnDate(e.title),\n }));\n\n for (const e of dated) {\n cache.essays[e.url] = { title: e.title, date: e.date, position: e.position };\n }\n\n cache.lastCheck = new Date().toISOString();\n await writeCache(cache);\n}\n\n/** Timestamp (ms) of the last successful check, or 0. */\nexport async function lastChecked(): Promise {\n const c = await readCache();\n if (!c.lastCheck) return 0;\n const v = Date.parse(c.lastCheck);\n return Number.isNaN(v) ? 0 : v;\n}\n\nexport interface Essay {\n title: string;\n url: string;\n date: string | null;\n}\n\n/** All essays, newest first (by date, then list position). */\nexport async function fetchEssays(): Promise {\n const c = await readCache();\n const essays = Object.entries(c.essays).map(([url, e]) => ({\n url,\n title: e.title,\n date: e.date,\n position: e.position,\n }));\n essays.sort((a, b) => {\n const da = a.date ? Date.parse(a.date) : -Infinity;\n const db = b.date ? Date.parse(b.date) : -Infinity;\n if (db !== da) return db - da;\n return a.position - b.position;\n });\n return essays.map(({ url, title, date }) => ({ url, title, date }));\n}\n\nexport function esc(s: string): string {\n return s.replace(/&/g, \"&\").replace(//g, \">\")\n .replace(/\"/g, \""\");\n}\n\nexport function buildRss(essays: Essay[], selfUrl: string): string {\n const items = essays.map((e) => {\n const link = BASE + e.url;\n const dateEl = e.date ? `${new Date(e.date).toUTCString()}` : \"\";\n const desc = `${esc(e.title)} (Paul Graham).`;\n return `\\n ${esc(e.title)}\\n ${esc(link)}\\n ${esc(link)}\\n ${dateEl}\\n ${desc}\\n `;\n }).join(\"\\n \");\n\n return `\n\n \n Paul Graham’s Essays\n ${BASE}/articles.html\n Paul Graham’s essays, updated automatically from paulgraham.com.\n \n ${items}\n \n`;\n}\n","deleted",false,"label",[19],{"_33":92,"_13":93,"_35":94,"_37":-5,"_38":39,"_40":95,"_42":43,"_44":96,"_17":86,"_47":24,"_49":97,"_51":52,"_53":-5,"_67":98,"_18":99},{"_33":81,"_13":82,"_35":83,"_37":-5,"_38":39,"_40":84,"_42":43,"_44":85,"_17":86,"_47":87,"_49":88,"_51":52,"_53":89,"_67":90,"_18":91},{"_33":73,"_13":74,"_35":75,"_37":-5,"_38":39,"_40":46,"_42":43,"_44":76,"_17":65,"_47":77,"_49":78,"_51":52,"_53":-5,"_67":79,"_18":80},{"_33":34,"_13":19,"_35":36,"_37":-5,"_38":39,"_40":41,"_42":43,"_44":70,"_17":46,"_47":48,"_49":50,"_51":52,"_53":-5,"_67":71,"_18":72},{"_33":60,"_13":61,"_35":62,"_37":-5,"_38":39,"_40":63,"_42":43,"_44":64,"_17":65,"_47":48,"_49":66,"_51":52,"_53":-5,"_67":68,"_18":69},"a403e767-7252-4066-90cf-24f609598c7a","seed.ts","35620348-a052-11f1-ad19-1607ee4eb77e",5,["D",1787641036851],0,"import { refresh, fetchEssays } from \"./scraper.ts\";\n\n// One-time backfill: fetch the full essay index and resolve publication dates\n// for every essay. Run via: run_file ivryb/pg-essays-rss seed.ts\nawait refresh();\nconst essays = await fetchEssays();\nconst withDate = essays.filter((e) => e.date).length;\nconsole.log(`Seeded ${essays.length} essays (${withDate} with a date).`);\n","children",[],[61],["D",1787723227835],[],[19],"6433f1e8-7233-4671-844d-e203a5eb4281","refresh.ts","355c0934-a052-11f1-ad19-1607ee4eb77e",["D",1787641036812],"interval","import { refresh } from \"./scraper.ts\";\n\n/** Keeps the cached essay index warm so feed requests stay fast. */\nexport default async function (): Promise {\n await refresh();\n console.log(\"pg-essays-rss refreshed\");\n}\n",[],[74],"4ec4e561-382c-40ec-bc47-0c60403a86fb","main.ts","149b5f88-a052-11f1-aaa5-1607ee4eb77e",6,["D",1787641040914],1,"http","import { refresh, lastChecked, fetchEssays, buildRss } from \"./scraper.ts\";\n\n// Re-check the index at most hourly on request; the interval job keeps it warm\n// in between so responses are fast.\nconst STALE_MS = 60 * 60 * 1000;\n\nexport default async function handler(req: Request): Promise {\n try {\n const checked = await lastChecked();\n if (Date.now() - checked >= STALE_MS) {\n await refresh();\n }\n } catch (err) {\n // Don't fail the request if a refresh hiccups — serve stale data if we have it.\n console.error(\"refresh failed:\", err);\n }\n\n const essays = await fetchEssays();\n if (essays.length === 0) {\n return new Response(\"Feed not ready yet — try again in a minute.\", {\n status: 503,\n });\n }\n\n const xml = buildRss(essays, req.url);\n return new Response(xml, {\n status: 200,\n headers: { \"Content-Type\": \"application/rss+xml; charset=utf-8\" },\n });\n}\n","pg-essays",[],[82],"4a1712f7-3d6a-4a46-a03c-3f1d949a2d6f","README.md","6fa9c69e-a052-11f1-a3d2-1607ee4eb77e",14,["D",1787723249634],"# pg-essays-rss\n\nAn automatically-updated RSS feed of **[Paul Graham's essays](https://paulgraham.com/articles.html)**.\n\n**Feed URL:** \n\n## How it works\n\n- `scraper.ts` fetches `articles.html`, parses the ordered list of essays, and resolves each essay's publication date from the earliest `paulgraham.com` submission on the Hacker News Algolia API. The feed data is cached as a single JSON document in the val's **blob storage** (`std/blob`), which keeps it independent of the SQLite client.\n- `main.ts` (HTTP) serves an RSS 2.0 feed from that cache. When a request finds the cache older than an hour it re-checks the index (cheap) and only resolves dates for newly-seen essays, so responses stay fast.\n- `refresh.ts` (interval, cron `0 */3 * * *` UTC) keeps the index warm between requests.\n- `seed.ts` is a one-time backfill script — run it once to populate the database with all ~230 essays and their dates (`run_file ivryb/pg-essays-rss seed.ts`).\n\nNew essays are picked up the next time the index is re-checked (hourly on request, or every 3 hours via the interval), so the feed stays current without hitting Paul Graham's server on every read.\n\n## Notes\n\n- Publication dates are approximate (inferred from Hacker News submissions).\n- The archive contains ~230 items; some very old essays predating Hacker News may have no date.\n\n## Files\n\n| File | Type | Purpose |\n| --- | --- | --- |\n| `main.ts` | http | Serves the RSS feed at `/` |\n| `scraper.ts` | script | Index scraping, date resolution, caching |\n| `refresh.ts` | interval | Warm-up job (every 3 hours) |\n| `seed.ts` | script | One-time backfill |\n",[],[93],"af97ad78-f1f9-48ff-a00d-c401c8b9b233",["D",1787640981828],"deletedAt","legacyEnvVars","privacy","public","httpPrivacy","description","RSS feed of Paul Graham's essays","imageUrl","userId","41fc127f-5d67-4e9d-aaf5-7f1531438361","pinnedFileId","pinPreview","pinMigrated","screenshotVersion","likeCount","orgId","9dd2e27d-d103-40dd-bb45-da8e837d341a","tursoName","af97ad78f1f948ffa00dc401c8b9b233","tursoHostname","af97ad78f1f948ffa00dc401c8b9b233-val-town.aws-us-east-2.turso.io","tursoMeasuredAt",["D",1789555289887],"pinned","userPerm","r","valPerm","blobPerm","rw","emailPerm","sqlitePerm","projectPerm","telemetryPerm","user",{"_11":12,"_156":152},"org",{"_11":12,"_150":-5,"_151":152,"_110":111,"_153":154,"_155":52},"branch",{"_17":95,"_13":16,"_33":39,"_142":100,"_143":-5,"_144":-5,"_145":-5,"_146":-5,"_147":-5,"_148":14,"_149":12},"isOwned","projectId","forkedBranchId","forkedBranchVersion","forkedProjectPrivacy","forkedProjectId","forkedProjectOrgId","projectName","userHandle","displayName","avatar","https://img.clerk.com/eyJ0eXBlIjoicHJveHkiLCJzcmMiOiJodHRwczovL2ltYWdlcy5jbGVyay5kZXYvb2F1dGhfZ2l0aHViL2ltZ18yZkFtS1dWcU5NYWRjQkN5MGVCUTVRS0Z5SkEifQ","tier","free","canRestrictVals","profileImageUrl","adoptOrgId",{"_33":100,"_13":14,"_44":202,"_102":-5,"_103":52,"_104":105,"_106":105,"_107":108,"_109":-5,"_110":111,"_112":83,"_113":43,"_114":-5,"_115":-5,"_116":65,"_117":118,"_119":120,"_121":122,"_123":203,"_125":-5,"_126":127,"_128":127,"_129":130,"_131":130,"_132":130,"_133":127,"_134":127,"_135":204,"_137":205,"_139":206,"_141":52},[187,188,189,190,191],"files",[187,188,189,190,191],"counts",{"_177":65,"_178":86,"_179":180,"_32":181,"_182":183},[],{"_33":34,"_13":19,"_35":36,"_37":-5,"_38":39,"_40":41,"_42":43,"_44":45,"_17":46,"_47":48,"_49":50,"_51":52,"_53":-5,"_18":176},"upstreamProject","upstreamBranch","emptyEnvVars","flags",[],"hasHttpFiles","grants","orgs","customDomains",{},[19],"pulls","branches","forks",3,{"_184":65,"_186":65},"connections",{"_184":65,"_185":65},"count","unfilledCount","emptyCount",{"_33":92,"_13":93,"_35":94,"_37":-5,"_38":39,"_40":95,"_42":43,"_44":96,"_17":86,"_47":24,"_49":97,"_51":52,"_53":-5,"_67":200,"_18":201},{"_33":81,"_13":82,"_35":83,"_37":-5,"_38":39,"_40":84,"_42":43,"_44":85,"_17":86,"_47":87,"_49":88,"_51":52,"_53":89,"_67":198,"_18":199},{"_33":73,"_13":74,"_35":75,"_37":-5,"_38":39,"_40":46,"_42":43,"_44":76,"_17":65,"_47":77,"_49":78,"_51":52,"_53":-5,"_67":196,"_18":197},{"_33":34,"_13":19,"_35":36,"_37":-5,"_38":39,"_40":41,"_42":43,"_44":70,"_17":46,"_47":48,"_49":50,"_51":52,"_53":-5,"_67":194,"_18":195},{"_33":60,"_13":61,"_35":62,"_37":-5,"_38":39,"_40":63,"_42":43,"_44":64,"_17":65,"_47":48,"_49":66,"_51":52,"_53":-5,"_67":192,"_18":193},[],[61],[],[19],[],[74],[],[82],[],[93],["D",1787640981828],["D",1789555289887],{"_11":12,"_156":152},{"_11":12,"_150":-5,"_151":152,"_110":111,"_153":154,"_155":52},{"_17":95,"_13":16,"_33":39,"_142":100,"_143":-5,"_144":-5,"_145":-5,"_146":-5,"_147":-5,"_148":14,"_149":12},"ctx",{"_135":-5,"_173":240,"_241":242,"_243":244,"_245":52,"_246":52,"_247":52,"_248":43,"_249":-5,"_250":-7,"_251":-7,"_252":65,"_253":52,"_254":52,"_255":-5,"_256":52,"_257":52,"_258":52,"_259":-5},"ENV",{"_211":212,"_213":214,"_215":16,"_216":217,"_218":219,"_220":221,"_222":223,"_224":225,"_226":227,"_228":229,"_230":231,"_232":233,"_234":235,"_236":237,"_238":239},"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"]