Where your leads come from, and what goes back

[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10},"actionData","errors","root",{"_841":842,"_843":844},"routes/_app.x.$handle.$name",{"_98":97,"_32":43,"_107":88,"_27":108,"_13":14,"_109":-5,"_11":110,"_111":112,"_113":114,"_115":116,"_117":118,"_20":-5,"_119":-5,"_120":-5,"_121":47,"_122":123,"_124":25,"_125":-5,"_126":-5,"_127":128},"routes/_app.x.$handle.$name.branch.$branch.version.$version.diff",{"_11":12,"_13":14,"_15":16,"_17":-5,"_18":-5},"project",{"_41":42,"_32":43,"_36":44,"_45":-5,"_46":47,"_48":49,"_50":49,"_51":52,"_53":-5,"_18":54,"_55":56,"_57":25,"_58":-5,"_59":-5,"_60":61,"_62":63,"_64":65,"_66":67,"_68":69,"_70":-5,"_71":72,"_73":72,"_74":75,"_76":75,"_77":75,"_78":72,"_79":72,"_80":81,"_82":83,"_84":85,"_86":47},"version",1268,"changes",[19],"aiChatInfo","userId",{"_20":21,"_22":23,"_24":25,"_26":25,"_27":28,"_29":28},"file",{"_30":31,"_32":28,"_33":20,"_34":35,"_36":37,"_38":14,"_39":40,"_24":25},"previous",{"_30":31,"_32":28,"_33":20,"_34":35},"deleted",true,"deletedHere","path","SOURCE-BUNDLE.part35.txt","latestPath","fileId","8a7ac07e-97ea-11f1-a03f-1607ee4eb77e","name","fileType","content","THE DOGS SPOT — SOURCE BUNDLE (part 35 of 47)\n\nEVERY source file in this project, engine/ included. Restoring these parts and nothing else gives\nyou a tree that builds, typechecks and runs its own test suite with no network and no val.\n\nengine/ is here as of 14 Aug 2026. It used to be left out because val 1bfa6e81-74e1-4c6c-ab32-118304a4ffff\nholds it, which was true of every engine file except engine/watch.ts: a module the val does not run,\nso it was never deployed, so it lived in one container and nothing else. A reclaim destroyed it.\nscripts/deploy.mjs --check still compares engine/ against the val file by file; that is a second\ncheck on the same files now, not the only copy of them.\n\nRESTORE (needs only node, from an empty folder). Save each part, then run this ON EACH ONE:\n\n node -e 'const fs=require(\"fs\"),p=require(\"path\");const b=fs.readFileSync(process.argv[1],\"utf8\");\n for(const s of b.split(\"\\n=====FILE \").slice(1)){const i=s.indexOf(\" =====\\n\");\n const f=s.slice(0,i),c=s.slice(i+7);fs.mkdirSync(p.dirname(f),{recursive:true});\n fs.writeFileSync(f,c.replace(/\\n$/,\"\"))}' PART.txt\n\nA record named #1, #2, ... is one FILE cut into pieces: concatenate them in order, then\nstrip one trailing newline from the last. scripts/restore.mjs does this for you.\n\nEach part is complete in itself: whole files only, no reassembly, any order.\n\nThen: node scripts/build.mjs (engine/ came out of these parts; nothing to fetch first)\n node scripts/typecheck.mjs\n node tests/run-all.mjs\n node scripts/deploy.mjs --check (pulls nothing, proves the val matches what you restored)\n node tests/negative-controls.mjs (proves the suite above can actually fail)\n\nIN THIS PART (1 of 129 files)\n\n\n================================================================================================\n=====FILE scripts/counter-sales-correction.mjs#1 =====\n#!/usr/bin/env node\n// THE COUNTER SALES CORRECTION PACK. Generator, 12 Aug 2026.\n//\n// WHY THIS EXISTS. The client has, in writing, \"33 counter sales worth $22,651.99 are recorded but\n// not linked to a customer, four with a partial trail worth $2,829.99 and 29 worth $19,822.00 that\n// arrived with no name, email or phone attached at all\". That is the THIRD wrong version of this\n// one number (42 / $33,535.99, then 29 / $19,822.00, then 33 / $22,651.99). The true figure is\n// 4 payments worth $1,969.99. LESSONS.md #14 has the cause: the grouping KEY, not the rule.\n//\n// WHAT IT WRITES (all to /mnt/user-data/outputs, override with CORRECTION_OUT_DIR):\n// counter-sales-not-linked.csv the four, each verified against Square itself\n// counter-sales-CORRECTION.md one page for the owner, leading with the corrected figure\n// writeback-dry-run.csv the real remaining work: money on a named customer, not on a booking\n//\n// NOTHING HERE WRITES TO A LIVE SYSTEM. Every call is a GET except POST /contacts/search, which is\n// GoHighLevel's read route for contacts and mutates nothing. There is no PUT, PATCH or DELETE in\n// this file, and no code path that sets an opportunity value. File 3 describes a write; it is not\n// one. Same posture as engine/money-match.ts and scripts/client-files-rebuild.mjs, and for the\n// same reason: another application also writes opportunities in this location, so until its owner\n// confirms whether it owns monetaryValue, two systems would own one field and one would win at\n// random.\n//\n// THE RULES IT ENFORCES, each one already paid for:\n// - THE RULE IS IMPORTED, NEVER RETYPED (LESSONS #14). paymentUniverse() and\n// squarePaymentIdsInRow() come from scripts/exception-report-lib.mjs, the tested parser. A\n// fourth hand written copy of \"which payments are unlinked\" is how the first three went wrong.\n// - AND THEN CHECKED BY A METHOD THAT SHARES NO CODE WITH IT. independentUnmatched() below\n// re-derives the same set by SET SUBTRACTION with a shape based id parser, and the run dies if\n// the two disagree. Two readings that share a helper share its bugs.\n// - A SUBSET NEVER SHIPS WITHOUT ITS PARENT (LESSONS #8). Every population is printed as \"n of N\"\n// and the remainder is proved to add back, in rows and in cents, or the run dies.\n// - NEVER TRUST A FLAG TO ANSWER A QUESTION IT WAS NOT ASKED (engine/facts.ts squareSentence).\n// hadEmail/hadPhone/hadCustomerId describe the WEBHOOK PAYLOAD, not what Square holds. Live,\n// they are backwards for two of the four. Every buyer detail in file 1 comes from Square's own\n// record through ?lookup=, and the disagreement is printed rather than smoothed over.\n// - NO DASHES AS PUNCTUATION, AND NEVER THE WORD \"DAYCARE\", in anything the client reads.\n// Checked mechanically at the end, same as scripts/exception-report.mjs.\n// - SENTENCES ARE GENERATED FROM VALUES. Every figure in the markdown is interpolated from a\n// computed variable. No number is typed beside prose anywhere in this file.\n//\n// USAGE\n// source /home/claude/.ghlenv && node scripts/counter-sales-correction.mjs\n// ENV\n// GHL_TOKEN, BRIDGE_ADMIN required\n// CORRECTION_OUT_DIR default /mnt/user-data/outputs\n// CORRECTION_CACHE_DIR if set, raw API responses are cached here and reused on re-run\n\nimport { writeFileSync, mkdirSync, existsSync, readFileSync } from \"node:fs\";\nimport { join, dirname, resolve } from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\n\nconst HERE = dirname(fileURLToPath(import.meta.url));\nconst ROOT = resolve(HERE, \"..\");\nconst { paymentUniverse, journalAmount, cents } = await import(join(ROOT, \"scripts\", \"exception-report-lib.mjs\"));\n\nconst shout = (m) => console.error(`\\n!!!! ${m} !!!!\\n`);\nconst die = (m) => { shout(m); process.exit(1); };\n\nconst LOCATION = \"BQHJ19uohldYe3eqA0bl\";\nconst GHL = \"https://services.leadconnectorhq.com\";\nconst BRIDGE = \"https://amir5--41ace24c7e2111f18c9d1607ee4eb77e.web.val.run\";\nconst UA = \"curl/8.5.0\"; // the API 403s without this exact User-Agent. Not optional, not cosmetic.\nconst TOKEN = process.env.GHL_TOKEN;\nconst ADMIN = process.env.BRIDGE_ADMIN;\nif (!TOKEN) die(\"GHL_TOKEN is not set. `source /home/claude/.ghlenv` first.\");\nif (!ADMIN) die(\"BRIDGE_ADMIN is not set. `source /home/claude/.ghlenv` first.\");\n\n// THE TWO STAGES A PAYMENT MAY EVER BE WRITTEN TO. Asserted equal to engine/money-match.ts's own\n// list below: the scope lives in both places on purpose, and an unscoped write puts money on a\n// Survey Requested card (proven live, $4,020 of $4,685 landed off the booking board).\nconst VALUABLE_STAGES = [\"fd821b4e-bbe6-44de-b754-fa80e4823616\", \"ae173310-f8b1-4399-acb7-ef1fc03d3697\"];\n// USE HER NAMES FOR HER THINGS. This map is filled from the client's own pipeline definition at\n// run time and is deliberately EMPTY here. A typed copy of a board name drifts silently: this file\n// carried \"Won and Paid\" for weeks and the board in her CRM is called \"Won - Paid\". A client\n// reading a board name that does not exist on her screen cannot check anything we tell her.\nconst STAGE_NAME = {};\nconst IN_SCOPE = new Set(VALUABLE_STAGES);\n{\n const src = readFileSync(join(ROOT, \"engine\", \"money-match.ts\"), \"utf8\");\n for (const s of VALUABLE_STAGES) {\n if (!src.includes(s)) die(`stage ${s} is not in engine/money-match.ts VALUABLE_STAGES. The two scope lists have drifted; fix that before planning a write.`);\n }\n}\n\nconst CACHE = process.env.CORRECTION_CACHE_DIR || \"\";\nif (CACHE) mkdirSync(CACHE, { recursive: true });\nconst cacheGet = (k) => (CACHE && existsSync(join(CACHE, k)) ? JSON.parse(readFileSync(join(CACHE, k), \"utf8\")) : null);\nconst cachePut = (k, v) => { if (CACHE) writeFileSync(join(CACHE, k), JSON.stringify(v)); return v; };\nconst sleep = (ms) => new Promise((r) => setTimeout(r, ms));\n\n// THE QUERY LOG. Every figure has to be traceable to the call that produced it and the row count\n// that came back, so every fetch appends here and the whole log prints at the end.\nconst QUERIES = [];\nconst logQuery = (what, url, rows) => { QUERIES.push({ what, url, rows }); return rows; };\n\nasync function jsonFetch(url, opts = {}, tries = 6) {\n let last = null;\n for (let t = 0; t < tries; t++) {\n try {\n const res = await fetch(url, { ...opts, headers: { \"User-Agent\": UA, Accept: \"application/json\", ...(opts.headers ?? {}) } });\n const text = await res.text();\n if (!res.ok) { last = `HTTP ${res.status}: ${text.slice(0, 200)}`; await sleep(1200 * (t + 1)); continue; }\n return JSON.parse(text);\n } catch (e) { last = e.message; await sleep(1200 * (t + 1)); }\n }\n die(`fetch failed after ${tries} tries: ${url.replace(/admin=[^&]+/, \"admin=\")}\\n last error: ${last}`);\n}\nconst ghlHeaders = { Authorization: `Bearer ${TOKEN}`, Version: \"2021-07-28\" };\n\n// -------------------------------------------------------------------------------------------\n// FETCHES. An empty page is retried, never believed, and the stop condition is the STATED TOTAL\n// as it stood at the FIRST page (LESSONS #15: a walk once stopped at 900 of 5,708 and reported\n// 900 as the whole CRM). Zero rows anywhere is a hard failure, never an empty success.\n// -------------------------------------------------------------------------------------------\nasync function fetchAllContacts() {\n const hit = cacheGet(\"contacts.json\"); if (hit) return logQuery(\"contacts\", \"POST /contacts/search {locationId, pageLimit:100, searchAfter}\", hit.length), hit;\n const all = []; const seen = new Set(); let searchAfter = null; let stated = null; let target = null; let empties = 0;\n while (true) {\n const body = { locationId: LOCATION, pageLimit: 100, ...(searchAfter ? { searchAfter } : {}) };\n const d = await jsonFetch(`${GHL}/contacts/search`, { method: \"POST\", headers: { ...ghlHeaders, \"Content-Type\": \"application/json\" }, body: JSON.stringify(body) });\n const page = d?.contacts ?? [];\n stated = d?.total ?? stated;\n if (target === null && stated != null) target = stated;\n if (page.length === 0) { if (++empties >= 3) break; await sleep(2500); continue; }\n empties = 0;\n for (const c of page) if (!seen.has(c.id)) { seen.add(c.id); all.push(c); }\n searchAfter = page[page.length - 1]?.searchAfter;\n if (target != null && all.length >= target) break;\n if (!searchAfter) break;\n }\n if (all.length === 0) die(\"contacts came back with ZERO rows. That is a broken read, not an empty CRM.\");\n if (target != null && all.length < target) die(`contact pagination is short: collected ${all.length}, the CRM held ${target} when this read began.`);\n if (stated != null && stated > all.length) console.log(` note: contacts grew from ${target} to ${stated} during the read; the ${all.length} read is the snapshot these files describe.`);\n logQuery(\"contacts\", \"POST /contacts/search {locationId, pageLimit:100, searchAfter}\", all.length);\n return cachePut(\"contacts.json\", all);\n}\n\nasync function fetchAllOpportunities() {\n const hit = cacheGet(\"opportunities.json\"); if (hit) return logQuery(\"opportunities\", `GET /opportunities/search?location_id=${LOCATION}&limit=100 (+nextPageUrl)`, hit.length), hit;\n const all = []; const seen = new Set(); let empties = 0; let stated = null; let target = null;\n let url = `${GHL}/opportunities/search?location_id=${LOCATION}&limit=100`;\n while (url) {\n const d = await jsonFetch(url, { headers: ghlHeaders });\n const page = d?.opportunities ?? []; const meta = d?.meta ?? {};\n stated = meta.total ?? stated;\n if (target === null && stated != null) target = stated;\n if (page.length === 0) { if (++empties >= 3) break; await sleep(2500); continue; }\n empties = 0;\n for (const o of page) if (!seen.has(o.id)) { seen.add(o.id); all.push(o); }\n if (target != null && all.length >= target) break;\n url = meta.nextPageUrl;\n }\n if (all.length === 0) die(\"opportunities came back with ZERO rows.\");\n if (target != null && all.length < target) die(`opportunity pagination is short: collected ${all.length}, the CRM held ${target} when this read began.`);\n if (stated != null && stated > all.length) console.log(` note: opportunities grew from ${target} to ${stated} during the read; the ${all.length} read is the snapshot these files describe.`);\n logQuery(\"opportunities\", `GET /opportunities/search?location_id=${LOCATION}&limit=100 (+nextPageUrl)`, all.length);\n return cachePut(\"opportunities.json\", all);\n}\n\n// INVOICES. `offset` is mandatory on this route or it 422s, and a page that comes back exactly\n// full is never the last page however tempting. Moved here from scripts/client-files-rebuild.mjs\n// so that one run produces the whole client pack: two generators writing files about the same\n// business on the same day is how a client ends up holding two documents that disagree.\nasync function fetchAllInvoices() {\n const hit = cacheGet(\"invoices.json\"); if (hit) return logQuery(\"invoices\", `GET /invoices/?altId=${LOCATION}&altType=location&limit=100&offset=<0..>`, hit.length), hit;\n const LIMIT = 100; const all = []; let stated = null;\n for (let offset = 0; offset < 5000; offset += LIMIT) {\n const d = await jsonFetch(`${GHL}/invoices/?altId=${LOCATION}&altType=location&limit=${LIMIT}&offset=${offset}`, { headers: ghlHeaders });\n const page = d?.invoices ?? [];\n stated = d?.total ?? stated;\n all.push(...page);\n if (page.length < LIMIT) break;\n }\n if (all.length === 0) die(\"invoices came back with ZERO rows. That is a broken read, not an empty business.\");\n if (stated != null && all.length !== stated) die(`invoice pagination is short: collected ${all.length}, the API says total ${stated}.`);\n logQuery(\"invoices\", `GET /invoices/?altId=${LOCATION}&altType=location&limit=100&offset=<0..>`, all.length);\n return cachePut(\"invoices.json\", all);\n}\n\n// THE CRM'S OWN PAYMENT RECORDS. Used only to answer \"has this invoice been settled another way\",\n// never as the Square population. This route rejects locationId and wants altId/altType.\nasync function fetchAllTransactions() {\n const hit = cacheGet(\"transactions.json\"); if (hit) return logQuery(\"payment transactions\", `GET /payments/transactions?altId=${LOCATION}&altType=location&limit=100&offset=<0..>`, hit.length), hit;\n const LIMIT = 100; const all = []; let stated = null;\n for (let offset = 0; offset < 20000; offset += LIMIT) {\n const d = await jsonFetch(`${GHL}/payments/transactions?altId=${LOCATION}&altType=location&limit=${LIMIT}&offset=${offset}`, { headers: ghlHeaders });\n const page = d?.data ?? d?.transactions ?? [];\n stated = d?.totalCount ?? d?.total ?? stated;\n all.push(...page);\n if (page.length < LIMIT) break;\n }\n if (all.length === 0) die(\"payment transactions came back with ZERO rows. That is a broken read, not an empty business.\");\n logQuery(\"payment transactions\", `GET /payments/transactions?altId=${LOCATION}&altType=location&limit=100&offset=<0..>`, all.length);\n return cachePut(\"transactions.json\", all);\n}\n\n// THE PRICE LIST, BOTH SIDES OF IT. Her CRM's products and prices, and Square's own catalogue, so\n// the claim \"set up at the exact Square price\" is checked against Square rather than asserted.\nasync function fetchCrmProducts() {\n const hit = cacheGet(\"products.json\"); if (hit) return logQuery(\"products\", `GET /products/?locationId=${LOCATION}&limit=100`, hit.length), hit;\n const d = await jsonFetch(`${GHL}/products/?locationId=${LOCATION}&limit=100`, { headers: ghlHeaders });\n const all = d?.products ?? [];\n if (all.length === 0) die(\"products came back with ZERO rows.\");\n logQuery(\"products\", `GET /products/?locationId=${LOCATION}&limit=100`, all.length);\n return cachePut(\"products.json\", all);\n}\nasync function fetchCrmPrices(productIds) {\n const hit = cacheGet(\"prices.json\"); if (hit) return logQuery(\"product prices\", `GET /products//price?locationId=${LOCATION}`, Object.keys(hit).length), hit;\n const out = {};\n for (const id of productIds) {\n const d = await jsonFetch(`${GHL}/products/${id}/price?locationId=${LOCATION}&limit=100`, { headers: ghlHeaders });\n out[id] = (d?.prices ?? []).map((p) => ({ id: p._id, name: p.name, amount: Number(p.amount) || 0, currency: p.currency }));\n }\n logQuery(\"product prices\", `GET /products//price?locationId=${LOCATION}`, Object.keys(out).length);\n return cachePut(\"prices.json\", out);\n}\nasync function fetchSquareCatalog() {\n const hit = cacheGet(\"catalog.json\"); if (hit) return logQuery(\"square catalogue\", \"GET ?catalog=1&admin=\", (hit.items ?? []).length), hit;\n const d = await jsonFetch(`${BRIDGE}?catalog=1&admin=${encodeURIComponent(ADMIN)}`);\n if (!Array.isArray(d?.items) || d.items.length === 0) die(\"the Square catalogue came back empty.\");\n logQuery(\"square catalogue\", \"GET ?catalog=1&admin=\", d.items.length);\n return cachePut(\"catalog.json\", d);\n}\n\n// HER BOARD NAMES, READ FROM HER CRM. Never typed into this file. See STAGE_NAME above.\nasync function fetchPipelines() {\n const hit = cacheGet(\"pipelines.json\"); if (hit) return logQuery(\"pipelines\", `GET /opportunities/pipelines?locationId=${LOCATION}`, hit.length), hit;\n const d = await jsonFetch(`${GHL}/opportunities/pipelines?locationId=${LOCATION}`, { headers: ghlHeaders });\n const all = d?.pipelines ?? [];\n if (all.length === 0) die(\"pipelines came back with ZERO rows, so this run cannot know what the client calls her own boards.\");\n logQuery(\"pipelines\", `GET /opportunities/pipelines?locationId=${LOCATION}`, all.length);\n return cachePut(\"pipelines.json\", all);\n}\n\nasync function fetchJournal() {\n const hit = cacheGet(\"journal.json\"); if (hit) return logQuery(\"bridge journal\", \"GET ?dump=1&admin=\", hit.length), hit;\n const j = await jsonFetch(`${BRIDGE}?dump=1&admin=${encodeURIComponent(ADMIN)}`);\n if (!Array.isArray(j)) die(`journal did not come back as an array (got ${typeof j}).`);\n if (j.length === 0) die(\"journal came back with ZERO rows. That is a failure, not an empty week.\");\n logQuery(\"bridge journal\", \"GET ?dump=1&admin=\", j.length);\n return cachePut(\"journal.json\", j);\n}\n\nasync function fetchSquare(ids) {\n const hit = cacheGet(\"square.json\"); if (hit) return logQuery(\"square lookup\", \"GET ?lookup=&admin=\", hit.length), hit;\n const out = []; const CHUNK = 45; // the bridge caps at 90; 45 keeps the URL comfortably short\n for (let i = 0; i < ids.length; i += CHUNK) {\n const d = await jsonFetch(`${BRIDGE}?lookup=${ids.slice(i, i + CHUNK).map(encodeURIComponent).join(\",\")}&admin=${encodeURIComponent(ADMIN)}`);\n out.push(...(d?.results ?? []));\n }\n if (out.length !== ids.length) die(`Square lookup returned ${out.length} of ${ids.length} requested payments. Every figure below depends on Square's own record, so a partial answer is not usable.`);\n logQuery(\"square lookup\", \"GET ?lookup=&admin=\", out.length);\n return cachePut(\"square.json\", out);\n}\n\n// -------------------------------------------------------------------------------------------\n// THE INDEPENDENT SECOND READING. Shares no code with paymentUniverse().\n//\n// paymentUniverse() groups a payment's rows by id and applies a guard per group. This does the\n// opposite: it builds two SETS and subtracts one from the other, and it finds ids by SHAPE and by\n// the grammatical slot they sit in rather than by a greedy \\S+ capture. If the two ever disagree\n// the run stops, because a number that only one method can produce is exactly what put three\n// wrong figures in the client's inbox.\n// -------------------------------------------------------------------------------------------\nconst SQUARE_PAYMENT_ID = /^[A-Za-z0-9]{29}$/; // refund ids are 73 chars with an underscore,\nconst SELF_TEST = /^(TESTPAY|captest|TESTREF)[-_]/i; // opportunity ids 20, invoice ids 28\nfunction independentIdsOnRow(r) {\n const found = new Set();\n for (const m of String(r?.note ?? \"\").matchAll(/\\bpayment\\s+([A-Za-z0-9]+)/g)) found.add(m[1]);\n if (typeof r?.id === \"string\" && r.id) found.add(r.id);\n const out = new Set();\n for (const t of found) if (SQUARE_PAYMENT_ID.test(t) && !SELF_TEST.test(t)) out.add(t);\n return out;\n}\nfunction independentUnmatched(journal) {\n const all = new Set(), onAContactRow = new Set();\n for (const r of journal) {\n const ids = independentIdsOnRow(r);\n for (const id of ids) all.add(id);\n if (typeof r?.contactId === \"string\" && r.contactId.trim().length > 4) for (const id of ids) onAContactRow.add(id);\n }\n return { all, linked: onAContactRow, unmatched: new Set([...all].filter((id) => !onAContactRow.has(id))) };\n}\n\n// -------------------------------------------------------------------------------------------\n// NORMALISERS. One definition each, so \"same phone\" cannot mean two different things.\n// -------------------------------------------------------------------------------------------\nconst normPhone = (p) => { const d = String(p ?? \"\").replace(/\\D/g, \"\"); const t = d.length === 11 && d.startsWith(\"1\") ? d.slice(1) : d; return t.length === 10 ? t : null; };\nconst normEmail = (e) => { const s = String(e ?? \"\").trim().toLowerCase(); return s || null; };\nconst normName = (n) => String(n ?? \"\").toLowerCase().replace(/[^a-z ]/g, \"\").replace(/\\s+/g, \" \").trim() || null;\nconst money = (n) => `$${Number(n).toLocaleString(\"en-US\", { minimumFractionDigits: 2, maximumFractionDigits: 2 })}`;\nconst plural = (n, one, many) => (n === 1 ? one : many);\nconst csvField = (v) => { const s = v === null || v === undefined ? \"\" : String(v); return /[\",\\n]/.test(s) ? `\"${s.replace(/\"/g, '\"\"')}\"` : s; };\n// THE HEADER ROW GOES THROUGH THE SAME ESCAPING AS EVERY OTHER ROW. It did not, and the moment a\n// column was given a name a person could read (\"Square receipt link, open this to see the sale\")\n// the comma inside it split the header into two columns and every spreadsheet mis-shaped the file.\nconst toCsv = (headers, records) => [headers.map(csvField).join(\",\"), ...records.map((r) => headers.map((h) => csvField(r[h])).join(\",\"))].join(\"\\n\") + \"\\n\";\nconst fmtDate = (iso) => {\n const d = new Date(iso); if (Number.isNaN(d.getTime())) return \"date unknown\";\n const M = [\"January\", \"February\", \"March\", \"April\", \"May\", \"June\", \"July\", \"August\", \"September\", \"October\", \"November\", \"December\"];\n return `${d.getUTCDate()} ${M[d.getUTCMonth()]} ${d.getUTCFullYear()}`;\n};\n// Dates inside a spreadsheet column stay in year, month, day order so a sort on the column works\n// and no reader has to guess whether 07/08 is July or August. Dates in prose are spelled out.\nconst isoDay = (iso) => String(iso ?? \"\").slice(0, 10);\n// Names as a person writes them. The CRM stores \"kylie smalley\" and Square stores \"AMERICAN_EXPRESS\";\n// neither is how the owner would write it down, and a client file is not the place to show either.\nconst titleCase = (s) => String(s ?? \"\").trim().replace(/\\b([a-z])/g, (m0) => m0.toUpperCase());\n// A person's name as her CRM spells it. The lowercased contactName field loses the capital in\n// \"McIntosh\"; the first and last name fields keep it, so those are preferred and contactName is\n// only a fallback. Never invent a capital the CRM does not hold.\nconst personName = (c) => {\n const parts = [c?.firstName, c?.lastName].map((x) => String(x ?? \"\").trim()).filter(Boolean);\n return parts.length ? parts.join(\" \") : titleCase(c?.contactName ?? \"\");\n};\nconst CARD_NAME = (brand) => {\n const b = String(brand ?? \"\").trim().toUpperCase();\n if (!b) return \"Card type not recorded\";\n const known = { VISA: \"Visa\", MASTERCARD: \"Mastercard\", AMERICAN_EXPRESS: \"American Express\", DISCOVER: \"Discover\", DISCOVER_DINERS: \"Discover Diners\", JCB: \"JCB\", CHINA_UNIONPAY: \"China UnionPay\", SQUARE_GIFT_CARD: \"Square gift card\" };\n return known[b] ?? titleCase(b.replace(/_/g, \" \").toLowerCase());\n};\n\n// THE FILE NAMES LIVE HERE ONCE. Every cross reference in every page below is interpolated from\n// these, so a rename can never leave one page pointing at a file that no longer exists. The old\n// names (writeback-dry-run.csv, counter-sales-not-linked.csv, counter-sales-CORRECTION.md) were\n// ours, not hers: she cannot search for a word she has never used.\nconst F_COUNTER_CSV = \"Counter-sales-with-no-customer.csv\";\nconst F_COUNTER_MD = \"Counter-sales-with-no-customer.md\";\nconst F_WRITE_CSV = \"Money-to-put-on-bookings.csv\";\nconst F_WRITE_MD = \"Money-to-put-on-bookings.md\";\nconst F_LEFT_CSV = \"Payments-left-alone-and-why.csv\";\nconst F_INVOICES_CSV = \"Unpaid-invoices.csv\";\nconst F_INVOICES_MD = \"Unpaid-invoices.md\";\nconst F_PRICES_CSV = \"Payment-links-and-prices.csv\";\n\n// ===========================================================================================\n// MAIN\n// ===========================================================================================\nconst RUN_AT = new Date();\n// \"Today\" is true for one day and quietly wrong every day after, and these files are kept. Every\n// sentence that wants to say \"right now\" names the date instead.\nconst AS_AT = fmtDate(RUN_AT.toISOString());\nconsole.log(`Reading live. Location ${LOCATION}. As of ${RUN_AT.toISOString()}.\\n`);\n\nconst [contacts, opportunities, journal, pipelines, invoices, transactions, crmProducts, squareCatalog] = await Promise.all([\n fetchAllContacts(), fetchAllOpportunities(), fetchJournal(), fetchPipelines(), fetchAllInvoices(), fetchAllTransactions(),\n fetchCrmProducts(), fetchSquareCatalog(),\n]);\nconst universe = paymentUniverse(journal);\nconst square = await fetchSquare([...universe.payments.keys()].sort());\nconst sqById = new Map(square.map((s) => [s.id, s]));\n\n// HER NAMES, FILLED IN FROM HER OWN CRM. A stage this run cannot name is a stage this run has no\n// business writing about, so a missing name stops the run rather than falling back to a guess.\nfor (const p of pipelines) for (const s of p?.stages ?? []) if (IN_SCOPE.has(s?.id)) STAGE_NAME[s.id] = String(s?.name ?? \"\").trim();\nfor (const s of VALUABLE_STAGES) if (!STAGE_NAME[s]) die(`stage ${s} is in the write scope and no pipeline in this CRM names it. Nothing written.`);\nconst BOARDS = VALUABLE_STAGES.map((s) => STAGE_NAME[s]);\nconst BOARDS_PHRASE = `${BOARDS.slice(0, -1).join(\", \")} or ${BOARDS[BOARDS.length - 1]}`;\nconsole.log(`Her board names, read from her own pipelines: ${BOARDS.map((b) => `\"${b}\"`).join(\" and \")}.`);\n\n// -------------------------------------------------------------------------------------------\n// GATE 1. The two independent readings must agree, exactly, before anything is computed from\n// either. This is the check that would have caught all three previous wrong numbers.\n// -------------------------------------------------------------------------------------------\nconst indep = independentUnmatched(journal);\n{\n const p = [];\n const a = [...indep.unmatched].sort(), b = [...universe.unlinked].sort();\n if (a.length !== b.length || a.some((x, i) => x !== b[i])) {\n p.push(`unmatched sets differ. set subtraction: ${a.length} (${a.join(\", \")}). paymentUniverse(): ${b.length} (${b.join(\", \")})`);\n }\n const u = [...indep.all].sort(), v = [...universe.payments.keys()].sort();\n if (u.length !== v.length || u.some((x, i) => x !== v[i])) {\n p.push(`populations differ. set subtraction sees ${u.length} payment ids, paymentUniverse() sees ${v.length}. only in one: ${[...u.filter((x) => !v.includes(x)), ...v.filter((x) => !u.includes(x))].join(\", \")}`);\n }\n if (p.length) { shout(\"THE TWO INDEPENDENT READINGS DISAGREE. This is the most important thing in this run. Nothing written.\"); p.forEach((x) => console.error(\" - \" + x)); process.exit(1); }\n console.log(`Independent check PASSED: set subtraction and paymentUniverse() name the same ${universe.payments.size} payments and the same ${universe.unlinked.length} unlinked, id for id.`);\n}\n\n// -------------------------------------------------------------------------------------------\n// THE AMOUNT. Square is the authority on what a card was charged; the journal is a log of\n// attempts and does not always carry an amount at all (PAY-DUP rows have no amount field). Where\n// both speak they must agree, or the total depends on which system you asked, and that is fatal.\n// -------------------------------------------------------------------------------------------\nconst amountOf = (id) => { const s = Number(sqById.get(id)?.amount); return Number.isFinite(s) ? s : journalAmount(universe.payments.get(id)); };\nconst amountSilentInJournal = [];\n{\n const p = [];\n for (const [id, rows] of universe.payments) {\n const j = journalAmount(rows), s = Number(sqById.get(id)?.amount ?? NaN);\n if (!Number.isFinite(s)) { p.push(`payment ${id}: Square returned no amount`); continue; }\n if (j === 0) { amountSilentInJournal.push({ id, square: s }); continue; } // journal never logged one\n if (cents(j) !== cents(s)) p.push(`payment ${id}: the journal says ${money(j)} and Square says ${money(s)}`);\n }\n if (p.length) { shout(\"THE JOURNAL AND SQUARE DISAGREE ON AN AMOUNT. Nothing written.\"); p.forEach((x) => console.error(\" - \" + x)); process.exit(1); }\n}\n\n// -------------------------------------------------------------------------------------------\n// REFUNDS. A refund id lives in its own namespace and is shaped \"_\", so the\n// payment a refund belongs to is recoverable. A payment with a refund against it must never have\n// its full amount proposed onto a booking.\n// -------------------------------------------------------------------------------------------\nconst refundedPayments = new Map();\nfor (const r of journal) {\n if (!/^REFUND/.test(String(r?.kind ?? \"\"))) continue;\n const tok = (String(r?.note ?? \"\").match(/refund\\s+(\\S+)/) ?? [])[1] ?? r?.id ?? \"\";\n const paymentId = String(tok).split(\"_\")[0];\n if (!universe.payments.has(paymentId)) continue;\n const g = refundedPayments.get(paymentId) ?? { paymentId, kinds: new Set(), amount: 0 };\n g.kinds.add(r.kind); g.amount = Math.max(g.amount, Number(r.amount) || 0);\n refundedPayments.set(paymentId, g);\n}\n\n// -------------------------------------------------------------------------------------------\n// THE PARENT TOTAL, and the split that must add back to it.\n// -------------------------------------------------------------------------------------------\nconst allIds = [...universe.payments.keys()];\nconst linkedIds = [...universe.linked].sort((a, b) => String(sqById.get(a)?.created_at ?? \"\").localeCompare(String(sqById.get(b)?.created_at ?? \"\")));\nconst unlinkedIds = [...universe.unlinked].sort((a, b) => String(sqById.get(a)?.created_at ?? \"\").localeCompare(String(sqById.get(b)?.created_at ?? \"\")));\nconst universeTotal = allIds.reduce((a, id) => a + amountOf(id), 0);\nconst linkedTotal = linkedIds.reduce((a, id) => a + amountOf(id), 0);\nconst unlinkedTotal = unlinkedIds.reduce((a, id) => a + amountOf(id), 0);\n{\n const p = [];\n if (linkedIds.length + unlinkedIds.length !== allIds.length) p.push(`linked ${linkedIds.length} + unlinked ${unlinkedIds.length} does not equal ${allIds.length} seen`);\n if (cents(linkedTotal + unlinkedTotal) !== cents(universeTotal)) p.push(`linked ${money(linkedTotal)} + unlinked ${money(unlinkedTotal)} does not equal ${money(universeTotal)}`);\n if (p.length) { shout(\"POPULATION RECONCILIATION FAILED. Nothing written.\"); p.forEach((x) => console.error(\" - \" + x)); process.exit(1); }\n}\n\n// -------------------------------------------------------------------------------------------\n// THE HISTORY OF THE NUMBER, re-derived rather than remembered, so the correction page can show\n// its own arithmetic. Three figures have been in writing; each one is reproduced here from the\n// live journal by running the rule as it stood at the time.\n// -------------------------------------------------------------------------------------------\nconst MATCHED_KINDS = new Set([\"REVENUE-ON-CLIENT-OPP\", \"PAYMENT\", \"CAPI-PURCHASE\", \"INVOICE-LINKED\"]);\nconst history = (() => {\n const byGreedyNoteKey = new Map();\n for (const r of journal) { const m = /payment\\s+(\\S+)/.exec(String(r?.note ?? \"\")); if (m) (byGreedyNoteKey.get(m[1]) ?? byGreedyNoteKey.set(m[1], []).get(m[1])).push(r); }\n const amt = (rs) => rs.map((r) => Number(r?.amount) || 0).find((a) => a > 0) ?? 0;\n const isMatched = (rs) => rs.some((r) => MATCHED_KINDS.has(r?.kind) || (typeof r?.contactId === \"string\" && r.contactId.length > 4));\n const failed = [...byGreedyNoteKey].filter(([, rs]) => rs.some((r) => r?.kind === \"NO-MATCH\"));\n const everFailed = failed.map(([id, rs]) => ({ id, amount: amt(rs) }));\n const thirdFigure = failed.filter(([, rs]) => !isMatched(rs)).map(([id, rs]) => ({ id, amount: amt(rs), trail: rs.some((r) => r?.hadEmail === true || r?.hadPhone === true || r?.hadCustomerId === true) }));\n const matchedLater = everFailed.filter((x) => !thirdFigure.some((y) => y.id === x.id));\n const semicolonBug = thirdFigure.filter((x) => !universe.unlinked.includes(x.id));\n const sum = (xs) => xs.reduce((a, x) => a + x.amount, 0);\n return {\n everFailed, everFailedTotal: sum(everFailed),\n matchedLater, matchedLaterTotal: sum(matchedLater),\n thirdFigure, thirdFigureTotal: sum(thirdFigure),\n thirdWithTrail: thirdFigure.filter((x) => x.trail), thirdWithTrailTotal: sum(thirdFigure.filter((x) => x.trail)),\n thirdNoTrail: thirdFigure.filter((x) => !x.trail), thirdNoTrailTotal: sum(thirdFigure.filter((x) => !x.trail)),\n semicolonBug, semicolonBugTotal: sum(semicolonBug),\n };\n})();\n{\n const p = [];\n if (history.matchedLater.length + history.thirdFigure.length !== history.everFailed.length) p.push(\"matched later plus still unmatched does not equal every payment that ever failed\");\n if (cents(history.matchedLaterTotal + history.thirdFigureTotal) !== cents(history.everFailedTotal)) p.push(\"the history dollars do not add back\");\n if (history.semicolonBug.length + unlinkedIds.length !== history.thirdFigure.length) p.push(\"the semicolon group plus the true unlinked does not equal the figure the client holds\");\n if (cents(history.semicolonBugTotal + unlinkedTotal) !== cents(history.thirdFigureTotal)) p.push(\"the semicolon dollars plus the true unlinked dollars do not equal the figure the client holds\");\n if (p.length) { shout(\"THE HISTORY OF THE NUMBER DOES NOT RECONCILE. Nothing written.\"); p.forEach((x) => console.error(\" - \" + x)); process.exit(1); }\n}\n\n// -------------------------------------------------------------------------------------------\n// CRM CANDIDATE MATCHING, for the four. Two tiers, and the tier is always stated.\n// PROOF an exact phone, email or full name hit, and exactly one contact answers to it.\n// PROBABLE the surname matches exactly and the first initial matches, on a different number.\n// Offered as a question, never as an answer. A merge is a decision about a person's\n// records and it belongs to the owner, not to this script.\n// Two candidates is not a better guess than one, it is a question, and this says so.\n// -------------------------------------------------------------------------------------------\nconst byPhone = new Map(), byEmail = new Map(), byName = new Map(), bySurname = new Map();\nconst push = (m, k, v) => { if (k) (m.get(k) ?? m.set(k, []).get(k)).push(v); };\nfor (const c of contacts) {\n push(byPhone, normPhone(c.phone), c);\n push(byEmail, normEmail(c.email), c);\n push(byName, normName(c.contactName || [c.firstName, c.lastName].filter(Boolean).join(\" \")), c);\n push(bySurname, normName(c.lastName), c);\n for (const ap of c.additionalPhones ?? []) push(byPhone, normPhone(typeof ap === \"string\" ? ap : ap?.phone), c);\n for (const ae of c.additionalEmails ?? []) push(byEmail, normEmail(typeof ae === \"string\" ? ae : ae?.email), c);\n}\nconst contactById = new Map(contacts.map((c) => [c.id, c]));\n\nfunction findCandidate(sq) {\n const c = sq?.square_customer ?? {};\n const given = String(c.given_name ?? \"\").trim(), family = String(c.family_name ?? \"\").trim();\n const full = [given, family].filter(Boolean).join(\" \") || String(sq?.cardholder_name ?? \"\").trim();\n const ph = normPhone(c.phone_number), em = normEmail(c.email_address), nm = normName(full);\n const hits = new Map(); const ev = [];\n const add = (list, label) => { if (list?.length) { ev.push(label); for (const x of list) hits.set(x.id, x); } };\n add(ph && byPhone.get(ph), `exact phone match on ${c.phone_number}`);\n add(em && byEmail.get(em), `exact email match on ${c.email_address}`);\n add(nm && byName.get(nm), `exact name match on \"${full}\"`);\n const proof = [...hits.values()];\n if (proof.length === 1) return { tier: \"proof\", contact: proof[0], evidence: ev.join(\"; \"), candidates: proof };\n if (proof.length > 1) return { tier: \"several\", contact: null, evidence: `${proof.length} contacts answer to this buyer (${ev.join(\"; \")}), so a person picks`, candidates: proof };\n // PROBABLE tier\n const sur = normName(family);\n const near = sur ? (bySurname.get(sur) ?? []).filter((x) => normName(x.firstName)?.[0] === normName(given)?.[0]) : [];\n if (near.length === 1) {\n const x = near[0];\n const bits = [`surname \"${family}\" matches exactly`, `first name is \"${x.firstName}\" in the CRM and \"${given}\" in Square`];\n if (ph && normPhone(x.phone) && ph !== normPhone(x.phone)) bits.push(`the phone numbers are different, ${c.phone_number} in Square and ${x.phone} in the CRM`);\n return { tier: \"probable\", contact: x, evidence: bits.join(\"; \"), candidates: near };\n }\n if (near.length > 1) return { tier: \"several\", contact: null, evidence: `${near.length} contacts share this surname and first initial, so a person picks`, candidates: near };\n return { tier: \"none\", contact: null, evidence: \"Square holds no name, no email and no phone for this sale, so there is nothing to match a customer on\", candidates: [] };\n}\n\n// -------------------------------------------------------------------------------------------\n// SPLIT TENDER. One sale settled on two cards is two payments against ONE Square order, and each\n// payment's line items describe the WHOLE order, not that card's share. Printing a line item\n// total of $1,795.00 beside a card that was charged $795.00 is exactly the kind of number beside\n// a sentence that this project keeps being burned by, so the relationship is stated instead.\n// -------------------------------------------------------------------------------------------\nconst paymentsByOrder = new Map();\nfor (const id of allIds) {\n const oid = sqById.get(id)?.order_id;\n if (oid) (paymentsByOrder.get(oid) ?? paymentsByOrder.set(oid, []).get(oid)).push(id);\n}\nconst orderTotal = (s) => (s?.line_items ?? []).reduce((a, li) => a + (Number(li?.total) || 0), 0);\n\n// -------------------------------------------------------------------------------------------\n// FILE 3, COMPUTED FIRST because file 1 needs to be able to say which booking a confirmed match\n// would land on, and whether that booking is already due to receive money in this same plan.\n//\n// Scope: the payments that DID reach a named customer. Those are the real remaining work, and\n// they are a different population from file 1's four, which is why the two files never share a\n// row and their counts add back to the parent total rather than overlapping.\n//\n// Kim's rule, agreed in writing 9 Aug: one open booking, assign it; more than one, a person\n// chooses. Scoped to the two stage IDS, summed per booking, never overwriting a non zero value.\n// -------------------------------------------------------------------------------------------\nconst oppsByContact = new Map();\nfor (const o of opportunities) {\n if (!IN_SCOPE.has(o.pipelineStageId) || !o.contactId) continue;\n (oppsByContact.get(o.contactId) ?? oppsByContact.set(o.contactId, []).get(o.contactId)).push(o);\n}\n\nconst leftAlone = [];\nconst plan = new Map();\nfor (const id of linkedIds) {\n const rows = universe.payments.get(id) ?? [];\n const s = sqById.get(id) ?? {};\n const sc = s.square_customer ?? {};\n const buyer = [sc.given_name, sc.family_name].map((x) => String(x ?? \"\").trim()).filter(Boolean).join(\" \") || String(s.cardholder_name ?? \"\").trim() || \"(Square holds no name)\";\n // EVERY REASON BELOW IS WRITTEN FOR THE OWNER, not for us. No record ids, no log vocabulary:\n // she has to be able to act on the sentence without asking anybody what a word in it means.\n const item = { id, amount: amountOf(id), date: String(s.created_at ?? \"\").slice(0, 10), buyer, receipt: s.receipt_url ?? \"\" };\n const reject = (why) => leftAlone.push({ ...item, why });\n\n const contactIds = [...new Set(rows.filter((r) => typeof r?.contactId === \"string\" && r.contactId.length > 4).map((r) => r.contactId))];\n if (contactIds.length !== 1) { reject(contactIds.length === 0 ? \"the Square connection never recorded a customer for this payment\" : `the Square connection recorded ${contactIds.length} different customers against this one payment, so a person picks`); continue; }\n const contact = contactById.get(contactIds[0]);\n if (!contact) { reject(\"the customer record this payment was filed against is no longer in your CRM\"); continue; }\n if (refundedPayments.has(id)) { reject(\"this payment was refunded, so its full amount must not be added to a booking\"); continue; }\n\n const inScope = oppsByContact.get(contact.id) ?? [];\n if (!inScope.length) { reject(`the customer is named and has no booking on the ${BOARDS_PHRASE} board to put the money on`); continue; }\n const open = inScope.filter((o) => Number(o.monetaryValue || 0) === 0);\n const valued = inScope.filter((o) => Number(o.monetaryValue || 0) > 0);\n if (!open.length) { reject(`every booking for this customer already carries a figure (${valued.map((o) => money(o.monetaryValue)).join(\", \")}), and nothing here overwrites a figure another system may own`); continue; }\n if (open.length !== 1) { reject(`${open.length} bookings for this customer show no dollars, so a person picks which one`); continue; }\n\n const o = open[0];\n const g = plan.get(o.id) ?? { opp: o, contact, items: [] };\n g.items.push(item); plan.set(o.id, g);\n}\n\n// -------------------------------------------------------------------------------------------\n// FILE 1. THE FOUR. Every buyer detail comes from Square's own record, not from the journal's\n// flags, and where the two disagree the disagreement is a column of its own.\n// -------------------------------------------------------------------------------------------\nconst flagDisagreements = [];\nconst fourRows = unlinkedIds.map((id) => {\n const s = sqById.get(id) ?? {};\n const c = s.square_customer ?? {};\n const rows = universe.payments.get(id) ?? [];\n const name = [c.given_name, c.family_name].map((x) => String(x ?? \"\").trim()).filter(Boolean).join(\" \").replace(/\\s+/g, \" \") || String(s.cardholder_name ?? \"\").trim();\n const m = findCandidate(s);\n\n // THE FLAGS versus SQUARE. hadEmail/hadPhone/hadCustomerId describe the webhook payload the\n // bridge received. Square is the record of what Square holds. Where they differ, say so.\n const flagSaysTrail = rows.some((r) => r?.hadEmail === true || r?.hadPhone === true || r?.hadCustomerId === true);\n const squareHasSomething = Boolean(name || c.email_address || c.phone_number);\n let flagVerdict = \"the journal flag and Square agree\";\n if (flagSaysTrail && !squareHasSomething) { flagVerdict = \"the journal flag said there was something to go on and Square holds no name, no email and no phone\"; flagDisagreements.push({ id, direction: \"flag too generous\" }); }\n if (!flagSaysTrail && squareHasSomething) { flagVerdict = \"the journal flag said there was nothing to go on and Square holds a name and a phone number\"; flagDisagreements.push({ id, direction: \"flag too harsh\" }); }\n\n // WHERE IT WOULD GO IF THE MATCH IS CONFIRMED. Same rule and same two stages as file 3, so the\n // two files cannot recommend different things about one customer.\n let landsOn = \"\", landsOnId = \"\", landsOnCurrent = \"\", landsOnAlreadyDue = \"\";\n if (m.contact) {\n const inScope = oppsByContact.get(m.contact.id) ?? [];\n const open = inScope.filter((o) => Number(o.monetaryValue || 0) === 0);\n if (open.length === 1) {\n const o = open[0];\n landsOnId = o.id;\n landsOnCurrent = Number(o.monetaryValue || 0).toFixed(2);\n const due = plan.get(o.id);\n landsOnAlreadyDue = due ? due.items.reduce((a, x) => a + x.amount, 0).toFixed(2) : \"0.00\";\n landsOn = `${o.name ?? \"(booking not named)\"} on the ${STAGE_NAME[o.pipelineStageId]} board, which shows ${money(o.monetaryValue || 0)} as at ${AS_AT}` + (due ? ` and is already due to receive ${money(Number(landsOnAlreadyDue))} in ${F_WRITE_CSV}` : \"\");\n } else if (inScope.length === 0) {\n landsOn = `this customer has no booking on the ${BOARDS_PHRASE} board, so there is nowhere to put it yet`;\n } else {\n landsOn = `${open.length} bookings for this customer show no dollars, so a person picks which one`;\n }\n }\n\n // SPLIT TENDER. Another payment against the same Square order means one sale on two cards. The\n // other card is named by ITS AMOUNT, not by its reference number: she can see two amounts on one\n // receipt, and a reference number tells her nothing she can use.\n const siblings = (paymentsByOrder.get(s.order_id) ?? []).filter((x) => x !== id);\n const whole = orderTotal(s);\n const splitNote = siblings.length\n ? `Yes. This was one sale of ${money(whole)} paid on ${siblings.length + 1} cards. This card paid ${money(amountOf(id))} and the other ${plural(siblings.length, \"card paid\", \"cards paid\")} ${siblings.map((x) => money(amountOf(x))).join(\" and \")}.`\n : \"No, one card, one sale.\";\n\n const refund = refundedPayments.get(id);\n const bought = (s.line_items ?? []).map((li) => (li?.name ? `${li.name} x${li?.quantity ?? \"1\"}` : \"The receipt does not name what was bought\")).join(\"; \")\n || \"The receipt does not name what was bought\";\n // KEYS THAT START WITH AN UNDERSCORE NEVER REACH THE CLIENT. They exist so the checks below and\n // the note beside this file can be built from the same row, without a reference number, a record\n // id or a status code ever appearing in a column she reads.\n return {\n \"Date of sale\": isoDay(s.created_at),\n \"Amount (US dollars)\": amountOf(id).toFixed(2),\n \"Name Square holds\": name || \"No name in Square\",\n \"Phone Square holds\": c.phone_number || \"No phone in Square\",\n \"What was bought\": bought,\n \"Card\": CARD_NAME(s.card_brand),\n \"Last four digits\": s.last_4 ?? \"\",\n \"One sale on two cards\": splitNote,\n \"Best match in your customer list\": m.contact ? personName(m.contact) : \"No match found\",\n \"How sure I am\": m.tier === \"proof\" ? \"Certain\" : m.tier === \"probable\" ? \"Likely, please confirm\" : m.tier === \"several\" ? \"More than one person could be this, please pick\" : \"No match found\",\n \"Why I think that\": m.evidence,\n \"Where the money would go if you confirm it\": landsOn || \"Nowhere yet, there is no one to attach it to\",\n \"Square receipt link, open this to see the sale\": s.receipt_url ?? \"\",\n _id: id,\n _date: isoDay(s.created_at),\n _createdAt: s.created_at ?? \"\",\n _amount: amountOf(id),\n _buyer: name || \"No name in Square\",\n _phone: c.phone_number ?? \"\",\n _bought: bought,\n _match: m.contact ? personName(m.contact) : \"\",\n _tier: m.tier,\n _orderId: s.order_id ?? \"\",\n _wholeSale: whole,\n _status: s.status ?? \"\",\n _flagVerdict: flagVerdict,\n _refunded: Boolean(refund),\n };\n});\n{\n const p = [];\n if (fourRows.length !== unlinkedIds.length) p.push(\"the file has a different row count from the unlinked set\");\n const t = fourRows.reduce((a, r) => a + r._amount, 0);\n if (cents(t) !== cents(unlinkedTotal)) p.push(`the file sums to ${money(t)} and the unlinked set is ${money(unlinkedTotal)}`);\n if (fourRows.some((r) => r._status !== \"COMPLETED\")) p.push(\"a payment in this file is not COMPLETED in Square, so it may not be counted as money collected\");\n // THE ORDER A FILE CLAIMS IS THE SOURCE'S ORDER, NEVER OURS. This list says \"oldest first\", and\n // oldest means the moment Square took the card, not the moment our own log noticed it. Two\n // payments 15 seconds apart on 27 July were once printed in the wrong order for exactly that\n // reason, in a file that told the reader it was in the order the payments arrived.\n for (let i = 1; i < fourRows.length; i++) {\n if (String(fourRows[i - 1]._createdAt) > String(fourRows[i]._createdAt)) p.push(\"this file claims oldest first and is not in Square's own time order\");\n }\n if (p.length) { shout(\"FILE 1 RECONCILIATION FAILED. Nothing written.\"); p.forEach((x) => console.error(\" - \" + x)); process.exit(1); }\n}\n\n// -------------------------------------------------------------------------------------------\n// FILE 3, RENDERED. The plan itself was computed above, before file 1, so that file 1 can name\n// the booking a confirmed match would land on.\n// -------------------------------------------------------------------------------------------\nconst writeRows = [...plan.values()].map((g) => {\n const cur = Number(g.opp.monetaryValue || 0);\n const items = [...g.items].sort((a, b) => String(a.date).localeCompare(String(b.date)));\n const delta = items.reduce((a, x) => a + x.amount, 0);\n return {\n \"Customer\": personName(g.contact),\n \"Booking\": g.opp.name ?? \"\",\n \"Board it sits on\": STAGE_NAME[g.opp.pipelineStageId],\n \"Amount showing on it now (US dollars)\": cur.toFixed(2),\n \"Amount to add (US dollars)\": delta.toFixed(2),\n \"Amount it would show afterwards (US dollars)\": (cur + delta).toFixed(2),\n \"How many payments make that up\": items.length,\n \"When those payments were taken\": items.map((x) => x.date).join(\"; \"),\n \"What each one was (US dollars)\": items.map((x) => x.amount.toFixed(2)).join(\"; \"),\n \"How I know\": `Square took ${plural(items.length, \"this payment\", \"these payments\")} from ${personName(g.contact)} and your CRM filed ${plural(items.length, \"it\", \"them\")} against that customer's record, but no dollars were ever put on the booking itself.`,\n \"Would this write over a figure already there\": cur > 0 ? \"YES, DO NOT RUN THIS ROW\" : \"No, the box is empty\",\n _increase: delta,\n _current: cur,\n _count: items.length,\n _stage: g.opp.pipelineStageId,\n _paymentIds: items.map((x) => x.id),\n _booking: g.opp.name ?? \"\",\n };\n}).sort((a, b) => b._increase - a._increase || String(a[\"Customer\"]).localeCompare(String(b[\"Customer\"])));\n\nconst writtenPayments = writeRows.reduce((a, r) => a + r._count, 0);\nconst writtenTotal = writeRows.reduce((a, r) => a + r._increase, 0);\nconst leftAloneTotal = leftAlone.reduce((a, r) => a + r.amount, 0);\n{\n const p = [];\n if (writtenPayments + leftAlone.length !== linkedIds.length) p.push(`${writtenPayments} written + ${leftAlone.length} left alone does not equal the ${linkedIds.length} payments that reached a customer`);\n if (cents(writtenTotal + leftAloneTotal) !== cents(linkedTotal)) p.push(`written ${money(writtenTotal)} + left alone ${money(leftAloneTotal)} does not equal ${money(linkedTotal)}`);\n if (writeRows.some((r) => r._current > 0)) p.push(\"a planned write would overwrite a non zero value\");\n if (writeRows.some((r) => !IN_SCOPE.has(r._stage))) p.push(\"a planned write is outside the two allowed stages\");\n if (new Set(writeRows.flatMap((r) => r._paymentIds)).size !== writtenPayments) p.push(\"a payment appears on more than one booking\");\n if (writeRows.some((r) => r._paymentIds.some((x) => refundedPayments.has(x)))) p.push(\"a refunded payment is in the write plan\");\n // NO ID COLUMN MEANS THE NAME HAS TO BE ENOUGH. If two bookings in this plan share a name and a\n // board, a reader cannot tell which row is which, and the file has to grow a column rather than\n // ship ambiguous. Checked rather than assumed.\n {\n const keys = writeRows.map((r) => `${r._booking}\\u0000${r[\"Board it sits on\"]}`);\n if (new Set(keys).size !== keys.length) p.push(\"two bookings in this plan share a name and a board, so a reader cannot tell the rows apart without an identifier\");\n }\n // The same rule as the counter sales list: where the file states an order it is the source's own\n // order. These payment dates come from Square's record of when the card was taken.\n for (const r of writeRows) {\n const d = r[\"When those payments were taken\"].split(\"; \");\n for (let i = 1; i < d.length; i++) if (d[i - 1] > d[i]) p.push(`the payments on ${r[\"Customer\"]}'s row are not in the order Square took them`);\n }\n if (writeRows.some((r) => r._paymentIds.some((x) => unlinkedIds.includes(x)))) p.push(\"an unlinked payment leaked into the write plan\");\n if (p.length) { shout(\"WRITE-BACK RECONCILIATION FAILED. Nothing written.\"); p.forEach((x) => console.error(\" - \" + x)); process.exit(1); }\n}\n\n// WHAT THE FIELD BEING WRITTEN ACTUALLY HOLDS TODAY. Checked, never assumed, because \"sum the\n// payment onto monetaryValue\" is only obviously right if that field already holds payments.\nconst valueShape = new Map();\nfor (const o of opportunities) { const v = Number(o.monetaryValue || 0); if (v > 0) valueShape.set(v, (valueShape.get(v) ?? 0) + 1); }\nconst distinctValues = [...valueShape.entries()].sort((a, b) => b[1] - a[1]);\nconst cardsWithValue = distinctValues.reduce((a, [, n]) => a + n, 0);\nconst looksLikeAPriceList = distinctValues.length > 0 && distinctValues.length <= 5;\nconst priceListNotice = looksLikeAPriceList\n ? `READ THIS BEFORE ANY OF IT IS RUN. ${cardsWithValue} of your ${opportunities.length.toLocaleString(\"en-US\")} cards carried a figure in the value column when I read them on ${AS_AT}, and between them they use only ${distinctValues.length} different ${plural(distinctValues.length, \"figure\", \"figures\")}, ${distinctValues.map(([v]) => money(v)).join(\", \")}. That is the shape of a price list, not of money taken. If that column holds the price of the program, then an empty card means no price was set rather than nobody has paid, and adding a counter sale to it makes the column mean two different things on different rows. Deciding what that column is for is your call and not this file's, so nothing here has been run.`\n : \"\";\n\n// ===========================================================================================\n// THE UNPAID INVOICES. A different population from everything above and it is labelled as one.\n// An unpaid invoice is money asked for that has not arrived; a counter sale with no customer is\n// money that HAS arrived and is not filed against anybody. Those two lists were once sent as if\n// they were the same list, so from here on each one says what it is not.\n// ===========================================================================================\n// Settled is enumerated as a positive list rather than assumed to be the single word \"paid\". An\n// unknown status counted as unresolved would invent a debt and counted as settled would hide one,\n// so an unknown status stops the run.\nconst SETTLED = new Set([\"paid\", \"void\", \"voided\", \"cancelled\", \"canceled\", \"written_off\", \"partially_paid\"]);\nconst UNRESOLVED = new Set([\"draft\", \"sent\", \"overdue\", \"viewed\", \"partially_paid_unsettled\"]);\n{\n const unknown = [...new Set(invoices.map((i) => i.status))].filter((s) => !SETTLED.has(s) && !UNRESOLVED.has(s));\n if (unknown.length) die(`invoice status(es) this report has no rule for: ${unknown.join(\", \")}. Classify them before shipping a number.`);\n}\nconst invTotal = (i) => Number(i.total ?? i.invoiceTotal ?? 0) || 0;\nconst invDue = (i) => Number(i.amountDue ?? 0) || 0;\nconst parentInvoiceTotal = invoices.reduce((a, i) => a + invTotal(i), 0);\nconst unresolvedInvoices = invoices.filter((i) => !SETTLED.has(i.status)).sort((a, b) => String(a.createdAt).localeCompare(String(b.createdAt)));\nconst settledInvoices = invoices.filter((i) => SETTLED.has(i.status));\nconst unresolvedTotal = unresolvedInvoices.reduce((a, i) => a + invTotal(i), 0);\nconst settledTotal = settledInvoices.reduce((a, i) => a + invTotal(i), 0);\n{\n const p = [];\n if (unresolvedInvoices.length + settledInvoices.length !== invoices.length) p.push(\"unresolved plus settled does not equal all invoices\");\n if (cents(unresolvedTotal + settledTotal) !== cents(parentInvoiceTotal)) p.push(`unresolved ${money(unresolvedTotal)} plus settled ${money(settledTotal)} does not equal ${money(parentInvoiceTotal)}`);\n if (p.length) { shout(\"INVOICE RECONCILIATION FAILED. Nothing written.\"); p.forEach((x) => console.error(\" - \" + x)); process.exit(1); }\n}\n\n// THE NAME COMES FROM THE CUSTOMER RECORD, NOT FROM WHATEVER THE INVOICE HAPPENED TO STORE. One\n// invoice in this list showed a customer called \"(410) 804-1833\", because that is what somebody\n// typed at the counter. Her CRM knows that person perfectly well. A phone number where a name\n// should be is not a data problem she has to solve, it is one we have to stop printing.\nconst PLACEHOLDER_EMAIL = /^auto\\.generated@pos\\.payment$/i;\nconst NAMELESS = new Set([\"unknown\", \"\", \"no name\", \"customer\", \"your dog\"]);\nconst looksLikeAPhoneNumber = (s) => /^[\\s()+\\-.\\d]{7,}$/.test(String(s ?? \"\").trim());\nconst sharedCounterContactIds = new Set(\n contacts.filter((c) => PLACEHOLDER_EMAIL.test(String(c.email ?? \"\")) || NAMELESS.has(String(c.contactName ?? \"\").trim().toLowerCase()))\n .map((c) => c.id),\n);\nfunction resolveCustomer(i) {\n const cd = i.contactDetails ?? {};\n const stored = String(cd.name ?? \"\").trim();\n const c = contactById.get(cd.id);\n const notes = [];\n let name = \"\";\n if (c && sharedCounterContactIds.has(c.id)) {\n name = \"No customer name on file\";\n notes.push(\"this one was rung up against the shared counter record your card reader uses, so there is no person on it to chase\");\n } else if (c) {\n name = personName(c);\n if (stored && normName(stored) && normName(stored) !== normName(name) && !looksLikeAPhoneNumber(stored)) {\n notes.push(`the invoice was typed up under the name ${stored} and the customer record now reads ${name}`);\n }\n } else if (stored && !looksLikeAPhoneNumber(stored) && !NAMELESS.has(stored.toLowerCase())) {\n name = titleCase(stored);\n notes.push(\"the customer record this was raised against has since been deleted from your CRM, so the email and phone on the invoice are all there is to go on\");\n } else {\n name = \"No customer name on file\";\n notes.push(\"the customer record this was raised against has since been deleted from your CRM\");\n }\n return { name, notes };\n}\n\n// SQUARE CANNOT SPEAK ABOUT WHAT IT NEVER SAW. Its record here begins the day the connection was\n// switched on, so for anything raised before that it is silent rather than negative. Saying \"no\n// Square payment found\" about a December invoice would be a date boundary passed off as a finding.\nconst squareCoverageStart = square.map((s) => s.created_at).filter(Boolean).sort()[0] ?? journal.map((r) => r?.ts).filter(Boolean).sort()[0];\nconst squareByKey = new Map();\nfor (const s of square) {\n const c = s.square_customer ?? {};\n for (const k of [normPhone(c.phone_number), normEmail(c.email_address), normName([c.given_name, c.family_name].filter(Boolean).join(\" \"))]) {\n if (k) (squareByKey.get(k) ?? squareByKey.set(k, []).get(k)).push(s);\n }\n}\nconst invoiceById = new Map(invoices.map((i) => [i._id, i]));\nconst SOURCE_NAME = { mobile_pos: \"Rung up at the counter\", payments_subscription: \"A subscription in your CRM\", manual: \"Entered by hand\" };\n\n// REAL MONEY OR A TEST ROW. This cut is a judgement and the file says so in the page beside it.\n// The rule is two lines long on purpose, so she can disagree with it row by row: anything under\n// five dollars is somebody testing a card reader rather than a sale, and anything raised against\n// a record with the word \"test\" in its name is somebody testing the software. Everything else is\n// treated as real money even where it is awkward, because deciding otherwise on a customer's\n// behalf is how a real unpaid invoice quietly disappears off a list.\nconst TEST_MONEY_CEILING = 5;\nconst invoiceRows = unresolvedInvoices.map((i) => {\n const cd = i.contactDetails ?? {};\n const amt = invTotal(i);\n const { name, notes } = resolveCustomer(i);\n const storedName = String(cd.name ?? \"\").trim();\n const namedAsATest = /\\btest\\b/i.test(storedName) || /\\btest\\b/i.test(name);\n const tooSmallToBeASale = amt < TEST_MONEY_CEILING;\n const isTest = namedAsATest || tooSmallToBeASale;\n\n const inSquareWindow = i.createdAt && squareCoverageStart && i.createdAt >= squareCoverageStart;\n const keys = [normPhone(cd.phoneNo), normEmail(cd.email), normName(cd.name)].filter(Boolean);\n const sqHits = [...new Set(keys.flatMap((k) => squareByKey.get(k) ?? []))].filter((s) => cents(s.amount) === cents(amt));\n const txHits = sharedCounterContactIds.has(cd.id) ? [] : transactions.filter((t) =>\n t.status === \"succeeded\" && cents(Number(t.amount) || 0) === cents(amt) && t.contactId && t.contactId === cd.id);\n\n let paid = \"No sign of it either way\";\n let evidence = \"\";\n let alreadyPaid = false;\n if (sqHits.length) {\n const s = sqHits[0];\n paid = \"Yes, in Square\";\n evidence = `Square took ${money(s.amount)} from this customer on ${fmtDate(s.created_at)}, and the receipt is at ${s.receipt_url}`;\n alreadyPaid = true;\n } else if (txHits.length) {\n const t = txHits[0];\n const sib = invoiceById.get(t.entitySourceId) ?? invoiceById.get(t.entityId);\n paid = \"Yes, in your CRM\";\n evidence = sib\n ? `the same customer paid ${money(t.amount)} on ${fmtDate(t.createdAt)} against invoice ${sib.invoiceNumber}, which is a duplicate of this one raised the same day and is marked paid`\n : `your CRM recorded a payment of ${money(t.amount)} from this customer on ${fmtDate(t.createdAt)}`;\n alreadyPaid = true;\n } else if (!inSquareWindow) {\n paid = \"Square cannot say\";\n evidence = `this was raised before the Square connection started recording on ${fmtDate(squareCoverageStart)}, so Square can neither confirm nor rule out\n","createdAt",["D",1789560843141],"branchVersion","branchId","551774fb-a850-4c9d-94a1-d3509ddcf1b0","id","1bfa6e81-74e1-4c6c-ab32-118304a4ffff","dogsspot_puppy_path",["D",1785429259053],"deletedAt","legacyEnvVars",false,"privacy","public","httpPrivacy","description","Puppy path nurture engine v1.2 — The Dogs Spot","imageUrl","d26e64e6-cd39-4be1-b5b4-1de11cc555f8","pinnedFileId","ad633fec-8e73-11f1-b800-1607ee4eb77e","pinPreview","pinMigrated","screenshotVersion","likeCount",0,"orgId","019f56fd-bd59-724f-8163-80ffcf8235dd","tursoName","1bfa6e8174e14c6cab32118304a4ffff","tursoHostname","1bfa6e8174e14c6cab32118304a4ffff-val-town.aws-us-east-2.turso.io","tursoMeasuredAt",["D",1789519842404],"pinned","userPerm","r","valPerm","blobPerm","rw","emailPerm","sqlitePerm","projectPerm","telemetryPerm","user",{"_98":97,"_106":102},"org",{"_98":97,"_99":100,"_101":102,"_18":54,"_103":104,"_105":47},"branch",{"_13":87,"_32":88,"_41":40,"_89":42,"_90":-5,"_91":-5,"_92":-5,"_93":-5,"_94":-5,"_95":43,"_96":97},"isOwned",1280,"main","projectId","forkedBranchId","forkedBranchVersion","forkedProjectPrivacy","forkedProjectId","forkedProjectOrgId","projectName","userHandle","amir5","handle","displayName","Amir","avatar","https://lh3.googleusercontent.com/a/ACg8ocILk3bwhcvrzozUWm7gxlKoBm7ZGtsgIkesW3ysOOsJ1rSQuA=s96-c","tier","free","canRestrictVals","profileImageUrl","branchName","","adoptOrgId",{"_41":42,"_32":43,"_36":836,"_45":-5,"_46":47,"_48":49,"_50":49,"_51":52,"_53":-5,"_18":54,"_55":56,"_57":25,"_58":-5,"_59":-5,"_60":61,"_62":63,"_64":65,"_66":67,"_68":837,"_70":-5,"_71":72,"_73":72,"_74":75,"_76":75,"_77":75,"_78":72,"_79":72,"_80":838,"_82":839,"_84":840,"_86":47},"tree",[611,612,613,614,615,616,617,618,619,620,621,622,623,624,625,626,627,628,629,630,631,632,633,634,635,636,637,638,639,640,641,642,643,644,645,646,647,648,649,650,651,652,653,654,655,656,657,658,659,660,661,662,663,664,665,666],"files",[611,612,613,614,615,616,617,618,619,620,621,622,623,624,625,626,627,628,629,630,631,632,633,634,635,636,637,638,639,640,641,642,643,644,645,646,647,648,649,650,651,652,653,654,655,656,657,658,659,660,661,662,663,664,665,666],"counts",{"_600":61,"_601":244,"_602":61,"_603":604,"_605":606},"contents",[129,130,131,132,133,134,135,136,137,138,139,140,141,142,143,144,145,146,147,148,149,150,151,152,153,154,155,156,157,158,159,160,161,162,163,164,165,166,167,168,169,170,171,172,173,174,175,176,177,178,179,180,181,182,183,184],"upstreamProject","upstreamBranch","emptyEnvVars","flags",[],"hasHttpFiles","grants","orgs","customDomains",{},{"_41":593,"_32":594,"_30":595,"_188":-5,"_39":40,"_38":596,"_190":25,"_36":597,"_13":61,"_33":20,"_34":598,"_24":47,"_195":-5,"_27":599},{"_41":586,"_32":587,"_30":588,"_188":-5,"_39":40,"_38":589,"_190":25,"_36":590,"_13":219,"_33":193,"_34":591,"_24":47,"_195":-5,"_27":592},{"_41":579,"_32":580,"_30":581,"_188":-5,"_39":40,"_38":582,"_190":25,"_36":583,"_13":236,"_33":20,"_34":584,"_24":47,"_195":-5,"_27":585},{"_41":572,"_32":573,"_30":574,"_188":-5,"_39":40,"_38":575,"_190":25,"_36":576,"_13":61,"_33":20,"_34":577,"_24":47,"_195":-5,"_27":578},{"_41":565,"_32":566,"_30":567,"_188":-5,"_39":40,"_38":568,"_190":47,"_36":569,"_13":228,"_33":20,"_34":570,"_24":47,"_195":-5,"_27":571},{"_41":558,"_32":559,"_30":560,"_188":-5,"_39":40,"_38":561,"_190":47,"_36":562,"_13":228,"_33":20,"_34":563,"_24":47,"_195":-5,"_27":564},{"_41":551,"_32":552,"_30":553,"_188":-5,"_39":40,"_38":554,"_190":47,"_36":555,"_13":202,"_33":20,"_34":556,"_24":47,"_195":-5,"_27":557},{"_41":544,"_32":545,"_30":546,"_188":-5,"_39":40,"_38":547,"_190":47,"_36":548,"_13":202,"_33":20,"_34":549,"_24":47,"_195":-5,"_27":550},{"_41":537,"_32":538,"_30":539,"_188":-5,"_39":40,"_38":540,"_190":47,"_36":541,"_13":219,"_33":20,"_34":542,"_24":47,"_195":-5,"_27":543},{"_41":530,"_32":531,"_30":532,"_188":-5,"_39":40,"_38":533,"_190":47,"_36":534,"_13":61,"_33":20,"_34":535,"_24":47,"_195":-5,"_27":536},{"_41":523,"_32":524,"_30":525,"_188":-5,"_39":40,"_38":526,"_190":47,"_36":527,"_13":61,"_33":20,"_34":528,"_24":47,"_195":-5,"_27":529},{"_41":516,"_32":517,"_30":518,"_188":-5,"_39":40,"_38":519,"_190":47,"_36":520,"_13":61,"_33":20,"_34":521,"_24":47,"_195":-5,"_27":522},{"_41":509,"_32":510,"_30":511,"_188":-5,"_39":40,"_38":512,"_190":47,"_36":513,"_13":61,"_33":20,"_34":514,"_24":47,"_195":-5,"_27":515},{"_41":502,"_32":503,"_30":504,"_188":-5,"_39":40,"_38":505,"_190":47,"_36":506,"_13":61,"_33":20,"_34":507,"_24":47,"_195":-5,"_27":508},{"_41":495,"_32":496,"_30":497,"_188":-5,"_39":40,"_38":498,"_190":47,"_36":499,"_13":61,"_33":20,"_34":500,"_24":47,"_195":-5,"_27":501},{"_41":488,"_32":489,"_30":490,"_188":-5,"_39":40,"_38":491,"_190":47,"_36":492,"_13":61,"_33":20,"_34":493,"_24":47,"_195":-5,"_27":494},{"_41":481,"_32":482,"_30":483,"_188":-5,"_39":40,"_38":484,"_190":25,"_36":485,"_13":61,"_33":193,"_34":486,"_24":47,"_195":-5,"_27":487},{"_41":474,"_32":475,"_30":476,"_188":-5,"_39":40,"_38":477,"_190":25,"_36":478,"_13":219,"_33":211,"_34":479,"_24":47,"_195":-5,"_27":480},{"_41":467,"_32":468,"_30":56,"_188":-5,"_39":40,"_38":469,"_190":25,"_36":470,"_13":471,"_33":211,"_34":472,"_24":47,"_195":-5,"_27":473},{"_41":460,"_32":461,"_30":462,"_188":-5,"_39":40,"_38":463,"_190":25,"_36":464,"_13":61,"_33":193,"_34":465,"_24":47,"_195":-5,"_27":466},{"_41":453,"_32":454,"_30":455,"_188":-5,"_39":40,"_38":456,"_190":25,"_36":457,"_13":228,"_33":193,"_34":458,"_24":47,"_195":-5,"_27":459},{"_41":446,"_32":447,"_30":448,"_188":-5,"_39":40,"_38":449,"_190":25,"_36":450,"_13":244,"_33":193,"_34":451,"_24":47,"_195":-5,"_27":452},{"_41":439,"_32":440,"_30":441,"_188":-5,"_39":40,"_38":442,"_190":25,"_36":443,"_13":61,"_33":193,"_34":444,"_24":47,"_195":-5,"_27":445},{"_41":431,"_32":432,"_30":433,"_188":-5,"_39":40,"_38":434,"_190":25,"_36":435,"_13":436,"_33":211,"_34":437,"_24":47,"_195":-5,"_27":438},{"_41":423,"_32":424,"_30":425,"_188":-5,"_39":40,"_38":426,"_190":25,"_36":427,"_13":428,"_33":193,"_34":429,"_24":47,"_195":-5,"_27":430},{"_41":416,"_32":417,"_30":418,"_188":-5,"_39":40,"_38":419,"_190":25,"_36":420,"_13":202,"_33":220,"_34":421,"_24":47,"_195":-5,"_27":422},{"_41":408,"_32":409,"_30":410,"_188":-5,"_39":40,"_38":411,"_190":25,"_36":412,"_13":413,"_33":211,"_34":414,"_24":47,"_195":-5,"_27":415},{"_41":401,"_32":402,"_30":403,"_188":-5,"_39":40,"_38":404,"_190":25,"_36":405,"_13":61,"_33":193,"_34":406,"_24":47,"_195":-5,"_27":407},{"_41":393,"_32":394,"_30":395,"_188":-5,"_39":40,"_38":396,"_190":25,"_36":397,"_13":398,"_33":193,"_34":399,"_24":47,"_195":-5,"_27":400},{"_41":386,"_32":387,"_30":388,"_188":-5,"_39":40,"_38":389,"_190":25,"_36":390,"_13":296,"_33":211,"_34":391,"_24":47,"_195":-5,"_27":392},{"_41":379,"_32":380,"_30":381,"_188":-5,"_39":40,"_38":382,"_190":25,"_36":383,"_13":267,"_33":193,"_34":384,"_24":47,"_195":-5,"_27":385},{"_41":372,"_32":373,"_30":374,"_188":-5,"_39":40,"_38":375,"_190":25,"_36":376,"_13":267,"_33":211,"_34":377,"_24":47,"_195":-5,"_27":378},{"_41":365,"_32":366,"_30":367,"_188":-5,"_39":40,"_38":368,"_190":25,"_36":369,"_13":210,"_33":211,"_34":370,"_24":47,"_195":-5,"_27":371},{"_41":357,"_32":358,"_30":359,"_188":-5,"_39":40,"_38":360,"_190":25,"_36":361,"_13":362,"_33":193,"_34":363,"_24":47,"_195":-5,"_27":364},{"_41":350,"_32":351,"_30":352,"_188":-5,"_39":40,"_38":353,"_190":25,"_36":354,"_13":219,"_33":193,"_34":355,"_24":47,"_195":-5,"_27":356},{"_41":342,"_32":343,"_30":344,"_188":-5,"_39":40,"_38":345,"_190":25,"_36":346,"_13":347,"_33":220,"_34":348,"_24":47,"_195":-5,"_27":349},{"_41":335,"_32":336,"_30":337,"_188":-5,"_39":40,"_38":338,"_190":25,"_36":339,"_13":219,"_33":193,"_34":340,"_24":47,"_195":-5,"_27":341},{"_41":328,"_32":329,"_30":330,"_188":-5,"_39":40,"_38":331,"_190":25,"_36":332,"_13":244,"_33":193,"_34":333,"_24":47,"_195":-5,"_27":334},{"_41":320,"_32":321,"_30":322,"_188":-5,"_39":40,"_38":323,"_190":25,"_36":324,"_13":325,"_33":211,"_34":326,"_24":47,"_195":-5,"_27":327},{"_41":313,"_32":314,"_30":315,"_188":-5,"_39":40,"_38":316,"_190":25,"_36":317,"_13":244,"_33":193,"_34":318,"_24":47,"_195":-5,"_27":319},{"_41":306,"_32":307,"_30":308,"_188":-5,"_39":40,"_38":309,"_190":25,"_36":310,"_13":244,"_33":193,"_34":311,"_24":47,"_195":-5,"_27":312},{"_41":299,"_32":300,"_30":301,"_188":-5,"_39":40,"_38":302,"_190":25,"_36":303,"_13":210,"_33":193,"_34":304,"_24":47,"_195":-5,"_27":305},{"_41":291,"_32":292,"_30":293,"_188":-5,"_39":40,"_38":294,"_190":25,"_36":295,"_13":296,"_33":193,"_34":297,"_24":47,"_195":-5,"_27":298},{"_41":284,"_32":285,"_30":286,"_188":-5,"_39":40,"_38":287,"_190":25,"_36":288,"_13":210,"_33":193,"_34":289,"_24":47,"_195":-5,"_27":290},{"_41":277,"_32":278,"_30":279,"_188":-5,"_39":40,"_38":280,"_190":25,"_36":281,"_13":244,"_33":193,"_34":282,"_24":47,"_195":-5,"_27":283},{"_41":270,"_32":271,"_30":272,"_188":-5,"_39":40,"_38":273,"_190":25,"_36":274,"_13":61,"_33":193,"_34":275,"_24":47,"_195":-5,"_27":276},{"_41":262,"_32":263,"_30":264,"_188":-5,"_39":40,"_38":265,"_190":25,"_36":266,"_13":267,"_33":193,"_34":268,"_24":47,"_195":-5,"_27":269},{"_41":254,"_32":255,"_30":256,"_188":-5,"_39":40,"_38":257,"_190":25,"_36":258,"_13":259,"_33":211,"_34":260,"_24":47,"_195":-5,"_27":261},{"_41":247,"_32":248,"_30":249,"_188":-5,"_39":40,"_38":250,"_190":25,"_36":251,"_13":219,"_33":211,"_34":252,"_24":47,"_195":-5,"_27":253},{"_41":239,"_32":240,"_30":241,"_188":-5,"_39":40,"_38":242,"_190":25,"_36":243,"_13":244,"_33":193,"_34":245,"_24":47,"_195":-5,"_27":246},{"_41":231,"_32":232,"_30":233,"_188":-5,"_39":40,"_38":234,"_190":25,"_36":235,"_13":236,"_33":193,"_34":237,"_24":47,"_195":-5,"_27":238},{"_41":223,"_32":224,"_30":225,"_188":-5,"_39":40,"_38":226,"_190":25,"_36":227,"_13":228,"_33":211,"_34":229,"_24":47,"_195":-5,"_27":230},{"_41":214,"_32":215,"_30":216,"_188":-5,"_39":40,"_38":217,"_190":25,"_36":218,"_13":219,"_33":220,"_34":221,"_24":47,"_195":-5,"_27":222},{"_41":205,"_32":206,"_30":207,"_188":-5,"_39":40,"_38":208,"_190":25,"_36":209,"_13":210,"_33":211,"_34":212,"_24":47,"_195":-5,"_27":213},{"_41":197,"_32":198,"_30":199,"_188":-5,"_39":40,"_38":200,"_190":25,"_36":201,"_13":202,"_33":193,"_34":203,"_24":47,"_195":-5,"_27":204},{"_41":185,"_32":186,"_30":187,"_188":-5,"_39":40,"_38":189,"_190":25,"_36":191,"_13":192,"_33":193,"_34":194,"_24":47,"_195":-5,"_27":196},"07bbc883-3657-42ce-a700-629b0024a8cb","worklog.ts","facd3ee8-9028-11f1-8d98-1607ee4eb77e","parentId",1117,"latest",["D",1786812154376],39,"script","// THE WORK LOG — what changed, what broke, what got fixed. v1.0, 4 Aug 2026.\n//\n// WHY: Kim's dashboard answers \"is it working\" from live data. It cannot answer \"what have you\n// actually been doing\" or \"did something break last week\" from live data, because those are\n// events, not states. This file is the event trail: append-only, plain English, dated.\n//\n// THE RULE: every entry describes something that DEMONSTRABLY happened, with the evidence\n// alongside it. No entry is written for work that was merely intended. If a claim here cannot\n// be checked, it does not go here. Kim reads this; it is the receipts column of the retainer.\n//\n// TWO SOURCES:\n// 1. SEEDED (below): work done by hand, each line traceable to a verification run.\n// 2. AUTOMATIC: the watchdog appends \"broke\"/\"recovered\" pairs to the `tds_worklog` blob, so\n// an outage at 3am and its recovery both appear without anyone remembering to write them.\n\nexport type WorkEntry = {\n at: string; // ISO date (day precision is fine; this is a human timeline)\n // v1.2. A reader noticed that \"Fixed: this page used to state a number nobody measured\" (mine)\n // and \"Fixed: your website was charging half the deposit\" (hers, worth thousands) wore the same\n // label in the same colour, so my errors were hiding among her wins. `mine` is now its own kind\n // and its own word. Her words: \"Separate the two columns and I'll trust the page more, not less.\"\n kind: \"fixed\" | \"built\" | \"found\" | \"broke\" | \"recovered\" | \"changed\" | \"mine\";\n what: string; // one plain sentence, Kim's vocabulary\n evidence?: string; // how it was checked. Optional only for \"broke\" (the alarm IS the evidence)\n};\n\n// Seeded history. Everything below was verified on the date shown; the evidence column names\n// the check. Newest first is handled by the renderer, so this list stays chronological.\nexport const SEEDED: WorkEntry[] = [\n {\n at: \"2026-07-30\",\n kind: \"built\",\n what: \"The puppy follow-up system was built and switched into practice mode, where it does everything except actually send.\",\n evidence: \"It has been running on its own since, writing down every decision it makes. Its first practice run is still on file.\",\n },\n {\n at: \"2026-08-02\",\n kind: \"built\",\n what: \"Candace's welcome email was written and sent so she could start on the phones with the full picture.\",\n evidence: \"Sent 2 August; it is in the sent folder.\",\n },\n {\n at: \"2026-08-02\",\n kind: \"found\",\n what: \"Your website was charging a $250 Bootcamp deposit instead of $500. It was hidden inside the booking form's own settings, which is why nobody could find it.\",\n evidence: \"Fixed and published; the whole live site was then searched for '$250' and it appears nowhere.\",\n },\n {\n at: \"2026-08-02\",\n kind: \"found\",\n what: \"There are 17 Bootcamp bookings on record, from 19 December to 25 July, every one of them taken while the deposit was set to $250. What is not yet known is which of them actually paid one, and that means matching each booking against the payment records.\",\n evidence: \"Counted from your own booking records. An earlier version of this note asked you for a payment permission to finish the job; that was wrong and it is corrected here, because you had already granted it and it has been working since 1 August. Matching the bookings to the payments is work rather than a blocker, and it has not been done yet.\",\n },\n {\n at: \"2026-08-03\",\n kind: \"fixed\",\n what: \"29 people who had texted STOP were never marked do-not-contact in the CRM, so they could still have been messaged.\",\n evidence: \"All 29 marked, then all 29 read back one at a time through the CRM's own records on 4 August. 29 of 29 confirmed, none missed.\",\n },\n {\n at: \"2026-08-03\",\n kind: \"mine\",\n what: \"Three of the people who had texted STOP were on a call list I had already sent to your front desk. That was my mistake. The list was pulled and rebuilt the same day, but whether anyone had already called those three is not something I can see from here, and it is worth asking the desk.\",\n evidence: \"The rebuilt list has every STOP and every gate arrival removed, with a second tab naming exactly who came off it and why. The three names are in that tab, so the desk can be asked about those three specifically.\",\n },\n {\n at: \"2026-08-03\",\n kind: \"changed\",\n what: \"The puppy follow-up messages were updated with your notes: the toy advice now explains the why, and the Pup Talk asks came down from six to four.\",\n evidence: \"The PDF you signed off was generated straight from the live system, not from a draft.\",\n },\n {\n at: \"2026-08-04\",\n kind: \"built\",\n what: \"The slow track you asked for is built: weekly for a month, then every two weeks for six months, then monthly. No sales asks anywhere on it.\",\n evidence: \"29 messages, all written out in the PDF for your sign-off. Nothing sends until you say go.\",\n },\n {\n at: \"2026-08-04\",\n kind: \"mine\",\n what: \"The follow-up system was running slightly older wording than the version you approved. It now runs exactly what you read.\",\n evidence: \"Compared the live wording against the wording you approved, character by character; they now match.\",\n },\n {\n at: \"2026-08-04\",\n kind: \"fixed\",\n what: \"A security review found that text typed by a customer into their own name could end up treated as code inside an email we send, rather than as words. Nobody had done it, and it cannot happen now. Two other holes were found and closed in the same review, one of them in the key that protects the page you are reading.\",\n evidence: \"It came out of an adversarial review alongside two other security findings, and each of the three now has its own automatic check, and those checks are run before anything goes anywhere near your account. For this one that means names holding dollar signs, angle brackets, quotes and stray markup. The old page key was checked afterwards and is dead.\",\n },\n {\n at: \"2026-08-04\",\n kind: \"built\",\n // [was: \"...looks over the whole setup ON A TIMER and raises an alarm...\". Every word about\n // what it checks was verified and still stands. The two words about the timer were not, and\n // on 5 August the timer turned out never to have fired. Kim has read this line. It is\n // corrected here rather than deleted, and the 5 August entry above carries the current state.]\n what: \"A second, separate system now looks over the whole setup and raises an alarm if anything stops working, including if somebody else quietly changes one of your CRM automations.\",\n evidence: \"Run live and watched end to end. It takes a fingerprint of your CRM automations each time it looks, so a change to any one of them shows up as a change rather than as silence. What was NOT checked at the time was whether it starts itself on a schedule. It does not; see 5 August.\",\n },\n {\n at: \"2026-08-04\",\n kind: \"found\",\n what: \"Your CRM still has an old puppy follow-up automation switched on. If our new one went live alongside it, new inquiries would get two sets of messages from you on the same day.\",\n evidence: \"Read all 165 automations in your account. Switching ours on and that one off has to happen together, and it needs your say-so.\",\n },\n {\n at: \"2026-08-04\",\n kind: \"found\",\n what: \"Your CRM records where nearly every inquiry came from, but not in the column it shows you. The column you can see is blank for four out of five people; the record underneath places all of them.\",\n evidence: \"Checked across a full week of inquiries: the column you can see named about one in five of them, the record underneath named every single one. That is where the Facebook and Instagram numbers above come from, and they are recounted every time you open this page.\",\n },\n {\n at: \"2026-08-04\",\n kind: \"mine\",\n what: \"This page used to tell you the follow-up system checks in every 15 minutes. Nobody had ever measured that, and it was not true. It now times itself and reports the rhythm it actually keeps.\",\n evidence: \"The page was saying 'last checked 26 minutes ago' and 'it runs every 15 minutes' at the same time, which cannot both be right. It now measures the gaps between runs and reports what it sees.\",\n },\n {\n at: \"2026-08-01\",\n kind: \"mine\",\n what: \"I sent you a draft of the follow-up messages as though it were the finished thing, and you spent an evening reading the wrong version. That was mine, and the replacement was generated from the live system so it could not happen the same way twice.\",\n evidence: \"Every write-up you have had since is generated from the running system rather than typed, so what you read is what would send.\",\n },\n {\n at: \"2026-08-02\",\n kind: \"mine\",\n what: \"I gave you a missed-calls figure that was too high, because it was counting people arriving at the gate as well as people calling. You spotted it before I did.\",\n evidence: \"Recounted with gate arrivals excluded, and the same exclusion now runs on every list that comes out of here.\",\n },\n {\n at: \"2026-08-03\",\n kind: \"mine\",\n what: \"I told you a list had been deleted and then left the old one sitting in your Drive for a day. Two versions of the same list is exactly the confusion I was trying to save you from.\",\n evidence: \"The old one is in the trash and the folder was checked afterwards; only one version exists.\",\n },\n {\n at: \"2026-08-03\",\n kind: \"mine\",\n what: \"You asked me something at 8:20 that morning and my reply at 8:27 answered everything except that. Answered since.\",\n evidence: \"Both messages re-read against each other so the gap could be found rather than assumed.\",\n },\n {\n at: \"2026-08-04\",\n kind: \"found\",\n what: \"Once it was measured, the follow-up system turned out to be running about hourly and the watchdog slower still, rather than four times an hour as this page used to claim. Nothing is harmed by that, because the messages are scheduled by the day, but it was worth knowing rather than assuming.\",\n evidence: \"Both were watched without being touched, then run by hand to confirm the code itself was healthy. Both ran cleanly. Do not read the rhythm off this line: the health card above measures the gaps between actual runs and prints what it currently observes, which is the only figure either of us should trust.\",\n },\n {\n at: \"2026-08-04\",\n kind: \"mine\",\n what: \"The count of new customers on this page was reading low. It was looking at only the most recent slice of your records, which missed anyone who first got in touch a while ago and only became a customer this week.\",\n evidence: \"The whole Customer list is now read every time rather than the first slice of it, in about a second. For the last seven days that changed the figure from 2 to 5.\",\n },\n {\n at: \"2026-08-05\",\n kind: \"found\",\n what: \"The second system that checks the first one was set to look once a day, not once an hour. It has been changed to hourly. Nothing was broken; it was just looking far less often than the things it watches can go wrong.\",\n evidence: \"Read off its own settings screen: it said once every 1 days, and its last run had been 13 hours earlier. The follow-up system runs on the hour, so a problem starting just after the checker looked could have sat unnoticed until the next day. It now runs hourly, which matches what it is checking. Everything it looks at was still being looked at throughout.\",\n },\n {\n at: \"2026-08-05\",\n kind: \"mine\",\n what: \"This page told you the checker runs itself about every 95 minutes. That came from the times Amir had started it by hand, so it was a real measurement of the wrong thing. I then went further and wrote that its timer was not firing at all. That was wrong twice over: it was firing, and the only reason my new counter showed nothing was that the counter itself was broken.\",\n evidence: \"The two kinds of run are recorded separately now, and both were watched working before this was written: a scheduled run recorded as scheduled, a hand-started one as by hand. The page no longer guesses at causes either. It reports what it has and has not seen and leaves the diagnosing to a person, which is what I should have done before writing that sentence the first time.\",\n },\n {\n at: \"2026-08-05\",\n kind: \"mine\",\n what: \"Two of our systems were describing the same pile of unmatched counter sales with different figures. One said 35 sales worth $23,463.99, the other said 40 worth $28,035.99.\",\n evidence: \"The payment records were counted again from scratch, a third time and by a different method: 40 is correct. The lower figure came from skipping some sales and from subtracting two things that were not the same kind of thing. Both systems now read the same single count, so they cannot disagree again.\",\n },\n {\n at: \"2026-08-05\",\n kind: \"found\",\n what: \"On your missing call transcripts, a correction of ours. This page said earlier that day that transcription had never been switched on. That was wrong: a call from that morning was opened and its full written transcript was watched rendering. Transcription works, at least sometimes, so the real question is which calls are missing theirs.\",\n evidence: \"The wrong version was reasoned from the reading connection, which never carries transcripts, and that gap was mistaken for the transcripts not existing. The corrected question is on the list above: one example from Kim of a call that should have a transcript and does not is the fastest way to pin down the pattern.\",\n },\n {\n at: \"2026-08-05\",\n kind: \"built\",\n what: \"The missing third step is built. Something now works out which of your inquiries is about a puppy, and it runs alongside everything else so you can see what it would do before it does anything.\",\n evidence: \"It has applied nothing and it cannot: the part that decides has no way to change anything in your account, which is checked automatically. Its first run over your most recent contacts is on the question list above, with its own numbers. A full pass over 1,200 of your records is written up separately for Amir to check line by line.\",\n },\n {\n at: \"2026-08-05\",\n kind: \"mine\",\n what: \"My first attempt at spotting a puppy inquiry would have signed up three people who should not have been: a man asking to buy a puppy, a woman rehoming her older dogs, and a dog described as three years and four months old that got read as four months.\",\n evidence: \"Each of those three is now a rule, each rule has a test, and each test has a check that breaks the rule on purpose and demands the test notice. None of them reached anybody, because nothing has been switched on.\",\n },\n {\n at: \"2026-08-05\",\n kind: \"found\",\n what: \"One of your knowledge bases was edited at around half past ten the night before, and nothing was keeping an eye on it. If that was you, everything is fine and this is just us noticing.\",\n evidence: \"The consolidated one, which is what Chloe answers customers from. Nothing on our side touched it. Until the following morning we were watching your 165 automations for changes but not the documents that decide what your business actually says, which was a gap.\",\n },\n {\n at: \"2026-08-05\",\n kind: \"built\",\n what: \"Your knowledge bases are now watched the same way your automations are. If one of them changes, it gets written down with what moved and when, whoever did it.\",\n evidence: \"Running live. It cannot read the wording inside the documents, only that something changed and which one, so it will not police your writing. The part that spots a change is tested on its own, including the case that matters most: a document edited in place, where nothing is added and nothing is removed.\",\n },\n {\n at: \"2026-08-05\",\n kind: \"mine\",\n what: \"The counter I built to prove the checker keeps its own time was itself broken, and it made a healthy system look dead. It recorded nothing for scheduled runs, so the page reported none had happened while they were happening every hour.\",\n evidence: \"Found by opening the running record rather than trusting my own counter: the scheduled runs were there, one line away from where I was looking. Both kinds of run have now been watched being recorded correctly, one of each, before this was written down.\",\n },\n {\n at: \"2026-08-05\",\n kind: \"fixed\",\n what: \"The two contact records for Kristina were merged into one, exactly as you asked. The phone number that survived is the one she actually rang from, the accidental do-not-disturb is off, her Meet and Greet is untouched, and the typo number is gone.\",\n evidence: \"Her inbound call that morning proves which number is real, so that one was kept. The duplicate had also been dropped into the no-sale and tips nurtures, which would have messaged a person who has an appointment booked on Monday; those did not carry over, and one click puts them back if wanted.\",\n },\n {\n at: \"2026-08-05\",\n kind: \"built\",\n what: \"The first two real puppy inquiries are marked and waiting: Walle's owner, whose Pup Talk was that afternoon, and Kristina, who was marked that morning. Nothing sends to either of them while practice mode is on, and the system deliberately stays quiet for anyone with a call still on the calendar.\",\n evidence: \"Both are visible in the count on this page, which reads your records live. The one switch that remains is the practice-mode switch, and that gets thrown deliberately, not quietly.\",\n },\n {\n at: \"2026-08-05\",\n kind: \"changed\",\n what: \"Walle's owner came off the puppy track before it ever sent her anything, and that is the agreed rule working: she booked. Her Free Training Day is on the calendar for Friday morning, her Pup Talk moved to Thursday afternoon, and during those changes the puppy mark came off her record. One inquiry is marked and waiting now, Kristina.\",\n evidence: \"Read live from her record on the evening of 5 August: the Friday booking is on the calendar, the mark is off, and the count on this page reflects whatever is true when you open it. If she should get the puppy messages after her visit anyway, putting the mark back is one click.\",\n },\n {\n at: \"2026-08-05\",\n kind: \"found\",\n what: \"The tag red flag turns out to be wired to a workflow that came with your system: anyone who gets that tag is switched to do-not-disturb. It was put on five people this week, and all five are on do-not-disturb right now, which means nothing will message them.\",\n evidence: \"Each of the five records was opened and read live on the evening of 5 August, and every one shows do-not-disturb on. They are listed by name in the tag report. Taking the tag off does not switch do-not-disturb back off on its own.\",\n },\n {\n at: \"2026-08-07\",\n kind: \"mine\",\n what: \"Two customers could have dropped off your deposit list without anything looking wrong. You have two boarding calendars because a customer can be on either one, and the list is both of them put together. If one calendar failed to answer — a bad connection is enough, and there was no retry — the shorter list was saved over the full one with a fresh timestamp. Anyone who only appears on the calendar that failed was not marked unknown. They were simply gone.\",\n evidence: \"Reproduced end to end before it was fixed: a run reading one of the two calendars dropped a real customer and was still accepted for saving. It now refuses to replace a saved list with one that saw fewer calendars, so the page goes visibly older instead of quietly shorter. A calendar you actually delete still saves normally, and the first run of all still saves even if a calendar is down, because a partial list with a warning on it beats no list.\",\n },\n {\n at: \"2026-08-07\",\n kind: \"mine\",\n what: \"Where two of your bookings sat on the same day, which one the deposit counted against was decided by the order the bookings happened to come back in. Nothing was ever double counted, but a row could move between 'Payment on file' and 'Worth a look' from one hour to the next with nothing changing on your account. The oldest payment now settles the oldest stay, every time.\",\n evidence: \"Found by shuffling the same customer's bookings and payments 841,000 times and comparing the answers. It also fixed a second case: two deposits paid weeks apart, where spending the newer one first left the later stay looking unpaid when it had been paid all along.\",\n },\n {\n at: \"2026-08-07\",\n kind: \"mine\",\n what: \"The deposit page said a missing deposit might have been paid by cash. Your money page lists four ways to pay and cash is not one of them, so that was sending you to look somewhere that does not exist. It names Venmo, Zelle and cheque now, which are the three your card system genuinely cannot see.\",\n evidence: \"Checked against your own money page, which lists Card, Venmo, Zelle and Cheque and nothing else.\",\n },\n {\n at: \"2026-08-08\",\n kind: \"mine\",\n what: \"Friday's report said 120 of your 149 new people had no source recorded and none came from Facebook. That was wrong, and it was wrong because it read the one box in your CRM that is usually empty instead of the ad-tracking record that sits on every one of them. The truth: 117 of the 149 came from Facebook and 10 more from Instagram, and most carry the exact ad that brought them in. A corrected report is owed and coming.\",\n evidence: \"Re-pulled twice on 9 August by two people working separately, from two different doors into your CRM, and the two answers matched to the digit: 117 Facebook, 10 Instagram, none without a tracking record.\",\n },\n {\n at: \"2026-08-08\",\n kind: \"built\",\n what: \"The Friday report went over: what the ads cost, what came in, and where the money side still cannot be answered from your CRM. One line in it was wrong and was corrected the same night, and that correction is the entry above.\",\n evidence: \"Sent on Upwork Friday 11:46 PM with the five page report attached at 12:03. Both are in the thread.\",\n },\n {\n at: \"2026-08-09\",\n kind: \"built\",\n what: \"Facebook finally lets this page read your ad spend. The permission that was missing since the connection was first built is granted, so the advertising card below now shows real dollars from Facebook's own records every time the page loads, instead of saying it is not allowed to look.\",\n evidence: \"Watched working today: the page read $671.72 of spend and 159 started conversations for the last 7 full days, straight from the ad platform, minutes after the permission went on.\",\n },\n {\n at: \"2026-08-09\",\n kind: \"changed\",\n what: \"Your Wednesday answers are in the copy. Message two now opens on the welcome instead of 'I got your message'. Nothing says 'pitch' anymore, it just says what a Pup Talk is. The 'I won't chase you' lines are gone and the 'call any time' lines stay. 'Getting on' reads 'going'. The July and August notes carry the water warning for hot days, and August mentions school going back.\",\n evidence: \"Each change is pinned by its own automated check, so the wording cannot quietly drift back. The two write-ups you have were regenerated from the changed copy today.\",\n },\n {\n at: \"2026-08-09\",\n kind: \"found\",\n what: \"You asked Thursday for two calendars, a Free Training Day pick up and a second Pup Talk calendar for Candace, both by Tuesday. Then Friday evening you and Kristian agreed nothing changes in calendars or workflows until his handover is checked and written down. Those two collide, so the calendars wait for your word rather than being built into a freeze you asked for.\",\n evidence: \"Both are in writing: your Thursday messages on Upwork, and the Friday emails where the freeze was agreed.\",\n },\n {\n at: \"2026-08-06\",\n kind: \"built\",\n what: \"The deposit list keeps itself up to date on its own now. It checked itself at 21:49 that evening with nobody asking it to, and it will do that every hour.\",\n evidence: \"Watched, not assumed. It refreshed by itself at 20:49 and again at 21:49 on 6 August, and the page records which schedule did it so there is no guessing. If a refresh ever fails, the page says how long ago it last managed one and warns you before you act on a name that might be a day old.\",\n },\n {\n at: \"2026-08-06\",\n kind: \"mine\",\n what: \"I had the deposit check charging $50 a stay. Your own money page says $50 per dog, and it was sitting in the handover pack the whole time. Jeffrey Musselwhite has three dogs in over Thanksgiving: that is $150, and one $50 payment would have marked the whole stay settled and taken him off your list.\",\n evidence: \"Fixed and checked against your live account at 20:31 on 6 August. His row now reads $150.00, three dogs at $50. It settles on one payment for the full amount, or on one $50 payment per dog, and on nothing else.\",\n },\n {\n at: \"2026-08-06\",\n kind: \"mine\",\n what: \"The deposit page was telling you a missing deposit might have been paid in cash or over the phone. Your website takes Venmo, Zelle and cheques as well, and none of those reach the card system either. It now names all three, because knowing where else to look is the difference between a ten-second check and a phone call.\",\n evidence: \"Taken from your own money page: card is the only route that matches itself to a customer record automatically. Venmo, Zelle to your email address, and cheques by post all land somewhere this cannot see.\",\n },\n {\n at: \"2026-08-06\",\n kind: \"built\",\n what: \"The holiday deposit check you asked for is on your page. It reads both boarding calendars for Thanksgiving week and 20 December to 2 January, puts one customer's dogs on one line, leaves out your regular weekly bookings and anything cancelled, and shows which stays have a card payment on file. Right now that is two stays, both worth a look.\",\n evidence: \"It ran against your live account at 15:42 on 6 August and the list came back in under three seconds. Jeffrey Musselwhite's three dogs on 25 November show as one stay, not three, and Enzo's standing Friday slot is left out even though it lands inside every holiday window. It will never say somebody has not paid: a deposit handed over in cash or taken on the phone does not reach the card system, so this is a shortlist to look at.\",\n },\n {\n at: \"2026-08-06\",\n kind: \"found\",\n what: \"Your card payments do reach your CRM after all, in two different shapes, and one of them was invisible to me until that morning. Some land as a plain payment line; others land as a till payment matched to a card payment later. I had only been reading the first kind.\",\n evidence: \"Both shapes are sitting on the same customer's record right now with the same $35 on them and two different reference numbers. If somebody's only record had been the second kind, the deposit check would have shown them as having nothing on file. It reads both now, and where the same money appears twice it is counted once rather than doubled.\",\n },\n {\n at: \"2026-08-06\",\n kind: \"mine\",\n what: \"Twice today I had the deposit check guessing which card payment was the deposit, and twice it was wrong in the direction that costs you money. The first version treated any payment between the booking and the stay as the deposit, so a customer's $355 training package marked their $50 as settled. The second only looked at the ten days around the booking, which then missed a real $50 paid eight days later.\",\n evidence: \"It has stopped guessing. A stay is only marked settled by a card payment for exactly $50. Everything else on the account near that stay is listed with its date and amount and left for you to judge, which is the two-second version of what you were doing by hand. A wrong 'worth a look' costs you a glance. A wrong 'settled' costs you fifty dollars and you never find out.\",\n },\n {\n at: \"2026-08-06\",\n kind: \"built\",\n what: \"The deposit list now knows how long a stay actually is, by reading your pick-up calendars as well as your drop-off ones. Jeffrey's three dogs show as 25 to 28 November rather than a single day, and anybody who drops off before a holiday and stays through it now appears at all.\",\n evidence: \"A drop-off booking in your system is a ten minute slot, so on its own it cannot say how long a dog stays. Checked against your live calendars on 6 August: Ghost and Chewy drop off on the 25th and are collected on the 28th, and only the pick-up calendar says so. If a pick-up calendar does not answer, the page says so rather than quietly showing a shorter list.\",\n },\n {\n at: \"2026-08-06\",\n kind: \"mine\",\n what: \"The first time the deposit check ran for real it was about to tell you your card payments had stopped working, on the strength of two customers with nothing on file. Two quiet customers is a normal week, not an outage. I had written the warning to fire whenever nobody at all had a payment, without asking how many people that was.\",\n evidence: \"Caught by watching the first live run at 15:41 on 6 August rather than by reading the code. It now needs at least five customers checked before it will suggest anything is wrong with the payment feed, and the second run at 15:42 gave you the plain list instead of the warning.\",\n },\n {\n at: \"2026-08-06\",\n kind: \"mine\",\n what: \"I told you the customer chased after booking was the only one it had ever happened to. That was wrong, and I said it with more confidence than my checking deserved. Four people were chased after they had already booked, going back to April: Brianna Badger, Janiya Williams, Michelle Burkard and Thomas.\",\n evidence: \"The first answer came from looking at two people with upcoming bookings. The real one comes from every Free Training Day booking you have ever taken, 80 of them across 69 people, each checked against their own messages. Three of the four came to their session anyway. Michelle's first booking was cancelled after her chase and she rebooked five days later, which is an order of events rather than a proven cause.\",\n },\n {\n at: \"2026-08-06\",\n kind: \"found\",\n what: \"Your missing call transcripts, with one thing I got ahead of myself on. No transcript exists on any call older than about three months, and since then almost everything with speech on it has been written down. I told you that was the date transcription got switched on. I cannot actually tell that from here.\",\n evidence: \"207 calls were opened one at a time, everything inside your hundred most recently active conversations, and each was asked directly for its transcript and its recording. Before 11 May: 45 calls, none transcribed, though 38 of them still play their audio. From 11 May: 162 calls, 127 transcribed. Of the 35 without, 31 were nobody answering and 2 failed to connect. In that sample one call was recorded and never written down, on 4 August at 11:09 in the morning. The honest part: the oldest transcript we can find is 87 days old, which is either the day it was switched on or the age at which transcripts get deleted. Those look identical from here. If they expire, you are losing a month of call history every month, so it matters. One query in a week settles it: if the oldest surviving transcript has moved forward, they expire. That check is now on the list.\",\n },\n {\n at: \"2026-08-06\",\n kind: \"built\",\n what: \"While practice mode is on, the parts that actually send a text or an email now refuse anyone except the single test record, and they refuse from a standing start rather than after being told who is safe.\",\n evidence: \"The refusal sits inside the sending functions themselves, so it holds even if something upstream enrolled the wrong person by mistake. It is switched on and running now. There is a test that proves it, and a second check that deletes the guard on purpose and demands that test go red.\",\n },\n {\n at: \"2026-08-05\",\n kind: \"fixed\",\n what: \"A customer who had already booked his Free Training Day got chased by an older funnel to book one, two texts, a voicemail and another text, because that funnel only counts bookings made through its own page and cannot see the calendar. He was taken out of it at half past six that evening.\",\n evidence: \"His record shows no active workflows since the removal, checked after a full page reload. At the time this was written I had checked the two other people with upcoming bookings and found them clean. That was too small a check to carry the sentence it was carrying, and the entry above from 6 August corrects it: four people have been chased after booking, not one. The follow-up system on this page had nothing to do with it: practice mode was on all day and it sent nothing, checked live the same evening.\",\n },\n // THE GO-LIVE. Written 14 Aug 2026, dated to the day it happened. The 5 August entry above,\n // which says nothing sends while practice mode is on, is left exactly as it was: it was true on\n // 5 August and a work log that edits its own past is not a work log. This is its successor.\n {\n at: \"2026-08-11\",\n kind: \"changed\",\n what: \"The puppy follow-up system came out of practice mode and went live on the evening of 11 August, with your written go-ahead that day, and it has been sending to real people ever since. Two people joined it that evening and both have since had the first two messages. The 5 August note saying nothing sends to anybody while practice mode is on was true on 5 August; this is where it stopped being true.\",\n evidence: \"Open your control panel and the banner across the top says the word LIVE where it used to say PRACTICE MODE. It reads that from the system's own record every time the page loads, so it is not a note somebody typed and forgot. Both of those two people joined at 5:25 in the afternoon on 11 August, Georgia time. To see the messages rather than take my word for it, open either of them in Conversations in your CRM: the texts are sitting in the thread with the date and time on each one.\",\n },\n {\n at: \"2026-08-14\",\n kind: \"mine\",\n what: \"For three days after it went live, this page kept telling you it had not been switched on. Four things on it said so: the question card asking when we should do the switch-on together, the line under the wording question saying it still does not send, the line under the domain question saying texting can still go live on its own, and the line at the very top saying three questions were holding up go-live. All four were written before 11 August and not one of them was rewritten when the day came. They are corrected now, and what actually happened is the 11 August entry.\",\n evidence: \"The system's own record has read live rather than practice since 11 August, and the last message to each of those two people went out on 12 August, so the page was disagreeing with the machine it was describing for three days in writing to you. The four sentences are named above rather than quietly swapped out, because you should be able to hold what you read earlier in the week against what this page says now. Nothing was sent or held back because of the wording; what it cost you was three days of not being able to trust the page.\",\n },\n {\n at: \"2026-08-14\",\n kind: \"mine\",\n what: \"Your control panel could tell you the follow-up system was not running when it was running perfectly. It used to expect a check four times an hour, so any gap past an hour turned the top of that page red and told you to call Amir. The system actually checks about once an hour, and the ordinary gap between checks runs a few minutes either side of that, so the red could appear for a minute or two and clear itself with nothing wrong.\",\n evidence: \"Measured from the system's own list of when it last checked itself, which your control panel already shows: over the most recent 39 gaps the longest was 64 minutes, and four of them ran past the point where the old warning would have fired, for about five minutes in total. It now waits for two checks to be missed before it says anything, and the sentence it prints says once an hour rather than the old wrong number.\",\n },\n // 14 AUGUST, SECOND PASS. Everything below was found by reading the live control panel line by\n // line and holding each sentence against the code that decides it. Four of them were instructions\n // to Kim that would not have worked, and those are the ones that matter: a wrong number on a page\n // is embarrassing, but an instruction that does nothing costs her an afternoon and her trust.\n {\n at: \"2026-08-14\",\n kind: \"mine\",\n what: \"The tile on your control panel that counts people the system could not reach told you to fix their details in your CRM. Doing that would have changed nothing. Once the system had given up on somebody, nothing you could do put them back on the follow-up: they were locked out for 60 days no matter what you fixed. The way back in now works, and the tile tells you the three steps in the order that works.\",\n evidence: \"The tile reads zero today, so nobody has been left stuck by this. It was found by reading the enrolment code rather than by waiting for it to bite: the check that decides who may join skipped anybody the system already had a record of, and that record is exactly what it writes when it gives up. Amir has since changed the engine so that fixing the record and re-tagging really does bring somebody back, and there is an automated check that breaks on purpose if that stops being true. The order matters and the tile now says so: put a phone number or an email address on the record first, then take the tag off, because doing it the other way round looks like nothing happened.\",\n },\n {\n at: \"2026-08-14\",\n kind: \"mine\",\n what: \"The same tile also told you it never resets. It does reset: the system clears somebody out 60 days after it stopped trying to reach them, and the count comes down then. It now says that instead.\",\n evidence: \"The 60 days is in the housekeeping step the system runs at the end of every check, and there is an automated check that fails if that step is ever removed. What the old sentence was reaching for is still true and still said: unlike the Problems today tile beside it, this one does not go back to zero at midnight.\",\n },\n {\n at: \"2026-08-14\",\n kind: \"mine\",\n what: \"The instruction on your control panel for taking one person off every track was wrong in two ways. It said switching on Do Not Disturb takes them off everything, permanently, within about an hour. Your CRM has three Do Not Disturb switches on a contact, not one: a main one, and separate ones for texts and for emails. Only the main one stops everything, and the other two stop just the thing they name, so switching off texts would have left the emails running. The hour was wrong too: the system does not look at somebody again until their next message is due, which can be up to a day.\",\n evidence: \"Your own contact records are the reason this was worth correcting rather than a hypothetical: several of them carry the texts-only switch turned on while the main switch is off, which is the exact combination the old sentence got wrong. Nobody was messaged in the gap, and nobody could have been, because the only moment the system would send to a person is the same moment it re-reads their switches, so this cost you nothing and was still not true. Both points are now spelled out on the page, including which switch is the one that stops everything.\",\n },\n {\n at: \"2026-08-14\",\n kind: \"mine\",\n what: \"Your list of the last things the system did had been taken over by one line repeating. 39 of the 40 rows were the same sentence, once an hour for two days: one person who already has a booking, being passed over again on every check. Everything else the system had done was pushed off the end of the page where you could not see it. Repeats are now folded into a single row that says how many times and over what period, and the page states the sum so you can check nothing was dropped.\",\n evidence: \"You can see this for yourself against what the page looked like on 13 August: the same table now shows the repeat once, with its count, and the note under it says how many rows and how many folded repeats add up to how many entries. Amir has separately stopped the system writing the same line over and over in the first place, so the list fills up with real history from here. The list also now shows times in Georgia time; before this it printed them four hours ahead, so a message sent at five in the afternoon read as nine at night.\",\n },\n {\n at: \"2026-08-14\",\n kind: \"changed\",\n what: \"The shouting is gone from your control panel. Every heading on it was being forced into capitals, and the banner said RUNNING NORMALLY, so you asked us to stop. Headings and labels are in ordinary sentence case now.\",\n evidence: \"It was one line of styling turning all of the headings into capitals rather than anything typed that way, which is why it was consistent and why fixing it fixed all of them at once. The two words spelled FAILED in the middle of a sentence were typed, and those are corrected separately.\",\n },\n {\n at: \"2026-08-14\",\n kind: \"fixed\",\n what: \"Your status page was one failed read away from telling you the follow-up was still in practice mode. It would only have shown while nobody was partway through the sequence, which is why it had not happened yet, and it was the same false sentence you were shown from 11 to 14 August arriving by a different route. The page can now say it does not know, and says that instead of guessing.\",\n evidence: \"It was found by reading the page's own logic rather than by it happening to you: the box that names practice or live was already careful, but the paragraph two lines under it was reading a different record and defaulting to practice when that record did not answer. Both now depend on the same check. There is an automated test that puts the page in exactly that state and demands it say it could not tell, and a second check that removes the fix on purpose and requires the first one to go red.\",\n },\n];\n\nexport function mergeLog(seeded: WorkEntry[], live: WorkEntry[] | null | undefined): WorkEntry[] {\n const all = [...seeded, ...(Array.isArray(live) ? live : [])];\n const seen = new Set();\n const out: WorkEntry[] = [];\n for (const e of all) {\n if (!e || typeof e.at !== \"string\" || typeof e.what !== \"string\" || !e.what.trim()) continue;\n // v1.1 (review #6): dedupe on the FULL sentence. A 60-character prefix collapsed two\n // different outages on the same day into one row, so the second incident never reached Kim.\n const key = `${e.at}|${e.kind}|${e.what}|${e.evidence ?? \"\"}`;\n if (seen.has(key)) continue;\n seen.add(key);\n out.push(e);\n }\n // newest first. Within one day the LATEST-added entry leads, so a broke/recovered pair on the\n // same date reads \"back to normal\" above \"broke\", which is the order a human wants to see.\n return out\n .map((e, i) => ({ e, i }))\n .sort((a, b) => (a.e.at === b.e.at ? b.i - a.i : (b.e.at > a.e.at ? 1 : -1)))\n .map((x) => x.e);\n}\n\nexport const KIND_LABEL: Record = {\n mine: \"My mistake\",\n fixed: \"Fixed\",\n built: \"Built\",\n found: \"Found\",\n broke: \"Broke\",\n recovered: \"Back to normal\",\n changed: \"Changed\",\n};\n","label",[186],"5124a7e0-2efc-42c2-8068-dc5528c65154","watch.ts","ff74119a-9822-11f1-b353-1607ee4eb77e",1230,["D",1787226707632],4,"// THE EARLY WARNING MONITOR. v1.0, 12 Aug 2026. Rebuilt 14 Aug 2026 from tests/watch.test.mjs.\n//\n// WHAT THIS IS FOR. On 19 February 2026 this account's CRM stopped recording payment amounts.\n// Bookings carried on arriving at full volume; the dollars written against them went to zero.\n// Nothing failed, so nothing errored, so nothing alerted, and every count on every page stayed\n// healthy. It ran for five months and cost a five-figure sum before a human happened to look.\n//\n// THE RULE THAT FOLLOWS FROM THAT (LESSONS #12): an absence raises no error, so something has to\n// watch the place where a thing used to be. Volume and value are watched TOGETHER, because either\n// one on its own reads as an ordinary business having an ordinary month.\n//\n// FIVE CHECKS, EACH MEASURED AGAINST THE SOURCE'S OWN HISTORY rather than against a number\n// somebody typed:\n// 1. silenceFindings a source that normally produces records has produced none for\n// longer than its own normal quiet spell.\n// 2. matchRatioFindings payments still arriving, the matched share collapsing against its\n// own recent baseline.\n// 3. revenueChannelFindings activity continuing while the money against it goes to zero. This\n// is the February shape, and it is the reason the file exists.\n// 4. bridgeFindings the Square link erroring now, or its journal no longer growing.\n// 5. backwardsFindings a figure that can only ever grow has gone backwards, which usually\n// means a source was swapped, truncated, or read from somewhere else.\n//\n// THREE DESIGN RULES THIS FILE IS BUILT AROUND, each of them paid for:\n//\n// A CHECK THAT INSPECTED ZERO ITEMS RAISES A FINDING ABOUT ITSELF (LESSONS #2). This project has\n// already shipped an audit that scanned zero files and reported all clear. On a monitor that is\n// worse than useless: \"nothing wrong\" and \"nothing looked at\" render identically on the page, and\n// the second one reads as reassurance. So every check returns the size of what it read, every\n// check that read nothing says so in an urgent finding, and blindSpots() is the backstop that\n// refuses to let a silent zero through.\n//\n// A BASELINE BELOW A MINIMUM POPULATION SAYS \"CANNOT JUDGE\" OUT LOUD (LESSONS #13). Replayed\n// against the real history as it stood on 15 March 2026 the revenue check fired and produced\n// \"47 bookings were recorded, which is the same as usual or more, and the money came to $50.00.\n// Over the 6 periods before it the usual figures were 2 bookings and $550.00.\" The arithmetic was\n// right and the sentence was nonsense, because the baseline was this account's first weeks in the\n// CRM. A sentence that reads as a glitch spends the credibility the real alarm will need, so a\n// thin baseline is declared unjudgeable rather than either accusing or passing.\n//\n// EVERY SENTENCE IS GENERATED FROM THE VALUES IT DESCRIBES (engine/facts.ts, header). Nothing in\n// here types a figure alongside the number it is meant to describe. Change an input and the words\n// move with it, or the two can silently disagree, which is how every wrong claim in this project\n// got out.\n//\n// CLIENT COPY RULES, enforced mechanically by copyProblems() over the generated report: no dashes\n// used as punctuation, and never the name of a service this business does not offer.\n//\n// READ ONLY. Nothing in this file fetches, writes, deploys or schedules anything. It is handed\n// data by scripts/watch-run.mjs and hands back a report.\n\n// ---------------------------------------------------------------------------------------------\n// THE SHAPES\n// ---------------------------------------------------------------------------------------------\n\n/** urgent: look today. attention: look this week. note: the monitor talking about itself. */\nexport type Severity = \"urgent\" | \"attention\" | \"note\";\n\nexport type Finding = {\n check: string; // which check raised it, so the report can group them\n severity: Severity;\n sentence: string; // plain words, generated from `numbers`, safe to send\n numbers: Record; // the figures the sentence was built from\n checkFirst: string; // the first thing to open, in her words not mine\n};\n\nexport type CheckResult = {\n check: string;\n title: string; // how the check is named in the report\n inspected: number; // HOW MUCH IT READ. Zero is a finding, never a pass.\n inspectedLabel: string; // what those items are, for the sentence that reports it\n measured: Record; // the workings, kept so a queried figure can be traced\n findings: Finding[];\n};\n\nexport type WatchReport = {\n generatedAt: string;\n headline: string;\n inspected: number;\n checks: CheckResult[];\n findings: Finding[];\n};\n\nexport type Stream = { name: string; timestamps: unknown; whereToLook?: string };\nexport type RatioPoint = { label?: string; endMs?: number; total: number; matched: number };\nexport type RevenuePeriod = { label?: string; endMs?: number; activity: number; dollars: number };\nexport type Snapshot = { at?: string; counters?: Record };\n\nexport type WatchInput = {\n nowMs?: unknown;\n streams?: unknown;\n ratio?: { subject?: string; points?: unknown } | null;\n revenue?: { subject?: string; periods?: unknown } | null;\n journal?: unknown;\n snapshots?: unknown;\n counterLabels?: Record | null;\n};\n\nconst HOUR = 3_600_000;\n\n// ---------------------------------------------------------------------------------------------\n// THE CONSTANTS, and why each one is the number it is. Every one of these is a judgement about\n// how loud this thing should be, so each is named, exported and testable rather than buried at a\n// call site where nobody can find it to argue with it.\n// ---------------------------------------------------------------------------------------------\n\n/** Below this many records a source has no rhythm worth quoting, and saying so is the honest move. */\nexport const MIN_RECORDS_FOR_RHYTHM = 5;\n\n/**\n * Only the most recent gaps are measured. A source that changes pace has to be able to\n * re-baseline: the payment feed moved from weekly invoicing to daily card takings in June, and a\n * rhythm averaged over all of history would still be judging today against a habit it dropped.\n */\nexport const MAX_GAPS_CONSIDERED = 30;\n\n/**\n * THE QUIET SPELL, not the longest outage. Read against the MAXIMUM gap in history, one bad\n * fortnight silently raises the bar past which any future outage would be reported: the next one\n * has to beat a record before anybody hears about it. The 90th percentile says \"longer than\n * almost every quiet spell this source normally has\" and cannot be dragged by a single hole.\n */\nexport const QUIET_QUANTILE = 0.9;\nexport const QUIET_MULTIPLE = 1.5; // half again past its own worst ordinary silence\nexport const NORMAL_MULTIPLE = 3; // or three times its ordinary gap, whichever is longer\n\n/**\n * THE OVERNIGHT FLOOR. New contact records arrive about every 25 minutes during the day and stop\n * at night. Judged on gaps alone that source is \"silent for twenty times its normal gap\" at 3am\n * every single night, and a report that cries wolf every morning is a report nobody opens on the\n * morning it is right. 26 hours clears a night, a weekend morning and a public holiday opening.\n */\nexport const MIN_EXPECT_HOURS = 26;\n\n/** Twice past the point where it became out of character is today's problem, not this week's. */\nexport const URGENT_MULTIPLE = 2;\n\n/** A collapse is a third of the baseline share gone AND ten points of it in absolute terms. */\nexport const RATIO_RELATIVE_FALL = 0.33;\nexport const RATIO_ABSOLUTE_FALL = 0.1;\n/** Half the baseline share gone is not a wobble, it is a fault, and it is today's problem. */\nexport const RATIO_URGENT_RELATIVE_FALL = 0.5;\n/** A verdict on two payments is not a verdict. Below this the check says so instead. */\nexport const RATIO_MIN_LATEST = 5;\n\n/** Four fifths of the usual money gone. A half is a trading question; this is a plumbing one. */\nexport const REVENUE_DOLLAR_FALL = 0.8;\n/** ...while at least half the usual amount of work still arrived. Both halves, or it is a slow month. */\nexport const REVENUE_ACTIVITY_HELD = 0.5;\n/** LESSONS #13. A baseline of two records a period cannot carry an accusation. */\nexport const REVENUE_MIN_BASELINE_ACTIVITY = 5;\n/** Fewer periods than this and there is no \"usual\" to compare the latest one against. */\nexport const REVENUE_MIN_PERIODS = 4;\n\n/**\n * The bridge is judged on its RECENT rows only. This journal holds 265 failures from three bad\n * days in July that were found and fixed. A check that fires on any error ever recorded is red\n * forever, and a permanently red check is a switched off one.\n */\nexport const BRIDGE_RECENT_ROWS = 100;\nexport const BRIDGE_ERROR_SHARE_URGENT = 0.2;\n\n// ---------------------------------------------------------------------------------------------\n// SAYING THINGS. Every one of these turns a value into words. Nothing below ever types a figure\n// beside the number it describes, which is the whole of engine/facts.ts in one rule.\n// ---------------------------------------------------------------------------------------------\n\nconst MONTH_NAMES = [\"January\", \"February\", \"March\", \"April\", \"May\", \"June\",\n \"July\", \"August\", \"September\", \"October\", \"November\", \"December\"];\n\n/** A duration in words that fit its size: minutes for an hour, hours for a day, days beyond that. */\nexport function sayGap(hours: unknown): string {\n const h = Number(hours);\n if (!Number.isFinite(h)) return \"an unknown length of time\";\n if (h <= 1) return `${Math.round(h * 60)} minutes`;\n if (h < 48) return `${Math.round(h)} hours`;\n const days = Math.round(h / 24);\n if (days < 60) return `${days} days`;\n // Past two months \"97 days\" stops meaning anything to a reader, so the months are said too.\n // Both figures, never the months alone: the day count is the one that can be checked.\n const months = Math.round(days / 30.44);\n return `${days} days, which is about ${months} months`;\n}\n\n/** A date a person can read, in UTC so a replay of a past morning says the same thing every time. */\nexport function sayDate(ms: unknown): string {\n const t = Number(ms);\n if (!Number.isFinite(t)) return \"a date this could not read\";\n const d = new Date(t);\n if (Number.isNaN(d.getTime())) return \"a date this could not read\";\n return `${d.getUTCDate()} ${MONTH_NAMES[d.getUTCMonth()]} ${d.getUTCFullYear()}`;\n}\n\n/** Money, always to the cent and always with its thousands separators. */\nexport function money(n: unknown): string {\n const v = Number(n);\n if (!Number.isFinite(v)) return \"an amount this could not read\";\n const [whole, frac] = Math.abs(v).toFixed(2).split(\".\");\n return `${v < 0 ? \"minus \" : \"\"}$${whole.replace(/\\B(?=(\\d{3})+(?!\\d))/g, \",\")}.${frac}`;\n}\n\nconst WORDS = [\"no\", \"one\", \"two\", \"three\", \"four\", \"five\", \"six\", \"seven\", \"eight\", \"nine\", \"ten\"];\nconst countWord = (n: number) => WORDS[n] ?? String(n);\nconst capitalise = (s: string) => s.replace(/^./, (c) => c.toUpperCase());\nconst plural = (n: number, one: string, many: string) => (n === 1 ? one : many);\nconst commas = (n: number) => Number(n ?? 0).toLocaleString(\"en-US\");\nconst percent = (x: number) => `${Math.round(x * 100)}%`;\n\n/** The subject as a bare noun: \"your bookings\" is what she calls them, \"bookings\" is what counts them. */\nconst unitOf = (subject: string) => String(subject ?? \"records\").replace(/^(your|the)\\s+/i, \"\");\n\n// ---------------------------------------------------------------------------------------------\n// THE MEASUREMENT. A rhythm read off the source itself.\n//\n// Everything else in this file rests on this function, so it is worth saying what it deliberately\n// does NOT do. It does not take a threshold. It does not know what kind of source it is looking\n// at. It reads the gaps between the things that actually arrived and reports how long this source\n// normally goes quiet for. A monitor built on typed thresholds is a monitor that is wrong for\n// every source but the one somebody had in mind when they typed it.\n// ---------------------------------------------------------------------------------------------\n\nexport type Rhythm = {\n records: number; // how many readable timestamps went into this\n gapsUsed: number; // how many gaps the figures below were measured from\n normalGapH: number; // the median gap: what \"usually\" means for this source\n quietGapH: number; // its ordinary worst quiet spell, at the 90th percentile\n longestGapH: number; // the worst hole in the history it was given, reported and NOT used\n expectByH: number; // past this it is out of character for this source\n};\n\n/** Every readable timestamp in a list, as milliseconds, oldest first. Unreadable ones are dropped. */\nexport function readTimes(list: unknown): number[] {\n if (!Array.isArray(list)) return [];\n const out: number[] = [];\n for (const v of list) {\n // A number is already milliseconds; anything else has to survive Date.parse to count.\n const t = typeof v === \"number\" ? v : Date.parse(String(v ?? \"\"));\n if (Number.isFinite(t)) out.push(t as number);\n }\n // SORTED, ALWAYS. The live feed comes back newest first, fixtures come back oldest first, and a\n // jittered series is in neither order. Measuring gaps off an unsorted list produces negative\n // gaps and a median that means nothing.\n return out.sort((a, b) => a - b);\n}\n\n/**\n * The rhythm of a source, or null when there is not enough of it to have one.\n *\n * Null is a real answer here, not a failure: it is what makes \"there is not enough history to\n * judge this\" sayable out loud instead of being rounded to either an alarm or an all clear.\n */\nexport function rhythmOf(list: unknown): Rhythm | null {\n const times = readTimes(list);\n if (times.length < MIN_RECORDS_FOR_RHYTHM) return null;\n const allGaps: number[] = [];\n for (let i = 1; i < times.length; i++) allGaps.push((times[i] - times[i - 1]) / HOUR);\n if (!allGaps.length) return null;\n // RECENT HISTORY ONLY, so a source that changes pace re-baselines instead of being judged\n // forever against a habit it has dropped.\n const gaps = allGaps.slice(-MAX_GAPS_CONSIDERED);\n const normalGapH = quantile(gaps, 0.5) as number;\n const quietGapH = quantile(gaps, QUIET_QUANTILE) as number;\n // The longest gap is REPORTED so it can be looked at, and deliberately not used as the\n // yardstick. See QUIET_QUANTILE above for what happens when it is.\n const longestGapH = Math.max(...allGaps);\n const expectByH = Math.max(quietGapH * QUIET_MULTIPLE, normalGapH * NORMAL_MULTIPLE, MIN_EXPECT_HOURS);\n return { records: times.length, gapsUsed: gaps.length, normalGapH, quietGapH, longestGapH, expectByH };\n}\n\n/** The value at a quantile, interpolated. Null on an empty list, never a confident zero. */\nexport function quantile(values: number[], q: number): number | null {\n if (!Array.isArray(values) || !values.length) return null;\n const a = [...values].sort((x, y) => x - y);\n const pos = (a.length - 1) * q;\n const lo = Math.floor(pos);\n const hi = Math.ceil(pos);\n if (lo === hi) return a[lo];\n return a[lo] + (a[hi] - a[lo]) * (pos - lo);\n}\n\n/** urgent once it is twice past the point where it stopped being in character, attention before. */\nconst escalate = (ageH: number, expectByH: number): Severity =>\n (ageH >= expectByH * URGENT_MULTIPLE ? \"urgent\" : \"attention\");\n\n// ---------------------------------------------------------------------------------------------\n// A CHECK THAT READ NOTHING.\n//\n// This is the single most important function in the file, which is why it is this near the top.\n// Every check routes its empty case through it, so there is exactly one place where \"I inspected\n// nothing\" is turned into words, and exactly one place to break in order to prove the whole\n// arrangement still works (tests/negative-controls.mjs does exactly that).\n// ---------------------------------------------------------------------------------------------\nexport function blindCheck(check: string, title: string, inspectedLabel: string, why: string, checkFirst: string): CheckResult {\n return {\n check,\n title,\n inspected: 0,\n inspectedLabel,\n measured: { inspected: 0 },\n // SEVERITY STAYS \"urgent\" AND SIX TESTS HOLD IT THERE (W10, W19, W26, W31, W37, W42). A check\n // that read nothing must never be quiet. What was wrong was not the severity, it was the\n // HEADLINE: it counted blind spots as business problems and said \"two things need you to look at\n // today\" when both were unwired checks. That is fixed in headlineFor and in the section split\n // below, which separate \"a check found a fault\" from \"a check could not look\" WITHOUT making the\n // second one quiet. Relabelling this to \"note\" was tried on 16 Aug and the tests rejected it,\n // correctly: it is the guarantee, not the wording.\n findings: [{ check, severity: \"urgent\", sentence: why, numbers: { inspected: 0 }, checkFirst }],\n };\n}\n\n/**\n * THE BACKSTOP. Any check that inspected nothing and said nothing about it. This should always be\n * empty, because every check above routes its empty case through blindCheck. It is here because\n * \"should always be empty\" is exactly the kind of claim that quietly stops being true, and\n * scripts/watch-run.mjs refuses to write a report while this returns anything.\n */\nexport function blindSpots(checks: unknown): CheckResult[] {\n return (Array.isArray(checks) ? checks : []).filter((c) => c && c.inspected === 0 && (!c.findings || c.findings.length === 0));\n}\n\n/**\n * A finding is blind only when its owning check inspected no evidence. `finding.numbers` is\n * explanatory working supplied by the check and is deliberately not an authority boundary.\n */\nexport function isBlindFindingForChecks(finding: unknown, checks: unknown): finding is Finding {\n if (!finding || typeof finding !== \"object\" || Array.isArray(finding) || !Array.isArray(checks)) return false;\n const ownerName = (finding as { check?: unknown }).check;\n if (typeof ownerName !== \"string\") return false;\n return checks.some((candidate) =>\n !!candidate && typeof candidate === \"object\" && !Array.isArray(candidate) &&\n (candidate as { check?: unknown }).check === ownerName &&\n (candidate as { inspected?: unknown }).inspected === 0);\n}\n\n// ---------------------------------------------------------------------------------------------\n// CHECK 1: SILENCE WHERE THERE SHOULD BE NOISE. This is the 19 February check.\n//\n// A source that normally produces records has produced none for longer than it normally goes\n// quiet. Every source is judged against its own rhythm: the payment feed against the payment\n// feed's habits, the fortnightly form payments against the fortnightly form payments'. Judging\n// them all by one clock is how the fortnightly source becomes a false alarm every fortnight.\n// ---------------------------------------------------------------------------------------------\n\nconst SILENCE = \"silence\";\nconst SILENCE_TITLE = \"Sources that have gone quiet\";\nconst SILENCE_LABEL = \"timestamps\";\n\nexport function silenceFindings(streams: unknown, nowMs: unknown): CheckResult {\n const now = Number(nowMs);\n const list = (Array.isArray(streams) ? streams : []) as Stream[];\n const prepared = list.map((s) => ({\n name: String(s?.name ?? \"a source with no name\"),\n whereToLook: typeof s?.whereToLook === \"string\" ? s.whereToLook : null,\n times: readTimes(s?.timestamps),\n }));\n const inspected = prepared.reduce((a, s) => a + s.times.length, 0);\n\n if (!Number.isFinite(now) || inspected === 0) {\n return blindCheck(SILENCE, SILENCE_TITLE, SILENCE_LABEL,\n `This check read nothing at all, so it cannot tell you whether anything has stopped arriving. ` +\n `A check that inspects nothing is a blind spot, not a clean result, and it is being reported as one.`,\n `Check that the connection to your CRM is still working, then run this again. Until it reads something, ` +\n `treat the sources it was meant to watch as unwatched rather than healthy.`);\n }\n\n const findings: Finding[] = [];\n const perSource: Record[] = [];\n\n for (const s of prepared) {\n const r = rhythmOf(s.times);\n if (r === null) {\n // NOT A SILENT PASS. A source nothing can be measured on is a source nothing is watching,\n // and she should be told that in the same breath as she is told everything else is fine.\n findings.push({\n check: SILENCE,\n severity: \"note\",\n sentence:\n `There is not enough history for ${s.name} to say what normal looks like: ${s.times.length} ` +\n `${plural(s.times.length, \"record\", \"records\")}, where this needs ${MIN_RECORDS_FOR_RHYTHM} before it can ` +\n `measure a rhythm. Nothing is watching this source yet, which is worth knowing rather than reading as a clean result.`,\n numbers: { source: s.name, records: s.times.length, needed: MIN_RECORDS_FOR_RHYTHM },\n checkFirst:\n `Nothing to do today. Once ${MIN_RECORDS_FOR_RHYTHM} records have arrived here this will start ` +\n `watching it on its own, and until then treat it as unwatched.`,\n });\n perSource.push({ source: s.name, records: s.times.length, rhythm: \"not enough history\" });\n continue;\n }\n const lastMs = s.times[s.times.length - 1];\n const ageH = (now - lastMs) / HOUR;\n perSource.push({\n source: s.name,\n records: r.records,\n normalGapH: Math.round(r.normalGapH * 10) / 10,\n quietGapH: Math.round(r.quietGapH * 10) / 10,\n expectByH: Math.round(r.expectByH * 10) / 10,\n quietForHours: Math.round(ageH * 10) / 10,\n });\n if (ageH <= r.expectByH) continue;\n const severity = escalate(ageH, r.expectByH);\n // THE FIRST MOVE. A stream that knows where its own answer lives brings its own sentence:\n // scripts/watch-run.mjs hands the payment feed one, because that is the stream whose silence\n // means what February meant. Everything else gets this, which is the same move generalised.\n const checkFirst = s.whereToLook ??\n `Open the Square app and compare what it has taken since ${sayDate(lastMs)} against what your CRM shows for ` +\n `${s.name}. If Square has money the CRM does not, sales are being rung up in a way that never reaches a customer record.`;\n findings.push({\n check: SILENCE,\n severity,\n sentence:\n `Nothing has come through from ${s.name} for ${sayGap(ageH)}. The last one was on ${sayDate(lastMs)}. ` +\n `Before that this source produced something every ${sayGap(r.normalGapH)} on average, and the longest it ` +\n `normally stays quiet is ${sayGap(r.quietGapH)}, so this is well outside its own habits rather than outside ` +\n `a figure somebody chose.`,\n numbers: {\n source: s.name,\n lastRecordAt: new Date(lastMs).toISOString(),\n quietForHours: Math.round(ageH * 10) / 10,\n normalGapHours: Math.round(r.normalGapH * 10) / 10,\n quietGapHours: Math.round(r.quietGapH * 10) / 10,\n outOfCharacterAfterHours: Math.round(r.expectByH * 10) / 10,\n recordsMeasured: r.records,\n },\n checkFirst,\n });\n }\n\n return {\n check: SILENCE,\n title: SILENCE_TITLE,\n inspected,\n inspectedLabel: SILENCE_LABEL,\n measured: { sources: prepared.length, timestamps: inspected, perSource },\n findings,\n };\n}\n\n// ---------------------------------------------------------------------------------------------\n// CHECK 2: A RATIO COLLAPSE. Payments still arrive; the share of them reaching a customer record\n// falls away against its own recent baseline.\n//\n// THE TRAP THIS CHECK HAS TO AVOID, and the reason W17 exists: nought matched out of nought\n// arriving is not nought percent matching. Calling it a collapse raises a second alarm for one\n// fault and names the wrong cause, sending her to look at the matcher when the payments never\n// arrived at all.\n// ---------------------------------------------------------------------------------------------\n\nconst RATIO = \"match-ratio\";\nconst RATIO_TITLE = \"Payments reaching a customer record\";\nconst RATIO_LABEL = \"payments\";\n\nexport function matchRatioFindings(points: unknown, subject: unknown): CheckResult {\n const what = String(subject ?? \"payments\");\n const list = (Array.isArray(points) ? points : []) as RatioPoint[];\n const clean = list.map((p) => ({\n label: String(p?.label ?? \"a window\"),\n endMs: Number(p?.endMs),\n total: Math.max(0, Number(p?.total) || 0),\n matched: Math.max(0, Number(p?.matched) || 0),\n }));\n const inspected = clean.reduce((a, p) => a + p.total, 0);\n\n if (inspected === 0) {\n return blindCheck(RATIO, RATIO_TITLE, RATIO_LABEL,\n `This check read no ${what} at all, so it cannot tell you whether they are still reaching a customer record. ` +\n `A check that inspects nothing is a blind spot, not a clean result, and it is being reported as one.`,\n `Check that the Square link is still running and still writing to its own log, then run this again.`);\n }\n\n const latest = clean[clean.length - 1];\n const base = clean.slice(0, -1);\n const baseTotal = base.reduce((a, p) => a + p.total, 0);\n const baseMatched = base.reduce((a, p) => a + p.matched, 0);\n const measured: Record = {\n windows: clean.length,\n payments: inspected,\n latestTotal: latest.total,\n latestMatched: latest.matched,\n baselineTotal: baseTotal,\n baselineMatched: baseMatched,\n };\n const result = (findings: Finding[]): CheckResult =>\n ({ check: RATIO, title: RATIO_TITLE, inspected, inspectedLabel: RATIO_LABEL, measured, findings });\n\n if (baseTotal === 0) {\n return result([{\n check: RATIO,\n severity: \"note\",\n sentence:\n `There is no earlier run of ${what} to compare the latest ${commas(latest.total)} against, so this cannot ` +\n `judge whether the share reaching a customer record has moved. It will be able to from the next run on.`,\n numbers: { subject: what, latestTotal: latest.total, baselineTotal: baseTotal, windows: clean.length },\n checkFirst: `Nothing to do today. This needs one more period of history before it can say anything useful here.`,\n }]);\n }\n\n if (latest.total === 0) {\n // AN ABSENCE, DESCRIBED AS AN ABSENCE. Never as a collapse to nought percent.\n return result([{\n check: RATIO,\n severity: \"note\",\n sentence:\n `No ${what} arrived at all in the latest window, so there is nothing to work out a share from. ` +\n `That is a different problem from the ones this check watches for, and the list of sources that have gone ` +\n `quiet is where it will show up.`,\n numbers: { subject: what, latestTotal: 0, baselineTotal: baseTotal, windows: clean.length },\n checkFirst:\n `Look at the sources that have gone quiet, further up. If nothing there names ${what}, open the Square app ` +\n `and check whether any sale has been taken at all in the last week.`,\n }]);\n }\n\n if (latest.total < RATIO_MIN_LATEST) {\n // LESSONS #13, in its other shape. A verdict on two payments is not a verdict.\n return result([{\n check: RATIO,\n severity: \"note\",\n sentence:\n `Only ${commas(latest.total)} ${plural(latest.total, \"payment\", \"payments\")} arrived in the latest window, ` +\n `which is too few to judge a matching rate on. This needs at least ${RATIO_MIN_LATEST} before it will call ` +\n `a fall in the share reaching a customer record, because a wrong alarm here spends the attention a real one will need.`,\n numbers: { subject: what, latestTotal: latest.total, needed: RATIO_MIN_LATEST, baselineTotal: baseTotal },\n checkFirst: `Nothing to do today. This will judge the share again as soon as a normal week's worth of payments has arrived.`,\n }]);\n }\n\n const baseShare = baseMatched / baseTotal;\n const latestShare = latest.matched / latest.total;\n const relativeFall = baseShare > 0 ? (baseShare - latestShare) / baseShare : 0;\n const absoluteFall = baseShare - latestShare;\n const fires = relativeFall >= RATIO_RELATIVE_FALL && absoluteFall >= RATIO_ABSOLUTE_FALL;\n measured.baselineSharePercent = Math.round(baseShare * 100);\n measured.latestSharePercent = Math.round(latestShare * 100);\n if (!fires) return result([]);\n\n const latestUnmatched = latest.total - latest.matched;\n return result([{\n check: RATIO,\n severity: relativeFall >= RATIO_URGENT_RELATIVE_FALL ? \"urgent\" : \"attention\",\n sentence:\n `${capitalise(what)} are still arriving, and the share of them reaching a customer record has fallen from ` +\n `${percent(baseShare)} to ${percent(latestShare)}. In the latest window ${commas(latestUnmatched)} of ` +\n `${commas(latest.total)} reached nobody at all. The money is still being taken; it is the record of who paid it ` +\n `that is going missing.`,\n numbers: {\n subject: what,\n latestTotal: latest.total,\n latestMatched: latest.matched,\n latestUnmatched,\n latestSharePercent: Math.round(latestShare * 100),\n baselineSharePercent: Math.round(baseShare * 100),\n baselineTotal: baseTotal,\n windowsCompared: clean.length,\n },\n checkFirst:\n `Open the Square link's own log and look at the most recent entries for a sale that did not find a customer. ` +\n `The weekly exception report lists every one of them by name and amount, and that is the list to work from.`,\n }]);\n}\n\n// ---------------------------------------------------------------------------------------------\n// CHECK 3: A REVENUE CHANNEL GOING QUIET WHILE THE ACTIVITY CONTINUES. THE FEBRUARY SHAPE.\n//\n// This is the one the whole file exists for. Six ordinary periods of about 45 bookings and about\n// $7,000 taken, then a period in which the same number of bookings arrived and not one dollar was\n// recorded against them. The live account did exactly that: 48 payment records and $7,386.50 in\n// February, then 37 records and $0.00 in March, 21 and $0.00 in April, 18 and $0.00 in May.\n//\n// BOTH HALVES OR NOTHING. Money down and work down together is a slow month, which she can\n// already see out of the window, and raising it would be inventing an alarm about business\n// conditions. Money down while the work held is a plumbing fault, and she cannot see that at all.\n// ---------------------------------------------------------------------------------------------\n\nconst REVENUE = \"revenue-quiet\";\nconst REVENUE_TITLE = \"Money recorded against the work\";\nconst REVENUE_LABEL = \"records of activity\";\n\nexport function revenueChannelFindings(periods: unknown, subject: unknown): CheckResult {\n const what = String(subject ?? \"your bookings\");\n const unit = unitOf(what);\n const list = (Array.isArray(periods) ? periods : []) as RevenuePeriod[];\n const clean = list.map((p) => ({\n label: String(p?.label ?? \"a period\"),\n endMs: Number(p?.endMs),\n activity: Math.max(0, Number(p?.activity) || 0),\n dollars: Math.max(0, Number(p?.dollars) || 0),\n }));\n const inspected = clean.reduce((a, p) => a + p.activity, 0);\n\n if (inspected === 0) {\n return blindCheck(REVENUE, REVENUE_TITLE, REVENUE_LABEL,\n `This check read no record of any work at all, so it cannot tell you whether the money against it is being ` +\n `written down. A check that inspects nothing is a blind spot, not a clean result, and it is being reported as one.`,\n `Check that the connection to your CRM is still working, then run this again. This is the check that would ` +\n `have caught the five month gap, so it reading nothing matters more than most.`);\n }\n\n const latest = clean[clean.length - 1];\n const base = clean.slice(0, -1);\n const measured: Record = {\n periods: clean.length,\n recordsOfActivity: inspected,\n latestActivity: latest.activity,\n latestDollars: latest.dollars,\n };\n const result = (findings: Finding[]): CheckResult =>\n ({ check: REVENUE, title: REVENUE_TITLE, inspected, inspectedLabel: REVENUE_LABEL, measured, findings });\n\n if (clean.length < REVENUE_MIN_PERIODS) {\n return result([{\n check: REVENUE,\n severity: \"note\",\n sentence:\n `There are only ${clean.length} periods of history for ${what}, and this needs ${REVENUE_MIN_PERIODS} before ` +\n `it can say what a normal period looks like. It cannot judge the latest one yet, and guessing would be worse ` +\n `than saying so.`,\n numbers: { subject: what, periods: clean.length, needed: REVENUE_MIN_PERIODS },\n checkFirst: `Nothing to do today. This will start judging as soon as there are ${REVENUE_MIN_PERIODS} periods to read.`,\n }]);\n }\n\n // THE BASELINE IS A MEDIAN, not an average. One freak month with a $4,000 boarding block in it\n // drags an average up and makes every ordinary month afterwards look like a collapse.\n const baseActivity = quantile(base.map((p) => p.activity), 0.5) as number;\n const baseDollars = Math.round((quantile(base.map((p) => p.dollars), 0.5) as number) * 100) / 100;\n measured.usualActivity = Math.round(baseActivity);\n // Keep the exact median as validation evidence. The rounded value is client-facing, but it is\n // not precise enough to prove the 50% activity-held boundary on its own.\n measured.baselineActivity = baseActivity;\n measured.usualDollars = baseDollars;\n\n if (baseActivity < REVENUE_MIN_BASELINE_ACTIVITY) {\n // LESSONS #13, the sentence that reads as a glitch. Right arithmetic, no denominator.\n return result([{\n check: REVENUE,\n severity: \"note\",\n sentence:\n `Over the ${base.length} periods before the latest one, ${what} ran at about ${Math.round(baseActivity)} ` +\n `${unit} a period, which is too little to say what a normal period looks like. This cannot judge the latest ` +\n `period against a baseline that thin, and it would rather tell you so than put a figure in front of you that ` +\n `reads as a glitch.`,\n numbers: {\n subject: what,\n usualActivity: Math.round(baseActivity),\n needed: REVENUE_MIN_BASELINE_ACTIVITY,\n latestActivity: latest.activity,\n latestDollars: latest.dollars,\n periods: clean.length,\n },\n checkFirst:\n `Nothing to do today. Once this channel has run at ${REVENUE_MIN_BASELINE_ACTIVITY} or more records a period ` +\n `for a few periods, this will start judging it properly.`,\n }]);\n }\n\n if (!(baseDollars > 0)) {\n // THE HONEST LIMIT OF THIS CHECK, said out loud rather than left to be discovered. Once every\n // period in view is already at zero there is nothing left to fall from, and silence here would\n // read as a clean bill of health for the exact fault this check was built for.\n return result([{\n check: REVENUE,\n severity: \"note\",\n sentence:\n `Over the ${base.length} periods before the latest one, no money at all was recorded against ${what}, so there ` +\n `is no normal level for this one to have fallen from. This cannot judge whether anything is wrong here: a fault ` +\n `that has run long enough to become the baseline stops looking like a fall. Take this as the monitor saying it ` +\n `is blind on this channel, not as an all clear.`,\n numbers: {\n subject: what,\n usualDollars: baseDollars,\n latestActivity: latest.activity,\n latestDollars: latest.dollars,\n periods: clean.length,\n },\n checkFirst:\n `Open the Square app and total what it has taken over the last few months, then compare that with what your ` +\n `CRM shows for the same months. If Square has money the CRM does not, the two have been disconnected for ` +\n `longer than this report can see.`,\n }]);\n }\n\n const dollarFall = 1 - latest.dollars / baseDollars;\n const activityHeld = latest.activity >= baseActivity * REVENUE_ACTIVITY_HELD;\n measured.dollarFallPercent = Math.round(dollarFall * 100);\n measured.activityHeld = activityHeld;\n\n if (dollarFall < REVENUE_DOLLAR_FALL || !activityHeld) {\n return result([]);\n }\n\n const usualActivity = Math.round(baseActivity);\n const shareOfMoneyMissing = Math.round(dollarFall * 100);\n const heldPhrase = latest.activity >= baseActivity\n ? \"as many as usual or more\"\n : `${Math.round((latest.activity / baseActivity) * 100)}% of the usual number`;\n const sentence =\n `In the latest period ${commas(latest.activity)} ${unit} were recorded, which is ${heldPhrase}, ` +\n `and the money recorded against them came to ${money(latest.dollars)}. ` +\n `Over the ${base.length} periods before it the usual figures were ${commas(usualActivity)} ${unit} and ` +\n `${money(baseDollars)}. The work carried on and ${shareOfMoneyMissing}% of the money that normally comes with it ` +\n `was never written down, which means it is being taken somewhere your CRM never hears about.`;\n\n return result([{\n check: REVENUE,\n severity: \"urgent\",\n sentence,\n numbers: {\n subject: what,\n latestActivity: latest.activity,\n latestDollars: latest.dollars,\n usualActivity,\n usualDollars: baseDollars,\n shareOfMoneyMissing,\n periodsCompared: clean.length,\n },\n checkFirst:\n `Open the Square app and total what it has taken over the same period. If Square shows sales your CRM does not, ` +\n `sales are being rung up in a way that never reaches a customer record, which is exactly what happened after ` +\n `19 February 2026.`,\n }]);\n}\n\n// ---------------------------------------------------------------------------------------------\n// CHECK 4: THE BRIDGE ITSELF. The Square link either erroring right now, or no longer writing\n// anything down at all.\n//\n// TWO FAULTS, TWO SENTENCES. \"It is failing\" and \"it has stopped\" are different problems with\n// different first moves, and collapsing them into one alarm sends her to the wrong place.\n// ---------------------------------------------------------------------------------------------\n\nconst BRIDGE = \"bridge\";\nconst BRIDGE_TITLE = \"The Square link\";\nconst BRIDGE_LABEL = \"journal rows\";\n\nconst isErrorRow = (r: any) =>\n String(r?.kind ?? \"\").toUpperCase() === \"ERROR\" || (typeof r?.error === \"string\" && r.error.length > 0);\n\nexport function bridgeFindings(rows: unknown, nowMs: unknown): CheckResult {\n const now = Number(nowMs);\n const list = Array.isArray(rows) ? rows : [];\n const inspected = list.length;\n\n if (!Number.isFinite(now) || inspected === 0) {\n return blindCheck(BRIDGE, BRIDGE_TITLE, BRIDGE_LABEL,\n `The Square link's own log came back with nothing in it that could be read, so this cannot tell you whether ` +\n `the link is working. A check that inspects nothing is a blind spot, not a clean result, and an unreadable log ` +\n `is the loudest thing in this report rather than the quietest.`,\n `Open the Square link's own page and check it answers at all. If it does and the log is genuinely empty, ` +\n `every sale taken since it last wrote something down is unaccounted for.`);\n }\n\n // Rows with a readable date, oldest first. The rest are counted and reported, never guessed at.\n const stamped = (list as any[])\n .map((r) => ({ row: r, ms: Date.parse(String(r?.ts ?? \"\")) }))\n .filter((x) => Number.isFinite(x.ms))\n .sort((a, b) => a.ms - b.ms);\n\n const measured: Record = {\n rows: inspected,\n rowsWithATimestamp: stamped.length,\n };\n const result = (findings: Finding[]): CheckResult =>\n ({ check: BRIDGE, title: BRIDGE_TITLE, inspected, inspectedLabel: BRIDGE_LABEL, measured, findings });\n\n if (stamped.length === 0) {\n return result([{\n check: BRIDGE,\n severity: \"urgent\",\n sentence:\n `The Square link's log has ${commas(inspected)} ${plural(inspected, \"entry\", \"entries\")} in it and not one of ` +\n `them carries a date this can read. Without dates there is no way to tell a link that stopped last night from ` +\n `one that stopped in March, so this is being raised rather than passed over.`,\n numbers: { rows: inspected, rowsWithATimestamp: 0 },\n checkFirst:\n `Open the Square link's own log and look at the newest few entries. If they carry no time against them, the ` +\n `link is writing in a shape this report cannot read and that needs fixing before any of it can be believed.`,\n }]);\n }\n\n // ONLY THE RECENT ROWS. See BRIDGE_RECENT_ROWS: a check that fires on any error ever recorded is\n // red forever, and 265 failures from three fixed days in July would keep it that way.\n const recent = stamped.slice(-BRIDGE_RECENT_ROWS);\n const recentSet = new Set(recent);\n const errorsInRecentRows = recent.filter((x) => isErrorRow(x.row)).length;\n const errorsBeforeThat = stamped.filter((x) => !recentSet.has(x) && isErrorRow(x.row)).length;\n const errorShare = recent.length ? errorsInRecentRows / recent.length : 0;\n measured.recentRows = recent.length;\n measured.errorsInRecentRows = errorsInRecentRows;\n measured.errorsBeforeThat = errorsBeforeThat;\n\n const findings: Finding[] = [];\n\n if (errorsInRecentRows > 0) {\n findings.push({\n check: BRIDGE,\n severity: errorShare >= BRIDGE_ERROR_SHARE_URGENT ? \"urgent\" : \"attention\",\n sentence:\n `The Square link is failing as it runs. ${commas(errorsInRecentRows)} of its last ${commas(recent.length)} ` +\n `entries are failures, which is ${percent(errorShare)} of them. Every one of those is a sale that reached ` +\n `Square and did not reach a customer record in your CRM.`,\n numbers: {\n errorsInRecentRows,\n recentRows: recent.length,\n errorSharePercent: Math.round(errorShare * 100),\n errorsBeforeThat,\n },\n checkFirst:\n `The weekly exception report lists every sale that did not reach a customer record, by name and amount. ` +\n `Work from that list rather than from the log itself, and send me the report if the same name keeps appearing.`,\n });\n }\n\n const r = rhythmOf(stamped.map((x) => x.ms));\n const lastMs = stamped[stamped.length - 1].ms;\n const ageH = (now - lastMs) / HOUR;\n measured.quietForHours = Math.round(ageH * 10) / 10;\n if (r === null) {\n findings.push({\n check: BRIDGE,\n severity: \"note\",\n sentence:\n `The Square link's log holds only ${commas(stamped.length)} dated ${plural(stamped.length, \"entry\", \"entries\")}, ` +\n `which is too little for this to know how often it normally writes something. It cannot yet tell a quiet link ` +\n `from a stopped one.`,\n numbers: { rowsWithATimestamp: stamped.length, needed: MIN_RECORDS_FOR_RHYTHM },\n checkFirst: `Nothing to do today. This will be able to judge the link once its log has a little more history in it.`,\n });\n } else {\n measured.expectByH = Math.round(r.expectByH * 10) / 10;\n if (ageH > r.expectByH) {\n findings.push({\n check: BRIDGE,\n severity: escalate(ageH, r.expectByH),\n sentence:\n `The Square link has written nothing down for ${sayGap(ageH)}. The last thing it recorded was on ` +\n `${sayDate(lastMs)}. It normally writes something every ${sayGap(r.normalGapH)}, so it has not simply gone ` +\n `quiet, it has stopped. Anything taken in Square since then has not reached your CRM.`,\n numbers: {\n quietForHours: Math.round(ageH * 10) / 10,\n lastRowAt: new Date(lastMs).toISOString(),\n normalGapHours: Math.round(r.normalGapH * 10) / 10,\n outOfCharacterAfterHours: Math.round(r.expectByH * 10) / 10,\n rowsWithATimestamp: stamped.length,\n },\n checkFirst:\n `Open the Square link's own page and check it answers. If it does, take one card payment in Square and see ` +\n `whether it appears against a customer in your CRM within a few minutes.`,\n });\n }\n }\n\n return result(findings);\n}\n\n// ---------------------------------------------------------------------------------------------\n// CHECK 5: A FIGURE THAT SHOULD ONLY EVER GROW HAS GONE BACKWARDS.\n//\n// Lifetime totals only go up. When one comes back smaller, the reading is being taken from\n// somewhere else: a source was swapped, a query was cut at a date, a page walk stopped early. Each\n// of those has produced a wrong number in front of this client already, and each was invisible at\n// the time because the smaller figure was perfectly plausible on its own.\n//\n// A FIGURE THAT STOPS BEING REPORTED IS THE SAME DISEASE. It hides exactly what a fall hides, and\n// it looks like nothing at all on a page that only prints what it has.\n// ---------------------------------------------------------------------------------------------\n\nconst BACKWARDS = \"backwards\";\nconst BACKWARDS_TITLE = \"Running totals that should only grow\";\nconst BACKWARDS_LABEL = \"running totals\";\n\nexport function backwardsFindings(snapshots: unknown, labels: unknown): CheckResult {\n const named = (labels ?? {}) as Record;\n const nameOf = (key: string) => String(named?.[key] ?? key);\n const list = (Array.isArray(snapshots) ? snapshots : []) as Snapshot[];\n\n if (list.length === 0) {\n return blindCheck(BACKWARDS, BACKWARDS_TITLE, BACKWARDS_LABEL,\n `This check has no readings of your running totals at all, so it cannot tell whether any of them has gone ` +\n `backwards. A check that inspects nothing is a blind spot, not a clean result, and it is being reported as one.`,\n `Check that the file this keeps its earlier readings in still exists and can be read. Until it can, a total ` +\n `that shrinks will pass unnoticed.`);\n }\n\n const previous = list[list.length - 2];\n const current = list[list.length - 1];\n\n if (list.length < 2) {\n // A FIRST RUN IS NOT A CLEAN RUN. It compared nothing, so it says it compared nothing. This is\n // a note rather than an alarm because there is nothing wrong here, but it is still a finding,\n // because \"nothing to compare\" printed as blank space reads as \"everything checks out\".\n return {\n check: BACKWARDS,\n title: BACKWARDS_TITLE,\n inspected: 0,\n inspectedLabel: BACKWARDS_LABEL,\n measured: { readings: list.length, compared: 0 },\n findings: [{\n check: BACKWARDS,\n severity: \"note\",\n sentence:\n `This is the first time these running totals have been written down, so there is nothing yet to compare ` +\n `them against. That is not a clean result, it is an empty one, and from the next run on any figure that ` +\n `goes backwards will be named here.`,\n numbers: { readings: list.length, compared: 0 },\n checkFirst: `Nothing to do today. Run this again tomorrow and it will have something to compare against.`,\n }],\n };\n }\n\n const prevCounters = (previous?.counters ?? {}) as Record;\n const curCounters = (current?.counters ?? {}) as Record;\n const keys = [...new Set([...Object.keys(prevCounters), ...Object.keys(curCounters)])];\n const inspected = keys.length;\n const prevAt = Date.parse(String(previous?.at ?? \"\"));\n\n if (inspected === 0) {\n return blindCheck(BACKWARDS, BACKWARDS_TITLE, BACKWARDS_LABEL,\n `The last two readings of your running totals carry no figures at all, so there was nothing to compare. ` +\n `A check that inspects nothing is a blind spot, not a clean result, and it is being reported as one.`,\n `Check that the file this keeps its earlier readings in has not been emptied or overwritten.`);\n }\n\n const findings: Finding[] = [];\n for (const key of keys) {\n const before = Number(prevCounters[key]);\n const after = curCounters[key] === undefined || curCounters[key] === null ? null : Number(curCounters[key]);\n if (!Number.isFinite(before)) continue; // nothing to fall FROM: not a finding, just no history\n if (after === null || !Number.isFinite(after as number)) {\n findings.push({\n check: BACKWARDS,\n severity: \"attention\",\n sentence:\n `${nameOf(key)} was being reported and now is not. It read ${commas(before)} on ${sayDate(prevAt)} and the ` +\n `latest reading does not carry it at all. A figure that stops being reported hides exactly what a figure ` +\n `going backwards hides, so it is raised the same way.`,\n numbers: { counter: key, label: nameOf(key), previous: before, current: null, previousAt: previous?.at ?? null },\n checkFirst:\n `Check whether whatever produces this figure answered at all on the last run. A reading that failed and a ` +\n `reading of nought look the same on a page and mean opposite things.`,\n });\n continue;\n }\n if ((after as number) >= before) continue;\n const fell = before - (after as number);\n findings.push({\n check: BACKWARDS,\n severity: \"urgent\",\n sentence:\n `${nameOf(key)} has gone backwards. It read ${commas(before)} on ${sayDate(prevAt)} and reads ` +\n `${commas(after as number)} now, a fall of ${commas(fell)}. Figures like this only ever go up, so a fall means ` +\n `it is being read from somewhere different: a source swapped, a list cut short, or a page walk that stopped ` +\n `early and reported what it had as the whole.`,\n numbers: {\n counter: key,\n label: nameOf(key),\n previous: before,\n current: after,\n fell,\n previousAt: previous?.at ?? null,\n currentAt: current?.at ?? null,\n },\n checkFirst:\n `Do not act on any figure derived from this one until it is explained. Send me this report and I will read ` +\n `the same total straight from the system that owns it.`,\n });\n }\n\n return {\n check: BACKWARDS,\n title: BACKWARDS_TITLE,\n inspected,\n inspectedLabel: BACKWARDS_LABEL,\n measured: { readings: list.length, compared: inspected, comparedAgainst: previous?.at ?? null },\n findings,\n };\n}\n\n// ---------------------------------------------------------------------------------------------\n// THE BUCKETING. Dates cut into windows, which is arithmetic and therefore testable.\n//\n// A RECORD WITH NO READABLE DATE IS NEVER INVENTED INTO A WINDOW. Dropping it understates a\n// window; guessing at it corrupts the baseline every later judgement is made against.\n// ---------------------------------------------------------------------------------------------\n\n/** Payments the bridge saw, cut into equal windows ending now, oldest window first. */\nexport function ratioBuckets(seen: unknown, nowMs: unknown, windowDays: number, windows: number): RatioPoint[] {\n const now = Number(nowMs);\n const spanMs = Math.max(1, Number(windowDays) || 1) * 24 * HOUR;\n const n = Math.max(1, Math.floor(Number(windows) || 1));\n const points = Array.from({ length: n }, (_, i) => {\n const endMs = now - (n - 1 - i) * spanMs;\n return { label: `the ${windowDays} days to ${sayDate(endMs)}`, endMs, total: 0, matched: 0 };\n });\n if (!Number.isFinite(now)) return points;\n for (const p of (Array.isArray(seen) ? seen : []) as any[]) {\n const at = Number(p?.atMs);\n if (!Number.isFinite(at)) continue;\n const back = Math.floor((now - at) / spanMs);\n if (back < 0 || back >= n) continue;\n const point = points[n - 1 - back];\n point.total += 1;\n if (p?.matched === true) point.matched += 1;\n }\n return points;\n}\n\n/** Records of work and the money against them, summed into equal windows, oldest window first. */\nexport function revenuePeriods(records: unknown, nowMs: unknown, windowDays: number, windows: number): RevenuePeriod[] {\n const now = Number(nowMs);\n const spanMs = Math.max(1, Number(windowDays) || 1) * 24 * HOUR;\n const n = Math.max(1, Math.floor(Number(windows) || 1));\n const periods = Array.from({ length: n }, (_, i) => {\n const endMs = now - (n - 1 - i) * spanMs;\n return { label: `the ${windowDays} days to ${sayDate(endMs)}`, endMs, activity: 0, dollars: 0 };\n });\n if (!Number.isFinite(now)) return periods;\n for (const rec of (Array.isArray(records) ? records : []) as any[]) {\n const at = Number(rec?.atMs);\n if (!Number.isFinite(at)) continue;\n const back = Math.floor((now - at) / spanMs);\n if (back < 0 || back >= n) continue;\n const period = periods[n - 1 - back];\n period.activity += 1;\n period.dollars += Number(rec?.dollars) || 0;\n }\n // Rounded to the cent at the end, not per addition: summing floats and rounding once is the only\n // version whose total matches what the CRM itself reports.\n for (const p of periods) p.dollars = Math.round(p.dollars * 100) / 100;\n return periods;\n}\n\n// ---------------------------------------------------------------------------------------------\n// THE WHOLE RUN.\n// ---------------------------------------------------------------------------------------------\n\nexport function runWatch(input: WatchInput): WatchReport {\n // A RUN THAT WAS NEVER TOLD THE TIME JUDGES NOTHING.\n //\n // The dangerous shape this refuses: a replay with a mistyped date silently reporting on today,\n // under a heading naming the date it was asked about, with every figure wrong and nothing in the\n // document able to see it. Inventing a clock here would be the one mistake this whole file could\n // make that nobody downstream could catch.\n const now = input?.nowMs;\n if (!Number.isFinite(now)) {\n return {\n generatedAt: \"not known\",\n headline: \"This check could not run, because it was not told what the time is.\",\n inspected: 0,\n checks: [],\n findings: [{\n check: \"clock\",\n severity: \"urgent\",\n sentence:\n `This run was not told what the time is, so it has judged nothing at all. Every figure in this report is ` +\n `measured against a moment, and inventing one would have produced a page of confident numbers about the ` +\n `wrong day. Nothing here is an all clear.`,\n numbers: { nowMs: String(now), inspected: 0 },\n checkFirst:\n `Run this again with the date it is meant to judge. If this was a replay of a past morning, check the date ` +\n `that was typed for it.`,\n }],\n };\n }\n const at = now as number;\n\n const checks: CheckResult[] = [\n silenceFindings(input?.streams, at),\n matchRatioFindings(input?.ratio?.points, input?.ratio?.subject ?? \"payments\"),\n revenueChannelFindings(input?.revenue?.periods, input?.revenue?.subject ?? \"your bookings\"),\n bridgeFindings(input?.journal, at),\n backwardsFindings(input?.snapshots, input?.counterLabels ?? {}),\n ];\n\n const inspected = checks.reduce((a, c) => a + (c.inspected ?? 0), 0);\n // MOST SEVERE FIRST, so the first thing she reads is the worst thing. A stable sort inside a\n // severity band keeps the checks in the order they ran, which is the order the report explains.\n const rank: Record = { urgent: 0, attention: 1, note: 2 };\n const findings = checks\n .flatMap((c) => c.findings.map((f) => ({ ...f, check: f.check ?? c.check })))\n .map((f, i) => ({ f, i }))\n .sort((a, b) => ((rank[a.f.severity] ?? 3) - (rank[b.f.severity] ?? 3)) || (a.i - b.i))\n .map((x) => x.f);\n\n return {\n generatedAt: new Date(at).toISOString(),\n headline: headlineFor(findings, checks, inspected),\n inspected,\n checks,\n findings,\n };\n}\n\n/**\n * The one line at the top. It leads with what has to happen today, and it never says a reassuring\n * thing about a run that could not see anything: \"nothing wrong\" and \"nothing looked at\" have to\n * be different sentences or the second one does the damage of the first.\n */\nexport function headlineFor(findings: Finding[], checks: CheckResult[], inspected: number): string {\n // A finding from a check that read NOTHING is a blind spot, never a problem with the business.\n // The owning check is the authority; a free-form number inside the finding cannot change class.\n const isBlind = (finding: Finding) => isBlindFindingForChecks(finding, checks);\n const n = (s: Severity) => findings.filter((f) => f.severity === s && !isBlind(f)).length;\n const urgent = n(\"urgent\");\n const attention = n(\"attention\");\n const notes = findings.filter((f) => f.severity === \"note\" || isBlind(f)).length;\n if (urgent) {\n return `${capitalise(countWord(urgent))} ${plural(urgent, \"thing needs\", \"things need\")} you to look at today` +\n `${attention ? `, and ${countWord(attention)} more ${plural(attention, \"is\", \"are\")} worth a look this week` : \"\"}.`;\n }\n if (attention) {\n return `${capitalise(countWord(attention))} ${plural(attention, \"thing is\", \"things are\")} worth a look this week.`;\n }\n if (notes) {\n // W42: when NOTHING could be read, \"nothing looks wrong\" is a reassuring sentence about a run\n // that judged nothing. Lead with the blindness instead. Only say the reassuring half when at\n // least one check actually read something and came back clean.\n const readSomething = checks.filter((c) => Number(c?.inspected) > 0).length;\n if (!readSomething) {\n return `Nothing could be checked. ${capitalise(countWord(notes))} ` +\n `${plural(notes, \"check\", \"checks\")} read no data at all, so this run judges nothing either way.`;\n }\n return `Nothing looks wrong in what could be checked, and ${countWord(notes)} ` +\n `${plural(notes, \"thing\", \"things\")} this monitor cannot see yet.`;\n }\n return `Nothing looks wrong. ${capitalise(countWord(checks.length))} checks ran and read ` +\n `${commas(inspected)} records between them.`;\n}\n\n// ---------------------------------------------------------------------------------------------\n// THE COPY SHE READS.\n//\n// TWO RULES, ENFORCED MECHANICALLY, and they run over the GENERATED report rather than over any\n// source file, because the sentences are built at run time and a rule that only reads source\n// cannot see them.\n// ---------------------------------------------------------------------------------------------\n\n/** One entry per rule broken, so an em dash and a spaced hyphen in one page are one problem, not two. */\nexport function copyProblems(text: unknown): string[] {\n const s = String(text ?? \"\");\n const out: string[] = [];\n // The name of a service this business does not offer. She asked for it never to appear.\n if (/\\bday\\s?care\\b/i.test(s)) out.push(\"names a service this business does not offer\");\n // A dash used as punctuation, in any of its forms. Hyphens INSIDE words are fine and common:\n // \"well known\" hyphenated, a phone number, a field name. Only a dash standing alone counts.\n if (/(^|\\s)[-–—](\\s|$)|[–—]/.test(s)) out.push(\"uses a dash as punctuation\");\n return out;\n}\n\n/**\n * THE ENGINE'S OWN VIEW of the report: every finding, the figures behind it, and what every check\n * read including the checks that found nothing.\n *\n * WHY THE CHECKS THAT FOUND NOTHING ARE PRINTED. A report that prints only problems gives the\n * reader no way to tell \"checked and clean\" from \"checked nothing\", and that exact confusion is\n * what let February run for five months.\n *\n * This is the workings, not the page for the owner. scripts/watch-run.mjs renders her page from\n * the same report object and keeps this one in the repo, so a queried figure can still be traced.\n */\nexport function watchReportMarkdown(report: WatchReport, title: unknown): string {\n const heading = String(title ?? \"Early warning check\");\n const findings = Array.isArray(report?.findings) ? report.findings : [];\n const checks = Array.isArray(report?.checks) ? report.checks : [];\n // v1.1 (16 Aug) — THE SPLIT IS \"DID IT READ ANYTHING\", NOT SEVERITY ALONE. A blind check keeps\n // severity \"urgent\" (six tests hold that, and it must never go quiet), but it is not a fault in\n // the business and it must not be filed as one. Before this, the report opened \"Two things need\n // you to look at today\" when both were checks that had never been wired up — the exact shape of\n // failure this page exists to prevent, pointed inward.\n const readNothing = (finding: Finding) => isBlindFindingForChecks(finding, checks);\n const loud = findings.filter((f) => f.severity !== \"note\" && !readNothing(f));\n const notes = findings.filter((f) => f.severity === \"note\" || readNothing(f));\n const band: Record = {\n urgent: \"Look at this today\",\n attention: \"Worth a look this week\",\n note: \"The monitor talking about itself\",\n };\n const figures = (o: Record) =>\n Object.entries(o ?? {})\n .filter(([, v]) => v !== undefined && (typeof v !== \"object\" || v === null))\n .map(([k, v]) => `${k}: ${v === null ? \"not known\" : String(v)}`)\n .join(\", \");\n\n const out: string[] = [];\n out.push(`# ${heading}`);\n out.push(\"\");\n out.push(report?.headline ?? \"\");\n out.push(\"\");\n out.push(`Read at ${report?.generatedAt ?? \"not known\"}. ${commas(report?.inspected ?? 0)} records inspected across ${checks.length} checks.`);\n out.push(\"\");\n\n const say = (f: Finding) => {\n out.push(`### ${band[f.severity] ?? f.severity}. ${f.check}`);\n out.push(\"\");\n out.push(f.sentence);\n out.push(\"\");\n const fig = figures(f.numbers);\n if (fig) { out.push(`The figures behind that: ${fig}`); out.push(\"\"); }\n if (f.checkFirst) { out.push(`Check first: ${f.checkFirst}`); out.push(\"\"); }\n };\n\n if (loud.length) {\n out.push(`## What needs your attention`);\n out.push(\"\");\n for (const f of loud) say(f);\n }\n if (notes.length) {\n out.push(`## What this monitor cannot see yet`);\n out.push(\"\");\n out.push(\n `These are not problems with the business. They are the monitor saying where it is unable to judge anything, ` +\n `which is worth knowing rather than reading as a clean result.`);\n out.push(\"\");\n for (const f of notes) say(f);\n }\n\n out.push(`## What every check read, including the ones that found nothing`);\n out.push(\"\");\n for (const c of checks) {\n out.push(`${c.title}: read ${commas(c.inspected ?? 0)} ${c.inspectedLabel}, and raised ` +\n `${commas(c.findings?.length ?? 0)} ${plural(c.findings?.length ?? 0, \"finding\", \"findings\")}.`);\n const fig = figures(c.measured);\n if (fig) out.push(`The figures behind that: ${fig}`);\n out.push(\"\");\n }\n\n const blind = blindSpots(checks);\n out.push(`## Whether this report can be believed`);\n out.push(\"\");\n out.push(blind.length\n ? `${capitalise(countWord(blind.length))} ${plural(blind.length, \"check\", \"checks\")} inspected nothing and said ` +\n `nothing about it, which means this report is not watching what it claims to. Do not read it as a clean result.`\n : `Every check above reported the size of what it read, and every check that read nothing said so in its own ` +\n `finding rather than passing silently. A check that inspects nothing is a blind spot, not an all clear, and ` +\n `that is the one rule this whole report rests on.`);\n out.push(\"\");\n\n return out.join(\"\\n\").replace(/\\n{3,}/g, \"\\n\\n\");\n}\n",[198],"5c3e5160-8a18-4ca4-9b52-47c0de7c9b06","watch-view.ts","d0159a5c-98c4-11f1-99c3-1607ee4eb77e",1232,["D",1787226716573],3,"http","// READING THE EARLY-WARNING MONITOR. v1.1, 18 Aug 2026.\n//\n// The scheduled monitor writes one receipt blob. This endpoint leads with receipt health so a\n// stale, degraded, failed, or never-successful monitor cannot look like a clean business result.\n\nimport { watchReportMarkdown } from \"./watch.ts\";\nimport {\n WATCH_BLOB,\n reportFindingSeverity,\n validateWatchBlob,\n validatedWatchFindingSummary,\n type ReportFindingSeverity,\n type WatchFindingSummary,\n} from \"./watch-cron.ts\";\n\nconst STALE_HOURS = 36;\nconst COVERAGE =\n \"Runs automatically: CRM revenue against activity, silence on CRM payments and new contacts, \" +\n \"running totals, Square match ratio, and bridge-journal health. Square checks run only when the \" +\n \"credentialled bridge journal validates; missing CRM contact or bridge evidence marks the run \" +\n \"degraded and names the blind checks instead of reporting full health.\";\n\nasync function sha256Hex(s: string): Promise {\n const b = await crypto.subtle.digest(\"SHA-256\", new TextEncoder().encode(s));\n return [...new Uint8Array(b)].map((x) => x.toString(16).padStart(2, \"0\")).join(\"\");\n}\n\nasync function authorised(k: string): Promise {\n const configured = Deno.env.get(\"NURTURE_ADMIN_KEY_SHA256\");\n if (!k || !configured || !/^[0-9a-f]{64}$/i.test(configured)) return false;\n const got = await sha256Hex(k);\n const want = configured.toLowerCase();\n if (got.length !== want.length) return false;\n let d = 0;\n for (let i = 0; i < got.length; i++) d |= got.charCodeAt(i) ^ want.charCodeAt(i);\n return d === 0;\n}\n\nfunction invalidView(state: \"invalid\" | \"unreadable\", what: string, reason: string): any {\n return {\n ok: false,\n state,\n what,\n health: {\n reportAgeHours: null,\n stale: true,\n hasSuccessfulReport: false,\n lastRunOk: false,\n persistedLastRunOk: false,\n degraded: true,\n sourceDegraded: true,\n findingSeverity: \"none\",\n actionableFindingSeverity: \"none\",\n blind: false,\n blindFindingCount: 0,\n actionableFindingCount: 0,\n lastRunAt: null,\n lastRunError: reason,\n coverage: COVERAGE,\n schemaError: reason,\n },\n inspected: null,\n report: null,\n snapshots: [],\n };\n}\n\n/** Pure receipt classification, shared by the endpoint and executable tests. */\nexport function watchViewData(stored: unknown, nowMs = Date.now(), readError = \"\"): any {\n if (readError) {\n return invalidView(\n \"unreadable\",\n \"The stored early-warning receipt could not be read. This is not a first run or an all clear.\",\n readError,\n );\n }\n if (stored == null) {\n return {\n ok: false,\n state: \"never-run\",\n what: \"The early-warning monitor has not attempted a run yet.\",\n };\n }\n\n if (!Number.isFinite(nowMs)) {\n return invalidView(\"invalid\", \"The monitor receipt cannot be judged because the current clock is invalid.\",\n \"current time is invalid\");\n }\n let validated: ReturnType;\n try {\n validated = validateWatchBlob(stored, nowMs);\n stored = validated;\n } catch (error) {\n return invalidView(\n \"invalid\",\n \"The stored monitor receipt is malformed or future-dated and cannot be trusted.\",\n error instanceof Error ? error.message : \"stored receipt validation failed\",\n );\n }\n const emptySummary = (): WatchFindingSummary => ({\n findings: [], blind: [], actionable: [], severity: \"none\", actionableSeverity: \"none\",\n });\n const successful = validated.hasSuccessfulReport;\n const findingSummary = successful ? validatedWatchFindingSummary(validated.report) : emptySummary();\n const findingSeverity: ReportFindingSeverity = successful\n ? reportFindingSeverity(validated.report)\n : \"urgent\";\n const actionableFindingSeverity = findingSummary.actionableSeverity;\n const hasActionableFinding = findingSummary.actionable.length > 0;\n const hasBlindFinding = findingSummary.blind.length > 0;\n\n const reportMs = Date.parse(validated.report.generatedAt);\n const ageHours = (nowMs - reportMs) / 3_600_000;\n const stale = ageHours > STALE_HOURS;\n const persistedLastRunOk = validated.lastRun.ok;\n const sourceDegraded = validated.lastRun.degraded === true;\n const lastRunError = validated.lastRun.error;\n // Severity is authoritative even for a receipt written by the pre-repair cron with ok:true.\n // Keep that raw bit for diagnostics, but never expose it as effective health in JSON or prose.\n const lastRunOk = persistedLastRunOk && !sourceDegraded && !hasActionableFinding && !hasBlindFinding;\n const attemptFailed = !persistedLastRunOk && !sourceDegraded && !!lastRunError;\n const hasSuccessfulReport = successful;\n\n let state: \"not-yet-successful\" | \"degraded\" | \"urgent\" | \"failed\" | \"stale\" | \"healthy\";\n if (!hasSuccessfulReport) state = \"not-yet-successful\";\n else if (sourceDegraded) state = \"degraded\";\n else if (attemptFailed) state = \"failed\";\n else if (stale) state = \"stale\";\n else if (actionableFindingSeverity === \"urgent\") state = \"urgent\";\n else if (actionableFindingSeverity === \"attention\") state = \"degraded\";\n else if (hasBlindFinding) state = \"degraded\";\n else if (!lastRunOk) state = \"failed\";\n else state = \"healthy\";\n\n const what = state === \"not-yet-successful\"\n ? \"The early-warning monitor has not completed a successful run. Its failure is shown below.\"\n : state === \"degraded\"\n ? sourceDegraded\n ? \"The latest report contains usable evidence, but one or more monitoring sources could not be read.\" +\n (hasActionableFinding ? ` The available evidence also contains ${actionableFindingSeverity} findings.` : \"\")\n : hasActionableFinding\n ? \"The latest report contains findings that need attention. All configured evidence sources were read.\"\n : \"The latest report cannot judge one or more checks because they inspected no evidence. This is not a business alert or an all clear.\"\n : state === \"urgent\"\n ? \"The latest report contains urgent findings that need action. All configured evidence sources were read.\"\n : state === \"failed\"\n ? \"The latest attempt failed. The last completed report is retained below.\"\n : state === \"stale\"\n ? \"The latest completed report is stale; the monitor may have stopped.\" +\n (hasActionableFinding ? ` Its retained report contains ${actionableFindingSeverity} findings.` :\n hasBlindFinding ? \" Its retained report also contains checks that inspected no evidence.\" : \"\")\n : \"The latest automatic monitor run completed with all configured evidence sources.\";\n\n return {\n ok: state === \"healthy\",\n state,\n what,\n builtAt: validated.builtAt,\n health: {\n reportAgeHours: +ageHours.toFixed(1),\n stale,\n hasSuccessfulReport,\n lastRunOk,\n persistedLastRunOk,\n degraded: sourceDegraded,\n sourceDegraded,\n findingSeverity,\n actionableFindingSeverity,\n blind: hasBlindFinding,\n blindFindingCount: findingSummary.blind.length,\n actionableFindingCount: findingSummary.actionable.length,\n lastRunAt: validated.lastRun.at,\n lastRunError: lastRunError || null,\n coverage: COVERAGE,\n },\n inspected: validated.inspected,\n report: validated.report,\n snapshots: validated.snapshots,\n };\n}\n\n/** Render only detached, classified view data. The original blob value never crosses this API. */\nexport function watchViewText(data: any): string {\n if ([\"never-run\", \"invalid\", \"unreadable\"].includes(String(data?.state))) {\n const detail = data?.health?.schemaError ? `\\nReason: ${data.health.schemaError}\\n` : \"\\n\";\n return `${data?.what ?? \"The stored monitor receipt is unavailable.\"}${detail}`;\n }\n\n const h = data.health;\n const age = h.reportAgeHours === null ? \"an unreadable age\" : `${h.reportAgeHours}h ago`;\n const runLabel = data.state === \"not-yet-successful\" ? \"NOT YET SUCCESSFUL\"\n : data.state === \"urgent\" ? \"URGENT FINDINGS\"\n : data.state === \"degraded\" ? (h.sourceDegraded ? \"DEGRADED\" : h.blind ? \"CANNOT TELL\" : \"ATTENTION\")\n : data.state === \"failed\" ? \"FAILED\"\n : data.state === \"stale\" ? \"STALE\"\n : \"succeeded\";\n const inspected = data.inspected;\n const report = data.report;\n const head = [\n data.what,\n `Report generated ${report?.generatedAt ?? \"at an unreadable time\"} (${age})` +\n `; receipt stored ${data.builtAt ?? \"at an unreadable time\"}` +\n `${h.stale ? \" ***STALE OR UNREADABLE***\" : \"\"}`,\n `Last run ${runLabel}${h.lastRunError ? `: ${h.lastRunError}` : \"\"} at ${h.lastRunAt ?? \"an unreadable time\"}`,\n `Inspected ${inspected?.transactions ?? 0} payment records across ${inspected?.pages ?? 0} page(s)` +\n (inspected?.truncated ? \" — TRUNCATED\" : \"\"),\n h.coverage,\n \"\",\n ].join(\"\\n\");\n\n const reportText = report && Array.isArray(report.findings)\n ? watchReportMarkdown(report, \"The Dogs Spot — early warning\")\n : \"The stored monitor report is malformed and cannot be rendered.\\n\";\n return head + reportText;\n}\n\nexport default async function (req: Request): Promise {\n const u = new URL(req.url);\n if (!(await authorised(u.searchParams.get(\"k\") ?? \"\"))) return new Response(\"Not found\", { status: 404 });\n\n let stored: unknown = null;\n let readError = \"\";\n try {\n const { blob } = await import(\"https://esm.town/v/std/blob\");\n stored = await blob.getJSON(WATCH_BLOB);\n } catch {\n readError = \"watch receipt storage read failed\";\n }\n\n const data = watchViewData(stored, Date.now(), readError);\n if (u.searchParams.get(\"f\") === \"json\") return Response.json(data, { status: 200 });\n return new Response(watchViewText(data), {\n headers: { \"Content-Type\": \"text/plain; charset=utf-8\" },\n });\n}\n",[206],"81b0edc8-3573-4196-8a6a-bb34c5b3b4ab","watch-cron.ts","cfa8812e-98c4-11f1-9f38-1607ee4eb77e",1231,["D",1787226711931],2,"interval","\nimport {\n headlineFor,\n isBlindFindingForChecks,\n REVENUE_ACTIVITY_HELD,\n REVENUE_DOLLAR_FALL,\n REVENUE_MIN_BASELINE_ACTIVITY,\n REVENUE_MIN_PERIODS,\n revenueChannelFindings,\n runWatch,\n ratioBuckets,\n revenuePeriods,\n type Finding,\n type WatchReport,\n} from \"./watch.ts\";\nimport { paymentLedger } from \"./facts.ts\";\nimport { fetchPayments, MIN_REAL_PAYMENT, toPayment } from \"./payments-source.ts\";\n\nconst LOC = \"BQHJ19uohldYe3eqA0bl\";\nconst GHL = \"https://services.leadconnectorhq.com\";\nconst PAYMENT_PATH = \"/payments/transactions\";\nconst CONTACT_PATH = \"/contacts/\";\nconst CONTACT_PAGE_SIZE = \"100\";\nconst CONTACT_QUERY_KEYS = new Set([\"locationId\", \"limit\", \"startAfter\", \"startAfterId\"]);\nexport const BRIDGE_URL = \"https://amir5--41ace24c7e2111f18c9d1607ee4eb77e.web.val.run\";\nconst UA =\n \"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/126.0 Safari/537.36\";\nconst DAY = 86_400_000;\nconst PAYMENT_CURRENCY = \"USD\";\nconst PAYMENT_AMOUNT_UNIT = \"major\";\nconst KNOWN_PAYMENT_STATUSES = new Set([\"succeeded\", \"failed\", \"pending\"]);\nconst CRM_REQUEST_TIMEOUT_MS = 15_000;\nconst BRIDGE_REQUEST_TIMEOUT_MS = 15_000;\n\nexport const WATCH_BLOB = \"watch_report\";\nexport const REVENUE_WINDOW_DAYS = 28;\nexport const REVENUE_WINDOWS = 7;\nexport const RATIO_WINDOW_DAYS = 7;\nexport const RATIO_WINDOWS = 6;\nexport const MONITORING_HORIZON_DAYS = REVENUE_WINDOW_DAYS * REVENUE_WINDOWS;\nexport const MAX_SNAPSHOTS = MONITORING_HORIZON_DAYS + 2;\nexport const REAL_MONEY = MIN_REAL_PAYMENT;\nexport const PAGE_CAP = 40;\nexport const BRIDGE_JOURNAL_CAP = 1_500;\nexport const MAX_TRANSACTION_DROP_SHARE = 0.10;\nexport const OVERALL_BUDGET_MS = 45_000;\n\nexport const LIFETIME_COUNTER_KEYS = [\n \"crmPaymentRecords\",\n \"crmPaymentDollarsLifetime\",\n] as const;\ntype LifetimeCounterKey = typeof LIFETIME_COUNTER_KEYS[number];\ntype LifetimeCounters = Record;\ntype Snapshot = { at: string; counters: LifetimeCounters };\ntype ResponseLike = { ok: boolean; status: number; json: () => Promise };\ntype RequestFn = (url: string, init?: RequestInit) => Promise;\ntype BlobLike = {\n getJSON: (key: string) => Promise;\n setJSON: (key: string, value: unknown) => Promise;\n};\n\nexport type ReportFindingSeverity = \"urgent\" | \"attention\" | \"note\" | \"none\";\n\nexport type WatchFindingSummary = {\n findings: Finding[];\n blind: Finding[];\n actionable: Finding[];\n severity: ReportFindingSeverity;\n actionableSeverity: ReportFindingSeverity;\n};\n\nexport type WatchInspected = {\n transactions: number;\n expectedTransactions: number;\n pages: number;\n truncated: boolean;\n validTransactionTimestamps: number;\n paymentStatuses: { succeeded: number; failed: number; pending: number };\n currency: \"USD\";\n amountUnit: \"major\";\n zeroOrTest: number;\n unknownSourceTypes: string[];\n contacts: number;\n contactPages: number;\n bridgeJournalRows: number;\n bridgePayments: number;\n bridgeAtCapacity: boolean;\n bridgeHorizonComplete: boolean;\n};\n\nexport type WatchBlob = {\n report: WatchReport;\n builtAt: string;\n hasSuccessfulReport: boolean;\n inspected: WatchInspected;\n lastRun: {\n at: string;\n ok: boolean;\n degraded?: boolean;\n findingSeverity?: ReportFindingSeverity;\n ms: number;\n error: string;\n };\n snapshots: Snapshot[];\n highWater?: Snapshot;\n};\n\nexport type BridgeEvidence = {\n journal: any[];\n payments: number;\n journalRows: number;\n atCapacity: boolean;\n horizonComplete: boolean;\n oldestAt: string;\n ratio: { subject: string; points: ReturnType };\n};\n\nexport type BridgeReadOptions = {\n admin?: string;\n bridgeUrl?: string;\n request?: RequestFn;\n timeoutMs?: number;\n};\n\nexport type TransactionEvidence = {\n rows: { atMs: number; dollars: number }[];\n count: number;\n expected: number;\n pages: number;\n truncated: false;\n validTimestamps: number;\n statuses: { succeeded: number; failed: number; pending: number };\n currency: \"USD\";\n amountUnit: \"major\";\n zeroOrTest: number;\n unknownSourceTypes: string[];\n};\n\nexport type ContactEvidence = { timestamps: number[]; rows: number; pages: number };\n\nexport type ScheduledWatchDeps = {\n blob?: BlobLike;\n env?: (name: string) => string | undefined;\n request?: RequestFn;\n now?: () => number;\n wallNow?: () => number;\n log?: (line: string) => void;\n runWatchFn?: typeof runWatch;\n};\n\nexport type ScheduledWatchResult = { published: boolean; degraded: boolean; error: string };\n\nconst envValue = (name: string): string | undefined => {\n try {\n return typeof Deno !== \"undefined\" ? Deno.env.get(name) : undefined;\n } catch {\n return undefined;\n }\n};\n\nconst errorText = (value: unknown): string => value instanceof Error ? value.message : String(value);\n\nexport function redactSecrets(value: unknown, known: string[] = []): string {\n let text = errorText(value);\n for (const secret of known.filter((x) => typeof x === \"string\" && x.length >= 4)) {\n text = text.split(secret).join(\"[REDACTED]\");\n }\n return text\n .replace(/Bearer\\s+[^\\s,;]+/gi, \"Bearer [REDACTED]\")\n .replace(/([?&](?:admin|token|api[_-]?key|secret)=)[^&\\s]+/gi, \"$1[REDACTED]\")\n .replace(/\\b((?:admin|token|api[_-]?key|secret)\\s*[:=]\\s*)[^\\s,;]+/gi, \"$1[REDACTED]\")\n .replace(/\\b(?:pit-|ghl_|admin_)[A-Za-z0-9._~-]{12,}/g, \"[REDACTED]\")\n .slice(0, 240);\n}\n\nfunction assertCrmUrl(raw: string, allowedPaths = new Set([PAYMENT_PATH, CONTACT_PATH])): URL {\n let target: URL;\n try {\n target = new URL(raw, GHL);\n } catch {\n throw new Error(\"CRM URL is invalid\");\n }\n if (target.protocol !== \"https:\" || target.origin !== GHL || target.username || target.password) {\n throw new Error(\"refusing a URL outside the CRM origin\");\n }\n if (!allowedPaths.has(target.pathname)) throw new Error(\"refusing an undocumented CRM endpoint\");\n return target;\n}\n\nfunction assertContactPageUrl(raw: string, continuation: boolean): URL {\n const target = assertCrmUrl(raw, new Set([CONTACT_PATH]));\n if (target.hash) throw new Error(\"contact pagination URL contains an unsafe fragment\");\n\n for (const key of target.searchParams.keys()) {\n if (!CONTACT_QUERY_KEYS.has(key)) {\n throw new Error(`contact pagination URL uses an unexpected query route: ${key || \"(empty)\"}`);\n }\n }\n const one = (key: string): string => {\n const values = target.searchParams.getAll(key);\n if (values.length !== 1) {\n throw new Error(`contact pagination URL must contain exactly one ${key}`);\n }\n return values[0];\n };\n\n const locationId = one(\"locationId\");\n if (!/^[A-Za-z0-9]{20}$/.test(locationId)) {\n throw new Error(\"contact pagination URL contains an unsafe locationId\");\n }\n if (locationId !== LOC) {\n throw new Error(\"contact pagination URL is not pinned to the Dogs Spot locationId\");\n }\n if (one(\"limit\") !== CONTACT_PAGE_SIZE) {\n throw new Error(`contact pagination URL changed the requested limit from ${CONTACT_PAGE_SIZE}`);\n }\n\n const startAfter = target.searchParams.getAll(\"startAfter\");\n const startAfterId = target.searchParams.getAll(\"startAfterId\");\n if (!continuation) {\n if (startAfter.length || startAfterId.length) {\n throw new Error(\"initial contact query unexpectedly contains a pagination cursor\");\n }\n return target;\n }\n if (startAfter.length !== 1 || startAfterId.length !== 1) {\n throw new Error(\"contact pagination URL must contain one complete cursor pair\");\n }\n if (!/^\\d{1,20}$/.test(startAfter[0]) || !/^[A-Za-z0-9_-]{1,128}$/.test(startAfterId[0])) {\n throw new Error(\"contact pagination URL contains an unsafe cursor\");\n }\n return target;\n}\n\nfunction bridgeTarget(configured: string): URL {\n let url: URL;\n try {\n url = new URL(configured || BRIDGE_URL);\n if (url.protocol !== \"https:\") throw new Error(\"HTTPS is required\");\n } catch {\n throw new Error(\"bridge journal unavailable: BRIDGE_URL is invalid\");\n }\n const allowed = new URL(BRIDGE_URL);\n if (url.origin !== allowed.origin || url.hostname !== allowed.hostname ||\n url.pathname !== allowed.pathname || url.username || url.password) {\n throw new Error(\"bridge journal unavailable: URL is outside the exact allowed origin\");\n }\n url.search = \"\";\n url.hash = \"\";\n return url;\n}\n\nexport async function readBridgeEvidence(\n nowMs: number,\n options: BridgeReadOptions = {},\n): Promise {\n if (!Number.isFinite(nowMs)) throw new Error(\"bridge journal unavailable: current time is invalid\");\n const admin = (options.admin ?? envValue(\"BRIDGE_ADMIN\") ?? \"\").trim();\n if (!admin) throw new Error(\"bridge journal unavailable: BRIDGE_ADMIN is not configured\");\n\n const configuredUrl = (options.bridgeUrl ?? envValue(\"BRIDGE_URL\") ?? \"\").trim();\n const url = bridgeTarget(configuredUrl);\n url.searchParams.set(\"dump\", \"1\");\n url.searchParams.set(\"admin\", admin);\n\n const timeoutMs = options.timeoutMs ?? BRIDGE_REQUEST_TIMEOUT_MS;\n if (!Number.isFinite(timeoutMs) || timeoutMs <= 0) throw new Error(\"bridge journal request budget is exhausted\");\n let response: ResponseLike;\n try {\n response = await (options.request ?? fetch)(url.toString(), {\n method: \"GET\",\n redirect: \"manual\",\n signal: AbortSignal.timeout(Math.max(1, Math.floor(timeoutMs))),\n }) as ResponseLike;\n } catch {\n throw new Error(\"bridge journal request failed\");\n }\n if (response.status >= 300 && response.status < 400) {\n throw new Error(`bridge journal refused redirect HTTP ${response.status}`);\n }\n if (!response.ok) throw new Error(`bridge journal request failed with HTTP ${response.status}`);\n\n let journal: unknown;\n try {\n journal = await response.json();\n } catch {\n throw new Error(\"bridge journal response was not valid JSON\");\n }\n if (!Array.isArray(journal)) throw new Error(\"bridge journal response was not an array\");\n if (journal.length === 0) {\n throw new Error(\"bridge journal returned zero rows; refusing to publish a zero-data watch report\");\n }\n if (journal.length > BRIDGE_JOURNAL_CAP) {\n throw new Error(`bridge journal exceeded its known ${BRIDGE_JOURNAL_CAP}-row cap`);\n }\n\n const times = journal.map((row, i) => {\n if (!row || typeof row !== \"object\" || Array.isArray(row)) {\n throw new Error(`bridge journal row ${i + 1} is malformed`);\n }\n const at = Date.parse(typeof row.ts === \"string\" ? row.ts : \"\");\n if (!Number.isFinite(at)) throw new Error(`bridge journal row ${i + 1} has an invalid timestamp`);\n if (at > nowMs + 5 * 60_000) throw new Error(`bridge journal row ${i + 1} has a future timestamp`);\n return at;\n });\n\n const ledger = paymentLedger(journal);\n if (ledger.length === 0) {\n throw new Error(\"bridge journal contained no Square payment records; refusing to publish a zero match ratio\");\n }\n if (ledger.some((row) => !Number.isFinite(row.atMs))) {\n throw new Error(\"bridge journal contains a Square payment with no readable timestamp\");\n }\n\n const oldestMs = Math.min(...times);\n const ratioStart = nowMs - RATIO_WINDOW_DAYS * RATIO_WINDOWS * DAY;\n const atCapacity = journal.length === BRIDGE_JOURNAL_CAP;\n const horizonComplete = !atCapacity || oldestMs <= ratioStart;\n if (!horizonComplete) {\n throw new Error(\"bridge journal history is truncated inside the match-ratio horizon\");\n }\n\n return {\n journal,\n payments: ledger.length,\n journalRows: journal.length,\n atCapacity,\n horizonComplete,\n oldestAt: new Date(oldestMs).toISOString(),\n ratio: {\n subject: \"Square payments\",\n points: ratioBuckets(ledger, nowMs, RATIO_WINDOW_DAYS, RATIO_WINDOWS),\n },\n };\n}\n\nexport async function readTransactions(\n get: (url: string) => Promise,\n nowMs = Date.now(),\n options: { pageSize?: number; pageCap?: number } = {},\n): Promise {\n const rawRows: any[] = [];\n const source = await fetchPayments(async (url) => {\n const body = await get(url);\n if (isRecord(body) && Array.isArray(body.data)) rawRows.push(...body.data);\n return body;\n }, {\n locationId: LOC,\n pageSize: options.pageSize,\n pageCap: options.pageCap ?? PAGE_CAP,\n now: nowMs,\n });\n\n const count = source.source.totalCount;\n if (count === 0) throw new Error(\"payment source returned zero transactions; refusing to publish\");\n if (rawRows.length !== count) throw new Error(`payment source read ${rawRows.length} of ${count}`);\n\n const statuses = { succeeded: 0, failed: 0, pending: 0 };\n let zeroOrTest = 0;\n const rows = rawRows.map((raw) => {\n const payment = toPayment(raw);\n if (!KNOWN_PAYMENT_STATUSES.has(payment.status)) {\n throw new Error(`unknown payment status for ${payment.id}: refusing to convert it to zero dollars`);\n }\n if (payment.status === \"succeeded\") statuses.succeeded++;\n else if (payment.status === \"failed\") statuses.failed++;\n else statuses.pending++;\n\n const statedCurrency = raw.currency ?? raw.currencyCode;\n if (statedCurrency != null &&\n (typeof statedCurrency !== \"string\" || statedCurrency.trim().toUpperCase() !== PAYMENT_CURRENCY)) {\n throw new Error(`payment ${payment.id} has an unsupported currency`);\n }\n if (!payment.at) throw new Error(`payment ${payment.id} has no createdAt timestamp`);\n const atMs = Date.parse(payment.at);\n if (!Number.isFinite(atMs)) throw new Error(`payment ${payment.id} has an invalid timestamp`);\n\n const isRevenue = payment.status === \"succeeded\" && payment.amount >= REAL_MONEY;\n if (payment.status === \"succeeded\" && !isRevenue) zeroOrTest++;\n return { atMs, dollars: isRevenue ? payment.amount : 0 };\n });\n\n return {\n rows,\n count,\n expected: source.source.totalCount,\n pages: source.source.pages,\n truncated: false,\n validTimestamps: rows.length,\n statuses,\n currency: PAYMENT_CURRENCY,\n amountUnit: PAYMENT_AMOUNT_UNIT,\n zeroOrTest,\n unknownSourceTypes: source.unknownTypes,\n };\n}\n\nexport async function readContactTimes(\n get: (url: string) => Promise,\n pageLimit = 3,\n nowMs = Date.now(),\n): Promise {\n if (!Number.isInteger(pageLimit) || pageLimit < 1 || pageLimit > 10) {\n throw new Error(\"invalid contact page limit\");\n }\n if (!Number.isFinite(nowMs)) throw new Error(\"contact source current time is invalid\");\n const timestamps: number[] = [];\n const seenUrls = new Set();\n let pages = 0;\n let url: URL | null = assertContactPageUrl(\n `${GHL}${CONTACT_PATH}?locationId=${LOC}&limit=${CONTACT_PAGE_SIZE}`,\n false,\n );\n while (url && pages < pageLimit) {\n const target = url;\n if (seenUrls.has(target.toString())) throw new Error(\"contact pagination repeated a page URL\");\n seenUrls.add(target.toString());\n\n const page = await get(target.toString());\n if (!isRecord(page)) {\n throw new Error(`contact page ${pages + 1} is malformed`);\n }\n if (!Array.isArray(page.contacts)) throw new Error(`contact page ${pages + 1} has no contacts array`);\n if (!isRecord(page.meta)) {\n throw new Error(`contact page ${pages + 1} has no metadata object`);\n }\n if (page.contacts.length > 100) throw new Error(`contact page ${pages + 1} exceeds its requested limit`);\n if (page.meta.nextPageUrl != null &&\n (typeof page.meta.nextPageUrl !== \"string\" || !page.meta.nextPageUrl.trim())) {\n throw new Error(`contact page ${pages + 1} has an invalid nextPageUrl`);\n }\n\n for (const contact of page.contacts) {\n if (!contact || typeof contact !== \"object\" || Array.isArray(contact)) {\n throw new Error(`contact page ${pages + 1} contains a malformed row`);\n }\n const at = Date.parse(String(contact.dateAdded ?? \"\"));\n if (!Number.isFinite(at)) throw new Error(\"contact row has an invalid dateAdded timestamp\");\n if (at > nowMs) throw new Error(\"contact row has a future dateAdded timestamp\");\n if (timestamps.length && at > timestamps[timestamps.length - 1]) {\n throw new Error(\"contact pages are not pinned newest-first\");\n }\n timestamps.push(at);\n }\n pages++;\n\n const next = page.meta.nextPageUrl ?? null;\n url = next ? assertContactPageUrl(next, true) : null;\n }\n if (timestamps.length === 0) throw new Error(\"contact source returned zero timestamps\");\n return { timestamps, rows: timestamps.length, pages };\n}\n\nconst CANONICAL_UTC_TIME = /^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}\\.\\d{3}Z$/;\nconst MAX_REPORT_PERSIST_LAG_MS = 5 * 60_000;\n\nconst isRecord = (value: unknown): value is Record => {\n try {\n return !!value && typeof value === \"object\" && !Array.isArray(value) &&\n Object.getPrototypeOf(value) === Object.prototype;\n } catch {\n return false;\n }\n};\n\nconst isNormalObjectDataDescriptor = (descriptor: PropertyDescriptor | undefined): boolean =>\n descriptor !== undefined && Object.prototype.hasOwnProperty.call(descriptor, \"value\") &&\n descriptor.enumerable === true && descriptor.writable === true && descriptor.configurable === true;\n\nfunction hasExactKeys(\n value: Record,\n required: readonly string[],\n optional: readonly string[] = [],\n): boolean {\n try {\n const allowed = new Set([...required, ...optional]);\n const keys = Reflect.ownKeys(value);\n return required.every((key) => keys.includes(key)) &&\n keys.every((key) => typeof key === \"string\" && allowed.has(key) &&\n isNormalObjectDataDescriptor(Object.getOwnPropertyDescriptor(value, key)));\n } catch {\n return false;\n }\n}\n\nfunction hasExactDataKeys(\n value: Record,\n required: readonly string[],\n optional: readonly string[] = [],\n): boolean {\n return hasExactKeys(value, required, optional);\n}\n\nfunction isExactArray(value: unknown): value is unknown[] {\n try {\n if (!Array.isArray(value) || Object.getPrototypeOf(value) !== Array.prototype) return false;\n const keys = Reflect.ownKeys(value);\n const lengthDescriptor = Object.getOwnPropertyDescriptor(value, \"length\");\n if (!lengthDescriptor || !Object.prototype.hasOwnProperty.call(lengthDescriptor, \"value\") ||\n typeof lengthDescriptor.value !== \"number\" || !Number.isSafeInteger(lengthDescriptor.value) ||\n lengthDescriptor.value < 0 || lengthDescriptor.enumerable !== false ||\n lengthDescriptor.writable !== true || lengthDescriptor.configurable !== false) return false;\n const length = lengthDescriptor.value;\n if (keys.length !== length + 1 || !keys.includes(\"length\")) return false;\n for (let i = 0; i < length; i++) {\n const key = String(i);\n if (!keys.includes(key) ||\n !isNormalObjectDataDescriptor(Object.getOwnPropertyDescriptor(value, key))) return false;\n }\n return keys.every((key) => key === \"length\" ||\n (typeof key === \"string\" && /^(?:0|[1-9]\\d*)$/.test(key) && Number(key) < length));\n } catch {\n return false;\n }\n}\n\nfunction isExactDataArray(value: unknown): value is unknown[] {\n return isExactArray(value);\n}\n\nfunction detachedExactData(\n value: unknown,\n fail: SchemaFailure,\n path: string,\n active: Set

Of the ${ptReadable ? pt.booked : \"unknown\"} Pup Talks: showed / no-show / never marked either way	${ptReadable ? `${pt.showed} / ${pt.noshow} / ${Math.max(0, pt.booked - pt.showed - pt.noshow)}` : \"Unknown\"}
Canceled (not counted above)	${ptReadable ? pt.cancelled : \"Unknown\"}
Show rate	${ptReadable ? `${pt.showed} of ${pt.booked} booked${pt.booked >= 5 ? ` (${pct(pt.showed, pt.booked)})` : \"\"}${Math.max(0, pt.booked - pt.showed - pt.noshow) > 0 && pt.showed + pt.noshow >= 5 ? `; of the ${pt.showed + pt.noshow} actually marked, ${pct(pt.showed, pt.showed + pt.noshow)}` : \"\"}` : \"Unknown\"}
Free Training Day booked / showed	${ftdReadable ? `${ftd.booked} / ${ftd.showed}${ftd.booked === 0 ? \" (none scheduled this week)\" : \"\"}` : \"Unknown\"}
Meta connection error	${esc(metaErr)}

Stage	People
${esc(STATUS_LABEL[s.k])}	${s.n}
Total in a sequence	${sum}

Segment	Count	Share	What can be done
Has an email	${c.emailable}	${pct(c.emailable, d.total)}	Address inventory only; not permission to release.
Email + consent snapshot clear	${c.releaseReady ?? 0}	${pct(c.releaseReady ?? 0, d.total)}	The only rows allowed into the dry-run batch plan.
Email, consent unknown	${c.consentUnknown ?? c.emailable}	${pct(c.consentUnknown ?? c.emailable, d.total)}	Held until each full contact DND snapshot is read.
Email blocked / DND	${c.emailBlocked ?? 0}	${pct(c.emailBlocked ?? 0, d.total)}	Excluded from the release.
Phone only	${c.phoneOnly}	${pct(c.phoneOnly, d.total)}	SMS — held until numbers are validated. Stale numbers get a business flagged by carriers.
Neither	${c.unreachable}	${pct(c.unreachable, d.total)}	Nothing by email or text. Reachable only inside Messenger, within Meta's window.
Excluded	${c.excluded}	${pct(c.excluded, d.total)}	Already customers, already on a path, flagged spam, or duplicates.

Campaign	Spent	Conversations	Cost each
Kims New Except4Ads#2	$180.64	47	$3.84
APRIL 10th Fresh February Leads - Copy	$170.89	44	$3.88
Email CSV AI Campaign	$116.49	22	$5.30
Training Tips-Messenger Leads-6/26	$86.96	14	$6.21
Free Training Day Website 6/19	$0.00	0	off
Total	$554.98	127	$4.37

Measure	This week	How it is worked out
Cost per click	$2.05	$164.00 divided by 80 clicks
Cost per conversion	$41.00	$164.00 divided by 4 conversions
Click through rate	8.25%	80 clicks divided by 970 impressions
Your share of available searches	32%	Google's figure, up from 29%
Rover's share of the same searches	24%	Google's figure, up from 22%

Channel	Messages in	Notes
Facebook	538	72% of everything that came in
Phone	71	120 calls in total, 24 unanswered
Text	71
Instagram	46
Email	4

Figure	Value	Source and method
Facebook spend	$554.98	Ads Manager, account 938090411743620, 31 Jul to 5 Aug, sum of the four live campaigns
Facebook conversations	127	Same view, sum of the Results column
Facebook cost per conversation	$4.37	554.98 divided by 127
Facebook consistency check	4 of 4	Each campaign's spend divided by its results matches Meta's own cost per result to the cent
Google spend, clicks, impressions, conversions	$164, 80, 970, 4	Google Ads overview, account 942-544-7945, 31 Jul to 6 Aug
New contacts, this week and last	175 and 197	CRM contact search on date added, converted to New York time before bucketing, two independent pulls agreed
Appointments	55 and 64	All 29 calendars queried one at a time, 197 raw events, bucketed on start time
Messages in and out	748 and 1,143	660 conversations pulled in full, 15,488 messages, system audit entries excluded
Calls	120, 96 answered	Call type messages, answered means completed
Opportunities won, all time	0	All 5,768 opportunities paginated: 5,594 open, 174 lost, 0 won, 0 abandoned. This is the pipeline view only, not a statement about money received
Payment records in the CRM	232 and 195	Transactions and orders. Three transactions fall inside this week, which is being checked before any return figure is quoted
Contacts with no source, 31 Jul to 5 Aug	120 of 149	Source field on each new contact record

Where the money went	Amount	How this page gets it
Facebook and Instagram3 August to 9 August 2026	$676.94	Read straight from the ad platform every time your card page loads. Read three times today, at 3:06 pm, 3:15 pm and 3:16 pm, and it said the same figure each time.
Google31 July to 6 August 2026	$164.00	Typed by hand. This is the figure in the message sent to you on 7 August. Google puts its own numbers behind a developer token, which Google quotes at about five business days. Google joins this page the same way Facebook has once that token lands, and until then every Google figure you see anywhere is one a person typed.

In the seven days 3 August to 9 August	Count
New people in your CRM	168
Of those, arrived through Facebook or Instagram	139
New cards on your Initial Lead Pipeline	166
Pup Talk appointments on your calendar	20
Of those, showed up	15
Cards that moved into your Customer column	2

Program price on the record	Records	Value
$3,295.00	39	$128,505.00
$2,395.00	11	$26,345.00
$3,795.00	3	$11,385.00
All valued records	53	$166,235.00

What happens to it	Payments	Value
Places itself. One booking open, so the money goes straight on it.	15	$7,880.00
Waits for one of your team to pick. More than one booking open.	0	$0.00
Booking already carries a value, so it is left exactly as it is.	15	$8,237.00
Stays where it is, and it is two separate causes. 3 worth $480.00 carry no name on the record. 3 worth $967.00 name a real customer whose booking sits on another board.	6	$1,447.00
All completed payments	36	$17,564.00

Read from the system itself at 3:12 pm today	Reading
Practice mode	On
Messages to real customers, all time	0
Records it is tracking	1
Practice messages produced	5
Version, and its last pass	1.7.1, 3:11 pm

Program price on the record	Records	Value
$3,295	39	$128,505.00
$2,395	11	$26,345.00
$3,795	3	$11,385.00
All valued records	53	$166,235.00

What happens to it	Payments	Value
Places itself. One booking open, so the money goes straight on it.	15	$7,880.00
Needs one of your team to pick. More than one booking open.	0	$0.00
Already has a value on the booking, so it is left alone.	15	$8,237.00
Cannot be placed, and it is two different problems. Three arrived against a record with no name on it at all. The other three name a real customer who has no card in your Customer column to put the money on.	6	$1,447.00
All completed payments	36	$17,564.00

Route	Payments	What it carries
Invoice raised in the CRM, paid by card	56	Arrives already attached to the customer. This is most of your real revenue.
Order form and manual charges	12	Same, attached to the customer.
Counter sale in Square with no name taken	8	Files against one nameless record. Nothing can ever place these.

What it finds	What it does
One open booking	Writes the amount on. No person involved.
More than one open booking	Puts it on an exception list for your team to pick. It never guesses.
No name on the payment	Reported separately as unplaceable. Never guessed at.
Booking already has a price on it	Left exactly as it is. It never overwrites anybody's number.

Outcome	Payments	Value
Places itself. One booking open.	15	$7,880.00
Goes to the exception list for your team to pick.	0	$0.00
Booking already priced, so left alone.	15	$8,237.00
Cannot be placed, reported separately.	6	$1,447.00
All completed payments	36	$17,564.00

Task	Who	How often
Take a name at the counter when somebody pays without one.	Front desk	Only fixes future payments, not past ones. Eight so far have no name.
Pick the right booking when a customer has more than one open.	Whoever you nominate	Zero times today. The list is empty.
Moving cards into Customer	Nobody	Already automated. Noted, and thank you for the correction.
Anything else	Nobody	The rest is automatic.

${esc(ch.name)}

Where your leads come from, and what goes back

Overall status

What this page deliberately does not claim

Did the ad leads actually land?

Did the ad leads actually land?

Did the ad leads actually land?

Some numbers could not be read

What last week's report said

What last week's report said

The Dogs Spot, the week in numbers

What happened, in words DRAFT until Amir reviews

New inquiries, last eight weeks

Where this week's inquiries came from

Why there is no revenue figure

Appendix, the fine print

This week's raw counts

How every number is computed

Nurture path registry

Holiday deposits

Holiday deposits

Holiday deposits

Holiday deposits

The Dogs Spot

Waiting on you

From first contact to paying customer

Is everything working?

Where the last 7 days of inquiries came from

Which ads they answered

New inquiries, week by week

What the advertising cost

What we have been doing

One thing worth fixing in the CRM

The follow-up system, in detail

What needs doing today

The Dogs Spot, Nurture Control Panel

Right now

Where those people are

Stop everything

${d.journalTotal <= entriesShown && groups.length <= RECENT_ROWS ? \"Everything it has done so far\" : \"What it has been doing\"}

Something went wrong in the last 24 hours

The dormant list — what is actually in it

Who can actually be contacted

How old it really is

The release plan

The Dogs Spot, week of 31 July to 6 August 2026

The thing worth two minutes

Facebook

Where the money went

Google

Your CRM

Where the 175 came from

The 175, since you asked what it counts

The gap between what the ads claim and what your CRM received

Appendix, every number and where it came from

What you spent, and what came back

1. What you spent, and what it brought

What your Square money is doing

What your bookings carry today

2. Where your people came from

3. What happened to those people

4. What your follow up system is doing

Your review pipeline, on one page for the first time

Where your money is, and what is missing

The money Square has sent across

The gap, in one sentence

What your bookings currently carry

What happens the moment the amount gets written

Two things worth knowing that nobody asked about

How Square money reaches your reports

1. What happens today

2. What happens once the reconciliation runs

3. What your staff actually have to do

The corrected unmatched figure you asked for

Diff · v1268