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

package/src/lib/jobs/ai-job-layout-language.js

@@ -0,0 +1,194 @@
+/**
+ * @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 { aiCompileLayoutFrame } from "../layout-language/ai-layout-frame.js";
+import { AI_LAYOUT_LANGUAGE_TEXT, aiReadLayoutFrame } from "../layout-language/ai-layout-language.js";
+import { aiLayoutCopyCheck } from "../layout-language/ai-layout-gaps.js";
+import { aiLayoutStoredTree } from "../layout-language/ai-layout-store.js";
+import { AI_GENERATION_MAX_ATTEMPTS } from "../runtime/ai-generation-bounds.js";
+import { aiHomeScreenIds } from "../model/ai-site-inventory.js";
+import { AI_STEP_TIERS } from "../providers/catalog.js";
+import { validateAiDoctrineTree } from "../runtime/ai-doctrine-validators.js";
+import { aiJobStepBudget } from "./ai-job-budget.js";
+import { aiJobBriefLine } from "./ai-job-generation.js";
+import { AI_LAYOUT_SITE_PAGES_MAX, aiLayoutIsHomeSlug, aiLayoutSitePages } from "./ai-job-layout-site-pages.js";
+import { aiLayoutPageTargets } from "./ai-job-page-language.js";
+import { AI_SITE_NAME_TOKEN } from "./ai-layout-site-facts.js";
+/**
+ * A site's layout built in the compact layout language (AGL-3660): the layout
+ * step's pass for a guided start's and a build's layout unit. The model
+ * designs the header and the footer — their bands, the call to action, the
+ * footer's columns and every word — in one short answer through
+ * `submit_frame`, and the compiler writes the layout around what the site
+ * owes it: its name as the brand, its pages as the navigation and the phone
+ * menu, the Layout Slot, and the footer at the bottom of a short page
+ * (`ai-layout-frame.ts`).
+ */ /** The most a frame's answer asks for: two sections of a few blocks each. */ export const AI_JOB_LAYOUT_LANGUAGE_TOKENS = 1200;
+/** A language layout pass's time, on the tier the layout step is served from. */ export const AI_JOB_LAYOUT_LANGUAGE_BUDGET = aiJobStepBudget({
+    tier: AI_STEP_TIERS['job.layout'],
+    maxTokens: AI_JOB_LAYOUT_LANGUAGE_TOKENS
+});
+/** The generation kind a frame is asked under, which the doctrine scopes. */ export const AI_LAYOUT_FRAME_KIND = 'layout-frame';
+/** The language, as the frame door's cached instructions. */ export const AI_JOB_LAYOUT_LANGUAGE_INSTRUCTIONS = [
+    {
+        text: [
+            AI_LAYOUT_LANGUAGE_TEXT,
+            '',
+            "Now you design a site's header and footer, each one section of the language, answered with submit_frame.",
+            "- header: the platform writes the site's name and its navigation itself. Choose its band and align (start, or center for a centered navigation), and give it at most one button: the call to action every page shows.",
+            '- footer: a section like any other, usually a row of two or three columns: a few words about the business, the details the brief gives, and a list of links (items with to). Put no contact detail, opening hours or address in it that the brief does not give, and no gap in square brackets for one.'
+        ].join('\n'),
+        cacheBreakpoint: true
+    }
+];
+/** The site's name as the brand: the name the job was given, else the token the site's own name fills. */ export function aiLayoutSiteName(job) {
+    var _job_inputs;
+    const given = (_job_inputs = job.inputs) == null ? void 0 : _job_inputs['businessName'];
+    return typeof given === 'string' && given.trim() ? given.trim() : AI_SITE_NAME_TOKEN;
+}
+/** The pages a frame's navigation links: the planned pages, else the site's own, in order. */ export function aiLayoutNavPages(job, inventory) {
+    var _ref;
+    // The header and the footer link the pages the job was told (AGL-3660),
+    // else the site's own, the home page always and first, labelled Home. The
+    // model draws neither list, so it cannot drop a page.
+    const planned = aiLayoutSitePages(job.inputs);
+    const own = ((_ref = inventory == null ? void 0 : inventory.screens) != null ? _ref : []).filter((row)=>!row.template).map((row)=>({
+            id: row.id,
+            label: row.name,
+            slug: row.slug
+        }));
+    const siteHome = planned.some((page)=>aiLayoutIsHomeSlug(page.slug)) ? [] : own.filter((page)=>aiLayoutIsHomeSlug(page.slug)).slice(0, 1);
+    const pages = [
+        ...siteHome,
+        ...planned.length ? planned : own
+    ].filter((page)=>page.label.trim());
+    const home = pages.find((page)=>aiLayoutIsHomeSlug(page.slug));
+    return [
+        ...home ? [
+            _extends({}, home, {
+                label: 'Home'
+            })
+        ] : [],
+        ...pages.filter((page)=>page !== home && !aiLayoutIsHomeSlug(page.slug))
+    ].slice(0, AI_LAYOUT_SITE_PAGES_MAX);
+}
+/** The home page the brand links: the planned home, else the site's. */ export function aiLayoutHomeId(pages, inventory) {
+    var _ref, _ref1;
+    const planned = pages.find((page)=>aiLayoutIsHomeSlug(page.slug));
+    return (_ref = (_ref1 = planned == null ? void 0 : planned.id) != null ? _ref1 : aiHomeScreenIds(inventory)[0]) != null ? _ref : null;
+}
+/** The frame's user turn: the site, its brief, its pages and its form. */ export function aiLayoutFramePrompt(input) {
+    const { job, pages, targets } = input;
+    return [
+        `Site: ${input.siteName === AI_SITE_NAME_TOKEN ? 'the business the brief describes' : `"${input.siteName}"`}`,
+        aiJobBriefLine(job),
+        pages.length ? `Its pages, which the navigation links: ${pages.map((page)=>`${page.label} (page:${page.id})`).join(', ')}.` : 'It has no pages yet.',
+        targets.forms.length || targets.formPageId ? 'A call to action that asks a visitor to get in touch goes to form.' : 'The site has no form yet.',
+        `Design seed: ${job.$id.slice(-6)}.`
+    ].join('\n');
+}
+/** The check a frame answer is held to: read, compiled, stored and checked as a layout, with the layout door's own checks. */ export function aiLayoutFrameCheck(input) {
+    let answers = 0;
+    return (answer)=>{
+        // The last answer a generation takes has its gaps taken out rather than asked about again.
+        answers += 1;
+        const last = answers >= AI_GENERATION_MAX_ATTEMPTS;
+        const frame = aiReadLayoutFrame(answer);
+        const compiled = aiCompileLayoutFrame(frame, {
+            siteName: input.siteName,
+            homeId: input.homeId,
+            navPages: input.pages
+        }, input.targets);
+        const context = {
+            screenIds: [
+                ...new Set([
+                    ...input.targets.pages.map((page)=>page.id),
+                    ...input.pages.map((page)=>page.id),
+                    ...input.homeId ? [
+                        input.homeId
+                    ] : []
+                ])
+            ],
+            formIds: input.targets.forms.map((form)=>form.id),
+            homeScreenIds: input.targets.homeIds,
+            codeBuilt: true
+        };
+        const stored = aiLayoutStoredTree(compiled.tree, 'layout', context);
+        if (stored.ok === false) {
+            console.error('ai layout frame: a compiled layout did not store', {
+                error: stored.error
+            });
+            return {
+                value: null,
+                violations: [
+                    {
+                        rule: null,
+                        code: 'layout-compile',
+                        message: 'This layout could not be built. Try again.',
+                        detail: stored.error
+                    }
+                ]
+            };
+        }
+        // No gap and no internal reference in the words of a frame every published page shows.
+        const navPages = [
+            ...input.targets.pages,
+            ...input.pages
+        ];
+        const copy = aiLayoutCopyCheck(stored.nodes, stored.rootId, {
+            pages: navPages,
+            ids: [
+                ...navPages.map((page)=>page.id),
+                ...input.targets.forms.map((form)=>form.id)
+            ]
+        }, last);
+        const { nodes, dropped } = copy;
+        const report = validateAiDoctrineTree({
+            rootId: stored.rootId,
+            nodes
+        }, 'layout', context);
+        const violations = [
+            ...report.violations,
+            ...copy.violations,
+            ...input.extend({
+                rootId: stored.rootId,
+                nodes,
+                repairs: [],
+                sourceIds: {},
+                score: report.score,
+                load: report.load
+            })
+        ];
+        return {
+            value: violations.length ? null : {
+                rootId: stored.rootId,
+                nodes,
+                load: report.load,
+                dropped
+            },
+            violations
+        };
+    };
+}
+/** What a frame's links resolve against: the site's pages and its form, as a page's do. */ export function aiLayoutFrameTargets(job, inventory) {
+    return aiLayoutPageTargets({
+        job,
+        inventory,
+        own: []
+    });
+}
+
+//# sourceMappingURL=ai-job-layout-language.js.map

package/src/lib/jobs/ai-job-layout-language.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/jobs/ai-job-layout-language.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 { NodesMap } from '@aglyn/aglyn/types/nodes'\nimport { aiCompileLayoutFrame } from '../layout-language/ai-layout-frame'\nimport {\n  AI_LAYOUT_FRAME_TOOL,\n  AI_LAYOUT_LANGUAGE_TEXT,\n  aiReadLayoutFrame,\n} from '../layout-language/ai-layout-language'\nimport type {\n  AiLayoutPage,\n  AiLayoutTargets,\n} from '../layout-language/ai-layout-links'\nimport { aiLayoutCopyCheck } from '../layout-language/ai-layout-gaps'\nimport { aiLayoutStoredTree } from '../layout-language/ai-layout-store'\nimport { AI_GENERATION_MAX_ATTEMPTS } from '../runtime/ai-generation-bounds'\nimport type { AiJob } from '../model/ai-jobs.types'\nimport {\n  aiHomeScreenIds,\n  type AiSiteInventory,\n} from '../model/ai-site-inventory'\nimport { AI_STEP_TIERS } from '../providers/catalog'\nimport type { AiGenerationCheck, AiValidatedTree } from '../runtime/ai-doctrine'\nimport {\n  validateAiDoctrineTree,\n  type AiDoctrineViolation,\n} from '../runtime/ai-doctrine-validators'\nimport type { AiLoadEstimate } from '../runtime/ai-palette'\nimport type { AiSystemBlock } from '../runtime/ai-runtime'\nimport { aiJobStepBudget } from './ai-job-budget'\nimport { aiJobBriefLine } from './ai-job-generation'\nimport {\n  AI_LAYOUT_SITE_PAGES_MAX,\n  aiLayoutIsHomeSlug,\n  aiLayoutSitePages,\n} from './ai-job-layout-site-pages'\nimport { aiLayoutPageTargets } from './ai-job-page-language'\nimport { AI_SITE_NAME_TOKEN } from './ai-layout-site-facts'\n\n/**\n * A site's layout built in the compact layout language (AGL-3660): the layout\n * step's pass for a guided start's and a build's layout unit. The model\n * designs the header and the footer — their bands, the call to action, the\n * footer's columns and every word — in one short answer through\n * `submit_frame`, and the compiler writes the layout around what the site\n * owes it: its name as the brand, its pages as the navigation and the phone\n * menu, the Layout Slot, and the footer at the bottom of a short page\n * (`ai-layout-frame.ts`).\n */\n\n/** The most a frame's answer asks for: two sections of a few blocks each. */\nexport const AI_JOB_LAYOUT_LANGUAGE_TOKENS = 1_200\n\n/** A language layout pass's time, on the tier the layout step is served from. */\nexport const AI_JOB_LAYOUT_LANGUAGE_BUDGET = aiJobStepBudget({\n  tier: AI_STEP_TIERS['job.layout'],\n  maxTokens: AI_JOB_LAYOUT_LANGUAGE_TOKENS,\n})\n\n/** The generation kind a frame is asked under, which the doctrine scopes. */\nexport const AI_LAYOUT_FRAME_KIND = 'layout-frame'\n\n/** The language, as the frame door's cached instructions. */\nexport const AI_JOB_LAYOUT_LANGUAGE_INSTRUCTIONS: readonly AiSystemBlock[] = [\n  {\n    text: [\n      AI_LAYOUT_LANGUAGE_TEXT,\n      '',\n      \"Now you design a site's header and footer, each one section of the language, answered with submit_frame.\",\n      \"- header: the platform writes the site's name and its navigation itself. Choose its band and align (start, or center for a centered navigation), and give it at most one button: the call to action every page shows.\",\n      '- footer: a section like any other, usually a row of two or three columns: a few words about the business, the details the brief gives, and a list of links (items with to). Put no contact detail, opening hours or address in it that the brief does not give, and no gap in square brackets for one.',\n    ].join('\\n'),\n    cacheBreakpoint: true,\n  },\n]\n\n/** The site's name as the brand: the name the job was given, else the token the site's own name fills. */\nexport function aiLayoutSiteName(job: Pick<AiJob, 'inputs'>): string {\n  const given = job.inputs?.['businessName']\n  return typeof given === 'string' && given.trim()\n    ? given.trim()\n    : AI_SITE_NAME_TOKEN\n}\n\n/** The pages a frame's navigation links: the planned pages, else the site's own, in order. */\nexport function aiLayoutNavPages(\n  job: Pick<AiJob, 'inputs'>,\n  inventory: AiSiteInventory | null,\n): AiLayoutPage[] {\n  // The header and the footer link the pages the job was told (AGL-3660),\n  // else the site's own, the home page always and first, labelled Home. The\n  // model draws neither list, so it cannot drop a page.\n  const planned = aiLayoutSitePages(job.inputs)\n  const own = (inventory?.screens ?? [])\n    .filter((row) => !row.template)\n    .map((row) => ({ id: row.id, label: row.name, slug: row.slug }))\n  const siteHome = planned.some((page) => aiLayoutIsHomeSlug(page.slug))\n    ? []\n    : own.filter((page) => aiLayoutIsHomeSlug(page.slug)).slice(0, 1)\n  const pages = [...siteHome, ...(planned.length ? planned : own)].filter((page) => page.label.trim())\n  const home = pages.find((page) => aiLayoutIsHomeSlug(page.slug))\n  return [\n    ...(home ? [{ ...home, label: 'Home' }] : []),\n    ...pages.filter((page) => page !== home && !aiLayoutIsHomeSlug(page.slug)),\n  ].slice(0, AI_LAYOUT_SITE_PAGES_MAX)\n}\n\n/** The home page the brand links: the planned home, else the site's. */\nexport function aiLayoutHomeId(\n  pages: readonly AiLayoutPage[],\n  inventory: AiSiteInventory | null,\n): string | null {\n  const planned = pages.find((page) => aiLayoutIsHomeSlug(page.slug))\n  return planned?.id ?? aiHomeScreenIds(inventory)[0] ?? null\n}\n\n/** The frame's user turn: the site, its brief, its pages and its form. */\nexport function aiLayoutFramePrompt(input: {\n  job: Pick<AiJob, 'brief' | '$id'>\n  siteName: string\n  pages: readonly AiLayoutPage[]\n  targets: AiLayoutTargets\n}): string {\n  const { job, pages, targets } = input\n  return [\n    `Site: ${input.siteName === AI_SITE_NAME_TOKEN ? 'the business the brief describes' : `\"${input.siteName}\"`}`,\n    aiJobBriefLine(job),\n    pages.length\n      ? `Its pages, which the navigation links: ${pages.map((page) => `${page.label} (page:${page.id})`).join(', ')}.`\n      : 'It has no pages yet.',\n    targets.forms.length || targets.formPageId\n      ? 'A call to action that asks a visitor to get in touch goes to form.'\n      : 'The site has no form yet.',\n    `Design seed: ${job.$id.slice(-6)}.`,\n  ].join('\\n')\n}\n\n/** A validated language layout. */\nexport interface AiLayoutFrameBuilt {\n  rootId: string\n  nodes: NodesMap\n  load: AiLoadEstimate | null\n  /** What the last answer's gaps took out of the frame (`ai-layout-gaps.ts`). */\n  dropped: string[]\n}\n\n/** The check a frame answer is held to: read, compiled, stored and checked as a layout, with the layout door's own checks. */\nexport function aiLayoutFrameCheck(input: {\n  siteName: string\n  homeId: string | null\n  pages: readonly AiLayoutPage[]\n  targets: AiLayoutTargets\n  extend: (tree: AiValidatedTree) => AiDoctrineViolation[]\n}): AiGenerationCheck<AiLayoutFrameBuilt> {\n  let answers = 0\n  return (answer) => {\n    // The last answer a generation takes has its gaps taken out rather than asked about again.\n    answers += 1\n    const last = answers >= AI_GENERATION_MAX_ATTEMPTS\n    const frame = aiReadLayoutFrame(answer)\n    const compiled = aiCompileLayoutFrame(\n      frame,\n      { siteName: input.siteName, homeId: input.homeId, navPages: input.pages },\n      input.targets,\n    )\n    const context = {\n      screenIds: [\n        ...new Set([\n          ...input.targets.pages.map((page) => page.id),\n          ...input.pages.map((page) => page.id),\n          ...(input.homeId ? [input.homeId] : []),\n        ]),\n      ],\n      formIds: input.targets.forms.map((form) => form.id),\n      homeScreenIds: input.targets.homeIds,\n      codeBuilt: true,\n    }\n    const stored = aiLayoutStoredTree(compiled.tree, 'layout', context)\n    if (stored.ok === false) {\n      console.error('ai layout frame: a compiled layout did not store', {\n        error: stored.error,\n      })\n      return {\n        value: null,\n        violations: [\n          {\n            rule: null,\n            code: 'layout-compile',\n            message: 'This layout could not be built. Try again.',\n            detail: stored.error,\n          },\n        ],\n      }\n    }\n    // No gap and no internal reference in the words of a frame every published page shows.\n    const navPages = [...input.targets.pages, ...input.pages]\n    const copy = aiLayoutCopyCheck(\n      stored.nodes,\n      stored.rootId,\n      {\n        pages: navPages,\n        ids: [...navPages.map((page) => page.id), ...input.targets.forms.map((form) => form.id)],\n      },\n      last,\n    )\n    const { nodes, dropped } = copy\n    const report = validateAiDoctrineTree(\n      { rootId: stored.rootId, nodes },\n      'layout',\n      context,\n    )\n    const violations = [\n      ...report.violations,\n      ...copy.violations,\n      ...input.extend({\n        rootId: stored.rootId,\n        nodes,\n        repairs: [],\n        sourceIds: {},\n        score: report.score as AiValidatedTree['score'],\n        load: report.load,\n      }),\n    ]\n    return {\n      value: violations.length\n        ? null\n        : { rootId: stored.rootId, nodes, load: report.load, dropped },\n      violations,\n    }\n  }\n}\n\n/** What a frame's links resolve against: the site's pages and its form, as a page's do. */\nexport function aiLayoutFrameTargets(\n  job: Pick<AiJob, 'brief' | 'inputs'>,\n  inventory: AiSiteInventory | null,\n): AiLayoutTargets {\n  return aiLayoutPageTargets({ job, inventory, own: [] })\n}\n"],"names":["aiCompileLayoutFrame","AI_LAYOUT_LANGUAGE_TEXT","aiReadLayoutFrame","aiLayoutCopyCheck","aiLayoutStoredTree","AI_GENERATION_MAX_ATTEMPTS","aiHomeScreenIds","AI_STEP_TIERS","validateAiDoctrineTree","aiJobStepBudget","aiJobBriefLine","AI_LAYOUT_SITE_PAGES_MAX","aiLayoutIsHomeSlug","aiLayoutSitePages","aiLayoutPageTargets","AI_SITE_NAME_TOKEN","AI_JOB_LAYOUT_LANGUAGE_TOKENS","AI_JOB_LAYOUT_LANGUAGE_BUDGET","tier","maxTokens","AI_LAYOUT_FRAME_KIND","AI_JOB_LAYOUT_LANGUAGE_INSTRUCTIONS","text","join","cacheBreakpoint","aiLayoutSiteName","job","given","inputs","trim","aiLayoutNavPages","inventory","planned","own","screens","filter","row","template","map","id","label","name","slug","siteHome","some","page","slice","pages","length","home","find","aiLayoutHomeId","aiLayoutFramePrompt","input","targets","siteName","forms","formPageId","$id","aiLayoutFrameCheck","answers","answer","last","frame","compiled","homeId","navPages","context","screenIds","Set","formIds","form","homeScreenIds","homeIds","codeBuilt","stored","tree","ok","console","error","value","violations","rule","code","message","detail","copy","nodes","rootId","ids","dropped","report","extend","repairs","sourceIds","score","load","aiLayoutFrameTargets"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC;AAGD,SAASA,oBAAoB,QAAQ,wCAAoC;AACzE,SAEEC,uBAAuB,EACvBC,iBAAiB,QACZ,2CAAuC;AAK9C,SAASC,iBAAiB,QAAQ,uCAAmC;AACrE,SAASC,kBAAkB,QAAQ,wCAAoC;AACvE,SAASC,0BAA0B,QAAQ,qCAAiC;AAE5E,SACEC,eAAe,QAEV,gCAA4B;AACnC,SAASC,aAAa,QAAQ,0BAAsB;AAEpD,SACEC,sBAAsB,QAEjB,uCAAmC;AAG1C,SAASC,eAAe,QAAQ,qBAAiB;AACjD,SAASC,cAAc,QAAQ,yBAAqB;AACpD,SACEC,wBAAwB,EACxBC,kBAAkB,EAClBC,iBAAiB,QACZ,gCAA4B;AACnC,SAASC,mBAAmB,QAAQ,4BAAwB;AAC5D,SAASC,kBAAkB,QAAQ,4BAAwB;AAE3D;;;;;;;;;CASC,GAED,2EAA2E,GAC3E,OAAO,MAAMC,gCAAgC,KAAK;AAElD,+EAA+E,GAC/E,OAAO,MAAMC,gCAAgCR,gBAAgB;IAC3DS,MAAMX,aAAa,CAAC,aAAa;IACjCY,WAAWH;AACb,GAAE;AAEF,2EAA2E,GAC3E,OAAO,MAAMI,uBAAuB,eAAc;AAElD,2DAA2D,GAC3D,OAAO,MAAMC,sCAAgE;IAC3E;QACEC,MAAM;YACJrB;YACA;YACA;YACA;YACA;SACD,CAACsB,IAAI,CAAC;QACPC,iBAAiB;IACnB;CACD,CAAA;AAED,wGAAwG,GACxG,OAAO,SAASC,iBAAiBC,GAA0B;QAC3CA;IAAd,MAAMC,SAAQD,cAAAA,IAAIE,MAAM,qBAAVF,WAAY,CAAC,eAAe;IAC1C,OAAO,OAAOC,UAAU,YAAYA,MAAME,IAAI,KAC1CF,MAAME,IAAI,KACVd;AACN;AAEA,4FAA4F,GAC5F,OAAO,SAASe,iBACdJ,GAA0B,EAC1BK,SAAiC;;IAEjC,wEAAwE;IACxE,0EAA0E;IAC1E,sDAAsD;IACtD,MAAMC,UAAUnB,kBAAkBa,IAAIE,MAAM;IAC5C,MAAMK,MAAM,SAACF,6BAAAA,UAAWG,OAAO,mBAAI,EAAE,EAClCC,MAAM,CAAC,CAACC,MAAQ,CAACA,IAAIC,QAAQ,EAC7BC,GAAG,CAAC,CAACF,MAAS,CAAA;YAAEG,IAAIH,IAAIG,EAAE;YAAEC,OAAOJ,IAAIK,IAAI;YAAEC,MAAMN,IAAIM,IAAI;QAAC,CAAA;IAC/D,MAAMC,WAAWX,QAAQY,IAAI,CAAC,CAACC,OAASjC,mBAAmBiC,KAAKH,IAAI,KAChE,EAAE,GACFT,IAAIE,MAAM,CAAC,CAACU,OAASjC,mBAAmBiC,KAAKH,IAAI,GAAGI,KAAK,CAAC,GAAG;IACjE,MAAMC,QAAQ;WAAIJ;WAAcX,QAAQgB,MAAM,GAAGhB,UAAUC;KAAK,CAACE,MAAM,CAAC,CAACU,OAASA,KAAKL,KAAK,CAACX,IAAI;IACjG,MAAMoB,OAAOF,MAAMG,IAAI,CAAC,CAACL,OAASjC,mBAAmBiC,KAAKH,IAAI;IAC9D,OAAO;WACDO,OAAO;YAAC,aAAKA;gBAAMT,OAAO;;SAAS,GAAG,EAAE;WACzCO,MAAMZ,MAAM,CAAC,CAACU,OAASA,SAASI,QAAQ,CAACrC,mBAAmBiC,KAAKH,IAAI;KACzE,CAACI,KAAK,CAAC,GAAGnC;AACb;AAEA,sEAAsE,GACtE,OAAO,SAASwC,eACdJ,KAA8B,EAC9BhB,SAAiC;QAG1BC;IADP,MAAMA,UAAUe,MAAMG,IAAI,CAAC,CAACL,OAASjC,mBAAmBiC,KAAKH,IAAI;IACjE,QAAOV,gBAAAA,2BAAAA,QAASO,EAAE,oBAAIjC,gBAAgByB,UAAU,CAAC,EAAE,YAA5CC,OAAgD;AACzD;AAEA,wEAAwE,GACxE,OAAO,SAASoB,oBAAoBC,KAKnC;IACC,MAAM,EAAE3B,GAAG,EAAEqB,KAAK,EAAEO,OAAO,EAAE,GAAGD;IAChC,OAAO;QACL,CAAC,MAAM,EAAEA,MAAME,QAAQ,KAAKxC,qBAAqB,qCAAqC,CAAC,CAAC,EAAEsC,MAAME,QAAQ,CAAC,CAAC,CAAC,EAAE;QAC7G7C,eAAegB;QACfqB,MAAMC,MAAM,GACR,CAAC,uCAAuC,EAAED,MAAMT,GAAG,CAAC,CAACO,OAAS,GAAGA,KAAKL,KAAK,CAAC,OAAO,EAAEK,KAAKN,EAAE,CAAC,CAAC,CAAC,EAAEhB,IAAI,CAAC,MAAM,CAAC,CAAC,GAC9G;QACJ+B,QAAQE,KAAK,CAACR,MAAM,IAAIM,QAAQG,UAAU,GACtC,uEACA;QACJ,CAAC,aAAa,EAAE/B,IAAIgC,GAAG,CAACZ,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC;KACrC,CAACvB,IAAI,CAAC;AACT;AAWA,4HAA4H,GAC5H,OAAO,SAASoC,mBAAmBN,KAMlC;IACC,IAAIO,UAAU;IACd,OAAO,CAACC;QACN,2FAA2F;QAC3FD,WAAW;QACX,MAAME,OAAOF,WAAWvD;QACxB,MAAM0D,QAAQ7D,kBAAkB2D;QAChC,MAAMG,WAAWhE,qBACf+D,OACA;YAAER,UAAUF,MAAME,QAAQ;YAAEU,QAAQZ,MAAMY,MAAM;YAAEC,UAAUb,MAAMN,KAAK;QAAC,GACxEM,MAAMC,OAAO;QAEf,MAAMa,UAAU;YACdC,WAAW;mBACN,IAAIC,IAAI;uBACNhB,MAAMC,OAAO,CAACP,KAAK,CAACT,GAAG,CAAC,CAACO,OAASA,KAAKN,EAAE;uBACzCc,MAAMN,KAAK,CAACT,GAAG,CAAC,CAACO,OAASA,KAAKN,EAAE;uBAChCc,MAAMY,MAAM,GAAG;wBAACZ,MAAMY,MAAM;qBAAC,GAAG,EAAE;iBACvC;aACF;YACDK,SAASjB,MAAMC,OAAO,CAACE,KAAK,CAAClB,GAAG,CAAC,CAACiC,OAASA,KAAKhC,EAAE;YAClDiC,eAAenB,MAAMC,OAAO,CAACmB,OAAO;YACpCC,WAAW;QACb;QACA,MAAMC,SAASvE,mBAAmB4D,SAASY,IAAI,EAAE,UAAUT;QAC3D,IAAIQ,OAAOE,EAAE,KAAK,OAAO;YACvBC,QAAQC,KAAK,CAAC,oDAAoD;gBAChEA,OAAOJ,OAAOI,KAAK;YACrB;YACA,OAAO;gBACLC,OAAO;gBACPC,YAAY;oBACV;wBACEC,MAAM;wBACNC,MAAM;wBACNC,SAAS;wBACTC,QAAQV,OAAOI,KAAK;oBACtB;iBACD;YACH;QACF;QACA,uFAAuF;QACvF,MAAMb,WAAW;eAAIb,MAAMC,OAAO,CAACP,KAAK;eAAKM,MAAMN,KAAK;SAAC;QACzD,MAAMuC,OAAOnF,kBACXwE,OAAOY,KAAK,EACZZ,OAAOa,MAAM,EACb;YACEzC,OAAOmB;YACPuB,KAAK;mBAAIvB,SAAS5B,GAAG,CAAC,CAACO,OAASA,KAAKN,EAAE;mBAAMc,MAAMC,OAAO,CAACE,KAAK,CAAClB,GAAG,CAAC,CAACiC,OAASA,KAAKhC,EAAE;aAAE;QAC1F,GACAuB;QAEF,MAAM,EAAEyB,KAAK,EAAEG,OAAO,EAAE,GAAGJ;QAC3B,MAAMK,SAASnF,uBACb;YAAEgF,QAAQb,OAAOa,MAAM;YAAED;QAAM,GAC/B,UACApB;QAEF,MAAMc,aAAa;eACdU,OAAOV,UAAU;eACjBK,KAAKL,UAAU;eACf5B,MAAMuC,MAAM,CAAC;gBACdJ,QAAQb,OAAOa,MAAM;gBACrBD;gBACAM,SAAS,EAAE;gBACXC,WAAW,CAAC;gBACZC,OAAOJ,OAAOI,KAAK;gBACnBC,MAAML,OAAOK,IAAI;YACnB;SACD;QACD,OAAO;YACLhB,OAAOC,WAAWjC,MAAM,GACpB,OACA;gBAAEwC,QAAQb,OAAOa,MAAM;gBAAED;gBAAOS,MAAML,OAAOK,IAAI;gBAAEN;YAAQ;YAC/DT;QACF;IACF;AACF;AAEA,yFAAyF,GACzF,OAAO,SAASgB,qBACdvE,GAAoC,EACpCK,SAAiC;IAEjC,OAAOjB,oBAAoB;QAAEY;QAAKK;QAAWE,KAAK,EAAE;IAAC;AACvD"}

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

@@ -45,8 +45,19 @@ export interface AiLayoutSitePage {
     label: string;
     slug: string;
 }
-/** The pages a scaffold's plan puts in the navigation, in plan order: ids minted, entries asked for, no record templates. */
-export declare function aiLayoutSitePagesOfPlan(screens: readonly AiBuildPlanScreen[]): AiLayoutSitePage[];
+/** Whether a slug is the site's root, the home page. */
+export declare function aiLayoutIsHomeSlug(slug: string): boolean;
+/**
+ * The pages a plan puts in the navigation, record templates aside, the home
+ * page first whatever its `nav` flag says (AGL-3660): a guided start's plan
+ * marked its Home `nav: false`, and the header linked only Contact. Every
+ * other page keeps its `nav` flag, except in a guided start (`guided`), whose
+ * pages are the ones the person asked for: each is linked, but a
+ * confirmation page — a thank-you, a "submitted" — stays out.
+ */
+export declare function aiLayoutSitePagesOfPlan(screens: readonly AiBuildPlanScreen[], options?: {
+    guided?: boolean;
+}): AiLayoutSitePage[];
 /** The planned pages a layout unit's inputs carry; none for any other layout. */
 export declare function aiLayoutSitePages(inputs: Readonly<Record<string, unknown>> | null | undefined): AiLayoutSitePage[];
 /**

package/src/lib/jobs/ai-job-layout-site-pages.js

@@ -36,12 +36,28 @@ import { _ as _extends } from "@swc/helpers/_/_extends";
  * adds only the entries a header does not already carry, adds nothing twice.
  */ /** The unit input a site layout's planned pages travel under. */ export const AI_LAYOUT_SITE_PAGES_INPUT = 'sitePages';
 /** The most pages the header links, as the layout instructions cap it. */ export const AI_LAYOUT_SITE_PAGES_MAX = 7;
-/** The pages a scaffold's plan puts in the navigation, in plan order: ids minted, entries asked for, no record templates. */ export function aiLayoutSitePagesOfPlan(screens) {
-    return screens.filter((screen)=>screen.nav && !screen.record && typeof screen.id === 'string' && screen.id).slice(0, AI_LAYOUT_SITE_PAGES_MAX).map((screen)=>({
+/** Whether a slug is the site's root, the home page. */ export function aiLayoutIsHomeSlug(slug) {
+    return slug.replace(/^\/+|\/+$/g, '') === '';
+}
+/** A page that confirms what a visitor just did, which no navigation links. */ const CONFIRMATION = /thank|confirm|success|submitted/i;
+/**
+ * The pages a plan puts in the navigation, record templates aside, the home
+ * page first whatever its `nav` flag says (AGL-3660): a guided start's plan
+ * marked its Home `nav: false`, and the header linked only Contact. Every
+ * other page keeps its `nav` flag, except in a guided start (`guided`), whose
+ * pages are the ones the person asked for: each is linked, but a
+ * confirmation page — a thank-you, a "submitted" — stays out.
+ */ export function aiLayoutSitePagesOfPlan(screens, options = {}) {
+    const linked = (screen)=>aiLayoutIsHomeSlug(screen.slug) || (options.guided ? !CONFIRMATION.test(`${screen.slug} ${screen.title}`) : !!screen.nav);
+    const pages = screens.filter((screen)=>!screen.record && typeof screen.id === 'string' && screen.id && linked(screen)).map((screen)=>({
             id: screen.id,
             label: screen.title.trim(),
             slug: screen.slug
         })).filter((page)=>page.label);
+    return [
+        ...pages.filter((page)=>aiLayoutIsHomeSlug(page.slug)),
+        ...pages.filter((page)=>!aiLayoutIsHomeSlug(page.slug))
+    ].slice(0, AI_LAYOUT_SITE_PAGES_MAX);
 }
 /** The planned pages a layout unit's inputs carry; none for any other layout. */ export function aiLayoutSitePages(inputs) {
     const raw = inputs == null ? void 0 : inputs[AI_LAYOUT_SITE_PAGES_INPUT];

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

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/jobs/ai-job-layout-site-pages.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 { normalizeScreenSlug, SCREEN_ROOT_PATH } from '@aglyn/aglyn/app-utils/screen-route'\nimport type { AiBuildPlanScreen } from '../model/ai-build-plan'\n\n/**\n * The navigation of a layout a site scaffold builds before its pages (AGL-3596).\n *\n * A scaffold builds its layout FIRST, because every page renders inside it,\n * so when the layout is generated none of the site's pages exists yet: the\n * model cannot link them, and the layout instructions forbid inventing a page\n * id. A plan that gave the layout a nav region then left the model one way to\n * keep the promise — a nav element with nothing in it — which rule 16 refuses\n * as an empty container, twice, and the guided start stopped there.\n *\n * The scaffold does know the pages: their ids are minted when the plan is\n * kept (`AiBuildPlanScreen.id`), and each page unit writes its draft under\n * that id. So the layout unit is handed them (`sitePages`), and the header's\n * navigation is written by the platform rather than asked of the model: one\n * Page Link per planned page, inside the nav element the model left (filled,\n * never left empty) or a nav row the platform adds to the Toolbar Content.\n * The completed tree is what the doctrine checks and what is written, so rule\n * 16 holds unchanged — nothing it sees is empty — and the publish step, which\n * adds only the entries a header does not already carry, adds nothing twice.\n */\n\n/** The unit input a site layout's planned pages travel under. */\nexport const AI_LAYOUT_SITE_PAGES_INPUT = 'sitePages'\n\n/** The most pages the header links, as the layout instructions cap it. */\nexport const AI_LAYOUT_SITE_PAGES_MAX = 7\n\n/** A page the scaffold builds after the layout, as the layout links it. */\nexport interface AiLayoutSitePage {\n  id: string\n  label: string\n  slug: string\n}\n\n/** The pages a scaffold's plan puts in the navigation, in plan order: ids minted, entries asked for, no record templates. */\nexport function aiLayoutSitePagesOfPlan(screens: readonly AiBuildPlanScreen[]): AiLayoutSitePage[] {\n  return screens\n    .filter((screen) => screen.nav && !screen.record && typeof screen.id === 'string' && screen.id)\n    .slice(0, AI_LAYOUT_SITE_PAGES_MAX)\n    .map((screen) => ({ id: screen.id as string, label: screen.title.trim(), slug: screen.slug }))\n    .filter((page) => page.label)\n}\n\n/** The planned pages a layout unit's inputs carry; none for any other layout. */\nexport function aiLayoutSitePages(inputs: Readonly<Record<string, unknown>> | null | undefined): AiLayoutSitePage[] {\n  const raw = inputs?.[AI_LAYOUT_SITE_PAGES_INPUT]\n  if (!Array.isArray(raw)) return []\n  const pages: AiLayoutSitePage[] = []\n  for (const entry of raw) {\n    if (!entry || typeof entry !== 'object') continue\n    const { id, label, slug } = entry as Record<string, unknown>\n    if (typeof id !== 'string' || !id || typeof label !== 'string' || !label.trim()) continue\n    if (pages.some((page) => page.id === id)) continue\n    pages.push({ id, label: label.trim(), slug: typeof slug === 'string' ? slug : '' })\n  }\n  return pages.slice(0, AI_LAYOUT_SITE_PAGES_MAX)\n}\n\n/**\n * What the layout's user turn says about those pages: that the platform\n * writes the navigation, so the model builds none and leaves no empty element\n * for it. The same promise the completion below keeps.\n */\nexport function aiLayoutSitePagesLines(pages: readonly AiLayoutSitePage[]): string[] {\n  if (!pages.length) return []\n  return [\n    `This site’s pages are built after this layout: ${pages\n      .map((page) => `${page.label} (${screenPath(page.slug)})`)\n      .join(', ')}.`,\n    'The platform writes the header’s navigation to those pages itself, as a nav row of Page Links inside the Toolbar Content. Build no navigation links to them and no nav element for them: leave no empty element where the links will go.',\n  ]\n}\n\nfunction screenPath(slug: string): string {\n  const normalized = normalizeScreenSlug(slug)\n  if (!normalized || normalized === SCREEN_ROOT_PATH) return '/'\n  return `/${normalized.replace(/^\\/+/, '')}`\n}\n\ntype RawNode = { componentId?: unknown; props?: Record<string, unknown>; nodes?: unknown; [key: string]: 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\nconst elementOf = (node: RawNode | undefined): string => {\n  const value = node?.props?.['component'] ?? node?.props?.['element']\n  return typeof value === 'string' ? value : ''\n}\n\nconst LINK_COMPONENTS = new Set(['muiScreenLink', 'muiButton'])\n\n/**\n * The model's layout with the header's navigation written in: a Page Link to\n * every planned page the header does not already link, placed in the first\n * nav element above the Layout Slot, else in a nav row the platform appends\n * to the Toolbar Content; and every OTHER nav element the model left empty\n * given the same links, so no nav is ever empty. A link to the site's current\n * home page is pointed at the planned home, which replaces it when the site\n * is published. Anything that is not a node map, or has no planned pages, is\n * returned as it came, for the doctrine to judge.\n */\nexport function aiLayoutWithSitePages(\n  tree: unknown,\n  pages: readonly AiLayoutSitePage[],\n  options: { homeScreenIds?: readonly string[] } = {},\n): unknown {\n  if (!pages.length || !isRecord(tree) || !isRecord(tree['nodes'])) return tree\n  const rootId = typeof tree['rootId'] === 'string' ? tree['rootId'] : null\n  const source = tree['nodes'] as Record<string, unknown>\n  if (!rootId || !isRecord(source[rootId])) return tree\n  const nodes: Record<string, RawNode> = {}\n  for (const [id, node] of Object.entries(source)) {\n    if (!isRecord(node)) continue\n    nodes[id] = {\n      ...(node as RawNode),\n      ...(isRecord(node['props']) ? { props: { ...(node['props'] as Record<string, unknown>) } } : {}),\n      ...(Array.isArray(node['nodes']) ? { nodes: [...(node['nodes'] as unknown[])] } : {}),\n    }\n  }\n\n  // Document order, and where the header ends: the Layout Slot.\n  const order: string[] = []\n  const seen = new Set<string>()\n  const visit = (id: string) => {\n    if (seen.has(id) || !nodes[id]) return\n    seen.add(id)\n    order.push(id)\n    for (const child of childrenOf(nodes[id])) visit(child)\n  }\n  visit(rootId)\n  const slotAt = order.findIndex((id) => nodes[id].componentId === 'layoutSlot')\n  const header = slotAt === -1 ? order : order.slice(0, slotAt)\n\n  // The site's current home is replaced by the planned one at publish.\n  const plannedHome = pages.find((page) => screenPath(page.slug) === '/')\n  const oldHomes = new Set(options.homeScreenIds ?? [])\n  let changed = false\n  if (plannedHome) {\n    for (const id of order) {\n      const node = nodes[id]\n      const screenId = node.props?.['screenId']\n      if (LINK_COMPONENTS.has(String(node.componentId)) && typeof screenId === 'string' && oldHomes.has(screenId)) {\n        node.props = { ...node.props, screenId: plannedHome.id }\n        changed = true\n      }\n    }\n  }\n\n  const used = new Set(Object.keys(nodes))\n  const freshId = (base: string): string => {\n    let id = base\n    for (let n = 2; used.has(id); n += 1) id = `${base}${n}`\n    used.add(id)\n    return id\n  }\n  const linkNodes = (entries: readonly AiLayoutSitePage[]): string[] =>\n    entries.map((page) => {\n      const id = freshId(`aiNavLink_${page.id.replace(/[^A-Za-z0-9_]/g, '')}`)\n      nodes[id] = {\n        componentId: 'muiScreenLink',\n        props: { children: page.label.slice(0, 40), screenId: page.id, renderAs: 'link', color: 'inherit' },\n      }\n      return id\n    })\n\n  const linkedInHeader = new Set(\n    header\n      .map((id) => nodes[id])\n      .filter((node) => LINK_COMPONENTS.has(String(node.componentId)))\n      .map((node) => node.props?.['screenId'])\n      .filter((value): value is string => typeof value === 'string'),\n  )\n  const missing = pages.filter((page) => !linkedInHeader.has(page.id))\n  const navs = order.filter((id) => elementOf(nodes[id]) === 'nav')\n  const headerNav = navs.find((id) => header.includes(id)) ?? null\n\n  if (missing.length) {\n    if (headerNav) {\n      nodes[headerNav].nodes = [...childrenOf(nodes[headerNav]), ...linkNodes(missing)]\n      changed = true\n    } else {\n      const toolbar = header.find((id) => nodes[id].componentId === 'muiToolbar')\n      if (toolbar) {\n        const navId = freshId('aiSiteNav')\n        nodes[navId] = {\n          componentId: 'muiStack',\n          props: { component: 'nav', direction: 'row', alignItems: 'center' },\n          sx: { gap: 2 },\n          nodes: linkNodes(missing),\n        }\n        nodes[toolbar].nodes = [...childrenOf(nodes[toolbar]), navId]\n        changed = true\n      }\n    }\n  }\n  // A nav element the model left empty anywhere else — a footer's, say — links the same pages.\n  for (const id of navs) {\n    if (id === headerNav && missing.length) continue\n    if (childrenOf(nodes[id]).some((child) => nodes[child])) continue\n    nodes[id].nodes = linkNodes(pages)\n    changed = true\n  }\n  return changed ? { ...tree, nodes } : tree\n}\n"],"names":["normalizeScreenSlug","SCREEN_ROOT_PATH","AI_LAYOUT_SITE_PAGES_INPUT","AI_LAYOUT_SITE_PAGES_MAX","aiLayoutSitePagesOfPlan","screens","filter","screen","nav","record","id","slice","map","label","title","trim","slug","page","aiLayoutSitePages","inputs","raw","Array","isArray","pages","entry","some","push","aiLayoutSitePagesLines","length","screenPath","join","normalized","replace","isRecord","value","Boolean","childrenOf","node","nodes","elementOf","props","LINK_COMPONENTS","Set","aiLayoutWithSitePages","tree","options","navs","rootId","source","Object","entries","order","seen","visit","has","add","child","slotAt","findIndex","componentId","header","plannedHome","find","oldHomes","homeScreenIds","changed","screenId","String","used","keys","freshId","base","n","linkNodes","children","renderAs","color","linkedInHeader","missing","headerNav","includes","toolbar","navId","component","direction","alignItems","sx","gap"],"mappings":"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"}
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/jobs/ai-job-layout-site-pages.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 { normalizeScreenSlug, SCREEN_ROOT_PATH } from '@aglyn/aglyn/app-utils/screen-route'\nimport type { AiBuildPlanScreen } from '../model/ai-build-plan'\n\n/**\n * The navigation of a layout a site scaffold builds before its pages (AGL-3596).\n *\n * A scaffold builds its layout FIRST, because every page renders inside it,\n * so when the layout is generated none of the site's pages exists yet: the\n * model cannot link them, and the layout instructions forbid inventing a page\n * id. A plan that gave the layout a nav region then left the model one way to\n * keep the promise — a nav element with nothing in it — which rule 16 refuses\n * as an empty container, twice, and the guided start stopped there.\n *\n * The scaffold does know the pages: their ids are minted when the plan is\n * kept (`AiBuildPlanScreen.id`), and each page unit writes its draft under\n * that id. So the layout unit is handed them (`sitePages`), and the header's\n * navigation is written by the platform rather than asked of the model: one\n * Page Link per planned page, inside the nav element the model left (filled,\n * never left empty) or a nav row the platform adds to the Toolbar Content.\n * The completed tree is what the doctrine checks and what is written, so rule\n * 16 holds unchanged — nothing it sees is empty — and the publish step, which\n * adds only the entries a header does not already carry, adds nothing twice.\n */\n\n/** The unit input a site layout's planned pages travel under. */\nexport const AI_LAYOUT_SITE_PAGES_INPUT = 'sitePages'\n\n/** The most pages the header links, as the layout instructions cap it. */\nexport const AI_LAYOUT_SITE_PAGES_MAX = 7\n\n/** A page the scaffold builds after the layout, as the layout links it. */\nexport interface AiLayoutSitePage {\n  id: string\n  label: string\n  slug: string\n}\n\n/** Whether a slug is the site's root, the home page. */\nexport function aiLayoutIsHomeSlug(slug: string): boolean {\n  return slug.replace(/^\\/+|\\/+$/g, '') === ''\n}\n\n/** A page that confirms what a visitor just did, which no navigation links. */\nconst CONFIRMATION = /thank|confirm|success|submitted/i\n\n/**\n * The pages a plan puts in the navigation, record templates aside, the home\n * page first whatever its `nav` flag says (AGL-3660): a guided start's plan\n * marked its Home `nav: false`, and the header linked only Contact. Every\n * other page keeps its `nav` flag, except in a guided start (`guided`), whose\n * pages are the ones the person asked for: each is linked, but a\n * confirmation page — a thank-you, a \"submitted\" — stays out.\n */\nexport function aiLayoutSitePagesOfPlan(\n  screens: readonly AiBuildPlanScreen[],\n  options: { guided?: boolean } = {},\n): AiLayoutSitePage[] {\n  const linked = (screen: AiBuildPlanScreen) =>\n    aiLayoutIsHomeSlug(screen.slug) ||\n    (options.guided ? !CONFIRMATION.test(`${screen.slug} ${screen.title}`) : !!screen.nav)\n  const pages = screens\n    .filter((screen) => !screen.record && typeof screen.id === 'string' && screen.id && linked(screen))\n    .map((screen) => ({ id: screen.id as string, label: screen.title.trim(), slug: screen.slug }))\n    .filter((page) => page.label)\n  return [...pages.filter((page) => aiLayoutIsHomeSlug(page.slug)), ...pages.filter((page) => !aiLayoutIsHomeSlug(page.slug))].slice(\n    0,\n    AI_LAYOUT_SITE_PAGES_MAX,\n  )\n}\n\n/** The planned pages a layout unit's inputs carry; none for any other layout. */\nexport function aiLayoutSitePages(inputs: Readonly<Record<string, unknown>> | null | undefined): AiLayoutSitePage[] {\n  const raw = inputs?.[AI_LAYOUT_SITE_PAGES_INPUT]\n  if (!Array.isArray(raw)) return []\n  const pages: AiLayoutSitePage[] = []\n  for (const entry of raw) {\n    if (!entry || typeof entry !== 'object') continue\n    const { id, label, slug } = entry as Record<string, unknown>\n    if (typeof id !== 'string' || !id || typeof label !== 'string' || !label.trim()) continue\n    if (pages.some((page) => page.id === id)) continue\n    pages.push({ id, label: label.trim(), slug: typeof slug === 'string' ? slug : '' })\n  }\n  return pages.slice(0, AI_LAYOUT_SITE_PAGES_MAX)\n}\n\n/**\n * What the layout's user turn says about those pages: that the platform\n * writes the navigation, so the model builds none and leaves no empty element\n * for it. The same promise the completion below keeps.\n */\nexport function aiLayoutSitePagesLines(pages: readonly AiLayoutSitePage[]): string[] {\n  if (!pages.length) return []\n  return [\n    `This site’s pages are built after this layout: ${pages\n      .map((page) => `${page.label} (${screenPath(page.slug)})`)\n      .join(', ')}.`,\n    'The platform writes the header’s navigation to those pages itself, as a nav row of Page Links inside the Toolbar Content. Build no navigation links to them and no nav element for them: leave no empty element where the links will go.',\n  ]\n}\n\nfunction screenPath(slug: string): string {\n  const normalized = normalizeScreenSlug(slug)\n  if (!normalized || normalized === SCREEN_ROOT_PATH) return '/'\n  return `/${normalized.replace(/^\\/+/, '')}`\n}\n\ntype RawNode = { componentId?: unknown; props?: Record<string, unknown>; nodes?: unknown; [key: string]: 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\nconst elementOf = (node: RawNode | undefined): string => {\n  const value = node?.props?.['component'] ?? node?.props?.['element']\n  return typeof value === 'string' ? value : ''\n}\n\nconst LINK_COMPONENTS = new Set(['muiScreenLink', 'muiButton'])\n\n/**\n * The model's layout with the header's navigation written in: a Page Link to\n * every planned page the header does not already link, placed in the first\n * nav element above the Layout Slot, else in a nav row the platform appends\n * to the Toolbar Content; and every OTHER nav element the model left empty\n * given the same links, so no nav is ever empty. A link to the site's current\n * home page is pointed at the planned home, which replaces it when the site\n * is published. Anything that is not a node map, or has no planned pages, is\n * returned as it came, for the doctrine to judge.\n */\nexport function aiLayoutWithSitePages(\n  tree: unknown,\n  pages: readonly AiLayoutSitePage[],\n  options: { homeScreenIds?: readonly string[] } = {},\n): unknown {\n  if (!pages.length || !isRecord(tree) || !isRecord(tree['nodes'])) return tree\n  const rootId = typeof tree['rootId'] === 'string' ? tree['rootId'] : null\n  const source = tree['nodes'] as Record<string, unknown>\n  if (!rootId || !isRecord(source[rootId])) return tree\n  const nodes: Record<string, RawNode> = {}\n  for (const [id, node] of Object.entries(source)) {\n    if (!isRecord(node)) continue\n    nodes[id] = {\n      ...(node as RawNode),\n      ...(isRecord(node['props']) ? { props: { ...(node['props'] as Record<string, unknown>) } } : {}),\n      ...(Array.isArray(node['nodes']) ? { nodes: [...(node['nodes'] as unknown[])] } : {}),\n    }\n  }\n\n  // Document order, and where the header ends: the Layout Slot.\n  const order: string[] = []\n  const seen = new Set<string>()\n  const visit = (id: string) => {\n    if (seen.has(id) || !nodes[id]) return\n    seen.add(id)\n    order.push(id)\n    for (const child of childrenOf(nodes[id])) visit(child)\n  }\n  visit(rootId)\n  const slotAt = order.findIndex((id) => nodes[id].componentId === 'layoutSlot')\n  const header = slotAt === -1 ? order : order.slice(0, slotAt)\n\n  // The site's current home is replaced by the planned one at publish.\n  const plannedHome = pages.find((page) => screenPath(page.slug) === '/')\n  const oldHomes = new Set(options.homeScreenIds ?? [])\n  let changed = false\n  if (plannedHome) {\n    for (const id of order) {\n      const node = nodes[id]\n      const screenId = node.props?.['screenId']\n      if (LINK_COMPONENTS.has(String(node.componentId)) && typeof screenId === 'string' && oldHomes.has(screenId)) {\n        node.props = { ...node.props, screenId: plannedHome.id }\n        changed = true\n      }\n    }\n  }\n\n  const used = new Set(Object.keys(nodes))\n  const freshId = (base: string): string => {\n    let id = base\n    for (let n = 2; used.has(id); n += 1) id = `${base}${n}`\n    used.add(id)\n    return id\n  }\n  const linkNodes = (entries: readonly AiLayoutSitePage[]): string[] =>\n    entries.map((page) => {\n      const id = freshId(`aiNavLink_${page.id.replace(/[^A-Za-z0-9_]/g, '')}`)\n      nodes[id] = {\n        componentId: 'muiScreenLink',\n        props: { children: page.label.slice(0, 40), screenId: page.id, renderAs: 'link', color: 'inherit' },\n      }\n      return id\n    })\n\n  const linkedInHeader = new Set(\n    header\n      .map((id) => nodes[id])\n      .filter((node) => LINK_COMPONENTS.has(String(node.componentId)))\n      .map((node) => node.props?.['screenId'])\n      .filter((value): value is string => typeof value === 'string'),\n  )\n  const missing = pages.filter((page) => !linkedInHeader.has(page.id))\n  const navs = order.filter((id) => elementOf(nodes[id]) === 'nav')\n  const headerNav = navs.find((id) => header.includes(id)) ?? null\n\n  if (missing.length) {\n    if (headerNav) {\n      nodes[headerNav].nodes = [...childrenOf(nodes[headerNav]), ...linkNodes(missing)]\n      changed = true\n    } else {\n      const toolbar = header.find((id) => nodes[id].componentId === 'muiToolbar')\n      if (toolbar) {\n        const navId = freshId('aiSiteNav')\n        nodes[navId] = {\n          componentId: 'muiStack',\n          props: { component: 'nav', direction: 'row', alignItems: 'center' },\n          sx: { gap: 2 },\n          nodes: linkNodes(missing),\n        }\n        nodes[toolbar].nodes = [...childrenOf(nodes[toolbar]), navId]\n        changed = true\n      }\n    }\n  }\n  // A nav element the model left empty anywhere else — a footer's, say — links the same pages.\n  for (const id of navs) {\n    if (id === headerNav && missing.length) continue\n    if (childrenOf(nodes[id]).some((child) => nodes[child])) continue\n    nodes[id].nodes = linkNodes(pages)\n    changed = true\n  }\n  return changed ? { ...tree, nodes } : tree\n}\n"],"names":["normalizeScreenSlug","SCREEN_ROOT_PATH","AI_LAYOUT_SITE_PAGES_INPUT","AI_LAYOUT_SITE_PAGES_MAX","aiLayoutIsHomeSlug","slug","replace","CONFIRMATION","aiLayoutSitePagesOfPlan","screens","options","linked","screen","guided","test","title","nav","pages","filter","record","id","map","label","trim","page","slice","aiLayoutSitePages","inputs","raw","Array","isArray","entry","some","push","aiLayoutSitePagesLines","length","screenPath","join","normalized","isRecord","value","Boolean","childrenOf","node","nodes","elementOf","props","LINK_COMPONENTS","Set","aiLayoutWithSitePages","tree","navs","rootId","source","Object","entries","order","seen","visit","has","add","child","slotAt","findIndex","componentId","header","plannedHome","find","oldHomes","homeScreenIds","changed","screenId","String","used","keys","freshId","base","n","linkNodes","children","renderAs","color","linkedInHeader","missing","headerNav","includes","toolbar","navId","component","direction","alignItems","sx","gap"],"mappings":"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"}

package/src/lib/jobs/ai-job-layout-step.d.ts

@@ -78,6 +78,11 @@ export declare function aiJobLayoutPrompt(job: Pick<AiJob, 'brief'> & Partial<Pi
  * component is placed rather than drawn again in the header.
  */
 export declare function aiLayoutReuseCheck(inventory: AiSiteInventory | null, plan: AiJobPlan | null): (tree: AiValidatedTree) => AiDoctrineViolation[];
+/**
+ * Every check the layout door adds to the doctrine's: the reuse and region
+ * checks above, and no contact detail the brief does not give (AGL-3596).
+ */
+export declare function aiLayoutChecks(inventory: AiSiteInventory | null, plan: AiJobPlan | null, brief: string): (tree: AiValidatedTree) => AiDoctrineViolation[];
 /**
  * The regions the confirmed plan gives the layout, against the layout a COPY
  * actually produced (AGL-3024); `null` when the copy keeps the plan, or when

package/src/lib/jobs/ai-job-layout-step.js

@@ -29,6 +29,11 @@ import { aiDraftAdmissionRefusal, aiDraftAllowanceRefusal, aiSiteSubdomain, read
 import { aiBracketedFactsNote, aiCopySourceLines, aiConfirmedPlan, aiDoctrineReview, aiGenerationSpent, aiJobBriefLine, aiLimitReview, aiModelNodeIds, aiPlacedComponentIds, aiPlanCreation, aiPlanReferenceLines, aiPlanReuseViolations, aiUnspentOutcome } from "./ai-job-generation.js";
 import { aiPlanRegionViolations, aiPlannedLayoutRegions } from "./ai-job-plan-conformance.js";
 import { aiLayoutSitePages, aiLayoutSitePagesLines, aiLayoutWithSitePages } from "./ai-job-layout-site-pages.js";
+import { aiLayoutInventedContactViolations, aiLayoutWithSiteName } from "./ai-layout-site-facts.js";
+import { aiLayoutWithFullHeight } from "./ai-layout-full-height.js";
+import { AI_LAYOUT_FRAME_TOOL } from "../layout-language/ai-layout-language.js";
+import { AI_JOB_LAYOUT_LANGUAGE_BUDGET, AI_JOB_LAYOUT_LANGUAGE_INSTRUCTIONS, AI_LAYOUT_FRAME_KIND, aiLayoutFrameCheck, aiLayoutFramePrompt, aiLayoutFrameTargets, aiLayoutHomeId, aiLayoutNavPages, aiLayoutSiteName } from "./ai-job-layout-language.js";
+import { aiJobUsesLayoutLanguage } from "./ai-job-page-language.js";
 import { aiJobStepBudget } from "./ai-job-budget.js";
 import { registerAiJobStep } from "./ai-jobs.js";
 /**
@@ -139,6 +144,24 @@ const FOOTER_NAME = /\bfooter\b/i;
         return violations;
     };
 }
+/**
+ * Every check the layout door adds to the doctrine's: the reuse and region
+ * checks above, and no contact detail the brief does not give (AGL-3596).
+ */ export function aiLayoutChecks(inventory, plan, brief) {
+    const reuse = aiLayoutReuseCheck(inventory, plan);
+    return (tree)=>[
+            ...reuse(tree),
+            ...aiLayoutInventedContactViolations({
+                rootId: tree.rootId,
+                nodes: tree.nodes
+            }, brief).map((violation)=>{
+                var _violation_nodeIds;
+                return _extends({}, violation, {
+                    nodeIds: aiModelNodeIds((_violation_nodeIds = violation.nodeIds) != null ? _violation_nodeIds : [], tree.sourceIds)
+                });
+            })
+        ];
+}
 /**
  * The regions the confirmed plan gives the layout, against the layout a COPY
  * actually produced (AGL-3024); `null` when the copy keeps the plan, or when
@@ -310,6 +333,77 @@ export function createAiJobLayoutStep(deps = {}) {
         if (allowance) return aiUnspentOutcome(model, {
             review: aiLimitReview(allowance)
         });
+        if (aiJobUsesLayoutLanguage(job)) {
+            // ── The header and footer designed in the layout language (AGL-3660) ──
+            const siteName = aiLayoutSiteName(job);
+            const pages = aiLayoutNavPages(job, inventory);
+            const targets = aiLayoutFrameTargets(job, inventory);
+            const result = await runValidatedGeneration(AI_LAYOUT_FRAME_KIND, _extends({
+                step: 'job.layout',
+                model,
+                instructions: AI_JOB_LAYOUT_LANGUAGE_INSTRUCTIONS,
+                inventory,
+                messages: [
+                    {
+                        role: 'user',
+                        content: aiLayoutFramePrompt({
+                            job,
+                            siteName,
+                            pages,
+                            targets
+                        })
+                    }
+                ],
+                tool: AI_LAYOUT_FRAME_TOOL,
+                maxTokens: AI_JOB_LAYOUT_LANGUAGE_BUDGET.maxTokens(model),
+                thinking: 'off',
+                check: aiLayoutFrameCheck({
+                    siteName,
+                    homeId: aiLayoutHomeId(pages, inventory),
+                    pages,
+                    targets,
+                    extend: aiLayoutChecks(inventory, plan, job.brief)
+                })
+            }, signal ? {
+                signal
+            } : {}));
+            const spent = aiGenerationSpent(result);
+            if (result.status === 'refused') return _extends({}, spent, {
+                refused: true
+            });
+            if (result.status === 'needs_input') return _extends({}, spent, {
+                review: aiDoctrineReview(result)
+            });
+            const draft = await writeAiDraft(firestore, {
+                kind: 'layout',
+                hostId,
+                id: draftId,
+                uid: job.createdBy,
+                org,
+                name,
+                nodes: result.value.nodes,
+                aiJobId: aiOriginJobId(job),
+                now
+            });
+            if (draft.ok === false) {
+                if (draft.status === 404) throw new Error(`site ${hostId} vanished while its layout was generated`);
+                return _extends({}, spent, {
+                    review: aiLimitReview(draft.error)
+                });
+            }
+            const note = aiBracketedFactsNote({
+                tree: {
+                    rootId: result.value.rootId,
+                    nodes: result.value.nodes
+                },
+                inventory
+            });
+            return _extends({}, spent, {
+                outputs: [
+                    output(draft, result.value.load, note)
+                ]
+            });
+        }
         // The pages a site scaffold builds after this layout (AGL-3596): their
         // ids are the plan's, so the header links them by id, written by the
         // platform before the doctrine checks the tree.
@@ -332,17 +426,23 @@ export function createAiJobLayoutStep(deps = {}) {
         } : {}, AI_ROUTING_TABLE['job.layout'].effort ? {
             effort: AI_ROUTING_TABLE['job.layout'].effort
         } : {}, {
-            extend: aiLayoutReuseCheck(inventory, plan)
+            extend: aiLayoutChecks(inventory, plan, job.brief),
+            // The site's name is written as the token that reads it, and the
+            // layout fills the window so a short page keeps its footer at the
+            // bottom (AGL-3596).
+            complete: (tree)=>{
+                var _job_inputs;
+                return aiLayoutWithFullHeight(aiLayoutWithSiteName(sitePages.length ? aiLayoutWithSitePages(tree, sitePages, {
+                    homeScreenIds: aiHomeScreenIds(inventory)
+                }) : tree, typeof ((_job_inputs = job.inputs) == null ? void 0 : _job_inputs['businessName']) === 'string' ? job.inputs['businessName'] : null));
+            }
         }, sitePages.length ? {
             context: {
                 screenIds: [
                     ...inventory.screens.map((screen)=>screen.id),
                     ...sitePages.map((page)=>page.id)
                 ]
-            },
-            complete: (tree)=>aiLayoutWithSitePages(tree, sitePages, {
-                    homeScreenIds: aiHomeScreenIds(inventory)
-                })
+            }
         } : {}, signal ? {
             signal
         } : {}));