@aglyn/plugins-ai 1.0.0-beta.229 → 1.0.0-beta.231

package/src/lib/jobs/ai-layout-full-height.d.ts

@@ -0,0 +1,40 @@
+/**
+ * @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.
+ */
+/**
+ * A layout at least as tall as the window (AGL-3596).
+ *
+ * A layout is header, page, footer, top to bottom, and on a page shorter than
+ * the window the footer used to end wherever the page did — on beta.230 a
+ * contact page left its footer floating halfway up the screen with blank page
+ * under it. So every layout the AI builds is written as one column at least
+ * the window's height, and the part of it that holds the Layout Slot takes
+ * the room left over: the footer sits at the bottom of a short page and
+ * follows the content of a long one.
+ *
+ * Written by the platform after the model answers and before the doctrine
+ * checks the tree, so the doctrine holds the column like anything else: it is
+ * a Stack with a style of its own, which no rule calls an empty wrapper.
+ */
+/** The id of the column the platform adds, when no node of the tree has it. */
+export declare const AI_LAYOUT_FRAME_ID = "aiLayoutFrame";
+/**
+ * The layout with its root's children in a column at least the window's
+ * height, and the child that holds the Layout Slot growing into the room
+ * left. A tree whose top already sets a minimum height is left as it came,
+ * and so is anything that is not a node map or holds no Layout Slot.
+ */
+export declare function aiLayoutWithFullHeight(tree: unknown): unknown;

package/src/lib/jobs/ai-layout-full-height.js

@@ -0,0 +1,82 @@
+import { _ as _extends } from "@swc/helpers/_/_extends";
+/**
+ * @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.
+ */ /**
+ * A layout at least as tall as the window (AGL-3596).
+ *
+ * A layout is header, page, footer, top to bottom, and on a page shorter than
+ * the window the footer used to end wherever the page did — on beta.230 a
+ * contact page left its footer floating halfway up the screen with blank page
+ * under it. So every layout the AI builds is written as one column at least
+ * the window's height, and the part of it that holds the Layout Slot takes
+ * the room left over: the footer sits at the bottom of a short page and
+ * follows the content of a long one.
+ *
+ * Written by the platform after the model answers and before the doctrine
+ * checks the tree, so the doctrine holds the column like anything else: it is
+ * a Stack with a style of its own, which no rule calls an empty wrapper.
+ */ /** The id of the column the platform adds, when no node of the tree has it. */ export const AI_LAYOUT_FRAME_ID = 'aiLayoutFrame';
+const isRecord = (value)=>Boolean(value) && typeof value === 'object' && !Array.isArray(value);
+const childrenOf = (node)=>Array.isArray(node == null ? void 0 : node.nodes) ? node.nodes.filter((id)=>typeof id === 'string') : [];
+/**
+ * The layout with its root's children in a column at least the window's
+ * height, and the child that holds the Layout Slot growing into the room
+ * left. A tree whose top already sets a minimum height is left as it came,
+ * and so is anything that is not a node map or holds no Layout Slot.
+ */ export function aiLayoutWithFullHeight(tree) {
+    var _source_grower_sx;
+    var _source_top__sx;
+    if (!isRecord(tree) || !isRecord(tree['nodes'])) return tree;
+    const source = tree['nodes'];
+    const rootId = typeof tree['rootId'] === 'string' ? tree['rootId'] : null;
+    if (!rootId || !isRecord(source[rootId])) return tree;
+    const top = childrenOf(source[rootId]).filter((id)=>isRecord(source[id]));
+    if (!top.length) return tree;
+    if (top.length === 1 && ((_source_top__sx = source[top[0]].sx) == null ? void 0 : _source_top__sx['minHeight']) !== undefined) return tree;
+    const holdsSlot = (id, seen = new Set())=>{
+        if (seen.has(id) || !isRecord(source[id])) return false;
+        seen.add(id);
+        return source[id].componentId === 'layoutSlot' || childrenOf(source[id]).some((child)=>holdsSlot(child, seen));
+    };
+    const grower = top.find((id)=>holdsSlot(id));
+    if (!grower) return tree;
+    let frameId = AI_LAYOUT_FRAME_ID;
+    for(let n = 2; frameId in source; n += 1)frameId = `${AI_LAYOUT_FRAME_ID}${n}`;
+    const nodes = _extends({}, source, {
+        [rootId]: _extends({}, source[rootId], {
+            nodes: [
+                frameId
+            ]
+        }),
+        [frameId]: {
+            componentId: 'muiStack',
+            sx: {
+                minHeight: '100vh'
+            },
+            nodes: top
+        },
+        [grower]: _extends({}, source[grower], {
+            sx: _extends({}, (_source_grower_sx = source[grower].sx) != null ? _source_grower_sx : {}, {
+                flexGrow: 1
+            })
+        })
+    });
+    return _extends({}, tree, {
+        nodes
+    });
+}
+
+//# sourceMappingURL=ai-layout-full-height.js.map

package/src/lib/jobs/ai-layout-full-height.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/jobs/ai-layout-full-height.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\n/**\n * A layout at least as tall as the window (AGL-3596).\n *\n * A layout is header, page, footer, top to bottom, and on a page shorter than\n * the window the footer used to end wherever the page did — on beta.230 a\n * contact page left its footer floating halfway up the screen with blank page\n * under it. So every layout the AI builds is written as one column at least\n * the window's height, and the part of it that holds the Layout Slot takes\n * the room left over: the footer sits at the bottom of a short page and\n * follows the content of a long one.\n *\n * Written by the platform after the model answers and before the doctrine\n * checks the tree, so the doctrine holds the column like anything else: it is\n * a Stack with a style of its own, which no rule calls an empty wrapper.\n */\n\n/** The id of the column the platform adds, when no node of the tree has it. */\nexport const AI_LAYOUT_FRAME_ID = 'aiLayoutFrame'\n\ntype RawNode = { componentId?: unknown; props?: Record<string, unknown>; sx?: Record<string, unknown>; nodes?: unknown }\n\nconst isRecord = (value: unknown): value is Record<string, unknown> =>\n  Boolean(value) && typeof value === 'object' && !Array.isArray(value)\n\nconst childrenOf = (node: RawNode | undefined): string[] =>\n  Array.isArray(node?.nodes) ? (node.nodes as unknown[]).filter((id): id is string => typeof id === 'string') : []\n\n/**\n * The layout with its root's children in a column at least the window's\n * height, and the child that holds the Layout Slot growing into the room\n * left. A tree whose top already sets a minimum height is left as it came,\n * and so is anything that is not a node map or holds no Layout Slot.\n */\nexport function aiLayoutWithFullHeight(tree: unknown): unknown {\n  if (!isRecord(tree) || !isRecord(tree['nodes'])) return tree\n  const source = tree['nodes'] as Record<string, RawNode>\n  const rootId = typeof tree['rootId'] === 'string' ? tree['rootId'] : null\n  if (!rootId || !isRecord(source[rootId])) return tree\n  const top = childrenOf(source[rootId]).filter((id) => isRecord(source[id]))\n  if (!top.length) return tree\n  if (top.length === 1 && source[top[0]].sx?.['minHeight'] !== undefined) return tree\n\n  const holdsSlot = (id: string, seen = new Set<string>()): boolean => {\n    if (seen.has(id) || !isRecord(source[id])) return false\n    seen.add(id)\n    return source[id].componentId === 'layoutSlot' || childrenOf(source[id]).some((child) => holdsSlot(child, seen))\n  }\n  const grower = top.find((id) => holdsSlot(id))\n  if (!grower) return tree\n\n  let frameId = AI_LAYOUT_FRAME_ID\n  for (let n = 2; frameId in source; n += 1) frameId = `${AI_LAYOUT_FRAME_ID}${n}`\n  const nodes: Record<string, RawNode> = {\n    ...source,\n    [rootId]: { ...source[rootId], nodes: [frameId] },\n    [frameId]: { componentId: 'muiStack', sx: { minHeight: '100vh' }, nodes: top },\n    [grower]: { ...source[grower], sx: { ...(source[grower].sx ?? {}), flexGrow: 1 } },\n  }\n  return { ...tree, nodes }\n}\n"],"names":["AI_LAYOUT_FRAME_ID","isRecord","value","Boolean","Array","isArray","childrenOf","node","nodes","filter","id","aiLayoutWithFullHeight","tree","source","rootId","top","length","sx","undefined","holdsSlot","seen","Set","has","add","componentId","some","child","grower","find","frameId","n","minHeight","flexGrow"],"mappings":";AAAA;;;;;;;;;;;;;;;CAeC,GAED;;;;;;;;;;;;;;CAcC,GAED,6EAA6E,GAC7E,OAAO,MAAMA,qBAAqB,gBAAe;AAIjD,MAAMC,WAAW,CAACC,QAChBC,QAAQD,UAAU,OAAOA,UAAU,YAAY,CAACE,MAAMC,OAAO,CAACH;AAEhE,MAAMI,aAAa,CAACC,OAClBH,MAAMC,OAAO,CAACE,wBAAAA,KAAMC,KAAK,IAAI,AAACD,KAAKC,KAAK,CAAeC,MAAM,CAAC,CAACC,KAAqB,OAAOA,OAAO,YAAY,EAAE;AAElH;;;;;CAKC,GACD,OAAO,SAASC,uBAAuBC,IAAa;QAuBPC;QAhBnBA;IANxB,IAAI,CAACZ,SAASW,SAAS,CAACX,SAASW,IAAI,CAAC,QAAQ,GAAG,OAAOA;IACxD,MAAMC,SAASD,IAAI,CAAC,QAAQ;IAC5B,MAAME,SAAS,OAAOF,IAAI,CAAC,SAAS,KAAK,WAAWA,IAAI,CAAC,SAAS,GAAG;IACrE,IAAI,CAACE,UAAU,CAACb,SAASY,MAAM,CAACC,OAAO,GAAG,OAAOF;IACjD,MAAMG,MAAMT,WAAWO,MAAM,CAACC,OAAO,EAAEL,MAAM,CAAC,CAACC,KAAOT,SAASY,MAAM,CAACH,GAAG;IACzE,IAAI,CAACK,IAAIC,MAAM,EAAE,OAAOJ;IACxB,IAAIG,IAAIC,MAAM,KAAK,KAAKH,EAAAA,kBAAAA,MAAM,CAACE,GAAG,CAAC,EAAE,CAAC,CAACE,EAAE,qBAAjBJ,eAAmB,CAAC,YAAY,MAAKK,WAAW,OAAON;IAE/E,MAAMO,YAAY,CAACT,IAAYU,OAAO,IAAIC,KAAa;QACrD,IAAID,KAAKE,GAAG,CAACZ,OAAO,CAACT,SAASY,MAAM,CAACH,GAAG,GAAG,OAAO;QAClDU,KAAKG,GAAG,CAACb;QACT,OAAOG,MAAM,CAACH,GAAG,CAACc,WAAW,KAAK,gBAAgBlB,WAAWO,MAAM,CAACH,GAAG,EAAEe,IAAI,CAAC,CAACC,QAAUP,UAAUO,OAAON;IAC5G;IACA,MAAMO,SAASZ,IAAIa,IAAI,CAAC,CAAClB,KAAOS,UAAUT;IAC1C,IAAI,CAACiB,QAAQ,OAAOf;IAEpB,IAAIiB,UAAU7B;IACd,IAAK,IAAI8B,IAAI,GAAGD,WAAWhB,QAAQiB,KAAK,EAAGD,UAAU,GAAG7B,qBAAqB8B,GAAG;IAChF,MAAMtB,QAAiC,aAClCK;QACH,CAACC,OAAO,EAAE,aAAKD,MAAM,CAACC,OAAO;YAAEN,OAAO;gBAACqB;aAAQ;;QAC/C,CAACA,QAAQ,EAAE;YAAEL,aAAa;YAAYP,IAAI;gBAAEc,WAAW;YAAQ;YAAGvB,OAAOO;QAAI;QAC7E,CAACY,OAAO,EAAE,aAAKd,MAAM,CAACc,OAAO;YAAEV,IAAI,cAAMJ,oBAAAA,MAAM,CAACc,OAAO,CAACV,EAAE,YAAjBJ,oBAAqB,CAAC;gBAAImB,UAAU;;;;IAE/E,OAAO,aAAKpB;QAAMJ;;AACpB"}

package/src/lib/jobs/ai-layout-site-facts.d.ts

@@ -0,0 +1,54 @@
+/**
+ * @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 { AiDoctrineTree, AiDoctrineViolation } from '../runtime/ai-doctrine-validators';
+/**
+ * What a layout may say about the business it frames (AGL-3596).
+ *
+ * A layout's header and footer are on every page, so a fact in them is
+ * published everywhere at once. Two went wrong on beta.230: the model coined
+ * a name for the business ("Austin Paws Grooming" for a site called Hillside
+ * Dog Grooming), and a footer is exactly where a model reaches for a phone
+ * number, an email or opening hours the brief never gave.
+ *
+ * - The site's name is the brand, and it is written as the host token that
+ *   reads it (`{{host.businessName}}`), so a rename in Setup follows on every
+ *   page rather than leaving the name it was built under
+ *   (`aiLayoutWithSiteName`).
+ * - A contact detail the brief does not give is refused by the layout's own
+ *   check (`aiLayoutInventedContactViolations`), so the model is asked again
+ *   to leave it out: an email, a phone number, a street address or opening
+ *   hours appear in the layout only when the brief has them.
+ */
+/** The host token that reads a site's own name at render. */
+export declare const AI_SITE_NAME_TOKEN = "{{host.businessName}}";
+/**
+ * The tree with every written occurrence of the site's name — the brand, the
+ * copyright line — replaced by the host token that reads it. Matched whole,
+ * ignoring case and runs of spaces. Anything that is not a node map, and a
+ * name too short to match safely, leaves the tree as it came.
+ */
+export declare function aiLayoutWithSiteName(tree: unknown, siteName: string | null | undefined): unknown;
+/**
+ * Rule 14 for a layout: every email address, phone number, street address
+ * and opening time its words carry is one the brief gives. A number is read
+ * by its digits, so a brief's "512.555.0142" admits "(512) 555-0142"; a year
+ * or a price is not a phone number, so only a run of seven digits or more is
+ * read as one. An address is matched by its house number and first street
+ * word; hours are admitted when the brief gives any, since a brief that names
+ * its hours is spelled a dozen ways a footer may fairly reword.
+ */
+export declare function aiLayoutInventedContactViolations(tree: AiDoctrineTree, brief: string): AiDoctrineViolation[];

package/src/lib/jobs/ai-layout-site-facts.js

@@ -0,0 +1,153 @@
+/**
+ * @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";
+import { walkTree } from "../runtime/ai-doctrine-validators.js";
+/**
+ * What a layout may say about the business it frames (AGL-3596).
+ *
+ * A layout's header and footer are on every page, so a fact in them is
+ * published everywhere at once. Two went wrong on beta.230: the model coined
+ * a name for the business ("Austin Paws Grooming" for a site called Hillside
+ * Dog Grooming), and a footer is exactly where a model reaches for a phone
+ * number, an email or opening hours the brief never gave.
+ *
+ * - The site's name is the brand, and it is written as the host token that
+ *   reads it (`{{host.businessName}}`), so a rename in Setup follows on every
+ *   page rather than leaving the name it was built under
+ *   (`aiLayoutWithSiteName`).
+ * - A contact detail the brief does not give is refused by the layout's own
+ *   check (`aiLayoutInventedContactViolations`), so the model is asked again
+ *   to leave it out: an email, a phone number, a street address or opening
+ *   hours appear in the layout only when the brief has them.
+ */ /** The host token that reads a site's own name at render. */ export const AI_SITE_NAME_TOKEN = '{{host.businessName}}';
+const isRecord = (value)=>Boolean(value) && typeof value === 'object' && !Array.isArray(value);
+const escapeRegExp = (value)=>value.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+/**
+ * The tree with every written occurrence of the site's name — the brand, the
+ * copyright line — replaced by the host token that reads it. Matched whole,
+ * ignoring case and runs of spaces. Anything that is not a node map, and a
+ * name too short to match safely, leaves the tree as it came.
+ */ export function aiLayoutWithSiteName(tree, siteName) {
+    const name = (siteName != null ? siteName : '').replace(/\s+/g, ' ').trim();
+    if (name.length < 3 || !isRecord(tree) || !isRecord(tree['nodes'])) return tree;
+    const pattern = new RegExp(`(?<![\\p{L}\\p{N}])${escapeRegExp(name).replace(/ /g, '\\s+')}(?![\\p{L}\\p{N}])`, 'giu');
+    let changed = false;
+    const nodes = {};
+    for (const [id, node] of Object.entries(tree['nodes'])){
+        if (!isRecord(node) || !isRecord(node['props'])) {
+            nodes[id] = node;
+            continue;
+        }
+        const props = {};
+        let touched = false;
+        for (const [key, value] of Object.entries(node['props'])){
+            const next = typeof value === 'string' ? value.replace(pattern, AI_SITE_NAME_TOKEN) : value;
+            if (next !== value) touched = true;
+            props[key] = next;
+        }
+        nodes[id] = touched ? _extends({}, node, {
+            props
+        }) : node;
+        changed || (changed = touched);
+    }
+    return changed ? _extends({}, tree, {
+        nodes
+    }) : tree;
+}
+const EMAIL = /[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\.[A-Za-z]{2,}/g;
+/** A phone number as people write one: seven or more digits, with the usual separators between them. */ const PHONE = /(?:\+?\(?\d[\d\s().-]{5,}\d)/g;
+const digitsOf = (value)=>value.replace(/\D/g, '');
+const STREET_SUFFIX = 'Street|St|Avenue|Ave|Road|Rd|Boulevard|Blvd|Lane|Ln|Drive|Dr|Way|Court|Ct|Place|Pl|Parkway|Pkwy|Highway|Hwy|Trail|Trl|Circle|Cir|Square|Sq';
+/** A street address as a footer writes one: a house number, one to four words, and a street suffix. */ const ADDRESS = new RegExp(`\\b\\d{1,6}\\s+(?:[A-Z0-9][\\w'.-]*\\s+){1,4}(?:${STREET_SUFFIX})\\b\\.?`, 'g');
+const DAY = '(?:Mon(?:day)?|Tue(?:s|sday)?|Wed(?:nesday)?|Thu(?:r|rs|rsday)?|Fri(?:day)?|Sat(?:urday)?|Sun(?:day)?)';
+/**
+ * Opening hours: a time of day ("9am", "8:30 PM") or a range of days
+ * ("Mon–Fri", "Monday through Saturday"). A bare "9–5" is left alone, since
+ * "2–3 weeks" is written the same way.
+ */ const HOURS = new RegExp([
+    '\\b\\d{1,2}(?::\\d{2})?\\s?(?:[ap]\\.?m\\.?)(?![a-z])',
+    `\\b${DAY}\\s?(?:[–—-]|to|through|thru)\\s?${DAY}\\b`
+].join('|'), 'gi');
+/** SVG path data: a move command, then only commands and numbers. */ const SVG_PATH_DATA = /^\s*[Mm][\s\d.,eE+-]*[\d.][\s\d.,eE+\-MmLlHhVvCcSsQqTtAaZz]*$/;
+/** The words of an address, as a brief and a layout can both spell them. */ const addressKey = (value)=>{
+    var _value_toLowerCase_match;
+    const [number, word] = (_value_toLowerCase_match = value.toLowerCase().match(/[a-z0-9]+/g)) != null ? _value_toLowerCase_match : [];
+    return `${number != null ? number : ''} ${word != null ? word : ''}`;
+};
+/**
+ * The contact details a brief gives: its email addresses, the digits of its
+ * phone numbers, the house number and first word of its street addresses,
+ * and whether it gives opening hours at all.
+ */ function briefFacts(brief) {
+    var _brief_match, _brief_match1;
+    return {
+        emails: new Set(((_brief_match = brief.match(EMAIL)) != null ? _brief_match : []).map((email)=>email.toLowerCase())),
+        digits: digitsOf(brief),
+        addresses: new Set(((_brief_match1 = brief.match(ADDRESS)) != null ? _brief_match1 : []).map(addressKey)),
+        hours: new RegExp(HOURS.source, 'i').test(brief)
+    };
+}
+/**
+ * Rule 14 for a layout: every email address, phone number, street address
+ * and opening time its words carry is one the brief gives. A number is read
+ * by its digits, so a brief's "512.555.0142" admits "(512) 555-0142"; a year
+ * or a price is not a phone number, so only a run of seven digits or more is
+ * read as one. An address is matched by its house number and first street
+ * word; hours are admitted when the brief gives any, since a brief that names
+ * its hours is spelled a dozen ways a footer may fairly reword.
+ */ export function aiLayoutInventedContactViolations(tree, brief) {
+    const given = briefFacts(brief);
+    const invented = [];
+    const nodeIds = [];
+    for (const { id, node } of walkTree(tree)){
+        var _node_props;
+        for (const value of Object.values((_node_props = node.props) != null ? _node_props : {})){
+            // An icon's drawing (`iconPath`) is SVG path data, whose coordinates read as phone numbers.
+            if (typeof value !== 'string' || SVG_PATH_DATA.test(value)) continue;
+            const matches = (pattern)=>{
+                var _value_match;
+                return [
+                    ...(_value_match = value.match(pattern)) != null ? _value_match : []
+                ];
+            };
+            const found = [
+                ...matches(EMAIL).filter((email)=>!given.emails.has(email.toLowerCase())),
+                ...matches(PHONE).filter((phone)=>{
+                    const digits = digitsOf(phone);
+                    return digits.length >= 7 && !given.digits.includes(digits);
+                }),
+                ...matches(ADDRESS).filter((address)=>!given.addresses.has(addressKey(address))),
+                ...given.hours ? [] : matches(HOURS)
+            ];
+            if (!found.length) continue;
+            invented.push(...found.map((fact)=>fact.trim()));
+            if (!nodeIds.includes(id)) nodeIds.push(id);
+        }
+    }
+    if (!invented.length) return [];
+    return [
+        {
+            rule: 14,
+            code: 'contact-not-in-brief',
+            message: `${[
+                ...new Set(invented)
+            ].map((fact)=>`"${fact}"`).join(', ')} is not in the brief. A layout shows only the contact details the brief gives: leave this out, and never invent one.`,
+            nodeIds
+        }
+    ];
+}
+
+//# sourceMappingURL=ai-layout-site-facts.js.map

package/src/lib/jobs/ai-layout-site-facts.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/jobs/ai-layout-site-facts.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 { AiDoctrineNode, AiDoctrineTree, AiDoctrineViolation } from '../runtime/ai-doctrine-validators'\nimport { walkTree } from '../runtime/ai-doctrine-validators'\n\n/**\n * What a layout may say about the business it frames (AGL-3596).\n *\n * A layout's header and footer are on every page, so a fact in them is\n * published everywhere at once. Two went wrong on beta.230: the model coined\n * a name for the business (\"Austin Paws Grooming\" for a site called Hillside\n * Dog Grooming), and a footer is exactly where a model reaches for a phone\n * number, an email or opening hours the brief never gave.\n *\n * - The site's name is the brand, and it is written as the host token that\n *   reads it (`{{host.businessName}}`), so a rename in Setup follows on every\n *   page rather than leaving the name it was built under\n *   (`aiLayoutWithSiteName`).\n * - A contact detail the brief does not give is refused by the layout's own\n *   check (`aiLayoutInventedContactViolations`), so the model is asked again\n *   to leave it out: an email, a phone number, a street address or opening\n *   hours appear in the layout only when the brief has them.\n */\n\n/** The host token that reads a site's own name at render. */\nexport const AI_SITE_NAME_TOKEN = '{{host.businessName}}'\n\nconst isRecord = (value: unknown): value is Record<string, unknown> =>\n  Boolean(value) && typeof value === 'object' && !Array.isArray(value)\n\nconst escapeRegExp = (value: string) => value.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&')\n\n/**\n * The tree with every written occurrence of the site's name — the brand, the\n * copyright line — replaced by the host token that reads it. Matched whole,\n * ignoring case and runs of spaces. Anything that is not a node map, and a\n * name too short to match safely, leaves the tree as it came.\n */\nexport function aiLayoutWithSiteName(tree: unknown, siteName: string | null | undefined): unknown {\n  const name = (siteName ?? '').replace(/\\s+/g, ' ').trim()\n  if (name.length < 3 || !isRecord(tree) || !isRecord(tree['nodes'])) return tree\n  const pattern = new RegExp(`(?<![\\\\p{L}\\\\p{N}])${escapeRegExp(name).replace(/ /g, '\\\\s+')}(?![\\\\p{L}\\\\p{N}])`, 'giu')\n  let changed = false\n  const nodes: Record<string, unknown> = {}\n  for (const [id, node] of Object.entries(tree['nodes'])) {\n    if (!isRecord(node) || !isRecord(node['props'])) {\n      nodes[id] = node\n      continue\n    }\n    const props: Record<string, unknown> = {}\n    let touched = false\n    for (const [key, value] of Object.entries(node['props'])) {\n      const next = typeof value === 'string' ? value.replace(pattern, AI_SITE_NAME_TOKEN) : value\n      if (next !== value) touched = true\n      props[key] = next\n    }\n    nodes[id] = touched ? { ...node, props } : node\n    changed ||= touched\n  }\n  return changed ? { ...tree, nodes } : tree\n}\n\nconst EMAIL = /[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\\.[A-Za-z]{2,}/g\n/** A phone number as people write one: seven or more digits, with the usual separators between them. */\nconst PHONE = /(?:\\+?\\(?\\d[\\d\\s().-]{5,}\\d)/g\n\nconst digitsOf = (value: string) => value.replace(/\\D/g, '')\n\nconst STREET_SUFFIX =\n  'Street|St|Avenue|Ave|Road|Rd|Boulevard|Blvd|Lane|Ln|Drive|Dr|Way|Court|Ct|Place|Pl|Parkway|Pkwy|Highway|Hwy|Trail|Trl|Circle|Cir|Square|Sq'\n/** A street address as a footer writes one: a house number, one to four words, and a street suffix. */\nconst ADDRESS = new RegExp(`\\\\b\\\\d{1,6}\\\\s+(?:[A-Z0-9][\\\\w'.-]*\\\\s+){1,4}(?:${STREET_SUFFIX})\\\\b\\\\.?`, 'g')\nconst DAY = '(?:Mon(?:day)?|Tue(?:s|sday)?|Wed(?:nesday)?|Thu(?:r|rs|rsday)?|Fri(?:day)?|Sat(?:urday)?|Sun(?:day)?)'\n/**\n * Opening hours: a time of day (\"9am\", \"8:30 PM\") or a range of days\n * (\"Mon–Fri\", \"Monday through Saturday\"). A bare \"9–5\" is left alone, since\n * \"2–3 weeks\" is written the same way.\n */\nconst HOURS = new RegExp(\n  [\n    '\\\\b\\\\d{1,2}(?::\\\\d{2})?\\\\s?(?:[ap]\\\\.?m\\\\.?)(?![a-z])',\n    `\\\\b${DAY}\\\\s?(?:[–—-]|to|through|thru)\\\\s?${DAY}\\\\b`,\n  ].join('|'),\n  'gi',\n)\n\n/** SVG path data: a move command, then only commands and numbers. */\nconst SVG_PATH_DATA = /^\\s*[Mm][\\s\\d.,eE+-]*[\\d.][\\s\\d.,eE+\\-MmLlHhVvCcSsQqTtAaZz]*$/\n\n/** The words of an address, as a brief and a layout can both spell them. */\nconst addressKey = (value: string) => {\n  const [number, word] = value.toLowerCase().match(/[a-z0-9]+/g) ?? []\n  return `${number ?? ''} ${word ?? ''}`\n}\n\n/**\n * The contact details a brief gives: its email addresses, the digits of its\n * phone numbers, the house number and first word of its street addresses,\n * and whether it gives opening hours at all.\n */\nfunction briefFacts(brief: string): { emails: Set<string>; digits: string; addresses: Set<string>; hours: boolean } {\n  return {\n    emails: new Set((brief.match(EMAIL) ?? []).map((email) => email.toLowerCase())),\n    digits: digitsOf(brief),\n    addresses: new Set((brief.match(ADDRESS) ?? []).map(addressKey)),\n    hours: new RegExp(HOURS.source, 'i').test(brief),\n  }\n}\n\n/**\n * Rule 14 for a layout: every email address, phone number, street address\n * and opening time its words carry is one the brief gives. A number is read\n * by its digits, so a brief's \"512.555.0142\" admits \"(512) 555-0142\"; a year\n * or a price is not a phone number, so only a run of seven digits or more is\n * read as one. An address is matched by its house number and first street\n * word; hours are admitted when the brief gives any, since a brief that names\n * its hours is spelled a dozen ways a footer may fairly reword.\n */\nexport function aiLayoutInventedContactViolations(tree: AiDoctrineTree, brief: string): AiDoctrineViolation[] {\n  const given = briefFacts(brief)\n  const invented: string[] = []\n  const nodeIds: string[] = []\n  for (const { id, node } of walkTree(tree)) {\n    for (const value of Object.values((node as AiDoctrineNode).props ?? {})) {\n      // An icon's drawing (`iconPath`) is SVG path data, whose coordinates read as phone numbers.\n      if (typeof value !== 'string' || SVG_PATH_DATA.test(value)) continue\n      const matches = (pattern: RegExp): string[] => [...(value.match(pattern) ?? [])]\n      const found: string[] = [\n        ...matches(EMAIL).filter((email) => !given.emails.has(email.toLowerCase())),\n        ...matches(PHONE).filter((phone) => {\n          const digits = digitsOf(phone)\n          return digits.length >= 7 && !given.digits.includes(digits)\n        }),\n        ...matches(ADDRESS).filter((address) => !given.addresses.has(addressKey(address))),\n        ...(given.hours ? [] : matches(HOURS)),\n      ]\n      if (!found.length) continue\n      invented.push(...found.map((fact) => fact.trim()))\n      if (!nodeIds.includes(id)) nodeIds.push(id)\n    }\n  }\n  if (!invented.length) return []\n  return [\n    {\n      rule: 14,\n      code: 'contact-not-in-brief',\n      message: `${[...new Set(invented)].map((fact) => `\"${fact}\"`).join(', ')} is not in the brief. A layout shows only the contact details the brief gives: leave this out, and never invent one.`,\n      nodeIds,\n    },\n  ]\n}\n"],"names":["walkTree","AI_SITE_NAME_TOKEN","isRecord","value","Boolean","Array","isArray","escapeRegExp","replace","aiLayoutWithSiteName","tree","siteName","name","trim","length","pattern","RegExp","changed","nodes","id","node","Object","entries","props","touched","key","next","EMAIL","PHONE","digitsOf","STREET_SUFFIX","ADDRESS","DAY","HOURS","join","SVG_PATH_DATA","addressKey","number","word","toLowerCase","match","briefFacts","brief","emails","Set","map","email","digits","addresses","hours","source","test","aiLayoutInventedContactViolations","given","invented","nodeIds","values","matches","found","filter","has","phone","includes","address","push","fact","rule","code","message"],"mappings":"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"}

package/src/lib/jobs/ai-logic-records.d.ts

@@ -0,0 +1,40 @@
+/**
+ * @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 { HostFunction } from '@aglyn/aglyn/app-utils/functions';
+import type { AiLogicSiteVariable } from '../model/ai-logic-job';
+/**
+ * What a `logic` job reads (AGL-3603): the site's variables and function
+ * names, in the window the Functions & Variables page itself reads, and one
+ * saved function by id. Functions and variables are core documents
+ * (`hosts/{hostId}/functions`, `hosts/{hostId}/variables`), read through the
+ * Admin SDK as projections of the fields named here.
+ */
+type Firestore = FirebaseFirestore.Firestore;
+/** Records of one kind a job reads: the logic page's own ceiling. */
+export declare const AI_LOGIC_RECORDS_WINDOW = 100;
+export interface AiLogicRecords {
+    variables: AiLogicSiteVariable[];
+    functions: string[];
+}
+/** The site's live variables (name, type, value) and function names. */
+export declare function readAiLogicRecords(firestore: Firestore, hostId: string): Promise<AiLogicRecords>;
+/** One saved function of the site, or `null` for one that does not exist or was deleted. */
+export declare function readAiLogicFunction(firestore: Firestore, input: {
+    hostId: string;
+    id: string;
+}): Promise<HostFunction | null>;
+export {};

package/src/lib/jobs/ai-logic-records.js

@@ -0,0 +1,55 @@
+/**
+ * @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";
+/** Records of one kind a job reads: the logic page's own ceiling. */ export const AI_LOGIC_RECORDS_WINDOW = 100;
+const live = (data)=>data['deletedAt'] == null;
+/** The site's live variables (name, type, value) and function names. */ export async function readAiLogicRecords(firestore, hostId) {
+    const host = firestore.collection('hosts').doc(hostId);
+    const [variables, functions] = await Promise.all([
+        host.collection('variables').select('name', 'type', 'value', 'deletedAt').limit(AI_LOGIC_RECORDS_WINDOW).get(),
+        host.collection('functions').select('name', 'deletedAt').limit(AI_LOGIC_RECORDS_WINDOW).get()
+    ]);
+    return {
+        variables: variables.docs.map((doc)=>{
+            var _doc_data;
+            return (_doc_data = doc.data()) != null ? _doc_data : {};
+        }).filter(live).filter((data)=>typeof data['name'] === 'string' && data['name']).map((data)=>({
+                name: String(data['name']),
+                type: typeof data['type'] === 'string' ? data['type'] : 'text',
+                value: typeof data['value'] === 'string' ? data['value'] : ''
+            })),
+        functions: functions.docs.map((doc)=>{
+            var _doc_data;
+            return (_doc_data = doc.data()) != null ? _doc_data : {};
+        }).filter(live).map((data)=>typeof data['name'] === 'string' ? data['name'].trim() : '').filter(Boolean)
+    };
+}
+/** One saved function of the site, or `null` for one that does not exist or was deleted. */ export async function readAiLogicFunction(firestore, input) {
+    var _snapshot_data;
+    const snapshot = await firestore.collection('hosts').doc(input.hostId).collection('functions').doc(input.id).get();
+    const data = snapshot.exists ? (_snapshot_data = snapshot.data()) != null ? _snapshot_data : {} : null;
+    if (!data || !live(data) || typeof data['name'] !== 'string') return null;
+    return _extends({
+        name: data['name'],
+        parameters: Array.isArray(data['parameters']) ? data['parameters'] : [],
+        variables: Array.isArray(data['variables']) ? data['variables'] : [],
+        operations: Array.isArray(data['operations']) ? data['operations'] : []
+    }, typeof data['returnValue'] === 'string' ? {
+        returnValue: data['returnValue']
+    } : {});
+}
+
+//# sourceMappingURL=ai-logic-records.js.map

package/src/lib/jobs/ai-logic-records.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/jobs/ai-logic-records.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 { HostFunction } from '@aglyn/aglyn/app-utils/functions'\nimport type { AiLogicSiteVariable } from '../model/ai-logic-job'\n\n/**\n * What a `logic` job reads (AGL-3603): the site's variables and function\n * names, in the window the Functions & Variables page itself reads, and one\n * saved function by id. Functions and variables are core documents\n * (`hosts/{hostId}/functions`, `hosts/{hostId}/variables`), read through the\n * Admin SDK as projections of the fields named here.\n */\n\ntype Firestore = FirebaseFirestore.Firestore\ntype Data = Record<string, unknown>\n\n/** Records of one kind a job reads: the logic page's own ceiling. */\nexport const AI_LOGIC_RECORDS_WINDOW = 100\n\nconst live = (data: Data) => data['deletedAt'] == null\n\nexport interface AiLogicRecords {\n  variables: AiLogicSiteVariable[]\n  functions: string[]\n}\n\n/** The site's live variables (name, type, value) and function names. */\nexport async function readAiLogicRecords(firestore: Firestore, hostId: string): Promise<AiLogicRecords> {\n  const host = firestore.collection('hosts').doc(hostId)\n  const [variables, functions] = await Promise.all([\n    host.collection('variables').select('name', 'type', 'value', 'deletedAt').limit(AI_LOGIC_RECORDS_WINDOW).get(),\n    host.collection('functions').select('name', 'deletedAt').limit(AI_LOGIC_RECORDS_WINDOW).get(),\n  ])\n  return {\n    variables: variables.docs\n      .map((doc) => (doc.data() ?? {}) as Data)\n      .filter(live)\n      .filter((data) => typeof data['name'] === 'string' && data['name'])\n      .map((data) => ({\n        name: String(data['name']),\n        type: (typeof data['type'] === 'string' ? data['type'] : 'text') as AiLogicSiteVariable['type'],\n        value: typeof data['value'] === 'string' ? data['value'] : '',\n      })),\n    functions: functions.docs\n      .map((doc) => (doc.data() ?? {}) as Data)\n      .filter(live)\n      .map((data) => (typeof data['name'] === 'string' ? data['name'].trim() : ''))\n      .filter(Boolean),\n  }\n}\n\n/** One saved function of the site, or `null` for one that does not exist or was deleted. */\nexport async function readAiLogicFunction(\n  firestore: Firestore,\n  input: { hostId: string; id: string },\n): Promise<HostFunction | null> {\n  const snapshot = await firestore.collection('hosts').doc(input.hostId).collection('functions').doc(input.id).get()\n  const data = snapshot.exists ? ((snapshot.data() ?? {}) as Data) : null\n  if (!data || !live(data) || typeof data['name'] !== 'string') return null\n  return {\n    name: data['name'],\n    parameters: Array.isArray(data['parameters']) ? (data['parameters'] as HostFunction['parameters']) : [],\n    variables: Array.isArray(data['variables']) ? (data['variables'] as HostFunction['variables']) : [],\n    operations: Array.isArray(data['operations']) ? (data['operations'] as HostFunction['operations']) : [],\n    ...(typeof data['returnValue'] === 'string' ? { returnValue: data['returnValue'] } : {}),\n  }\n}\n"],"names":["AI_LOGIC_RECORDS_WINDOW","live","data","readAiLogicRecords","firestore","hostId","host","collection","doc","variables","functions","Promise","all","select","limit","get","docs","map","filter","name","String","type","value","trim","Boolean","readAiLogicFunction","input","snapshot","id","exists","parameters","Array","isArray","operations","returnValue"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC;AAgBD,mEAAmE,GACnE,OAAO,MAAMA,0BAA0B,IAAG;AAE1C,MAAMC,OAAO,CAACC,OAAeA,IAAI,CAAC,YAAY,IAAI;AAOlD,sEAAsE,GACtE,OAAO,eAAeC,mBAAmBC,SAAoB,EAAEC,MAAc;IAC3E,MAAMC,OAAOF,UAAUG,UAAU,CAAC,SAASC,GAAG,CAACH;IAC/C,MAAM,CAACI,WAAWC,UAAU,GAAG,MAAMC,QAAQC,GAAG,CAAC;QAC/CN,KAAKC,UAAU,CAAC,aAAaM,MAAM,CAAC,QAAQ,QAAQ,SAAS,aAAaC,KAAK,CAACd,yBAAyBe,GAAG;QAC5GT,KAAKC,UAAU,CAAC,aAAaM,MAAM,CAAC,QAAQ,aAAaC,KAAK,CAACd,yBAAyBe,GAAG;KAC5F;IACD,OAAO;QACLN,WAAWA,UAAUO,IAAI,CACtBC,GAAG,CAAC,CAACT;gBAASA;oBAAAA,YAAAA,IAAIN,IAAI,cAARM,YAAc,CAAC;WAC7BU,MAAM,CAACjB,MACPiB,MAAM,CAAC,CAAChB,OAAS,OAAOA,IAAI,CAAC,OAAO,KAAK,YAAYA,IAAI,CAAC,OAAO,EACjEe,GAAG,CAAC,CAACf,OAAU,CAAA;gBACdiB,MAAMC,OAAOlB,IAAI,CAAC,OAAO;gBACzBmB,MAAO,OAAOnB,IAAI,CAAC,OAAO,KAAK,WAAWA,IAAI,CAAC,OAAO,GAAG;gBACzDoB,OAAO,OAAOpB,IAAI,CAAC,QAAQ,KAAK,WAAWA,IAAI,CAAC,QAAQ,GAAG;YAC7D,CAAA;QACFQ,WAAWA,UAAUM,IAAI,CACtBC,GAAG,CAAC,CAACT;gBAASA;oBAAAA,YAAAA,IAAIN,IAAI,cAARM,YAAc,CAAC;WAC7BU,MAAM,CAACjB,MACPgB,GAAG,CAAC,CAACf,OAAU,OAAOA,IAAI,CAAC,OAAO,KAAK,WAAWA,IAAI,CAAC,OAAO,CAACqB,IAAI,KAAK,IACxEL,MAAM,CAACM;IACZ;AACF;AAEA,0FAA0F,GAC1F,OAAO,eAAeC,oBACpBrB,SAAoB,EACpBsB,KAAqC;QAGJC;IADjC,MAAMA,WAAW,MAAMvB,UAAUG,UAAU,CAAC,SAASC,GAAG,CAACkB,MAAMrB,MAAM,EAAEE,UAAU,CAAC,aAAaC,GAAG,CAACkB,MAAME,EAAE,EAAEb,GAAG;IAChH,MAAMb,OAAOyB,SAASE,MAAM,IAAKF,iBAAAA,SAASzB,IAAI,cAAbyB,iBAAmB,CAAC,IAAc;IACnE,IAAI,CAACzB,QAAQ,CAACD,KAAKC,SAAS,OAAOA,IAAI,CAAC,OAAO,KAAK,UAAU,OAAO;IACrE,OAAO;QACLiB,MAAMjB,IAAI,CAAC,OAAO;QAClB4B,YAAYC,MAAMC,OAAO,CAAC9B,IAAI,CAAC,aAAa,IAAKA,IAAI,CAAC,aAAa,GAAkC,EAAE;QACvGO,WAAWsB,MAAMC,OAAO,CAAC9B,IAAI,CAAC,YAAY,IAAKA,IAAI,CAAC,YAAY,GAAiC,EAAE;QACnG+B,YAAYF,MAAMC,OAAO,CAAC9B,IAAI,CAAC,aAAa,IAAKA,IAAI,CAAC,aAAa,GAAkC,EAAE;OACnG,OAAOA,IAAI,CAAC,cAAc,KAAK,WAAW;QAAEgC,aAAahC,IAAI,CAAC,cAAc;IAAC,IAAI,CAAC;AAE1F"}

package/src/lib/jobs/ai-site-publish.d.ts

@@ -52,6 +52,13 @@ export interface AiSitePublishDeps {
     sendSitePublished?: typeof sendGa4SitePublished;
     dropCache?: typeof dropPluginSiteCache;
 }
+/**
+ * Whether a build puts its pages live (AGL-3616): only where its request
+ * asked to (`publish`, set by Assist's proposal) AND the member ticked the
+ * plan card's box when confirming (`publishConfirmed`, set by the resume
+ * door). Every other build leaves drafts.
+ */
+export declare function aiJobPublishesBuild(job: Pick<AiJob, 'kind' | 'inputs'>): boolean;
 /** Whether a finished job of this shape publishes what it built. */
 export declare function aiJobPublishesSite(job: Pick<AiJob, 'kind' | 'inputs'>): boolean;
 /**

package/src/lib/jobs/ai-site-publish.js

@@ -22,6 +22,15 @@ import { decodeStoredNodes, encodeStoredNodes } from "@aglyn/aglyn/app-utils/sto
 import { dropPluginSiteCache } from "@aglyn/aglyn/plugin-manager/plugin-site-cache";
 import { sendGa4SitePublished } from "@aglyn/tenant-data-admin/server/ga4-measurement-protocol";
 import { FieldValue } from "firebase-admin/firestore";
+/**
+ * Whether a build puts its pages live (AGL-3616): only where its request
+ * asked to (`publish`, set by Assist's proposal) AND the member ticked the
+ * plan card's box when confirming (`publishConfirmed`, set by the resume
+ * door). Every other build leaves drafts.
+ */ export function aiJobPublishesBuild(job) {
+    var _job_inputs, _job_inputs1;
+    return job.kind === 'build' && ((_job_inputs = job.inputs) == null ? void 0 : _job_inputs['publish']) === true && ((_job_inputs1 = job.inputs) == null ? void 0 : _job_inputs1['publishConfirmed']) === true;
+}
 /** Whether a finished job of this shape publishes what it built. */ export function aiJobPublishesSite(job) {
     var _job_inputs;
     return job.kind === 'site' && ((_job_inputs = job.inputs) == null ? void 0 : _job_inputs['autoConfirm']) === true;