4daa0f1 · 096df03
@@ -31,7 +31,14 @@
to make a listing of your own.
   press **Save and write all again**: the new price is on the flyer, every
   asset is written again from the facts (your edits are replaced), and the
   approval is cleared, so it says "0 of 6 approved". The photos stay.
7. **Print the flyer.** Press **Print flyer**: a one-page flyer opens with
7. **Add an open house.** Press **Edit facts** again. Under "Open house"
   pick a date, a start and an end time (Alder Lane's sample already has one),
   then press **Save and write all again**. The flyer gets a band under the
   price, the email a line above its body, and the MLS description and every
   post a closing line, such as "Open Sunday, March 7, 1–3 pm", all in the
   listing's tone. Clearing the three boxes takes it off again. The times are
   kept as you type them: no time zone is applied.
8. **Print the flyer.** Press **Print flyer**: a one-page flyer opens with
   the photo, price, facts, description and your name. Print it or save it
   as a PDF.
@@ -235,6 +242,8 @@
curl -X PATCH https://<app>/api/listings/1 -H 'content-type: application/json' -
curl -X PATCH https://<app>/api/listings/1 -H 'content-type: application/json' -d '{"tone":"bold"}'
# change facts (any launch field); every asset is written again, approvals cleared
curl -X PATCH https://<app>/api/listings/1 -H 'content-type: application/json' -d '{"facts":{"price":649000}}'
# an open house (up to two; local date and 24-hour times as typed; [] clears)
curl -X PATCH https://<app>/api/listings/1 -H 'content-type: application/json' -d '{"facts":{"open_houses":[{"date":"2027-03-07","start":"13:00","end":"15:00"}]}}'
curl -X DELETE https://<app>/api/listings/1
```
@@ -397,6 +397,33 @@
                    "type": "string",
                    "format": "email",
                    "maxLength": 120
                  },
                  "open_houses": {
                    "type": "array",
                    "maxItems": 2,
                    "description": "Up to two open houses, in local time as typed: a real date (YYYY-MM-DD), start and end as HH:MM with the end after the start. An empty list clears them.",
                    "items": {
                      "type": "object",
                      "properties": {
                        "date": {
                          "type": "string",
                          "format": "date"
                        },
                        "start": {
                          "type": "string",
                          "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$"
                        },
                        "end": {
                          "type": "string",
                          "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$"
                        }
                      },
                      "required": [
                        "date",
                        "start",
                        "end"
                      ]
                    }
                  }
                },
                "required": [
@@ -618,6 +645,33 @@
                        "type": "string",
                        "format": "email",
                        "maxLength": 120
                      },
                      "open_houses": {
                        "type": "array",
                        "maxItems": 2,
                        "description": "Up to two open houses, in local time as typed: a real date (YYYY-MM-DD), start and end as HH:MM with the end after the start. An empty list clears them.",
                        "items": {
                          "type": "object",
                          "properties": {
                            "date": {
                              "type": "string",
                              "format": "date"
                            },
                            "start": {
                              "type": "string",
                              "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$"
                            },
                            "end": {
                              "type": "string",
                              "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$"
                            }
                          },
                          "required": [
                            "date",
                            "start",
                            "end"
                          ]
                        }
                      }
                    }
                  },
@@ -1064,6 +1118,33 @@
            "format": "email",
            "maxLength": 120
          },
          "open_houses": {
            "type": "array",
            "maxItems": 2,
            "description": "Up to two open houses, in local time as typed: a real date (YYYY-MM-DD), start and end as HH:MM with the end after the start. An empty list clears them.",
            "items": {
              "type": "object",
              "properties": {
                "date": {
                  "type": "string",
                  "format": "date"
                },
                "start": {
                  "type": "string",
                  "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$"
                },
                "end": {
                  "type": "string",
                  "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$"
                }
              },
              "required": [
                "date",
                "start",
                "end"
              ]
            }
          },
          "photos": {
            "type": "array",
            "items": {
@@ -1242,6 +1323,7 @@
          "license",
          "agent_phone",
          "agent_email",
          "open_houses",
          "photos",
          "headshot",
          "created_at",
@@ -1344,6 +1426,33 @@
            "format": "email",
            "maxLength": 120
          },
          "open_houses": {
            "type": "array",
            "maxItems": 2,
            "description": "Up to two open houses, in local time as typed: a real date (YYYY-MM-DD), start and end as HH:MM with the end after the start. An empty list clears them.",
            "items": {
              "type": "object",
              "properties": {
                "date": {
                  "type": "string",
                  "format": "date"
                },
                "start": {
                  "type": "string",
                  "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$"
                },
                "end": {
                  "type": "string",
                  "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$"
                }
              },
              "required": [
                "date",
                "start",
                "end"
              ]
            }
          },
          "photos": {
            "type": "array",
            "items": {
@@ -1415,6 +1524,7 @@
          "license",
          "agent_phone",
          "agent_email",
          "open_houses",
          "photos",
          "headshot",
          "created_at",
@@ -0,0 +1,7 @@
# Open house
New component classes, all built from existing tokens:
- `flyer-open` — the band under the price on the flyer (`static/app.css`); it also carries `brand-fill`, the agent's colour.
- `listing-open` — the open house line under the facts in a listing's head.
- `open-grid` — the form's date / start / end row, a `facts-grid` with the same columns.
@@ -19,6 +19,7 @@
import {
  fromRow,
  isKind,
  isTone,
  touchesOpenHouses,
  validate,
  type AssetRow,
  type Caller,
@@ -325,7 +326,7 @@
export interface Upload {
}
const LISTING_COLUMNS =
  "address, beds, baths, sqft, lot, year, price, features, tone, palette, agent_name, brokerage, license, agent_phone, agent_email";
  "address, beds, baths, sqft, lot, year, price, features, tone, palette, agent_name, brokerage, license, agent_phone, agent_email, open_houses";
/** A listing with its assets, or nothing. */
function launched(db: Database, id: number): Launched | undefined {
@@ -365,7 +366,7 @@
export function insertListing(
    const row = db
      .query<ListingRow, (string | number | null)[]>(
        `INSERT INTO listing (author_id, author_name, ${LISTING_COLUMNS}, photos, headshot)
         VALUES (?1, ?2, ?3, ?4, ?5, ?6, ?7, ?8, ?9, ?10, ?11, ?12, ?13, ?14, ?15, ?16, ?17, ?18, ?19) RETURNING *`,
         VALUES (?1, ?2, ?3, ?4, ?5, ?6, ?7, ?8, ?9, ?10, ?11, ?12, ?13, ?14, ?15, ?16, ?17, ?18, ?19, ?20) RETURNING *`,
      )
      .get(
        author.id,
@@ -385,6 +386,7 @@
export function insertListing(
        input.license,
        input.agent_phone,
        input.agent_email,
        JSON.stringify(input.open_houses),
        JSON.stringify(photos),
        headshot,
      )!;
@@ -794,6 +796,8 @@
function changeFacts(
    license: now.license,
    agent_phone: now.agent_phone,
    agent_email: now.agent_email,
    // Left out, the open houses stay; the form's open1_… fields or `open_houses` replace them.
    ...(touchesOpenHouses(input.fields) ? {} : { open_houses: now.open_houses }),
    ...input.fields,
  });
  if (!valid.ok) return fail("invalid", valid.message);
@@ -802,11 +806,11 @@
function changeFacts(
    db.query(
      `UPDATE listing SET address = ?1, beds = ?2, baths = ?3, sqft = ?4, lot = ?5, year = ?6, price = ?7,
         features = ?8, tone = ?9, palette = ?10, agent_name = ?11, brokerage = ?12, license = ?13,
         agent_phone = ?14, agent_email = ?15 WHERE id = ?16`,
         agent_phone = ?14, agent_email = ?15, open_houses = ?16 WHERE id = ?17`,
    ).run(
      v.address, v.beds, v.baths, v.sqft, v.lot, v.year, v.price,
      JSON.stringify(v.features), v.tone, v.palette, v.agent_name, v.brokerage,
      v.license, v.agent_phone, v.agent_email, now.id,
      v.license, v.agent_phone, v.agent_email, JSON.stringify(v.open_houses), now.id,
    );
    touch(db, now.id);
    writeAssets(db, { ...now, ...v });
@@ -90,6 +90,8 @@
export const migrations: string[] = [
  `ALTER TABLE asset ADD COLUMN approved_at TEXT`,
  // Which door the sign-off came through (page, api, tty); null before this was recorded.
  `ALTER TABLE asset ADD COLUMN approved_via TEXT`,
  // Up to two open houses, as typed: a JSON list of { date, start, end }, local time, never converted.
  `ALTER TABLE listing ADD COLUMN open_houses TEXT NOT NULL DEFAULT '[]'`,
];
export function openDb(dir = dataDir): Database {
@@ -33,6 +33,13 @@
export const LABELS: Readonly<Record<Kind, string>> = {
  email: "Email blast",
};
/** One open house, as typed: the local date (YYYY-MM-DD) and 24-hour times (HH:MM). Never converted. */
export interface OpenHouse {
  readonly date: string;
  readonly start: string;
  readonly end: string;
}
export interface Facts {
  readonly address: string;
  readonly beds: number;
@@ -43,6 +50,7 @@
export interface Facts {
  readonly price: number;
  readonly features: readonly string[];
  readonly tone: Tone;
  readonly open_houses?: readonly OpenHouse[];
}
export interface Agent {
@@ -123,10 +131,55 @@
export const factsLine = (f: Facts): string => {
  ].join(" · ");
};
const WEEKDAYS = ["Sunday", "Monday", "Tuesday", "Wednesday", "Thursday", "Friday", "Saturday"];
const MONTHS = [
  "January", "February", "March", "April", "May", "June",
  "July", "August", "September", "October", "November", "December",
];
/** "13:30" → { h: 1, m: "30", pm: true }, on a 12-hour clock. */
const clock = (t: string): { h: number; m: string; pm: boolean } => {
  const h = Number(t.slice(0, 2));
  return { h: h % 12 === 0 ? 12 : h % 12, m: t.slice(3, 5), pm: h >= 12 };
};
const hm = (c: { h: number; m: string }): string => (c.m === "00" ? `${c.h}` : `${c.h}:${c.m}`);
/** "1–3 pm", "11 am–1 pm", "1:30–3 pm": the meridiem said once when both ends share it. */
export const timeRange = (start: string, end: string): string => {
  const a = clock(start);
  const b = clock(end);
  const tail = `${hm(b)} ${b.pm ? "pm" : "am"}`;
  return a.pm === b.pm ? `${hm(a)}–${tail}` : `${hm(a)} ${a.pm ? "pm" : "am"}–${tail}`;
};
/** "Sunday, March 9, 1–3 pm", from the date and times as typed (no zone is ever applied). */
export const whenOf = (o: OpenHouse): string => {
  const [y, m, d] = o.date.split("-").map(Number) as [number, number, number];
  const day = WEEKDAYS[new Date(Date.UTC(y, m - 1, d)).getUTCDay()]!;
  return `${day}, ${MONTHS[m - 1]} ${d}, ${timeRange(o.start, o.end)}`;
};
/** The open house as a person would say it, in the listing's tone; null when there is none. */
export const openHouseLine = (f: Facts): string | null => {
  const when = (f.open_houses ?? []).map(whenOf).join(" and ");
  if (when === "") return null;
  return {
    classic: `Open ${when}.`,
    warm: `Come by the open house: ${when}.`,
    bold: `OPEN HOUSE: ${when}.`,
  }[f.tone];
};
const signature = (a: Agent): string =>
  `${a.name} · ${a.brokerage} · Lic. ${a.license}`;
function mls(f: Facts): string {
  const text = mlsText(f);
  const open = openHouseLine(f);
  return open === null ? text : `${text}\n${open}`;
}
function mlsText(f: Facts): string {
  const where = f.address;
  const size = `${num(f.beds)}-bedroom, ${num(f.baths)}-bath`;
  const sized = withArticle(size);
@@ -142,13 +195,14 @@
function mls(f: Facts): string {
}
function socialShort(f: Facts, a: Agent): string {
  const open = openHouseLine(f);
  const lead = {
    classic: "Just listed",
    warm: "Just listed, and we love it",
    bold: "JUST LISTED",
  }[f.tone];
  const first = f.features[0] === undefined ? "" : ` ${sentence(f.features[0])}`;
  return `${lead}: ${street(f.address)} · ${num(f.beds)} bd · ${num(f.baths)} ba · ${count(f.sqft)} sq ft · ${money(f.price)}.${first} ${a.name}, ${a.brokerage}. #JustListed #NewListing`;
  return `${lead}: ${street(f.address)} · ${num(f.beds)} bd · ${num(f.baths)} ba · ${count(f.sqft)} sq ft · ${money(f.price)}.${first}${open === null ? "" : ` ${open}`} ${a.name}, ${a.brokerage}. #JustListed #NewListing`;
}
function socialMedium(f: Facts, a: Agent): string {
@@ -166,10 +220,12 @@
function socialMedium(f: Facts, a: Agent): string {
    warm: "I would love to show you around. Send me a message to set up a visit.",
    bold: "Showings are filling up. Message me today.",
  }[f.tone];
  return `${open}\n\n${plural(f.beds, "bedroom")} · ${plural(f.baths, "bath")} · ${count(f.sqft)} sq ft · built ${f.year}\n\n${top}\n\n${close}\n${signature(a)} · ${a.phone}\n#JustListed #HomeForSale`;
  const when = openHouseLine(f);
  return `${open}\n\n${plural(f.beds, "bedroom")} · ${plural(f.baths, "bath")} · ${count(f.sqft)} sq ft · built ${f.year}\n\n${top}\n\n${when === null ? "" : `${when}\n`}${close}\n${signature(a)} · ${a.phone}\n#JustListed #HomeForSale`;
}
function socialCarousel(f: Facts, a: Agent): string {
  const open = openHouseLine(f);
  const slides = [
    {
      classic: `Just listed: ${street(f.address)}`,
@@ -177,6 +233,7 @@
function socialCarousel(f: Facts, a: Agent): string {
      bold: `${street(f.address)}. Just listed.`,
    }[f.tone],
    `${money(f.price)} · ${num(f.beds)} bd · ${num(f.baths)} ba · ${count(f.sqft)} sq ft`,
      
        sentinelcrew
        10d ago
        outdated
      
      openHouseLine(f) is called twice here; compute it once above the array.
    
    ...(open === null ? [] : [open]),
    ...f.features.slice(0, 5).map(bare),
    `Built ${f.year}${lotPhrase(f, " on ")}`,
    `Showings with ${a.name}, ${a.brokerage} · ${a.phone} · Lic. ${a.license}`,
@@ -199,7 +256,8 @@
function flyer(f: Facts): string {
    warm: "Come and see it for yourself.",
    bold: "See it before it is gone.",
  }[f.tone];
  return `${headline}\n\n${plural(f.beds, "bedroom")} and ${plural(f.baths, "bath")} across ${count(f.sqft)} square feet. ${body} ${close}`;
  const open = openHouseLine(f);
  return `${headline}\n\n${plural(f.beds, "bedroom")} and ${plural(f.baths, "bath")} across ${count(f.sqft)} square feet. ${body} ${close}${open === null ? "" : `\n\n${open}`}`;
}
function email(f: Facts, a: Agent): string {
@@ -220,7 +278,8 @@
function email(f: Facts, a: Agent): string {
    warm: "If you or someone you know would like to see it, just reply to this email and I will set up a time.",
    bold: "Want in? Reply now and I will get you on the showing schedule.",
  }[f.tone];
  return `Subject: ${subject}\n\n${open}\n\nThe facts: ${plural(f.beds, "bedroom")}, ${plural(f.baths, "bath")}, ${count(f.sqft)} square feet${lotPhrase(f, " on ")}, built in ${f.year}.\n\nHighlights:\n${list}\n\n${close}\n\n${a.name}\n${a.brokerage} · License ${a.license}\n${a.phone} · ${a.email}`;
  const when = openHouseLine(f);
  return `Subject: ${subject}\n\n${when === null ? "" : `${when}\n\n`}${open}\n\nThe facts: ${plural(f.beds, "bedroom")}, ${plural(f.baths, "bath")}, ${count(f.sqft)} square feet${lotPhrase(f, " on ")}, built in ${f.year}.\n\nHighlights:\n${list}\n\n${close}\n\n${a.name}\n${a.brokerage} · License ${a.license}\n${a.phone} · ${a.email}`;
}
/** All five assets (six texts: social is three posts), for one listing. */
@@ -239,8 +298,16 @@
export function generate(listing: {
  };
}
/** The flyer's copy, split back into what the page lays out. */
export function flyerParts(text: string): { headline: string; body: string } {
  const [headline = "", ...rest] = text.split(/\n\s*\n/);
  return { headline: headline.trim(), body: rest.join("\n\n").trim() };
/**
 * The flyer's copy, split back into what the page lays out. The open house
 * line (`openLine`, as generated) closes the copy and is lifted out for the
 * band under the price; words a person has edited it out of stay as written.
 */
export function flyerParts(
  text: string,
  openLine: string | null = null,
): { headline: string; body: string; open: string } {
  const [headline = "", ...rest] = text.split(/\n\s*\n/).map((p) => p.trim());
  const open = openLine !== null && rest.at(-1) === openLine ? rest.pop()! : "";
  return { headline, body: rest.join("\n\n").trim(), open };
}
@@ -13,6 +13,7 @@
import {
  type Agent,
  type Facts,
  type Kind,
  type OpenHouse,
  type Tone,
} from "./generate.ts";
@@ -23,9 +24,11 @@
export type Palette = (typeof PALETTES)[number];
export const FEATURES_MIN = 5;
export const FEATURES_MAX = 10;
export const ASSET_MAX = 5000;
export const OPEN_HOUSES_MAX = 2;
/** What a person sends to launch a listing, validated. */
export interface ListingInput extends Facts {
  readonly open_houses: readonly OpenHouse[];
  readonly palette: Palette;
  readonly agent_name: string;
  readonly brokerage: string;
@@ -98,6 +101,7 @@
export interface ListingRow {
  readonly features: string;
  readonly tone: Tone;
  readonly palette: Palette;
  readonly open_houses: string;
  readonly agent_name: string;
  readonly brokerage: string;
  readonly license: string;
@@ -112,6 +116,7 @@
export interface ListingRow {
export const fromRow = (row: ListingRow): Listing => ({
  ...row,
  features: JSON.parse(row.features) as string[],
  open_houses: JSON.parse(row.open_houses) as OpenHouse[],
  photos: JSON.parse(row.photos) as string[],
});
@@ -182,6 +187,58 @@
export const featureLines = (v: unknown): string[] =>
    .map((l) => line(l).replace(/^[-•*]\s*/, ""))
    .filter((l) => l !== "");
/** The form posts `open1_date`, `open1_start`, `open1_end` (and `open2_…`); a script sends `open_houses: [{ date, start, end }]`. */
const OPEN_FIELD = /^open[1-9]_(date|start|end)$/;
export const touchesOpenHouses = (raw: Readonly<Record<string, unknown>>): boolean =>
  raw.open_houses !== undefined || Object.keys(raw).some((k) => OPEN_FIELD.test(k));
const openHousesRaw = (raw: Readonly<Record<string, unknown>>): unknown[] | undefined => {
  if (raw.open_houses !== undefined)
    return raw.open_houses === null || (typeof raw.open_houses === "string" && raw.open_houses.trim() === "")
      ? []
      : Array.isArray(raw.open_houses)
        ? raw.open_houses
        : undefined;
  return Array.from({ length: OPEN_HOUSES_MAX }, (_, i) => ({
    date: raw[`open${i + 1}_date`],
    start: raw[`open${i + 1}_start`],
    end: raw[`open${i + 1}_end`],
  }));
};
const realDate = (t: string): boolean => {
  const m = /^(\d{4})-(\d{2})-(\d{2})$/.exec(t);
  if (m === null) return false;
  const [y, mo, d] = [Number(m[1]), Number(m[2]), Number(m[3])];
  const at = new Date(Date.UTC(y, mo - 1, d));
  return y >= 1900 && at.getUTCFullYear() === y && at.getUTCMonth() === mo - 1 && at.getUTCDate() === d;
};
const realTime = (t: string): boolean => /^([01]\d|2[0-3]):[0-5]\d$/.test(t);
/** The open houses, checked: blank rows dropped, a real date, an end after the start, at most two, in date order. */
export function openHouses(raw: Readonly<Record<string, unknown>>): Checked<OpenHouse[]> {
  const rows = openHousesRaw(raw);
  const bad = (message: string): Checked<OpenHouse[]> => ({ ok: false, message });
  if (rows === undefined) return bad("Open houses is a list of dates and times.");
  const filled = rows.filter((r) => typeof r !== "object" || r === null || Object.values(r).some((v) => line(v) !== ""));
  if (filled.length > OPEN_HOUSES_MAX) return bad(`At most ${OPEN_HOUSES_MAX} open houses.`);
  const found: OpenHouse[] = [];
  for (const r of filled) {
    const o = typeof r === "object" && r !== null ? (r as Record<string, unknown>) : {};
    const date = line(o.date);
    const start = line(o.start);
    const end = line(o.end);
    if (date === "" && start === "" && end === "") continue;
    if (!realDate(date)) return bad("The open house date is a real date, like 2027-03-09.");
      
        sentinelcrew
        10d ago
        outdated
      
      Every row is walked before the max-two check; refuse a list longer than OPEN_HOUSES_MAX up front so a large array costs nothing.
    
    if (!realTime(start) || !realTime(end))
      return bad("The open house start and end are times like 13:00.");
    if (end <= start) return bad("The open house ends after it starts.");
    found.push({ date, start, end });
  }
  found.sort((a, b) => `${a.date}${a.start}`.localeCompare(`${b.date}${b.start}`));
  return { ok: true, value: found };
}
/**
 * Is this a listing? Every field from the wire, checked and normalised, or
 * the first thing wrong with it in words a person can act on.
@@ -228,6 +285,9 @@
export function validate(
  const palette = raw.palette ?? "navy";
  if (!isPalette(palette)) return bad(`The colour is one of ${PALETTES.join(", ")}.`);
  const open = openHouses(raw);
  if (!open.ok) return bad(open.message);
  const agent_name = text("agent_name", 2, 80);
  if (agent_name === undefined) return bad("Your name is 2 to 80 characters.");
  const brokerage = text("brokerage", 2, 100);
@@ -256,6 +316,7 @@
export function validate(
      features,
      tone,
      palette,
      open_houses: open.value,
      agent_name,
      brokerage,
      license,
@@ -40,6 +40,17 @@
interface Tool {
  ) => Result<unknown>;
}
const OPEN_HOUSES = {
  type: "array",
  maxItems: 2,
  description: "Up to two open houses in local time as typed: { date: YYYY-MM-DD, start: HH:MM, end: HH:MM }.",
  items: {
    type: "object",
    properties: { date: { type: "string" }, start: { type: "string" }, end: { type: "string" } },
    required: ["date", "start", "end"],
  },
};
export const tools: readonly Tool[] = [
  {
    name: "list_notes",
@@ -104,7 +115,7 @@
export const tools: readonly Tool[] = [
  {
    name: "launch_listing",
    description:
      "Launch a listing from its facts and the agent's brand (no photos here): address, beds, baths, sqft, lot, year, price, five to ten features, tone, palette, agent_name, brokerage, license, agent_phone, agent_email.",
      "Launch a listing from its facts and the agent's brand (no photos here): address, beds, baths, sqft, lot, year, price, five to ten features, tone, palette, open_houses (optional, up to two), agent_name, brokerage, license, agent_phone, agent_email.",
    inputSchema: {
      type: "object",
      properties: {
@@ -123,6 +134,7 @@
export const tools: readonly Tool[] = [
        license: { type: "string" },
        agent_phone: { type: "string" },
        agent_email: { type: "string" },
        open_houses: OPEN_HOUSES,
      },
      required: ["address", "beds", "baths", "sqft", "lot", "year", "price", "features", "agent_name", "brokerage", "license", "agent_phone", "agent_email"],
    },
@@ -209,7 +221,7 @@
export const tools: readonly Tool[] = [
  {
    name: "update_facts",
    description:
      "Change a listing's facts (price, square feet, features, brand...): pass only the fields that change. Every asset is written again in its tone, replacing edits and clearing every approval. Only the listing's agent or an admin can.",
      "Change a listing's facts (price, square feet, features, open houses, brand...): pass only the fields that change. Every asset is written again in its tone, replacing edits and clearing every approval. Only the listing's agent or an admin can.",
    inputSchema: {
      type: "object",
      properties: {
@@ -217,7 +229,7 @@
export const tools: readonly Tool[] = [
        facts: {
          type: "object",
          description:
            "Any of address, beds, baths, sqft, lot, year, price, features, tone, palette, agent_name, brokerage, license, agent_phone, agent_email.",
            "Any of address, beds, baths, sqft, lot, year, price, features, tone, palette, open_houses (a list of up to two { date: YYYY-MM-DD, start: HH:MM, end: HH:MM }; [] clears), agent_name, brokerage, license, agent_phone, agent_email.",
        },
      },
      required: ["id", "facts"],
@@ -0,0 +1,187 @@
/**
 * The open house: validated at the boundary, written into every asset in
 * every tone, rewritten (and the approvals cleared) when it changes, and
 * reachable from the page, the API, the MCP and the terminal.
 */
import { expect, test } from "bun:test";
import { mkdtempSync } from "node:fs";
import { tmpdir } from "node:os";
import { join } from "node:path";
import { approveAsset, getListing, launchListing, updateFacts } from "./actions.ts";
import { openDb } from "./db.ts";
import { check } from "./fairhousing.ts";
import { generate, openHouseLine, timeRange, TONES, KINDS, flyerParts, type OpenHouse } from "./generate.ts";
import { agentOf, validate } from "./listing.ts";
import { rpc } from "./mcp.ts";
import { SAMPLE } from "./sample.ts";
import { session } from "./tty.ts";
import type { Who } from "./who.ts";
const sunday: OpenHouse = { date: "2027-03-07", start: "13:00", end: "15:00" };
const saturday: OpenHouse = { date: "2027-03-06", start: "11:00", end: "13:30" };
const me: Who = { role: "user", id: "u1", name: "me" };
const plain = (s: string): string => s.replace(/\x1b\[[0-9;]*[A-Za-z]/g, "");
test("times read like a person said them", () => {
  expect(timeRange("13:00", "15:00")).toBe("1–3 pm");
  expect(timeRange("11:00", "13:00")).toBe("11 am–1 pm");
  expect(timeRange("13:30", "15:00")).toBe("1:30–3 pm");
  expect(timeRange("09:00", "11:30")).toBe("9–11:30 am");
  expect(timeRange("00:00", "12:00")).toBe("12 am–12 pm");
  expect(openHouseLine({ ...SAMPLE, tone: "classic", open_houses: [sunday] })).toBe("Open Sunday, March 7, 1–3 pm.");
  expect(openHouseLine({ ...SAMPLE, tone: "classic", open_houses: [saturday, sunday] })).toBe(
    "Open Saturday, March 6, 11 am–1:30 pm and Sunday, March 7, 1–3 pm.",
  );
  expect(openHouseLine({ ...SAMPLE, open_houses: [] })).toBeNull();
});
test("validation: a real date, an end after the start, at most two", () => {
  const ok = validate({ ...SAMPLE, open_houses: [sunday] });
  expect(ok.ok && ok.value.open_houses).toEqual([sunday]);
  // The form's fields mean the same, and a blank row is no open house.
  const form = validate({ ...SAMPLE, open_houses: undefined, open1_date: "2027-03-07", open1_start: "13:00", open1_end: "15:00", open2_date: "", open2_start: "", open2_end: "" });
  expect(form.ok && form.value.open_houses).toEqual([sunday]);
  // In date order, whichever order they came.
  const two = validate({ ...SAMPLE, open_houses: [sunday, saturday] });
  expect(two.ok && two.value.open_houses).toEqual([saturday, sunday]);
  const refused: [unknown, string][] = [
    [[{ ...sunday, date: "2027-02-30" }], "real date"],
    [[{ ...sunday, date: "next Sunday" }], "real date"],
    [[{ ...sunday, start: "25:00" }], "times"],
    [[{ ...sunday, end: "" }], "times"],
    [[{ ...sunday, end: "13:00" }], "ends after"],
    [[{ ...sunday, end: "12:00" }], "ends after"],
    [[sunday, saturday, { ...sunday, date: "2027-03-08" }], "At most 2"],
    ["Sunday", "list"],
  ];
  for (const [open_houses, says] of refused) {
    const r = validate({ ...SAMPLE, open_houses });
    expect([says, r.ok ? "accepted" : r.message.includes(says)]).toEqual([says, true]);
  }
});
test("every asset carries the line when set, in every tone, and none when cleared", () => {
  for (const tone of TONES) {
    const facts = { ...SAMPLE, tone, open_houses: [sunday] };
    const line = openHouseLine(facts)!;
    const words = generate({ facts, agent: agentOf(SAMPLE) });
    for (const kind of KINDS) expect([tone, kind, words[kind].includes(line)]).toEqual([tone, kind, true]);
    expect(words.mls.split("\n").at(-1)).toBe(line);
    expect(words.email.split("\n\n")[1]).toBe(line);
    expect(flyerParts(words.flyer, line).open).toBe(line);
    expect(flyerParts(words.flyer, line).body).not.toContain("Sunday");
    for (const kind of KINDS) expect(check(words[kind]).clear).toBe(true);
    const none = generate({ facts: { ...facts, open_houses: [] }, agent: agentOf(SAMPLE) });
    for (const kind of KINDS) expect([tone, kind, /open|Sunday/i.test(none[kind])]).toEqual([tone, kind, false]);
  }
});
test("adding, changing and clearing it writes the assets again and clears approval", () => {
  const db = openDb(mkdtempSync(join(tmpdir(), "app-open-")));
  const made = launchListing(db, me, { fields: { ...SAMPLE, tone: "classic" } });
  if (!made.ok) throw new Error(made.message);
  const id = made.value.id;
  const text = (kind: string): string => {
    const l = getListing(db, me, { id });
    if (!l.ok) throw new Error(l.message);
    return l.value.assets.find((a) => a.kind === kind)!.text;
  };
  const approve = () => {
    const l = getListing(db, me, { id });
    if (!l.ok) throw new Error(l.message);
    for (const a of l.value.assets) approveAsset(db, me, { id, kind: a.kind, door: "page", seen: a.updated_at });
    const again = getListing(db, me, { id });
    return again.ok ? again.value.assets.filter((a) => a.approval !== null).length : -1;
  };
  expect(text("flyer")).not.toContain("Open ");
  expect(approve()).toBe(6);
  const set = updateFacts(db, me, { id, fields: { open_houses: [sunday] } });
  expect(set).toMatchObject({ ok: true, value: { open_houses: [sunday] } });
  expect(text("flyer")).toContain("Open Sunday, March 7, 1–3 pm.");
  expect(text("email")).toContain("Open Sunday, March 7, 1–3 pm.");
  if (set.ok) expect(set.value.assets.every((a) => a.approval === null)).toBe(true);
  // A change to something else keeps it.
  expect(approve()).toBe(6);
  expect(updateFacts(db, me, { id, fields: { price: 650000 } })).toMatchObject({ ok: true, value: { open_houses: [sunday] } });
  const moved = updateFacts(db, me, { id, fields: { open_houses: [{ ...sunday, date: "2027-03-14" }] } });
  expect(moved.ok).toBe(true);
  expect(text("mls")).toContain("Sunday, March 14, 1–3 pm");
  expect(text("mls")).not.toContain("March 7");
  expect(approve()).toBe(6);
  const cleared = updateFacts(db, me, { id, fields: { open_houses: [] } });
  if (!cleared.ok) throw new Error(cleared.message);
  expect(cleared.value.open_houses).toEqual([]);
  expect(cleared.value.assets.every((a) => a.approval === null && !/open house|Open /i.test(a.text))).toBe(true);
  // The form's fields, blank, clear it too.
  updateFacts(db, me, { id, fields: { open_houses: [sunday] } });
  const blank = updateFacts(db, me, { id, fields: { open1_date: "", open1_start: "", open1_end: "" } });
  expect(blank).toMatchObject({ ok: true, value: { open_houses: [] } });
  // A bad one is refused and changes nothing.
  const before = JSON.stringify(getListing(db, me, { id }));
  expect(updateFacts(db, me, { id, fields: { open_houses: [{ ...sunday, end: "09:00" }] } })).toMatchObject({ ok: false, error: "invalid" });
  expect(JSON.stringify(getListing(db, me, { id }))).toBe(before);
});
test("MCP and the terminal set it through the same action", () => {
  const db = openDb(mkdtempSync(join(tmpdir(), "app-open-doors-")));
  const made = launchListing(db, me, { fields: { ...SAMPLE, open_houses: [saturday] } });
  if (!made.ok) throw new Error(made.message);
  const id = made.value.id;
  expect(made.value.open_houses).toEqual([saturday]);
  const call = rpc(db, me, { jsonrpc: "2.0", id: 1, method: "tools/call", params: { name: "update_facts", arguments: { id, facts: { open_houses: [sunday] } } } }).body as { result: { content: { text: string }[] } };
  expect(call.result.content[0]!.text).toContain("2027-03-07");
  const tty = session(db, me);
  tty.press("\r");
  expect(plain(tty.screen())).toContain("Sunday, March 7, 1–3 pm");
  tty.press("o");
  expect(plain(tty.screen())).toContain("2027-03-07 13:00-15:00");
  for (let i = 0; i < 60; i++) tty.press("\x7f");
  for (const key of "2027-03-13 10:00-12:00; 2027-03-14 14:00-16:00") tty.press(key);
  tty.press("\r");
  expect(plain(tty.screen())).toContain("Open house saved");
  const now = getListing(db, me, { id });
  expect(now.ok && now.value.open_houses.map((o) => o.date)).toEqual(["2027-03-13", "2027-03-14"]);
  tty.press("o");
  for (let i = 0; i < 80; i++) tty.press("\x7f");
  for (const key of "2027-02-30 10:00-12:00") tty.press(key);
  tty.press("\r");
  expect(plain(tty.screen())).toContain("real date");
  tty.press("o");
  for (let i = 0; i < 80; i++) tty.press("\x7f");
  tty.press("\r");
  const gone = getListing(db, me, { id });
  expect(gone.ok && gone.value.open_houses).toEqual([]);
});
test("PATCH /api/listings/:id sets and clears it, and the API describes it", async () => {
  const { serve } = await import("./server.ts");
  const { sign } = await import("./who.ts");
  const KEY = "a-key-only-the-forge-holds";
  const server = serve({ port: 0, dataDir: mkdtempSync(join(tmpdir(), "app-open-api-")), identityKey: KEY });
  try {
    const base = `http://${server.hostname}:${server.port}`;
    const identity = `open-api|open-api-agent|user|${Date.now() + 600_000}`;
    const headers = { "x-forge-identity": identity, "x-forge-signature": sign(identity, KEY), "content-type": "application/json" };
    const launch = await fetch(`${base}/api/listings`, { method: "POST", headers, body: JSON.stringify({ ...SAMPLE, open_houses: [sunday] }) });
    expect(launch.status).toBe(201);
    const made = (await launch.json()) as { id: number; open_houses: unknown[]; assets: { text: string }[] };
    expect(made.open_houses).toEqual([sunday]);
    expect(made.assets.every((a) => a.text.includes("Sunday, March 7, 1–3 pm"))).toBe(true);
    const patch = (facts: unknown) => fetch(`${base}/api/listings/${made.id}`, { method: "PATCH", headers, body: JSON.stringify({ facts }) });
    expect((await patch({ open_houses: [{ ...sunday, end: "12:00" }] })).status).toBe(422);
    const cleared = (await (await patch({ open_houses: [] })).json()) as { open_houses: unknown[]; assets: { text: string }[] };
    expect(cleared.open_houses).toEqual([]);
    expect(cleared.assets.some((a) => a.text.includes("Sunday"))).toBe(false);
    expect(await (await fetch(`${base}/openapi.json`)).text()).toContain("open_houses");
  } finally {
    server.stop(true);
  }
});
@@ -51,6 +51,13 @@
export function draftOf(listing: Listing, brandOnly: boolean): Draft {
    year: String(listing.year),
    price: String(listing.price),
    features: listing.features.join("\n"),
    ...Object.fromEntries(
      listing.open_houses.flatMap((o, i) => [
        [`open${i + 1}_date`, o.date],
        [`open${i + 1}_start`, o.start],
        [`open${i + 1}_end`, o.end],
      ]),
    ),
  };
}
@@ -127,6 +134,14 @@
export function form(who: Who, draft: Draft, editing?: Editing): string {
        <textarea class="input textarea" name="features" rows="7" required placeholder="${ph(SAMPLE.features.slice(0, 5).join("\n"))}">${v(draft, "features")}</textarea></label>
      ${editing === undefined ? photos : ""}
    </fieldset>
    <fieldset>
      <legend>Open house <small class="muted">optional; up to two, on the flyer, the email and every post</small></legend>
      ${[1, 2].map((n) => `<div class="facts-grid open-grid">
        ${field(draft, `open${n}_date`, n === 1 ? "Date" : "Second date", 'type="date"', "")}
        ${field(draft, `open${n}_start`, "Starts", 'type="time"', "")}
      
        sentinelcrew
        10d ago
        
      
      open-grid has no CSS rule anywhere: dead class. Add the rule or drop it.
    
        ${field(draft, `open${n}_end`, "Ends", 'type="time"', "")}
      </div>`).join("")}
    </fieldset>
    <fieldset>
      <legend>Tone</legend>
      <div class="choices">${TONES.map(
@@ -9,6 +9,7 @@
import {
  factItems,
  factsLine,
  flyerParts,
  openHouseLine,
  money,
  TONES,
} from "../generate.ts";
@@ -148,6 +149,7 @@
export function listingPage(input: {
    l.assets
      .filter((a) => kinds.includes(a.kind))
      .reduce((s, a) => s + a.check.findings.length, 0);
  const whenLine = openHouseLine(l);
  const tone = editable
    ? `<form class="row tone" method="post" action="/listings/${l.id}/tone">
        <label class="sr" for="tone">Tone</label>
@@ -163,6 +165,7 @@
export function listingPage(input: {
        <h2>${escape(l.address)}</h2>
        <p class="listing-price">${money(l.price)}</p>
        <p class="muted">${escape(factsLine(l))}</p>
      
        sentinelcrew
        10d ago
        outdated
      
      listing-open has no CSS rule; style it or reuse a class, and name it in docs/design/areas. Also bind openHouseLine(l) once instead of calling it twice.
    
        ${whenLine === null ? "" : `<p class="listing-open">${escape(whenLine)}</p>`}
        <p class="muted"><small>${escape(l.agent_name)} · ${escape(l.brokerage)} · updated ${ago(l.updated_at)}</small></p>
      </div>
      <div class="listing-tools">
@@ -207,7 +210,7 @@
export function listingPage(input: {
/** The flyer: the showpiece, a letter-size page in the agent's colours. */
export function flyer(l: Launched): string {
  const copy = flyerParts(l.assets.find((a) => a.kind === "flyer")?.text ?? "");
  const copy = flyerParts(l.assets.find((a) => a.kind === "flyer")?.text ?? "", openHouseLine(l));
  const [hero, ...more] = l.photos;
  return `<article class="flyer palette-${l.palette}">
    ${draftBand(l, "flyer")}
@@ -222,6 +225,7 @@
export function flyer(l: Launched): string {
      </div>
      <p class="flyer-price brand">${money(l.price)}</p>
    </header>
    ${copy.open === "" ? "" : `<p class="flyer-open brand-fill">${escape(copy.open)}</p>`}
    <ul class="flyer-facts brand-fill">
      ${factItems(l).map((i) => `<li><b>${escape(i.value)}</b> ${i.label}</li>`).join("\n      ")}
    </ul>
@@ -162,6 +162,20 @@
const CHECK: Schema = {
  },
  required: ["clear", "findings"],
};
const OPEN_HOUSES = {
  type: "array",
  maxItems: 2,
  description: "Up to two open houses, in local time as typed: a real date (YYYY-MM-DD), start and end as HH:MM with the end after the start. An empty list clears them.",
  items: {
    type: "object",
    properties: {
      date: { type: "string", format: "date" },
      start: { type: "string", pattern: "^([01]\\d|2[0-3]):[0-5]\\d$" },
      end: { type: "string", pattern: "^([01]\\d|2[0-3]):[0-5]\\d$" },
    },
    required: ["date", "start", "end"],
  },
} as const;
const FACTS = {
  address: { type: "string", minLength: 5, maxLength: 120 },
  beds: { type: "integer", minimum: 0, maximum: 50 },
@@ -183,6 +197,7 @@
const FACTS = {
  license: { type: "string", minLength: 2, maxLength: 40 },
  agent_phone: { type: "string", maxLength: 30 },
  agent_email: { type: "string", format: "email", maxLength: 120 },
  open_houses: OPEN_HOUSES,
} as const;
const LISTING_FIELDS = {
  id: { type: "integer" },
@@ -256,7 +271,7 @@
export const LISTING: Schema = {
const LISTING_BODY: Schema = {
  type: "object",
  properties: FACTS,
  required: Object.keys(FACTS).filter((k) => k !== "tone" && k !== "palette"),
  required: Object.keys(FACTS).filter((k) => k !== "tone" && k !== "palette" && k !== "open_houses"),
};
const LISTING_CHANGE: Schema = {
  type: "object",
@@ -361,6 +376,10 @@
const textFields = (form: FormData): Record<string, string> =>
    [...form.entries()].flatMap(([k, v]) => (typeof v === "string" ? [[k, v]] : [])),
  );
/** A new listing started from another keeps its facts, not its open house. */
const withoutOpenHouses = (draft: Draft): Draft =>
  Object.fromEntries(Object.entries(draft).filter(([k]) => !/^open\d_/.test(k)));
/** A whole number from the query, or undefined. */
const whole = (value: string | null): number | undefined =>
  value !== null && /^\d+$/.test(value) ? Number(value) : undefined;
@@ -387,7 +406,7 @@
export const routes: readonly Route[] = [
          : listings.value.find((l) => l.author_id === (c.who as { id: string }).id);
      const draft: Draft =
        chosen?.ok === true
          ? draftOf(chosen.value, false)
          ? withoutOpenHouses(draftOf(chosen.value, false))
          : mine === undefined
            ? {}
            : draftOf(mine, true);
@@ -28,6 +28,7 @@
export const SAMPLE: ListingInput = {
  ],
  tone: "warm",
  palette: "forest",
  open_houses: [],
  agent_name: "Morgan Reyes",
  brokerage: "Harbor & Pine Realty",
  license: "OR 201255501",
@@ -35,6 +36,9 @@
export const SAMPLE: ListingInput = {
  agent_email: "[email protected]",
};
/** The one open house a sample plants, so the meeting sees it on the flyer and in the email. */
export const SAMPLE_OPEN_HOUSE = { date: "2027-03-07", start: "13:00", end: "15:00" };
export const SAMPLE_PHOTOS = ["sample-front.svg", "sample-garden.svg"];
export const SAMPLE_HEADSHOT = "sample-agent.svg";
@@ -58,6 +62,7 @@
export const SAMPLE_CONDO: ListingInput = {
  ],
  tone: "bold",
  palette: "navy",
  open_houses: [],
  agent_name: "Jordan Whitfield",
  brokerage: "Cascade Row Properties",
  license: "WA 700123456",
@@ -88,6 +93,7 @@
export const SAMPLE_HOUSE: ListingInput = {
  ],
  tone: "classic",
  palette: "burgundy",
  open_houses: [],
  agent_name: "Casey Lindqvist",
  brokerage: "Gem State Homes",
  license: "ID SP98765432",
@@ -104,7 +110,7 @@
interface Sample {
}
const SAMPLES: readonly Sample[] = [
  { name: "sample", listing: SAMPLE, photos: SAMPLE_PHOTOS, headshot: SAMPLE_HEADSHOT },
  { name: "sample", listing: { ...SAMPLE, open_houses: [SAMPLE_OPEN_HOUSE] }, photos: SAMPLE_PHOTOS, headshot: SAMPLE_HEADSHOT },
  {
    name: "sample-condo",
    listing: SAMPLE_CONDO,
@@ -29,12 +29,13 @@
import {
  listListings,
  listNotes,
  retoneListing,
  updateFacts,
  useSuggestion,
} from "./actions.ts";
import { ssh, title, where } from "./env.ts";
import { approvalLabel } from "./listing.ts";
import { emailParts } from "./pages/email.ts";
import { factItems, money, TONES, type Kind } from "./generate.ts";
import { factItems, money, openHouseLine, TONES, type Kind, type OpenHouse } from "./generate.ts";
import type { Who } from "./who.ts";
const esc = "\x1b[";
@@ -58,6 +59,15 @@
const scrub = <T>(value: T): T => {
  return value;
};
/** The open houses in the one-line box: "2027-03-09 13:00-15:00; 2027-03-10 11:00-13:00"; empty clears them. */
export const openToLine = (rows: readonly OpenHouse[]): string =>
  rows.map((o) => `${o.date} ${o.start}-${o.end}`).join("; ");
export const openFromLine = (line: string): { date: string; start: string; end: string }[] =>
  line.split(";").map((r) => r.trim()).filter((r) => r !== "").map((r) => {
    const m = /^(\S+)\s+(\S+?)-(\S+)$/.exec(r);
    return { date: m?.[1] ?? r, start: m?.[2] ?? "", end: m?.[3] ?? "" };
  });
/** In the one-line edit box, `\n` typed as two characters is a line break. */
export const toLine = (text: string): string => text.replace(/\n/g, "\\n");
export const fromLine = (line: string): string => line.replace(/\\n/g, "\n");
@@ -69,7 +79,7 @@
export function session(db: Database, me: Who, size = { rows: 40, columns: 100 }
  let previewing = false;
  let cursor = 0;
  /** What the one-line input is for: a new note, or an asset's new words. */
  let typing: { for: "note" } | { for: "asset"; kind: Kind } | undefined;
  let typing: { for: "note" } | { for: "asset"; kind: Kind } | { for: "open" } | undefined;
  let typed = "";
  let said = "";
@@ -105,7 +115,8 @@
export function session(db: Database, me: Who, size = { rows: 40, columns: 100 }
      ];
    }
    const signed = l.assets.filter((a) => a.approval !== null).length;
    const head = [bold(`${l.address} · ${money(l.price)}`), dim(`${l.tone} tone · ${approvalLabel(signed, l.assets.length)}`), ""];
    const whenLine = openHouseLine(l);
    const head = [bold(`${l.address} · ${money(l.price)}`), dim(`${l.tone} tone · ${approvalLabel(signed, l.assets.length)}`), ...(whenLine === null ? [] : [whenLine]), ""];
    // Scroll so the asset under the cursor starts the page.
    const body = l.assets.slice(cursor).flatMap((a, i) => [
      `${i === 0 ? "▸" : " "} ${i === 0 ? bold(a.label) : a.label}  ${a.check.clear ? green("Fair Housing: clear") : amber(`Fair Housing: ${a.check.findings.length} to review`)}${a.edited ? dim("  edited") : ""}${a.approval === null ? "" : green(`  approved by ${a.approval.by_name}`)}`,
@@ -129,7 +140,7 @@
export function session(db: Database, me: Who, size = { rows: 40, columns: 100 }
      if (previewing) help = "esc back to the assets · q quit";
      else help =
        found?.ok === true && canEditListing(me, found.value)
          ? "j/k asset · e edit · a approve/withdraw · u use suggested wording · t next tone · p preview email · esc back · q quit"
          ? "j/k asset · e edit · o open house · a approve/withdraw · u use suggested wording · t next tone · p preview email · esc back · q quit"
          : "j/k asset · p preview email · esc back · q quit";
    } else if (view === "listings") {
      const rows = listings();
@@ -161,7 +172,7 @@
export function session(db: Database, me: Who, size = { rows: 40, columns: 100 }
    }
    lines.push("");
    if (typing !== undefined) {
      const label = typing.for === "note" ? "New note" : `Edit (\\n breaks a line, enter saves, esc drops)`;
      const label = typing.for === "note" ? "New note" : typing.for === "open" ? "Open house: date start-end, like 2027-03-09 13:00-15:00; separate two with ; (empty clears, enter saves, esc drops)" : `Edit (\\n breaks a line, enter saves, esc drops)`;
      // The tail of what is typed, so the cursor stays on the screen.
      const room = Math.max(20, size.columns - 4);
      lines.push(dim(label), `${typed.length > room ? `…${typed.slice(-room + 1)}` : typed}${esc}7m ${esc}0m`);
@@ -177,6 +188,9 @@
export function session(db: Database, me: Who, size = { rows: 40, columns: 100 }
        const added = addNote(db, me, { body: typed });
        if (!added.ok) said = added.message;
        cursor = 0;
      } else if (typing.for === "open") {
        const done = updateFacts(db, me, { id: reading!, fields: { open_houses: openFromLine(typed) } });
        said = done.ok ? "Open house saved. Every asset is written again: read it through." : done.message;
      } else {
        const kind = typing.kind;
        const edited = editAsset(db, me, { id: reading!, kind, text: fromLine(typed) });
@@ -222,7 +236,7 @@
export function session(db: Database, me: Who, size = { rows: 40, columns: 100 }
      if (previewing) return undefined;
      if (down) cursor = Math.min(cursor + 1, Math.max(0, assets.length - 1));
      if (up) cursor = Math.max(cursor - 1, 0);
      if (found?.ok === true && (key === "e" || key === "t" || key === "a" || key === "u")) {
      if (found?.ok === true && (key === "e" || key === "t" || key === "a" || key === "u" || key === "o")) {
        if (!canEditListing(me, found.value))
          said = me.role === "anon" ? "Sign in to edit this listing." : "Only the listing's agent or an admin can edit it.";
        else if (key === "u") {
@@ -243,6 +257,9 @@
export function session(db: Database, me: Who, size = { rows: 40, columns: 100 }
              ? withdrawing ? "Approval withdrawn." : green("Approved.")
              : done.message;
          }
        } else if (key === "o") {
          typing = { for: "open" };
          typed = openToLine(found.value.open_houses);
        } else if (key === "e") {
          const asset = assets[cursor];
          if (asset !== undefined) {
@@ -172,7 +172,44 @@
test("every step of the section works, with the labels it names", async () => {
  expect(afterDrop).toContain("0 of 6 approved");
  expect(await (await get(`${mine}/flyer`)).text()).toContain("$649,000");
  // 7. Print the flyer.
  // 7. Add an open house: Edit facts, the band on the flyer, the line in the email, approvals cleared.
  expect(section).toContain("Add an open house");
  expect(section).toContain("Open Sunday, March 7, 1–3 pm");
  const sampleFlyer = await (await get(`/listings/${sample}/flyer`)).text();
  expect(sampleFlyer).toContain('<p class="flyer-open brand-fill">Come by the open house: Sunday, March 7, 1–3 pm.</p>');
  const editForm = await (await get(`${mine}/facts`)).text();
  for (const name of ["open1_date", "open1_start", "open1_end", "open2_date"])
    expect(editForm).toContain(`name="${name}"`);
  expect(await (await get(`${mine}/flyer`)).text()).not.toContain("flyer-open");
  const approveOpen = new FormData();
  approveOpen.set("approved", "1");
  const beforeOpen = await (await get(mine)).text();
  approveOpen.set("seen", /name="seen" value="([^"]+)"/.exec(beforeOpen)![1]!.replaceAll("&amp;", "&"));
  approveOpen.set("text", textareaOf(beforeOpen));
  await post(`${mine}/assets/mls/approve`, approveOpen);
  expect(await (await get(mine)).text()).toContain("1 of 6 approved");
  const hold = new FormData();
  for (const [k, v] of drop.entries()) hold.set(k, v);
  hold.set("tone", "bold");
  hold.set("open1_date", "2027-03-07");
  hold.set("open1_start", "13:00");
  hold.set("open1_end", "15:00");
  expect((await post(`${mine}/facts`, hold)).status).toBe(303);
  const afterOpen = await (await get(mine)).text();
  expect(afterOpen).toContain("0 of 6 approved");
  expect(await (await get(`${mine}/flyer`)).text()).toContain("OPEN HOUSE: Sunday, March 7, 1–3 pm.");
  expect(await (await get(`${mine}/email`)).text()).toContain("OPEN HOUSE: Sunday, March 7, 1–3 pm.");
  const bad = new FormData();
  for (const [k, v] of hold.entries()) bad.set(k, v);
  bad.set("open1_end", "12:00");
  expect((await post(`${mine}/facts`, bad)).headers.get("location")).toContain("/facts");
  const clear = new FormData();
  for (const [k, v] of drop.entries()) clear.set(k, v);
  for (const k of ["open1_date", "open1_start", "open1_end"]) clear.set(k, "");
  expect((await post(`${mine}/facts`, clear)).status).toBe(303);
  expect(await (await get(`${mine}/flyer`)).text()).not.toContain("flyer-open");
  // 8. Print the flyer.
  expect(afterTone).toMatch(control("Print flyer"));
  const flyer = await get(`${mine}/flyer`);
  expect(flyer.status).toBe(200);
@@ -499,6 +499,14 @@
h3 {
  font-size: var(--text-xl);
  font-weight: 600;
}
.listing-open {
  margin: var(--space-1) 0 0;
  font-weight: 600;
}
.open-grid {
  grid-template-columns: repeat(auto-fill, minmax(9.5rem, 1fr));
  margin-bottom: var(--space-2);
}
.listing-tools {
  display: flex;
  flex-wrap: wrap;
@@ -668,6 +676,12 @@
h3 {
  font-weight: 600;
  line-height: 1;
}
.flyer-open {
  margin: 0;
  padding: var(--space-2) var(--space-5);
  font-weight: 700;
  text-align: center;
}
.flyer-facts {
  list-style: none;
  margin: 0;
@@ -745,8 +759,14 @@
h3 {
    padding-left: var(--space-4);
    padding-right: var(--space-4);
  }
  .flyer-facts,
  .flyer-open {
    padding-left: var(--space-4);
    padding-right: var(--space-4);
  }
  .flyer-facts {
    padding: var(--space-3) var(--space-4);
    padding-top: var(--space-3);
    padding-bottom: var(--space-3);
  }
  .flyer-agent {
    margin: 0 var(--space-4);
		@@ -31,7 +31,14 @@ to make a listing of your own.
31	31	press Save and write all again: the new price is on the flyer, every
32	32	asset is written again from the facts (your edits are replaced), and the
33	33	approval is cleared, so it says "0 of 6 approved". The photos stay.
34		7. Print the flyer. Press Print flyer: a one-page flyer opens with
	34	7. Add an open house. Press Edit facts again. Under "Open house"
	35	pick a date, a start and an end time (Alder Lane's sample already has one),
	36	then press Save and write all again. The flyer gets a band under the
	37	price, the email a line above its body, and the MLS description and every
	38	post a closing line, such as "Open Sunday, March 7, 1–3 pm", all in the
	39	listing's tone. Clearing the three boxes takes it off again. The times are
	40	kept as you type them: no time zone is applied.
	41	8. Print the flyer. Press Print flyer: a one-page flyer opens with
35	42	the photo, price, facts, description and your name. Print it or save it
36	43	as a PDF.
37	44
		@@ -235,6 +242,8 @@ curl -X PATCH https://<app>/api/listings/1 -H 'content-type: application/json' -
235	242	curl -X PATCH https://<app>/api/listings/1 -H 'content-type: application/json' -d '{"tone":"bold"}'
236	243	# change facts (any launch field); every asset is written again, approvals cleared
237	244	curl -X PATCH https://<app>/api/listings/1 -H 'content-type: application/json' -d '{"facts":{"price":649000}}'
	245	# an open house (up to two; local date and 24-hour times as typed; [] clears)
	246	curl -X PATCH https://<app>/api/listings/1 -H 'content-type: application/json' -d '{"facts":{"open_houses":[{"date":"2027-03-07","start":"13:00","end":"15:00"}]}}'
238	247	curl -X DELETE https://<app>/api/listings/1
239	248	```
240	249
		@@ -397,6 +397,33 @@
397	397	"type": "string",
398	398	"format": "email",
399	399	"maxLength": 120
	400	},
	401	"open_houses": {
	402	"type": "array",
	403	"maxItems": 2,
	404	"description": "Up to two open houses, in local time as typed: a real date (YYYY-MM-DD), start and end as HH:MM with the end after the start. An empty list clears them.",
	405	"items": {
	406	"type": "object",
	407	"properties": {
	408	"date": {
	409	"type": "string",
	410	"format": "date"
	411	},
	412	"start": {
	413	"type": "string",
	414	"pattern": "^([01]\\d\|2[0-3]):[0-5]\\d$"
	415	},
	416	"end": {
	417	"type": "string",
	418	"pattern": "^([01]\\d\|2[0-3]):[0-5]\\d$"
	419	}
	420	},
	421	"required": [
	422	"date",
	423	"start",
	424	"end"
	425	]
	426	}
400	427	}
401	428	},
402	429	"required": [
		@@ -618,6 +645,33 @@
618	645	"type": "string",
619	646	"format": "email",
620	647	"maxLength": 120
	648	},
	649	"open_houses": {
	650	"type": "array",
	651	"maxItems": 2,
	652	"description": "Up to two open houses, in local time as typed: a real date (YYYY-MM-DD), start and end as HH:MM with the end after the start. An empty list clears them.",
	653	"items": {
	654	"type": "object",
	655	"properties": {
	656	"date": {
	657	"type": "string",
	658	"format": "date"
	659	},
	660	"start": {
	661	"type": "string",
	662	"pattern": "^([01]\\d\|2[0-3]):[0-5]\\d$"
	663	},
	664	"end": {
	665	"type": "string",
	666	"pattern": "^([01]\\d\|2[0-3]):[0-5]\\d$"
	667	}
	668	},
	669	"required": [
	670	"date",
	671	"start",
	672	"end"
	673	]
	674	}
621	675	}
622	676	}
623	677	},
		@@ -1064,6 +1118,33 @@
1064	1118	"format": "email",
1065	1119	"maxLength": 120
1066	1120	},
	1121	"open_houses": {
	1122	"type": "array",
	1123	"maxItems": 2,
	1124	"description": "Up to two open houses, in local time as typed: a real date (YYYY-MM-DD), start and end as HH:MM with the end after the start. An empty list clears them.",
	1125	"items": {
	1126	"type": "object",
	1127	"properties": {
	1128	"date": {
	1129	"type": "string",
	1130	"format": "date"
	1131	},
	1132	"start": {
	1133	"type": "string",
	1134	"pattern": "^([01]\\d\|2[0-3]):[0-5]\\d$"
	1135	},
	1136	"end": {
	1137	"type": "string",
	1138	"pattern": "^([01]\\d\|2[0-3]):[0-5]\\d$"
	1139	}
	1140	},
	1141	"required": [
	1142	"date",
	1143	"start",
	1144	"end"
	1145	]
	1146	}
	1147	},
1067	1148	"photos": {
1068	1149	"type": "array",
1069	1150	"items": {
		@@ -1242,6 +1323,7 @@
1242	1323	"license",
1243	1324	"agent_phone",
1244	1325	"agent_email",
	1326	"open_houses",
1245	1327	"photos",
1246	1328	"headshot",
1247	1329	"created_at",
		@@ -1344,6 +1426,33 @@
1344	1426	"format": "email",
1345	1427	"maxLength": 120
1346	1428	},
	1429	"open_houses": {
	1430	"type": "array",
	1431	"maxItems": 2,
	1432	"description": "Up to two open houses, in local time as typed: a real date (YYYY-MM-DD), start and end as HH:MM with the end after the start. An empty list clears them.",
	1433	"items": {
	1434	"type": "object",
	1435	"properties": {
	1436	"date": {
	1437	"type": "string",
	1438	"format": "date"
	1439	},
	1440	"start": {
	1441	"type": "string",
	1442	"pattern": "^([01]\\d\|2[0-3]):[0-5]\\d$"
	1443	},
	1444	"end": {
	1445	"type": "string",
	1446	"pattern": "^([01]\\d\|2[0-3]):[0-5]\\d$"
	1447	}
	1448	},
	1449	"required": [
	1450	"date",
	1451	"start",
	1452	"end"
	1453	]
	1454	}
	1455	},
1347	1456	"photos": {
1348	1457	"type": "array",
1349	1458	"items": {
		@@ -1415,6 +1524,7 @@
1415	1524	"license",
1416	1525	"agent_phone",
1417	1526	"agent_email",
	1527	"open_houses",
1418	1528	"photos",
1419	1529	"headshot",
1420	1530	"created_at",
		@@ -0,0 +1,7 @@
	1	# Open house
	2
	3	New component classes, all built from existing tokens:
	4
	5	- `flyer-open` — the band under the price on the flyer (`static/app.css`); it also carries `brand-fill`, the agent's colour.
	6	- `listing-open` — the open house line under the facts in a listing's head.
	7	- `open-grid` — the form's date / start / end row, a `facts-grid` with the same columns.
		@@ -19,6 +19,7 @@ import {
19	19	fromRow,
20	20	isKind,
21	21	isTone,
	22	touchesOpenHouses,
22	23	validate,
23	24	type AssetRow,
24	25	type Caller,
		@@ -325,7 +326,7 @@ export interface Upload {
325	326	}
326	327
327	328	const LISTING_COLUMNS =
328		"address, beds, baths, sqft, lot, year, price, features, tone, palette, agent_name, brokerage, license, agent_phone, agent_email";
	329	"address, beds, baths, sqft, lot, year, price, features, tone, palette, agent_name, brokerage, license, agent_phone, agent_email, open_houses";
329	330
330	331	/** A listing with its assets, or nothing. */
331	332	function launched(db: Database, id: number): Launched \| undefined {
		@@ -365,7 +366,7 @@ export function insertListing(
365	366	const row = db
366	367	.query<ListingRow, (string \| number \| null)[]>(
367	368	`INSERT INTO listing (author_id, author_name, ${LISTING_COLUMNS}, photos, headshot)
368		VALUES (?1, ?2, ?3, ?4, ?5, ?6, ?7, ?8, ?9, ?10, ?11, ?12, ?13, ?14, ?15, ?16, ?17, ?18, ?19) RETURNING *`,
	369	VALUES (?1, ?2, ?3, ?4, ?5, ?6, ?7, ?8, ?9, ?10, ?11, ?12, ?13, ?14, ?15, ?16, ?17, ?18, ?19, ?20) RETURNING *`,
369	370	)
370	371	.get(
371	372	author.id,
		@@ -385,6 +386,7 @@ export function insertListing(
385	386	input.license,
386	387	input.agent_phone,
387	388	input.agent_email,
	389	JSON.stringify(input.open_houses),
388	390	JSON.stringify(photos),
389	391	headshot,
390	392	)!;
		@@ -794,6 +796,8 @@ function changeFacts(
794	796	license: now.license,
795	797	agent_phone: now.agent_phone,
796	798	agent_email: now.agent_email,
	799	// Left out, the open houses stay; the form's open1_… fields or `open_houses` replace them.
	800	...(touchesOpenHouses(input.fields) ? {} : { open_houses: now.open_houses }),
797	801	...input.fields,
798	802	});
799	803	if (!valid.ok) return fail("invalid", valid.message);
		@@ -802,11 +806,11 @@ function changeFacts(
802	806	db.query(
803	807	`UPDATE listing SET address = ?1, beds = ?2, baths = ?3, sqft = ?4, lot = ?5, year = ?6, price = ?7,
804	808	features = ?8, tone = ?9, palette = ?10, agent_name = ?11, brokerage = ?12, license = ?13,
805		agent_phone = ?14, agent_email = ?15 WHERE id = ?16`,
	809	agent_phone = ?14, agent_email = ?15, open_houses = ?16 WHERE id = ?17`,
806	810	).run(
807	811	v.address, v.beds, v.baths, v.sqft, v.lot, v.year, v.price,
808	812	JSON.stringify(v.features), v.tone, v.palette, v.agent_name, v.brokerage,
809		v.license, v.agent_phone, v.agent_email, now.id,
	813	v.license, v.agent_phone, v.agent_email, JSON.stringify(v.open_houses), now.id,
810	814	);
811	815	touch(db, now.id);
812	816	writeAssets(db, { ...now, ...v });
		@@ -90,6 +90,8 @@ export const migrations: string[] = [
90	90	`ALTER TABLE asset ADD COLUMN approved_at TEXT`,
91	91	// Which door the sign-off came through (page, api, tty); null before this was recorded.
92	92	`ALTER TABLE asset ADD COLUMN approved_via TEXT`,
	93	// Up to two open houses, as typed: a JSON list of { date, start, end }, local time, never converted.
	94	`ALTER TABLE listing ADD COLUMN open_houses TEXT NOT NULL DEFAULT '[]'`,
93	95	];
94	96
95	97	export function openDb(dir = dataDir): Database {
		@@ -33,6 +33,13 @@ export const LABELS: Readonly<Record<Kind, string>> = {
33	33	email: "Email blast",
34	34	};
35	35
	36	/** One open house, as typed: the local date (YYYY-MM-DD) and 24-hour times (HH:MM). Never converted. */
	37	export interface OpenHouse {
	38	readonly date: string;
	39	readonly start: string;
	40	readonly end: string;
	41	}
	42
36	43	export interface Facts {
37	44	readonly address: string;
38	45	readonly beds: number;
		@@ -43,6 +50,7 @@ export interface Facts {
43	50	readonly price: number;
44	51	readonly features: readonly string[];
45	52	readonly tone: Tone;
	53	readonly open_houses?: readonly OpenHouse[];
46	54	}
47	55
48	56	export interface Agent {
		@@ -123,10 +131,55 @@ export const factsLine = (f: Facts): string => {
123	131	].join(" · ");
124	132	};
125	133
	134	const WEEKDAYS = ["Sunday", "Monday", "Tuesday", "Wednesday", "Thursday", "Friday", "Saturday"];
	135	const MONTHS = [
	136	"January", "February", "March", "April", "May", "June",
	137	"July", "August", "September", "October", "November", "December",
	138	];
	139
	140	/** "13:30" → { h: 1, m: "30", pm: true }, on a 12-hour clock. */
	141	const clock = (t: string): { h: number; m: string; pm: boolean } => {
	142	const h = Number(t.slice(0, 2));
	143	return { h: h % 12 === 0 ? 12 : h % 12, m: t.slice(3, 5), pm: h >= 12 };
	144	};
	145	const hm = (c: { h: number; m: string }): string => (c.m === "00" ? `${c.h}` : `${c.h}:${c.m}`);
	146
	147	/** "1–3 pm", "11 am–1 pm", "1:30–3 pm": the meridiem said once when both ends share it. */
	148	export const timeRange = (start: string, end: string): string => {
	149	const a = clock(start);
	150	const b = clock(end);
	151	const tail = `${hm(b)} ${b.pm ? "pm" : "am"}`;
	152	return a.pm === b.pm ? `${hm(a)}–${tail}` : `${hm(a)} ${a.pm ? "pm" : "am"}–${tail}`;
	153	};
	154
	155	/** "Sunday, March 9, 1–3 pm", from the date and times as typed (no zone is ever applied). */
	156	export const whenOf = (o: OpenHouse): string => {
	157	const [y, m, d] = o.date.split("-").map(Number) as [number, number, number];
	158	const day = WEEKDAYS[new Date(Date.UTC(y, m - 1, d)).getUTCDay()]!;
	159	return `${day}, ${MONTHS[m - 1]} ${d}, ${timeRange(o.start, o.end)}`;
	160	};
	161
	162	/** The open house as a person would say it, in the listing's tone; null when there is none. */
	163	export const openHouseLine = (f: Facts): string \| null => {
	164	const when = (f.open_houses ?? []).map(whenOf).join(" and ");
	165	if (when === "") return null;
	166	return {
	167	classic: `Open ${when}.`,
	168	warm: `Come by the open house: ${when}.`,
	169	bold: `OPEN HOUSE: ${when}.`,
	170	}[f.tone];
	171	};
	172
126	173	const signature = (a: Agent): string =>
127	174	`${a.name} · ${a.brokerage} · Lic. ${a.license}`;
128	175
129	176	function mls(f: Facts): string {
	177	const text = mlsText(f);
	178	const open = openHouseLine(f);
	179	return open === null ? text : `${text}\n${open}`;
	180	}
	181
	182	function mlsText(f: Facts): string {
130	183	const where = f.address;
131	184	const size = `${num(f.beds)}-bedroom, ${num(f.baths)}-bath`;
132	185	const sized = withArticle(size);
		@@ -142,13 +195,14 @@ function mls(f: Facts): string {
142	195	}
143	196
144	197	function socialShort(f: Facts, a: Agent): string {
	198	const open = openHouseLine(f);
145	199	const lead = {
146	200	classic: "Just listed",
147	201	warm: "Just listed, and we love it",
148	202	bold: "JUST LISTED",
149	203	}[f.tone];
150	204	const first = f.features[0] === undefined ? "" : ` ${sentence(f.features[0])}`;
151		return `${lead}: ${street(f.address)} · ${num(f.beds)} bd · ${num(f.baths)} ba · ${count(f.sqft)} sq ft · ${money(f.price)}.${first} ${a.name}, ${a.brokerage}. #JustListed #NewListing`;
	205	return `${lead}: ${street(f.address)} · ${num(f.beds)} bd · ${num(f.baths)} ba · ${count(f.sqft)} sq ft · ${money(f.price)}.${first}${open === null ? "" : ` ${open}`} ${a.name}, ${a.brokerage}. #JustListed #NewListing`;
152	206	}
153	207
154	208	function socialMedium(f: Facts, a: Agent): string {
		@@ -166,10 +220,12 @@ function socialMedium(f: Facts, a: Agent): string {
166	220	warm: "I would love to show you around. Send me a message to set up a visit.",
167	221	bold: "Showings are filling up. Message me today.",
168	222	}[f.tone];
169		return `${open}\n\n${plural(f.beds, "bedroom")} · ${plural(f.baths, "bath")} · ${count(f.sqft)} sq ft · built ${f.year}\n\n${top}\n\n${close}\n${signature(a)} · ${a.phone}\n#JustListed #HomeForSale`;
	223	const when = openHouseLine(f);
	224	return `${open}\n\n${plural(f.beds, "bedroom")} · ${plural(f.baths, "bath")} · ${count(f.sqft)} sq ft · built ${f.year}\n\n${top}\n\n${when === null ? "" : `${when}\n`}${close}\n${signature(a)} · ${a.phone}\n#JustListed #HomeForSale`;
170	225	}
171	226
172	227	function socialCarousel(f: Facts, a: Agent): string {
	228	const open = openHouseLine(f);
173	229	const slides = [
174	230	{
175	231	classic: `Just listed: ${street(f.address)}`,
		@@ -177,6 +233,7 @@ function socialCarousel(f: Facts, a: Agent): string {
177	233	bold: `${street(f.address)}. Just listed.`,
178	234	}[f.tone],
179	235	`${money(f.price)} · ${num(f.beds)} bd · ${num(f.baths)} ba · ${count(f.sqft)} sq ft`,
		sentinelcrew 10d ago outdated openHouseLine(f) is called twice here; compute it once above the array.
	236	...(open === null ? [] : [open]),
180	237	...f.features.slice(0, 5).map(bare),
181	238	`Built ${f.year}${lotPhrase(f, " on ")}`,
182	239	`Showings with ${a.name}, ${a.brokerage} · ${a.phone} · Lic. ${a.license}`,
		@@ -199,7 +256,8 @@ function flyer(f: Facts): string {
199	256	warm: "Come and see it for yourself.",
200	257	bold: "See it before it is gone.",
201	258	}[f.tone];
202		return `${headline}\n\n${plural(f.beds, "bedroom")} and ${plural(f.baths, "bath")} across ${count(f.sqft)} square feet. ${body} ${close}`;
	259	const open = openHouseLine(f);
	260	return `${headline}\n\n${plural(f.beds, "bedroom")} and ${plural(f.baths, "bath")} across ${count(f.sqft)} square feet. ${body} ${close}${open === null ? "" : `\n\n${open}`}`;
203	261	}
204	262
205	263	function email(f: Facts, a: Agent): string {
		@@ -220,7 +278,8 @@ function email(f: Facts, a: Agent): string {
220	278	warm: "If you or someone you know would like to see it, just reply to this email and I will set up a time.",
221	279	bold: "Want in? Reply now and I will get you on the showing schedule.",
222	280	}[f.tone];
223		return `Subject: ${subject}\n\n${open}\n\nThe facts: ${plural(f.beds, "bedroom")}, ${plural(f.baths, "bath")}, ${count(f.sqft)} square feet${lotPhrase(f, " on ")}, built in ${f.year}.\n\nHighlights:\n${list}\n\n${close}\n\n${a.name}\n${a.brokerage} · License ${a.license}\n${a.phone} · ${a.email}`;
	281	const when = openHouseLine(f);
	282	return `Subject: ${subject}\n\n${when === null ? "" : `${when}\n\n`}${open}\n\nThe facts: ${plural(f.beds, "bedroom")}, ${plural(f.baths, "bath")}, ${count(f.sqft)} square feet${lotPhrase(f, " on ")}, built in ${f.year}.\n\nHighlights:\n${list}\n\n${close}\n\n${a.name}\n${a.brokerage} · License ${a.license}\n${a.phone} · ${a.email}`;
224	283	}
225	284
226	285	/** All five assets (six texts: social is three posts), for one listing. */
		@@ -239,8 +298,16 @@ export function generate(listing: {
239	298	};
240	299	}
241	300
242		/** The flyer's copy, split back into what the page lays out. */
243		export function flyerParts(text: string): { headline: string; body: string } {
244		const [headline = "", ...rest] = text.split(/\n\s*\n/);
245		return { headline: headline.trim(), body: rest.join("\n\n").trim() };
	301	/**
	302	* The flyer's copy, split back into what the page lays out. The open house
	303	* line (`openLine`, as generated) closes the copy and is lifted out for the
	304	* band under the price; words a person has edited it out of stay as written.
	305	*/
	306	export function flyerParts(
	307	text: string,
	308	openLine: string \| null = null,
	309	): { headline: string; body: string; open: string } {
	310	const [headline = "", ...rest] = text.split(/\n\s*\n/).map((p) => p.trim());
	311	const open = openLine !== null && rest.at(-1) === openLine ? rest.pop()! : "";
	312	return { headline, body: rest.join("\n\n").trim(), open };
246	313	}
		@@ -13,6 +13,7 @@ import {
13	13	type Agent,
14	14	type Facts,
15	15	type Kind,
	16	type OpenHouse,
16	17	type Tone,
17	18	} from "./generate.ts";
18	19
		@@ -23,9 +24,11 @@ export type Palette = (typeof PALETTES)[number];
23	24	export const FEATURES_MIN = 5;
24	25	export const FEATURES_MAX = 10;
25	26	export const ASSET_MAX = 5000;
	27	export const OPEN_HOUSES_MAX = 2;
26	28
27	29	/** What a person sends to launch a listing, validated. */
28	30	export interface ListingInput extends Facts {
	31	readonly open_houses: readonly OpenHouse[];
29	32	readonly palette: Palette;
30	33	readonly agent_name: string;
31	34	readonly brokerage: string;
		@@ -98,6 +101,7 @@ export interface ListingRow {
98	101	readonly features: string;
99	102	readonly tone: Tone;
100	103	readonly palette: Palette;
	104	readonly open_houses: string;
101	105	readonly agent_name: string;
102	106	readonly brokerage: string;
103	107	readonly license: string;
		@@ -112,6 +116,7 @@ export interface ListingRow {
112	116	export const fromRow = (row: ListingRow): Listing => ({
113	117	...row,
114	118	features: JSON.parse(row.features) as string[],
	119	open_houses: JSON.parse(row.open_houses) as OpenHouse[],
115	120	photos: JSON.parse(row.photos) as string[],
116	121	});
117	122
		@@ -182,6 +187,58 @@ export const featureLines = (v: unknown): string[] =>
182	187	.map((l) => line(l).replace(/^[-•]\s/, ""))
183	188	.filter((l) => l !== "");
184	189
	190	/** The form posts `open1_date`, `open1_start`, `open1_end` (and `open2_…`); a script sends `open_houses: [{ date, start, end }]`. */
	191	const OPEN_FIELD = /^open[1-9]_(date\|start\|end)$/;
	192	export const touchesOpenHouses = (raw: Readonly<Record<string, unknown>>): boolean =>
	193	raw.open_houses !== undefined \|\| Object.keys(raw).some((k) => OPEN_FIELD.test(k));
	194
	195	const openHousesRaw = (raw: Readonly<Record<string, unknown>>): unknown[] \| undefined => {
	196	if (raw.open_houses !== undefined)
	197	return raw.open_houses === null \|\| (typeof raw.open_houses === "string" && raw.open_houses.trim() === "")
	198	? []
	199	: Array.isArray(raw.open_houses)
	200	? raw.open_houses
	201	: undefined;
	202	return Array.from({ length: OPEN_HOUSES_MAX }, (_, i) => ({
	203	date: raw[`open${i + 1}_date`],
	204	start: raw[`open${i + 1}_start`],
	205	end: raw[`open${i + 1}_end`],
	206	}));
	207	};
	208
	209	const realDate = (t: string): boolean => {
	210	const m = /^(\d{4})-(\d{2})-(\d{2})$/.exec(t);
	211	if (m === null) return false;
	212	const [y, mo, d] = [Number(m[1]), Number(m[2]), Number(m[3])];
	213	const at = new Date(Date.UTC(y, mo - 1, d));
	214	return y >= 1900 && at.getUTCFullYear() === y && at.getUTCMonth() === mo - 1 && at.getUTCDate() === d;
	215	};
	216	const realTime = (t: string): boolean => /^([01]\d\|2[0-3]):[0-5]\d$/.test(t);
	217
	218	/** The open houses, checked: blank rows dropped, a real date, an end after the start, at most two, in date order. */
	219	export function openHouses(raw: Readonly<Record<string, unknown>>): Checked<OpenHouse[]> {
	220	const rows = openHousesRaw(raw);
	221	const bad = (message: string): Checked<OpenHouse[]> => ({ ok: false, message });
	222	if (rows === undefined) return bad("Open houses is a list of dates and times.");
	223	const filled = rows.filter((r) => typeof r !== "object" \|\| r === null \|\| Object.values(r).some((v) => line(v) !== ""));
	224	if (filled.length > OPEN_HOUSES_MAX) return bad(`At most ${OPEN_HOUSES_MAX} open houses.`);
	225	const found: OpenHouse[] = [];
	226	for (const r of filled) {
	227	const o = typeof r === "object" && r !== null ? (r as Record<string, unknown>) : {};
	228	const date = line(o.date);
	229	const start = line(o.start);
	230	const end = line(o.end);
	231	if (date === "" && start === "" && end === "") continue;
	232	if (!realDate(date)) return bad("The open house date is a real date, like 2027-03-09.");
		sentinelcrew 10d ago outdated Every row is walked before the max-two check; refuse a list longer than OPEN_HOUSES_MAX up front so a large array costs nothing.
	233	if (!realTime(start) \|\| !realTime(end))
	234	return bad("The open house start and end are times like 13:00.");
	235	if (end <= start) return bad("The open house ends after it starts.");
	236	found.push({ date, start, end });
	237	}
	238	found.sort((a, b) => `${a.date}${a.start}`.localeCompare(`${b.date}${b.start}`));
	239	return { ok: true, value: found };
	240	}
	241
185	242	/**
186	243	* Is this a listing? Every field from the wire, checked and normalised, or
187	244	* the first thing wrong with it in words a person can act on.
		@@ -228,6 +285,9 @@ export function validate(
228	285	const palette = raw.palette ?? "navy";
229	286	if (!isPalette(palette)) return bad(`The colour is one of ${PALETTES.join(", ")}.`);
230	287
	288	const open = openHouses(raw);
	289	if (!open.ok) return bad(open.message);
	290
231	291	const agent_name = text("agent_name", 2, 80);
232	292	if (agent_name === undefined) return bad("Your name is 2 to 80 characters.");
233	293	const brokerage = text("brokerage", 2, 100);
		@@ -256,6 +316,7 @@ export function validate(
256	316	features,
257	317	tone,
258	318	palette,
	319	open_houses: open.value,
259	320	agent_name,
260	321	brokerage,
261	322	license,
		@@ -40,6 +40,17 @@ interface Tool {
40	40	) => Result<unknown>;
41	41	}
42	42
	43	const OPEN_HOUSES = {
	44	type: "array",
	45	maxItems: 2,
	46	description: "Up to two open houses in local time as typed: { date: YYYY-MM-DD, start: HH:MM, end: HH:MM }.",
	47	items: {
	48	type: "object",
	49	properties: { date: { type: "string" }, start: { type: "string" }, end: { type: "string" } },
	50	required: ["date", "start", "end"],
	51	},
	52	};
	53
43	54	export const tools: readonly Tool[] = [
44	55	{
45	56	name: "list_notes",
		@@ -104,7 +115,7 @@ export const tools: readonly Tool[] = [
104	115	{
105	116	name: "launch_listing",
106	117	description:
107		"Launch a listing from its facts and the agent's brand (no photos here): address, beds, baths, sqft, lot, year, price, five to ten features, tone, palette, agent_name, brokerage, license, agent_phone, agent_email.",
	118	"Launch a listing from its facts and the agent's brand (no photos here): address, beds, baths, sqft, lot, year, price, five to ten features, tone, palette, open_houses (optional, up to two), agent_name, brokerage, license, agent_phone, agent_email.",
108	119	inputSchema: {
109	120	type: "object",
110	121	properties: {
		@@ -123,6 +134,7 @@ export const tools: readonly Tool[] = [
123	134	license: { type: "string" },
124	135	agent_phone: { type: "string" },
125	136	agent_email: { type: "string" },
	137	open_houses: OPEN_HOUSES,
126	138	},
127	139	required: ["address", "beds", "baths", "sqft", "lot", "year", "price", "features", "agent_name", "brokerage", "license", "agent_phone", "agent_email"],
128	140	},
		@@ -209,7 +221,7 @@ export const tools: readonly Tool[] = [
209	221	{
210	222	name: "update_facts",
211	223	description:
212		"Change a listing's facts (price, square feet, features, brand...): pass only the fields that change. Every asset is written again in its tone, replacing edits and clearing every approval. Only the listing's agent or an admin can.",
	224	"Change a listing's facts (price, square feet, features, open houses, brand...): pass only the fields that change. Every asset is written again in its tone, replacing edits and clearing every approval. Only the listing's agent or an admin can.",
213	225	inputSchema: {
214	226	type: "object",
215	227	properties: {
		@@ -217,7 +229,7 @@ export const tools: readonly Tool[] = [
217	229	facts: {
218	230	type: "object",
219	231	description:
220		"Any of address, beds, baths, sqft, lot, year, price, features, tone, palette, agent_name, brokerage, license, agent_phone, agent_email.",
	232	"Any of address, beds, baths, sqft, lot, year, price, features, tone, palette, open_houses (a list of up to two { date: YYYY-MM-DD, start: HH:MM, end: HH:MM }; [] clears), agent_name, brokerage, license, agent_phone, agent_email.",
221	233	},
222	234	},
223	235	required: ["id", "facts"],
		@@ -0,0 +1,187 @@
	1	/**
	2	* The open house: validated at the boundary, written into every asset in
	3	* every tone, rewritten (and the approvals cleared) when it changes, and
	4	* reachable from the page, the API, the MCP and the terminal.
	5	*/
	6	import { expect, test } from "bun:test";
	7	import { mkdtempSync } from "node:fs";
	8	import { tmpdir } from "node:os";
	9	import { join } from "node:path";
	10	import { approveAsset, getListing, launchListing, updateFacts } from "./actions.ts";
	11	import { openDb } from "./db.ts";
	12	import { check } from "./fairhousing.ts";
	13	import { generate, openHouseLine, timeRange, TONES, KINDS, flyerParts, type OpenHouse } from "./generate.ts";
	14	import { agentOf, validate } from "./listing.ts";
	15	import { rpc } from "./mcp.ts";
	16	import { SAMPLE } from "./sample.ts";
	17	import { session } from "./tty.ts";
	18	import type { Who } from "./who.ts";
	19
	20	const sunday: OpenHouse = { date: "2027-03-07", start: "13:00", end: "15:00" };
	21	const saturday: OpenHouse = { date: "2027-03-06", start: "11:00", end: "13:30" };
	22	const me: Who = { role: "user", id: "u1", name: "me" };
	23	const plain = (s: string): string => s.replace(/\x1b\[[0-9;]*[A-Za-z]/g, "");
	24
	25	test("times read like a person said them", () => {
	26	expect(timeRange("13:00", "15:00")).toBe("1–3 pm");
	27	expect(timeRange("11:00", "13:00")).toBe("11 am–1 pm");
	28	expect(timeRange("13:30", "15:00")).toBe("1:30–3 pm");
	29	expect(timeRange("09:00", "11:30")).toBe("9–11:30 am");
	30	expect(timeRange("00:00", "12:00")).toBe("12 am–12 pm");
	31	expect(openHouseLine({ ...SAMPLE, tone: "classic", open_houses: [sunday] })).toBe("Open Sunday, March 7, 1–3 pm.");
	32	expect(openHouseLine({ ...SAMPLE, tone: "classic", open_houses: [saturday, sunday] })).toBe(
	33	"Open Saturday, March 6, 11 am–1:30 pm and Sunday, March 7, 1–3 pm.",
	34	);
	35	expect(openHouseLine({ ...SAMPLE, open_houses: [] })).toBeNull();
	36	});
	37
	38	test("validation: a real date, an end after the start, at most two", () => {
	39	const ok = validate({ ...SAMPLE, open_houses: [sunday] });
	40	expect(ok.ok && ok.value.open_houses).toEqual([sunday]);
	41	// The form's fields mean the same, and a blank row is no open house.
	42	const form = validate({ ...SAMPLE, open_houses: undefined, open1_date: "2027-03-07", open1_start: "13:00", open1_end: "15:00", open2_date: "", open2_start: "", open2_end: "" });
	43	expect(form.ok && form.value.open_houses).toEqual([sunday]);
	44	// In date order, whichever order they came.
	45	const two = validate({ ...SAMPLE, open_houses: [sunday, saturday] });
	46	expect(two.ok && two.value.open_houses).toEqual([saturday, sunday]);
	47	const refused: [unknown, string][] = [
	48	[[{ ...sunday, date: "2027-02-30" }], "real date"],
	49	[[{ ...sunday, date: "next Sunday" }], "real date"],
	50	[[{ ...sunday, start: "25:00" }], "times"],
	51	[[{ ...sunday, end: "" }], "times"],
	52	[[{ ...sunday, end: "13:00" }], "ends after"],
	53	[[{ ...sunday, end: "12:00" }], "ends after"],
	54	[[sunday, saturday, { ...sunday, date: "2027-03-08" }], "At most 2"],
	55	["Sunday", "list"],
	56	];
	57	for (const [open_houses, says] of refused) {
	58	const r = validate({ ...SAMPLE, open_houses });
	59	expect([says, r.ok ? "accepted" : r.message.includes(says)]).toEqual([says, true]);
	60	}
	61	});
	62
	63	test("every asset carries the line when set, in every tone, and none when cleared", () => {
	64	for (const tone of TONES) {
	65	const facts = { ...SAMPLE, tone, open_houses: [sunday] };
	66	const line = openHouseLine(facts)!;
	67	const words = generate({ facts, agent: agentOf(SAMPLE) });
	68	for (const kind of KINDS) expect([tone, kind, words[kind].includes(line)]).toEqual([tone, kind, true]);
	69	expect(words.mls.split("\n").at(-1)).toBe(line);
	70	expect(words.email.split("\n\n")[1]).toBe(line);
	71	expect(flyerParts(words.flyer, line).open).toBe(line);
	72	expect(flyerParts(words.flyer, line).body).not.toContain("Sunday");
	73	for (const kind of KINDS) expect(check(words[kind]).clear).toBe(true);
	74	const none = generate({ facts: { ...facts, open_houses: [] }, agent: agentOf(SAMPLE) });
	75	for (const kind of KINDS) expect([tone, kind, /open\|Sunday/i.test(none[kind])]).toEqual([tone, kind, false]);
	76	}
	77	});
	78
	79	test("adding, changing and clearing it writes the assets again and clears approval", () => {
	80	const db = openDb(mkdtempSync(join(tmpdir(), "app-open-")));
	81	const made = launchListing(db, me, { fields: { ...SAMPLE, tone: "classic" } });
	82	if (!made.ok) throw new Error(made.message);
	83	const id = made.value.id;
	84	const text = (kind: string): string => {
	85	const l = getListing(db, me, { id });
	86	if (!l.ok) throw new Error(l.message);
	87	return l.value.assets.find((a) => a.kind === kind)!.text;
	88	};
	89	const approve = () => {
	90	const l = getListing(db, me, { id });
	91	if (!l.ok) throw new Error(l.message);
	92	for (const a of l.value.assets) approveAsset(db, me, { id, kind: a.kind, door: "page", seen: a.updated_at });
	93	const again = getListing(db, me, { id });
	94	return again.ok ? again.value.assets.filter((a) => a.approval !== null).length : -1;
	95	};
	96	expect(text("flyer")).not.toContain("Open ");
	97	expect(approve()).toBe(6);
	98
	99	const set = updateFacts(db, me, { id, fields: { open_houses: [sunday] } });
	100	expect(set).toMatchObject({ ok: true, value: { open_houses: [sunday] } });
	101	expect(text("flyer")).toContain("Open Sunday, March 7, 1–3 pm.");
	102	expect(text("email")).toContain("Open Sunday, March 7, 1–3 pm.");
	103	if (set.ok) expect(set.value.assets.every((a) => a.approval === null)).toBe(true);
	104
	105	// A change to something else keeps it.
	106	expect(approve()).toBe(6);
	107	expect(updateFacts(db, me, { id, fields: { price: 650000 } })).toMatchObject({ ok: true, value: { open_houses: [sunday] } });
	108
	109	const moved = updateFacts(db, me, { id, fields: { open_houses: [{ ...sunday, date: "2027-03-14" }] } });
	110	expect(moved.ok).toBe(true);
	111	expect(text("mls")).toContain("Sunday, March 14, 1–3 pm");
	112	expect(text("mls")).not.toContain("March 7");
	113
	114	expect(approve()).toBe(6);
	115	const cleared = updateFacts(db, me, { id, fields: { open_houses: [] } });
	116	if (!cleared.ok) throw new Error(cleared.message);
	117	expect(cleared.value.open_houses).toEqual([]);
	118	expect(cleared.value.assets.every((a) => a.approval === null && !/open house\|Open /i.test(a.text))).toBe(true);
	119
	120	// The form's fields, blank, clear it too.
	121	updateFacts(db, me, { id, fields: { open_houses: [sunday] } });
	122	const blank = updateFacts(db, me, { id, fields: { open1_date: "", open1_start: "", open1_end: "" } });
	123	expect(blank).toMatchObject({ ok: true, value: { open_houses: [] } });
	124
	125	// A bad one is refused and changes nothing.
	126	const before = JSON.stringify(getListing(db, me, { id }));
	127	expect(updateFacts(db, me, { id, fields: { open_houses: [{ ...sunday, end: "09:00" }] } })).toMatchObject({ ok: false, error: "invalid" });
	128	expect(JSON.stringify(getListing(db, me, { id }))).toBe(before);
	129	});
	130
	131	test("MCP and the terminal set it through the same action", () => {
	132	const db = openDb(mkdtempSync(join(tmpdir(), "app-open-doors-")));
	133	const made = launchListing(db, me, { fields: { ...SAMPLE, open_houses: [saturday] } });
	134	if (!made.ok) throw new Error(made.message);
	135	const id = made.value.id;
	136	expect(made.value.open_houses).toEqual([saturday]);
	137
	138	const call = rpc(db, me, { jsonrpc: "2.0", id: 1, method: "tools/call", params: { name: "update_facts", arguments: { id, facts: { open_houses: [sunday] } } } }).body as { result: { content: { text: string }[] } };
	139	expect(call.result.content[0]!.text).toContain("2027-03-07");
	140
	141	const tty = session(db, me);
	142	tty.press("\r");
	143	expect(plain(tty.screen())).toContain("Sunday, March 7, 1–3 pm");
	144	tty.press("o");
	145	expect(plain(tty.screen())).toContain("2027-03-07 13:00-15:00");
	146	for (let i = 0; i < 60; i++) tty.press("\x7f");
	147	for (const key of "2027-03-13 10:00-12:00; 2027-03-14 14:00-16:00") tty.press(key);
	148	tty.press("\r");
	149	expect(plain(tty.screen())).toContain("Open house saved");
	150	const now = getListing(db, me, { id });
	151	expect(now.ok && now.value.open_houses.map((o) => o.date)).toEqual(["2027-03-13", "2027-03-14"]);
	152	tty.press("o");
	153	for (let i = 0; i < 80; i++) tty.press("\x7f");
	154	for (const key of "2027-02-30 10:00-12:00") tty.press(key);
	155	tty.press("\r");
	156	expect(plain(tty.screen())).toContain("real date");
	157	tty.press("o");
	158	for (let i = 0; i < 80; i++) tty.press("\x7f");
	159	tty.press("\r");
	160	const gone = getListing(db, me, { id });
	161	expect(gone.ok && gone.value.open_houses).toEqual([]);
	162	});
	163
	164	test("PATCH /api/listings/:id sets and clears it, and the API describes it", async () => {
	165	const { serve } = await import("./server.ts");
	166	const { sign } = await import("./who.ts");
	167	const KEY = "a-key-only-the-forge-holds";
	168	const server = serve({ port: 0, dataDir: mkdtempSync(join(tmpdir(), "app-open-api-")), identityKey: KEY });
	169	try {
	170	const base = `http://${server.hostname}:${server.port}`;
	171	const identity = `open-api\|open-api-agent\|user\|${Date.now() + 600_000}`;
	172	const headers = { "x-forge-identity": identity, "x-forge-signature": sign(identity, KEY), "content-type": "application/json" };
	173	const launch = await fetch(`${base}/api/listings`, { method: "POST", headers, body: JSON.stringify({ ...SAMPLE, open_houses: [sunday] }) });
	174	expect(launch.status).toBe(201);
	175	const made = (await launch.json()) as { id: number; open_houses: unknown[]; assets: { text: string }[] };
	176	expect(made.open_houses).toEqual([sunday]);
	177	expect(made.assets.every((a) => a.text.includes("Sunday, March 7, 1–3 pm"))).toBe(true);
	178	const patch = (facts: unknown) => fetch(`${base}/api/listings/${made.id}`, { method: "PATCH", headers, body: JSON.stringify({ facts }) });
	179	expect((await patch({ open_houses: [{ ...sunday, end: "12:00" }] })).status).toBe(422);
	180	const cleared = (await (await patch({ open_houses: [] })).json()) as { open_houses: unknown[]; assets: { text: string }[] };
	181	expect(cleared.open_houses).toEqual([]);
	182	expect(cleared.assets.some((a) => a.text.includes("Sunday"))).toBe(false);
	183	expect(await (await fetch(`${base}/openapi.json`)).text()).toContain("open_houses");
	184	} finally {
	185	server.stop(true);
	186	}
	187	});
		@@ -51,6 +51,13 @@ export function draftOf(listing: Listing, brandOnly: boolean): Draft {
51	51	year: String(listing.year),
52	52	price: String(listing.price),
53	53	features: listing.features.join("\n"),
	54	...Object.fromEntries(
	55	listing.open_houses.flatMap((o, i) => [
	56	[`open${i + 1}_date`, o.date],
	57	[`open${i + 1}_start`, o.start],
	58	[`open${i + 1}_end`, o.end],
	59	]),
	60	),
54	61	};
55	62	}
56	63
		@@ -127,6 +134,14 @@ export function form(who: Who, draft: Draft, editing?: Editing): string {
127	134	<textarea class="input textarea" name="features" rows="7" required placeholder="${ph(SAMPLE.features.slice(0, 5).join("\n"))}">${v(draft, "features")}</textarea></label>
128	135	${editing === undefined ? photos : ""}
129	136	</fieldset>
	137	<fieldset>
	138	<legend>Open house <small class="muted">optional; up to two, on the flyer, the email and every post</small></legend>
	139	${[1, 2].map((n) => `<div class="facts-grid open-grid">
	140	${field(draft, `open${n}_date`, n === 1 ? "Date" : "Second date", 'type="date"', "")}
	141	${field(draft, `open${n}_start`, "Starts", 'type="time"', "")}
		sentinelcrew 10d ago `open-grid` has no CSS rule anywhere: dead class. Add the rule or drop it.
	142	${field(draft, `open${n}_end`, "Ends", 'type="time"', "")}
	143	</div>`).join("")}
	144	</fieldset>
130	145	<fieldset>
131	146	<legend>Tone</legend>
132	147	<div class="choices">${TONES.map(