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

package/src/lib/model/ai-build-event-page.d.ts

@@ -0,0 +1,70 @@
+/**
+ * @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 { AiDoctrineViolation } from '../runtime/ai-doctrine-validators';
+import type { AiBuildOps } from './ai-build-job';
+import { type AiBuildItem, type AiBuildPlan } from './ai-build-plan';
+/**
+ * THE PAGE A BUILD'S EVENTS ARE LISTED ON (AGL-3755).
+ *
+ * A build's `event` items are written as events, and an event is seen on the
+ * site only through an Event List a page section places — the section whose
+ * uses name the event. The live eval of 2026-10-13 asked "add our next three
+ * Friday night jazz shows at 8pm to an events page" of a site with only a
+ * Home page, and the plan made the three events and no page: they landed
+ * nowhere a visitor could see. So, settled in code where there is one right
+ * answer ({@link aiSettleBuildEventPage}), and re-asked where there is not
+ * ({@link aiBuildUnlistedEventsCheck}):
+ *
+ *  1. Events no section names, and a page the plan makes about them (its
+ *     address or title says events): the events are named in that page's
+ *     section about them, else its second section, else its first.
+ *  2. None such, the site has no page at `/events`, and the plan has room
+ *     for one more page: the plan gains an Events page at `/events`, linked
+ *     in the navigation and in the layout the other pages render in, whose
+ *     one section lists them.
+ *  3. Anything else — a site that already has an events page, a plan at its
+ *     page cap — is left to the plan's one re-ask, which names the events.
+ *
+ * Only the `event` operation: other placed operations keep their own rules.
+ */
+/** The operation whose items this settles; the events-calendar plugin's, named, never imported. */
+export declare const AI_BUILD_EVENT_OP = "event";
+/**
+ * The page a build adds for its events. Its address is the SITE's page,
+ * spelled from its title so it is never read as the console's Events page.
+ */
+export declare const AI_BUILD_EVENT_PAGE: {
+    readonly title: "Events";
+    readonly slug: `/${string}`;
+    readonly section: "Upcoming events";
+};
+/** The plan's event items that no page section names. */
+export declare function aiBuildUnlistedEvents(plan: Pick<AiBuildPlan, 'items' | 'screens'>): AiBuildItem[];
+export interface AiBuildEventPageContext {
+    /** The operations this site has; the settling runs only where it has `event`. */
+    ops: AiBuildOps | null;
+    /** The site's pages, by address. */
+    siteSlugs: readonly string[];
+    /** How many pages the build may plan. */
+    pageLimit: number;
+    /** The layout the site's pages render in (its home page's, else its one layout), or null. */
+    siteLayout: string | null;
+}
+/** A build plan with its unlisted events placed where there is one right answer; otherwise as it came. */
+export declare function aiSettleBuildEventPage<T extends AiBuildPlan>(plan: T, context: AiBuildEventPageContext): T;
+/** The re-ask for events the settling could not place: each named, and where to put it. */
+export declare function aiBuildUnlistedEventsCheck(ops: AiBuildOps | null): (plan: AiBuildPlan) => AiDoctrineViolation[];

package/src/lib/model/ai-build-event-page.js

@@ -0,0 +1,145 @@
+/**
+ * @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 { AI_BUILD_PLAN_LIMITS, aiPlanSlugKey } from "./ai-build-plan.js";
+/**
+ * THE PAGE A BUILD'S EVENTS ARE LISTED ON (AGL-3755).
+ *
+ * A build's `event` items are written as events, and an event is seen on the
+ * site only through an Event List a page section places — the section whose
+ * uses name the event. The live eval of 2026-10-13 asked "add our next three
+ * Friday night jazz shows at 8pm to an events page" of a site with only a
+ * Home page, and the plan made the three events and no page: they landed
+ * nowhere a visitor could see. So, settled in code where there is one right
+ * answer ({@link aiSettleBuildEventPage}), and re-asked where there is not
+ * ({@link aiBuildUnlistedEventsCheck}):
+ *
+ *  1. Events no section names, and a page the plan makes about them (its
+ *     address or title says events): the events are named in that page's
+ *     section about them, else its second section, else its first.
+ *  2. None such, the site has no page at `/events`, and the plan has room
+ *     for one more page: the plan gains an Events page at `/events`, linked
+ *     in the navigation and in the layout the other pages render in, whose
+ *     one section lists them.
+ *  3. Anything else — a site that already has an events page, a plan at its
+ *     page cap — is left to the plan's one re-ask, which names the events.
+ *
+ * Only the `event` operation: other placed operations keep their own rules.
+ */ /** The operation whose items this settles; the events-calendar plugin's, named, never imported. */ export const AI_BUILD_EVENT_OP = 'event';
+const EVENT_PAGE_TITLE = 'Events';
+/**
+ * The page a build adds for its events. Its address is the SITE's page,
+ * spelled from its title so it is never read as the console's Events page.
+ */ export const AI_BUILD_EVENT_PAGE = {
+    title: EVENT_PAGE_TITLE,
+    slug: `/${EVENT_PAGE_TITLE.toLowerCase()}`,
+    section: 'Upcoming events'
+};
+/** A page or section that is about events. */ const ABOUT_EVENTS = /\b(events?|calendar|upcoming|what'?s on|shows?|gigs?|schedule|classes|workshops?)\b/i;
+const refOf = (item)=>`new:${item.name}`;
+/** The plan's event items that no page section names. */ export function aiBuildUnlistedEvents(plan) {
+    var _plan_items;
+    const uses = new Set(plan.screens.flatMap((screen)=>screen.sections.flatMap((section)=>section.uses.map((ref)=>ref.trim().toLowerCase()))));
+    return ((_plan_items = plan.items) != null ? _plan_items : []).filter((item)=>item.op === AI_BUILD_EVENT_OP && !uses.has(refOf(item).trim().toLowerCase()));
+}
+/** Whether a planned page is about events: its address or its title says so. */ function aboutEvents(screen) {
+    var _screen_slug_trim_replace_split_;
+    const first = (_screen_slug_trim_replace_split_ = screen.slug.trim().replace(/^\/+/, '').split('/')[0]) != null ? _screen_slug_trim_replace_split_ : '';
+    return first !== '' && ABOUT_EVENTS.test(`${first.replace(/-/g, ' ')} ${screen.title}`);
+}
+/** The section of an events page that lists them: the one named for them, else its second, else its first. */ function listingSection(screen) {
+    const named = screen.sections.findIndex((section)=>ABOUT_EVENTS.test(section.name));
+    if (named !== -1) return named;
+    return screen.sections.length > 1 ? 1 : 0;
+}
+/** A build plan with its unlisted events placed where there is one right answer; otherwise as it came. */ export function aiSettleBuildEventPage(plan, context) {
+    var _ref;
+    var _context_ops, _plan_screens_find;
+    if (!((_context_ops = context.ops) == null ? void 0 : _context_ops.has(AI_BUILD_EVENT_OP))) return plan;
+    const unlisted = aiBuildUnlistedEvents(plan);
+    if (!unlisted.length) return plan;
+    const refs = unlisted.map(refOf);
+    // 1. A page the plan makes about them lists them.
+    const page = plan.screens.findIndex((screen)=>!screen.record && screen.sections.length && aboutEvents(screen));
+    if (page !== -1) {
+        const screen = plan.screens[page];
+        const at = listingSection(screen);
+        const section = screen.sections[at];
+        if (!section || section.uses.length + refs.length > AI_BUILD_PLAN_LIMITS.uses) return plan;
+        const sections = screen.sections.map((one, index)=>index === at ? _extends({}, one, {
+                uses: [
+                    ...one.uses,
+                    ...refs
+                ]
+            }) : one);
+        return _extends({}, plan, {
+            screens: plan.screens.map((one, index)=>index === page ? _extends({}, screen, {
+                    sections
+                }) : one)
+        });
+    }
+    // 2. An Events page of its own, where the address is free and the plan has room.
+    const taken = new Set([
+        ...context.siteSlugs,
+        ...plan.screens.map((screen)=>screen.slug)
+    ].map(aiPlanSlugKey));
+    if (taken.has(aiPlanSlugKey(AI_BUILD_EVENT_PAGE.slug)) || plan.screens.length >= context.pageLimit) return plan;
+    if (refs.length > AI_BUILD_PLAN_LIMITS.uses) return plan;
+    const names = unlisted.map((item)=>item.name);
+    const listed = names.length === 1 ? names[0] : `${names.slice(0, -1).join(', ')} and ${names[names.length - 1]}`;
+    const events = {
+        title: AI_BUILD_EVENT_PAGE.title,
+        slug: AI_BUILD_EVENT_PAGE.slug,
+        // The layout the plan's other pages render in, else the site's.
+        layout: (_ref = (_plan_screens_find = plan.screens.find((screen)=>screen.layout)) == null ? void 0 : _plan_screens_find.layout) != null ? _ref : context.siteLayout,
+        template: null,
+        duplicateOf: null,
+        nav: true,
+        seoTitle: AI_BUILD_EVENT_PAGE.title,
+        seoDescription: `Upcoming events: ${listed}.`.slice(0, AI_BUILD_PLAN_LIMITS.seoDescription),
+        sections: [
+            {
+                name: AI_BUILD_EVENT_PAGE.section,
+                uses: refs,
+                items: 0
+            }
+        ],
+        record: null
+    };
+    return _extends({}, plan, {
+        screens: [
+            ...plan.screens,
+            events
+        ]
+    });
+}
+/** The re-ask for events the settling could not place: each named, and where to put it. */ export function aiBuildUnlistedEventsCheck(ops) {
+    return (plan)=>{
+        if (!(ops == null ? void 0 : ops.has(AI_BUILD_EVENT_OP))) return [];
+        const unlisted = aiBuildUnlistedEvents(plan);
+        if (!unlisted.length) return [];
+        const named = unlisted.map((item)=>`new:${item.name}`).join(', ');
+        return [
+            {
+                rule: null,
+                code: 'plan-job-shape',
+                message: `The events ${named} are listed on no page, so no visitor would see them. Put each in the uses of the section that lists the events, on the page the request names for them or a page about events this plan makes.`
+            }
+        ];
+    };
+}
+
+//# sourceMappingURL=ai-build-event-page.js.map

package/src/lib/model/ai-build-event-page.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/model/ai-build-event-page.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 { AiDoctrineViolation } from '../runtime/ai-doctrine-validators'\nimport type { AiBuildOps } from './ai-build-job'\nimport {\n  AI_BUILD_PLAN_LIMITS,\n  aiPlanSlugKey,\n  type AiBuildItem,\n  type AiBuildPlan,\n  type AiBuildPlanScreen,\n} from './ai-build-plan'\n\n/**\n * THE PAGE A BUILD'S EVENTS ARE LISTED ON (AGL-3755).\n *\n * A build's `event` items are written as events, and an event is seen on the\n * site only through an Event List a page section places — the section whose\n * uses name the event. The live eval of 2026-10-13 asked \"add our next three\n * Friday night jazz shows at 8pm to an events page\" of a site with only a\n * Home page, and the plan made the three events and no page: they landed\n * nowhere a visitor could see. So, settled in code where there is one right\n * answer ({@link aiSettleBuildEventPage}), and re-asked where there is not\n * ({@link aiBuildUnlistedEventsCheck}):\n *\n *  1. Events no section names, and a page the plan makes about them (its\n *     address or title says events): the events are named in that page's\n *     section about them, else its second section, else its first.\n *  2. None such, the site has no page at `/events`, and the plan has room\n *     for one more page: the plan gains an Events page at `/events`, linked\n *     in the navigation and in the layout the other pages render in, whose\n *     one section lists them.\n *  3. Anything else — a site that already has an events page, a plan at its\n *     page cap — is left to the plan's one re-ask, which names the events.\n *\n * Only the `event` operation: other placed operations keep their own rules.\n */\n\n/** The operation whose items this settles; the events-calendar plugin's, named, never imported. */\nexport const AI_BUILD_EVENT_OP = 'event'\n\nconst EVENT_PAGE_TITLE = 'Events'\n\n/**\n * The page a build adds for its events. Its address is the SITE's page,\n * spelled from its title so it is never read as the console's Events page.\n */\nexport const AI_BUILD_EVENT_PAGE = {\n  title: EVENT_PAGE_TITLE,\n  slug: `/${EVENT_PAGE_TITLE.toLowerCase()}`,\n  section: 'Upcoming events',\n} as const\n\n/** A page or section that is about events. */\nconst ABOUT_EVENTS = /\\b(events?|calendar|upcoming|what'?s on|shows?|gigs?|schedule|classes|workshops?)\\b/i\n\nconst refOf = (item: Pick<AiBuildItem, 'name'>) => `new:${item.name}`\n\n/** The plan's event items that no page section names. */\nexport function aiBuildUnlistedEvents(plan: Pick<AiBuildPlan, 'items' | 'screens'>): AiBuildItem[] {\n  const uses = new Set(\n    plan.screens.flatMap((screen) => screen.sections.flatMap((section) => section.uses.map((ref) => ref.trim().toLowerCase()))),\n  )\n  return (plan.items ?? []).filter((item) => item.op === AI_BUILD_EVENT_OP && !uses.has(refOf(item).trim().toLowerCase()))\n}\n\n/** Whether a planned page is about events: its address or its title says so. */\nfunction aboutEvents(screen: Pick<AiBuildPlanScreen, 'slug' | 'title'>): boolean {\n  const first = screen.slug.trim().replace(/^\\/+/, '').split('/')[0] ?? ''\n  return first !== '' && ABOUT_EVENTS.test(`${first.replace(/-/g, ' ')} ${screen.title}`)\n}\n\n/** The section of an events page that lists them: the one named for them, else its second, else its first. */\nfunction listingSection(screen: AiBuildPlanScreen): number {\n  const named = screen.sections.findIndex((section) => ABOUT_EVENTS.test(section.name))\n  if (named !== -1) return named\n  return screen.sections.length > 1 ? 1 : 0\n}\n\nexport interface AiBuildEventPageContext {\n  /** The operations this site has; the settling runs only where it has `event`. */\n  ops: AiBuildOps | null\n  /** The site's pages, by address. */\n  siteSlugs: readonly string[]\n  /** How many pages the build may plan. */\n  pageLimit: number\n  /** The layout the site's pages render in (its home page's, else its one layout), or null. */\n  siteLayout: string | null\n}\n\n/** A build plan with its unlisted events placed where there is one right answer; otherwise as it came. */\nexport function aiSettleBuildEventPage<T extends AiBuildPlan>(plan: T, context: AiBuildEventPageContext): T {\n  if (!context.ops?.has(AI_BUILD_EVENT_OP)) return plan\n  const unlisted = aiBuildUnlistedEvents(plan)\n  if (!unlisted.length) return plan\n  const refs = unlisted.map(refOf)\n  // 1. A page the plan makes about them lists them.\n  const page = plan.screens.findIndex((screen) => !screen.record && screen.sections.length && aboutEvents(screen))\n  if (page !== -1) {\n    const screen = plan.screens[page] as AiBuildPlanScreen\n    const at = listingSection(screen)\n    const section = screen.sections[at]\n    if (!section || section.uses.length + refs.length > AI_BUILD_PLAN_LIMITS.uses) return plan\n    const sections = screen.sections.map((one, index) => (index === at ? { ...one, uses: [...one.uses, ...refs] } : one))\n    return { ...plan, screens: plan.screens.map((one, index) => (index === page ? { ...screen, sections } : one)) }\n  }\n  // 2. An Events page of its own, where the address is free and the plan has room.\n  const taken = new Set([...context.siteSlugs, ...plan.screens.map((screen) => screen.slug)].map(aiPlanSlugKey))\n  if (taken.has(aiPlanSlugKey(AI_BUILD_EVENT_PAGE.slug)) || plan.screens.length >= context.pageLimit) return plan\n  if (refs.length > AI_BUILD_PLAN_LIMITS.uses) return plan\n  const names = unlisted.map((item) => item.name)\n  const listed = names.length === 1 ? names[0] : `${names.slice(0, -1).join(', ')} and ${names[names.length - 1]}`\n  const events: AiBuildPlanScreen = {\n    title: AI_BUILD_EVENT_PAGE.title,\n    slug: AI_BUILD_EVENT_PAGE.slug,\n    // The layout the plan's other pages render in, else the site's.\n    layout: plan.screens.find((screen) => screen.layout)?.layout ?? context.siteLayout,\n    template: null,\n    duplicateOf: null,\n    nav: true,\n    seoTitle: AI_BUILD_EVENT_PAGE.title,\n    seoDescription: `Upcoming events: ${listed}.`.slice(0, AI_BUILD_PLAN_LIMITS.seoDescription),\n    sections: [{ name: AI_BUILD_EVENT_PAGE.section, uses: refs, items: 0 }],\n    record: null,\n  }\n  return { ...plan, screens: [...plan.screens, events] }\n}\n\n/** The re-ask for events the settling could not place: each named, and where to put it. */\nexport function aiBuildUnlistedEventsCheck(ops: AiBuildOps | null): (plan: AiBuildPlan) => AiDoctrineViolation[] {\n  return (plan) => {\n    if (!ops?.has(AI_BUILD_EVENT_OP)) return []\n    const unlisted = aiBuildUnlistedEvents(plan)\n    if (!unlisted.length) return []\n    const named = unlisted.map((item) => `new:${item.name}`).join(', ')\n    return [\n      {\n        rule: null,\n        code: 'plan-job-shape',\n        message: `The events ${named} are listed on no page, so no visitor would see them. Put each in the uses of the section that lists the events, on the page the request names for them or a page about events this plan makes.`,\n      },\n    ]\n  }\n}\n"],"names":["AI_BUILD_PLAN_LIMITS","aiPlanSlugKey","AI_BUILD_EVENT_OP","EVENT_PAGE_TITLE","AI_BUILD_EVENT_PAGE","title","slug","toLowerCase","section","ABOUT_EVENTS","refOf","item","name","aiBuildUnlistedEvents","plan","uses","Set","screens","flatMap","screen","sections","map","ref","trim","items","filter","op","has","aboutEvents","first","replace","split","test","listingSection","named","findIndex","length","aiSettleBuildEventPage","context","ops","unlisted","refs","page","record","at","one","index","taken","siteSlugs","pageLimit","names","listed","slice","join","events","layout","find","siteLayout","template","duplicateOf","nav","seoTitle","seoDescription","aiBuildUnlistedEventsCheck","rule","code","message"],"mappings":"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"}

package/src/lib/model/ai-build-job.d.ts

@@ -15,6 +15,7 @@
  * limitations under the License.
  */
 import { type PluginAiCapability } from '@aglyn/aglyn/plugin-manager/plugin-ai-capabilities';
+import type { PluginDraftRecord } from '@aglyn/aglyn/plugin-manager/plugin-resource-drafts';
 import { type AiBuildItem, type AiBuildPlan, type AiBuildPlanCreate, type AiBuildPlanCreateKind, type AiBuildPlanScreen } from './ai-build-plan';
 import type { AiJobItemLedger } from './ai-jobs.types';
 import { type AiCreditRange, type AiCreditsSmaller } from './ai-credit-estimate';
@@ -59,6 +60,22 @@ export declare const AI_BUILD_CREATE_KINDS: readonly AiBuildPlanCreateKind[];
  * `items`: an item naming one is a plan that put it in the wrong list.
  */
 export declare const AI_BUILD_STRUCTURAL_OPS: readonly string[];
+/**
+ * What a build hands an item it made before it (AGL-3728): its pages, by the
+ * title the plan gave each and the id it was written under, and its layouts,
+ * by name. An item's `new:<title>` destinations are read against it.
+ */
+export declare const AI_BUILD_MADE_INPUT = "buildMade";
+export interface AiBuildMade {
+    pages: Array<{
+        title: string;
+        id: string;
+    }>;
+    layouts: Array<{
+        name: string;
+        id: string;
+    }>;
+}
 /** The job input a build's Assist proposal sets when the brief asked to publish. */
 export declare const AI_BUILD_PUBLISH_INPUT = "publish";
 /** A unit of a build: a creation, a page, or an item. */
@@ -75,6 +92,13 @@ export interface AiBuildUnit {
 }
 /** The name a `new:<name>` reference gives, lowercased. */
 export declare function aiBuildRefName(ref: string): string;
+/**
+ * The `new:<name>` references an item's arguments make (AGL-3728): an
+ * argument that is one, or the destination after `=>` in an entry such as a
+ * menu item's `About => new:About`. Read from the arguments, never from the
+ * model's `dependsOn`, so what an item links is always built before it.
+ */
+export declare function aiBuildItemArgRefs(args: Readonly<Record<string, unknown>> | null | undefined): string[];
 /** Every reference a page makes: its layout, template, starting page and what its sections place. */
 export declare function aiBuildScreenRefs(screen: AiBuildPlanScreen): string[];
 /**
@@ -112,6 +136,16 @@ export declare function aiBuildPlanShapeRefusal(plan: AiBuildPlan, options?: {
     freeTaste?: boolean;
     ops?: AiBuildOps;
 }): string | null;
+/**
+ * What the person must still say before this plan can be built, as the
+ * questions its operations ask (`missingInput`), or `null` when nothing is
+ * missing: an item the planner kept with nothing it may build from — a
+ * tracking change naming no id, AGL-3751 — is asked about, never built
+ * empty or from a value the planner made up. Not a plan rule: a re-ask
+ * cannot supply what only the person knows, so the plan is not kept and
+ * the build answers with the question.
+ */
+export declare function aiBuildPlanMissingInput(plan: AiBuildPlan, ops: AiBuildOps | null | undefined): string | null;
 /** "a booking service", "an email design". */
 export declare function aiArticle(noun: string): string;
 /**
@@ -217,6 +251,8 @@ export declare function aiBuildPlacedItemLines(unit: AiBuildUnit, context: {
     units: readonly AiBuildUnit[];
     ledger: readonly AiJobItemLedger[];
     ops?: AiBuildOps;
+    /** Operations whose items the platform places itself (a listing), so the page is told nothing of them. */
+    placedByCode?: readonly string[];
 }): string[];
 /** What a build came to: whether anything was delivered, and whether anything is left. */
 export declare function aiBuildSettlement(ledger: readonly AiJobItemLedger[]): {
@@ -242,3 +278,11 @@ export declare function aiBuildRetryLedger(ledger: readonly AiJobItemLedger[], u
  * page built after the layouts and forms the ledger holds.
  */
 export declare function aiLedgerUnits(ledger: readonly AiJobItemLedger[]): AiBuildUnit[];
+/**
+ * What the job drawer says under an item another plugin's writer made: a
+ * draft, or, for setup its writer saves live (`live`, a CRM pipeline or
+ * field, AGL-3746), that it was saved. A writer that went live only when the
+ * member may (an event the publishing role publishes, AGL-3755) reports
+ * `live: false` for one it kept as a draft, with its `notice` saying why.
+ */
+export declare function aiBuildItemOutputNote(capability: Pick<PluginAiCapability, 'where' | 'live'>, written?: Pick<PluginDraftRecord, 'live' | 'notice'>): string;

package/src/lib/model/ai-build-job.js

@@ -65,6 +65,11 @@ import { AI_CREDIT_RANGE_ZERO, AI_MEASURED_PASS_CREDITS, aiCreditRangeAdd, aiCre
     'page',
     ...AI_BUILD_CREATE_KINDS
 ];
+/**
+ * What a build hands an item it made before it (AGL-3728): its pages, by the
+ * title the plan gave each and the id it was written under, and its layouts,
+ * by name. An item's `new:<title>` destinations are read against it.
+ */ export const AI_BUILD_MADE_INPUT = 'buildMade';
 /** The job input a build's Assist proposal sets when the brief asked to publish. */ export const AI_BUILD_PUBLISH_INPUT = 'publish';
 /** The operation a creation is built as. */ function creationOp(creation) {
     return creation.kind;
@@ -81,6 +86,30 @@ import { AI_CREDIT_RANGE_ZERO, AI_MEASURED_PASS_CREDITS, aiCreditRangeAdd, aiCre
 /** The name a `new:<name>` reference gives, lowercased. */ export function aiBuildRefName(ref) {
     return ref.slice(AI_PLAN_NEW_REF_PREFIX.length).trim().toLowerCase();
 }
+/**
+ * The `new:<name>` references an item's arguments make (AGL-3728): an
+ * argument that is one, or the destination after `=>` in an entry such as a
+ * menu item's `About => new:About`. Read from the arguments, never from the
+ * model's `dependsOn`, so what an item links is always built before it.
+ */ export function aiBuildItemArgRefs(args) {
+    const refs = [];
+    const take = (value)=>{
+        var _value_split_slice_;
+        if (typeof value !== 'string') return;
+        for (const part of [
+            value,
+            (_value_split_slice_ = value.split('=>').slice(-1)[0]) != null ? _value_split_slice_ : ''
+        ]){
+            const ref = part.trim();
+            if (isAiPlanNewRef(ref) && !refs.includes(ref)) refs.push(ref);
+        }
+    };
+    for (const value of Object.values(args != null ? args : {})){
+        if (Array.isArray(value)) value.forEach(take);
+        else take(value);
+    }
+    return refs;
+}
 /** Every reference a page makes: its layout, template, starting page and what its sections place. */ export function aiBuildScreenRefs(screen) {
     return [
         screen.layout,
@@ -97,11 +126,19 @@ import { AI_CREDIT_RANGE_ZERO, AI_MEASURED_PASS_CREDITS, aiCreditRangeAdd, aiCre
  */ export function aiBuildUnits(plan) {
     var _plan_items;
     const slots = namedSlots(plan);
-    const depsOf = (refs, self)=>{
+    // A page, by the title the plan gave it: what an item's arguments may link
+    // as `new:<title>` (a menu item, AGL-3728), built before the item.
+    const pageSlots = new Map();
+    plan.screens.forEach((screen, index)=>{
+        const title = screen.title.trim().toLowerCase();
+        if (title && !pageSlots.has(title)) pageSlots.set(title, `p${index}`);
+    });
+    const depsOf = (refs, self, pages = false)=>{
         const deps = [];
         for (const ref of refs){
+            var _slots_get;
             if (!isAiPlanNewRef(ref)) continue;
-            const slot = slots.get(aiBuildRefName(ref));
+            const slot = (_slots_get = slots.get(aiBuildRefName(ref))) != null ? _slots_get : pages ? pageSlots.get(aiBuildRefName(ref)) : undefined;
             if (slot && slot !== self && !deps.includes(slot)) deps.push(slot);
         }
         return deps;
@@ -129,7 +166,11 @@ import { AI_CREDIT_RANGE_ZERO, AI_MEASURED_PASS_CREDITS, aiCreditRangeAdd, aiCre
             op: item.op,
             label: item.name,
             item,
-            deps: depsOf(item.dependsOn, item.slot)
+            // What it depends on, and what its arguments link as `new:` (AGL-3728).
+            deps: depsOf([
+                ...item.dependsOn,
+                ...aiBuildItemArgRefs(item.args)
+            ], item.slot, true)
         });
     }
     plan.screens.forEach((screen, index)=>{
@@ -259,6 +300,29 @@ import { AI_CREDIT_RANGE_ZERO, AI_MEASURED_PASS_CREDITS, aiCreditRangeAdd, aiCre
     }
     return null;
 }
+/**
+ * What the person must still say before this plan can be built, as the
+ * questions its operations ask (`missingInput`), or `null` when nothing is
+ * missing: an item the planner kept with nothing it may build from — a
+ * tracking change naming no id, AGL-3751 — is asked about, never built
+ * empty or from a value the planner made up. Not a plan rule: a re-ask
+ * cannot supply what only the person knows, so the plan is not kept and
+ * the build answers with the question.
+ */ export function aiBuildPlanMissingInput(plan, ops) {
+    var _plan_items;
+    if (!ops) return null;
+    const questions = [];
+    for (const item of (_plan_items = plan.items) != null ? _plan_items : []){
+        var _ops_get_missingInput, _ops_get;
+        const question = (_ops_get = ops.get(item.op)) == null ? void 0 : (_ops_get_missingInput = _ops_get.missingInput) == null ? void 0 : _ops_get_missingInput.call(_ops_get, {
+            name: item.name,
+            why: item.why,
+            args: item.args
+        });
+        if (question && !questions.includes(question)) questions.push(question);
+    }
+    return questions.length ? questions.join(' ') : null;
+}
 /** "a booking service", "an email design". */ export function aiArticle(noun) {
     return `${/^[aeiou]/i.test(noun) ? 'an' : 'a'} ${noun}`;
 }
@@ -477,9 +541,21 @@ const OPEN = [
             continue;
         }
         if (unit.screen) {
-            var _capability_pageBlocks;
+            var _capability_pageBlocks, _capability_pageBlocks1;
             const section = unit.screen.sections.find((one)=>one.uses.some((ref)=>isAiPlanNewRef(ref) && aiBuildRefName(ref) === dep.label.toLowerCase()));
-            const blocks = (capability == null ? void 0 : (_capability_pageBlocks = capability.pageBlocks) == null ? void 0 : _capability_pageBlocks.length) ? ` the ${capability.pageBlocks.join(' or ')} block` : '';
+            // Another item this section places with the same block was built (one
+            // of several events, AGL-3743): the block stays, and only this item is
+            // missing from what it shows.
+            const blockStays = Boolean(section && (capability == null ? void 0 : (_capability_pageBlocks = capability.pageBlocks) == null ? void 0 : _capability_pageBlocks.length) && aiBuildSectionDeliveredBlocks(section, _extends({}, context, {
+                rows,
+                except: slot
+            })).has(aiBuildBlocksKey(capability.pageBlocks)));
+            if (blockStays) {
+                result.notes.push(`Built without the ${noun} “${dep.label}”: it could not be created.`);
+                result.briefLines.push(`Leave the ${noun} “${dep.label}” out of the “${section == null ? void 0 : section.name}” section: it could not be created.`);
+                continue;
+            }
+            const blocks = (capability == null ? void 0 : (_capability_pageBlocks1 = capability.pageBlocks) == null ? void 0 : _capability_pageBlocks1.length) ? ` the ${capability.pageBlocks.join(' or ')} block` : '';
             result.notes.push(`Built without${blocks || ` the ${noun}`}: the ${noun} “${dep.label}” could not be created.`);
             result.briefLines.push(`${section ? `Build the “${section.name}” section` : 'Build the page'} without the ${noun} “${dep.label}”${blocks ? ` and without${blocks}` : ''}: it could not be created.`);
         } else {
@@ -507,22 +583,60 @@ const OPEN = [
         ]));
     const lines = [];
     for (const section of unit.screen.sections){
-        for (const ref of section.uses){
-            var _ref, _ref1;
-            var _context_ops;
-            if (!isAiPlanNewRef(ref)) continue;
-            const dep = context.units.find((one)=>one.item && one.item.name.toLowerCase() === aiBuildRefName(ref));
-            if (!(dep == null ? void 0 : dep.item)) continue;
+        // One line per block a section places, naming every built item it shows:
+        // a section listing four events places the Event List once (AGL-3743).
+        const placed = new Map();
+        for (const { dep, capability } of aiBuildSectionItems(section, context.units, context.ops)){
+            var _ref, _placed_get, _ref1;
+            var _context_placedByCode;
             const row = rows.get(dep.slot);
             if (!row || !aiBuildItemDelivered(row)) continue;
-            const capability = (_context_ops = context.ops) == null ? void 0 : _context_ops.get(dep.op);
+            if ((_context_placedByCode = context.placedByCode) == null ? void 0 : _context_placedByCode.includes(dep.op)) continue;
             const blocks = (_ref = capability == null ? void 0 : capability.pageBlocks) != null ? _ref : [];
             if (!blocks.length) continue;
-            lines.push(`In the “${section.name}” section, place the ${blocks.join(' or ')} block for the ${(_ref1 = capability == null ? void 0 : capability.noun) != null ? _ref1 : dep.op} “${dep.label}”.`);
+            const key = aiBuildBlocksKey(blocks);
+            const entry = (_placed_get = placed.get(key)) != null ? _placed_get : {
+                blocks,
+                noun: (_ref1 = capability == null ? void 0 : capability.noun) != null ? _ref1 : dep.op,
+                labels: []
+            };
+            entry.labels.push(`“${dep.label}”`);
+            placed.set(key, entry);
+        }
+        for (const { blocks, noun, labels } of placed.values()){
+            const named = labels.length === 1 ? `the ${noun} ${labels[0]}` : `the ${noun}s ${labels.slice(0, -1).join(', ')} and ${labels[labels.length - 1]}`;
+            lines.push(`In the “${section.name}” section, place the ${blocks.join(' or ')} block for ${named}.`);
         }
     }
     return lines;
 }
+/** The items a page section places, each with its capability, in the order its uses name them. */ function aiBuildSectionItems(section, units, ops) {
+    const found = [];
+    for (const ref of section.uses){
+        if (!isAiPlanNewRef(ref)) continue;
+        const dep = units.find((one)=>one.item && one.item.name.toLowerCase() === aiBuildRefName(ref));
+        if (dep == null ? void 0 : dep.item) found.push({
+            dep,
+            capability: ops == null ? void 0 : ops.get(dep.op)
+        });
+    }
+    return found;
+}
+/** The blocks a section's built items place, each set as one key; `except` leaves one item out. */ function aiBuildSectionDeliveredBlocks(section, context) {
+    const keys = new Set();
+    for (const { dep, capability } of aiBuildSectionItems(section, context.units, context.ops)){
+        var _capability_pageBlocks;
+        if (dep.slot === context.except || !(capability == null ? void 0 : (_capability_pageBlocks = capability.pageBlocks) == null ? void 0 : _capability_pageBlocks.length)) continue;
+        const row = context.rows.get(dep.slot);
+        if (row && aiBuildItemDelivered(row)) keys.add(aiBuildBlocksKey(capability.pageBlocks));
+    }
+    return keys;
+}
+function aiBuildBlocksKey(blocks) {
+    return [
+        ...blocks
+    ].sort().join('|');
+}
 /** What a build came to: whether anything was delivered, and whether anything is left. */ export function aiBuildSettlement(ledger) {
     return {
         delivered: ledger.some(aiBuildItemDelivered),
@@ -602,5 +716,19 @@ const OPEN = [
             deps: row.op === 'page' ? creations : []
         }));
 }
+/**
+ * What the job drawer says under an item another plugin's writer made: a
+ * draft, or, for setup its writer saves live (`live`, a CRM pipeline or
+ * field, AGL-3746), that it was saved. A writer that went live only when the
+ * member may (an event the publishing role publishes, AGL-3755) reports
+ * `live: false` for one it kept as a draft, with its `notice` saying why.
+ */ export function aiBuildItemOutputNote(capability, written) {
+    var _ref;
+    var _written_notice;
+    const live = (_ref = written == null ? void 0 : written.live) != null ? _ref : capability.live;
+    const said = live ? `Live now, in ${capability.where}.` : `A draft, in ${capability.where}.`;
+    const notice = written == null ? void 0 : (_written_notice = written.notice) == null ? void 0 : _written_notice.trim();
+    return notice ? `${said} ${notice}` : said;
+}
 
 //# sourceMappingURL=ai-build-job.js.map