@aglyn/plugins-ai 1.0.0-beta.246 → 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';
@@ -135,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;
 /**
@@ -240,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[]): {
@@ -265,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

@@ -300,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}`;
 }
@@ -565,8 +588,10 @@ const OPEN = [
         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;
+            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;
             const key = aiBuildBlocksKey(blocks);
@@ -691,5 +716,19 @@ function aiBuildBlocksKey(blocks) {
             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