@aglyn/plugins-ai 1.0.0-beta.143

package/src/lib/model/ai-site-start-seo.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/model/ai-site-start-seo.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 { SCREEN_SEO_TEXT_GUIDANCE } from '@aglyn/aglyn/app-utils/screen-seo-fields'\nimport type { AiJobOutput } from './ai-jobs.types'\nimport { aiSiteWords, type AiSiteWords } from './ai-site-job'\n\n/**\n * The site's own search listing, from the answers (AGL-2918).\n *\n * A site has two SEO title-and-description pairs. A page's is the page's, and\n * the scaffold's page step writes one for each page it builds. The SITE's is\n * the fallback every page with none of its own publishes, and it is the one\n * nothing was filling: a newly created site carries whatever its creation\n * seeded, which is its subdomain or its display name, and a scaffolded site\n * would publish pages listed under that.\n *\n * ── Derived, not generated ───────────────────────────────────────────────\n *\n * The two values here are arithmetic on what the person typed, not a model's\n * writing, and that is deliberate on three counts. The answers are already\n * the sentence the fallback wants — \"what kind of site\" IS what the site is,\n * and \"who it is for\" IS who it is for. It costs nothing, on a job that is\n * already tens of model calls. And it is available on the scaffold's first\n * pass, so the proposal is waiting while the pages are still building rather\n * than arriving after them.\n *\n * ── A proposal, never a write ────────────────────────────────────────────\n *\n * Nothing here writes the site's settings. The values travel as a job output\n * and land in the site SEO form as unsaved edits through the `hostSeo` zone's\n * own `proposeDraft`; the form's Update is what stores them, and a person who\n * never opens that form is left with exactly what they had.\n *\n * Pure: strings in, strings out, no Firestore and no React.\n */\n\n/**\n * The site SEO form's field names, which are what a proposal is keyed by.\n *\n * The same two strings the host settings SEO section names its Title and\n * Description inputs. They are stated here rather than imported because the\n * form is the console's and this is a plugin: the zone's `proposeDraft`\n * ignores a key the form does not edit, so a name that drifted would stage\n * nothing rather than stage something wrong.\n */\nexport const AI_SITE_SEO_FORM_FIELDS = {\n  title: 'seo.title',\n  description: 'seo.description',\n} as const\n\nexport type AiSiteSeoFormField =\n  (typeof AI_SITE_SEO_FORM_FIELDS)[keyof typeof AI_SITE_SEO_FORM_FIELDS]\n\n/**\n * What each value is held to: the lengths the SEO editors guide a listing to,\n * which are the same two the host settings form counts down from.\n */\nexport const AI_SITE_SEO_LIMITS = SCREEN_SEO_TEXT_GUIDANCE\n\n/** The kind an `seo` output carries when it is a guided start's site listing. */\nexport const AI_SITE_SEO_PROPOSAL_KIND = 'site-listing'\n\n/** The id the scaffold reports its one site listing under. */\nexport const AI_SITE_SEO_OUTPUT_ID = 'site:listing'\n\nexport interface AiSiteSeoProposal {\n  kind: typeof AI_SITE_SEO_PROPOSAL_KIND\n  /** Values for the site SEO form, by field name. */\n  values: Record<AiSiteSeoFormField, string>\n  /** Customer-safe lines about where the words came from. */\n  notes: string[]\n}\n\n/** What the proposal says about itself wherever it is shown. */\nexport const AI_SITE_SEO_NOTE =\n  'Written from what you said the site is and who it is for, not from its pages — read it before you save it.'\n\n/** Held to a length, cut at a word rather than mid-word. */\nfunction clip(value: string, max: number): string {\n  const text = value.replace(/\\s+/g, ' ').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/**\n * The leading article dropped and the first letter raised: \"a neighborhood\n * dog groomer\" is how a person answers the question and is not how a title\n * starts. Anything the person already capitalized is left alone, so a name\n * typed as the site type survives.\n */\nfunction asSubject(about: string): string {\n  // `\\b` rather than `\\s+`, so an answer that is ONLY an article leaves\n  // nothing behind and the caller proposes nothing: a one-letter title is a\n  // worse thing to stage into a required field than no proposal at all.\n  const text = about.replace(/\\s+/g, ' ').trim().replace(/^(?:an?|the)\\b\\s*/i, '')\n  if (!text) return ''\n  return text[0].toUpperCase() + text.slice(1)\n}\n\n/** A sentence closed with one period, and never two. */\nfunction sentence(text: string): string {\n  const trimmed = text.trim()\n  return /[.!?]$/.test(trimmed) ? trimmed : `${trimmed}.`\n}\n\n/**\n * What the listing is built from: either answer may be missing, because the\n * guided start requires only the first of them.\n */\nexport interface AiSiteSeoInput extends Partial<AiSiteWords> {\n  /** The site's own name where the job carries one; empty for a site named on its pages. */\n  siteName?: string\n}\n\n/**\n * The site's fallback listing from the answers, or `null` when the answers\n * describe no site at all — a job with no `businessType` has nothing to\n * propose, and an empty proposal is worse than none.\n */\nexport function aiSiteSeoProposal(input: AiSiteSeoInput): AiSiteSeoProposal | null {\n  const subject = asSubject(input.about ?? '')\n  if (!subject) return null\n  const name = (input.siteName ?? '').replace(/\\s+/g, ' ').trim()\n  const audience = (input.audience ?? '').replace(/\\s+/g, ' ').trim()\n  const title = clip(name ? `${name} — ${subject}` : subject, AI_SITE_SEO_LIMITS.title)\n  const described = name ? `${name} is ${input.about?.trim()}` : subject\n  const description = clip(\n    sentence(audience ? `${described}, for ${audience}` : described),\n    AI_SITE_SEO_LIMITS.description,\n  )\n  return {\n    kind: AI_SITE_SEO_PROPOSAL_KIND,\n    values: {\n      [AI_SITE_SEO_FORM_FIELDS.title]: title,\n      [AI_SITE_SEO_FORM_FIELDS.description]: description,\n    },\n    notes: [AI_SITE_SEO_NOTE],\n  }\n}\n\n/** The proposal a job's inputs imply, for the step that reports it. */\nexport function aiSiteSeoProposalForInputs(\n  inputs: Readonly<Record<string, unknown>> | null | undefined,\n): AiSiteSeoProposal | null {\n  const words = aiSiteWords(inputs)\n  const businessName = inputs?.['businessName']\n  return aiSiteSeoProposal({\n    ...words,\n    ...(typeof businessName === 'string' ? { siteName: businessName } : {}),\n  })\n}\n\n/** Whether a value is a record the reader may look inside. */\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null && !Array.isArray(value)\n}\n\n/**\n * The site listing a job's outputs carry, or `null` when they carry none.\n *\n * Read defensively: an output is whatever a past release wrote, so a proposal\n * whose values are not two strings is treated as no proposal rather than\n * staged into somebody's live SEO form.\n */\nexport function aiSiteSeoProposalOf(\n  outputs: readonly Pick<AiJobOutput, 'resource' | 'proposal'>[] | null | undefined,\n): AiSiteSeoProposal | null {\n  for (const output of outputs ?? []) {\n    if (output.resource !== 'seo') continue\n    const proposal = output.proposal\n    if (!isRecord(proposal) || proposal['kind'] !== AI_SITE_SEO_PROPOSAL_KIND) continue\n    const values = isRecord(proposal['values']) ? proposal['values'] : {}\n    const title = values[AI_SITE_SEO_FORM_FIELDS.title]\n    const description = values[AI_SITE_SEO_FORM_FIELDS.description]\n    if (typeof title !== 'string' || typeof description !== 'string') continue\n    if (!title.trim() || !description.trim()) continue\n    const notes = Array.isArray(proposal['notes'])\n      ? proposal['notes'].filter((note): note is string => typeof note === 'string')\n      : []\n    return {\n      kind: AI_SITE_SEO_PROPOSAL_KIND,\n      values: {\n        [AI_SITE_SEO_FORM_FIELDS.title]: title,\n        [AI_SITE_SEO_FORM_FIELDS.description]: description,\n      },\n      notes,\n    }\n  }\n  return null\n}\n"],"names":["SCREEN_SEO_TEXT_GUIDANCE","aiSiteWords","AI_SITE_SEO_FORM_FIELDS","title","description","AI_SITE_SEO_LIMITS","AI_SITE_SEO_PROPOSAL_KIND","AI_SITE_SEO_OUTPUT_ID","AI_SITE_SEO_NOTE","clip","value","max","text","replace","trim","length","cut","slice","space","lastIndexOf","asSubject","about","toUpperCase","sentence","trimmed","test","aiSiteSeoProposal","input","subject","name","siteName","audience","described","kind","values","notes","aiSiteSeoProposalForInputs","inputs","words","businessName","isRecord","Array","isArray","aiSiteSeoProposalOf","outputs","output","resource","proposal","filter","note"],"mappings":"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"}

package/src/lib/model/ai-site-start.d.ts

@@ -0,0 +1,122 @@
+/**
+ * @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 AiSiteJobInputs, type AiSiteSubmissions } from './ai-site-job';
+/**
+ * The guided start (AGL-2918): the questions a person answers on a site they
+ * have just made, and the site job those answers become.
+ *
+ * A scaffold already exists — the `site` job plans four to eight pages, a
+ * layout, a contact form, a palette and a welcome email, and builds every one
+ * of them as a draft. What it had no way in through was a brief: somebody had
+ * to know what to write, on a site where nothing has happened yet. So this
+ * module is the QUESTIONS, and nothing else: what is asked, what an answer may
+ * be, and how a set of answers becomes the brief and the scalar inputs the
+ * `site` door already takes.
+ *
+ * ── Answering is never the way out ───────────────────────────────────────
+ *
+ * There is no answer here that means "not this". The way past the questions
+ * is the `hostFirstRun` zone's own `startBlank`, which is drawn beside them
+ * from the first one and creates nothing at all — see the zone in
+ * `CONSOLE_WIDGET_SLOTS`. Putting the exit inside the question set would make
+ * leaving a thing you answer your way to, and it is not.
+ *
+ * ── Every answer but the first is optional ───────────────────────────────
+ *
+ * Only what a site is FOR has no default worth guessing. The audience narrows
+ * the copy, the example steers the shape, the page count and the welcome
+ * email are defaults a person may change — so a person who types six words
+ * and confirms gets a planned site, and the rest of the questions are there
+ * for the person who wants to answer them.
+ *
+ * Pure: shapes, vocabularies and two string builders. No React, no network,
+ * and no import of the starter catalog — {@link AI_SITE_START_EXAMPLES} names
+ * the starters rather than reading them, so the console does not carry a
+ * catalog of node maps to draw five cards. `ai-site-start.spec.ts` holds the
+ * two lists to each other.
+ */
+/** A worked example a person picks to steer what the site should look like. */
+export interface AiSiteStartExample {
+    /** A `STARTER_TEMPLATES` id, which is a persisted identifier. */
+    id: string;
+    /** The starter as its card names it. */
+    label: string;
+    /** The starter's category, which is how the examples group. */
+    category: string;
+    /** What the example is, in one line a person reads before picking it. */
+    blurb: string;
+}
+/**
+ * The examples the start offers, in the order they are shown. The platform's
+ * own starter sites: a person who has no words for what they want has seen
+ * these five shapes before, and picking one says more than a sentence would.
+ */
+export declare const AI_SITE_START_EXAMPLES: readonly AiSiteStartExample[];
+/**
+ * Kinds of site offered beside the first question's box, so answering it can
+ * be a tap. They fill the box rather than replacing it: what somebody is
+ * building is theirs to say, and a list of eight is a list somebody is not on.
+ */
+export declare const AI_SITE_START_TYPES: readonly string[];
+/** What a person answered; the shape the card holds and the brief is built from. */
+export interface AiSiteStartAnswers {
+    /** What kind of site this is. The one answer with no default. */
+    siteType: string;
+    /** Who the site is for; empty when they did not say. */
+    audience: string;
+    /** The example they liked, by {@link AiSiteStartExample.id}; `null` for none. */
+    example: string | null;
+    /** How many pages to plan. */
+    pages: number;
+    /** Where the contact form's submissions go. */
+    submissions: AiSiteSubmissions;
+    /** Whether the scaffold also drafts a welcome email. */
+    welcomeEmail: boolean;
+}
+/**
+ * What the questions start on. Five pages because it is the middle of the
+ * band the scaffold builds, a welcome email because the scaffold drafts one
+ * unless it is told not to, and the Inbox because it is what every submission
+ * does anyway — filing a lead as well is the addition, and an addition is the
+ * thing a person should have to choose.
+ */
+export declare const AI_SITE_START_ANSWERS: AiSiteStartAnswers;
+/** The example an answer names, or `null` when it names none this list knows. */
+export declare function aiSiteStartExample(answers: AiSiteStartAnswers): AiSiteStartExample | null;
+/**
+ * Why these answers cannot start a site, in a sentence a person reads; `null`
+ * when they can. The door's own parser is what actually admits the job — this
+ * is what the card says before it asks for one.
+ */
+export declare function aiSiteStartRefusal(answers: AiSiteStartAnswers): string | null;
+/**
+ * The answers as the brief the `site` job is created with: the plan step reads
+ * it as the person's own words, so it says what they said and asks for nothing
+ * they did not.
+ */
+export declare function aiSiteStartBrief(answers: AiSiteStartAnswers): string;
+/**
+ * The answers as the `site` job's scalar inputs. Read by the door's
+ * {@link parseAiSiteJobInputs}, and put in front of the model one per line by
+ * the plan step, which is how the audience and the example reach the plan
+ * without a prompt of their own.
+ *
+ * The per-site variables an agency batch fills — the business name, the city,
+ * the brand — are left empty: this is one person's own site, and its name is
+ * on the site already.
+ */
+export declare function aiSiteStartInputs(answers: AiSiteStartAnswers): Omit<AiSiteJobInputs, 'batchId'>;

package/src/lib/model/ai-site-start.js

@@ -0,0 +1,159 @@
+/**
+ * @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_SITE_INPUT_MAX_CHARS, AI_SITE_PAGES, AI_SITE_SUBMISSIONS } from "./ai-site-job.js";
+/**
+ * The examples the start offers, in the order they are shown. The platform's
+ * own starter sites: a person who has no words for what they want has seen
+ * these five shapes before, and picking one says more than a sentence would.
+ */ export const AI_SITE_START_EXAMPLES = [
+    {
+        id: 'business',
+        label: 'Business',
+        category: 'Business',
+        blurb: 'A home page led by what you do, an about page and a contact page'
+    },
+    {
+        id: 'landing',
+        label: 'Landing Page',
+        category: 'Marketing',
+        blurb: 'One page that leads to one action, with the reasons to take it'
+    },
+    {
+        id: 'portfolio',
+        label: 'Portfolio',
+        category: 'Personal',
+        blurb: 'An introduction, a grid of work and a way to get in touch'
+    },
+    {
+        id: 'physical-shop',
+        label: 'Shop (physical products)',
+        category: 'Commerce',
+        blurb: 'Featured products, a shop to browse, and a cart'
+    },
+    {
+        id: 'digital-shop',
+        label: 'Shop (digital products)',
+        category: 'Commerce',
+        blurb: 'Downloads up front, a shop to browse, and a cart'
+    }
+];
+/**
+ * Kinds of site offered beside the first question's box, so answering it can
+ * be a tap. They fill the box rather than replacing it: what somebody is
+ * building is theirs to say, and a list of eight is a list somebody is not on.
+ */ export const AI_SITE_START_TYPES = [
+    'a local service business',
+    'a restaurant or cafe',
+    'a professional practice',
+    'a trades business',
+    'a shop',
+    'a nonprofit',
+    'a personal portfolio',
+    'an event'
+];
+/**
+ * What the questions start on. Five pages because it is the middle of the
+ * band the scaffold builds, a welcome email because the scaffold drafts one
+ * unless it is told not to, and the Inbox because it is what every submission
+ * does anyway — filing a lead as well is the addition, and an addition is the
+ * thing a person should have to choose.
+ */ export const AI_SITE_START_ANSWERS = {
+    siteType: '',
+    audience: '',
+    example: null,
+    pages: 5,
+    submissions: 'inbox',
+    welcomeEmail: true
+};
+/** The example an answer names, or `null` when it names none this list knows. */ export function aiSiteStartExample(answers) {
+    var _AI_SITE_START_EXAMPLES_find;
+    if (!answers.example) return null;
+    return (_AI_SITE_START_EXAMPLES_find = AI_SITE_START_EXAMPLES.find((entry)=>entry.id === answers.example)) != null ? _AI_SITE_START_EXAMPLES_find : null;
+}
+/**
+ * Why these answers cannot start a site, in a sentence a person reads; `null`
+ * when they can. The door's own parser is what actually admits the job — this
+ * is what the card says before it asks for one.
+ */ export function aiSiteStartRefusal(answers) {
+    const siteType = answers.siteType.trim();
+    if (!siteType) return 'Say what kind of site this is.';
+    if (siteType.length > AI_SITE_INPUT_MAX_CHARS) {
+        return `Keep what kind of site this is under ${AI_SITE_INPUT_MAX_CHARS} characters.`;
+    }
+    if (answers.audience.trim().length > AI_SITE_INPUT_MAX_CHARS) {
+        return `Keep who the site is for under ${AI_SITE_INPUT_MAX_CHARS} characters.`;
+    }
+    if (!Number.isInteger(answers.pages) || answers.pages < AI_SITE_PAGES.min || answers.pages > AI_SITE_PAGES.max) {
+        return `A site is planned with ${AI_SITE_PAGES.min} to ${AI_SITE_PAGES.max} pages.`;
+    }
+    if (answers.example !== null && !aiSiteStartExample(answers)) {
+        return 'Pick one of the examples, or none of them.';
+    }
+    if (!AI_SITE_SUBMISSIONS.includes(answers.submissions)) {
+        return 'Say where the contact form’s submissions go.';
+    }
+    return null;
+}
+/**
+ * The answers as the brief the `site` job is created with: the plan step reads
+ * it as the person's own words, so it says what they said and asks for nothing
+ * they did not.
+ */ export function aiSiteStartBrief(answers) {
+    const siteType = answers.siteType.trim();
+    const audience = answers.audience.trim();
+    const example = aiSiteStartExample(answers);
+    const sentences = [
+        `A ${answers.pages}-page website for ${siteType}.`
+    ];
+    if (audience) sentences.push(`It is for ${audience}.`);
+    if (example) {
+        sentences.push(`Follow the shape of the ${example.label} starter: ${example.blurb.toLowerCase()}.`);
+    }
+    sentences.push('Plan a page for each thing a visitor comes to do, and a contact form on the page that asks to be contacted.');
+    if (audience) {
+        // Said of the FORM as well as of the copy: who fills a form in is what
+        // decides which fields it asks for, and a brief that named the audience
+        // once, in a sentence about the pages, left the form to guess.
+        sentences.push(`Ask the contact form for what ${audience} would be asked for.`);
+    }
+    return sentences.join(' ');
+}
+/**
+ * The answers as the `site` job's scalar inputs. Read by the door's
+ * {@link parseAiSiteJobInputs}, and put in front of the model one per line by
+ * the plan step, which is how the audience and the example reach the plan
+ * without a prompt of their own.
+ *
+ * The per-site variables an agency batch fills — the business name, the city,
+ * the brand — are left empty: this is one person's own site, and its name is
+ * on the site already.
+ */ export function aiSiteStartInputs(answers) {
+    var _ref;
+    const example = aiSiteStartExample(answers);
+    return {
+        businessType: answers.siteType.trim(),
+        audience: answers.audience.trim(),
+        starter: (_ref = example == null ? void 0 : example.id) != null ? _ref : '',
+        pages: answers.pages,
+        businessName: '',
+        city: '',
+        brand: '',
+        submissions: answers.submissions,
+        welcomeEmail: answers.welcomeEmail
+    };
+}
+
+//# sourceMappingURL=ai-site-start.js.map

package/src/lib/model/ai-site-start.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/model/ai-site-start.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 {\n  AI_SITE_INPUT_MAX_CHARS,\n  AI_SITE_PAGES,\n  AI_SITE_SUBMISSIONS,\n  type AiSiteJobInputs,\n  type AiSiteSubmissions,\n} from './ai-site-job'\n\n/**\n * The guided start (AGL-2918): the questions a person answers on a site they\n * have just made, and the site job those answers become.\n *\n * A scaffold already exists — the `site` job plans four to eight pages, a\n * layout, a contact form, a palette and a welcome email, and builds every one\n * of them as a draft. What it had no way in through was a brief: somebody had\n * to know what to write, on a site where nothing has happened yet. So this\n * module is the QUESTIONS, and nothing else: what is asked, what an answer may\n * be, and how a set of answers becomes the brief and the scalar inputs the\n * `site` door already takes.\n *\n * ── Answering is never the way out ───────────────────────────────────────\n *\n * There is no answer here that means \"not this\". The way past the questions\n * is the `hostFirstRun` zone's own `startBlank`, which is drawn beside them\n * from the first one and creates nothing at all — see the zone in\n * `CONSOLE_WIDGET_SLOTS`. Putting the exit inside the question set would make\n * leaving a thing you answer your way to, and it is not.\n *\n * ── Every answer but the first is optional ───────────────────────────────\n *\n * Only what a site is FOR has no default worth guessing. The audience narrows\n * the copy, the example steers the shape, the page count and the welcome\n * email are defaults a person may change — so a person who types six words\n * and confirms gets a planned site, and the rest of the questions are there\n * for the person who wants to answer them.\n *\n * Pure: shapes, vocabularies and two string builders. No React, no network,\n * and no import of the starter catalog — {@link AI_SITE_START_EXAMPLES} names\n * the starters rather than reading them, so the console does not carry a\n * catalog of node maps to draw five cards. `ai-site-start.spec.ts` holds the\n * two lists to each other.\n */\n\n/** A worked example a person picks to steer what the site should look like. */\nexport interface AiSiteStartExample {\n  /** A `STARTER_TEMPLATES` id, which is a persisted identifier. */\n  id: string\n  /** The starter as its card names it. */\n  label: string\n  /** The starter's category, which is how the examples group. */\n  category: string\n  /** What the example is, in one line a person reads before picking it. */\n  blurb: string\n}\n\n/**\n * The examples the start offers, in the order they are shown. The platform's\n * own starter sites: a person who has no words for what they want has seen\n * these five shapes before, and picking one says more than a sentence would.\n */\nexport const AI_SITE_START_EXAMPLES: readonly AiSiteStartExample[] = [\n  {\n    id: 'business',\n    label: 'Business',\n    category: 'Business',\n    blurb: 'A home page led by what you do, an about page and a contact page',\n  },\n  {\n    id: 'landing',\n    label: 'Landing Page',\n    category: 'Marketing',\n    blurb: 'One page that leads to one action, with the reasons to take it',\n  },\n  {\n    id: 'portfolio',\n    label: 'Portfolio',\n    category: 'Personal',\n    blurb: 'An introduction, a grid of work and a way to get in touch',\n  },\n  {\n    id: 'physical-shop',\n    label: 'Shop (physical products)',\n    category: 'Commerce',\n    blurb: 'Featured products, a shop to browse, and a cart',\n  },\n  {\n    id: 'digital-shop',\n    label: 'Shop (digital products)',\n    category: 'Commerce',\n    blurb: 'Downloads up front, a shop to browse, and a cart',\n  },\n]\n\n/**\n * Kinds of site offered beside the first question's box, so answering it can\n * be a tap. They fill the box rather than replacing it: what somebody is\n * building is theirs to say, and a list of eight is a list somebody is not on.\n */\nexport const AI_SITE_START_TYPES: readonly string[] = [\n  'a local service business',\n  'a restaurant or cafe',\n  'a professional practice',\n  'a trades business',\n  'a shop',\n  'a nonprofit',\n  'a personal portfolio',\n  'an event',\n]\n\n/** What a person answered; the shape the card holds and the brief is built from. */\nexport interface AiSiteStartAnswers {\n  /** What kind of site this is. The one answer with no default. */\n  siteType: string\n  /** Who the site is for; empty when they did not say. */\n  audience: string\n  /** The example they liked, by {@link AiSiteStartExample.id}; `null` for none. */\n  example: string | null\n  /** How many pages to plan. */\n  pages: number\n  /** Where the contact form's submissions go. */\n  submissions: AiSiteSubmissions\n  /** Whether the scaffold also drafts a welcome email. */\n  welcomeEmail: boolean\n}\n\n/**\n * What the questions start on. Five pages because it is the middle of the\n * band the scaffold builds, a welcome email because the scaffold drafts one\n * unless it is told not to, and the Inbox because it is what every submission\n * does anyway — filing a lead as well is the addition, and an addition is the\n * thing a person should have to choose.\n */\nexport const AI_SITE_START_ANSWERS: AiSiteStartAnswers = {\n  siteType: '',\n  audience: '',\n  example: null,\n  pages: 5,\n  submissions: 'inbox',\n  welcomeEmail: true,\n}\n\n/** The example an answer names, or `null` when it names none this list knows. */\nexport function aiSiteStartExample(\n  answers: AiSiteStartAnswers,\n): AiSiteStartExample | null {\n  if (!answers.example) return null\n  return AI_SITE_START_EXAMPLES.find((entry) => entry.id === answers.example) ?? null\n}\n\n/**\n * Why these answers cannot start a site, in a sentence a person reads; `null`\n * when they can. The door's own parser is what actually admits the job — this\n * is what the card says before it asks for one.\n */\nexport function aiSiteStartRefusal(answers: AiSiteStartAnswers): string | null {\n  const siteType = answers.siteType.trim()\n  if (!siteType) return 'Say what kind of site this is.'\n  if (siteType.length > AI_SITE_INPUT_MAX_CHARS) {\n    return `Keep what kind of site this is under ${AI_SITE_INPUT_MAX_CHARS} characters.`\n  }\n  if (answers.audience.trim().length > AI_SITE_INPUT_MAX_CHARS) {\n    return `Keep who the site is for under ${AI_SITE_INPUT_MAX_CHARS} characters.`\n  }\n  if (\n    !Number.isInteger(answers.pages) ||\n    answers.pages < AI_SITE_PAGES.min ||\n    answers.pages > AI_SITE_PAGES.max\n  ) {\n    return `A site is planned with ${AI_SITE_PAGES.min} to ${AI_SITE_PAGES.max} pages.`\n  }\n  if (answers.example !== null && !aiSiteStartExample(answers)) {\n    return 'Pick one of the examples, or none of them.'\n  }\n  if (!(AI_SITE_SUBMISSIONS as readonly string[]).includes(answers.submissions)) {\n    return 'Say where the contact form’s submissions go.'\n  }\n  return null\n}\n\n/**\n * The answers as the brief the `site` job is created with: the plan step reads\n * it as the person's own words, so it says what they said and asks for nothing\n * they did not.\n */\nexport function aiSiteStartBrief(answers: AiSiteStartAnswers): string {\n  const siteType = answers.siteType.trim()\n  const audience = answers.audience.trim()\n  const example = aiSiteStartExample(answers)\n  const sentences = [\n    `A ${answers.pages}-page website for ${siteType}.`,\n  ]\n  if (audience) sentences.push(`It is for ${audience}.`)\n  if (example) {\n    sentences.push(\n      `Follow the shape of the ${example.label} starter: ${example.blurb.toLowerCase()}.`,\n    )\n  }\n  sentences.push(\n    'Plan a page for each thing a visitor comes to do, and a contact form on the page that asks to be contacted.',\n  )\n  if (audience) {\n    // Said of the FORM as well as of the copy: who fills a form in is what\n    // decides which fields it asks for, and a brief that named the audience\n    // once, in a sentence about the pages, left the form to guess.\n    sentences.push(`Ask the contact form for what ${audience} would be asked for.`)\n  }\n  return sentences.join(' ')\n}\n\n/**\n * The answers as the `site` job's scalar inputs. Read by the door's\n * {@link parseAiSiteJobInputs}, and put in front of the model one per line by\n * the plan step, which is how the audience and the example reach the plan\n * without a prompt of their own.\n *\n * The per-site variables an agency batch fills — the business name, the city,\n * the brand — are left empty: this is one person's own site, and its name is\n * on the site already.\n */\nexport function aiSiteStartInputs(\n  answers: AiSiteStartAnswers,\n): Omit<AiSiteJobInputs, 'batchId'> {\n  const example = aiSiteStartExample(answers)\n  return {\n    businessType: answers.siteType.trim(),\n    audience: answers.audience.trim(),\n    starter: example?.id ?? '',\n    pages: answers.pages,\n    businessName: '',\n    city: '',\n    brand: '',\n    submissions: answers.submissions,\n    welcomeEmail: answers.welcomeEmail,\n  }\n}\n"],"names":["AI_SITE_INPUT_MAX_CHARS","AI_SITE_PAGES","AI_SITE_SUBMISSIONS","AI_SITE_START_EXAMPLES","id","label","category","blurb","AI_SITE_START_TYPES","AI_SITE_START_ANSWERS","siteType","audience","example","pages","submissions","welcomeEmail","aiSiteStartExample","answers","find","entry","aiSiteStartRefusal","trim","length","Number","isInteger","min","max","includes","aiSiteStartBrief","sentences","push","toLowerCase","join","aiSiteStartInputs","businessType","starter","businessName","city","brand"],"mappings":"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"}

package/src/lib/model/ai-site-switch.d.ts

@@ -0,0 +1,56 @@
+/**
+ * @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.
+ */
+/**
+ * AI switched off for ONE site (AGL-3028).
+ *
+ * A site switches AI off through its `disabledPlugins` deny-list, the same
+ * field every per-site plugin switch writes. The plugin API dispatcher already
+ * answers 404 for a door whose request names that site as a top-level
+ * `hostId`, before the handler runs. What this module covers is everything
+ * the dispatcher cannot see:
+ *
+ * - a door whose site rides somewhere else in the body — the assistant's
+ *   `context.hostId`, the agency batch's `sites[].hostId`;
+ * - a job already QUEUED for the site, which the jobs beat runs with no
+ *   request at all.
+ *
+ * The workspace half of AI never passes through here. The add-on, credits,
+ * allotments, overage charging and close-out, the billing webhooks and the
+ * staff doors carry no site, so no site's switch can stop them.
+ *
+ * Read with the Firestore handle the caller already runs on, never through
+ * the admin barrel: the jobs machine and its specs hold no default app.
+ */
+/** What a person reads when a site's AI switch refused them. */
+export declare const AI_OFF_FOR_SITE_COPY = "AI is switched off for this site.";
+/** The refusal's status: the dispatcher's answer for a site-disabled plugin. */
+export declare const AI_OFF_FOR_SITE_STATUS = 404;
+/**
+ * Whether AI runs on the site this host document describes, under this org.
+ *
+ * Fails OPEN on an absent host document, as the dispatcher does: a site that
+ * cannot be read is not a site that switched AI off, and the doors below this
+ * refuse an unknown site for reasons of their own.
+ */
+export declare function isAiOnForSite(org: unknown, host: unknown): boolean;
+/**
+ * Whether the named site has AI switched off. `false` for no site: a request
+ * that names none is workspace-level, and no site's switch applies to it.
+ */
+export declare function isAiOffForSite(firestore: FirebaseFirestore.Firestore, org: unknown, hostId: string | null | undefined): Promise<boolean>;
+/** The door's answer when the site it names has AI switched off. */
+export declare function aiOffForSiteResponse(): Response;

package/src/lib/model/ai-site-switch.js

@@ -0,0 +1,73 @@
+/**
+ * @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 { isHostPluginEnabled } from "@aglyn/aglyn/plugin-manager/enabled-plugins";
+import { AI_PLUGIN_ID } from "../constants.js";
+/**
+ * AI switched off for ONE site (AGL-3028).
+ *
+ * A site switches AI off through its `disabledPlugins` deny-list, the same
+ * field every per-site plugin switch writes. The plugin API dispatcher already
+ * answers 404 for a door whose request names that site as a top-level
+ * `hostId`, before the handler runs. What this module covers is everything
+ * the dispatcher cannot see:
+ *
+ * - a door whose site rides somewhere else in the body — the assistant's
+ *   `context.hostId`, the agency batch's `sites[].hostId`;
+ * - a job already QUEUED for the site, which the jobs beat runs with no
+ *   request at all.
+ *
+ * The workspace half of AI never passes through here. The add-on, credits,
+ * allotments, overage charging and close-out, the billing webhooks and the
+ * staff doors carry no site, so no site's switch can stop them.
+ *
+ * Read with the Firestore handle the caller already runs on, never through
+ * the admin barrel: the jobs machine and its specs hold no default app.
+ */ /** What a person reads when a site's AI switch refused them. */ export const AI_OFF_FOR_SITE_COPY = 'AI is switched off for this site.';
+/** The refusal's status: the dispatcher's answer for a site-disabled plugin. */ export const AI_OFF_FOR_SITE_STATUS = 404;
+/**
+ * Whether AI runs on the site this host document describes, under this org.
+ *
+ * Fails OPEN on an absent host document, as the dispatcher does: a site that
+ * cannot be read is not a site that switched AI off, and the doors below this
+ * refuse an unknown site for reasons of their own.
+ */ export function isAiOnForSite(org, host) {
+    return isHostPluginEnabled(org != null ? org : null, host != null ? host : null, AI_PLUGIN_ID);
+}
+/**
+ * The shape of a site id this module will read. A request body names a site
+ * in free text, and a value carrying `/` is a different document PATH, which
+ * the SDK refuses by throwing — so anything that cannot be a site id is
+ * answered as no site rather than read.
+ */ const SITE_ID = /^[A-Za-z0-9_-]{1,128}$/;
+/**
+ * Whether the named site has AI switched off. `false` for no site: a request
+ * that names none is workspace-level, and no site's switch applies to it.
+ */ export async function isAiOffForSite(firestore, org, hostId) {
+    if (!hostId || !SITE_ID.test(hostId)) return false;
+    const snapshot = await firestore.collection('hosts').doc(hostId).get();
+    if (!snapshot.exists) return false;
+    return !isAiOnForSite(org, snapshot.data());
+}
+/** The door's answer when the site it names has AI switched off. */ export function aiOffForSiteResponse() {
+    return Response.json({
+        error: AI_OFF_FOR_SITE_COPY,
+        reason: 'site-off'
+    }, {
+        status: AI_OFF_FOR_SITE_STATUS
+    });
+}
+
+//# sourceMappingURL=ai-site-switch.js.map

package/src/lib/model/ai-site-switch.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/model/ai-site-switch.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 { isHostPluginEnabled } from '@aglyn/aglyn/plugin-manager/enabled-plugins'\nimport { AI_PLUGIN_ID } from '../constants'\n\n/**\n * AI switched off for ONE site (AGL-3028).\n *\n * A site switches AI off through its `disabledPlugins` deny-list, the same\n * field every per-site plugin switch writes. The plugin API dispatcher already\n * answers 404 for a door whose request names that site as a top-level\n * `hostId`, before the handler runs. What this module covers is everything\n * the dispatcher cannot see:\n *\n * - a door whose site rides somewhere else in the body — the assistant's\n *   `context.hostId`, the agency batch's `sites[].hostId`;\n * - a job already QUEUED for the site, which the jobs beat runs with no\n *   request at all.\n *\n * The workspace half of AI never passes through here. The add-on, credits,\n * allotments, overage charging and close-out, the billing webhooks and the\n * staff doors carry no site, so no site's switch can stop them.\n *\n * Read with the Firestore handle the caller already runs on, never through\n * the admin barrel: the jobs machine and its specs hold no default app.\n */\n\n/** What a person reads when a site's AI switch refused them. */\nexport const AI_OFF_FOR_SITE_COPY = 'AI is switched off for this site.'\n\n/** The refusal's status: the dispatcher's answer for a site-disabled plugin. */\nexport const AI_OFF_FOR_SITE_STATUS = 404\n\n/**\n * Whether AI runs on the site this host document describes, under this org.\n *\n * Fails OPEN on an absent host document, as the dispatcher does: a site that\n * cannot be read is not a site that switched AI off, and the doors below this\n * refuse an unknown site for reasons of their own.\n */\nexport function isAiOnForSite(org: unknown, host: unknown): boolean {\n  return isHostPluginEnabled(\n    (org ?? null) as { enabledPlugins?: string[] } | null,\n    (host ?? null) as { disabledPlugins?: string[]; enabledPlugins?: string[] } | null,\n    AI_PLUGIN_ID,\n  )\n}\n\n/**\n * The shape of a site id this module will read. A request body names a site\n * in free text, and a value carrying `/` is a different document PATH, which\n * the SDK refuses by throwing — so anything that cannot be a site id is\n * answered as no site rather than read.\n */\nconst SITE_ID = /^[A-Za-z0-9_-]{1,128}$/\n\n/**\n * Whether the named site has AI switched off. `false` for no site: a request\n * that names none is workspace-level, and no site's switch applies to it.\n */\nexport async function isAiOffForSite(\n  firestore: FirebaseFirestore.Firestore,\n  org: unknown,\n  hostId: string | null | undefined,\n): Promise<boolean> {\n  if (!hostId || !SITE_ID.test(hostId)) return false\n  const snapshot = await firestore.collection('hosts').doc(hostId).get()\n  if (!snapshot.exists) return false\n  return !isAiOnForSite(org, snapshot.data())\n}\n\n/** The door's answer when the site it names has AI switched off. */\nexport function aiOffForSiteResponse(): Response {\n  return Response.json(\n    { error: AI_OFF_FOR_SITE_COPY, reason: 'site-off' },\n    { status: AI_OFF_FOR_SITE_STATUS },\n  )\n}\n"],"names":["isHostPluginEnabled","AI_PLUGIN_ID","AI_OFF_FOR_SITE_COPY","AI_OFF_FOR_SITE_STATUS","isAiOnForSite","org","host","SITE_ID","isAiOffForSite","firestore","hostId","test","snapshot","collection","doc","get","exists","data","aiOffForSiteResponse","Response","json","error","reason","status"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED,SAASA,mBAAmB,QAAQ,8CAA6C;AACjF,SAASC,YAAY,QAAQ,kBAAc;AAE3C;;;;;;;;;;;;;;;;;;;;CAoBC,GAED,8DAA8D,GAC9D,OAAO,MAAMC,uBAAuB,oCAAmC;AAEvE,8EAA8E,GAC9E,OAAO,MAAMC,yBAAyB,IAAG;AAEzC;;;;;;CAMC,GACD,OAAO,SAASC,cAAcC,GAAY,EAAEC,IAAa;IACvD,OAAON,oBACJK,cAAAA,MAAO,MACPC,eAAAA,OAAQ,MACTL;AAEJ;AAEA;;;;;CAKC,GACD,MAAMM,UAAU;AAEhB;;;CAGC,GACD,OAAO,eAAeC,eACpBC,SAAsC,EACtCJ,GAAY,EACZK,MAAiC;IAEjC,IAAI,CAACA,UAAU,CAACH,QAAQI,IAAI,CAACD,SAAS,OAAO;IAC7C,MAAME,WAAW,MAAMH,UAAUI,UAAU,CAAC,SAASC,GAAG,CAACJ,QAAQK,GAAG;IACpE,IAAI,CAACH,SAASI,MAAM,EAAE,OAAO;IAC7B,OAAO,CAACZ,cAAcC,KAAKO,SAASK,IAAI;AAC1C;AAEA,kEAAkE,GAClE,OAAO,SAASC;IACd,OAAOC,SAASC,IAAI,CAClB;QAAEC,OAAOnB;QAAsBoB,QAAQ;IAAW,GAClD;QAAEC,QAAQpB;IAAuB;AAErC"}

package/src/lib/model/ai-storefront-claims.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';
+/**
+ * STOREFRONT COPY SAFETY (AGL-2916): the claims AI-written product copy may not
+ * make, checked in code on every answer rather than asked for in a prompt.
+ *
+ * A product description is published copy a shopper relies on, and a
+ * generator writing one from a name and a photo knows nothing a claim would
+ * rest on. So three kinds are refused outright, whatever the product:
+ *
+ *  - **health** — what a product cures, treats, heals or prevents, clinical or
+ *    medical proof, a regulator's approval, a doctor's recommendation;
+ *  - **financial** — returns, income or profit promised, an investment that
+ *    cannot lose;
+ *  - **legal** — legal advice, a legal guarantee, compliance or approval.
+ *
+ * A fourth kind is refused unless the merchant's own words already state it:
+ * a certification, an award, a license or an endorsement. The acceptable-use
+ * rules every AI request carries (`runtime/ai-runtime.ts`) forbid copy that
+ * claims an endorsement, certification or partnership not given as a fact,
+ * and the merchant's product text is the only such fact the generator has.
+ *
+ * The patterns name CLAIMS, not topics: "a sweet treat", "cured ham" and "a
+ * soothing lavender scent" are ordinary copy. A match is refused with the
+ * phrase quoted, so the one re-ask the generation loop allows can remove
+ * exactly that phrase.
+ *
+ * A price is refused the same way unless the merchant's own words state it:
+ * prices are the merchant's to set, and a generator never invents one.
+ */
+export type AiStorefrontClaimKind = 'health' | 'financial' | 'legal' | 'endorsement';
+export interface AiStorefrontCopySample {
+    /** Where the text sits in the answer, as `products[2].description`. */
+    at: string;
+    text: string;
+}
+/** One claim found, with the phrase that makes it. */
+export interface AiStorefrontClaim {
+    kind: AiStorefrontClaimKind;
+    at: string;
+    phrase: string;
+}
+/**
+ * Every claim the samples make that they may not. A certification, award,
+ * license or endorsement is allowed when the merchant's own words — the
+ * product's name and text, or the brief — contain the same phrase.
+ */
+export declare function findStorefrontClaims(samples: readonly AiStorefrontCopySample[], merchantWords?: string): AiStorefrontClaim[];
+/** A price in the samples that the merchant's own words do not state. */
+export declare function findInventedPrices(samples: readonly AiStorefrontCopySample[], merchantWords?: string): AiStorefrontClaim[];
+/**
+ * The claims as violations the generation loop re-asks for: one per kind, the
+ * phrases quoted in the detail the model is told, the places in `paths`.
+ */
+export declare function storefrontClaimViolations(claims: readonly AiStorefrontClaim[], prices?: readonly AiStorefrontClaim[]): AiDoctrineViolation[];