🖤 Black Hat Hydrology Lab

San Juan River forecast experiment · Current season ${current} ·\nraw JSON

`;\n\n // Film room first: all completed seasons, most recent first.\n const completed = [...bySeason.keys()].filter((s) => s !== current).sort().reverse();\n for (const season of completed) {\n body +=\n `

Film room — ${season}

${seasonTable(bySeason.get(season)!, season)}

`;\n }\n // Current / active season last.\n body +=\n `

Current season — ${current}

${seasonTable(bySeason.get(current) ?? [], current)}

`;\n\n return new Response(layout(body), {\n headers: { \"content-type\": \"text/html; charset=utf-8\" },\n });\n}\n\nfunction seasonTable(recs: Array>, season: string): string {\n if (!recs.length) return `

No predictions locked yet for ${season}.

`;\n const rows = recs\n .map((r) => {\n const f = r.forecast as { headline: string; model_version: string };\n const s = r.score == null\n ? \"—\"\n : `= 0 ? \"win\" : \"loss\"}\">${r.score}`;\n return `${r.issue_date}${f.headline}${f.model_version}${s}`;\n })\n .join(\"\");\n return `${rows}

Issue	Forecast	Model	Score

`;\n}\n\nfunction authorized(req: Request): boolean {\n const secret = Deno.env.get(\"BH_LAB_SECRET\");\n if (!secret) return true; // no secret set → allow while building\n return req.headers.get(\"x-lab-secret\") === secret;\n}\n\nfunction jsonResponse(data: unknown, status = 200): Response {\n return new Response(JSON.stringify(data, null, 2), {\n status,\n headers: { \"content-type\": \"application/json\" },\n });\n}\n",[223],"cd4e6e69-78bd-4cf6-b43c-911ea0c17652","first400-trees-5.ts","480a27d2-ab9c-11f1-9a57-1607ee4eb77e",47,["D",1788882319621],[229],"ff4cade3-377c-486f-8c32-07fb15d4b8f1","first400-trees-4.ts","443c880c-ab9c-11f1-abb3-1607ee4eb77e",45,["D",1788882312683],[235],"82ac7bdc-eb46-4a8d-87cd-70644e230d73","first400-trees-3.ts","420ad214-ab9c-11f1-8ed7-1607ee4eb77e",43,["D",1788882306326],[241],"00e5f497-a106-4771-925a-87050315d243","first400-trees-2.ts","3df70fa8-ab9c-11f1-a43c-1607ee4eb77e",41,["D",1788882302686],[247],"1830c816-3f3d-4665-81c8-75dff77b9f4a","first400-trees-1.ts","41098f18-ab9c-11f1-99ad-1607ee4eb77e",54,["D",1788882510486],[253],"207f3d62-22f6-4eb4-bf9b-145fa1b36c6a","engine.ts","a6362ff6-ab9a-11f1-9797-1607ee4eb77e",65,["D",1788882627143],"import { CONFIG, IS_LIVE } from \"./config.ts\";\nimport { addDays, fixedIssueAt, mountainToUtc, waterYear } from \"./dates.ts\";\nimport { MODEL_BUNDLE } from \"./models.ts\";\nimport { QUESTIONS } from \"./questions.ts\";\nimport { fetchBasinSnapshot } from \"./sources.ts\";\nimport {\n cachePublicFeed,\n ensureSeason,\n finalizePrediction,\n getPrediction,\n initDb,\n listPredictions,\n lockPrediction,\n recentRuns,\n recordEvent,\n recordRun,\n} from \"./storage.ts\";\nimport type { BasinSnapshot, QuestionDefinition } from \"./types.ts\";\n\nfunction canonical(value: any): string {\n if (Array.isArray(value)) return `[${value.map(canonical).join(\",\")}]`;\n if (value && typeof value === \"object\") {\n return `{${\n Object.keys(value).sort().map((key) =>\n `${JSON.stringify(key)}:${canonical(value[key])}`\n ).join(\",\")\n }}`;\n }\n return JSON.stringify(value);\n}\n\nasync function sha256(value: string): Promise {\n const digest = await crypto.subtle.digest(\n \"SHA-256\",\n new TextEncoder().encode(value),\n );\n return [...new Uint8Array(digest)].map((byte) =>\n byte.toString(16).padStart(2, \"0\")\n ).join(\"\");\n}\n\nfunction inputRecord(snapshot: BasinSnapshot): Record {\n const m = snapshot.milestones;\n return {\n captured_at: snapshot.capturedAt.toISOString(),\n cutoff_at: snapshot.cutoffAt.toISOString(),\n current: {\n date: snapshot.current.date.toISOString(),\n value: snapshot.current.value,\n },\n features: snapshot.features,\n milestones: {\n runoff_year: m.runoffYear,\n first_400: m.first400 &&\n { date: m.first400.date.toISOString(), value: m.first400.value },\n peak_daily: m.peakDaily &&\n { date: m.peakDaily.date.toISOString(), value: m.peakDaily.value },\n peak_instant: m.peakInstant &&\n { date: m.peakInstant.date.toISOString(), value: m.peakInstant.value },\n tubing_trigger: m.tubingForecastTrigger &&\n {\n date: m.tubingForecastTrigger.date.toISOString(),\n value: m.tubingForecastTrigger.value,\n },\n tubing_opening: m.tubingOpening?.toISOString() || null,\n counts: m.counts,\n strength: m.strength,\n persistent_snow: m.persistentSnow &&\n {\n date: m.persistentSnow.date.toISOString(),\n value: m.persistentSnow.value,\n },\n peak_swe: m.peakSwe &&\n { date: m.peakSwe.date.toISOString(), value: m.peakSwe.value },\n },\n };\n}\n\nfunction dueAt(\n question: QuestionDefinition,\n runoffYear: number,\n snapshot: BasinSnapshot,\n): Date | null {\n if (question.issueKind === \"fixed\") {\n return fixedIssueAt(runoffYear, question.issueMonth!, question.issueDay!);\n }\n return question.trigger?.(snapshot) || null;\n}\n\nfunction publicPrediction(row: any): Record {\n return {\n number: Number(row.question_number),\n key: row.question_key,\n title: row.title,\n issue_kind: row.issue_kind,\n issue_due_at: row.issue_due_at,\n locked_at: row.locked_at,\n input_cutoff_at: row.input_cutoff_at,\n model_version: row.model_version,\n prediction: JSON.parse(row.prediction_json),\n status: row.status,\n actual: row.actual_json ? JSON.parse(row.actual_json) : null,\n score: row.score,\n scored_at: row.scored_at,\n };\n}\n\nasync function refreshPublicCache(runoffYear: number): Promise {\n const live = await listPredictions(runoffYear, \"live\");\n const shadow = await listPredictions(runoffYear, \"shadow\");\n const runs = await recentRuns(5);\n const feed = {\n schema_version: 1,\n water_year: runoffYear,\n game_state: live.length ? \"live\" : \"shadow-testing\",\n model: MODEL_BUNDLE,\n updated_at: new Date().toISOString(),\n predictions: live.map(publicPrediction),\n shadow_summary: {\n locked: shadow.length,\n scored: shadow.filter((row) => row.score).length,\n },\n health: runs.map((run) => ({\n ran_at: run.ran_at,\n mode: run.mode,\n success: Boolean(run.success),\n message: run.message,\n })),\n };\n await cachePublicFeed(`scoreboard-${runoffYear}`, feed);\n await cachePublicFeed(\"scoreboard-current\", feed);\n}\n\nexport async function runAutomation(\n now = new Date(),\n): Promise> {\n await initDb();\n const mode = IS_LIVE ? \"live\" : \"shadow\";\n const runoffYear = waterYear(now);\n if (runoffYear < CONFIG.firstAutomatedWaterYear) {\n // September is a preseason health check. It deliberately creates no locks,\n // but proves the official sources, models, database, cron and public cache work.\n try {\n const current = await fetchBasinSnapshot(now);\n const message =\n `Preseason ${mode} check passed. Water year ${CONFIG.firstAutomatedWaterYear} becomes eligible on October 1.`;\n await recordRun(true, mode, message, current.sourceStatus);\n await refreshPublicCache(CONFIG.firstAutomatedWaterYear);\n return {\n ok: true,\n mode,\n preseason: true,\n water_year: CONFIG.firstAutomatedWaterYear,\n message,\n source_status: current.sourceStatus,\n };\n } catch (error) {\n const message = error instanceof Error ? error.message : String(error);\n await recordRun(false, mode, `Preseason check failed: ${message}`);\n throw error;\n }\n }\n const openedAt = mountainToUtc(runoffYear - 1, 10, 1, 0);\n await ensureSeason(runoffYear, MODEL_BUNDLE.source_model_version, openedAt);\n let current: BasinSnapshot;\n try {\n current = await fetchBasinSnapshot(now);\n } catch (error) {\n const message = error instanceof Error ? error.message : String(error);\n await recordRun(false, mode, message);\n throw error;\n }\n\n const actions: string[] = [];\n const lockSnapshots = new Map();\n for (const question of QUESTIONS) {\n let stored = await getPrediction(runoffYear, question.number, mode);\n if (!stored) {\n const issueAt = dueAt(question, runoffYear, current);\n if (issueAt && now >= issueAt) {\n const ageHours = (now.getTime() - issueAt.getTime()) / 3_600_000;\n if (ageHours > CONFIG.fixedLockGraceHours) {\n actions.push(\n `P${question.number} needs review: issue window was missed`,\n );\n } else {\n const cacheKey = issueAt.toISOString();\n let lockSnapshot = lockSnapshots.get(cacheKey);\n if (!lockSnapshot) {\n lockSnapshot = await fetchBasinSnapshot(issueAt);\n lockSnapshots.set(cacheKey, lockSnapshot);\n }\n const prediction = question.calculate(lockSnapshot);\n const inputs = inputRecord(lockSnapshot);\n const predictionJson = canonical(prediction);\n const inputsJson = canonical(inputs);\n const inserted = await lockPrediction({\n water_year: runoffYear,\n question_number: question.number,\n question_key: question.key,\n title: question.title,\n mode,\n issue_kind: question.issueKind,\n issue_due_at: issueAt.toISOString(),\n locked_at: now.toISOString(),\n input_cutoff_at: issueAt.toISOString(),\n model_version: MODEL_BUNDLE.source_model_version,\n model_hash: MODEL_BUNDLE.sha256,\n prediction_json: predictionJson,\n inputs_json: inputsJson,\n inputs_hash: await sha256(inputsJson),\n source_status_json: canonical(lockSnapshot.sourceStatus),\n status: \"locked\",\n actual_json: null,\n score: null,\n scored_at: null,\n });\n if (inserted) {\n await recordEvent(\n runoffYear,\n question.number,\n `${mode}_lock_created`,\n now,\n { issue_at: issueAt.toISOString(), prediction },\n );\n actions.push(`P${question.number} ${mode} lock created`);\n stored = await getPrediction(runoffYear, question.number, mode);\n }\n }\n }\n }\n if (stored && !stored.scored_at && question.final(current)) {\n const actual = question.actual(current);\n if (actual) {\n const prediction = JSON.parse(stored.prediction_json);\n const hit = question.score(prediction, actual);\n await finalizePrediction(\n runoffYear,\n question.number,\n mode,\n canonical(actual),\n hit,\n now,\n );\n await recordEvent(\n runoffYear,\n question.number,\n `${mode}_score_finalized`,\n now,\n { actual, score: hit ? \"hit\" : \"miss\" },\n );\n actions.push(`P${question.number} scored ${hit ? \"HIT\" : \"MISS\"}`);\n }\n }\n }\n const message = actions.length\n ? actions.join(\"; \")\n : \"Data refreshed; no lock or score was due.\";\n await recordRun(true, mode, message, current.sourceStatus);\n await refreshPublicCache(runoffYear);\n return {\n ok: true,\n mode,\n water_year: runoffYear,\n actions,\n source_status: current.sourceStatus,\n };\n}",[259],"5c5fb06d-0c56-490b-8d6c-f0b6e727cedf","dates-old.ts","8d25a690-ab9a-11f1-ade0-1607ee4eb77e",74,["D",1788882955145],"import { CONFIG } from \"./config.ts\";\n\nconst DAY = 86_400_000;\n\nexport function addDays(date: Date, days: number): Date {\n return new Date(date.getTime() + days * DAY);\n}\n\nexport function isoDay(date: Date): string {\n return date.toISOString().slice(0, 10);\n}\n\nexport function mountainParts(\n date: Date,\n): { year: number; month: number; day: number; hour: number } {\n const parts = new Intl.DateTimeFormat(\"en-US\", {\n timeZone: CONFIG.timeZone,\n year: \"numeric\",\n month: \"numeric\",\n day: \"numeric\",\n hour: \"numeric\",\n hourCycle: \"h23\",\n }).formatToParts(date);\n const values = Object.fromEntries(\n parts.filter((part) => part.type !== \"literal\").map((\n part,\n ) => [part.type, Number(part.value)]),\n );\n return values as { year: number; month: number; day: number; hour: number };\n}\n\n// Converts a wall-clock time in America/Denver to UTC without requiring a date library.\nexport function mountainToUtc(\n year: number,\n month: number,\n day: number,\n hour = 0,\n minute = 0,\n): Date {\n let guess = new Date(Date.UTC(year, month - 1, day, hour, minute));\n for (let attempt = 0; attempt < 3; attempt += 1) {\n const seen = mountainParts(guess);\n const wanted = Date.UTC(year, month - 1, day, hour, minute);\n const actual = Date.UTC(\n seen.year,\n seen.month - 1,\n seen.day,\n seen.hour,\n minute,\n );\n guess = new Date(guess.getTime() + wanted - actual);\n }\n return guess;\n}\n\nexport function mountainCalendarDate(date: Date): Date {\n const p = mountainParts(date);\n return new Date(Date.UTC(p.year, p.month - 1, p.day, 12));\n}\n\nexport function waterYear(date: Date): number {\n const p = mountainParts(date);\n return p.month >= 10 ? p.year + 1 : p.year;\n}\n\nexport function fixedIssueAt(\n runoffYear: number,\n month: number,\n day: number,\n): Date {\n const year = month >= 10 ? runoffYear - 1 : runoffYear;\n return mountainToUtc(year, month, day, CONFIG.lockHourMountain);\n}\n\nexport function firstMondayOfSeptember(year: number): Date {\n const first = new Date(Date.UTC(year, 8, 1, 12));\n const offset = (8 - first.getUTCDay()) % 7;\n return addDays(first, offset);\n}\n\nexport function daysBetween(a: Date, b: Date): number {\n return Math.round(\n (mountainCalendarDate(a).getTime() - mountainCalendarDate(b).getTime()) /\n DAY,\n );\n}\n\nexport function afterMountainDay(\n date: Date,\n year: number,\n month: number,\n day: number,\n): boolean {\n return mountainCalendarDate(date) >\n new Date(Date.UTC(year, month - 1, day, 23, 59, 59));\n}",[266],"45cba583-bb0d-43d5-bdd9-c9c1f03251ca","cron.ts","a7fd641c-ab9a-11f1-83fc-1607ee4eb77e",73,["D",1788882806280],7,"interval",[273],"2e430288-2b75-40ad-8a18-d32903314145","config.ts","377dfa62-ab9a-11f1-ac1e-1607ee4eb77e",["D",1788881526228],"export const CONFIG = {\n username: \"pagosaoutside\",\n projectName: \"black-hat-hydrology\",\n timeZone: \"America/Denver\",\n lockHourMountain: 9,\n fixedLockGraceHours: 36,\n firstAutomatedWaterYear: 2027,\n // Leave this in shadow mode until the preseason checks have passed.\n mode: String(\n (globalThis as any).Deno?.env?.get?.(\"BLACK_HAT_MODE\") || \"shadow\",\n ).toLowerCase(),\n allowedOrigins: new Set([\n \"https://pagosaoutside.com\",\n \"https://www.pagosaoutside.com\",\n ]),\n usgsSite: \"09342500\",\n snotelStations: [\"840:CO:SNTL\", \"874:CO:SNTL\"],\n modelVersion: \"0.5.0-2027-game\",\n} as const;\n\nexport const IS_LIVE = CONFIG.mode === \"live\";",[281],"pulls","branches","forks","envVars",{"_293":62,"_295":62},"connections",{"_293":62,"_294":62},"count","unfilledCount","emptyCount",{"_42":280,"_32":281,"_30":282,"_152":-5,"_40":41,"_39":181,"_154":24,"_37":374,"_13":156,"_33":34,"_35":284,"_23":24,"_158":-5,"_317":375,"_26":376},{"_42":272,"_32":273,"_30":274,"_152":-5,"_40":41,"_39":275,"_154":24,"_37":371,"_13":277,"_33":278,"_35":220,"_23":24,"_158":-5,"_317":372,"_26":373},{"_42":265,"_32":266,"_30":267,"_152":-5,"_40":41,"_39":268,"_154":58,"_37":368,"_13":165,"_33":34,"_35":270,"_23":24,"_158":-5,"_317":369,"_26":370},{"_42":258,"_32":259,"_30":260,"_152":-5,"_40":41,"_39":261,"_154":24,"_37":365,"_13":181,"_33":34,"_35":263,"_23":24,"_158":-5,"_317":366,"_26":367},{"_42":252,"_32":253,"_30":254,"_152":-5,"_40":41,"_39":255,"_154":24,"_37":362,"_13":206,"_33":34,"_35":36,"_23":24,"_158":-5,"_317":363,"_26":364},{"_42":246,"_32":247,"_30":248,"_152":-5,"_40":41,"_39":249,"_154":24,"_37":359,"_13":156,"_33":34,"_35":36,"_23":24,"_158":-5,"_317":360,"_26":361},{"_42":240,"_32":241,"_30":242,"_152":-5,"_40":41,"_39":243,"_154":24,"_37":356,"_13":206,"_33":34,"_35":36,"_23":24,"_158":-5,"_317":357,"_26":358},{"_42":234,"_32":235,"_30":236,"_152":-5,"_40":41,"_39":237,"_154":24,"_37":353,"_13":206,"_33":34,"_35":36,"_23":24,"_158":-5,"_317":354,"_26":355},{"_42":228,"_32":229,"_30":230,"_152":-5,"_40":41,"_39":231,"_154":24,"_37":350,"_13":206,"_33":34,"_35":36,"_23":24,"_158":-5,"_317":351,"_26":352},{"_42":222,"_32":223,"_30":224,"_152":-5,"_40":41,"_39":156,"_154":58,"_37":347,"_13":62,"_33":219,"_35":226,"_23":24,"_158":-5,"_317":348,"_26":349},{"_42":215,"_32":216,"_30":56,"_152":-5,"_40":41,"_39":217,"_154":24,"_37":344,"_13":165,"_33":219,"_35":220,"_23":24,"_158":-5,"_317":345,"_26":346},{"_42":208,"_32":209,"_30":210,"_152":-5,"_40":41,"_39":211,"_154":24,"_37":341,"_13":213,"_33":34,"_35":192,"_23":24,"_158":-5,"_317":342,"_26":343},{"_42":201,"_32":202,"_30":203,"_152":-5,"_40":41,"_39":204,"_154":24,"_37":338,"_13":206,"_33":34,"_35":36,"_23":24,"_158":-5,"_317":339,"_26":340},{"_42":194,"_32":195,"_30":196,"_152":-5,"_40":41,"_39":197,"_154":58,"_37":335,"_13":173,"_33":34,"_35":199,"_23":24,"_158":-5,"_317":336,"_26":337},{"_42":187,"_32":188,"_30":189,"_152":-5,"_40":41,"_39":190,"_154":24,"_37":332,"_13":156,"_33":34,"_35":192,"_23":24,"_158":-5,"_317":333,"_26":334},{"_42":184,"_32":27,"_30":31,"_152":-5,"_40":41,"_39":14,"_154":24,"_37":329,"_13":62,"_33":34,"_35":36,"_23":24,"_158":-5,"_317":330,"_26":331},{"_42":176,"_32":177,"_30":178,"_152":-5,"_40":41,"_39":179,"_154":24,"_37":326,"_13":181,"_33":34,"_35":182,"_23":24,"_158":-5,"_317":327,"_26":328},{"_42":168,"_32":169,"_30":170,"_152":-5,"_40":41,"_39":171,"_154":24,"_37":323,"_13":173,"_33":34,"_35":174,"_23":24,"_158":-5,"_317":324,"_26":325},{"_42":160,"_32":161,"_30":162,"_152":-5,"_40":41,"_39":163,"_154":24,"_37":320,"_13":165,"_33":34,"_35":166,"_23":24,"_158":-5,"_317":321,"_26":322},{"_42":149,"_32":150,"_30":151,"_152":-5,"_40":41,"_39":153,"_154":24,"_37":316,"_13":156,"_33":34,"_35":157,"_23":24,"_158":-5,"_317":318,"_26":319},["D",1788881595508],"children",[],[150],["D",1788882421895],[],[161],["D",1788882623133],[],[169],["D",1788882624992],[],[177],["D",1788882961690],[],[27],["D",1788882799219],[],[188],["D",1788882784046],[],[195],["D",1788882295796],[],[202],["D",1788882618399],[],[209],["D",1788882631456],[],[216],["D",1788719065897],[],[223],["D",1788882319621],[],[229],["D",1788882312683],[],[235],["D",1788882306326],[],[241],["D",1788882302686],[],[247],["D",1788882510486],[],[253],["D",1788882627143],[],[259],["D",1788882955145],[],[266],["D",1788882806280],[],[273],["D",1788881526228],[],[281],["D",1788718960405],["D",1789488693443],{"_99":98,"_107":103},{"_99":98,"_100":101,"_102":103,"_18":54,"_104":105,"_106":24},{"_13":88,"_32":89,"_42":41,"_90":43,"_91":-5,"_92":-5,"_93":-5,"_94":-5,"_95":-5,"_96":44,"_97":98},"ctx",{"_81":-5,"_126":415,"_416":417,"_418":419,"_420":24,"_421":24,"_422":24,"_423":58,"_424":-5,"_425":-7,"_426":-7,"_427":62,"_428":24,"_429":24,"_430":-5,"_431":24,"_432":24,"_433":24,"_434":-5},"ENV",{"_386":387,"_388":389,"_390":89,"_391":392,"_393":394,"_395":396,"_397":398,"_399":400,"_401":402,"_403":404,"_405":406,"_407":408,"_409":410,"_411":412,"_413":414},"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"]

Diff · v75