[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10},"actionData","errors","root",{"_246":247,"_248":249},"routes/_app.x.$handle.$name",{"_11":12,"_13":14,"_107":-7,"_108":109,"_31":-7,"_110":-5,"_15":111,"_112":113,"_114":115,"_116":117,"_118":119,"_120":-5,"_121":-5,"_122":-5,"_123":54,"_124":125,"_126":127,"_128":-5,"_129":-5,"_130":131},"routes/_app.x.$handle.$name.branches",{"_11":12,"_13":14,"_15":16,"_17":18},"handle","plusjade","name","source-gtb","project",{"_22":30,"_13":14,"_24":52,"_39":-5,"_53":54,"_55":56,"_57":56,"_58":59,"_60":-5,"_61":62,"_63":64,"_65":54,"_66":-5,"_67":-5,"_68":69,"_70":71,"_72":73,"_74":75,"_76":77,"_78":-5,"_79":80,"_81":80,"_82":83,"_84":83,"_85":83,"_86":80,"_87":80,"_88":89,"_90":91,"_92":93,"_94":54},"branches",[19,20,21],{"_22":34,"_24":47,"_26":48,"_13":49,"_29":30,"_31":50,"_33":-5,"_35":-5,"_37":51,"_39":-5},{"_22":40,"_24":41,"_26":42,"_13":43,"_29":30,"_31":44,"_33":34,"_35":45,"_37":46,"_39":-5},{"_22":23,"_24":25,"_26":27,"_13":28,"_29":30,"_31":32,"_33":34,"_35":36,"_37":38,"_39":-5},"id","caf01072-0b69-496f-9756-972ac4951352","createdAt",["D",1789230554165],"updatedAt",["D",1789230686114],"codex-gtb-item-windows","projectId","a7b2eeb5-f918-4692-b7a6-a0c0bf445b34","version",15,"forkedBranchId","a3048ec0-333a-4b49-9884-3544cf56b1bc","forkedBranchVersion",8,"lockfileKey","1789230686244-esm.town_v_plusjade_source-gtb@15-codex-gtb-item-windows","deletedAt","93ca6783-b041-4938-b723-d4d7685cb9c4",["D",1789230815105],["D",1789230840127],"codex-gtb-starts-at",5,9,"1789230840354-esm.town_v_plusjade_source-gtb@5-codex-gtb-starts-at",["D",1788937002070],["D",1789231745657],"main",11,"1789231745798-esm.town_v_plusjade_source-gtb@11-main",["D",1788937002070],"legacyEnvVars",false,"privacy","public","httpPrivacy","description","Clark View source: flea medication reminder, 8th of every month","imageUrl","userId","b0a8da26-58e7-4d19-8b5c-eedf487df9a9","pinnedFileId","c169c7a2-ac1b-11f1-80ba-1607ee4eb77e","pinPreview","pinMigrated","screenshotVersion","likeCount",0,"orgId","5a10edca-919b-4a78-babb-71908f69af93","tursoName","a7b2eeb5f9184692b7a6a0c0bf445b34","tursoHostname","a7b2eeb5f9184692b7a6a0c0bf445b34-val-town.aws-us-east-2.turso.io","tursoMeasuredAt",["D",1789458074143],"pinned","userPerm","r","valPerm","blobPerm","rw","emailPerm","sqlitePerm","projectPerm","telemetryPerm","user",{"_11":12,"_106":102},"org",{"_11":12,"_100":-5,"_101":102,"_61":62,"_103":104,"_105":54},"branch",{"_31":50,"_13":49,"_22":34,"_29":30,"_33":-5,"_35":-5,"_95":-5,"_96":-5,"_97":-5,"_98":14,"_99":12},"isOwned","forkedProjectPrivacy","forkedProjectId","forkedProjectOrgId","projectName","userHandle","displayName","avatar","https://img.clerk.com/eyJ0eXBlIjoicHJveHkiLCJzcmMiOiJodHRwczovL2ltYWdlcy5jbGVyay5kZXYvb2F1dGhfZ2l0aHViL2ltZ18yVHpab25kTlBTM3M3WmpCa3NMSTd5akVwWksuanBlZyJ9","tier","free","canRestrictVals","profileImageUrl","branchName","path","","adoptOrgId",{"_22":30,"_13":14,"_24":241,"_39":-5,"_53":54,"_55":56,"_57":56,"_58":59,"_60":-5,"_61":62,"_63":64,"_65":54,"_66":-5,"_67":-5,"_68":69,"_70":71,"_72":73,"_74":75,"_76":242,"_78":-5,"_79":80,"_81":80,"_82":83,"_84":83,"_85":83,"_86":80,"_87":80,"_88":243,"_90":244,"_92":245,"_94":54},"tree",[204,206,207,208,209,210,211],"files",[204,205,206,207,208,209,210,211],"counts",{"_195":69,"_17":173,"_196":69,"_197":198,"_199":200},"contents",[132,133,134,135,136,137,138],"file","upstreamProject","upstreamBranch","emptyEnvVars","flags",[],"hasHttpFiles",true,"grants","orgs","customDomains",{},{"_22":189,"_13":190,"_141":191,"_142":-5,"_143":34,"_144":147,"_145":127,"_24":192,"_31":69,"_148":193,"_150":-5,"_152":54,"_153":-5,"_108":194},{"_22":182,"_13":183,"_141":184,"_142":-5,"_143":34,"_144":185,"_145":127,"_24":186,"_31":69,"_148":120,"_150":187,"_152":54,"_153":-5,"_108":188},{"_22":176,"_13":177,"_141":178,"_142":-5,"_143":34,"_144":50,"_145":127,"_24":179,"_31":173,"_148":120,"_150":180,"_152":54,"_153":-5,"_108":181},{"_22":169,"_13":170,"_141":171,"_142":-5,"_143":34,"_144":36,"_145":127,"_24":172,"_31":173,"_148":159,"_150":174,"_152":54,"_153":-5,"_108":175},{"_22":162,"_13":163,"_141":164,"_142":-5,"_143":34,"_144":45,"_145":127,"_24":165,"_31":166,"_148":159,"_150":167,"_152":54,"_153":-5,"_108":168},{"_22":155,"_13":156,"_141":157,"_142":-5,"_143":34,"_144":36,"_145":127,"_24":158,"_31":69,"_148":159,"_150":160,"_152":54,"_153":-5,"_108":161},{"_22":139,"_13":140,"_141":64,"_142":-5,"_143":34,"_144":36,"_145":127,"_24":146,"_31":147,"_148":149,"_150":151,"_152":54,"_153":-5,"_108":154},"94204429-75e0-4b77-a2fa-3489bd9d96fe","rpc.ts","fileId","parentId","branchId","branchVersion","latest",["D",1789230693679],1,"fileType","http","content","// Deployment authentication around the shared source protocol.\nimport { serveSource } from \"https://esm.town/v/plusjade/source-sdk@12-main/mod.ts\";\nimport gtb from \"./gtbSource.ts\";\nexport default function handler(req: Request): Promise | Response {\n const token = Deno.env.get(\"SOURCE_GTB_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(gtb, req);\n}\n","deleted","label",[140],"f0043e4a-5a49-4b3c-8f7e-a2a2b3cbde3c","http-check.ts","6ab3a33e-aec7-11f1-9b08-1607ee4eb77e",["D",1789230693679],"script","// Read-only verification of the deployed GTB protocol and stored windows.\nconst endpoint = \"https://plusjade--c169c7a2ac1b11f180ba1607ee4eb77e.web.val.run\";\nconst token = Deno.env.get(\"SOURCE_GTB_V1_TOKEN\");\nif (!token) throw new Error(\"SOURCE_GTB_V1_TOKEN is required\");\nconst headers = { authorization: `Bearer ${token}`, \"content-type\": \"application/json\" };\nconst unauth = await fetch(endpoint + \"/v1/descriptor?sourceKey=gtb\");\nif (unauth.status !== 401) throw new Error(\"Expected unauthenticated rejection\");\nconst descriptor = await fetch(endpoint + \"/v1/descriptor?sourceKey=gtb\", { headers });\nconst desc = await descriptor.json();\nif (!descriptor.ok || desc.sourceKey !== \"gtb\" || !desc.temporal) throw new Error(\"Invalid descriptor\");\nfor (const utcOffsetSeconds of [null, -43200, 50400]) {\n const response = await fetch(endpoint + \"/v1/read\", {\n method: \"POST\", headers,\n body: JSON.stringify({ protocolVersion: 1, sourceKey: \"gtb\", settings: {}, context: { utcOffsetSeconds } }),\n });\n const body = await response.json();\n if (!response.ok || body.protocolVersion !== 1 || body.sourceKey !== \"gtb\" || !body.items?.length)\n throw new Error(\"Expected a nonempty deployed feed; check stored schedule coverage\");\n for (const item of body.items) {\n if (!Number.isInteger(item.startsAt) || item.expiresAt !== item.startsAt + 3600 || \"timestamp\" in item)\n throw new Error(\"Invalid deployed window\");\n }\n}\nconsole.log(\"PASS: deployed authenticated descriptor/read, nonempty one-hour windows, timezone edges and auth rejection\");\n",[156],"ba2ed046-9034-4597-8cd8-4de431f2e5f6","gtbSource.ts","ad286ed8-ac1b-11f1-95ee-1607ee4eb77e",["D",1789230852564],2,"// Flea-medication reminder source: the 8th of every month, and nothing else.\n// Device settings are always empty; storage is GTB-only. main_text/sub_text\n// are stored as real columns, not a JSON payload, since every row carries\n// the same fixed reminder text.\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@12-main/mod.ts\";\nimport { monthlyDatesAfter, noonInZoneUtcSeconds } from \"./lib/schedule.ts\";\n\nconst FALLBACK_ZONE = \"America/Los_Angeles\";\nconst REMINDER_ZONE = \"America/Los_Angeles\";\nconst REMINDER_DAY = 8;\nconst REMINDER_DURATION_SECONDS = 3600;\nconst MAIN_TEXT = \"Give Flea medication\";\nconst SUB_TEXT = \"Gemma, Bron, Tilka \\u{1F408}\\u{1F408}‍⬛\\u{1F408}\";\n\n/** Provision at deployment, never on a feed read. */\nexport async function ensureSchema(): Promise {\n await sqlite.execute(`CREATE TABLE IF NOT EXISTS flea_medication_reminders(\n date_key TEXT PRIMARY KEY,\n main_text TEXT NOT NULL,\n sub_text TEXT NOT NULL,\n starts_at INTEGER NOT NULL,\n expires_at INTEGER 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/Lunar'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\nexport async function gtbItems(dateKey: string): Promise {\n const result = await sqlite.execute({\n sql: \"SELECT date_key, main_text, sub_text, starts_at, expires_at FROM flea_medication_reminders WHERE date_key >= ? ORDER BY date_key LIMIT 1\",\n args: [dateKey],\n });\n const row = result.rows[0];\n if (!row) return [];\n return [{\n id: `gtb-${row.date_key}`,\n mainText: String(row.main_text),\n subText: String(row.sub_text),\n // Noon Pacific is the actual reminder instant, not a whole-day or\n // astronomical event, so let the widget render it as a real clock time.\n caption: null,\n emphasized: false,\n startsAt: Number(row.starts_at),\n expiresAt: Number(row.expires_at),\n }];\n}\n\n/** Replace the next `count` monthly reminders authoritatively, starting after `afterDateKey`. */\nexport async function rebuildSchedule(count: number, afterDateKey: string): Promise {\n await ensureSchema();\n const dateKeys = monthlyDatesAfter(REMINDER_DAY, count, afterDateKey);\n const fetchedAt = new Date().toISOString();\n for (const dateKey of dateKeys) {\n const startsAt = noonInZoneUtcSeconds(dateKey, REMINDER_ZONE);\n await sqlite.execute({\n sql: `INSERT INTO flea_medication_reminders(date_key,main_text,sub_text,starts_at,expires_at,fetched_at) VALUES(?,?,?,?,?,?)\n ON CONFLICT(date_key) DO UPDATE SET main_text=excluded.main_text,sub_text=excluded.sub_text,starts_at=excluded.starts_at,expires_at=excluded.expires_at,fetched_at=excluded.fetched_at`,\n args: [dateKey, MAIN_TEXT, SUB_TEXT, startsAt, startsAt + REMINDER_DURATION_SECONDS, fetchedAt],\n });\n }\n return dateKeys.length;\n}\n\nexport default defineSource({\n key: \"gtb\",\n settingsSchema: { type: \"object\", properties: {}, additionalProperties: false },\n parseSettings: (raw) => Object.keys(raw).length === 0 ? accept(null) : reject(\"invalid_settings\"),\n read: (_, { utcOffsetSeconds }) => gtbItems(fromDate(utcOffsetSeconds)),\n writes: {\n // Idempotent authoritative rebuild, mirroring Lunar's calendar.rebuild:\n // the only way this fixed-formula schedule needs to change is extending\n // the window, so there is no per-date upstream to page through.\n \"reminders.rebuild\": async (raw) => {\n const count = raw.count;\n const after = raw.after;\n if (!record(raw) || typeof count !== \"number\" || !Number.isInteger(count)\n || count < 1 || count > 60\n || typeof after !== \"string\" || !/^\\d{4}-\\d{2}-\\d{2}$/.test(after)) {\n return reject(\"invalid_rebuild_payload\");\n }\n return accept({ count: await rebuildSchedule(count, after) });\n },\n },\n});\n",[163],"9cd878da-8429-4fdb-8861-8a02b20823de","check.ts","cc43f72e-ac1b-11f1-bbe2-1607ee4eb77e",["D",1789230693679],3,"// GTB contract, schedule and storage checks. Disposable rows are removed.\nimport handler from \"./rpc.ts\";\nimport gtb from \"./gtbSource.ts\";\nimport { fromDate, gtbItems, offsetSecondsFor, rebuildSchedule, ensureSchema } from \"./gtbSource.ts\";\nimport { monthlyDatesAfter, noonInZoneUtcSeconds } from \"./lib/schedule.ts\";\nimport { serveSource } from \"https://esm.town/v/plusjade/source-sdk@12-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: \"gtb\" };\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(gtb, new Request(\"https://gtb.invalid\" + path, {\n method: body === undefined ? \"GET\" : \"POST\",\n ...(body === undefined ? {} : { body: JSON.stringify(body) }),\n }));\n}\n\n// --- schedule arithmetic ------------------------------------------------------\nconst dates = monthlyDatesAfter(8, 12, \"2026-09-09\");\ncheck(dates.length === 12, \"twelve dates\");\ncheck(dates[0] === \"2026-10-08\", \"starts after this month's 8th has already passed\");\ncheck(dates[11] === \"2027-09-08\", \"twelve months out\");\ncheck(dates.every((d, i) => i === 0 || d > dates[i - 1]), \"ascending\");\ncheck(new Set(dates).size === dates.length, \"unique date keys\");\ncheck(dates.every((d) => d.slice(8, 10) === \"08\"), \"always the 8th\");\ncheck(monthlyDatesAfter(8, 3, \"2026-01-08\")[0] === \"2026-02-08\", \"on-the-day is not after itself\");\ncheck(monthlyDatesAfter(31, 1, \"2026-03-01\")[0] === \"2026-03-31\", \"31st exists in a long month\");\ncheck(monthlyDatesAfter(31, 1, \"2026-01-31\")[0] === \"2026-02-28\", \"clamped in a short month\");\n\ncheck(noonInZoneUtcSeconds(\"2026-10-08\", \"America/Los_Angeles\") === Date.parse(\"2026-10-08T19:00:00Z\") / 1000, \"PDT noon offset\");\ncheck(noonInZoneUtcSeconds(\"2026-11-08\", \"America/Los_Angeles\") === Date.parse(\"2026-11-08T20:00:00Z\") / 1000, \"PST noon offset\");\ncheck(noonInZoneUtcSeconds(\"2027-09-08\", \"America/Los_Angeles\") === Date.parse(\"2027-09-08T19:00:00Z\") / 1000, \"PDT noon offset a year out\");\n\n// --- offsets and selection ---------------------------------------------------\ncheck(offsetSecondsFor(50400, \"2026-06-01\") === 50400, \"offset passthrough\");\ncheck(offsetSecondsFor(null, \"2026-01-04\") === -28800, \"null falls back to Pacific standard\");\n\n// --- protocol ----------------------------------------------------------------\nconst desc = await (await call(\"/v1/descriptor?sourceKey=gtb\")).json();\ncheck(desc.temporal && desc.sourceKey === \"gtb\", \"descriptor\");\ncheck(JSON.stringify(desc.capabilities.write) === '[\"reminders.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: \"reminders.rebuild\", payload: { count: \"12\", after: \"2026-09-09\" } })).status === 400, \"non-numeric count\");\ncheck((await call(\"/v1/write\", { ...base, operation: \"reminders.rebuild\", payload: { count: 12, after: \"bad-date\" } })).status === 400, \"bad after date\");\ncheck((await call(\"/v1/publish\", base)).status === 501, \"publish\");\n\n// The mount adds only authentication.\nconst unauth = await handler(new Request(\"https://gtb.invalid/v1/descriptor\"));\ncheck(unauth.status === 401 || unauth.status === 503, \"mount rejects a missing bearer\");\nconst token = Deno.env.get(\"SOURCE_GTB_V1_TOKEN\");\nif (token) {\n const authed = await handler(new Request(\"https://gtb.invalid/v1/descriptor?sourceKey=gtb\", {\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\";\nconst fixtureAfter = `${fixtureYear}-01-01`;\ntry {\n const count = await rebuildSchedule(2, fixtureAfter);\n check(count === 2, \"rebuild writes the requested count\");\n check(await rebuildSchedule(2, fixtureAfter) === 2, \"rebuild is idempotent\");\n\n const first = monthlyDatesAfter(8, 1, fixtureAfter)[0];\n const [item] = await gtbItems(first);\n check(item.id === `gtb-${first}`, \"stable id\");\n check(item.mainText === \"Give Flea medication\", \"main text\");\n check(item.subText === \"Gemma, Bron, Tilka \\u{1F408}\\u{1F408}‍⬛\\u{1F408}\", \"sub text\");\n check(item.caption === null, \"no caption: the timestamp itself is the reminder time\");\n check(item.startsAt === noonInZoneUtcSeconds(first, \"America/Los_Angeles\"), \"stored noon-Pacific instant\");\n check(item.expiresAt === item.startsAt + 3600, \"one-hour stored expiry\");\n check(!(\"timestamp\" in item), \"source emits window fields only\");\n check((await gtbItems(\"2200-01-01\")).length === 0, \"exhaustion past the ingested window\");\n check((await gtbItems(fromDate(null, new Date(first + \"T00:00:00Z\"))))[0]?.id === `gtb-${first}`, \"fromDate selects the fixture row\");\n} finally {\n await sqlite.execute({ sql: \"DELETE FROM flea_medication_reminders WHERE date_key LIKE ?\", args: [`${fixtureYear}-%`] });\n}\n\nconsole.log(\"PASS: GTB schedule arithmetic, noon-Pacific conversion, offsets, protocol, auth, storage and cleanup\");\n",[170],"4bc0352c-69e8-4528-a9ac-dc272eb67c81","README.md","081ea708-ac1c-11f1-bbe2-1607ee4eb77e",["D",1789231745657],"# source-gtb\n\nA Clark View source that reminds to give flea medication on the 8th of every\nmonth, and nothing else. Every row carries the same fixed text.\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## Agent data entry\n\n[AGENTS.md](AGENTS.md) owns the `add-entry:` shortcut for individual custom events,\nincluding normalization, conflict handling, and transactional verification. Update\nit alongside changes to storage or reader selection. It uses direct SQLite access;\nit is separate from the authoritative monthly `reminders.rebuild` operation.\n\n## Storage\n\nUnlike Moon/Lunar, which store a JSON `payload` column and derive display\ntext in code, `flea_medication_reminders` stores `main_text` and `sub_text`\nas real columns — every row's reminder text is identical, so there is\nnothing a payload blob would buy here:\n\n```sql\nCREATE TABLE flea_medication_reminders(\n date_key TEXT PRIMARY KEY,\n main_text TEXT NOT NULL,\n sub_text TEXT NOT NULL,\n starts_at INTEGER NOT NULL,\n expires_at INTEGER NOT NULL,\n fetched_at TEXT NOT NULL\n)\n```\n\nThe existing database received an additive nullable `expires_at INTEGER` column;\nall existing rows were backfilled with `starts_at + 3600`. New databases use the\nNOT NULL schema above. Every write must supply expiry; missing/invalid windows\nare rejected by the SDK on read. Reads never migrate storage.\n\n## Files\n\n| File | Role |\n| --- | --- |\n| `lib/schedule.ts` | Pure arithmetic: monthly date generation, noon-in-zone-to-UTC conversion. No storage, clock or network. |\n| `gtbSource.ts` | Source definition, offset policy, item text, `flea_medication_reminders` storage and `rebuildSchedule`. |\n| `rpc.ts` | HTTP entry: bearer authentication around `serveSource`. |\n| `check.ts` | Contract, schedule, DST, 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\nbrowser form renders no controls. One item is returned: the next reminder\non or after the reader's current civil date.\n\n```json\n{\n \"id\": \"gtb-2026-10-08\",\n \"mainText\": \"Give Flea medication\",\n \"subText\": \"Gemma, Bron, Tilka 🐈🐈‍⬛🐈\",\n \"caption\": null,\n \"emphasized\": false,\n \"startsAt\": 1791486000,\n \"expiresAt\": 1791489600\n}\n```\n\n(noon Pacific on 2026-10-08, stored as 19:00 UTC — PDT is in effect that date)\n\n`startsAt` (stored in `starts_at`) is Unix **seconds** for local noon in `America/Los_Angeles` on the\nreminder date, precomputed and stored in UTC at write time — it does not\ndepend on the reader's timezone. `caption` is `null`, unlike Moon's `PEAK` or\nLunar's `DAY 15`: noon Pacific is the actual reminder instant here, not a\nwhole-day or astronomical event, so the widget renders it as a real clock\ntime in the reader's own zone. `expiresAt` is stored in `expires_at`, exactly one\nhour after the start for rebuilt reminders. It controls lifecycle and refresh timing\nand is never displayed. The source uses SDK snapshot `12-main` and emits no legacy\nwire `timestamp`; the parent owns compatibility for older clients.\n\n`utcOffsetSeconds: null` (used only to pick the reader's \"today\" for\nselecting the next row) falls back to `America/Los_Angeles`, matching\nMoon/Lunar.\n\n## Populating and extending the schedule\n\nThe write operation `reminders.rebuild` replaces the next `count` monthly\nreminders authoritatively, starting after `after` (`YYYY-MM-DD`):\n\n```json\n{ \"protocolVersion\": 1, \"sourceKey\": \"gtb\", \"operation\": \"reminders.rebuild\",\n \"payload\": { \"count\": 12, \"after\": \"2026-09-09\" } }\n```\n\nThe initial 12 months (2026-10-08 through 2027-09-08) were seeded this way at\ndeployment. There is no automatic reseed job — unlike Lunar's annual interval,\nthis schedule is a fixed formula with nothing upstream to poll for, but it\nstill needs a fresh `reminders.rebuild` call with a later `after` date before\nthe stored window is exhausted. Add an interval later if ongoing unattended\nextension is wanted; it was left out here as unbuilt scope, not an oversight.\n\n## Deployment\n\n1. Set `SOURCE_GTB_V1_TOKEN` on this val.\n2. Register in `plusjade/app-clarkview`: `rpc.ts`'s endpoint, source key `gtb`,\n protocol version 1, and a credential reference holding the same bearer\n value 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\n runs.\n4. Run `http-check.ts` after merging to verify the deployed authenticated descriptor\n and nonempty window feed at null and extreme timezone offsets.\n",[177],"2f340d32-cc7d-474d-ad8f-841b3873592e","AGENTS.md","b4d1938e-aec9-11f1-9274-1607ee4eb77e",10,["D",1789231677034],"# add-entry: source-gtb\n\nThis is the complete operational contract for inserting one GTB event. Read only\nthis file for an add-entry request; no parent, SDK, README, or repository brief is\nneeded. Keep this file synchronized when GTB's schema or selection changes.\n\n## Scope and input\n\nTarget: `plusjade/source-gtb`, val-scoped SQLite, table\n`flea_medication_reminders`. Use Val Town MCP SQLite directly. This operation is\nauthorized by an explicit add-entry request. Never call `reminders.rebuild`,\nedit code/schema, create branches, fetch credentials, send notifications, or\ninspect the parent as part of this path.\n\nPreferred prompt (JSON after the source name):\n\n```text\nadd-entry: source-gtb {\"starts_at\":\"2026-09-12T17:00:00-07:00\",\"duration_seconds\":3600,\"main_text\":\"Facetime with Bron\",\"sub_text\":\"healthcheck\"}\n```\n\nRequired: offset-qualified ISO start, integer duration 1..86400 seconds, nonblank\nmain_text. sub_text defaults to \"\"; preserve supplied text exactly. Reject unknown\nfields rather than silently ignoring them. Duration is elapsed seconds, including\nacross DST. The one-day maximum is an intentional limit of this shortcut.\n\nNatural-language equivalents are accepted when unambiguous: \"today at 5pm,\nexpires 1 hour\" means a one-hour duration, in America/Los_Angeles unless the user\nspecifies a different timezone. Capture the current clock once for relative dates;\ndo not use a stale conversation date. Resolve calendar dates using an IANA timezone\nwith a timezone-aware runtime, not mental UTC arithmetic. Ask once if required\ninformation is missing or a local time is nonexistent/ambiguous at a DST transition.\n\"Today\" stays today even if the requested time has passed; do not roll to tomorrow.\nRestate the resolved date/time and offset in the result.\n\n## Normalize before any write\n\nUse a local runtime (Python standard library datetime/zoneinfo is sufficient).\nConvert the supplied start to an aware datetime; require an explicit offset in\ncanonical input, whole seconds, and year 2000..2100. Validate by parsing and\nround-tripping the supplied calendar date/time (reject invalid dates). Require\nduration_seconds to be an integer, not a boolean, and main_text/sub_text to be\nstrings. Check nonblank main_text without trimming the stored text.\n\nCompute deterministically:\n\n- starts_at = integer Unix seconds from that datetime.\n- expires_at = starts_at + duration_seconds, also integer Unix seconds.\n- date_key = start converted to America/Los_Angeles, formatted YYYY-MM-DD.\n This source-owned date rule applies even when the input uses another timezone.\n- fetched_at = current UTC ISO timestamp captured for this operation.\n\nThe start and expiry must be finite, with expiry strictly greater than start.\nDo not compute timestamps in the language model or send milliseconds. Do not\ninterpolate user text into SQL, shell commands, or executable code: pass it as data.\n\n## One transactional write and read-back\n\nDiscover only `val_town_sqlite_batch` if it is not already callable. Call it with:\n\n```json\n{\"database\":{\"type\":\"val\",\"val\":\"plusjade/source-gtb\"},\"mode\":\"write\",\"statements\":[\n {\"sql\":\"\",\"args\":\"\"},\n {\"sql\":\"\",\"args\":\"\"}\n]}\n```\n\nThe placeholders above describe tool arguments, not literal strings to submit.\nUse named args objects containing exactly the parameters each statement references.\nRun these two statements in order in the same transaction:\n\n```sql\nINSERT INTO flea_medication_reminders\n (date_key, main_text, sub_text, starts_at, expires_at, fetched_at)\nVALUES (:date_key, :main_text, :sub_text, :starts_at, :expires_at, :fetched_at)\nON CONFLICT(date_key) DO NOTHING;\n```\n\n```sql\nSELECT date_key, main_text, sub_text, starts_at, expires_at,\n CASE WHEN main_text = :main_text AND sub_text = :sub_text\n AND starts_at = :starts_at AND expires_at = :expires_at\n AND typeof(starts_at) = 'integer' AND typeof(expires_at) = 'integer'\n AND expires_at > starts_at AND expires_at - starts_at <= 86400\n THEN 1 ELSE 0 END AS matches_request\nFROM flea_medication_reminders WHERE date_key = :date_key;\n```\n\nSuccess requires a successful transaction, exactly one verification row, and\n`matches_request = 1`. Insert rowsAffected=1 means added; 0 with matching read-back\nmeans already present (safe retry). fetched_at is not part of duplicate identity.\n\nA different event on the same date produces rowsAffected=0 and matches_request=0:\nreport the date conflict, make no further writes, and ask whether the user wants\nto replace that entry as a separate request. Never silently upsert or manufacture\na different date_key. SQL errors roll back the batch; a missing table/column is\nschema drift, not permission to migrate. Report the error and stop the shortcut.\nIf the tool outcome is uncertain, repeat the exact normalized request; do not\nreinterpret relative time or change dates. The unique key prevents duplicates.\n\nAfter success, finish immediately: \"Added [text] to source-gtb: [resolved start]\nfor [duration]. Stored row verified.\" Say \"Already present\" for an exact retry.\nNo production smoke-test fixtures, broad checks, logs in repository docs, or\nadditional MCP reads are needed.\n\n## Dependencies and limits\n\n- Requires Val Town edit/SQLite access and a runtime with timezone data.\n- date_key is the primary key: one event per Pacific date. Multiple events on a\n date need a separate schema/reader change, outside this shortcut.\n- Storage columns are date_key, main_text, sub_text, starts_at, expires_at,\n fetched_at. The existing expires_at column is nullable; this path always writes\n an integer. Wire fields are startsAt/expiresAt; row ID becomes gtb-.\n- GTB returns one row: first date_key on/after the reader's current civil date.\n It does not filter on expiry. An earlier date can hide this entry; clients in\n other timezones can cross the date boundary sooner or later.\n- reminders.rebuild can overwrite custom entries on the 8th. If inserting on\n the 8th, include that concrete limitation in the result.\n- Completion proves exact persisted content, not assignment, device refresh,\n widget visibility, or notification delivery. No parent context is required.\n- This bypasses the source write API; these checks are the ingest boundary.\n Schema/reader maintainers must update this file in the same change.\n",[183],"6a900a50-a3d1-4d66-8daa-8a1b52b3238c","lib","94313899-2b4a-48d2-8d44-57fc3efb0203",["D",1788937012306],"directory",[190],"pulls","forks","envVars",{"_201":147,"_203":69},"connections",{"_201":69,"_202":69},"count","unfilledCount","emptyCount",{"_22":189,"_13":190,"_141":191,"_142":-5,"_143":34,"_144":147,"_145":127,"_24":238,"_31":69,"_148":193,"_150":-5,"_152":54,"_153":-5,"_213":239,"_108":240},{"_22":231,"_13":232,"_141":233,"_142":191,"_143":34,"_144":147,"_145":127,"_24":234,"_31":69,"_148":159,"_150":235,"_152":54,"_153":-5,"_213":236,"_108":237},{"_22":182,"_13":183,"_141":184,"_142":-5,"_143":34,"_144":185,"_145":127,"_24":228,"_31":69,"_148":120,"_150":187,"_152":54,"_153":-5,"_213":229,"_108":230},{"_22":176,"_13":177,"_141":178,"_142":-5,"_143":34,"_144":50,"_145":127,"_24":225,"_31":173,"_148":120,"_150":180,"_152":54,"_153":-5,"_213":226,"_108":227},{"_22":169,"_13":170,"_141":171,"_142":-5,"_143":34,"_144":36,"_145":127,"_24":222,"_31":173,"_148":159,"_150":174,"_152":54,"_153":-5,"_213":223,"_108":224},{"_22":162,"_13":163,"_141":164,"_142":-5,"_143":34,"_144":45,"_145":127,"_24":219,"_31":166,"_148":159,"_150":167,"_152":54,"_153":-5,"_213":220,"_108":221},{"_22":155,"_13":156,"_141":157,"_142":-5,"_143":34,"_144":36,"_145":127,"_24":216,"_31":69,"_148":159,"_150":160,"_152":54,"_153":-5,"_213":217,"_108":218},{"_22":139,"_13":140,"_141":64,"_142":-5,"_143":34,"_144":36,"_145":127,"_24":212,"_31":147,"_148":149,"_150":151,"_152":54,"_153":-5,"_213":214,"_108":215},["D",1789230693679],"children",[],[140],["D",1789230693679],[],[156],["D",1789230852564],[],[163],["D",1789230693679],[],[170],["D",1789231745657],[],[177],["D",1789231677034],[],[183],"a4dce68c-9802-4f80-a2b3-48f0febc997f","schedule.ts","a2f8eb7c-ac1b-11f1-bbe6-1607ee4eb77e",["D",1788937012306],"// Pure monthly-reminder date arithmetic: no storage, no clock side effects\n// beyond the `now`/`afterDateKey` callers pass in explicitly.\n\n/** Civil YYYY-MM-DD for `day` in `year`-`month` (1-indexed), clamped to the month's real last day. */\nfunction civilDateForMonth(year: number, month: number, day: number): string {\n const lastDay = new Date(Date.UTC(year, month, 0)).getUTCDate();\n const clamped = Math.min(day, lastDay);\n return `${year}-${String(month).padStart(2, \"0\")}-${String(clamped).padStart(2, \"0\")}`;\n}\n\n/**\n * The next `count` civil dates falling on `day` of consecutive months,\n * starting from the first such date strictly after `afterDateKey`.\n */\nexport function monthlyDatesAfter(day: number, count: number, afterDateKey: string): string[] {\n const [afterYear, afterMonth] = afterDateKey.split(\"-\").map(Number);\n let year = afterYear;\n let month = afterMonth;\n if (civilDateForMonth(year, month, day) <= afterDateKey) {\n month += 1;\n if (month > 12) { month = 1; year += 1; }\n }\n const out: string[] = [];\n for (let i = 0; i < count; i++) {\n out.push(civilDateForMonth(year, month, day));\n month += 1;\n if (month > 12) { month = 1; year += 1; }\n }\n return out;\n}\n\n/** The IANA zone's UTC offset in seconds, east-positive, at `instantMs`. */\nfunction offsetSecondsAt(instantMs: number, timeZone: string): number {\n const name = new Intl.DateTimeFormat(\"en-US\", { timeZone, timeZoneName: \"longOffset\" })\n .formatToParts(new Date(instantMs))\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/**\n * Unix seconds of local noon on civil date `dateKey` in `timeZone`, correct\n * across a DST transition. Noon UTC on `dateKey` always falls in the same\n * `timeZone` civil day as local noon (the gap between them is at most a few\n * hours, far short of a day), so resolving the offset there and correcting\n * once is exact — no fixed-point iteration needed.\n */\nexport function noonInZoneUtcSeconds(dateKey: string, timeZone: string): number {\n const noonUtcGuessMs = Date.parse(dateKey + \"T12:00:00Z\");\n const offsetSeconds = offsetSecondsAt(noonUtcGuessMs, timeZone);\n return noonUtcGuessMs / 1000 - offsetSeconds;\n}\n",[],[190,232],["D",1788937012306],[205],[190],["D",1788937002070],["D",1789458074143],{"_11":12,"_106":102},{"_11":12,"_100":-5,"_101":102,"_61":62,"_103":104,"_105":54},{"_31":50,"_13":49,"_22":34,"_29":30,"_33":-5,"_35":-5,"_95":-5,"_96":-5,"_97":-5,"_98":14,"_99":12},"ctx",{"_88":-5,"_129":279,"_280":281,"_282":283,"_284":54,"_285":54,"_286":54,"_287":127,"_288":-5,"_289":-7,"_290":-7,"_291":69,"_292":54,"_293":54,"_294":-5,"_295":54,"_296":54,"_297":54,"_298":-5},"ENV",{"_250":251,"_252":253,"_254":49,"_255":256,"_257":258,"_259":260,"_261":262,"_263":264,"_265":266,"_267":268,"_269":270,"_271":272,"_273":274,"_275":276,"_277":278},"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"]

Branches3

Branches
3