The Guild
diff --git a/playbooks/tests/command-center-smoke.js b/playbooks/tests/command-center-smoke.js
new file mode 100644
index 0000000..8b2f913
--- /dev/null
+++ b/playbooks/tests/command-center-smoke.js
@@ -0,0 +1,387 @@
+/*
+ * Behavioral smoke suite for playbooks/guild-command-center.html
+ *
+ * Run: npm install playwright (Chromium required; uses /opt/pw-browsers/chromium
+ * when present, otherwise Playwright's own browser)
+ * node playbooks/tests/command-center-smoke.js
+ *
+ * Proves: view navigation (incl. client presentation mode), zero external
+ * requests, no horizontal overflow at 390px and desktop, the full field-log
+ * integrity contract (doors 1-20 unique, duplicate/out-of-range/21st-entry
+ * rejection, completion lock, derived cohorts, demo-consistency locks, draft
+ * + reload persistence, escaped CSV, typed-RESET gate), the owner_present /
+ * sit_down_booked schema with its truth cascades, legacy-entry migration,
+ * the RESULTS denominator (demos among answered owner-present conversations),
+ * partial-run INVALID, both 20-door gate verdicts, client-view honesty copy,
+ * tier mapping, and a customer-facing guarantee-language scan.
+ */
+const { chromium } = require("playwright");
+const path = require("path");
+const fs = require("fs");
+
+const FILE = "file://" + path.resolve(__dirname, "..", "guild-command-center.html");
+const BROWSER_CANDIDATES = [
+ "/opt/pw-browsers/chromium",
+ "/Applications/Google Chrome.app/Contents/MacOS/Google Chrome"
+];
+const results = [];
+function check(name, ok, detail) {
+ results.push((ok ? "PASS" : "FAIL") + " " + name + (detail ? " (" + detail + ")" : ""));
+ if (!ok) process.exitCode = 1;
+}
+
+function entry(door, over) {
+ const base = {
+ door_number: door, timestamp: "2026-08-10 09:00", business_name: "Biz " + door,
+ trade: "hvac", price_cohort: door % 2 === 1 ? "$497" : "$997",
+ owner_present: "yes", demo_shown: "yes", demo_result: "absent",
+ outcome: "soft no", sit_down_booked: "no", objection_element: "water",
+ notes: "", callback_date: ""
+ };
+ return Object.assign(base, over || {});
+}
+function noAnswer(door) {
+ return entry(door, { owner_present: "not applicable", demo_shown: "no", demo_result: "not run", outcome: "no answer", sit_down_booked: "no", objection_element: "unread" });
+}
+async function seed(page, entries) {
+ await page.evaluate((data) => {
+ localStorage.setItem("lehi-field-log-v1", JSON.stringify(data));
+ localStorage.removeItem("lehi-field-log-draft-v1");
+ }, entries);
+ await page.reload();
+}
+async function nav(page, view) { await page.click(`#tabbar button[data-view="${view}"]`); }
+
+async function saveDoor(page, o) {
+ if (o.door != null) await page.fill("#door", String(o.door));
+ await page.selectOption("#trade", o.trade || "plumber");
+ if (o.biz) await page.fill("#biz", o.biz);
+ await page.click(`#outcome button[data-v="${o.outcome || "soft no"}"]`);
+ if ((o.outcome || "soft no") !== "no answer") {
+ await page.click(`#ownerPresent button[data-v="${o.owner || "yes"}"]`);
+ await page.click(`#demoShown button[data-v="${o.demoShown || "yes"}"]`);
+ if ((o.demoShown || "yes") === "yes") await page.click(`#demoResult button[data-v="${o.demoResult || "absent"}"]`);
+ await page.click(`#sitDown button[data-v="${o.sit || "no"}"]`);
+ }
+ await page.click(`#element button[data-v="${o.element || "water"}"]`);
+ if (o.notes) await page.fill("#notes", o.notes);
+ if (o.cb) await page.fill("#cb", o.cb);
+ await page.click("#saveBtn");
+}
+
+(async () => {
+ const executablePath = BROWSER_CANDIDATES.find(candidate => fs.existsSync(candidate));
+ const launchOpts = executablePath ? { executablePath } : {};
+ const browser = await chromium.launch(launchOpts);
+
+ /* ================= MOBILE (390px) — full suite ================= */
+ const ctx = await browser.newContext({ viewport: { width: 390, height: 844 }, acceptDownloads: true });
+ const page = await ctx.newPage();
+ const external = [];
+ page.on("request", (r) => { if (!r.url().startsWith("file://")) external.push(r.url()); });
+ await page.goto(FILE);
+ check("m: page loads with title", (await page.title()) === "Guild Command Center");
+
+ // ---- Top status + navigation ----
+ for (const id of ["topProgress","topPhase","nextMoveBtn","tabbar"]) {
+ check("m: #" + id + " present", await page.locator("#" + id).count() === 1);
+ }
+ check("m: starts on COMMAND", await page.locator("#view-command").evaluate(v => v.classList.contains("on")));
+ check("m: phase pill starts Prepare", (await page.locator("#topPhase").textContent()) === "Prepare");
+ check("m: next move says START DOOR 1", (await page.locator("#nextMoveBtn").textContent()).includes("START DOOR 1"));
+ check("m: COMMAND marks Prepare as current", await page.locator('.phase[data-phase="0"] .youarehere').count() === 1);
+ check("m: post-close chips labeled later", (await page.locator(".chip.later").count()) === 3);
+
+ for (const v of ["workflow","log","results","command"]) {
+ await nav(page, v);
+ check("m: nav to " + v.toUpperCase(), await page.locator("#view-" + v).evaluate(el => el.classList.contains("on")));
+ }
+ check("m: no page navigation occurred", page.url().startsWith("file://"));
+
+ // NEXT MOVE routes to LOG when incomplete
+ await page.click("#nextMoveBtn");
+ check("m: NEXT MOVE routes to LOG", await page.locator("#view-log").evaluate(v => v.classList.contains("on")));
+
+ // ---- CLIENT presentation mode ----
+ await nav(page, "client");
+ check("m: client view on", await page.locator("#view-client").evaluate(v => v.classList.contains("on")));
+ check("m: client mode hides tabbar", await page.locator("#tabbar").evaluate(t => getComputedStyle(t).display === "none"));
+ check("m: client mode hides topbar", await page.locator(".topbar").evaluate(t => getComputedStyle(t).display === "none"));
+ check("m: client price maps door 1 → $497", (await page.locator("#cPrice").textContent()).includes("$497"));
+ // Active-door regression: CLIENT must follow the LOG's selected door, not
+ // merely nextDoor() — matters when doors are worked out of sequence.
+ await page.click("#clientExit");
+ await nav(page, "log");
+ await page.fill("#door", "2");
+ await nav(page, "client");
+ check("m: active door 2 (no saves) → CLIENT $997", (await page.locator("#cPrice").textContent()).includes("$997"));
+ await page.click("#clientExit");
+ await nav(page, "log");
+ await page.fill("#door", "5");
+ await nav(page, "client");
+ check("m: active door 5 (no saves) → CLIENT $497", (await page.locator("#cPrice").textContent()).includes("$497"));
+ await page.click("#clientExit");
+ await nav(page, "log");
+ await page.fill("#door", "1");
+ await nav(page, "client");
+ await page.selectOption("#cTrade", "pest control company");
+ await page.fill("#cTown", "Lehi, Utah");
+ await page.click("#cNext0");
+ check("m: prompt uses trade + town", (await page.locator("#cPrompt").textContent()) === "Who should I call for a pest control company in Lehi, Utah?");
+ await page.click("#cCopy");
+ const copyFeedback = await page.waitForFunction(
+ () => (document.getElementById("cCopyMsg").textContent || "").length > 0, null, { timeout: 5000 }
+ ).then(() => true, () => false);
+ check("m: copy gives feedback", copyFeedback);
+ await page.click("#cNext1");
+ await page.click("#cAbsent");
+ const absentText = await page.locator("#cInterpBody").textContent();
+ check("m: ABSENT copy says one answer proves nothing", absentText.includes("one flip of the coin") && absentText.includes("doesn't prove"));
+ await page.click("#cBack3");
+ await page.click("#cPresent");
+ const presentText = await page.locator("#cInterpBody").textContent();
+ check("m: PRESENT copy warns it doesn't always", presentText.includes("doesn't always") && presentText.includes("never proves"));
+ await page.click("#cNext3"); await page.click("#cNext4");
+ check("m: $497 tier lists 4 inclusions", (await page.locator("#cIncludes li").count()) === 4);
+ check("m: honest line present on offer card", (await page.locator(".honest-foot").textContent()).includes("guarantee the work"));
+ const closeCopy = await page.locator("#cClose").textContent();
+ check("m: close copy promises the approved timeframe", closeCopy.includes("within the week"));
+ check("m: close copy does not say within days", !/within days/i.test(closeCopy));
+ check("m: no cohort/experiment language in client view", !/cohort|experiment|odd door|even door/i.test(await page.locator("#view-client").innerText()));
+ await page.click("#clientExit");
+ check("m: client exit returns to operator", await page.locator("#view-command").evaluate(v => v.classList.contains("on")));
+
+ // ---- Customer-facing copy scan (guarantee violations) ----
+ const clientCopy = await page.locator("#view-client").innerText();
+ const scrubbed = clientCopy.replace(/Anyone who guarantees a ranking is lying to you\. I guarantee the work[^"]*"/g, "");
+ check("m: client copy has no guarantee violations",
+ !/(we (?:will |’ll |'ll )?make (?:the )?AI|guarantee[sd]? (?:a |your )?(?:rank|placement|score|result|spot)|you will (?:show up|appear|rank)|#1 in ChatGPT)/i.test(scrubbed));
+
+ // ---- LOG: structure ----
+ await nav(page, "log");
+ for (const id of ["door","trade","biz","notes","cb","cohortDisplay","outcome","ownerPresent","demoShown","demoResult","sitDown","element","saveBtn","exportBtn","resetBtn","resetConfirm","completeBanner"]) {
+ check("m: log #" + id + " present", await page.locator("#" + id).count() === 1);
+ }
+ check("m: trades include wave-one set", (await page.locator("#trade option").allTextContents()).join("|").includes("sprinkler"));
+ check("m: door bounded 1-20 in markup", await page.locator('#door[min="1"][max="20"]').count() === 1);
+ check("m: no manual cohort control", (await page.locator("#cohortDisplay button").count()) === 0);
+ check("m: door 1 derives $497", (await page.locator("#cohortDisplay").textContent()).includes("$497"));
+ await page.fill("#door", "2");
+ check("m: door 2 derives $997", (await page.locator("#cohortDisplay").textContent()).includes("$997"));
+ await page.fill("#door", "1");
+
+ // ---- Cascades ----
+ check("m: owner N/A disabled by default", await page.locator('#ownerPresent button[data-v="not applicable"]').isDisabled());
+ check("m: demo result locked before demoShown", await page.locator('#demoResult button[data-v="present"]').isDisabled());
+ await page.click('#outcome button[data-v="no answer"]');
+ check("m: no-answer forces owner N/A", await page.locator('#ownerPresent button[data-v="not applicable"]').evaluate(b => b.classList.contains("on")));
+ check("m: no-answer locks owner group", await page.locator('#ownerPresent button[data-v="yes"]').isDisabled());
+ check("m: no-answer forces demo no", await page.locator('#demoShown button[data-v="no"]').evaluate(b => b.classList.contains("on")));
+ check("m: no-answer forces not run", await page.locator('#demoResult button[data-v="not run"]').evaluate(b => b.classList.contains("on")));
+ check("m: no-answer forces sit no", await page.locator('#sitDown button[data-v="no"]').evaluate(b => b.classList.contains("on")));
+ check("m: no-answer locks sit group", await page.locator('#sitDown button[data-v="yes"]').isDisabled());
+ await page.click('#outcome button[data-v="soft no"]');
+ check("m: leaving no-answer unlocks owner", !(await page.locator('#ownerPresent button[data-v="yes"]').isDisabled()));
+ check("m: leaving no-answer clears owner N/A", await page.locator('#ownerPresent button[data-v="not applicable"]').evaluate(b => !b.classList.contains("on")));
+ check("m: leaving no-answer unlocks sit", !(await page.locator('#sitDown button[data-v="yes"]').isDisabled()));
+ await page.click('#demoShown button[data-v="no"]');
+ check("m: demo=no forces not run", await page.locator('#demoResult button[data-v="not run"]').evaluate(b => b.classList.contains("on")));
+ check("m: demo=no locks present", await page.locator('#demoResult button[data-v="present"]').isDisabled());
+ await page.click('#demoShown button[data-v="yes"]');
+ check("m: switch to yes clears not-run", await page.locator('#demoResult button[data-v="not run"]').evaluate(b => !b.classList.contains("on")));
+ check("m: yes disables not-run", await page.locator('#demoResult button[data-v="not run"]').isDisabled());
+
+ // ---- Validation guards ----
+ await page.click('#ownerPresent button[data-v="yes"]');
+ await page.click('#outcome button[data-v="soft no"]');
+ await page.selectOption("#trade", "plumber");
+ await page.click('#element button[data-v="water"]');
+ await page.click("#saveBtn"); // demo=yes but no result picked
+ check("m: yes without result rejected", (await page.locator(".msg.err").textContent()).includes("Present or Absent"));
+ await page.click('#demoResult button[data-v="absent"]');
+ await page.click("#saveBtn"); // sit-down not picked
+ check("m: missing sit-down rejected", (await page.locator(".msg.err").textContent()).includes("Sit-down"));
+ await page.fill("#door", "0");
+ await page.click('#sitDown button[data-v="no"]');
+ await page.click("#saveBtn");
+ check("m: door 0 rejected", (await page.locator(".msg.err").textContent()).includes("1–20"));
+ await page.fill("#door", "21");
+ await page.click("#saveBtn");
+ check("m: door 21 rejected", (await page.locator(".msg.err").textContent()).includes("1–20"));
+ check("m: no entries after rejects", (await page.locator("#barLabel").textContent()).trim() === "0 / 20 doors");
+
+ // ---- Valid save with CSV-hostile text ----
+ await page.fill("#door", "1");
+ await page.fill("#biz", 'Joe\'s "Plumbing", LLC');
+ await page.fill("#notes", 'said "another door guy",\nburned by SEO before');
+ await page.fill("#cb", "2026-08-12");
+ await page.click("#saveBtn");
+ check("m: door 1 saved", (await page.locator(".msg.ok").textContent()).includes("Door 1 saved"));
+ check("m: progress 1/20", (await page.locator("#barLabel").textContent()).trim() === "1 / 20 doors");
+ check("m: tally $497:1", (await page.locator("#cohorts").textContent()).includes("$497: 1"));
+ check("m: door auto-advances to 2", (await page.inputValue("#door")) === "2");
+ check("m: entry shows owner + sit in meta", (await page.locator(".entry .meta").first().textContent()).includes("owner yes"));
+ check("m: saved door is a closed disclosure", await page.locator("details.entry").count() === 1 && !(await page.locator("details.entry").first().getAttribute("open")));
+ await page.click("details.entry summary");
+ check("m: saved door opens on tap", await page.locator("details.entry").first().getAttribute("open") !== null);
+ const savedDetails = await page.locator("details.entry .entry-details").first().innerText();
+ check("m: saved door reveals business", savedDetails.includes("Joe's \"Plumbing\", LLC"));
+ check("m: saved door reveals callback date", savedDetails.toLowerCase().includes("callback date") && savedDetails.includes("2026-08-12"));
+ check("m: saved door preserves multiline objection", savedDetails.includes("said \"another door guy\"") && savedDetails.includes("burned by SEO before"));
+ check("m: saved door details are read-only", await page.locator("details.entry .entry-details input, details.entry .entry-details button, details.entry .entry-details textarea, details.entry .entry-details select").count() === 0);
+ check("m: top progress updates", (await page.locator("#topProgress").textContent()) === "1 / 20");
+
+ // ---- Duplicate ----
+ await saveDoor(page, { door: 1, outcome: "no answer", element: "unread" });
+ check("m: duplicate door 1 rejected", (await page.locator(".msg.err").textContent()).includes("already logged"));
+
+ // ---- Shared data: RESULTS + CLIENT see the same store ----
+ await nav(page, "results");
+ check("m: RESULTS counts the saved door", (await page.locator("#statGrid").textContent()).includes("1"));
+ check("m: RESULTS gate incomplete", (await page.locator("#gateVerdict").textContent()).includes("INCOMPLETE"));
+ await nav(page, "client");
+ check("m: CLIENT price follows next door 2 → $997", (await page.locator("#cPrice").textContent()).includes("$997"));
+ await page.click("#clientExit");
+ await nav(page, "log");
+
+ // ---- Persistence + draft ----
+ await page.reload();
+ check("m: entry persists after reload", (await page.locator("#barLabel").textContent()).trim() === "1 / 20 doors");
+ await nav(page, "log");
+ await page.click("details.entry summary");
+ check("m: read-only details persist after reload", (await page.locator("details.entry .entry-details").first().innerText()).includes("2026-08-12"));
+ await page.fill("#notes", "draft-survives-reload");
+ await page.waitForTimeout(100);
+ await page.reload();
+ await nav(page, "log");
+ check("m: draft restored after reload", (await page.inputValue("#notes")) === "draft-survives-reload");
+
+ // ---- CSV ----
+ const [dl1] = await Promise.all([page.waitForEvent("download"), page.click("#exportBtn")]);
+ const csv1 = fs.readFileSync(await dl1.path(), "utf8");
+ check("m: csv header includes new fields in order",
+ csv1.split("\r\n")[0] === "door_number,timestamp,business_name,trade,price_cohort,owner_present,demo_shown,demo_result,outcome,sit_down_booked,objection_element,notes,callback_date");
+ check("m: csv escapes embedded quotes", csv1.includes('"Joe\'s ""Plumbing"", LLC"'));
+ check("m: csv preserves newline in quoted note", csv1.includes('"said ""another door guy"",\nburned by SEO before"'));
+ check("m: csv row carries owner+sit values", /\$497,yes,yes,absent,soft no,no/.test(csv1));
+
+ // ---- Legacy migration (fallback-logger entries) ----
+ await seed(page, [
+ { door_number: 1, timestamp: "2026-08-10 08:00", business_name: "Legacy Shop", trade: "plumber", price_cohort: "$497", demo_shown: "yes", demo_result: "absent", outcome: "soft no", objection_element: "water", notes: "", callback_date: "" },
+ { door_number: 2, timestamp: "2026-08-10 08:10", business_name: "", trade: "hvac", price_cohort: "$997", demo_shown: "no", demo_result: "not run", outcome: "no answer", objection_element: "unread", notes: "", callback_date: "" }
+ ]);
+ check("m: legacy entries still count", (await page.locator("#topProgress").textContent()) === "2 / 20");
+ await nav(page, "log");
+ check("m: legacy answered door shows owner —", (await page.locator(".entry .meta").allTextContents()).some(t => t.includes("owner —")));
+ const [dl2] = await Promise.all([page.waitForEvent("download"), page.click("#exportBtn")]);
+ const csv2 = fs.readFileSync(await dl2.path(), "utf8");
+ check("m: legacy no-answer exports derived N/A", /^2,.*not applicable,no,not run,no answer,no/m.test(csv2));
+ check("m: legacy answered exports empty owner", /^1,[^\n]*\$497,,yes,absent,soft no,,water/m.test(csv2));
+ await nav(page, "results");
+ check("m: legacy incomplete flagged in gate", (await page.locator("#gateDetail").textContent()).includes("missing owner-present"));
+
+ // ---- Denominator correctness (partial data, no verdict) ----
+ await seed(page, [
+ entry(1, { owner_present: "yes", demo_shown: "yes", demo_result: "present" }),
+ entry(2, { owner_present: "yes", demo_shown: "no", demo_result: "not run" }),
+ entry(3, { owner_present: "no", demo_shown: "yes", demo_result: "absent" }),
+ noAnswer(4)
+ ]);
+ await nav(page, "results");
+ const demoCard = await page.locator("#demoRateCard").textContent();
+ check("m: demo denominator = owner-present answered (2)", demoCard.includes("of 2 owner conversations"));
+ check("m: demo numerator = 1 → 50%", demoCard.includes("50%"));
+ check("m: partial run stays no-verdict", (await page.locator("#gateVerdict").textContent()).includes("no verdict"));
+
+ // ---- Complete 20: PASS scenario ----
+ const passSet = [];
+ for (let d = 1; d <= 20; d++) {
+ if (d <= 4) passSet.push(noAnswer(d));
+ else if (d <= 14) passSet.push(entry(d, {
+ owner_present: "yes",
+ demo_shown: d <= 10 ? "yes" : "no",
+ demo_result: d <= 10 ? (d % 2 ? "present" : "absent") : "not run",
+ outcome: d === 5 ? "closed" : (d <= 8 ? "callback set" : "soft no"),
+ sit_down_booked: d >= 6 && d <= 8 ? "yes" : "no"
+ }));
+ else passSet.push(entry(d, { owner_present: "no", demo_shown: "no", demo_result: "not run" }));
+ }
+ await seed(page, passSet);
+ await nav(page, "results");
+ check("m: complete-run gate PASS", (await page.locator("#gateVerdict").textContent()).includes("LEARN GATES MET"));
+ check("m: PASS detail uses owner denominator", (await page.locator("#gateDetail").textContent()).includes("of 10 owner conversations"));
+ check("m: cohort card labeled direction only", (await page.locator("#cohortCard").textContent()).includes("direction"));
+ check("m: log locks at completion", await page.locator("#saveBtn").isDisabled());
+ check("m: phase advances to First close", (await page.locator("#topPhase").textContent()) === "First close");
+ check("m: NEXT MOVE routes to results at 20", (await page.locator("#nextMoveBtn").textContent()).includes("RESULTS"));
+ await nav(page, "log");
+ await page.evaluate(() => document.getElementById("f").requestSubmit());
+ check("m: 21st save rejected", (await page.locator(".msg.err").textContent()).includes("Sprint complete"));
+ check("m: entry count stays 20", await page.evaluate(() => JSON.parse(localStorage.getItem("lehi-field-log-v1")).length) === 20);
+
+ // ---- Complete 20: ATTENTION scenario ----
+ const missSet = [];
+ for (let d = 1; d <= 20; d++) {
+ if (d <= 4) missSet.push(noAnswer(d));
+ else if (d <= 14) missSet.push(entry(d, {
+ owner_present: "yes",
+ demo_shown: d <= 6 ? "yes" : "no",
+ demo_result: d <= 6 ? "absent" : "not run",
+ outcome: "soft no", sit_down_booked: d === 5 ? "yes" : "no"
+ }));
+ else missSet.push(entry(d, { owner_present: "no", demo_shown: "no", demo_result: "not run" }));
+ }
+ await seed(page, missSet);
+ await nav(page, "results");
+ check("m: gates-not-met verdict", (await page.locator("#gateVerdict").textContent()).includes("GATES NOT MET"));
+ const missDetail = await page.locator("#gateDetail").textContent();
+ check("m: miss detail names demo gate", missDetail.includes("<50%"));
+ check("m: miss detail names offer gate", missDetail.includes("sit-downs"));
+
+ // ---- Reset (typed gate) from RESULTS-shared store via LOG ----
+ await nav(page, "log");
+ await page.click(".reset-box summary");
+ check("m: reset disabled before typing", await page.locator("#resetBtn").isDisabled());
+ await page.fill("#resetConfirm", "reset");
+ check("m: reset disabled wrong case", await page.locator("#resetBtn").isDisabled());
+ await page.fill("#resetConfirm", "RESET");
+ check("m: reset armed by RESET", !(await page.locator("#resetBtn").isDisabled()));
+ await page.click("#resetBtn");
+ check("m: reset clears to 0/20", (await page.locator("#barLabel").textContent()).trim() === "0 / 20 doors");
+ check("m: reset re-enables save", !(await page.locator("#saveBtn").isDisabled()));
+ await page.reload();
+ check("m: reset persists", (await page.locator("#topProgress").textContent()) === "0 / 20");
+
+ // ---- Overflow + network (mobile) ----
+ for (const v of ["command","workflow","log","results"]) {
+ await nav(page, v);
+ const w = await page.evaluate(() => document.documentElement.scrollWidth);
+ check("m: no horizontal overflow on " + v, w <= 390, "scrollWidth=" + w);
+ }
+ await nav(page, "client");
+ const wc = await page.evaluate(() => document.documentElement.scrollWidth);
+ check("m: no horizontal overflow on client", wc <= 390, "scrollWidth=" + wc);
+ check("m: zero external requests (mobile)", external.length === 0, external.join(", ") || "none");
+ await ctx.close();
+
+ /* ================= DESKTOP (1280px) ================= */
+ const dctx = await browser.newContext({ viewport: { width: 1280, height: 800 } });
+ const dpage = await dctx.newPage();
+ const dexternal = [];
+ dpage.on("request", (r) => { if (!r.url().startsWith("file://")) dexternal.push(r.url()); });
+ await dpage.goto(FILE);
+ check("d: loads at desktop", (await dpage.title()) === "Guild Command Center");
+ check("d: rail is vertical at desktop", await dpage.locator("#tabbar").evaluate(t => getComputedStyle(t).flexDirection === "column"));
+ for (const v of ["workflow","log","results","command"]) {
+ await dpage.click(`#tabbar button[data-view="${v}"]`);
+ check("d: nav to " + v, await dpage.locator("#view-" + v).evaluate(el => el.classList.contains("on")));
+ }
+ const dw = await dpage.evaluate(() => document.documentElement.scrollWidth);
+ check("d: no horizontal overflow", dw <= 1280, "scrollWidth=" + dw);
+ check("d: zero external requests (desktop)", dexternal.length === 0, dexternal.join(", ") || "none");
+ await dctx.close();
+
+ await browser.close();
+ console.log(results.join("\n"));
+ console.log(results.filter(r => r.startsWith("FAIL")).length + " failures / " + results.length + " checks");
+})().catch(e => { console.error("SMOKE CRASH:", e); process.exit(1); });
diff --git a/pwa/README.md b/pwa/README.md
new file mode 100644
index 0000000..491fd13
--- /dev/null
+++ b/pwa/README.md
@@ -0,0 +1,48 @@
+# Guild Command Center PWA
+
+The canonical application source is `playbooks/guild-command-center.html`.
+The PWA shell in this directory adds installability, offline caching, icons,
+security headers, guarded CSV restore, and update handling without adding a
+backend, login, CRM, API call, or paid service.
+
+## Live release
+
+- **URL:** https://guild-command-center.brandonwadepackard.workers.dev
+- **Status:** RELEASE_READY for the Lehi 20-door field sprint — v1.0.1
+ automated + live checks passed at source commit `a46c2ba`; actual-iPhone
+ install, save, saved-row open, export, airplane-mode reopen, and typed reset
+ are complete.
+- **Receipt:** `pwa/RELEASE-2026-08-09.md` (etag, byte hashes, live checks).
+- Transport is a static Cloudflare Worker with no bindings, storage,
+ analytics, API, payment, CRM, or OpenAI dependency. The URL is
+ public-by-URL; all field data stays device-local.
+
+## Build and test
+
+```bash
+npm ci
+npm run build
+npm test
+```
+
+`npm run build` stages only the public app files in ignored `dist/`. It copies
+the canonical HTML byte-for-byte to `dist/index.html`, so the artifact and the
+deployed app cannot silently become two different products.
+
+## Data contract
+
+- Door data stays in this browser/device's local storage.
+- Export CSV at the end of every field session and before reset or restore.
+- CSV restore validates the exact schema, unique doors 1–20, locked odd/even
+ price cohorts, and demo/no-answer truth rules before showing a destructive
+ confirmation. It never merges ambiguous records.
+- The service worker caches the app shell, not the field log. Browser storage
+ remains the canonical working copy; the exported CSV is the portable backup.
+
+## Release proof
+
+Desktop automation proves build identity, manifest/install assets, security
+configuration, guarded restore, persistence across reopen, and offline reopen
+after first load. A release remains limited-test ready until Brandon proves on
+his actual phone: Add to Home Screen, save/export, close/reopen, airplane-mode
+reopen, restore, then typed reset.
diff --git a/pwa/RELEASE-2026-08-09.md b/pwa/RELEASE-2026-08-09.md
new file mode 100644
index 0000000..bb947aa
--- /dev/null
+++ b/pwa/RELEASE-2026-08-09.md
@@ -0,0 +1,69 @@
+# Guild Command Center — Release Receipt — 2026-08-09
+
+Verdict: **RELEASE_READY** for the Lehi 20-door field sprint. Brandon completed
+the actual-iPhone install, save, read-only detail open, CSV export, app close,
+airplane-mode reopen with data intact, and typed-reset cleanup. Deployment was
+verified by Codex (Mac lane); device steps were performed and reported by
+Brandon, with the opened saved-record state captured in the session.
+
+## Release identity
+
+| Item | Value |
+|---|---|
+| Live URL | https://guild-command-center.brandonwadepackard.workers.dev |
+| App source commit | `a46c2ba8145e0414c3263c8ad2e1b448ecc3fe17` |
+| Saved-log feature commit | `30820cf8774b2645264f4642f3cd07913ea28680` |
+| Cloudflare Worker upload etag | `e052dbf494c33e2e7bd862ecd5ad00a16456153afc78bba077bd6acb5fa81b7c` |
+| Live `X-Guild-Commit` header | `a46c2ba…` |
+
+## Byte hashes of the live assets (SHA-256)
+
+| Asset | Hash |
+|---|---|
+| HTML (`/index.html`) | `4fb41f047739923855023eba3c7260f0d00f33ded2332e93868a7de0a353f8ae` |
+| `manifest.webmanifest` | `dbf2432f33834797c5fa2645dc154b3ca123882df7fd48c4a5c1750983d6aa2a` |
+| `sw.js` | `59feb26d312c47d6439718c5706640833f35c2f1f250db337a7857d82790f9af` |
+
+## Automated proof (at source commit `a46c2ba`)
+
+- Command Center smoke: **137/137** · PWA smoke: **27/27** · total **164/164**
+- The PWA suite passed three consecutive offline runs after its asynchronous
+ offline-status assertion was stabilized.
+- `npm audit --omit=dev`: 0 vulnerabilities · secret-shape scan: clean
+
+## Live checks (verified against the deployed URL)
+
+- HTTPS 200 · service worker takes control · saved state survives
+ close/reopen and offline reload · zero external requests
+- A saved row starts closed, opens to all recorded fields, exposes no mutation
+ controls, and still opens after close/reopen and while offline.
+- Unknown routes 404 · POST 405
+- Headers: CSP self-only · `X-Frame-Options: DENY` · no-cache release
+ headers · `X-Guild-Commit: a46c2ba…`
+
+## Transport and data posture
+
+Static Cloudflare Worker with **no bindings, storage, analytics, API,
+payment, CRM, or OpenAI dependency**. The URL is public-by-URL; it serves
+only the app shell. All field data remains device-local (browser
+localStorage); the exported CSV is the portable backup.
+
+## Source of truth
+
+The canonical application source remains
+`playbooks/guild-command-center.html`. `dist/` stays generated and
+gitignored — the build stages a byte-identical copy, so the artifact,
+repo, and deployed app cannot silently diverge.
+
+## Real-device proof completed
+
+- Installed from Safari to the actual iPhone Home Screen.
+- Saved PHONE PROOF and confirmed the counter at 1/20.
+- Opened the saved row after the v1.0.1 update; the captured screen shows all
+ recorded fields and the read-only disclosure state.
+- Exported the CSV to Gmail as the portable backup.
+- Closed the app, enabled airplane mode, reopened the installed app, and
+ confirmed the saved record and details still worked.
+- Used the typed RESET gate after export and confirmed cleanup worked.
+
+No blocking release gate remains for the approved Lehi field-sprint scope.
diff --git a/pwa/_headers b/pwa/_headers
new file mode 100644
index 0000000..d4a61c6
--- /dev/null
+++ b/pwa/_headers
@@ -0,0 +1,24 @@
+/*
+ X-Content-Type-Options: nosniff
+ Referrer-Policy: no-referrer
+ X-Frame-Options: DENY
+ Permissions-Policy: camera=(), microphone=(), geolocation=(), payment=()
+ Content-Security-Policy: default-src 'self'; script-src 'self' 'unsafe-inline'; style-src 'self' 'unsafe-inline'; img-src 'self' data:; connect-src 'self'; worker-src 'self'; manifest-src 'self'; object-src 'none'; base-uri 'none'; frame-ancestors 'none'
+
+/
+ Cache-Control: no-cache, no-store, must-revalidate
+
+/index.html
+ Cache-Control: no-cache, no-store, must-revalidate
+
+/sw.js
+ Cache-Control: no-cache, no-store, must-revalidate
+ Service-Worker-Allowed: /
+
+/manifest.webmanifest
+ Cache-Control: no-cache
+ Content-Type: application/manifest+json
+
+/icons/*
+ Cache-Control: public, max-age=31536000, immutable
+
diff --git a/pwa/icons/icon-192.png b/pwa/icons/icon-192.png
new file mode 100644
index 0000000..36bee9c
Binary files /dev/null and b/pwa/icons/icon-192.png differ
diff --git a/pwa/icons/icon-512.png b/pwa/icons/icon-512.png
new file mode 100644
index 0000000..44ea883
Binary files /dev/null and b/pwa/icons/icon-512.png differ
diff --git a/pwa/icons/icon-maskable-512.png b/pwa/icons/icon-maskable-512.png
new file mode 100644
index 0000000..44ea883
Binary files /dev/null and b/pwa/icons/icon-maskable-512.png differ
diff --git a/pwa/icons/icon-source.svg b/pwa/icons/icon-source.svg
new file mode 100644
index 0000000..dce6718
--- /dev/null
+++ b/pwa/icons/icon-source.svg
@@ -0,0 +1,7 @@
+
+
diff --git a/pwa/manifest.webmanifest b/pwa/manifest.webmanifest
new file mode 100644
index 0000000..c539432
--- /dev/null
+++ b/pwa/manifest.webmanifest
@@ -0,0 +1,34 @@
+{
+ "id": "/",
+ "name": "Guild Command Center",
+ "short_name": "Guild",
+ "description": "Offline field command center for The Guild's 20-door Lehi learn sprint.",
+ "start_url": "/",
+ "scope": "/",
+ "display": "standalone",
+ "orientation": "any",
+ "background_color": "#F7F8F6",
+ "theme_color": "#16334E",
+ "categories": ["business", "productivity"],
+ "icons": [
+ {
+ "src": "/icons/icon-192.png",
+ "sizes": "192x192",
+ "type": "image/png",
+ "purpose": "any"
+ },
+ {
+ "src": "/icons/icon-512.png",
+ "sizes": "512x512",
+ "type": "image/png",
+ "purpose": "any"
+ },
+ {
+ "src": "/icons/icon-maskable-512.png",
+ "sizes": "512x512",
+ "type": "image/png",
+ "purpose": "maskable"
+ }
+ ]
+}
+
diff --git a/pwa/sw.js b/pwa/sw.js
new file mode 100644
index 0000000..6638dc9
--- /dev/null
+++ b/pwa/sw.js
@@ -0,0 +1,59 @@
+/* Guild Command Center offline shell. Bump CACHE_VERSION for every release. */
+const CACHE_VERSION = "guild-command-center-v1.0.1";
+const APP_SHELL = [
+ "/",
+ "/index.html",
+ "/manifest.webmanifest",
+ "/icons/icon-192.png",
+ "/icons/icon-512.png",
+ "/icons/icon-maskable-512.png"
+];
+
+self.addEventListener("install", (event) => {
+ event.waitUntil(caches.open(CACHE_VERSION).then((cache) => cache.addAll(APP_SHELL)));
+});
+
+self.addEventListener("activate", (event) => {
+ event.waitUntil(
+ caches.keys()
+ .then((keys) => Promise.all(keys.filter((key) => key !== CACHE_VERSION).map((key) => caches.delete(key))))
+ .then(() => self.clients.claim())
+ );
+});
+
+self.addEventListener("message", (event) => {
+ if (event.data && event.data.type === "SKIP_WAITING") self.skipWaiting();
+});
+
+self.addEventListener("fetch", (event) => {
+ const request = event.request;
+ if (request.method !== "GET") return;
+ const url = new URL(request.url);
+ if (url.origin !== self.location.origin) return;
+
+ if (request.mode === "navigate") {
+ event.respondWith(
+ fetch(request)
+ .then((response) => {
+ const copy = response.clone();
+ caches.open(CACHE_VERSION).then((cache) => cache.put("/index.html", copy));
+ return response;
+ })
+ .catch(() => caches.match("/index.html"))
+ );
+ return;
+ }
+
+ event.respondWith(
+ caches.match(request).then((cached) => {
+ if (cached) return cached;
+ return fetch(request).then((response) => {
+ if (response.ok) {
+ const copy = response.clone();
+ caches.open(CACHE_VERSION).then((cache) => cache.put(request, copy));
+ }
+ return response;
+ });
+ })
+ );
+});
diff --git a/pwa/tests/pwa-smoke.js b/pwa/tests/pwa-smoke.js
new file mode 100644
index 0000000..ab43d68
--- /dev/null
+++ b/pwa/tests/pwa-smoke.js
@@ -0,0 +1,122 @@
+/* End-to-end PWA, offline, persistence, and guarded-restore proof. */
+const { chromium } = require("playwright");
+const { execFileSync } = require("child_process");
+const fs = require("fs");
+const http = require("http");
+const path = require("path");
+
+const ROOT = path.resolve(__dirname, "..", "..");
+const DIST = path.join(ROOT, "dist");
+const results = [];
+function check(name, ok, detail) {
+ results.push((ok ? "PASS" : "FAIL") + " " + name + (detail ? " (" + detail + ")" : ""));
+ if (!ok) process.exitCode = 1;
+}
+function contentType(file) {
+ if (file.endsWith(".html")) return "text/html; charset=utf-8";
+ if (file.endsWith(".js")) return "text/javascript; charset=utf-8";
+ if (file.endsWith(".webmanifest")) return "application/manifest+json";
+ if (file.endsWith(".png")) return "image/png";
+ return "application/octet-stream";
+}
+function launchOptions() {
+ const candidates = [
+ "/opt/pw-browsers/chromium",
+ "/Applications/Google Chrome.app/Contents/MacOS/Google Chrome"
+ ];
+ const executablePath = candidates.find((candidate) => fs.existsSync(candidate));
+ return executablePath ? { executablePath } : {};
+}
+
+(async () => {
+ execFileSync("bash", [path.join(ROOT, "scripts", "build-guild-pwa.sh")], { cwd: ROOT, stdio: "pipe" });
+ check("build output is byte-identical to canonical HTML", fs.readFileSync(path.join(DIST, "index.html")).equals(fs.readFileSync(path.join(ROOT, "playbooks", "guild-command-center.html"))));
+
+ const manifest = JSON.parse(fs.readFileSync(path.join(DIST, "manifest.webmanifest"), "utf8"));
+ check("manifest names the Guild Command Center", manifest.name === "Guild Command Center" && manifest.short_name === "Guild");
+ check("manifest launches standalone at root", manifest.display === "standalone" && manifest.start_url === "/" && manifest.scope === "/");
+ check("manifest has 192, 512, and maskable icons", manifest.icons.some((i) => i.sizes === "192x192") && manifest.icons.some((i) => i.sizes === "512x512" && i.purpose === "any") && manifest.icons.some((i) => i.purpose === "maskable"));
+ for (const icon of manifest.icons) check("manifest icon exists: " + icon.src, fs.existsSync(path.join(DIST, icon.src.replace(/^\//, ""))));
+ const headers = fs.readFileSync(path.join(DIST, "_headers"), "utf8");
+ check("deployment headers deny framing and external connections", headers.includes("X-Frame-Options: DENY") && headers.includes("connect-src 'self'") && headers.includes("frame-ancestors 'none'"));
+ check("service worker and HTML use no-cache release headers", headers.includes("/sw.js") && headers.includes("no-cache, no-store, must-revalidate"));
+
+ const server = http.createServer((req, res) => {
+ const rawPath = new URL(req.url, "http://localhost").pathname;
+ const relative = rawPath === "/" ? "index.html" : decodeURIComponent(rawPath.replace(/^\/+/, ""));
+ const file = path.resolve(DIST, relative);
+ if (!file.startsWith(DIST + path.sep) || !fs.existsSync(file) || fs.statSync(file).isDirectory()) {
+ res.writeHead(404); res.end("not found"); return;
+ }
+ res.writeHead(200, { "Content-Type": contentType(file), "Cache-Control": "no-cache" });
+ fs.createReadStream(file).pipe(res);
+ });
+ await new Promise((resolve) => server.listen(0, "127.0.0.1", resolve));
+ const origin = `http://127.0.0.1:${server.address().port}`;
+ const browser = await chromium.launch(launchOptions());
+ const context = await browser.newContext({ viewport: { width: 390, height: 844 } });
+ const page = await context.newPage();
+ const external = [];
+ page.on("request", (request) => { if (!request.url().startsWith(origin)) external.push(request.url()); });
+ await page.goto(origin, { waitUntil: "networkidle" });
+ check("live app links its manifest", await page.locator('link[rel="manifest"]').getAttribute("href") === "manifest.webmanifest");
+ check("live app exposes install guidance", await page.locator("#installBtn").count() === 1 && (await page.locator("#installHelp").textContent()).includes("Add to Home Screen"));
+ await page.waitForFunction(() => navigator.serviceWorker && navigator.serviceWorker.controller, null, { timeout: 10000 });
+ check("service worker controls the live app", await page.evaluate(() => !!navigator.serviceWorker.controller));
+ check("offline-ready state is visible", await page.locator("#installDot").evaluate((el) => el.classList.contains("ready")));
+
+ const validCSV = [
+ "door_number,timestamp,business_name,trade,price_cohort,owner_present,demo_shown,demo_result,outcome,sit_down_booked,objection_element,notes,callback_date",
+ '1,2026-08-09 10:00,"