@aglyn/plugins-ai 1.0.0-beta.272 → 1.0.0-beta.274

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/runtime/ai-doctrine-validators.d.ts

@@ -619,7 +619,9 @@ export declare function aiDanglingWord(line: string, language?: string | null):
  * past half of `max` is cut at `max` itself, mid-word.
  *
  * The page step clips what it stores with it; `aiSettlePlanSeo` clips a plan
- * with it only where the cut lands on a whole word (AGL-3837).
+ * with it only where the cut lands on a whole word (AGL-3837); and an SEO
+ * listing or audit batch whose re-ask still ran past a length is fitted with
+ * it (`aiFitSeoText`, AGL-4016).
  */
 export declare function aiClipAtWord(value: string, max: number, language?: string | null): string;
 /**

package/src/lib/runtime/ai-doctrine-validators.js

@@ -2477,7 +2477,9 @@ function danglingTableFor(language) {
  * past half of `max` is cut at `max` itself, mid-word.
  *
  * The page step clips what it stores with it; `aiSettlePlanSeo` clips a plan
- * with it only where the cut lands on a whole word (AGL-3837).
+ * with it only where the cut lands on a whole word (AGL-3837); and an SEO
+ * listing or audit batch whose re-ask still ran past a length is fitted with
+ * it (`aiFitSeoText`, AGL-4016).
  */ export function aiClipAtWord(value, max, language) {
     const text = value.trim();
     if (text.length <= max) return text;