@aglyn/plugins-ai 1.0.0-beta.143

package/src/lib/jobs/ai-job-page-step.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/jobs/ai-job-page-step.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 { buildPageMarkdown } from '@aglyn/aglyn/app-utils/page-markdown'\nimport { checkEntitlement } from '@aglyn/aglyn/app-utils/plan-entitlements'\nimport { SCREEN_SEO_TEXT_GUIDANCE } from '@aglyn/aglyn/app-utils/screen-seo-fields'\nimport { CANVAS_ROOT_ELEMENT_ID } from '@aglyn/aglyn/foundation/constants/canvas'\nimport type { AglynOrgBilling } from '@aglyn/aglyn/foundation/definitions/org-billing.types'\nimport { duplicateResource } from '@aglyn/tenant-data-admin/server/duplicate-resource'\nimport { AI_BUILD_PLAN_LIMITS, type AiBuildPlanScreen } from '../model/ai-build-plan'\nimport {\n  AI_PAGE_CREATE_KINDS,\n  aiPageCreationRefusal,\n  aiPagePlanRefusal,\n  parseAiPageJobInputs,\n} from '../model/ai-page-job'\nimport { aiPlanCapabilitiesForJob, aiPlanUncreatable } from '../model/ai-plan-capabilities'\nimport { aiSiteWords } from '../model/ai-site-job'\nimport type { AiJob, AiJobOutput, AiJobPlan, AiJobReview } from '../model/ai-jobs.types'\nimport { aiModelForStep } from '../providers/routing'\nimport { aiDoctrineNeedsInputMessage, runValidatedGeneration } from '../runtime/ai-doctrine'\nimport { validateAiDoctrineTree, type AiDoctrineTree } from '../runtime/ai-doctrine-validators'\nimport type { AiLoadEstimate } from '../runtime/ai-palette'\nimport { AI_SEO_FIELDS_MAX_TOKENS, generateSeoFields } from '../runtime/seo-fields'\nimport { readSiteInventory } from '../runtime/site-inventory'\nimport { registerAiJobAdmission, type AiJobAdmission } from './ai-job-admission'\nimport { aiGenerationWorstCaseMs } from './ai-job-budget'\nimport { aiJobDraftId } from './ai-job-draft-ids'\nimport {\n  aiDraftAdmissionRefusal,\n  aiDraftAllowanceRefusal,\n  aiSiteSubdomain,\n  readAiDraft,\n  readAiDraftNodes,\n  readAiPlanCapabilities,\n  updateAiDraftNodes,\n  writeAiDraft,\n  writeAiDraftScreenSeo,\n  type AiDraftRecord,\n} from './ai-job-drafts'\nimport {\n  aiBracketedFactsNote,\n  aiConfirmedPlan,\n  aiDoctrineReview,\n  aiGenerationSpent,\n  aiLimitReview,\n  aiModelNodeIds,\n  aiUnspentOutcome,\n} from './ai-job-generation'\nimport {\n  AI_JOB_PAGE_SECTION_MAX_TOKENS,\n  AI_JOB_PAGE_SECTION_TOKENS,\n  AI_JOB_PAGE_STEP_BUDGET,\n  AI_JOB_PAGE_STEP_MINIMUM_MS,\n  aiJobPageSectionMaxTokens,\n} from './ai-job-page-budget'\nimport {\n  AI_JOB_PAGE_INSTRUCTIONS,\n  AI_PAGE_SECTION_TOOL,\n  aiEmptyPage,\n  aiPageCheckContext,\n  aiPageSectionCheck,\n  aiPageSectionNodeId,\n  aiPageSectionPrompt,\n  aiPageSectionSmaller,\n  aiPageWithSection,\n  type AiPageSection,\n} from './ai-job-page-sections'\nimport { AI_PLAN_ITEMS_MIN, aiPlanCopiedPageViolations } from './ai-job-plan-conformance'\nimport {\n  aiCreationUnit,\n  aiRunJobUnit,\n  aiSiteBuiltRefs,\n  aiSitePendingUnits,\n  aiSiteUnitJob,\n  type AiSiteUnit,\n} from './ai-job-site-step'\nimport type { AiJobStepOutcome, AiJobStepRunner } from './ai-job-text-step'\nimport {\n  aiJobStepRunMinimumMs,\n  aiJobStepRunnerFor,\n  registerAiJobStep,\n  registerAiJobStepPasses,\n} from './ai-jobs'\n\n/**\n * The page step (AGL-2907): the generation step of a `page` job, run once a\n * member confirmed the job's plan. It builds ONE screen, section by section,\n * from what the site already has, and leaves it an unpublished draft.\n *\n * ── Why a page is built in passes ────────────────────────────────────────\n *\n * A page is far larger than one answer the job beat can wait for: the beat\n * gives a step what is left of its budget, and a whole page, answered and re-asked,\n * takes several times that. The confirmed plan already names the page's\n * sections, so the step builds one section per pass and asks the machine to\n * continue. Every pass is one reservation and one generation — the section's\n * lookup rounds, its answer and, when it breaks a rule, its one re-ask — sized\n * so that worst case fits `AI_JOB_PAGE_STEP_MINIMUM_MS`, which the step\n * registers as the least time a section pass needs before it starts.\n *\n *  - The first pass builds the top section, which holds the page's h1, and\n *    writes the draft screen and its first version.\n *  - Each later pass builds the next section and adds it to that version.\n *  - The last pass generates no tree: it holds the whole page to the\n *    doctrine, writes the search title and description, and reports the\n *    draft with its measured weight and a navigation proposal.\n *\n * How a section is asked for and held to the rules as part of the page is\n * `ai-job-page-sections.ts`.\n *\n * ── What the plan creates comes first (AGL-3031) ─────────────────────────\n *\n * A plan that creates a layout, forms or components is built in the same job,\n * before its page, one creation a pass, through the site scaffold's unit\n * machinery: each creation is handed to the step that builds that kind, under\n * a job derived from this one, and lands as the draft that step writes. Where\n * the job stands is read from its outputs, so nothing is kept anywhere else.\n * Once every creation is built, the page's passes run on the plan with each\n * `new:<name>` resolved to the record that was built, which the site's\n * inventory now lists — so the page places the new component and binds the new\n * form by id, and renders inside the new layout, exactly as it would one the\n * site always had. A pass that builds a creation needs the time the step that\n * builds it registers, not a section's (`aiPageJobRunMinimumMs`, AGL-3035), so\n * neither the beat nor a door starts it with only a section's time left.\n *\n * ── Never published ──────────────────────────────────────────────────────\n *\n * The draft is written the way `/api/hosts/resources` and\n * `/api/hosts/versions` write a screen and its first version, and nothing\n * else is touched: not the host document, whose routing map is what the live\n * site serves, and no collection, store, layout or navigation pointer\n * (`ai-job-drafts.ts`). A screen the routing map does not name serves nothing\n * until a member publishes it.\n */\n\n/**\n * A section pass's time, and the ceiling each pass asks on each model, are\n * declared apart from the step (`ai-job-page-budget.ts`): the site scaffold\n * builds its pages through this step and reads them without loading it.\n */\nexport {\n  AI_JOB_PAGE_SECTION_MAX_TOKENS,\n  AI_JOB_PAGE_SECTION_TOKENS,\n  AI_JOB_PAGE_STEP_BUDGET,\n  AI_JOB_PAGE_STEP_MINIMUM_MS,\n  aiJobPageSectionMaxTokens,\n}\n\n/**\n * Tokens one element takes in a section's answer, ESTIMATED: the tree as JSON\n * text inside the tool call, at four characters a token. Measured on the ten\n * golden pages at a median of 38 and a most of 43 over their 39 sections, and\n * `ai-job-page-evals.spec.ts` holds every golden section under it.\n */\nexport const AI_JOB_PAGE_TOKENS_PER_ELEMENT = 45\n\n/**\n * Real tokens to every token estimated at four characters (AGL-3042). A\n * section's ceiling is counted by the provider in its own tokens, which run\n * above that estimate. MEASURED on the first live document run on a Free\n * workspace (AGL-3024, test-org, 2026-09-16), as the cache read of a request\n * over the estimate of the same cached prefix: 4,059 over 2,825 for the page\n * plan and 6,649 over 4,310 for the layout, the higher of the two, 1.5427 —\n * the ratio `ai-job-free-page.spec.ts` prices a Free page at. It is measured on\n * prompt text; an answer's own is read off a recorded pass, whose output\n * tokens the step's record keeps (`lastRuns`), beside the section it stored.\n */\nexport const AI_JOB_PAGE_REAL_TOKENS_PER_ESTIMATED = Math.max(4_059 / 2_825, 6_649 / 4_310)\n\n/**\n * Real tokens one element takes in a section's answer: the estimate at its\n * golden most, in real tokens, rounded up — 45 × 1.5427 → 70 (AGL-3042).\n */\nexport const AI_JOB_PAGE_REAL_TOKENS_PER_ELEMENT = Math.ceil(\n  AI_JOB_PAGE_TOKENS_PER_ELEMENT * AI_JOB_PAGE_REAL_TOKENS_PER_ESTIMATED,\n)\n\n/**\n * The most elements a section's request asks it to keep under at an answer\n * ceiling: 15 at the balanced tier's 1,050 (AGL-3042). Counted in real\n * tokens, because the ceiling is: counted in the estimate, the budget is 23\n * elements, which a section of the goldens' largest elements fills at 1,597\n * real tokens — half as much again as the ceiling that cuts it off.\n */\nexport function aiJobPageSectionMaxElements(maxTokens: number): number {\n  return Math.max(1, Math.floor(maxTokens / AI_JOB_PAGE_REAL_TOKENS_PER_ELEMENT))\n}\n\n/** A page's name when the plan names none. */\nexport const AI_JOB_PAGE_DEFAULT_NAME = 'New page'\n\nexport const AI_JOB_PAGE_NO_PLAN_COPY = 'This page job has no confirmed plan to build.'\nexport const AI_JOB_PAGE_DELETED_COPY = 'The draft page was deleted while it was being built.'\n\n/** A creation the plan names that this deployment has no step to build. */\nexport const AI_JOB_PAGE_CREATION_UNAVAILABLE_COPY =\n  'This page needs something that cannot be built here yet. Describe the page again.'\n\n/** A creation that finished without reporting what it built; the page cannot place it. */\nexport const AI_JOB_PAGE_CREATION_EMPTY_COPY =\n  'Part of this page could not be built. Describe the page again.'\n\n/**\n * What a page refused on its last pass tells the member beside the rules it\n * broke (AGL-3143). The draft is reported with the review, and mending what\n * the findings name in it is what lets the next pass finish the job.\n */\nexport const AI_JOB_PAGE_REFUSED_DRAFT_COPY =\n  'The draft is yours to open: mend what these name in it, then try again.'\n\n/**\n * The most passes a page job may take (AGL-3031): every creation the plan\n * limits admit, every section they admit, and the last pass that reports the\n * draft. A creation's step builds it in one pass, and a page one section a\n * pass, so a runner that never finishes is still bounded while a real page is\n * not.\n */\nexport const AI_JOB_PAGE_MAX_PASSES = AI_BUILD_PLAN_LIMITS.create + AI_BUILD_PLAN_LIMITS.sections + 1\n\n/**\n * The units a plan's creations are built as, in the order a scaffold builds\n * them: the layout, then the forms, then the components. Each is addressed by\n * its place in the plan, so a unit run again finds its own draft.\n */\nexport function aiPageJobUnits(plan: Pick<AiJobPlan, 'create'>): AiSiteUnit[] {\n  return AI_PAGE_CREATE_KINDS.flatMap((kind) =>\n    plan.create.flatMap((creation, index) => {\n      if (creation.kind !== kind) return []\n      const unit = aiCreationUnit(creation, `c${index}`)\n      return unit ? [unit] : []\n    }),\n  )\n}\n\n/**\n * The least time this page job's next pass needs (AGL-3035). A pass that\n * builds a creation hands it to the step registered for that kind, under the\n * job derived for it, so it needs what that step registers for that job — a\n * layout's time, not a section's. Every other pass — a section, the last one —\n * needs a section pass's.\n */\nexport function aiPageJobRunMinimumMs(job: AiJob): number {\n  const confirmed = aiConfirmedPlan(job)\n  if (!confirmed) return AI_JOB_PAGE_STEP_MINIMUM_MS\n  const units = aiPageJobUnits(confirmed)\n  const outputs = job.outputs ?? []\n  const [unit] = aiSitePendingUnits(units, outputs)\n  if (!unit) return AI_JOB_PAGE_STEP_MINIMUM_MS\n  return aiJobStepRunMinimumMs(aiSiteUnitJob(job, unit, aiSiteBuiltRefs(units, outputs)))\n}\n\n/** The one-segment address a draft asks for, from the plan's slug. */\nexport function aiPageDraftSlug(screen: Pick<AiBuildPlanScreen, 'slug'>): string {\n  const segments = screen.slug.split('/').map((part) => part.trim()).filter(Boolean)\n  return segments[segments.length - 1] ?? ''\n}\n\n/** A plan's listing value held to the length the SEO editor guides it to, cut at a word. */\nfunction clip(value: string, max: number): string {\n  const text = value.trim()\n  if (text.length <= max) return text\n  const cut = text.slice(0, max + 1)\n  const space = cut.lastIndexOf(' ')\n  return (space > max / 2 ? cut.slice(0, space) : text.slice(0, max)).trim()\n}\n\n/** The site's name as its visitors see it, read the way the SEO step reads it. */\nfunction siteNameOf(host: FirebaseFirestore.DocumentSnapshot): string {\n  const text = (value: unknown) => (typeof value === 'string' ? value.trim() : '')\n  return text(host.get('seo.title')) || text(host.get('displayName')) || text(host.get('subdomain'))\n}\n\n/**\n * The counts the confirmed plan's sections promised, against the page a COPY\n * actually produced (AGL-3024); `null` when the copy keeps the plan, or when\n * the plan promised no count to keep.\n *\n * The same hole the layout copy had (`aiCopiedLayoutReview`), on the kind the\n * defect was measured on. This branch generates nothing, so no model ever\n * answers for the plan: a plan reading \"start from the Services page, one\n * card per practice area\" gets the Services page and whatever IT had, and\n * until now reported `Done` — the one report that tells a customer there is\n * no reason to re-read the page.\n *\n * A copy that cannot be read back settles nothing, and a promise this step\n * cannot settle is reviewed by a person rather than reported as kept.\n */\nexport async function aiCopiedPageReview(\n  firestore: FirebaseFirestore.Firestore,\n  input: { hostId: string; id: string; name: string; screen: Pick<AiBuildPlanScreen, 'sections'> },\n): Promise<AiJobReview | null> {\n  if (!input.screen.sections.some((section) => section.items >= AI_PLAN_ITEMS_MIN)) return null\n  const stored = await readAiDraftNodes(firestore, { kind: 'screen', hostId: input.hostId, id: input.id })\n  const nodes = (stored?.nodes ?? {}) as unknown as AiDoctrineTree['nodes']\n  if (!nodes[CANVAS_ROOT_ELEMENT_ID]) {\n    return {\n      reason: 'doctrine',\n      message: `\"${input.name}\" was copied from the page the plan names, and this job could not read the copy back to check it shows what the plan says it shows. Open the page and check it before you put it in front of anyone.`,\n      findings: [],\n    }\n  }\n  const violations = aiPlanCopiedPageViolations(input.screen, { rootId: CANVAS_ROOT_ELEMENT_ID, nodes })\n  if (!violations.length) return null\n  return aiDoctrineReview({\n    message: `\"${input.name}\" is a copy of the page the plan names, and a copy is all it is: ${violations[0].message}`,\n    violations,\n  })\n}\n\n/**\n * A page job is admitted with inputs that read, for a site of the job's own\n * org with a screen to spare; and confirmed only for a plan it can build —\n * one screen, whose creations are ones a page job builds, this deployment has\n * a step for, and this workspace may still make on this site (AGL-3031).\n */\nexport const aiPageJobAdmission: AiJobAdmission = async (context) => {\n  const inputs = parseAiPageJobInputs(context.inputs)\n  if (typeof inputs === 'string') return { status: 400, error: inputs }\n  const plan = context.plan\n  if (plan) {\n    const refusal = aiPagePlanRefusal(plan)\n    if (refusal) return { status: 400, error: refusal }\n    if (aiPageJobUnits(plan).some((unit) => !aiJobStepRunnerFor(unit.jobKind))) {\n      return { status: 400, error: AI_JOB_PAGE_CREATION_UNAVAILABLE_COPY }\n    }\n  }\n  const org = context.org as Partial<AglynOrgBilling> | null\n  return aiDraftAdmissionRefusal(context.firestore, {\n    orgId: context.orgId,\n    hostId: context.hostId,\n    kind: 'screen',\n    noun: 'page',\n    org,\n    // What the workspace may still make here, read once the site is known to\n    // be the org's: the site may have changed since the plan was told.\n    ...(plan?.create.length\n      ? {\n          ownCheck: async (hostId: string) => {\n            const capabilities = aiPlanCapabilitiesForJob(\n              await readAiPlanCapabilities(context.firestore, { hostId, org }),\n              { noun: 'a page job', creates: AI_PAGE_CREATE_KINDS },\n            )\n            const refusal = aiPageCreationRefusal(aiPlanUncreatable(plan, capabilities))\n            return refusal ? { status: 403 as const, error: refusal } : null\n          },\n        }\n      : {}),\n  })\n}\n\nexport interface AiJobPageStepDeps {\n  /** The inventory reader; specs hand in a fake. */\n  readInventory?: typeof readSiteInventory\n  /** The platform's duplicate module, for a plan that starts from a copy. */\n  duplicate?: typeof duplicateResource\n  /** The listing generator (AGL-2910). */\n  seoFields?: typeof generateSeoFields\n  /** The runners a plan's creations are built by (AGL-3031); the registry's otherwise. */\n  runnerFor?: typeof aiJobStepRunnerFor\n}\n\nexport function createAiJobPageStep(deps: AiJobPageStepDeps = {}): AiJobStepRunner {\n  const readInventory = deps.readInventory ?? readSiteInventory\n  const duplicate = deps.duplicate ?? duplicateResource\n  const seoFields = deps.seoFields ?? generateSeoFields\n  const runnerFor = deps.runnerFor ?? aiJobStepRunnerFor\n  return async (stepContext): Promise<AiJobStepOutcome> => {\n    const { job, now, signal, firestore, modelFor } = stepContext\n    const hostId = job.hostId\n    if (!hostId) throw new Error('a page job names no site, and its admission refuses one')\n    // The switch's answer for this job, else the routing table's (AGL-2942).\n    const model = modelFor?.('job.page') ?? aiModelForStep('job.page')\n    const confirmed = aiConfirmedPlan(job)\n    if (!confirmed) return { ...aiUnspentOutcome(model), failure: AI_JOB_PAGE_NO_PLAN_COPY }\n    // The resume door refuses such a plan at confirmation; one confirmed\n    // before a site changed still stops here, before any spend.\n    const refusal = aiPagePlanRefusal(confirmed)\n    if (refusal) return { ...aiUnspentOutcome(model), failure: refusal }\n\n    // ── The creations first (AGL-3031): one a pass, by the steps that own them ──\n    const units = aiPageJobUnits(confirmed)\n    const outputs = job.outputs ?? []\n    const [unit] = aiSitePendingUnits(units, outputs)\n    if (unit) {\n      const runner = runnerFor(unit.jobKind)\n      if (!runner) return { ...aiUnspentOutcome(model), failure: AI_JOB_PAGE_CREATION_UNAVAILABLE_COPY }\n      const pass = await aiRunJobUnit(stepContext, {\n        unit,\n        units,\n        runner,\n        emptyCopy: AI_JOB_PAGE_CREATION_EMPTY_COPY,\n      })\n      // A built creation is followed by the next, or by the page's first section.\n      return pass.built ? { ...pass.outcome, continue: true } : pass.outcome\n    }\n    // The page's plan with every creation resolved to the record it built, as\n    // a scaffold's page is planned against what the scaffold built.\n    const plan: AiJobPlan = units.length\n      ? (aiSiteUnitJob(\n          job,\n          {\n            kind: 'page',\n            jobKind: 'page',\n            resource: 'screen',\n            slot: 'page',\n            screen: confirmed.screens[0],\n            label: confirmed.screens[0].title,\n          },\n          aiSiteBuiltRefs(units, outputs),\n        ).plan as AiJobPlan)\n      : confirmed\n    const screen = plan.screens[0] as AiBuildPlanScreen\n    const name = screen.title || AI_JOB_PAGE_DEFAULT_NAME\n    const slug = aiPageDraftSlug(screen)\n    const sectionIds = screen.sections.map((_, index) => aiPageSectionNodeId(job.$id, index))\n    // The draft screen, by the id the job recorded for it: every pass writes and finds the same one.\n    const draftId = aiJobDraftId(job, 'screen')\n\n    const output = (\n      draft: Pick<AiDraftRecord, 'id' | 'versionId' | 'name' | 'hostSubdomain'>,\n      load?: AiLoadEstimate | null,\n      note?: string | null,\n    ): AiJobOutput => ({\n      resource: 'screen',\n      id: draft.id,\n      versionId: draft.versionId,\n      hostId,\n      hostSubdomain: draft.hostSubdomain,\n      label: draft.name,\n      ...(load ? { load } : {}),\n      ...(note ? { note } : {}),\n      // Rule 10: a navigation entry travels with the page as a proposal, for\n      // the member to add once the page is live; no menu is written.\n      ...(screen.nav ? { proposal: { navigation: { label: name, slug } } } : {}),\n    })\n\n    const [inventory, orgSnapshot, written] = await Promise.all([\n      readInventory(job.orgId, hostId, { firestore }),\n      firestore.collection('orgs').doc(job.orgId).get(),\n      readAiDraft(firestore, { kind: 'screen', hostId, id: draftId }),\n    ])\n    const org = (orgSnapshot.data() ?? null) as Partial<AglynOrgBilling> | null\n    if (written?.deleted) return { ...aiUnspentOutcome(model), failure: AI_JOB_PAGE_DELETED_COPY }\n\n    // The plan starts from a copy of a screen the site has (rule 15): the copy\n    // is the draft — unrouted, as every copy is — and nothing is generated.\n    // Only a page is a page's start: a collection entry template's copy stays\n    // a template, so a plan naming one builds the page instead.\n    if (\n      !written &&\n      screen.duplicateOf &&\n      inventory.screens.some((row) => row.id === screen.duplicateOf && !row.template)\n    ) {\n      const copy = await duplicate('screen', {\n        orgId: job.orgId,\n        hostId,\n        sourceId: screen.duplicateOf,\n        name,\n        uid: job.createdBy,\n        org: org as Record<string, unknown> | null,\n      })\n      if (copy.ok) {\n        // A copy is not a build (AGL-3024). Nothing is generated here, so\n        // whatever the plan promised BEYOND the source is in the draft only\n        // if the source already had it, and no model is left to answer for\n        // the difference — the copy itself has to.\n        const review = await aiCopiedPageReview(firestore, { hostId, id: copy.id, name, screen })\n        if (review) return aiUnspentOutcome(model, { review })\n        const hostSubdomain = await aiSiteSubdomain(firestore, hostId)\n        return aiUnspentOutcome(model, {\n          outputs: [output({ id: copy.id, versionId: copy.versionId, name: copy.name, hostSubdomain })],\n        })\n      }\n      if (copy.ok === false && copy.status === 403) {\n        return aiUnspentOutcome(model, { review: aiLimitReview(copy.error) })\n      }\n    }\n\n    const stored = written ? await readAiDraftNodes(firestore, { kind: 'screen', hostId, id: draftId }) : null\n    if (written && !stored) return { ...aiUnspentOutcome(model), failure: AI_JOB_PAGE_DELETED_COPY }\n    const page = stored?.nodes ?? aiEmptyPage()\n    const index = sectionIds.findIndex((id) => !(id in page))\n    // A workspace that keeps no reusable components or saved forms builds its\n    // page inline, and every pass is held to the rules that way (AGL-3030).\n    const reusableComponents = checkEntitlement(org, 'reusableComponents')\n    // A link may take a visitor to a section of this page, by its name in the plan (AGL-3097).\n    const sections = screen.sections.map((section) => section.name)\n    const context = aiPageCheckContext(inventory, { reusableComponents, sections })\n\n    // ── The last pass: the whole page, its listing, and the draft reported ──\n    if (index === -1 && written) {\n      // A link the page carries to one of its sections goes there, now every section is built.\n      const report = validateAiDoctrineTree({ rootId: CANVAS_ROOT_ELEMENT_ID, nodes: page }, 'page', {\n        ...context,\n        scrollTargetIds: sectionIds,\n      })\n      // The facts the brief did not give, on the page or in the defaults its components show (AGL-3056).\n      const note = aiBracketedFactsNote({\n        tree: { rootId: CANVAS_ROOT_ELEMENT_ID, nodes: page as unknown as AiDoctrineTree['nodes'] },\n        inventory,\n      })\n      // The page's own draft, reported once however many times the last pass\n      // runs (AGL-3143): a refused pass reports it and a later one that\n      // passes does not report it twice.\n      const reported = outputs.some((entry) => entry.resource === 'screen' && entry.id === draftId)\n      const reports = reported ? [] : [output(written, report.load, note)]\n      if (report.violations.length) {\n        // The check mints its own ids; the review names the nodes by the ids the draft stores them under.\n        const storedIds = report.tree?.sourceIds ?? {}\n        const violations = report.violations.map((violation) =>\n          violation.nodeIds ? { ...violation, nodeIds: aiModelNodeIds(violation.nodeIds, storedIds) } : violation,\n        )\n        // THE DRAFT TRAVELS WITH THE REFUSAL (AGL-3143). Every other review\n        // parks on a model's answer, so trying again asks the model again and\n        // can come back different. This one reads the STORED page and spends\n        // nothing, so trying again refuses the same page for the same reasons\n        // forever — and a job parked here having reported no output names no\n        // draft at all, which leaves the member nowhere to mend the nodes the\n        // findings name and no way to finish the job from the console. The\n        // draft is reported now instead, and the job still parks: what the\n        // review names is mended in the draft, and the next pass then passes.\n        return aiUnspentOutcome(model, {\n          outputs: reports,\n          review: aiDoctrineReview({\n            message: `${aiDoctrineNeedsInputMessage(violations)} ${AI_JOB_PAGE_REFUSED_DRAFT_COPY}`,\n            violations,\n            answer: { tree: { rootId: CANVAS_ROOT_ELEMENT_ID, nodes: page } },\n          }),\n        })\n      }\n      let spent: AiJobStepOutcome = aiUnspentOutcome(model)\n      if (!written.seo?.title?.trim() || !written.seo?.description?.trim()) {\n        const seoModel = modelFor?.('job.seo') ?? aiModelForStep('job.seo')\n        // The plan's own listing, held to the editor's guidance, when the\n        // listing cannot be written inside this pass's time on the model the\n        // job runs.\n        let values = {\n          title: clip(screen.seoTitle, SCREEN_SEO_TEXT_GUIDANCE.title),\n          description: clip(screen.seoDescription, SCREEN_SEO_TEXT_GUIDANCE.description),\n        }\n        if (\n          // A listing is written from the page's own text, with no inventory\n          // and so no lookup round.\n          aiGenerationWorstCaseMs({ maxTokens: AI_SEO_FIELDS_MAX_TOKENS, model: seoModel, lookups: 0 }) <=\n          AI_JOB_PAGE_STEP_MINIMUM_MS\n        ) {\n          const host = await firestore.collection('hosts').doc(hostId).get()\n          const result = await seoFields({\n            subject: { kind: 'screen', name, path: `/${slug}` },\n            brand: siteNameOf(host),\n            // What the site is and who it is for (AGL-2918). The page's own\n            // Markdown says what the page is about and cannot say who it was\n            // written for, so the listing borrows the two answers the job was\n            // started from — the scaffold's derived page job carries them,\n            // and a page job started from the Screens page carries neither.\n            site: aiSiteWords(job.inputs),\n            text: buildPageMarkdown({ nodes: page as never, rootId: CANVAS_ROOT_ELEMENT_ID }),\n            fields: ['title', 'description'],\n            // Other screens by name only: their own listings are their content.\n            otherTitles: inventory.screens.map((row) => row.name),\n            model: seoModel,\n            ...(signal ? { signal } : {}),\n          })\n          spent = { ...spent, ...aiGenerationSpent(result) }\n          if (result.status === 'ok') {\n            values = {\n              title: result.value.title?.trim() || values.title,\n              description: result.value.description?.trim() || values.description,\n            }\n          }\n        }\n        await writeAiDraftScreenSeo(firestore, { hostId, id: draftId, seo: values, now })\n      }\n      return { ...spent, outputs: reports }\n    }\n\n    // ── A section pass ──\n    if (!written) {\n      const allowance = await aiDraftAllowanceRefusal(firestore, { kind: 'screen', hostId, org })\n      if (allowance) return aiUnspentOutcome(model, { review: aiLimitReview(allowance) })\n    }\n    const maxTokens = aiJobPageSectionMaxTokens(model)\n    const maxElements = aiJobPageSectionMaxElements(maxTokens)\n    const result = await runValidatedGeneration<AiPageSection>('page-section', {\n      step: 'job.page',\n      model,\n      instructions: AI_JOB_PAGE_INSTRUCTIONS,\n      inventory,\n      messages: [\n        {\n          role: 'user',\n          content: aiPageSectionPrompt({ job, plan, screen, index, maxElements, reusableComponents }),\n        },\n      ],\n      tool: AI_PAGE_SECTION_TOOL,\n      maxTokens,\n      // A section cut off at its ceiling is asked for smaller, and a member\n      // whose section still does not fit reads that it was too large (AGL-3042).\n      cutOff: { noun: 'section', smaller: aiPageSectionSmaller({ maxElements, reusableComponents }) },\n      thinking: 'off',\n      check: aiPageSectionCheck({\n        page,\n        sectionIds,\n        index,\n        context,\n        section: screen.sections[index],\n        inventory,\n      }),\n      ...(signal ? { signal } : {}),\n    })\n    const spent = aiGenerationSpent(result)\n    if (result.status === 'refused') return { ...spent, refused: true }\n    if (result.status === 'needs_input') return { ...spent, review: aiDoctrineReview(result) }\n\n    if (!written) {\n      const draft = await writeAiDraft(firestore, {\n        kind: 'screen',\n        hostId,\n        id: draftId,\n        uid: job.createdBy,\n        org,\n        name,\n        nodes: aiPageWithSection(aiEmptyPage(), result.value, sectionIds),\n        slug,\n        layoutId:\n          screen.layout && inventory.layouts.some((row) => row.id === screen.layout) ? screen.layout : null,\n        now,\n      })\n      if (draft.ok === false) {\n        if (draft.status === 404) throw new Error(`site ${hostId} vanished while its page was generated`)\n        return { ...spent, review: aiLimitReview(draft.error) }\n      }\n    } else {\n      const update = await updateAiDraftNodes(firestore, {\n        kind: 'screen',\n        hostId,\n        id: draftId,\n        now,\n        // A pass run again after its write finds its section and changes nothing.\n        update: (nodes) =>\n          result.value.rootId in nodes ? null : aiPageWithSection(nodes, result.value, sectionIds),\n      })\n      if (update.ok === false) return { ...spent, failure: AI_JOB_PAGE_DELETED_COPY }\n    }\n    return { ...spent, continue: true }\n  }\n}\n\nexport const runAiJobPageStep = createAiJobPageStep()\n\n/**\n * Registers the page step with the least time a section pass needs and the\n * time its next pass needs, the passes a page with its creations may take, and\n * the check a page job passes when it is created or its plan is confirmed.\n */\nexport function registerAiPageJob(): void {\n  registerAiJobStep('page', runAiJobPageStep, {\n    minimumMs: AI_JOB_PAGE_STEP_MINIMUM_MS,\n    minimumMsFor: aiPageJobRunMinimumMs,\n  })\n  registerAiJobStepPasses('page', AI_JOB_PAGE_MAX_PASSES)\n  registerAiJobAdmission('page', aiPageJobAdmission)\n}\n"],"names":["buildPageMarkdown","checkEntitlement","SCREEN_SEO_TEXT_GUIDANCE","CANVAS_ROOT_ELEMENT_ID","duplicateResource","AI_BUILD_PLAN_LIMITS","AI_PAGE_CREATE_KINDS","aiPageCreationRefusal","aiPagePlanRefusal","parseAiPageJobInputs","aiPlanCapabilitiesForJob","aiPlanUncreatable","aiSiteWords","aiModelForStep","aiDoctrineNeedsInputMessage","runValidatedGeneration","validateAiDoctrineTree","AI_SEO_FIELDS_MAX_TOKENS","generateSeoFields","readSiteInventory","registerAiJobAdmission","aiGenerationWorstCaseMs","aiJobDraftId","aiDraftAdmissionRefusal","aiDraftAllowanceRefusal","aiSiteSubdomain","readAiDraft","readAiDraftNodes","readAiPlanCapabilities","updateAiDraftNodes","writeAiDraft","writeAiDraftScreenSeo","aiBracketedFactsNote","aiConfirmedPlan","aiDoctrineReview","aiGenerationSpent","aiLimitReview","aiModelNodeIds","aiUnspentOutcome","AI_JOB_PAGE_SECTION_MAX_TOKENS","AI_JOB_PAGE_SECTION_TOKENS","AI_JOB_PAGE_STEP_BUDGET","AI_JOB_PAGE_STEP_MINIMUM_MS","aiJobPageSectionMaxTokens","AI_JOB_PAGE_INSTRUCTIONS","AI_PAGE_SECTION_TOOL","aiEmptyPage","aiPageCheckContext","aiPageSectionCheck","aiPageSectionNodeId","aiPageSectionPrompt","aiPageSectionSmaller","aiPageWithSection","AI_PLAN_ITEMS_MIN","aiPlanCopiedPageViolations","aiCreationUnit","aiRunJobUnit","aiSiteBuiltRefs","aiSitePendingUnits","aiSiteUnitJob","aiJobStepRunMinimumMs","aiJobStepRunnerFor","registerAiJobStep","registerAiJobStepPasses","AI_JOB_PAGE_TOKENS_PER_ELEMENT","AI_JOB_PAGE_REAL_TOKENS_PER_ESTIMATED","Math","max","AI_JOB_PAGE_REAL_TOKENS_PER_ELEMENT","ceil","aiJobPageSectionMaxElements","maxTokens","floor","AI_JOB_PAGE_DEFAULT_NAME","AI_JOB_PAGE_NO_PLAN_COPY","AI_JOB_PAGE_DELETED_COPY","AI_JOB_PAGE_CREATION_UNAVAILABLE_COPY","AI_JOB_PAGE_CREATION_EMPTY_COPY","AI_JOB_PAGE_REFUSED_DRAFT_COPY","AI_JOB_PAGE_MAX_PASSES","create","sections","aiPageJobUnits","plan","flatMap","kind","creation","index","unit","aiPageJobRunMinimumMs","job","confirmed","units","outputs","aiPageDraftSlug","screen","segments","slug","split","map","part","trim","filter","Boolean","length","clip","value","text","cut","slice","space","lastIndexOf","siteNameOf","host","get","aiCopiedPageReview","firestore","input","some","section","items","stored","hostId","id","nodes","reason","message","name","findings","violations","rootId","aiPageJobAdmission","context","inputs","status","error","refusal","jobKind","org","orgId","noun","ownCheck","capabilities","creates","createAiJobPageStep","deps","readInventory","duplicate","seoFields","runnerFor","stepContext","orgSnapshot","now","signal","modelFor","Error","model","failure","runner","pass","emptyCopy","built","outcome","continue","resource","slot","screens","label","title","sectionIds","_","$id","draftId","output","draft","load","note","versionId","hostSubdomain","nav","proposal","navigation","inventory","written","Promise","all","collection","doc","data","deleted","duplicateOf","row","template","copy","sourceId","uid","createdBy","ok","review","page","findIndex","reusableComponents","report","scrollTargetIds","tree","reported","entry","reports","storedIds","sourceIds","violation","nodeIds","answer","spent","seo","description","seoModel","values","seoTitle","seoDescription","lookups","result","subject","path","brand","site","fields","otherTitles","allowance","maxElements","step","instructions","messages","role","content","tool","cutOff","smaller","thinking","check","refused","layoutId","layout","layouts","update","runAiJobPageStep","registerAiPageJob","minimumMs","minimumMsFor"],"mappings":"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"}

package/src/lib/jobs/ai-job-plan-conformance.d.ts

@@ -0,0 +1,107 @@
+/**
+ * @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 { AiBuildPlanScreen, AiBuildPlanSection } from '../model/ai-build-plan';
+import type { AiJobPlan } from '../model/ai-jobs.types';
+import { type AiDoctrineTree, type AiDoctrineViolation, type AiLayoutRegion } from '../runtime/ai-doctrine-validators';
+/**
+ * The build held to the plan the member confirmed (AGL-3024).
+ *
+ * The doctrine validators ask whether an artifact was built the way a careful
+ * author builds one. They do not ask whether it is the artifact the plan
+ * PROMISED, and a build that quietly delivers less still reports `Done` —
+ * which is the dangerous part, because `Done` is what tells the customer they
+ * have no reason to re-read it. Measured on beta.139: a plan promising four
+ * practice areas built three cards; a plan promising a layout with a sidebar
+ * built a verbatim copy of the base layout, the word "sidebar" nowhere in it.
+ *
+ * ── Structured commitments, never prose ──────────────────────────────────
+ *
+ * A plan's rationale (`why`) is prose a model wrote, and matching English
+ * against a node tree after the fact would be a second guess dressed as a
+ * check. Only the plan's STRUCTURE is read here, and only the two shapes that
+ * are already numbers or names in `ai-build-plan.ts`:
+ *
+ *  - **A count**: `screens[].sections[].items`, which the plan already
+ *    carries and the section prompt already states as "It shows N items".
+ *    Nothing read it back.
+ *  - **A region**: `create[].fields` on a layout, which is that kind's own
+ *    field for the regions it has (`AI_LAYOUT_REGIONS`). A layout has no
+ *    properties, so the planner is asked there for the one thing about a
+ *    layout worth promising and worth checking — a checkable assertion the
+ *    planner emits beside its prose, rather than English parsed out of it.
+ *
+ * ── It fails closed ──────────────────────────────────────────────────────
+ *
+ * Every function here answers "the plan is kept" only when it could look. A
+ * layout the step never read is not a layout whose regions are present; the
+ * layout door turns that into a stop for review rather than a `Done`. What it
+ * will not do is guess: a count it cannot settle from the document — items a
+ * collection fills at render — is not reported as short.
+ *
+ * The findings are ordinary `AiDoctrineViolation`s, so they ride the
+ * mechanism every other rule rides: `runValidatedGeneration` re-asks the
+ * model once with them, and a second answer that still breaks one stops the
+ * job for a person with `aiDoctrineReview`. They carry `rule: null` on
+ * purpose. The seventeen rules are how a document is BUILT; keeping the plan
+ * is not one of them, and numbering these as rule 7 would print "Rule 7
+ * (Reuse before creating)" over a finding about a count.
+ */
+/** A count below this is not a repeat, so a plan promising one promises nothing to count. */
+export declare const AI_PLAN_ITEMS_MIN = 2;
+/**
+ * The regions the confirmed plan's layout creation names, and the words it
+ * named that no region answers to. A plan with no layout creation names none.
+ */
+export declare function aiPlannedLayoutRegions(plan: AiJobPlan | null): {
+    regions: AiLayoutRegion[];
+    unreadable: string[];
+};
+/**
+ * The plan's promised regions against a built layout: one finding naming
+ * every region the plan lists that the layout does not carry, and one naming
+ * a word the vocabulary could not read, which is a promise this check cannot
+ * settle either way.
+ */
+export declare function aiPlanRegionViolations(plan: AiJobPlan | null, tree: AiDoctrineTree): AiDoctrineViolation[];
+/**
+ * The plan's promised item count against a built section. Silent where there
+ * is nothing to settle: a section promising fewer than `AI_PLAN_ITEMS_MIN`
+ * promises no repeat, and one whose items a collection fills draws them from
+ * data at render, where the document cannot be counted and rule 8 asked for
+ * exactly that. Silent, too, when the section shows MORE than it promised:
+ * the count is read generously (`aiRepeatedItemCount`), so a number above the
+ * promise is as likely to be the reading as the section.
+ */
+export declare function aiPlanItemCountViolations(section: Pick<AiBuildPlanSection, 'name' | 'items'>, tree: AiDoctrineTree): AiDoctrineViolation[];
+/**
+ * The counts the plan's sections promised against a page a COPY produced
+ * (AGL-3024), read over the whole page because a copy has no section of the
+ * plan's in it to read one at a time.
+ *
+ * A copied screen carries the SOURCE's nodes under the source's ids: nothing
+ * maps "the practice areas section" onto a subtree of it, so the per-section
+ * reading `aiPlanItemCountViolations` does at a generation pass has nothing
+ * to stand on here. What can still be settled is the weaker claim, and it is
+ * the one that catches the measured shape: a plan promising a section of four
+ * against a copy in which NO group of four repeated things exists anywhere is
+ * a promise the copy did not keep, whichever section was meant to keep it.
+ *
+ * Weaker on purpose, and so quieter: a copy holding six of something else
+ * reads as six and is let through. A screen carries no app bar and no footer
+ * — those are its layout's — so what is counted is the page's own content.
+ */
+export declare function aiPlanCopiedPageViolations(screen: Pick<AiBuildPlanScreen, 'sections'>, tree: AiDoctrineTree): AiDoctrineViolation[];

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

@@ -0,0 +1,164 @@
+/**
+ * @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 { AI_LAYOUT_REGION_NAMES, aiBindsRepeatedItems, aiLayoutRegionOf, aiRepeatedItemCount, aiTreeLayoutRegions } from "../runtime/ai-doctrine-validators.js";
+import { aiPlanCreation } from "./ai-job-generation.js";
+/**
+ * The build held to the plan the member confirmed (AGL-3024).
+ *
+ * The doctrine validators ask whether an artifact was built the way a careful
+ * author builds one. They do not ask whether it is the artifact the plan
+ * PROMISED, and a build that quietly delivers less still reports `Done` —
+ * which is the dangerous part, because `Done` is what tells the customer they
+ * have no reason to re-read it. Measured on beta.139: a plan promising four
+ * practice areas built three cards; a plan promising a layout with a sidebar
+ * built a verbatim copy of the base layout, the word "sidebar" nowhere in it.
+ *
+ * ── Structured commitments, never prose ──────────────────────────────────
+ *
+ * A plan's rationale (`why`) is prose a model wrote, and matching English
+ * against a node tree after the fact would be a second guess dressed as a
+ * check. Only the plan's STRUCTURE is read here, and only the two shapes that
+ * are already numbers or names in `ai-build-plan.ts`:
+ *
+ *  - **A count**: `screens[].sections[].items`, which the plan already
+ *    carries and the section prompt already states as "It shows N items".
+ *    Nothing read it back.
+ *  - **A region**: `create[].fields` on a layout, which is that kind's own
+ *    field for the regions it has (`AI_LAYOUT_REGIONS`). A layout has no
+ *    properties, so the planner is asked there for the one thing about a
+ *    layout worth promising and worth checking — a checkable assertion the
+ *    planner emits beside its prose, rather than English parsed out of it.
+ *
+ * ── It fails closed ──────────────────────────────────────────────────────
+ *
+ * Every function here answers "the plan is kept" only when it could look. A
+ * layout the step never read is not a layout whose regions are present; the
+ * layout door turns that into a stop for review rather than a `Done`. What it
+ * will not do is guess: a count it cannot settle from the document — items a
+ * collection fills at render — is not reported as short.
+ *
+ * The findings are ordinary `AiDoctrineViolation`s, so they ride the
+ * mechanism every other rule rides: `runValidatedGeneration` re-asks the
+ * model once with them, and a second answer that still breaks one stops the
+ * job for a person with `aiDoctrineReview`. They carry `rule: null` on
+ * purpose. The seventeen rules are how a document is BUILT; keeping the plan
+ * is not one of them, and numbering these as rule 7 would print "Rule 7
+ * (Reuse before creating)" over a finding about a count.
+ */ /** A count below this is not a repeat, so a plan promising one promises nothing to count. */ export const AI_PLAN_ITEMS_MIN = 2;
+/**
+ * The regions the confirmed plan's layout creation names, and the words it
+ * named that no region answers to. A plan with no layout creation names none.
+ */ export function aiPlannedLayoutRegions(plan) {
+    var _ref;
+    var _aiPlanCreation;
+    const regions = new Set();
+    const unreadable = [];
+    for (const field of (_ref = (_aiPlanCreation = aiPlanCreation(plan, 'layout')) == null ? void 0 : _aiPlanCreation.fields) != null ? _ref : []){
+        const region = aiLayoutRegionOf(field);
+        if (region) regions.add(region);
+        else unreadable.push(field);
+    }
+    return {
+        regions: [
+            ...regions
+        ],
+        unreadable
+    };
+}
+/**
+ * The plan's promised regions against a built layout: one finding naming
+ * every region the plan lists that the layout does not carry, and one naming
+ * a word the vocabulary could not read, which is a promise this check cannot
+ * settle either way.
+ */ export function aiPlanRegionViolations(plan, tree) {
+    const { regions, unreadable } = aiPlannedLayoutRegions(plan);
+    const built = aiTreeLayoutRegions(tree);
+    const violations = [];
+    const missing = regions.filter((region)=>!built.has(region));
+    if (missing.length) {
+        const one = missing.length === 1;
+        violations.push({
+            rule: null,
+            code: 'plan-region-missing',
+            message: `The confirmed plan gives this layout ${listed(missing)}, and the layout has no ${one ? 'such region' : 'such regions'}. Build ${one ? 'it' : 'each of them'}: a sidebar is a Section whose element is aside, a header a Section whose element is header or an App Bar, a nav a Section whose element is nav, a footer a Section whose element is footer, and the main region the Layout Slot.`
+        });
+    }
+    if (unreadable.length) {
+        violations.push({
+            rule: null,
+            code: 'plan-region-unreadable',
+            message: `The confirmed plan gives this layout ${listed(unreadable)}, which is no region this platform builds, so nothing can check the layout has ${unreadable.length === 1 ? 'it' : 'them'}. A layout's regions are ${AI_LAYOUT_REGION_NAMES.join(', ')}.`
+        });
+    }
+    return violations;
+}
+/**
+ * The plan's promised item count against a built section. Silent where there
+ * is nothing to settle: a section promising fewer than `AI_PLAN_ITEMS_MIN`
+ * promises no repeat, and one whose items a collection fills draws them from
+ * data at render, where the document cannot be counted and rule 8 asked for
+ * exactly that. Silent, too, when the section shows MORE than it promised:
+ * the count is read generously (`aiRepeatedItemCount`), so a number above the
+ * promise is as likely to be the reading as the section.
+ */ export function aiPlanItemCountViolations(section, tree) {
+    if (section.items < AI_PLAN_ITEMS_MIN) return [];
+    if (aiBindsRepeatedItems(tree)) return [];
+    const shown = aiRepeatedItemCount(tree);
+    if (shown >= section.items) return [];
+    return [
+        {
+            rule: null,
+            code: 'plan-items-short',
+            message: `The confirmed plan says the "${section.name}" section shows ${section.items} items, and this section shows ${shown}. Build all ${section.items}.`
+        }
+    ];
+}
+/**
+ * The counts the plan's sections promised against a page a COPY produced
+ * (AGL-3024), read over the whole page because a copy has no section of the
+ * plan's in it to read one at a time.
+ *
+ * A copied screen carries the SOURCE's nodes under the source's ids: nothing
+ * maps "the practice areas section" onto a subtree of it, so the per-section
+ * reading `aiPlanItemCountViolations` does at a generation pass has nothing
+ * to stand on here. What can still be settled is the weaker claim, and it is
+ * the one that catches the measured shape: a plan promising a section of four
+ * against a copy in which NO group of four repeated things exists anywhere is
+ * a promise the copy did not keep, whichever section was meant to keep it.
+ *
+ * Weaker on purpose, and so quieter: a copy holding six of something else
+ * reads as six and is let through. A screen carries no app bar and no footer
+ * — those are its layout's — so what is counted is the page's own content.
+ */ export function aiPlanCopiedPageViolations(screen, tree) {
+    const promised = screen.sections.filter((section)=>section.items >= AI_PLAN_ITEMS_MIN).sort((a, b)=>b.items - a.items)[0];
+    if (!promised) return [];
+    if (aiBindsRepeatedItems(tree)) return [];
+    const shown = aiRepeatedItemCount(tree);
+    if (shown >= promised.items) return [];
+    return [
+        {
+            rule: null,
+            code: 'plan-items-short',
+            message: `The confirmed plan says the "${promised.name}" section shows ${promised.items} items, and this page is a copy that shows at most ${shown} of anything. Build the ${promised.items}.`
+        }
+    ];
+}
+/** `"a"`, `"a" and "b"`, `"a", "b" and "c"`. */ function listed(values) {
+    const quoted = values.map((value)=>`"${value}"`);
+    return quoted.length <= 1 ? quoted.join('') : `${quoted.slice(0, -1).join(', ')} and ${quoted[quoted.length - 1]}`;
+}
+
+//# sourceMappingURL=ai-job-plan-conformance.js.map

package/src/lib/jobs/ai-job-plan-conformance.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/jobs/ai-job-plan-conformance.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 { AiBuildPlanScreen, AiBuildPlanSection } from '../model/ai-build-plan'\nimport type { AiJobPlan } from '../model/ai-jobs.types'\nimport {\n  AI_LAYOUT_REGION_NAMES,\n  aiBindsRepeatedItems,\n  aiLayoutRegionOf,\n  aiRepeatedItemCount,\n  aiTreeLayoutRegions,\n  type AiDoctrineTree,\n  type AiDoctrineViolation,\n  type AiLayoutRegion,\n} from '../runtime/ai-doctrine-validators'\nimport { aiPlanCreation } from './ai-job-generation'\n\n/**\n * The build held to the plan the member confirmed (AGL-3024).\n *\n * The doctrine validators ask whether an artifact was built the way a careful\n * author builds one. They do not ask whether it is the artifact the plan\n * PROMISED, and a build that quietly delivers less still reports `Done` —\n * which is the dangerous part, because `Done` is what tells the customer they\n * have no reason to re-read it. Measured on beta.139: a plan promising four\n * practice areas built three cards; a plan promising a layout with a sidebar\n * built a verbatim copy of the base layout, the word \"sidebar\" nowhere in it.\n *\n * ── Structured commitments, never prose ──────────────────────────────────\n *\n * A plan's rationale (`why`) is prose a model wrote, and matching English\n * against a node tree after the fact would be a second guess dressed as a\n * check. Only the plan's STRUCTURE is read here, and only the two shapes that\n * are already numbers or names in `ai-build-plan.ts`:\n *\n *  - **A count**: `screens[].sections[].items`, which the plan already\n *    carries and the section prompt already states as \"It shows N items\".\n *    Nothing read it back.\n *  - **A region**: `create[].fields` on a layout, which is that kind's own\n *    field for the regions it has (`AI_LAYOUT_REGIONS`). A layout has no\n *    properties, so the planner is asked there for the one thing about a\n *    layout worth promising and worth checking — a checkable assertion the\n *    planner emits beside its prose, rather than English parsed out of it.\n *\n * ── It fails closed ──────────────────────────────────────────────────────\n *\n * Every function here answers \"the plan is kept\" only when it could look. A\n * layout the step never read is not a layout whose regions are present; the\n * layout door turns that into a stop for review rather than a `Done`. What it\n * will not do is guess: a count it cannot settle from the document — items a\n * collection fills at render — is not reported as short.\n *\n * The findings are ordinary `AiDoctrineViolation`s, so they ride the\n * mechanism every other rule rides: `runValidatedGeneration` re-asks the\n * model once with them, and a second answer that still breaks one stops the\n * job for a person with `aiDoctrineReview`. They carry `rule: null` on\n * purpose. The seventeen rules are how a document is BUILT; keeping the plan\n * is not one of them, and numbering these as rule 7 would print \"Rule 7\n * (Reuse before creating)\" over a finding about a count.\n */\n\n/** A count below this is not a repeat, so a plan promising one promises nothing to count. */\nexport const AI_PLAN_ITEMS_MIN = 2\n\n/**\n * The regions the confirmed plan's layout creation names, and the words it\n * named that no region answers to. A plan with no layout creation names none.\n */\nexport function aiPlannedLayoutRegions(plan: AiJobPlan | null): {\n  regions: AiLayoutRegion[]\n  unreadable: string[]\n} {\n  const regions = new Set<AiLayoutRegion>()\n  const unreadable: string[] = []\n  for (const field of aiPlanCreation(plan, 'layout')?.fields ?? []) {\n    const region = aiLayoutRegionOf(field)\n    if (region) regions.add(region)\n    else unreadable.push(field)\n  }\n  return { regions: [...regions], unreadable }\n}\n\n/**\n * The plan's promised regions against a built layout: one finding naming\n * every region the plan lists that the layout does not carry, and one naming\n * a word the vocabulary could not read, which is a promise this check cannot\n * settle either way.\n */\nexport function aiPlanRegionViolations(\n  plan: AiJobPlan | null,\n  tree: AiDoctrineTree,\n): AiDoctrineViolation[] {\n  const { regions, unreadable } = aiPlannedLayoutRegions(plan)\n  const built = aiTreeLayoutRegions(tree)\n  const violations: AiDoctrineViolation[] = []\n  const missing = regions.filter((region) => !built.has(region))\n  if (missing.length) {\n    const one = missing.length === 1\n    violations.push({\n      rule: null,\n      code: 'plan-region-missing',\n      message: `The confirmed plan gives this layout ${listed(\n        missing,\n      )}, and the layout has no ${one ? 'such region' : 'such regions'}. Build ${\n        one ? 'it' : 'each of them'\n      }: a sidebar is a Section whose element is aside, a header a Section whose element is header or an App Bar, a nav a Section whose element is nav, a footer a Section whose element is footer, and the main region the Layout Slot.`,\n    })\n  }\n  if (unreadable.length) {\n    violations.push({\n      rule: null,\n      code: 'plan-region-unreadable',\n      message: `The confirmed plan gives this layout ${listed(\n        unreadable,\n      )}, which is no region this platform builds, so nothing can check the layout has ${\n        unreadable.length === 1 ? 'it' : 'them'\n      }. A layout's regions are ${AI_LAYOUT_REGION_NAMES.join(', ')}.`,\n    })\n  }\n  return violations\n}\n\n/**\n * The plan's promised item count against a built section. Silent where there\n * is nothing to settle: a section promising fewer than `AI_PLAN_ITEMS_MIN`\n * promises no repeat, and one whose items a collection fills draws them from\n * data at render, where the document cannot be counted and rule 8 asked for\n * exactly that. Silent, too, when the section shows MORE than it promised:\n * the count is read generously (`aiRepeatedItemCount`), so a number above the\n * promise is as likely to be the reading as the section.\n */\nexport function aiPlanItemCountViolations(\n  section: Pick<AiBuildPlanSection, 'name' | 'items'>,\n  tree: AiDoctrineTree,\n): AiDoctrineViolation[] {\n  if (section.items < AI_PLAN_ITEMS_MIN) return []\n  if (aiBindsRepeatedItems(tree)) return []\n  const shown = aiRepeatedItemCount(tree)\n  if (shown >= section.items) return []\n  return [\n    {\n      rule: null,\n      code: 'plan-items-short',\n      message: `The confirmed plan says the \"${section.name}\" section shows ${section.items} items, and this section shows ${shown}. Build all ${section.items}.`,\n    },\n  ]\n}\n\n/**\n * The counts the plan's sections promised against a page a COPY produced\n * (AGL-3024), read over the whole page because a copy has no section of the\n * plan's in it to read one at a time.\n *\n * A copied screen carries the SOURCE's nodes under the source's ids: nothing\n * maps \"the practice areas section\" onto a subtree of it, so the per-section\n * reading `aiPlanItemCountViolations` does at a generation pass has nothing\n * to stand on here. What can still be settled is the weaker claim, and it is\n * the one that catches the measured shape: a plan promising a section of four\n * against a copy in which NO group of four repeated things exists anywhere is\n * a promise the copy did not keep, whichever section was meant to keep it.\n *\n * Weaker on purpose, and so quieter: a copy holding six of something else\n * reads as six and is let through. A screen carries no app bar and no footer\n * — those are its layout's — so what is counted is the page's own content.\n */\nexport function aiPlanCopiedPageViolations(\n  screen: Pick<AiBuildPlanScreen, 'sections'>,\n  tree: AiDoctrineTree,\n): AiDoctrineViolation[] {\n  const promised = screen.sections\n    .filter((section) => section.items >= AI_PLAN_ITEMS_MIN)\n    .sort((a, b) => b.items - a.items)[0]\n  if (!promised) return []\n  if (aiBindsRepeatedItems(tree)) return []\n  const shown = aiRepeatedItemCount(tree)\n  if (shown >= promised.items) return []\n  return [\n    {\n      rule: null,\n      code: 'plan-items-short',\n      message: `The confirmed plan says the \"${promised.name}\" section shows ${promised.items} items, and this page is a copy that shows at most ${shown} of anything. Build the ${promised.items}.`,\n    },\n  ]\n}\n\n/** `\"a\"`, `\"a\" and \"b\"`, `\"a\", \"b\" and \"c\"`. */\nfunction listed(values: readonly string[]): string {\n  const quoted = values.map((value) => `\"${value}\"`)\n  return quoted.length <= 1\n    ? quoted.join('')\n    : `${quoted.slice(0, -1).join(', ')} and ${quoted[quoted.length - 1]}`\n}\n"],"names":["AI_LAYOUT_REGION_NAMES","aiBindsRepeatedItems","aiLayoutRegionOf","aiRepeatedItemCount","aiTreeLayoutRegions","aiPlanCreation","AI_PLAN_ITEMS_MIN","aiPlannedLayoutRegions","plan","regions","Set","unreadable","field","fields","region","add","push","aiPlanRegionViolations","tree","built","violations","missing","filter","has","length","one","rule","code","message","listed","join","aiPlanItemCountViolations","section","items","shown","name","aiPlanCopiedPageViolations","screen","promised","sections","sort","a","b","values","quoted","map","value","slice"],"mappings":"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"}

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

@@ -0,0 +1,196 @@
+/**
+ * @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 { AglynOrgBilling } from '@aglyn/aglyn/foundation/definitions/org-billing.types';
+import { type AiBuildPlan } from '../model/ai-build-plan';
+import type { AiJob, AiJobKind, AiJobPlan, AiJobStatus } from '../model/ai-jobs.types';
+import { type AiPlanCapabilities, type AiPlanJobScope } from '../model/ai-plan-capabilities';
+import type { AiSiteInventory } from '../model/ai-site-inventory';
+import type { AiSystemBlock } from '../runtime/ai-runtime';
+import { readSiteInventory } from '../runtime/site-inventory';
+import { aiJobAdmissionRefusal } from './ai-job-admission';
+import { type AiJobStepRunner } from './ai-job-text-step';
+/**
+ * The plan step (AGL-2935): the first step of every job that builds site
+ * structure. Before a node is generated, the model answers with a typed plan
+ * — what the site already has that the job reuses, what it creates and why,
+ * and the screens it builds from them — held to the doctrine's plan rules
+ * against the site's inventory and re-asked once when it breaks one.
+ *
+ * A plan that passes is kept on the job, and the job stops for review: the
+ * member reads what it will build before a credit is spent building it, and
+ * confirms through the resume door. A plan that still breaks a rule on its
+ * re-ask stops the job the same way, with the rules named. Either way the
+ * step writes nothing itself; the machine records the plan, the spend and
+ * the stop, as it records every step.
+ *
+ * ── Told what it may create, refused what it cannot build (AGL-3030) ─────
+ *
+ * Before it asks, the step reads what the job may create on its site: the
+ * workspace's plan, the site's counts against its limits, and — for a kind
+ * that builds only some plans — what the job builds itself. The user turn
+ * states it, the plan rules refuse a creation outside it with the one re-ask,
+ * and where the workspace keeps no reusable components they accept the page
+ * built inline. A plan the confirm door would still refuse — the kind's own
+ * admission, handed the plan, as the resume door hands it — is refused HERE,
+ * before a member is shown a Confirm: the job fails with the door's sentence,
+ * its plan is not kept, and it holds nothing.
+ */
+/** The plan step's own instructions, cached after the doctrine. */
+export declare const AI_JOB_PLAN_INSTRUCTIONS: readonly AiSystemBlock[];
+/**
+ * The plan step's time (AGL-3026, AGL-3036): its two inventory-lookup rounds,
+ * its answer and its re-ask at the routing table's ceiling for `job.plan`, on
+ * the tier that step kind is served from, with the step's reads and writes,
+ * at the rates `ai-job-budget.ts` assumes — fitted to what a beat can give a
+ * step, so the served tier asks a little under the routing ceiling.
+ */
+export declare const AI_JOB_PLAN_STEP_BUDGET: import("./ai-job-budget").AiJobStepBudget;
+/**
+ * The least time a plan needs before it starts. Registered with the step, so
+ * an inline door never starts a plan. A plan thinks before it answers and
+ * routinely runs past an inline door's budget, and a provider call that
+ * budget cuts off is still generated and billed upstream while the meter
+ * records nothing. The beat starts a plan only with this much of its own
+ * budget left, and a spec holds it inside that budget.
+ */
+export declare const AI_JOB_PLAN_STEP_MINIMUM_MS: number;
+/**
+ * The plan's answer ceiling on the model a job runs: the most whose worst
+ * case fits the least time the step registered, and never more than the
+ * routing table's. A model the catalog does not know is planned at the
+ * slowest.
+ */
+export declare function aiJobPlanMaxTokens(model: string): number;
+/** What the member reads while a plan waits for them. */
+export declare const AI_JOB_PLAN_REVIEW_COPY = "The plan is ready. Review what the job will reuse and create, then confirm it to build.";
+/**
+ * The job as the plan step's user turn: its kind, its brief, its scalar
+ * inputs and, where the job read them, what it may create on its site
+ * (AGL-3030). Per workspace and per site, which is why they ride here and
+ * never in a system block the platform's cache entry is keyed on.
+ */
+export declare function aiJobPlanPrompt(job: Pick<AiJob, 'kind' | 'brief' | 'inputs'>, capabilities?: AiPlanCapabilities | null): string;
+/** A kind that builds only some plans: the creations it makes, and the shapes it refuses. */
+export interface AiJobPlanScope extends AiPlanJobScope {
+    /** Why a job of the kind cannot build a plan of this shape; `null` when it can. Pure. */
+    shapeRefusal: (plan: AiBuildPlan) => string | null;
+}
+/**
+ * The kinds whose confirm door builds only some plans (AGL-3030). A page job
+ * builds one screen and a scaffold four to eight; each builds only the
+ * creations its list names. Every other planned kind builds its own one
+ * output, and its plan is held to the workspace alone.
+ */
+export declare const AI_JOB_PLAN_SCOPES: Readonly<Partial<Record<AiJobKind, AiJobPlanScope>>>;
+/**
+ * The inventory names of every id the plan references, so the proposal reads
+ * "the Services layout" rather than an id — kept on the plan because the
+ * inventory is not read again when the member opens it.
+ */
+export declare function aiPlanLabels(plan: AiBuildPlan, inventory: AiSiteInventory | null): Record<string, string>;
+/**
+ * How long a plan may be reused for (AGL-2937).
+ *
+ * The window is what makes reuse safe rather than merely cheap. The key
+ * already covers everything the request said — the brief, the inputs, the
+ * model and the prompt as rendered, site inventory included — so a plan is
+ * reused only when nothing the model was shown has changed. What the key
+ * cannot see is the world outside the request: a page published, a component
+ * renamed after the inventory was read, a member who meant something
+ * different the second time. Fifteen minutes is short enough that the answer
+ * is still the one the site would give, and long enough to cover what reuse
+ * is actually for — the same brief run twice in a sitting, a job resubmitted
+ * after a refused reservation, two members starting the same work.
+ */
+export declare const AI_PLAN_REUSE_WINDOW_MS: number;
+/** Jobs one lookup reads. More than one can share a key; the newest plan wins. */
+export declare const AI_PLAN_REUSE_CANDIDATES = 5;
+/** A job whose plan might be reused, as the finder reports it. */
+export interface AiJobPlanCandidate {
+    jobId: string;
+    status: AiJobStatus;
+    plan: AiJobPlan;
+}
+/**
+ * The digest a plan is reused by: the whole request, never the answer.
+ *
+ * It hashes what the model was asked and what it was shown — the job's kind
+ * and site, the user turn (which carries the trimmed brief and every scalar
+ * input), the model that would answer, every rendered system block including
+ * the site inventory, and the tool's schema. Two requests that hash the same
+ * would have been sent the same bytes to the same model, so the second can
+ * keep the first's answer.
+ *
+ * The version tag is the escape hatch: anything that changes what a key
+ * MEANS, rather than what it covers, bumps it and strands every old key
+ * harmlessly, since a key nothing matches simply asks the model.
+ */
+export declare function aiJobPlanKey(input: {
+    job: Pick<AiJob, 'kind' | 'hostId'>;
+    prompt: string;
+    model: string;
+    system: readonly AiSystemBlock[];
+}): string;
+/**
+ * The newest plan worth reusing out of what the finder returned: another
+ * job's, still proposed or already confirmed, on a job that was neither
+ * canceled nor failed, proposed inside the window.
+ *
+ * A canceled or failed job is excluded even though its plan may be perfectly
+ * good: those are the jobs a member walked away from, and handing their plan
+ * to the next one would make a rejected answer look like a fresh one.
+ */
+export declare function aiReusablePlan(candidates: readonly AiJobPlanCandidate[], context: {
+    jobId: string;
+    now: Date;
+}): AiJobPlanCandidate | null;
+export type AiJobPlanFinder = (orgId: string, key: string, firestore?: FirebaseFirestore.Firestore) => Promise<AiJobPlanCandidate[]>;
+/**
+ * The finder the step uses in production: an equality on `plan.key` inside
+ * the org's own jobs.
+ *
+ * One equality on one field, with no ordering beside it, so Firestore's
+ * automatic single-field index answers it and no composite index is deployed.
+ * The window and the statuses are applied in memory instead, which is what
+ * keeps it that way.
+ */
+export declare const findAiJobsByPlanKey: AiJobPlanFinder;
+/** What a job may create on its site, read for the plan step; `null` for no site. */
+export type AiPlanCapabilitiesReader = (input: {
+    job: AiJob;
+    org: Partial<AglynOrgBilling> | null;
+    firestore: FirebaseFirestore.Firestore;
+}) => Promise<AiPlanCapabilities | null>;
+/** The reader the step uses in production: the draft bands' own arithmetic, for the job's site. */
+export declare const readAiJobPlanCapabilities: AiPlanCapabilitiesReader;
+export interface AiJobPlanStepDeps {
+    /** The inventory reader; specs hand in a fake. */
+    readInventory?: typeof readSiteInventory;
+    /** The reuse lookup; specs hand in a fake, and `null` turns reuse off. */
+    findPlansByKey?: AiJobPlanFinder | null;
+    /** What the job may create on its site (AGL-3030); specs and the eval recorder hand in their own. */
+    readCapabilities?: AiPlanCapabilitiesReader;
+    /** The kind's admission, asked of a plan before it is kept; the registry's otherwise. */
+    admissionRefusal?: typeof aiJobAdmissionRefusal;
+}
+export declare function createAiJobPlanStep(deps?: AiJobPlanStepDeps): AiJobStepRunner;
+export declare const runAiJobPlanStep: AiJobStepRunner;
+/**
+ * Registers the plan step every planned kind runs first, with the least time
+ * a plan needs; the plugin's console surface calls it.
+ */
+export declare function registerAiJobPlan(): void;