@aglyn/plugins-ai 1.0.0-beta.271 → 1.0.0-beta.273

package/src/lib/model/ai-site-photos.d.ts

@@ -0,0 +1,119 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import type { StockPhotoSearchRequest } from '@aglyn/aglyn/plugin-manager/stock-photo-provider';
+import type { AiLayoutPicturePhoto, AiLayoutPictureRole } from '../layout-language/ai-layout-pictures';
+/**
+ * THE PICTURES A SITE START LEFT ON A STARTER PHOTO (AGL-3988).
+ *
+ * A guided start's pages and its datasets' records are each built in a pass
+ * of their own, minutes apart. A picture the stock library could not fill in
+ * its pass took a starter photo there: its picks' downloads refused by the
+ * library's image hosts in a burst, or no photo of the job's own to take
+ * yet. The v1.0.0-beta.271 Laurel Fork Photography start (2026-10-19 23:05Z)
+ * filed all twelve "Gallery collections" covers and its home hero under an
+ * office team and a desk: pixabay.com's Cloudflare answered 429 to 22
+ * downloads while the covers were built, before the job had copied any
+ * photo, and to 11 more on the home page, the first page built.
+ *
+ * Each such picture is written down here, with the picks the hosts refused,
+ * on the job, by the machine, in the write that records its pass. The site
+ * step's late photo pass (`jobs/ai-site-late-photos.ts`) reads it once every
+ * page is built and before the site is published: it asks the refused picks
+ * for again, a minute after the refusal, and gives every picture still on a
+ * starter one of the photos the job copied. Pure.
+ */
+/** Where a starter photo is served from: the platform's own files, on every site's origin. */
+export declare const AI_SITE_STARTER_PREFIX = "/_static/starter/";
+/** Whether an address is a starter photo's. */
+export declare function aiSiteIsStarterSrc(src: unknown): boolean;
+/** The picks a slot kept in hand whose downloads the library's image hosts refused, to ask for again. */
+export interface AiStockRefusedPicks {
+    /** The search they came from, as it was sent: asked again, the provider's cache answers it. */
+    request: StockPhotoSearchRequest;
+    /** The picks' source keys (`pixabay:5401602`), best first. */
+    keys: string[];
+    /** When the last of them was refused, ISO. */
+    at: string;
+}
+/** A picture of one of the start's pages that holds a starter photo. */
+export interface AiSiteStarterSlot {
+    /** The `image` node. */
+    image: string;
+    /** What the picture was to show, in the slot's own words: a starter's alt text is the starter's. */
+    words: string;
+    role: AiLayoutPictureRole;
+    /** The frame's shape, width over height. */
+    aspect: number;
+    refused?: AiStockRefusedPicks;
+}
+/** A page of the start with the pictures it left on a starter. */
+export interface AiSiteStarterPage {
+    /** The page's draft. */
+    screen: string;
+    slots: AiSiteStarterSlot[];
+}
+/** A record of a pictured list, as its photo was written. */
+export interface AiSiteListRecord {
+    /** The record's name: its first field's value. */
+    name: string;
+    /** What the list files it under, where it files its records (AGL-3856). */
+    category?: string;
+    /** The value its photo field holds: a starter's path, or the library photo's CDN path. */
+    value: string;
+    /** The library photo it shows, with its size and words; absent on a starter. */
+    photo?: AiLayoutPicturePhoto;
+    refused?: AiStockRefusedPicks;
+}
+/** A pictured list of the start, one of whose records holds a starter photo. */
+export interface AiSiteStarterList {
+    /** The dataset. */
+    dataset: string;
+    /** Its photo field, by id. */
+    imageField: string;
+    /** The field its records keep what their photo shows in, by id (AGL-3856). */
+    altField?: string;
+    /** A list of the business's people: a record of it never takes a photo of anything but a person. */
+    people?: boolean;
+    /** Every record, in order, so a record's neighbors are known. */
+    records: AiSiteListRecord[];
+}
+/** What a site job holds on its pictures that took a starter, until its late photo pass. */
+export interface AiSitePhotos {
+    pages: AiSiteStarterPage[];
+    lists: AiSiteStarterList[];
+    /**
+     * The late photo passes that ran out of time and handed this back (AGL-3988).
+     * The site step publishes on the last pass its bound gives them, whatever
+     * the pictures hold then, so a burst that never clears never holds a site
+     * back.
+     */
+    latePasses?: number;
+}
+/**
+ * The job's photos state once a unit reported its own (AGL-3988): a page's
+ * or a list's entry replaces the one it had, by its draft or its dataset;
+ * every other entry stays. `null` where neither holds anything.
+ */
+export declare function aiSiteMergePhotos(previous: AiSitePhotos | null | undefined, next: Partial<AiSitePhotos> | null | undefined): AiSitePhotos | null;
+/**
+ * Whether a site job owes its late photo pass: a page picture or a list
+ * record it left on a starter. With `pageIds`, only a picture of one of
+ * those pages counts: a page that was not built is never published.
+ */
+export declare function aiSitePhotosOwed(photos: AiSitePhotos | null | undefined, pageIds?: readonly string[]): boolean;
+/** When the newest refusal the state holds was made, in ms; `null` where none was. */
+export declare function aiSitePhotosLastRefusalMs(photos: AiSitePhotos | null | undefined): number | null;

package/src/lib/model/ai-site-photos.js

@@ -0,0 +1,128 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */ import { _ as _extends } from "@swc/helpers/_/_extends";
+/**
+ * THE PICTURES A SITE START LEFT ON A STARTER PHOTO (AGL-3988).
+ *
+ * A guided start's pages and its datasets' records are each built in a pass
+ * of their own, minutes apart. A picture the stock library could not fill in
+ * its pass took a starter photo there: its picks' downloads refused by the
+ * library's image hosts in a burst, or no photo of the job's own to take
+ * yet. The v1.0.0-beta.271 Laurel Fork Photography start (2026-10-19 23:05Z)
+ * filed all twelve "Gallery collections" covers and its home hero under an
+ * office team and a desk: pixabay.com's Cloudflare answered 429 to 22
+ * downloads while the covers were built, before the job had copied any
+ * photo, and to 11 more on the home page, the first page built.
+ *
+ * Each such picture is written down here, with the picks the hosts refused,
+ * on the job, by the machine, in the write that records its pass. The site
+ * step's late photo pass (`jobs/ai-site-late-photos.ts`) reads it once every
+ * page is built and before the site is published: it asks the refused picks
+ * for again, a minute after the refusal, and gives every picture still on a
+ * starter one of the photos the job copied. Pure.
+ */ /** Where a starter photo is served from: the platform's own files, on every site's origin. */ export const AI_SITE_STARTER_PREFIX = '/_static/starter/';
+/** Whether an address is a starter photo's. */ export function aiSiteIsStarterSrc(src) {
+    return typeof src === 'string' && src.startsWith(AI_SITE_STARTER_PREFIX);
+}
+/** The most of each a job keeps: a site's pages, each one's pictures, and its lists' records. */ const PAGES_MAX = 12;
+const SLOTS_MAX = 16;
+const LISTS_MAX = 8;
+const RECORDS_MAX = 24;
+const KEYS_MAX = 3;
+/** An entry with its refused picks bounded, and none where it has none. */ function withPicks(entry) {
+    var _ref;
+    var _entry_refused;
+    const copy = _extends({}, entry);
+    delete copy.refused;
+    const keys = (_ref = (_entry_refused = entry.refused) == null ? void 0 : _entry_refused.keys.slice(0, KEYS_MAX)) != null ? _ref : [];
+    return entry.refused && keys.length ? _extends({}, copy, {
+        refused: _extends({}, entry.refused, {
+            keys
+        })
+    }) : copy;
+}
+/** A page's starters as a job keeps them: bounded, and none without a picture. */ function pageOf(page) {
+    const slots = page.slots.slice(0, SLOTS_MAX).map(withPicks);
+    return page.screen && slots.length ? {
+        screen: page.screen,
+        slots
+    } : null;
+}
+/** Whether a list still holds a starter on any record. */ function listHoldsStarters(list) {
+    return list.records.some((record)=>aiSiteIsStarterSrc(record.value));
+}
+/**
+ * The job's photos state once a unit reported its own (AGL-3988): a page's
+ * or a list's entry replaces the one it had, by its draft or its dataset;
+ * every other entry stays. `null` where neither holds anything.
+ */ export function aiSiteMergePhotos(previous, next) {
+    var _ref, _ref1, _ref2, _ref3, _ref4;
+    const pages = new Map(((_ref = previous == null ? void 0 : previous.pages) != null ? _ref : []).map((page)=>[
+            page.screen,
+            page
+        ]));
+    for (const page of (_ref1 = next == null ? void 0 : next.pages) != null ? _ref1 : []){
+        const kept = pageOf(page);
+        if (kept) pages.set(kept.screen, kept);
+        else pages.delete(page.screen);
+    }
+    const lists = new Map(((_ref2 = previous == null ? void 0 : previous.lists) != null ? _ref2 : []).map((list)=>[
+            list.dataset,
+            list
+        ]));
+    for (const list of (_ref3 = next == null ? void 0 : next.lists) != null ? _ref3 : []){
+        if (list.dataset && list.imageField && listHoldsStarters(list)) {
+            lists.set(list.dataset, _extends({}, list, {
+                records: list.records.slice(0, RECORDS_MAX).map(withPicks)
+            }));
+        } else lists.delete(list.dataset);
+    }
+    const merged = {
+        pages: [
+            ...pages.values()
+        ].slice(0, PAGES_MAX),
+        lists: [
+            ...lists.values()
+        ].slice(0, LISTS_MAX)
+    };
+    const latePasses = (_ref4 = next == null ? void 0 : next.latePasses) != null ? _ref4 : previous == null ? void 0 : previous.latePasses;
+    if (latePasses) merged.latePasses = latePasses;
+    return merged.pages.length || merged.lists.length ? merged : null;
+}
+/**
+ * Whether a site job owes its late photo pass: a page picture or a list
+ * record it left on a starter. With `pageIds`, only a picture of one of
+ * those pages counts: a page that was not built is never published.
+ */ export function aiSitePhotosOwed(photos, pageIds) {
+    const built = pageIds ? new Set(pageIds) : null;
+    return Boolean((photos == null ? void 0 : photos.pages.some((page)=>page.slots.length && (!built || built.has(page.screen)))) || (photos == null ? void 0 : photos.lists.some(listHoldsStarters)));
+}
+/** When the newest refusal the state holds was made, in ms; `null` where none was. */ export function aiSitePhotosLastRefusalMs(photos) {
+    var _ref, _ref1;
+    const times = [
+        ...((_ref = photos == null ? void 0 : photos.pages) != null ? _ref : []).flatMap((page)=>page.slots.map((slot)=>{
+                var _slot_refused;
+                return (_slot_refused = slot.refused) == null ? void 0 : _slot_refused.at;
+            })),
+        ...((_ref1 = photos == null ? void 0 : photos.lists) != null ? _ref1 : []).flatMap((list)=>list.records.map((record)=>{
+                var _record_refused;
+                return (_record_refused = record.refused) == null ? void 0 : _record_refused.at;
+            }))
+    ].map((at)=>at ? Date.parse(at) : NaN).filter((ms)=>Number.isFinite(ms));
+    return times.length ? Math.max(...times) : null;
+}
+
+//# sourceMappingURL=ai-site-photos.js.map

package/src/lib/model/ai-site-photos.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/model/ai-site-photos.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport type { StockPhotoSearchRequest } from '@aglyn/aglyn/plugin-manager/stock-photo-provider'\nimport type { AiLayoutPicturePhoto, AiLayoutPictureRole } from '../layout-language/ai-layout-pictures'\n\n/**\n * THE PICTURES A SITE START LEFT ON A STARTER PHOTO (AGL-3988).\n *\n * A guided start's pages and its datasets' records are each built in a pass\n * of their own, minutes apart. A picture the stock library could not fill in\n * its pass took a starter photo there: its picks' downloads refused by the\n * library's image hosts in a burst, or no photo of the job's own to take\n * yet. The v1.0.0-beta.271 Laurel Fork Photography start (2026-10-19 23:05Z)\n * filed all twelve \"Gallery collections\" covers and its home hero under an\n * office team and a desk: pixabay.com's Cloudflare answered 429 to 22\n * downloads while the covers were built, before the job had copied any\n * photo, and to 11 more on the home page, the first page built.\n *\n * Each such picture is written down here, with the picks the hosts refused,\n * on the job, by the machine, in the write that records its pass. The site\n * step's late photo pass (`jobs/ai-site-late-photos.ts`) reads it once every\n * page is built and before the site is published: it asks the refused picks\n * for again, a minute after the refusal, and gives every picture still on a\n * starter one of the photos the job copied. Pure.\n */\n\n/** Where a starter photo is served from: the platform's own files, on every site's origin. */\nexport const AI_SITE_STARTER_PREFIX = '/_static/starter/'\n\n/** Whether an address is a starter photo's. */\nexport function aiSiteIsStarterSrc(src: unknown): boolean {\n  return typeof src === 'string' && src.startsWith(AI_SITE_STARTER_PREFIX)\n}\n\n/** The picks a slot kept in hand whose downloads the library's image hosts refused, to ask for again. */\nexport interface AiStockRefusedPicks {\n  /** The search they came from, as it was sent: asked again, the provider's cache answers it. */\n  request: StockPhotoSearchRequest\n  /** The picks' source keys (`pixabay:5401602`), best first. */\n  keys: string[]\n  /** When the last of them was refused, ISO. */\n  at: string\n}\n\n/** A picture of one of the start's pages that holds a starter photo. */\nexport interface AiSiteStarterSlot {\n  /** The `image` node. */\n  image: string\n  /** What the picture was to show, in the slot's own words: a starter's alt text is the starter's. */\n  words: string\n  role: AiLayoutPictureRole\n  /** The frame's shape, width over height. */\n  aspect: number\n  refused?: AiStockRefusedPicks\n}\n\n/** A page of the start with the pictures it left on a starter. */\nexport interface AiSiteStarterPage {\n  /** The page's draft. */\n  screen: string\n  slots: AiSiteStarterSlot[]\n}\n\n/** A record of a pictured list, as its photo was written. */\nexport interface AiSiteListRecord {\n  /** The record's name: its first field's value. */\n  name: string\n  /** What the list files it under, where it files its records (AGL-3856). */\n  category?: string\n  /** The value its photo field holds: a starter's path, or the library photo's CDN path. */\n  value: string\n  /** The library photo it shows, with its size and words; absent on a starter. */\n  photo?: AiLayoutPicturePhoto\n  refused?: AiStockRefusedPicks\n}\n\n/** A pictured list of the start, one of whose records holds a starter photo. */\nexport interface AiSiteStarterList {\n  /** The dataset. */\n  dataset: string\n  /** Its photo field, by id. */\n  imageField: string\n  /** The field its records keep what their photo shows in, by id (AGL-3856). */\n  altField?: string\n  /** A list of the business's people: a record of it never takes a photo of anything but a person. */\n  people?: boolean\n  /** Every record, in order, so a record's neighbors are known. */\n  records: AiSiteListRecord[]\n}\n\n/** What a site job holds on its pictures that took a starter, until its late photo pass. */\nexport interface AiSitePhotos {\n  pages: AiSiteStarterPage[]\n  lists: AiSiteStarterList[]\n  /**\n   * The late photo passes that ran out of time and handed this back (AGL-3988).\n   * The site step publishes on the last pass its bound gives them, whatever\n   * the pictures hold then, so a burst that never clears never holds a site\n   * back.\n   */\n  latePasses?: number\n}\n\n/** The most of each a job keeps: a site's pages, each one's pictures, and its lists' records. */\nconst PAGES_MAX = 12\nconst SLOTS_MAX = 16\nconst LISTS_MAX = 8\nconst RECORDS_MAX = 24\nconst KEYS_MAX = 3\n\n/** An entry with its refused picks bounded, and none where it has none. */\nfunction withPicks<T extends { refused?: AiStockRefusedPicks }>(entry: T): T {\n  const copy = { ...entry }\n  delete copy.refused\n  const keys = entry.refused?.keys.slice(0, KEYS_MAX) ?? []\n  return entry.refused && keys.length ? { ...copy, refused: { ...entry.refused, keys } } : copy\n}\n\n/** A page's starters as a job keeps them: bounded, and none without a picture. */\nfunction pageOf(page: AiSiteStarterPage): AiSiteStarterPage | null {\n  const slots = page.slots.slice(0, SLOTS_MAX).map(withPicks)\n  return page.screen && slots.length ? { screen: page.screen, slots } : null\n}\n\n/** Whether a list still holds a starter on any record. */\nfunction listHoldsStarters(list: AiSiteStarterList): boolean {\n  return list.records.some((record) => aiSiteIsStarterSrc(record.value))\n}\n\n/**\n * The job's photos state once a unit reported its own (AGL-3988): a page's\n * or a list's entry replaces the one it had, by its draft or its dataset;\n * every other entry stays. `null` where neither holds anything.\n */\nexport function aiSiteMergePhotos(\n  previous: AiSitePhotos | null | undefined,\n  next: Partial<AiSitePhotos> | null | undefined,\n): AiSitePhotos | null {\n  const pages = new Map((previous?.pages ?? []).map((page) => [page.screen, page]))\n  for (const page of next?.pages ?? []) {\n    const kept = pageOf(page)\n    if (kept) pages.set(kept.screen, kept)\n    else pages.delete(page.screen)\n  }\n  const lists = new Map((previous?.lists ?? []).map((list) => [list.dataset, list]))\n  for (const list of next?.lists ?? []) {\n    if (list.dataset && list.imageField && listHoldsStarters(list)) {\n      lists.set(list.dataset, { ...list, records: list.records.slice(0, RECORDS_MAX).map(withPicks) })\n    } else lists.delete(list.dataset)\n  }\n  const merged: AiSitePhotos = { pages: [...pages.values()].slice(0, PAGES_MAX), lists: [...lists.values()].slice(0, LISTS_MAX) }\n  const latePasses = next?.latePasses ?? previous?.latePasses\n  if (latePasses) merged.latePasses = latePasses\n  return merged.pages.length || merged.lists.length ? merged : null\n}\n\n/**\n * Whether a site job owes its late photo pass: a page picture or a list\n * record it left on a starter. With `pageIds`, only a picture of one of\n * those pages counts: a page that was not built is never published.\n */\nexport function aiSitePhotosOwed(photos: AiSitePhotos | null | undefined, pageIds?: readonly string[]): boolean {\n  const built = pageIds ? new Set(pageIds) : null\n  return Boolean(\n    photos?.pages.some((page) => page.slots.length && (!built || built.has(page.screen))) || photos?.lists.some(listHoldsStarters),\n  )\n}\n\n/** When the newest refusal the state holds was made, in ms; `null` where none was. */\nexport function aiSitePhotosLastRefusalMs(photos: AiSitePhotos | null | undefined): number | null {\n  const times = [\n    ...(photos?.pages ?? []).flatMap((page) => page.slots.map((slot) => slot.refused?.at)),\n    ...(photos?.lists ?? []).flatMap((list) => list.records.map((record) => record.refused?.at)),\n  ]\n    .map((at) => (at ? Date.parse(at) : NaN))\n    .filter((ms) => Number.isFinite(ms))\n  return times.length ? Math.max(...times) : null\n}\n"],"names":["AI_SITE_STARTER_PREFIX","aiSiteIsStarterSrc","src","startsWith","PAGES_MAX","SLOTS_MAX","LISTS_MAX","RECORDS_MAX","KEYS_MAX","withPicks","entry","copy","refused","keys","slice","length","pageOf","page","slots","map","screen","listHoldsStarters","list","records","some","record","value","aiSiteMergePhotos","previous","next","pages","Map","kept","set","delete","lists","dataset","imageField","merged","values","latePasses","aiSitePhotosOwed","photos","pageIds","built","Set","Boolean","has","aiSitePhotosLastRefusalMs","times","flatMap","slot","at","Date","parse","NaN","filter","ms","Number","isFinite","Math","max"],"mappings":"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"}

package/src/lib/model/ai-site-start.d.ts

@@ -186,18 +186,29 @@ export declare function aiSiteStartAnswersFromInputs(inputs: Readonly<Record<str
 }): AiSiteStartAnswers | null;
 /**
  * The questions' answers for a site staff are building for a client: what
- * the business does is the kind of site, and every other answer keeps its
- * default, which the review shows to change. The rest of the intake is not an
- * answer to these questions; it reaches the job through
- * {@link aiSiteStartClientInputs} and {@link aiSiteStartClientBrief}.
+ * the business does is the kind of site, and the details the intake holds
+ * fill the Details step's own fields (AGL-3979, AGL-3995): the phone, the
+ * email, the towns as the areas it serves and the hours, each held to that
+ * detail's own rule, so one the Details step would refuse is left empty
+ * there. Every other answer keeps its default, which the review shows to
+ * change. The intake, a refused detail included, also reaches the job
+ * through {@link aiSiteStartClientInputs} and {@link aiSiteStartClientBrief}.
  */
 export declare function aiSiteStartAnswersFromClientBuild(intake: ClientBuildIntake): AiSiteStartAnswers;
 /**
  * The per-site inputs the intake fills, which the guided start's own
  * questions leave empty: the business's name for the header and footer, and
  * the towns it serves as its place.
+ *
+ * The towns are the place only while no address is given. The Entity reads
+ * `city` as the address's own locality wherever there is a street or a
+ * postal code (`aiSiteEntity`), so once the answers carry either, `city` is
+ * the city the Details step was given with that address, never the towns
+ * (AGL-3995). The intake asks no address, so today that is the Details step's
+ * own, typed on the review; the towns still reach the site as the areas it
+ * serves.
  */
-export declare function aiSiteStartClientInputs(intake: ClientBuildIntake): Pick<AiSiteJobInputs, 'businessName' | 'city'>;
+export declare function aiSiteStartClientInputs(intake: ClientBuildIntake, answers?: Pick<AiSiteStartAnswers, 'street' | 'postalCode' | 'city'> | null): Pick<AiSiteJobInputs, 'businessName' | 'city'>;
 /**
  * The intake as sentences added to the brief: how to reach the business and
  * when it is open, which the site should say where a visitor looks for them,
@@ -206,9 +217,11 @@ export declare function aiSiteStartClientInputs(intake: ClientBuildIntake): Pick
  */
 export declare function aiSiteStartClientBrief(intake: ClientBuildIntake): string;
 /**
- * What the review says the client build adds, so staff see the intake is
- * used without it being asked again: "Also from the client's details:
- * Harbor Plumbing, serving Austin, its phone, email and hours, and the
- * owner's own words."
+ * What the review says the client build adds beyond its own rows, so staff
+ * see the intake is used without it being asked again: the business's name
+ * and the owner's own words, which no row shows. The phone, email, towns and
+ * hours are the review's Details rows already (AGL-3995), so the note does
+ * not say them twice: "Also from the client's details: Harbor Plumbing and
+ * the owner's own words."
  */
 export declare function aiSiteStartClientNote(intake: ClientBuildIntake): string;

package/src/lib/model/ai-site-start.js

@@ -14,7 +14,8 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */ import { _ as _extends } from "@swc/helpers/_/_extends";
-import { AI_SITE_DETAIL_KEYS, AI_SITE_NO_DETAILS, aiSiteDetailProblem } from "./ai-site-details.js";
+import { weeklyHoursFromText, weeklyHoursToText } from "@aglyn/shared-ui-jsx/utils/weekly-hours";
+import { AI_SITE_DETAIL_KEYS, AI_SITE_NO_DETAILS, aiSiteDetailProblem, aiSiteDetailsOf } from "./ai-site-details.js";
 import { aiSiteKind, aiSiteKindFor } from "./ai-site-kinds.js";
 import { AI_SITE_INSPIRATION_INPUT, aiSiteInspirationInput, aiSiteInspirationLimit, aiSiteInspirationRefusal, aiSiteInspirationUrl } from "./ai-site-inspiration.js";
 import { AI_SITE_INPUT_MAX_CHARS, AI_SITE_SUBMISSIONS, aiSitePagesBand } from "./ai-site-job.js";
@@ -304,25 +305,72 @@ import { AI_SITE_INPUT_MAX_CHARS, AI_SITE_SUBMISSIONS, aiSitePagesBand } from ".
     const space = cut.lastIndexOf(' ');
     return (space > max / 2 ? cut.slice(0, space) : cut).trim();
 }
+/** A time with am or pm: "9am", "5:30 pm", "12 a.m.". */ const TWELVE_HOUR_TIME = /\b(\d{1,2})(?::(\d{2}))?\s*([ap])\.?m\.?(?![a-z])/gi;
+/**
+ * The hours an owner gave, in the shape the Details step's hours picker
+ * writes (`Tu-Sa 09:00-17:00`, one set of days a line), so the plan reads
+ * them as it reads hours picked there. A time with am or pm is the time it
+ * names, "to" joins a range as a dash does, and days with their hours may be
+ * set apart by a comma, a semicolon or a line. Whatever still does not read
+ * as hours — "8–5", "Sat by appointment" — is left out rather than guessed at.
+ */ function clientBuildHours(hours) {
+    const lines = hours.replace(TWELVE_HOUR_TIME, (time, hour, minutes, half)=>{
+        const h = Number(hour);
+        if (h < 1 || h > 12) return time;
+        const clock = h % 12 + (half.toLowerCase() === 'p' ? 12 : 0);
+        return `${String(clock).padStart(2, '0')}:${minutes != null ? minutes : '00'}`;
+    }).replace(/\s+to\s+/gi, '-').replace(/(\d{1,2}:\d{2})\s*,\s*/g, '$1\n').replace(/;/g, '\n');
+    const week = weeklyHoursFromText(lines).hours;
+    return week.some((day)=>day.length) ? weeklyHoursToText(week) : '';
+}
+/**
+ * The towns an intake serves, one a line, as the Details step's "Areas you
+ * serve" holds them: "Austin, Round Rock and Pflugerville" is three.
+ */ function clientBuildServiceArea(towns) {
+    return towns.split(/\r?\n|[,;]|\s+(?:and|&)\s+/i).map((town)=>town.trim()).filter(Boolean).join('\n');
+}
 /**
  * The questions' answers for a site staff are building for a client: what
- * the business does is the kind of site, and every other answer keeps its
- * default, which the review shows to change. The rest of the intake is not an
- * answer to these questions; it reaches the job through
- * {@link aiSiteStartClientInputs} and {@link aiSiteStartClientBrief}.
+ * the business does is the kind of site, and the details the intake holds
+ * fill the Details step's own fields (AGL-3979, AGL-3995): the phone, the
+ * email, the towns as the areas it serves and the hours, each held to that
+ * detail's own rule, so one the Details step would refuse is left empty
+ * there. Every other answer keeps its default, which the review shows to
+ * change. The intake, a refused detail included, also reaches the job
+ * through {@link aiSiteStartClientInputs} and {@link aiSiteStartClientBrief}.
  */ export function aiSiteStartAnswersFromClientBuild(intake) {
+    const details = aiSiteDetailsOf({
+        phone: intake.phone,
+        email: intake.email,
+        serviceArea: clientBuildServiceArea(intake.towns),
+        hours: clientBuildHours(intake.hours)
+    });
     return _extends({}, AI_SITE_START_ANSWERS, {
-        siteType: bounded(intake.whatTheyDo, AI_SITE_INPUT_MAX_CHARS)
+        siteType: bounded(intake.whatTheyDo, AI_SITE_INPUT_MAX_CHARS),
+        phone: details.phone,
+        email: details.email,
+        serviceArea: details.serviceArea,
+        hours: details.hours
     });
 }
 /**
  * The per-site inputs the intake fills, which the guided start's own
  * questions leave empty: the business's name for the header and footer, and
  * the towns it serves as its place.
- */ export function aiSiteStartClientInputs(intake) {
+ *
+ * The towns are the place only while no address is given. The Entity reads
+ * `city` as the address's own locality wherever there is a street or a
+ * postal code (`aiSiteEntity`), so once the answers carry either, `city` is
+ * the city the Details step was given with that address, never the towns
+ * (AGL-3995). The intake asks no address, so today that is the Details step's
+ * own, typed on the review; the towns still reach the site as the areas it
+ * serves.
+ */ export function aiSiteStartClientInputs(intake, answers) {
+    var _ref;
+    const addressed = Boolean((answers == null ? void 0 : answers.street.trim()) || (answers == null ? void 0 : answers.postalCode.trim()));
     return {
         businessName: bounded(intake.businessName, AI_SITE_INPUT_MAX_CHARS),
-        city: bounded(intake.towns, AI_SITE_INPUT_MAX_CHARS)
+        city: bounded(addressed ? (_ref = answers == null ? void 0 : answers.city) != null ? _ref : '' : intake.towns, AI_SITE_INPUT_MAX_CHARS)
     };
 }
 /**
@@ -352,26 +400,19 @@ import { AI_SITE_INPUT_MAX_CHARS, AI_SITE_SUBMISSIONS, aiSitePagesBand } from ".
     return sentences.join(' ');
 }
 /**
- * What the review says the client build adds, so staff see the intake is
- * used without it being asked again: "Also from the client's details:
- * Harbor Plumbing, serving Austin, its phone, email and hours, and the
- * owner's own words."
+ * What the review says the client build adds beyond its own rows, so staff
+ * see the intake is used without it being asked again: the business's name
+ * and the owner's own words, which no row shows. The phone, email, towns and
+ * hours are the review's Details rows already (AGL-3995), so the note does
+ * not say them twice: "Also from the client's details: Harbor Plumbing and
+ * the owner's own words."
  */ export function aiSiteStartClientNote(intake) {
-    const name = intake.businessName.trim();
-    const towns = intake.towns.trim();
-    const reach = [
-        intake.phone.trim() ? 'phone' : '',
-        intake.email.trim() ? 'email' : '',
-        intake.hours.trim() ? 'hours' : ''
-    ].filter(Boolean);
     const parts = [
-        name && towns ? `${name}, serving ${towns}` : name || (towns ? `serving ${towns}` : ''),
-        reach.length ? `its ${reach.length > 1 ? `${reach.slice(0, -1).join(', ')} and ${reach[reach.length - 1]}` : reach[0]}` : '',
+        intake.businessName.trim(),
         intake.ownerWords.trim() ? "the owner's own words" : ''
     ].filter(Boolean);
     if (!parts.length) return 'Built from the client’s details.';
-    const list = parts.length > 1 ? `${parts.slice(0, -1).join(', ')}, and ${parts[parts.length - 1]}` : parts[0];
-    return `Also from the client’s details: ${list}.`;
+    return `Also from the client’s details: ${parts.join(' and ')}.`;
 }
 
 //# sourceMappingURL=ai-site-start.js.map