[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10},"actionData","errors","root",{"_229":230,"_231":232},"routes/_app.x.$handle.$name",{"_11":12,"_13":14,"_15":-7,"_18":19,"_17":-7,"_174":-5,"_20":175,"_22":176,"_177":178,"_179":180,"_26":181,"_24":182,"_183":-5,"_184":-5,"_185":54,"_186":187,"_188":45,"_189":-5,"_190":-5,"_191":192},"routes/_app.x.$handle.$name.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","plusjade","name","source-lunar","branchName","main","version","path","lib/lunation.ts","project",{"_33":117,"_13":14,"_46":118,"_119":-5,"_120":54,"_121":122,"_123":122,"_124":125,"_126":-5,"_127":128,"_129":66,"_130":45,"_131":-5,"_132":-5,"_133":48,"_134":135,"_136":137,"_138":139,"_140":141,"_142":-5,"_143":144,"_145":144,"_146":147,"_148":147,"_149":147,"_150":144,"_151":144,"_152":153,"_154":155,"_156":157,"_158":54},"tree",[58,59,60,61,62,63],"file",{"_33":34,"_13":35,"_36":37,"_38":39,"_40":41,"_42":43,"_44":45,"_46":47,"_17":48,"_49":50,"_51":52,"_53":54,"_55":-5,"_18":56},"contents",[],"upstream","pull","ahead","behind","envVars","id","e26f4346-29e3-40b4-b411-3e57254309e8","lunation.ts","fileId","aa8888ec-ab9f-11f1-90d4-1607ee4eb77e","parentId","da6450e2-c47d-4681-9aa6-c233fd542c1f","branchId","d6eac716-8ec7-4672-81af-bf4acf39c908","branchVersion",2,"latest",true,"createdAt",["D",1788883767418],0,"fileType","script","content","// Pure lunar-calendar arithmetic: no storage, no clock, no network.\n//\n// A lunar month begins on the civil day that contains its new moon, so the\n// month's 15th day is that day plus fourteen. \"Which civil day\" depends on a\n// zone, and the calendar has to fix one or the same instant lands on different\n// dates for different readers; ANCHOR_OFFSET_SECONDS is that choice.\n\n/** UTC+8, the conventional civil anchor for the East Asian lunisolar calendar. */\nexport const ANCHOR_OFFSET_SECONDS = 8 * 3600;\n\nconst UNIX_EPOCH_JD = 2440587.5;\n// Terrestrial-to-universal time offset. Slowly varying; a constant is far below\n// the precision that a day boundary needs.\nconst DELTA_T_SECONDS = 69;\n\nconst RAD = Math.PI / 180;\nconst sin = (deg: number) => Math.sin(deg * RAD);\n\n/**\n * Julian Day (UT) of the new moon numbered `k`, where k=0 is the new moon of\n * 2000 January 6. Meeus, *Astronomical Algorithms* ch. 49, without the small\n * planetary terms; the residual error is well under a minute.\n */\nexport function newMoonJd(k: number): number {\n const t = k / 1236.85;\n const t2 = t * t, t3 = t2 * t, t4 = t3 * t;\n\n let jde = 2451550.09766 + 29.530588861 * k\n + 0.00015437 * t2 - 0.000000150 * t3 + 0.00000000073 * t4;\n\n const e = 1 - 0.002516 * t - 0.0000074 * t2;\n const m = 2.5534 + 29.10535670 * k - 0.0000014 * t2 - 0.00000011 * t3;\n const mp = 201.5643 + 385.81693528 * k + 0.0107582 * t2\n + 0.00001238 * t3 - 0.000000058 * t4;\n const f = 160.7108 + 390.67050284 * k - 0.0016118 * t2\n - 0.00000227 * t3 + 0.000000011 * t4;\n const omega = 124.7746 - 1.56375588 * k + 0.0020672 * t2 + 0.00000215 * t3;\n\n jde += -0.40720 * sin(mp)\n + 0.17241 * e * sin(m)\n + 0.01608 * sin(2 * mp)\n + 0.01039 * sin(2 * f)\n + 0.00739 * e * sin(mp - m)\n - 0.00514 * e * sin(mp + m)\n + 0.00208 * e * e * sin(2 * m)\n - 0.00111 * sin(mp - 2 * f)\n - 0.00057 * sin(mp + 2 * f)\n + 0.00056 * e * sin(2 * mp + m)\n - 0.00042 * sin(3 * mp)\n + 0.00042 * e * sin(m + 2 * f)\n + 0.00038 * e * sin(m - 2 * f)\n - 0.00024 * e * sin(2 * mp - m)\n - 0.00017 * sin(omega)\n - 0.00007 * sin(mp + 2 * m)\n + 0.00004 * sin(2 * mp - 2 * f)\n + 0.00004 * sin(3 * m)\n + 0.00003 * sin(mp + m - 2 * f)\n + 0.00003 * sin(2 * mp + 2 * f)\n - 0.00003 * sin(mp + m + 2 * f)\n + 0.00003 * sin(mp - m + 2 * f)\n - 0.00002 * sin(mp - m - 2 * f)\n - 0.00002 * sin(3 * mp + m)\n + 0.00002 * sin(4 * mp);\n\n return jde - DELTA_T_SECONDS / 86400;\n}\n\n/** Unix seconds of the new moon numbered `k`. */\nexport function newMoonUnix(k: number): number {\n return Math.round((newMoonJd(k) - UNIX_EPOCH_JD) * 86400);\n}\n\n/** The `YYYY-MM-DD` an instant falls on for an observer at `offsetSeconds`. */\nexport function civilDate(unixSeconds: number, offsetSeconds: number): string {\n return new Date((unixSeconds + offsetSeconds) * 1000).toISOString().slice(0, 10);\n}\n\n/** `YYYY-MM-DD` shifted by whole days. */\nexport function addDays(dateKey: string, days: number): string {\n return new Date(Date.parse(dateKey + \"T00:00:00Z\") + days * 86400_000)\n .toISOString().slice(0, 10);\n}\n\nexport interface LunarFifteenth {\n /** Civil date of the lunar month's 15th day, in the anchor zone. */\n dateKey: string;\n /** Civil date the lunar month begins on: the day holding its new moon. */\n newMoonDate: string;\n /** ISO instant of the new moon that starts the month. */\n newMoonUtc: string;\n}\n\n/**\n * Every lunar 15th whose anchor-zone date falls in `year`, in ascending order.\n * The k range overshoots the year on both sides so no boundary month is lost.\n */\nexport function lunarFifteenthsForYear(year: number): LunarFifteenth[] {\n const kFor = (y: number) => Math.round((y - 2000) * 12.3685);\n const out: LunarFifteenth[] = [];\n for (let k = kFor(year) - 14; k <= kFor(year) + 14; k++) {\n const unix = newMoonUnix(k);\n const newMoonDate = civilDate(unix, ANCHOR_OFFSET_SECONDS);\n const dateKey = addDays(newMoonDate, 14);\n if (dateKey.slice(0, 4) !== String(year)) continue;\n out.push({ dateKey, newMoonDate, newMoonUtc: new Date(unix * 1000).toISOString() });\n }\n return out.sort((a, b) => a.dateKey < b.dateKey ? -1 : 1);\n}\n","deleted",false,"label",[57,35],"lib",{"_33":108,"_13":57,"_36":39,"_38":-5,"_40":41,"_42":43,"_44":45,"_46":109,"_17":48,"_49":110,"_51":-5,"_53":54,"_55":-5,"_71":111,"_18":112},{"_33":100,"_13":101,"_36":102,"_38":-5,"_40":41,"_42":103,"_44":45,"_46":104,"_17":43,"_49":24,"_51":105,"_53":54,"_55":-5,"_71":106,"_18":107},{"_33":92,"_13":93,"_36":94,"_38":-5,"_40":41,"_42":95,"_44":45,"_46":96,"_17":48,"_49":50,"_51":97,"_53":54,"_55":-5,"_71":98,"_18":99},{"_33":82,"_13":83,"_36":84,"_38":-5,"_40":41,"_42":85,"_44":45,"_46":86,"_17":87,"_49":88,"_51":89,"_53":54,"_55":-5,"_71":90,"_18":91},{"_33":74,"_13":75,"_36":76,"_38":-5,"_40":41,"_42":77,"_44":45,"_46":78,"_17":48,"_49":50,"_51":79,"_53":54,"_55":-5,"_71":80,"_18":81},{"_33":64,"_13":65,"_36":66,"_38":-5,"_40":41,"_42":67,"_44":45,"_46":68,"_17":48,"_49":69,"_51":70,"_53":54,"_55":-5,"_71":72,"_18":73},"5b42fc46-418c-48d1-a9e6-208b9ff2d927","rpc.ts","bf3ab8aa-ab9f-11f1-a75e-1607ee4eb77e",4,["D",1788883802150],"http","// Deployment authentication around the shared source protocol.\nimport { serveSource } from \"https://esm.town/v/plusjade/source-sdk@3-main/mod.ts\";\nimport lunar from \"./lunarSource.ts\";\nexport default function handler(req: Request): Promise | Response {\n const token = Deno.env.get(\"SOURCE_LUNAR_V1_TOKEN\");\n if (!token) return Response.json({error:\"RPC token not configured\"},{status:503});\n if (req.headers.get(\"authorization\") !== `Bearer ${token}`) {\n return Response.json({error:\"unauthorized\"},{status:401});\n }\n return serveSource(lunar, req);\n}\n","children",[],[65],"7605d4e8-ff93-4a65-86cc-7556cb2f4f26","lunarSource.ts","bb3e291c-ab9f-11f1-8433-1607ee4eb77e",3,["D",1788883795459],"// Lunar-calendar source: the 15th day of each lunar month, and nothing else.\n// Device settings are always empty; storage and ingest are Lunar-only.\nimport { sqlite } from \"https://esm.town/v/std/sqlite/main.ts\";\nimport { accept, reject, record, type Item, defineSource } from \"https://esm.town/v/plusjade/source-sdk@3-main/mod.ts\";\nimport { lunarFifteenthsForYear } from \"./lib/lunation.ts\";\n\nconst FALLBACK_ZONE = \"America/Los_Angeles\";\nconst MONTHS = [\"Jan\", \"Feb\", \"Mar\", \"Apr\", \"May\", \"Jun\", \"Jul\", \"Aug\", \"Sep\", \"Oct\", \"Nov\", \"Dec\"];\n\n/** Provision at deployment and ingest, never on a feed read. */\nexport async function ensureSchema(): Promise {\n await sqlite.execute(`CREATE TABLE IF NOT EXISTS lunar_fifteenths(\n date_key TEXT PRIMARY KEY,\n payload TEXT NOT NULL,\n fetched_at TEXT NOT NULL\n )`);\n}\n\n/** Whole-day offset context for a reader; `null` means the parent had none. */\nexport function offsetSecondsFor(offset: number | null, dateKey: string): number {\n if (offset !== null && offset >= -43200 && offset <= 50400) return offset;\n // Not UTC: treating a missing offset as 0 would move every day boundary to\n // Greenwich. Match Moon's fallback zone, resolved for the day in question.\n const name = new Intl.DateTimeFormat(\"en-US\", {\n timeZone: FALLBACK_ZONE,\n timeZoneName: \"longOffset\",\n }).formatToParts(new Date(dateKey + \"T12:00:00Z\"))\n .find((p) => p.type === \"timeZoneName\")?.value ?? \"GMT+00:00\";\n const [, sign, hh, mm] = /GMT([+-])(\\d{2}):(\\d{2})/.exec(name) ?? [, \"+\", \"00\", \"00\"];\n return (sign === \"-\" ? -1 : 1) * (Number(hh) * 3600 + Number(mm) * 60);\n}\n\n/** The reader's current civil date. */\nexport function fromDate(offset: number | null, now = new Date()): string {\n const today = now.toISOString().slice(0, 10);\n return new Date(now.getTime() + offsetSecondsFor(offset, today) * 1000)\n .toISOString().slice(0, 10);\n}\n\nfunction monthDay(dateKey: string): string {\n return `${MONTHS[Number(dateKey.slice(5, 7)) - 1]} ${Number(dateKey.slice(8, 10))}`;\n}\n\nexport async function lunarItems(dateKey: string, offset: number | null): Promise {\n const result = await sqlite.execute({\n sql: \"SELECT date_key, payload FROM lunar_fifteenths WHERE date_key >= ? ORDER BY date_key LIMIT 1\",\n args: [dateKey],\n });\n const row = result.rows[0];\n if (!row) return [];\n const key = String(row.date_key);\n const payload = JSON.parse(String(row.payload));\n return [{\n id: `lunar15-${key}`,\n mainText: \"Lunar 15th\",\n subText: `Cycle from ${monthDay(payload.newMoonDate)}`,\n // The lunar 15th is a whole day, not an instant. A caption keeps the widget\n // from rendering the anchor time as if it meant something.\n caption: \"DAY 15\",\n emphasized: false,\n // Local noon, so the reader's own day label is the lunar 15th itself.\n timestamp: Date.parse(key + \"T12:00:00Z\") / 1000 - offsetSecondsFor(offset, key),\n }];\n}\n\n/** Replace one calendar year of lunar 15ths authoritatively. */\nexport async function rebuildYear(year: number): Promise {\n await ensureSchema();\n const rows = lunarFifteenthsForYear(year);\n const fetchedAt = new Date().toISOString();\n await sqlite.execute({\n sql: \"DELETE FROM lunar_fifteenths WHERE date_key LIKE ?\",\n args: [`${year}-%`],\n });\n for (const row of rows) {\n await sqlite.execute({\n sql: `INSERT INTO lunar_fifteenths(date_key,payload,fetched_at) VALUES(?,?,?)\n ON CONFLICT(date_key) DO UPDATE SET payload=excluded.payload,fetched_at=excluded.fetched_at`,\n args: [row.dateKey, JSON.stringify({ newMoonDate: row.newMoonDate, newMoonUtc: row.newMoonUtc }), fetchedAt],\n });\n }\n return rows.length;\n}\n\nexport default defineSource({\n key: \"lunar\",\n settingsSchema: { type: \"object\", properties: {}, additionalProperties: false },\n parseSettings: (raw) => Object.keys(raw).length === 0 ? accept(null) : reject(\"invalid_settings\"),\n read: (_, { utcOffsetSeconds }) =>\n lunarItems(fromDate(utcOffsetSeconds), utcOffsetSeconds),\n writes: {\n // A whole year at a time: the lunar calendar is computed, not fetched, so\n // there is no per-date upstream to page through.\n \"calendar.rebuild\": async (raw) => {\n const year = raw.year;\n if (!record(raw) || typeof year !== \"number\" || !Number.isInteger(year)\n || year < 1900 || year > 2999) {\n return reject(\"invalid_rebuild_payload\");\n }\n return accept({ year, count: await rebuildYear(year) });\n },\n },\n});\n",[],[75],"8268a0ac-d202-411f-bef9-1a2cb46a8286","ingest.ts","c255ff36-ab9f-11f1-983f-1607ee4eb77e",7,["D",1788883886330],1,"interval","// Annual ingest: once a year, in the last month, build the whole next year.\n//\n// The lunar calendar is computed rather than fetched, so a year's worth of\n// rows is a few milliseconds of arithmetic and there is nothing to poll for.\n// Runs in this val, so it writes this val's SQLite directly rather than over\n// the source protocol. Schedule: `0 0 1 12 *` (1 December, UTC).\n//\n// The current year is rebuilt alongside the next one. It is normally already\n// stored and identical, but including it means one run of this file is also\n// the deployment seed, so there is no separate first-year bootstrap to forget.\nimport { rebuildYear } from \"./lunarSource.ts\";\n\nexport default async function (_interval: Interval) {\n const current = new Date().getUTCFullYear();\n for (const year of [current, current + 1]) {\n console.log(`lunar: rebuilt ${await rebuildYear(year)} fifteenths for ${year}`);\n }\n}\n",[],[83],"7684fb64-5367-4621-9925-e1c0bfbd24d2","check.ts","e66e4f22-ab9f-11f1-a7c9-1607ee4eb77e",6,["D",1788883867912],"// Lunar contract, calendar and storage checks. Disposable rows are removed.\nimport handler from \"./rpc.ts\";\nimport lunar from \"./lunarSource.ts\";\nimport { fromDate, lunarItems, offsetSecondsFor, rebuildYear, ensureSchema } from \"./lunarSource.ts\";\nimport { civilDate, lunarFifteenthsForYear, newMoonUnix, ANCHOR_OFFSET_SECONDS } from \"./lib/lunation.ts\";\nimport { serveSource } from \"https://esm.town/v/plusjade/source-sdk@3-main/mod.ts\";\nimport { sqlite } from \"https://esm.town/v/std/sqlite/main.ts\";\n\nfunction check(ok: unknown, message: string) { if (!ok) throw new Error(message); }\nconst base = { protocolVersion: 1, sourceKey: \"lunar\" };\n\n// The protocol is exercised through the definition; the mount below is checked\n// for authentication only, so these checks need no token to run.\nfunction call(path: string, body?: unknown) {\n return serveSource(lunar, new Request(\"https://lunar.invalid\" + path, {\n method: body === undefined ? \"GET\" : \"POST\",\n ...(body === undefined ? {} : { body: JSON.stringify(body) }),\n }));\n}\n\n// --- calendar arithmetic -----------------------------------------------------\n// Meeus numbers lunations from the new moon of 2000 January 6.\ncheck(new Date(newMoonUnix(0) * 1000).toISOString().slice(0, 10) === \"2000-01-06\", \"k=0 anchor\");\n\nconst y2026 = lunarFifteenthsForYear(2026);\ncheck(y2026.length === 12 || y2026.length === 13, \"12 or 13 lunar months in 2026\");\ncheck(new Set(y2026.map((r) => r.dateKey)).size === y2026.length, \"unique date keys\");\ncheck(y2026.every((r) => r.dateKey.startsWith(\"2026-\")), \"year bounded\");\ncheck(y2026.every((r, i) => i === 0 || r.dateKey > y2026[i - 1].dateKey), \"ascending\");\ncheck(y2026.every((r) =>\n (Date.parse(r.dateKey) - Date.parse(r.newMoonDate)) / 86400_000 === 14), \"day 15 is new moon day + 14\");\n\n// Synodic month is 29.27-29.84 days; anything outside means a dropped lunation.\nfor (let k = -100; k < 100; k++) {\n const gap = (newMoonUnix(k + 1) - newMoonUnix(k)) / 86400;\n check(gap > 29.2 && gap < 29.9, `synodic gap at k=${k}`);\n}\n\n// Two published dates that pin the UTC+8 anchor convention end to end:\n// lunar new year 2026 (month 1, day 1) and mid-autumn 2026 (month 8, day 15).\ncheck(y2026.some((r) => r.newMoonDate === \"2026-02-17\"), \"lunar new year 2026-02-17\");\ncheck(y2026.some((r) => r.dateKey === \"2026-09-25\"), \"mid-autumn 2026-09-25\");\ncheck(civilDate(0, ANCHOR_OFFSET_SECONDS) === \"1970-01-01\", \"anchor civil date\");\n\n// --- offsets and selection ---------------------------------------------------\ncheck(offsetSecondsFor(50400, \"2026-06-01\") === 50400, \"offset passthrough\");\ncheck(offsetSecondsFor(99999, \"2026-06-01\") === -25200, \"out-of-range falls back to Pacific DST\");\ncheck(offsetSecondsFor(null, \"2026-01-04\") === -28800, \"null falls back to Pacific standard\");\ncheck(fromDate(null, new Date(\"2026-01-04T07:30:00Z\")) === \"2026-01-03\", \"winter fallback\");\ncheck(fromDate(50400, new Date(\"2026-01-03T12:00:00Z\")) === \"2026-01-04\", \"positive boundary\");\n\n// --- protocol ----------------------------------------------------------------\nconst desc = await (await call(\"/v1/descriptor?sourceKey=lunar\")).json();\ncheck(desc.temporal && desc.sourceKey === \"lunar\", \"descriptor\");\ncheck(JSON.stringify(desc.capabilities.write) === '[\"calendar.rebuild\"]', \"writes\");\ncheck((await call(\"/v1/read\", { ...base, settings: { x: 1 }, context: { utcOffsetSeconds: 0 } })).status === 400, \"settings\");\ncheck((await call(\"/v1/read\", { ...base, sourceKey: \"moon\", settings: {}, context: { utcOffsetSeconds: 0 } })).status === 404, \"wrong source\");\ncheck((await call(\"/v1/write\", { ...base, operation: \"toString\", payload: {} })).status === 422, \"unsupported write\");\ncheck((await call(\"/v1/write\", { ...base, operation: \"calendar.rebuild\", payload: { year: \"2026\" } })).status === 400, \"non-numeric year\");\ncheck((await call(\"/v1/write\", { ...base, operation: \"calendar.rebuild\", payload: { year: 1899 } })).status === 400, \"out-of-range year\");\ncheck((await call(\"/v1/publish\", base)).status === 501, \"publish\");\n\n// The mount adds only authentication.\nconst unauth = await handler(new Request(\"https://lunar.invalid/v1/descriptor\"));\ncheck(unauth.status === 401 || unauth.status === 503, \"mount rejects a missing bearer\");\nconst token = Deno.env.get(\"SOURCE_LUNAR_V1_TOKEN\");\nif (token) {\n const authed = await handler(new Request(\"https://lunar.invalid/v1/descriptor?sourceKey=lunar\", {\n headers: { authorization: `Bearer ${token}` },\n }));\n check(authed.ok, \"mount accepts the configured bearer\");\n}\n\n// --- storage round trip ------------------------------------------------------\nawait ensureSchema();\nconst fixtureYear = 1901;\ntry {\n const count = await rebuildYear(fixtureYear);\n check(count === lunarFifteenthsForYear(fixtureYear).length, \"rebuild writes the whole year\");\n check(await rebuildYear(fixtureYear) === count, \"rebuild is idempotent\");\n\n const first = lunarFifteenthsForYear(fixtureYear)[0].dateKey;\n const [item] = await lunarItems(first, -28800);\n check(item.id === `lunar15-${first}`, \"stable id\");\n check(item.caption === \"DAY 15\" && item.mainText === \"Lunar 15th\", \"presentation\");\n // Seconds, not milliseconds, and local noon on the lunar 15th itself.\n check(item.timestamp === Date.parse(first + \"T12:00:00Z\") / 1000 + 28800, \"local noon in seconds\");\n check(civilDate(item.timestamp, -28800) === first, \"reader's day label is the 15th\");\n for (const tz of [null, 0, -43200, 50400]) {\n const [tzItem] = await lunarItems(first, tz);\n check(civilDate(tzItem.timestamp, offsetSecondsFor(tz, first)) === first, `day label at tz=${tz}`);\n }\n check((await lunarItems(\"1902-01-01\", 0)).length === 0, \"exhaustion past the ingested year\");\n} finally {\n await sqlite.execute({ sql: \"DELETE FROM lunar_fifteenths WHERE date_key LIKE ?\", args: [`${fixtureYear}-%`] });\n}\n\nconsole.log(\"PASS: Lunar calendar arithmetic, anchor convention, offsets, protocol, auth, storage and cleanup\");\n",[],[93],"03725744-0ce4-436c-9170-d5364506af6b","README.md","9c2a02bc-ab9f-11f1-aa74-1607ee4eb77e",9,["D",1788883931237],"# source-lunar\n\nA Clark View source that models the lunar calendar and surfaces **only** the\n15th day of each lunar month. No other lunar day is stored or served.\n\nBuilt on the shared [source SDK](https://www.val.town/x/plusjade/source-sdk):\nprotocol v1 over `rpc.ts`, bearer-authenticated, SQLite owned by this val.\n\n## The calendar model\n\nA lunar month begins on the civil day containing its new moon, so its 15th day\nis that day plus fourteen. \"Which civil day\" depends on a zone, and the calendar\nmust fix one or the same instant lands on different dates for different readers.\nThis source anchors on **UTC+8**, the conventional civil anchor for the East\nAsian lunisolar calendar.\n\nNew-moon instants come from Meeus, *Astronomical Algorithms* ch. 49, minus the\nsmall planetary terms — the residual is well under a minute, far below what a\nday boundary needs. The calendar is therefore **computed, not fetched**: there\nis no upstream provider, no egress, and nothing that can go stale or 403.\n\nTwo published dates pin the convention end to end in `check.ts`: Lunar New Year\n2026 (month 1 day 1) on 2026-02-17, and Mid-Autumn 2026 (month 8 day 15) on\n2026-09-25.\n\nLunar months are **not numbered**. Correct lunisolar numbering needs leap-month\nand solstice rules this source does not implement, and a wrong month number is\nworse than none.\n\n## Files\n\n| File | Role |\n| --- | --- |\n| `lib/lunation.ts` | Pure arithmetic: new-moon instants, civil dates, a year of 15ths. No storage, clock or network. |\n| `lunarSource.ts` | Source definition, offset policy, item text, `lunar_fifteenths` storage and `rebuildYear`. |\n| `rpc.ts` | HTTP entry: bearer authentication around `serveSource`. |\n| `ingest.ts` | Annual interval; see below. |\n| `check.ts` | Contract, calendar, offset, protocol, auth and storage checks. Disposable rows are removed. |\n\n## Settings and items\n\nSettings are exactly `{}` — there is nothing to select, and the parent's browser\nform renders no controls. One item is returned: the next lunar 15th on or after\nthe reader's current civil date.\n\n```json\n{\n \"id\": \"lunar15-2026-09-25\",\n \"mainText\": \"Lunar 15th\",\n \"subText\": \"Cycle from Sep 11\",\n \"caption\": \"DAY 15\",\n \"emphasized\": false,\n \"timestamp\": 1790362800\n}\n```\n\n(local noon on 2026-09-25 for a reader at UTC-7)\n\n`timestamp` is Unix **seconds** at the reader's local noon on that date, so the\nwidget's own day label is the lunar 15th in every timezone. The lunar 15th is a\nwhole day rather than an instant, and `caption` is set so the widget does not\nrender that anchor time as if it meant something — the same reasoning behind\nMoon's `PEAK`.\n\n`utcOffsetSeconds: null` falls back to `America/Los_Angeles`, matching Moon.\nIt is not treated as UTC.\n\n## Ingest\n\n`ingest.ts` runs on cron **`0 0 1 12 *`** — once a year, on 1 December UTC — and\nrebuilds the whole of the next year, replacing that year's rows authoritatively.\nIt also rebuilds the current year, which is normally already stored and\nidentical; including it means one run of the file is also the deployment seed,\nso there is no separate first-year bootstrap to forget.\n\nThe same work is reachable over the protocol as the write operation\n`calendar.rebuild` with payload `{ \"year\": 2027 }`, for backfilling a year out\nof band. It rejects `invalid_rebuild_payload` outside 1900–2999.\n\nThe interval runs inside this val and so writes this val's SQLite directly.\nStorage is provisioned by `ensureSchema` during ingest, never on a feed read.\n\n## Deployment\n\n1. Set `SOURCE_LUNAR_V1_TOKEN` on this val.\n2. Register in `plusjade/sports-today`: `rpc.ts`'s endpoint, source key `lunar`,\n protocol version 1, and a credential reference holding the same bearer value\n configured independently in the parent. Then assign it to a device.\n3. Run `check.ts` after any change. With the token set it also covers the\n authenticated mount; without it, everything but that one assertion still runs.\n",[],[101],"37afaef2-395e-4382-b28c-052840aec393",["D",1788883767418],"directory",[113],[57],{"_33":34,"_13":35,"_36":37,"_38":39,"_40":41,"_42":43,"_44":45,"_46":114,"_17":48,"_49":50,"_51":52,"_53":54,"_55":-5,"_71":115,"_18":116},["D",1788883767418],[],[57,35],"7c1da428-9ae0-4299-8701-a1898366757a",["D",1788883743258],"deletedAt","legacyEnvVars","privacy","public","httpPrivacy","description","Clark View source: the 15th day of each lunar month","imageUrl","userId","b0a8da26-58e7-4d19-8b5c-eedf487df9a9","pinnedFileId","pinPreview","pinMigrated","screenshotVersion","likeCount","orgId","5a10edca-919b-4a78-babb-71908f69af93","tursoName","7c1da4289ae042998701a1898366757a","tursoHostname","7c1da4289ae042998701a1898366757a-val-town.aws-us-east-2.turso.io","tursoMeasuredAt",["D",1789492268774],"pinned","userPerm","r","valPerm","blobPerm","rw","emailPerm","sqlitePerm","projectPerm","telemetryPerm","user",{"_11":12,"_173":169},"org",{"_11":12,"_167":-5,"_168":169,"_127":128,"_170":171,"_172":54},"branch",{"_17":103,"_13":16,"_33":41,"_159":117,"_160":-5,"_161":-5,"_162":-5,"_163":-5,"_164":-5,"_165":14,"_166":12},"isOwned","projectId","forkedBranchId","forkedBranchVersion","forkedProjectPrivacy","forkedProjectId","forkedProjectOrgId","projectName","userHandle","displayName","avatar","https://img.clerk.com/eyJ0eXBlIjoicHJveHkiLCJzcmMiOiJodHRwczovL2ltYWdlcy5jbGVyay5kZXYvb2F1dGhfZ2l0aHViL2ltZ18yVHpab25kTlBTM3M3WmpCa3NMSTd5akVwWksuanBlZyJ9","tier","free","canRestrictVals","profileImageUrl","adoptOrgId",{"_33":117,"_13":14,"_46":224,"_119":-5,"_120":54,"_121":122,"_123":122,"_124":125,"_126":-5,"_127":128,"_129":66,"_130":45,"_131":-5,"_132":-5,"_133":48,"_134":135,"_136":137,"_138":139,"_140":225,"_142":-5,"_143":144,"_145":144,"_146":147,"_148":147,"_149":147,"_150":144,"_151":144,"_152":226,"_154":227,"_156":228,"_158":54},[203,205,206,207,208,209],"files",[203,204,205,206,207,208,209],"counts",{"_194":48,"_195":87,"_196":48,"_32":197,"_198":199},[],{"_33":34,"_13":35,"_36":37,"_38":39,"_40":41,"_42":43,"_44":45,"_46":47,"_17":48,"_49":50,"_51":52,"_53":54,"_55":-5,"_18":193},"upstreamProject","upstreamBranch","emptyEnvVars","flags",[],"hasHttpFiles","grants","orgs","customDomains",{},[57,35],"pulls","branches","forks",{"_200":87,"_202":48},"connections",{"_200":48,"_201":48},"count","unfilledCount","emptyCount",{"_33":108,"_13":57,"_36":39,"_38":-5,"_40":41,"_42":43,"_44":45,"_46":109,"_17":48,"_49":110,"_51":-5,"_53":54,"_55":-5,"_71":222,"_18":223},{"_33":34,"_13":35,"_36":37,"_38":39,"_40":41,"_42":43,"_44":45,"_46":114,"_17":48,"_49":50,"_51":52,"_53":54,"_55":-5,"_71":220,"_18":221},{"_33":100,"_13":101,"_36":102,"_38":-5,"_40":41,"_42":103,"_44":45,"_46":104,"_17":43,"_49":24,"_51":105,"_53":54,"_55":-5,"_71":218,"_18":219},{"_33":92,"_13":93,"_36":94,"_38":-5,"_40":41,"_42":95,"_44":45,"_46":96,"_17":48,"_49":50,"_51":97,"_53":54,"_55":-5,"_71":216,"_18":217},{"_33":82,"_13":83,"_36":84,"_38":-5,"_40":41,"_42":85,"_44":45,"_46":86,"_17":87,"_49":88,"_51":89,"_53":54,"_55":-5,"_71":214,"_18":215},{"_33":74,"_13":75,"_36":76,"_38":-5,"_40":41,"_42":77,"_44":45,"_46":78,"_17":48,"_49":50,"_51":79,"_53":54,"_55":-5,"_71":212,"_18":213},{"_33":64,"_13":65,"_36":66,"_38":-5,"_40":41,"_42":67,"_44":45,"_46":68,"_17":48,"_49":69,"_51":70,"_53":54,"_55":-5,"_71":210,"_18":211},[],[65],[],[75],[],[83],[],[93],[],[101],[],[57,35],[204],[57],["D",1788883743258],["D",1789492268774],{"_11":12,"_173":169},{"_11":12,"_167":-5,"_168":169,"_127":128,"_170":171,"_172":54},{"_17":103,"_13":16,"_33":41,"_159":117,"_160":-5,"_161":-5,"_162":-5,"_163":-5,"_164":-5,"_165":14,"_166":12},"ctx",{"_152":-5,"_190":262,"_263":264,"_265":266,"_267":54,"_268":54,"_269":54,"_270":45,"_271":-5,"_272":-7,"_273":-7,"_274":48,"_275":54,"_276":54,"_277":-5,"_278":54,"_279":54,"_280":54,"_281":-5},"ENV",{"_233":234,"_235":236,"_237":16,"_238":239,"_240":241,"_242":243,"_244":245,"_246":247,"_248":249,"_250":251,"_252":253,"_254":255,"_256":257,"_258":259,"_260":261},"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"]