@aglyn/plugins-ai 1.0.0-beta.263 → 1.0.0-beta.266

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

@@ -15,6 +15,8 @@ import { _ as _extends } from "@swc/helpers/_/_extends";
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */ import { aiSiteKindOfInputs } from "../model/ai-site-kinds.js";
+import { aiSiteHomeArc, aiSiteHomeArcSentence } from "../model/ai-site-home-arcs.js";
+import { aiSiteSeed } from "../model/ai-site-look.js";
 import { createHash } from "node:crypto";
 import { AI_BUILD_PLAN_TOOL, aiBuildPlanToolFor, aiPlanSlugKey, isAiPlanNewRef } from "../model/ai-build-plan.js";
 import { AI_BUILD_PRODUCT_OP, aiBuildStorePagesFor } from "../model/ai-build-store-pages.js";
@@ -23,7 +25,7 @@ import { AI_TEMPLATE_SUBJECT_DEFINITIONS, aiTemplateShownTokens } from "../model
 import { AI_JOB_CREATE_KINDS, AI_JOB_CREATE_NOUNS } from "../model/ai-job-creations.js";
 import { AI_PAGE_CREATE_KINDS, aiPagePlanShapeRefusal } from "../model/ai-page-job.js";
 import { AI_PLAN_COMPILED_REPEATS_SENTENCE, AI_PLAN_NO_FORM_SENTENCE, aiPlanCanPlaceForm, aiPlanCapabilitiesForJob, aiPlanCapabilityLines } from "../model/ai-plan-capabilities.js";
-import { aiSitePlanDatasetCapability } from "./ai-job-site-datasets.js";
+import { aiSettleSiteForeignDatasets, aiSiteInventoryWithRecordCounts, aiSitePlanDatasetCapability } from "./ai-job-site-datasets.js";
 import { AI_FREE_SITE_WORST_CASE_CREDITS, AI_SITE_CREATE_KINDS, AI_SITE_FREE_PAGES, AI_SITE_FREE_POSTS, AI_SITE_PLAN_MAX_TOKENS, AI_SITE_HOME_BANDS, aiFreeSiteSectionsWithin, aiSiteFullPlanSentence, aiSiteHomeMinSections, aiSiteNameSentence, aiSitePlanIsHome, aiSitePlanShapeRefusal, aiSiteBlogStandInViolations, aiSiteThinHomeViolations, AI_SITE_GALLERY_SENTENCE, aiSiteEmptyGalleryViolations, AI_SITE_DATASETS_MAX, AI_SITE_GALLERY_MIN_ITEMS } from "../model/ai-site-job.js";
 import { aiSiteContentPart } from "./ai-job-site-content.js";
 import { aiPlanHasCustomerWords, aiSettlePlanPlaceholderNames, aiSettlePlanSaidSections } from "../model/ai-plan-said-sections.js";
@@ -35,7 +37,7 @@ import { aiPlanFailureCopy, aiPlanRetryRefusal } from "../model/ai-job-failure-c
 import { FREE_AI_TASTE_CREDITS_PER_MONTH } from "../plan-entitlements.js";
 import { aiDoctrineSystemBlocks, runValidatedGeneration } from "../runtime/ai-doctrine.js";
 import { AI_STEP_TIERS, aiCatalogEntry, aiDefaultModelFor } from "../providers/catalog.js";
-import { AI_FREE_PAGE_WORST_CASE_CREDITS, aiPlanEmbedBriefViolations } from "../runtime/ai-doctrine-validators.js";
+import { AI_FREE_PAGE_WORST_CASE_CREDITS, aiPlanEmbedBriefViolations, aiSettlePlanDatasets, aiSettlePlanHomeForms } from "../runtime/ai-doctrine-validators.js";
 import { assistCreditsFromUsd } from "../usage/assist-credits.js";
 import { ASSIST_RETURNED_USD_FIELD, assistSpendAfterReturnsUsd } from "../usage/assist-credit-returns.js";
 import { freeAccountUsageRef, freeAssistAccount } from "../usage/assist-free-taste.js";
@@ -53,7 +55,7 @@ import { readAiPlanCapabilities } from "./ai-job-drafts.js";
 import { AI_JOB_BRIEF_MAX_CHARS } from "./ai-job-text-step.js";
 import { aiJobStepBudget } from "./ai-job-budget.js";
 import { aiDoctrineReview, aiUnspentOutcome } from "./ai-job-generation.js";
-import { aiPlanWithDraftIds } from "./ai-job-draft-ids.js";
+import { aiOriginJobId, aiPlanWithDraftIds } from "./ai-job-draft-ids.js";
 import { AI_JOBS_COLLECTION, registerAiJobPlanStep } from "./ai-jobs.js";
 /**
  * The plan step (AGL-2935): the first step of every job that builds site
@@ -197,17 +199,25 @@ import { AI_JOBS_COLLECTION, registerAiJobPlanStep } from "./ai-jobs.js";
     }
     const cap = capabilities == null ? void 0 : capabilities.freeSitePages;
     const home = aiSitePlanHomeRule(inventory, capabilities);
+    // The form lives on the page a visitor opens to get in touch (AGL-3899),
+    // and the home's call to action links it; a one-page site keeps it home.
+    const formOnHome = aiSiteFormStaysHome(job, cap);
     if (cap !== undefined) {
-        lines.push(`This is a Free workspace: plan at most ${cap} ${cap === 1 ? 'page' : 'pages'} — the home page at / and the one page the brief most needs, such as services, booking or contact — and ${home.across} sections across them.${aiPlanCanPlaceForm(inventory, capabilities) ? ' Put the contact form on one of them.' : ''}`);
+        const where = formOnHome ? ' Put the contact form on the home page.' : ' Put the contact form on the page that is not the home page.';
+        lines.push(`This is a Free workspace: plan at most ${cap} ${cap === 1 ? 'page' : 'pages'} — the home page at / and the one page the brief most needs, such as services, booking or contact — and ${home.across} sections across them.${aiPlanCanPlaceForm(inventory, capabilities) ? where : ''}`);
     }
     // A new site is a full website (AGL-3660): its home is planned as one, not
     // left to a ceiling the outline is free to stay far under.
     const plansHome = !pages.some((page)=>!page.replaceable && aiSitePlanIsHome(page));
     if (home.min > 0 && plansHome) {
         var _aiSiteKindOfInputs1;
-        // A store's home is a storefront (AGL-3676): its own parts, in its own order.
+        // A store's home is a storefront (AGL-3676): its own parts.
         const bands = ((_aiSiteKindOfInputs1 = aiSiteKindOfInputs(job.inputs)) == null ? void 0 : _aiSiteKindOfInputs1.id) === 'store' ? AI_SITE_STORE_HOME_BANDS : AI_SITE_HOME_BANDS;
         lines.push(`The home page at / reads as a full website: at least ${home.min} sections — ${bands}.`);
+        // And its own arc, chosen by the job's seed (AGL-3899): two identical
+        // briefs are two different homes.
+        const arc = aiSitePlanHomeArc(job);
+        if (arc) lines.push(aiSiteHomeArcSentence(arc));
     }
     // The sections are a budget to use (AGL-3660): a prod start of 2026-10-08
     // read "at most 8" as leave to plan a home of two.
@@ -242,7 +252,10 @@ import { AI_JOBS_COLLECTION, registerAiJobPlanStep } from "./ai-jobs.js";
     // A section that asks for something places the form (AGL-3660): a live
     // portfolio start planned a commissions inquiry beside the form it made
     // for its Contact page, without placing it.
-    if (aiPlanCanPlaceForm(inventory, capabilities)) lines.push(AI_SITE_FORM_SENTENCE);
+    if (aiPlanCanPlaceForm(inventory, capabilities)) lines.push(aiSiteFormSentence(formOnHome));
+    // As many items as the content has (AGL-3899): 47 of 55 groups in the
+    // newest production homes showed exactly three.
+    lines.push(AI_SITE_ITEMS_SENTENCE);
     // Structured content is kept as a dataset where one may be made (AGL-3616).
     if (capabilities == null ? void 0 : capabilities.create.dataset.allowed) {
         var _capabilities_datasetsMax, _capabilities_create_dataset_left;
@@ -282,9 +295,58 @@ import { AI_JOBS_COLLECTION, registerAiJobPlanStep } from "./ai-jobs.js";
  */ export const AI_SITE_NO_CUSTOMER_WORDS_SENTENCE = 'This site has no reviews or testimonials yet, and the build never writes them: plan no testimonials, reviews or client feedback section, and plan what working together is like instead. Never name a section a placeholder.';
 /**
  * The sentence a site plan's turn states about a section that collects
- * answers (AGL-3660): it places the saved form by reference, and one form
- * may be placed on more than one page.
- */ export const AI_SITE_FORM_SENTENCE = "A section that asks visitors for something (contact, inquiry, commissions, booking, sign-up) places the form: put new:<the form's name> or the site's form id in its uses. One form may be placed on several pages.";
+ * answers (AGL-3660): it places the saved form by reference — on the page a
+ * visitor opens to get in touch, never on the home page as well (AGL-3899).
+ * Told "one form may be placed on several pages", 17 of the 22 newest
+ * production homes carried the contact form, 16 of them in their last band,
+ * so every site ended the same way.
+ */ export const AI_SITE_FORM_SENTENCE = "A section that asks visitors for something (contact, inquiry, commissions, booking, sign-up) places the form: put new:<the form's name> or the site's form id in its uses.";
+/** Where the form goes, said after {@link AI_SITE_FORM_SENTENCE} on a site whose home does not keep it. */ export const AI_SITE_FORM_PAGE_SENTENCE = "Place it on the page a visitor opens to get in touch (such as Contact, Book, Visit or Enroll), and nowhere on the home page: the home's call to action is a button to that page.";
+/** What a site plan is told about its form: where it goes, as {@link aiSiteFormStaysHome} decides. */ export function aiSiteFormSentence(onHome) {
+    return onHome ? AI_SITE_FORM_SENTENCE : `${AI_SITE_FORM_SENTENCE} ${AI_SITE_FORM_PAGE_SENTENCE}`;
+}
+/**
+ * What a site plan is told about repeated items (AGL-3899): as many as the
+ * content has. Told nothing, the newest production plans gave 45 of 62 home
+ * groups three items, and the pages drew 47 of 55 groups with three.
+ */ export const AI_SITE_ITEMS_SENTENCE = 'Give each section that repeats items as many as its content has, from 2 to 6 (two offers, four steps, five questions, six pieces of work): vary the counts from section to section, never 3 everywhere.';
+/** The kinds whose one action is the form on the home page: a landing page and a coming-soon page. */ const AI_SITE_FORM_HOME_KINDS = new Set([
+    'landing',
+    'coming-soon'
+]);
+/**
+ * A brief that asks for the form on the home page itself, in one sentence:
+ * "a sign-up form on the home page", "the homepage should have a contact form".
+ */ const HOME_FORM_ASKED = /\b(?:home ?page|front page|main page)\b[^.!?\n]{0,60}\bform\b|\bform\b[^.!?\n]{0,60}\b(?:home ?page|front page|main page)\b/i;
+/**
+ * Whether a site start's home keeps its form (AGL-3899): a one-page site, a
+ * kind whose one action is that form (a landing or coming-soon page), or a
+ * brief that asks for it there. Every other start places the form on the
+ * page a visitor opens to get in touch, and its home closes with a call to
+ * action that links it (`aiSettlePlanHomeForms`).
+ */ export function aiSiteFormStaysHome(job, freePages) {
+    var _job_brief;
+    var _job_inputs, _aiSiteKindOfInputs;
+    const asked = Number((_job_inputs = job.inputs) == null ? void 0 : _job_inputs['pages']);
+    // A Free start's pages are its capped band (`freeSitePages`), else the pages asked for.
+    const pages = freePages != null ? freePages : Number.isInteger(asked) && asked > 0 ? asked : null;
+    if (pages === 1) return true;
+    const kind = (_aiSiteKindOfInputs = aiSiteKindOfInputs(job.inputs)) == null ? void 0 : _aiSiteKindOfInputs.id;
+    if (kind && AI_SITE_FORM_HOME_KINDS.has(kind)) return true;
+    return HOME_FORM_ASKED.test((_job_brief = job.brief) != null ? _job_brief : '');
+}
+/** The home arc a site start's plan is told (AGL-3899), by its job's seed; `null` for a job with no id. */ export function aiSitePlanHomeArc(job) {
+    var _ref, _job_inputs;
+    var _aiSiteKindOfInputs;
+    if (!job.$id) return null;
+    return aiSiteHomeArc({
+        kind: (_ref = (_aiSiteKindOfInputs = aiSiteKindOfInputs(job.inputs)) == null ? void 0 : _aiSiteKindOfInputs.id) != null ? _ref : null,
+        seed: aiSiteSeed(aiOriginJobId({
+            $id: job.$id,
+            inputs: (_job_inputs = job.inputs) != null ? _job_inputs : {}
+        }))
+    });
+}
 /**
  * The sentence a site plan's turn states where it may create datasets, with
  * how many it may (the live eval of 2026-10-10 planned four past a cap of
@@ -348,7 +410,11 @@ import { AI_JOBS_COLLECTION, registerAiJobPlanStep } from "./ai-jobs.js";
 }
 /** What a store's plan is told about its Shop page (AGL-3676). */ export const AI_SITE_STORE_SHOP_SENTENCE = 'Plan a Shop page at /shop: a short title section, then a section named "Product grid" second, where the platform lists the store\'s real products with sort, filters, photos, prices and cart, then at most one or two short sections (care, shipping, gifting help). Never open it with a hero, and never plan the products themselves as cards of your own.';
 /** What a paid store's plan is told about the pages the platform adds beside it (AGL-3676). */ export const AI_SITE_STORE_PAGES_SENTENCE = "The platform adds this store's account page (sign in, orders, saved items), its cart page, and its Shipping & returns, Privacy policy and Terms of sale pages, and links them in the header and footer; they do not count toward this plan's pages. Plan none of them: spend every page on what the brief is about.";
-/** What a store's home is composed of (AGL-3676): a storefront's parts, in a storefront's order. */ export const AI_SITE_STORE_HOME_BANDS = 'a hero that sells first, then "Bestsellers" (the platform lists the real products), "Shop by collection" with 3 or 4 items, the brand story, why buy here with 3 or 4 items, "Customer reviews" (the platform shows the store\'s real ones) and a "Newsletter sign-up" band last';
+/**
+ * What a store's home is composed of (AGL-3676): a storefront's parts, the
+ * hero first and the sign-up last, between them in the order its arc gives
+ * (AGL-3899).
+ */ export const AI_SITE_STORE_HOME_BANDS = 'a hero that sells first and a "Newsletter sign-up" band last, and between them "Bestsellers" (the platform lists the real products), "Shop by collection" with 3 or 4 items, the brand story, why buy here with 3 or 4 items and "Customer reviews" (the platform shows the store\'s real ones)';
 /**
  * A store plan held to a storefront (AGL-3676, `ai-layout-storefront.ts`):
  * on a paid start its home gains the parts a shopper expects that the plan
@@ -806,10 +872,17 @@ export function createAiJobPlanStep(deps = {}) {
         var _AI_JOB_PLAN_SCOPES_job_kind, _ref, _job_inputs, _ref1;
         var _aiSiteKindOfInputs, _aiSiteKindOfInputs1;
         const org = orgDocument != null ? orgDocument : null;
-        const [inventory, workspace, siteContext] = await Promise.all([
-            job.hostId ? readInventory(job.orgId, job.hostId, {
+        // A site start counts each dataset's records (AGL-3912): it reuses only
+        // one whose records are its own to show.
+        const readPlanInventory = async ()=>{
+            if (!job.hostId) return null;
+            const read = await readInventory(job.orgId, job.hostId, {
                 firestore
-            }) : Promise.resolve(null),
+            });
+            return job.kind === 'site' ? aiSiteInventoryWithRecordCounts(read, job.orgId, deps.countDatasetRecords) : read;
+        };
+        const [inventory, workspace, siteContext] = await Promise.all([
+            readPlanInventory(),
             readCapabilities({
                 job,
                 org,
@@ -960,9 +1033,11 @@ export function createAiJobPlanStep(deps = {}) {
         if (reused) {
             var _ref2;
             // The reused plan's draft ids name the other job's drafts; this job's are its own.
-            const plan = aiPlanWithStorePages(job.kind, ops, inventory, aiPlanWithItemCredits(itemOps, aiPlanWithDraftIds(job.kind, _extends({}, reused.plan, {
+            // Settled again against what the datasets hold now (AGL-3912).
+            const kept = site ? aiSettlePlanDatasets(aiSettleSiteForeignDatasets(reused.plan, inventory, capabilities), capabilities) : reused.plan;
+            const plan = aiPlanWithStorePages(job.kind, ops, inventory, aiPlanWithItemCredits(itemOps, aiPlanWithDraftIds(job.kind, _extends({}, kept, {
                 status: 'proposed',
-                labels: aiPlanLabels(reused.plan, inventory),
+                labels: aiPlanLabels(kept, inventory),
                 proposedAt: now,
                 confirmedAt: null,
                 confirmedBy: null,
@@ -1012,7 +1087,8 @@ export function createAiJobPlanStep(deps = {}) {
             // A build's events are listed on a page (AGL-3755): on the one it makes
             // about them, else on an Events page of its own where there is room.
             // No section is named a placeholder, and a site start plans no section
-            // of customer words it has none of (AGL-3887).
+            // of customer words it has none of (AGL-3887). A site start's plan
+            // makes again each dataset it reuses that another site filled (AGL-3912).
             settle: (answered)=>{
                 var _ref;
                 return aiPlanSaidSettle(job, inventory, site ? aiSitePlanHomeRule(inventory, capabilities).min : 0)(ops ? aiSettleBuildEventPage(answered, {
@@ -1020,8 +1096,13 @@ export function createAiJobPlanStep(deps = {}) {
                     siteSlugs: ((_ref = inventory == null ? void 0 : inventory.screens) != null ? _ref : []).map((screen)=>screen.slug),
                     pageLimit: aiBuildPageLimit(freeTaste),
                     siteLayout: aiSiteLayoutOf(inventory)
-                }) : answered);
-            },
+                }) : site ? aiSettleSiteForeignDatasets(answered, inventory, capabilities) : answered);
+            }
+        }, site ? {
+            settleForms: (placed)=>aiSettlePlanHomeForms(placed, inventory, {
+                    keep: aiSiteFormStaysHome(job, capabilities == null ? void 0 : capabilities.freeSitePages)
+                })
+        } : {}, {
             extend: aiSiteWithEventItemsCheck(planViolations(scope, job.brief, freeTaste, ops, site ? aiSitePlanHomeRule(inventory, capabilities) : null, site && aiSiteContentPart((_job_inputs = job.inputs) != null ? _job_inputs : null, freeTaste) === 'posts', site, site && ((_aiSiteKindOfInputs = aiSiteKindOfInputs(job.inputs)) == null ? void 0 : _aiSiteKindOfInputs.id) === 'store'), site ? siteEvents : undefined, ops)
         }));
         const spent = _extends({