@aglyn/plugins-ai 1.0.0-beta.242 → 1.0.0-beta.244

package/src/lib/runtime/ai-doctrine-validators.d.ts

@@ -130,6 +130,14 @@ export interface AiDoctrineTreeContext extends AiNodeTreeContext {
      * to when the site has none for what it promises. Absent: none is known.
      */
     homeScreenIds?: readonly string[];
+    /**
+     * The site's pages that place its form, by id (AGL-3729): where a link whose
+     * words ask a visitor to get in touch (`aiAsksToGetInTouch`) does what it
+     * says, even when that page is home. A guided start's café put its
+     * pre-order form on Home, and its Menu page's "Request weekend pickup"
+     * links there. Absent: none is known, and a link home is held to its words.
+     */
+    formScreenIds?: readonly string[];
     /**
      * The node as the model wrote it, by the id the checked tree gives it
      * (AGL-3078), for a tree that was stored before it is checked: a page
@@ -472,6 +480,39 @@ export declare function isAiLinkElement(componentId: unknown): boolean;
  * a re-ask to inherit the band's contrast text or to set it.
  */
 export declare function detectInvisibleLinks(tree: AiDoctrineTree, outputKind: AiOutputKind): AiDoctrineViolation[];
+/**
+ * Whether a link's words ask a visitor to get in touch — contact, book, quote,
+ * request, order, pre-order, enquire — which the site's form answers
+ * (AGL-3729). The layout language sends such a link to the form.
+ */
+export declare function aiAsksToGetInTouch(label: string): boolean;
+/**
+ * RULE 10'S LINK SENT HOME, REPAIRED IN CODE (AGL-3729).
+ *
+ * The rule's own advice is "link the page that does, or leave the link out",
+ * and both halves are something code can do once it knows where the site's
+ * form is. A Free guided start's café (beta.243, 2026-10-12) put its contact
+ * and pre-order form on Home; its Menu page's "Request weekend pickup" was
+ * sent to Home, and the page was refused on every answer, since the
+ * destination was the compiler's, not the model's. So, before the check reads
+ * the tree, each link `detectUnrelatedScreenLinks` would refuse is:
+ *
+ * - repointed to the page that places the site's form, when its words ask a
+ *   visitor to get in touch and the site has such a page that is not the page
+ *   being checked (`formScreenIds`, `ownScreenIds`). The platform reaches a
+ *   section of another page by no anchor (AGL-2867), so the link names the
+ *   page; a link to a section of its own page is the Scroll to element
+ *   interaction, which this never writes;
+ * - otherwise left out: the node and everything under it are taken off the
+ *   page, and out of its parent's children.
+ *
+ * The root is never taken out. A tree with nothing to repair comes back as
+ * the same object; a node that is changed is copied, never edited in place.
+ */
+export declare function aiSettleUnrelatedScreenLinks<T extends AiDoctrineTree>(tree: T, outputKind: AiOutputKind, context?: Pick<AiDoctrineTreeContext, 'homeScreenIds' | 'formScreenIds'> & {
+    /** The page being checked, by every id it goes by: a link never goes to itself. */
+    ownScreenIds?: readonly string[];
+}): T;
 /**
  * Rule 10, for a link sent where the site has nothing for it (AGL-3056). A
  * link whose purpose the site has no screen for is left out; it never goes to
@@ -483,7 +524,7 @@ export declare function detectInvisibleLinks(tree: AiDoctrineTree, outputKind: A
  * not say home is refused, with a re-ask to link the screen that does what it
  * says, or to leave the link out.
  */
-export declare function detectUnrelatedScreenLinks(tree: AiDoctrineTree, outputKind: AiOutputKind, context?: Pick<AiDoctrineTreeContext, 'homeScreenIds'>): AiDoctrineViolation[];
+export declare function detectUnrelatedScreenLinks(tree: AiDoctrineTree, outputKind: AiOutputKind, context?: Pick<AiDoctrineTreeContext, 'homeScreenIds' | 'formScreenIds'>): AiDoctrineViolation[];
 /**
  * Rule 10, for a link that goes nowhere (AGL-3072). A Button or a Screen Link
  * goes where its `screenId` or its `href` says, and those are the only

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

@@ -1841,20 +1841,23 @@ const GRID = 'muiGrid';
     ];
 }
 /** A link's words that say it goes home. */ const HOME_WORDS = /\bhome(?:\s?page)?\b/i;
+/** Words that ask a visitor to get in touch, which the site's form answers. */ const GET_IN_TOUCH_WORDS = /\b(?:contact|book|booking|call|quote|estimate|appointment|schedule|reserve|reservation|get in touch|request|visit|enquire|inquire|enquiry|inquiry|message|talk|consult|consultation|order|pre-?order|sign up|join|apply|start)\b/i;
 /**
- * Rule 10, for a link sent where the site has nothing for it (AGL-3056). A
- * link whose purpose the site has no screen for is left out; it never goes to
- * a screen that does something else. The site inventory cannot say what each
- * screen is for, but it can name the one a model falls back to: a live About
- * page's footer sent "Request a Consultation" to the home screen, because the
- * site had no consultation screen. So a Screen Link or a Button, outside the
- * header and the navigation, that links the home screen with words that do
- * not say home is refused, with a re-ask to link the screen that does what it
- * says, or to leave the link out.
- */ export function detectUnrelatedScreenLinks(tree, outputKind, context = {}) {
-    var _context_homeScreenIds;
+ * Whether a link's words ask a visitor to get in touch — contact, book, quote,
+ * request, order, pre-order, enquire — which the site's form answers
+ * (AGL-3729). The layout language sends such a link to the form.
+ */ export function aiAsksToGetInTouch(label) {
+    return GET_IN_TOUCH_WORDS.test(label);
+}
+/**
+ * The links rule 10 refuses as sent home for nothing (`detectUnrelatedScreenLinks`),
+ * in document order. A link whose words ask a visitor to get in touch, sent to
+ * a home page that places the site's form, does what it says (AGL-3729).
+ */ function unrelatedScreenLinks(tree, outputKind, context) {
+    var _context_homeScreenIds, _context_formScreenIds;
     if (outputKind === 'email' || outputKind === 'form') return [];
     const home = new Set((_context_homeScreenIds = context.homeScreenIds) != null ? _context_homeScreenIds : []);
+    const forms = new Set((_context_formScreenIds = context.formScreenIds) != null ? _context_formScreenIds : []);
     const sent = [];
     for (const visit of walkTree(tree)){
         var _node_props, _node_props1, _node_props2;
@@ -1864,6 +1867,8 @@ const GRID = 'muiGrid';
         const linksHome = typeof screenId === 'string' && home.has(screenId) || ((_node_props1 = node.props) == null ? void 0 : _node_props1['href']) === '/';
         const label = typeof ((_node_props2 = node.props) == null ? void 0 : _node_props2['children']) === 'string' ? node.props['children'].trim() : '';
         if (!linksHome || !label || HOME_WORDS.test(label)) continue;
+        // Home holds the site's form, and the words ask for what it does (AGL-3729).
+        if (typeof screenId === 'string' && forms.has(screenId) && aiAsksToGetInTouch(label)) continue;
         // The header and the navigation link home by name and by the site's own brand.
         const inNavigation = hasAncestor(tree, visit, (ancestor)=>ancestor.componentId === 'muiAppBar' || [
                 'header',
@@ -1874,6 +1879,88 @@ const GRID = 'muiGrid';
             label
         });
     }
+    return sent;
+}
+/**
+ * RULE 10'S LINK SENT HOME, REPAIRED IN CODE (AGL-3729).
+ *
+ * The rule's own advice is "link the page that does, or leave the link out",
+ * and both halves are something code can do once it knows where the site's
+ * form is. A Free guided start's café (beta.243, 2026-10-12) put its contact
+ * and pre-order form on Home; its Menu page's "Request weekend pickup" was
+ * sent to Home, and the page was refused on every answer, since the
+ * destination was the compiler's, not the model's. So, before the check reads
+ * the tree, each link `detectUnrelatedScreenLinks` would refuse is:
+ *
+ * - repointed to the page that places the site's form, when its words ask a
+ *   visitor to get in touch and the site has such a page that is not the page
+ *   being checked (`formScreenIds`, `ownScreenIds`). The platform reaches a
+ *   section of another page by no anchor (AGL-2867), so the link names the
+ *   page; a link to a section of its own page is the Scroll to element
+ *   interaction, which this never writes;
+ * - otherwise left out: the node and everything under it are taken off the
+ *   page, and out of its parent's children.
+ *
+ * The root is never taken out. A tree with nothing to repair comes back as
+ * the same object; a node that is changed is copied, never edited in place.
+ */ export function aiSettleUnrelatedScreenLinks(tree, outputKind, context = {}) {
+    var _context_ownScreenIds, _find, _context_formScreenIds;
+    const sent = unrelatedScreenLinks(tree, outputKind, context);
+    if (!sent.length) return tree;
+    const own = new Set((_context_ownScreenIds = context.ownScreenIds) != null ? _context_ownScreenIds : []);
+    const formScreen = (_find = ((_context_formScreenIds = context.formScreenIds) != null ? _context_formScreenIds : []).find((id)=>!own.has(id))) != null ? _find : null;
+    const nodes = _extends({}, tree.nodes);
+    const parents = new Map();
+    for (const visit of walkTree(tree)){
+        const parent = visit.ancestors[visit.ancestors.length - 1];
+        if (parent !== undefined) parents.set(visit.id, parent);
+    }
+    for (const { id, label } of sent){
+        var _nodes_parent_nodes;
+        if (!nodes[id]) continue;
+        if (formScreen && aiAsksToGetInTouch(label)) {
+            var _nodes_id_props;
+            const props = _extends({}, (_nodes_id_props = nodes[id].props) != null ? _nodes_id_props : {}, {
+                screenId: formScreen
+            });
+            delete props['href'];
+            nodes[id] = _extends({}, nodes[id], {
+                props
+            });
+            continue;
+        }
+        const parent = parents.get(id);
+        if (parent === undefined || !nodes[parent]) continue;
+        nodes[parent] = _extends({}, nodes[parent], {
+            nodes: ((_nodes_parent_nodes = nodes[parent].nodes) != null ? _nodes_parent_nodes : []).filter((child)=>child !== id)
+        });
+        const stack = [
+            id
+        ];
+        while(stack.length){
+            var _ref;
+            var _nodes_next;
+            const next = stack.pop();
+            stack.push(...(_ref = (_nodes_next = nodes[next]) == null ? void 0 : _nodes_next.nodes) != null ? _ref : []);
+            delete nodes[next];
+        }
+    }
+    return _extends({}, tree, {
+        nodes
+    });
+}
+/**
+ * Rule 10, for a link sent where the site has nothing for it (AGL-3056). A
+ * link whose purpose the site has no screen for is left out; it never goes to
+ * a screen that does something else. The site inventory cannot say what each
+ * screen is for, but it can name the one a model falls back to: a live About
+ * page's footer sent "Request a Consultation" to the home screen, because the
+ * site had no consultation screen. So a Screen Link or a Button, outside the
+ * header and the navigation, that links the home screen with words that do
+ * not say home is refused, with a re-ask to link the screen that does what it
+ * says, or to leave the link out.
+ */ export function detectUnrelatedScreenLinks(tree, outputKind, context = {}) {
+    const sent = unrelatedScreenLinks(tree, outputKind, context);
     if (!sent.length) return [];
     return [
         {