@aglyn/plugins-ai 1.0.0-beta.228 → 1.0.0-beta.230

package/src/lib/model/ai-site-build-progress.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/model/ai-site-build-progress.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 { aiJobKindNoun } from './ai-job-activity'\nimport type { AiJobSummary } from './ai-jobs.types'\n\n/**\n * What the \"Building your site\" page shows of a site job (AGL-3594): one row\n * a stage — planning the pages, then each page — with its state, the state\n * the whole job is in, and the job's one price.\n *\n * Read off the job summary every surface already follows: the plan step's\n * status, the plan's pages, and the pages the build has reported as outputs.\n * A scaffold builds its units in plan order and reports each page when it is\n * written, so the pages written so far are the first pages of the plan.\n *\n * Pure: no React, no request. The page and its spec read the same rows.\n */\n\nexport type AiSiteBuildRowState = 'done' | 'active' | 'waiting' | 'failed'\n\nexport interface AiSiteBuildRow {\n  id: string\n  label: string\n  state: AiSiteBuildRowState\n}\n\n/** Where the whole job stands, as the page's header and actions read it. */\nexport type AiSiteBuildPhase = 'working' | 'done' | 'stopped' | 'failed' | 'canceled'\n\nexport function aiSiteBuildPhase(job: Pick<AiJobSummary, 'status'>): AiSiteBuildPhase {\n  switch (job.status) {\n    case 'done':\n      return 'done'\n    case 'failed':\n      return 'failed'\n    case 'canceled':\n      return 'canceled'\n    case 'needs_review':\n    case 'needs_input':\n      return 'stopped'\n    default:\n      return 'working'\n  }\n}\n\nexport function aiSiteBuildRows(\n  job: Pick<AiJobSummary, 'status' | 'steps' | 'plan' | 'outputs' | 'review'>,\n): AiSiteBuildRow[] {\n  const phase = aiSiteBuildPhase(job)\n  const planStep = job.steps.find((step) => step.name === 'plan')\n  const planDone = planStep?.status === 'done' || Boolean(job.plan)\n  const stoppedHere = (active: boolean) => (phase === 'failed' || phase === 'stopped') && active\n  const planActive = !planDone\n  const rows: AiSiteBuildRow[] = [\n    {\n      id: 'plan',\n      label: 'Planning your pages',\n      state: planDone ? 'done' : stoppedHere(planActive) ? 'failed' : phase === 'working' ? 'active' : 'waiting',\n    },\n  ]\n  const pages = job.plan?.screens ?? []\n  const written = job.outputs.filter((output) => output.resource === 'screen').length\n  pages.forEach((page, index) => {\n    const done = index < written || phase === 'done'\n    const current = !done && index === written && planDone\n    rows.push({\n      id: `page-${index}`,\n      label: `Writing page ${index + 1} of ${pages.length}: ${page.title}`,\n      state: done ? 'done' : stoppedHere(current) ? 'failed' : current && phase === 'working' ? 'active' : 'waiting',\n    })\n  })\n  return rows\n}\n\n/**\n * The job's one price (AGL-3594), never a plan's on its own: what it has used\n * so far while it works, what it used once done, and, on a failure we gave\n * back, that nothing was charged.\n */\nexport function aiSiteBuildCreditsLine(\n  job: Pick<AiJobSummary, 'status' | 'creditsSpent' | 'refundedCredits'> & Partial<Pick<AiJobSummary, 'kind'>>,\n): string | null {\n  const spent = Math.max(0, job.creditsSpent ?? 0)\n  const refunded = Math.max(0, job.refundedCredits ?? 0)\n  const net = Math.max(0, spent - refunded)\n  const phase = aiSiteBuildPhase(job)\n  // What the job made, by its kind; a job that names none is a site's.\n  const subject = !job.kind || job.kind === 'site' ? 'This site' : aiJobKindNoun(job.kind) === 'AI job' ? 'This AI job' : `This ${aiJobKindNoun(job.kind)}`\n  if (refunded > 0 && net === 0) return `Nothing was charged — we refunded ${refunded} credits.`\n  if (phase === 'done') return `${subject} used ${net} credits.`\n  if (phase === 'working') return `Credits used so far: ${net}`\n  if (refunded > 0) return `${subject} used ${net} credits — we refunded ${refunded}.`\n  return net > 0 ? `${subject} used ${net} credits.` : null\n}\n\n/** The heading and the sentence under it, for one job's page in its current phase. */\nexport interface AiJobPageCopy {\n  heading: string\n  lede: string\n}\n\n/**\n * What one job's page says at the top (AGL-3594, AGL-3596). A site job reads\n * as \"Building your site\"; any other kind names what it makes — \"Building\n * your page\" — or, for a kind with no noun, the job itself.\n *\n * A guided site start publishes its pages when it finishes, and says so\n * (`sitePublish`): with a page live the heading is \"Your site is live\". A\n * done site job without that record — an older job, or one that was not a\n * guided start — built drafts, and says that instead.\n */\nexport function aiJobPageCopy(\n  job: Pick<AiJobSummary, 'kind' | 'status' | 'review' | 'error'> & Partial<Pick<AiJobSummary, 'sitePublish'>>,\n  brand: string,\n): AiJobPageCopy {\n  const phase = aiSiteBuildPhase(job)\n  const noun = job.kind === 'site' ? 'site' : aiJobKindNoun(job.kind)\n  const generic = noun === 'AI job'\n  // `products` is the one plural noun.\n  const isAre = noun.endsWith('s') ? 'are' : 'is'\n  const why = job.review?.message ?? job.error ?? null\n  if (phase === 'working') {\n    return {\n      heading: generic ? 'Your AI job is running' : `Building your ${noun}`,\n      lede:\n        job.kind === 'site'\n          ? `${brand} AI is planning your pages and writing each one. You can leave this page; it keeps going.`\n          : `${brand} AI is working on it. You can leave this page; it keeps going.`,\n    }\n  }\n  if (phase === 'done') {\n    const published = job.sitePublish?.published.length ?? 0\n    if (job.kind === 'site' && published > 0) {\n      return {\n        heading: 'Your site is live',\n        lede: job.sitePublish?.drafts.length\n          ? 'Your pages are published, except the ones listed below, which stayed drafts.'\n          : 'Your pages are published, and anyone can visit your site now.',\n      }\n    }\n    if (job.kind === 'site' && job.sitePublish) {\n      return {\n        heading: 'Your site is ready',\n        lede: 'None of your new pages could be published, so they are drafts. The reasons are below.',\n      }\n    }\n    return {\n      heading: generic ? 'Your AI job finished' : `Your ${noun} ${isAre} ready`,\n      lede:\n        job.kind === 'site'\n          ? 'Your new pages are drafts. Publish them when you’re happy.'\n          : 'Everything it built is an unpublished draft until you publish it.',\n    }\n  }\n  if (phase === 'canceled') {\n    return { heading: generic ? 'Your AI job was canceled' : `Your ${noun} was not built`, lede: 'The job was canceled.' }\n  }\n  return {\n    heading: generic ? 'Your AI job stopped' : `Your ${noun} ${noun.endsWith('s') ? 'were' : 'was'} not built`,\n    lede: why ?? (generic ? 'Something went wrong running this job.' : `Something went wrong building your ${noun}.`),\n  }\n}\n"],"names":["aiJobKindNoun","aiSiteBuildPhase","job","status","aiSiteBuildRows","phase","planStep","steps","find","step","name","planDone","Boolean","plan","stoppedHere","active","planActive","rows","id","label","state","pages","screens","written","outputs","filter","output","resource","length","forEach","page","index","done","current","push","title","aiSiteBuildCreditsLine","spent","Math","max","creditsSpent","refunded","refundedCredits","net","subject","kind","aiJobPageCopy","brand","noun","generic","isAre","endsWith","why","review","message","error","heading","lede","published","sitePublish","drafts"],"mappings":"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"}
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/model/ai-site-build-progress.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 { aiJobKindNoun } from './ai-job-activity'\nimport { aiJobRefundCopy } from './ai-job-failure-copy'\nimport { aiBuildItemRows, aiBuildOutcomeLine, aiSitePartialCopy } from './ai-build-progress'\nimport type { AiJobSummary } from './ai-jobs.types'\n\n/**\n * What the \"Building your site\" page shows of a site job (AGL-3594): one row\n * a stage — planning the pages, then each page — with its state, the state\n * the whole job is in, and the job's one price.\n *\n * Read off the job summary every surface already follows: the plan step's\n * status, the plan's pages, and the pages the build has reported as outputs.\n * A scaffold builds its units in plan order and reports each page when it is\n * written, so the pages written so far are the first pages of the plan.\n *\n * Pure: no React, no request. The page and its spec read the same rows.\n */\n\nexport type AiSiteBuildRowState = 'done' | 'active' | 'waiting' | 'failed' | 'skipped'\n\nexport interface AiSiteBuildRow {\n  id: string\n  label: string\n  state: AiSiteBuildRowState\n  /** What the person should know about this row (AGL-3616): a build item's failure, note or refund. */\n  detail?: string | null\n  /** What the row is doing while it is the active one, in a sentence. */\n  hint?: string | null\n  /** A page's planned sections, in order, so the person sees what is being written. */\n  sections?: string[]\n  /** The credits this row's work used, once it has finished; absent while it runs. */\n  credits?: number\n  /** When this row's work started, for the elapsed time beside the active row. */\n  startedAt?: string | null\n}\n\n/** Where the whole job stands, as the page's header and actions read it. */\nexport type AiSiteBuildPhase = 'working' | 'done' | 'stopped' | 'failed' | 'canceled'\n\nexport function aiSiteBuildPhase(job: Pick<AiJobSummary, 'status'>): AiSiteBuildPhase {\n  switch (job.status) {\n    case 'done':\n      return 'done'\n    case 'failed':\n      return 'failed'\n    case 'canceled':\n      return 'canceled'\n    case 'needs_review':\n    case 'needs_input':\n      return 'stopped'\n    default:\n      return 'working'\n  }\n}\n\n/** The creations a scaffold builds before its pages, in its build order, and what each row says. */\nconst CREATION_ROWS: ReadonlyArray<{ kind: string; resource: string; label: (name: string) => string }> = [\n  { kind: 'theme-change', resource: 'theme', label: () => 'Choosing your colors' },\n  { kind: 'layout', resource: 'layout', label: (name) => `Building the header and footer: ${name}` },\n  { kind: 'form', resource: 'form', label: (name) => `Building the form: ${name}` },\n]\n\n/**\n * One row a stage: planning, then each creation the plan builds before its\n * pages — the colors, the layout, the form — then each page (AGL-3596). A\n * scaffold builds them in that order and reports each as an output when it\n * is written, so the first row without its output is where the build is, and\n * where a failure stopped it: a layout that broke is the layout's row, never\n * the first page's.\n */\nexport function aiSiteBuildRows(\n  job: Pick<AiJobSummary, 'status' | 'steps' | 'plan' | 'outputs' | 'review'> &\n    Partial<Pick<AiJobSummary, 'items' | 'kind' | 'siteInputs' | 'sitePublish'>>,\n): AiSiteBuildRow[] {\n  const phase = aiSiteBuildPhase(job)\n  // A build is read off its item ledger (AGL-3616): one row an item, each with\n  // its own state and what became of its credits.\n  if (job.items?.length) {\n    const site = job.kind !== 'build'\n    const pages = (job.items ?? []).filter((row) => row.op === 'page')\n    return [\n      { id: 'plan', label: site ? 'Planning your pages' : 'Planning what to build', state: 'done' },\n      ...aiBuildItemRows(job).map((row, index) => {\n        const ledger = (job.items ?? [])[index]\n        // A site keeps the scaffold's own words for each stage (AGL-3596).\n        const label =\n          !site || !ledger\n            ? row.label\n            : ledger.op === 'theme'\n              ? 'Choosing your colors'\n              : ledger.op === 'layout'\n                ? `Building the header and footer: ${ledger.label}`\n                : ledger.op === 'form'\n                  ? `Building the form: ${ledger.label}`\n                  : ledger.op === 'page'\n                    ? `Writing page ${pages.indexOf(ledger) + 1} of ${pages.length}: ${ledger.label}`\n                    : ledger.op === 'email'\n                      ? 'Writing your welcome email'\n                      : row.label\n        const screen = ledger?.op === 'page' ? aiPlanScreenFor(job.plan, ledger.label, pages.indexOf(ledger)) : null\n        const finished = row.state === 'done' || row.state === 'failed'\n        const net = ledger ? Math.max(0, Math.floor((ledger.creditsSpent ?? 0) - (ledger.creditsRefunded ?? 0))) : 0\n        return {\n          id: row.slot,\n          label,\n          state: row.state,\n          detail: row.detail,\n          ...(screen?.sections.length ? { sections: screen.sections.map((section) => section.name) } : {}),\n          ...(finished && ledger ? { credits: net } : {}),\n        }\n      }),\n      ...aiSitePublishRow(job, phase),\n    ]\n  }\n  const planStep = job.steps.find((step) => step.name === 'plan')\n  const planDone = planStep?.status === 'done' || Boolean(job.plan)\n  const stopped = phase === 'failed' || phase === 'stopped'\n  const planState: AiSiteBuildRowState = planDone ? 'done' : stopped ? 'failed' : phase === 'working' ? 'active' : 'waiting'\n  const rows: AiSiteBuildRow[] = [\n    {\n      id: 'plan',\n      label: 'Planning your pages',\n      state: planState,\n      startedAt: planStep?.startedAt ?? null,\n      hint: planState === 'active' ? AI_SITE_PLAN_HINT : null,\n      ...(planDone && planStep ? { credits: Math.max(0, Math.floor(planStep.creditsSpent ?? 0)) } : {}),\n    },\n  ]\n  // Before there is a plan, the stages a guided start always goes through\n  // are named from its answers, so the page shows the whole way from the\n  // start rather than one row.\n  if (!job.plan && job.kind !== 'build') {\n    const pagesAsked = typeof job.siteInputs?.['pages'] === 'number' ? Math.round(job.siteInputs['pages'] as number) : 0\n    if (job.siteInputs) {\n      rows.push({ id: 'layout', label: 'Building the header and footer', state: 'waiting' })\n      rows.push({\n        id: 'pages',\n        label: pagesAsked > 1 ? `Writing your ${pagesAsked} pages` : 'Writing your pages',\n        state: 'waiting',\n      })\n      rows.push(...aiSitePublishRow(job, phase))\n    }\n    return rows\n  }\n  const built = new Map<string, number>()\n  for (const output of job.outputs) built.set(output.resource, (built.get(output.resource) ?? 0) + 1)\n  const take = (resource: string): boolean => {\n    const left = built.get(resource) ?? 0\n    if (left <= 0) return false\n    built.set(resource, left - 1)\n    return true\n  }\n  const stages: Array<{ id: string; label: string; resource: string; sections?: string[] }> = []\n  for (const row of CREATION_ROWS) {\n    const creation = job.plan?.create.find((entry) => entry.kind === row.kind)\n    if (creation) stages.push({ id: row.resource, label: row.label(creation.name), resource: row.resource })\n  }\n  const pages = job.plan?.screens ?? []\n  pages.forEach((page, index) => {\n    stages.push({\n      id: `page-${index}`,\n      label: `Writing page ${index + 1} of ${pages.length}: ${page.title}`,\n      resource: 'screen',\n      sections: page.sections.map((section) => section.name),\n    })\n  })\n  let reached = false\n  for (const stage of stages) {\n    const done = phase === 'done' || take(stage.resource)\n    const current = !done && !reached && planDone\n    if (current) reached = true\n    rows.push({\n      id: stage.id,\n      label: stage.label,\n      state: done ? 'done' : current && stopped ? 'failed' : current && phase === 'working' ? 'active' : 'waiting',\n      ...(stage.sections?.length ? { sections: stage.sections } : {}),\n    })\n  }\n  rows.push(...aiSitePublishRow(job, phase))\n  return rows\n}\n\n/** What the planning row says while it runs. */\nexport const AI_SITE_PLAN_HINT =\n  'Reading your answers and choosing your pages, what each one says, and the forms and layout they need. This usually takes under a minute.'\n\n/** The plan's page an item builds: by its title, else by its place among the pages. */\nfunction aiPlanScreenFor(\n  plan: AiJobSummary['plan'],\n  title: string,\n  index: number,\n): NonNullable<AiJobSummary['plan']>['screens'][number] | null {\n  const screens = plan?.screens ?? []\n  return screens.find((screen) => screen.title === title) ?? (index >= 0 ? (screens[index] ?? null) : null)\n}\n\n/**\n * A guided start ends by putting its pages live (AGL-3596): the last row, so\n * the person sees that step coming and when it is done. Only a site job\n * publishes on its own; a build publishes when asked, and says so in its plan.\n */\nfunction aiSitePublishRow(\n  job: Pick<AiJobSummary, 'status'> & Partial<Pick<AiJobSummary, 'kind' | 'sitePublish'>>,\n  phase: AiSiteBuildPhase,\n): AiSiteBuildRow[] {\n  if (job.kind !== 'site') return []\n  const published = (job.sitePublish?.published.length ?? 0) > 0\n  return [\n    {\n      id: 'publish',\n      label: 'Publishing your site',\n      // A job that stopped or failed publishes nothing, so the row is passed over.\n      state: phase === 'done' ? (published ? 'done' : 'skipped') : phase === 'working' ? 'waiting' : 'skipped',\n    },\n  ]\n}\n\n/**\n * How far the job is, from 0 to 1, by its rows: a finished row counts whole\n * and the active one half. `null` before there is more than one row to count.\n */\nexport function aiSiteBuildFraction(rows: readonly AiSiteBuildRow[]): number | null {\n  if (rows.length < 2) return null\n  const counted = rows.reduce(\n    (sum, row) => sum + (row.state === 'active' ? 0.5 : row.state === 'waiting' ? 0 : 1),\n    0,\n  )\n  return Math.min(1, counted / rows.length)\n}\n\n/**\n * The job's one price (AGL-3594), never a plan's on its own: what it has used\n * so far while it works, what it used once done, and, on a failure we gave\n * back, that nothing was charged.\n */\nexport function aiSiteBuildCreditsLine(\n  job: Pick<AiJobSummary, 'status' | 'creditsSpent' | 'refundedCredits'> & Partial<Pick<AiJobSummary, 'kind'>>,\n): string | null {\n  const spent = Math.max(0, job.creditsSpent ?? 0)\n  const refunded = Math.max(0, job.refundedCredits ?? 0)\n  const net = Math.max(0, spent - refunded)\n  const phase = aiSiteBuildPhase(job)\n  // What the job made, by its kind; a job that names none is a site's.\n  const subject = !job.kind || job.kind === 'site' ? 'This site' : aiJobKindNoun(job.kind) === 'AI job' ? 'This AI job' : `This ${aiJobKindNoun(job.kind)}`\n  // A failure on our side says so in the words every surface uses (AGL-3596),\n  // from the job's recorded give-back.\n  const refund = phase === 'working' || phase === 'done' ? null : aiJobRefundCopy(job)\n  if (refund && refunded > 0) return refund\n  if (phase === 'done') return `${subject} used ${net} credits.`\n  if (phase === 'working') return `Credits used so far: ${net}`\n  if (refund) return `${subject} used ${net} credits. ${refund}`\n  return net > 0 ? `${subject} used ${net} credits.` : null\n}\n\n/** The heading and the sentence under it, for one job's page in its current phase. */\nexport interface AiJobPageCopy {\n  heading: string\n  lede: string\n}\n\n/**\n * What one job's page says at the top (AGL-3594, AGL-3596). A site job reads\n * as \"Building your site\"; any other kind names what it makes — \"Building\n * your page\" — or, for a kind with no noun, the job itself.\n *\n * A guided site start publishes its pages when it finishes, and says so\n * (`sitePublish`): with a page live the heading is \"Your site is live\". A\n * done site job without that record — an older job, or one that was not a\n * guided start — built drafts, and says that instead.\n */\nexport function aiJobPageCopy(\n  job: Pick<AiJobSummary, 'kind' | 'status' | 'review' | 'error'> & Partial<Pick<AiJobSummary, 'sitePublish' | 'items'>>,\n  brand: string,\n): AiJobPageCopy {\n  const phase = aiSiteBuildPhase(job)\n  // A build is what the person asked for, item by item (AGL-3616).\n  if (job.kind === 'build') return aiBuildPageCopy(job, brand)\n  const noun = job.kind === 'site' ? 'site' : aiJobKindNoun(job.kind)\n  const generic = noun === 'AI job'\n  // `products` is the one plural noun.\n  const isAre = noun.endsWith('s') ? 'are' : 'is'\n  const why = job.review?.message ?? job.error ?? null\n  if (phase === 'working') {\n    return {\n      heading: generic ? 'Your AI job is running' : `Building your ${noun}`,\n      lede:\n        job.kind === 'site'\n          ? `${brand} AI is planning your pages and writing each one. You can leave this page; it keeps going.`\n          : `${brand} AI is working on it. You can leave this page; it keeps going.`,\n    }\n  }\n  if (phase === 'done') {\n    const published = job.sitePublish?.published.length ?? 0\n    // Part of the site was built (AGL-3616): what was, what was not, and its credits.\n    const partial = job.kind === 'site' ? aiSitePartialCopy({ items: job.items, status: job.status }) : null\n    if (job.kind === 'site' && published > 0) {\n      return {\n        heading: 'Your site is live',\n        lede: [\n          partial,\n          job.sitePublish?.drafts.length\n            ? 'Your pages are published, except the ones listed below, which stayed drafts.'\n            : 'Your pages are published, and anyone can visit your site now.',\n        ]\n          .filter(Boolean)\n          .join(' '),\n      }\n    }\n    if (partial) return { heading: 'Your site is ready', lede: `${partial} Your new pages are drafts. Publish them when you’re happy.` }\n    if (job.kind === 'site' && job.sitePublish) {\n      return {\n        heading: 'Your site is ready',\n        lede: 'None of your new pages could be published, so they are drafts. The reasons are below.',\n      }\n    }\n    return {\n      heading: generic ? 'Your AI job finished' : `Your ${noun} ${isAre} ready`,\n      lede:\n        job.kind === 'site'\n          ? 'Your new pages are drafts. Publish them when you’re happy.'\n          : 'Everything it built is an unpublished draft until you publish it.',\n    }\n  }\n  if (phase === 'canceled') {\n    return { heading: generic ? 'Your AI job was canceled' : `Your ${noun} was not built`, lede: 'The job was canceled.' }\n  }\n  return {\n    heading: generic ? 'Your AI job stopped' : `Your ${noun} ${noun.endsWith('s') ? 'were' : 'was'} not built`,\n    lede: why ?? (generic ? 'Something went wrong running this job.' : `Something went wrong building your ${noun}.`),\n  }\n}\n\n/** A build's page heading and sentence (AGL-3616). */\nfunction aiBuildPageCopy(\n  job: Pick<AiJobSummary, 'status' | 'review' | 'error'> & Partial<Pick<AiJobSummary, 'items' | 'sitePublish'>>,\n  brand: string,\n): AiJobPageCopy {\n  const phase = aiSiteBuildPhase(job)\n  const outcome = aiBuildOutcomeLine({ items: job.items ?? [], status: job.status })\n  if (phase === 'working') {\n    return {\n      heading: 'Building what you asked for',\n      lede: `${brand} AI is building each part in turn. You can leave this page; it keeps going.`,\n    }\n  }\n  if (phase === 'stopped') {\n    return {\n      heading: job.review?.reason === 'plan' ? 'Your plan is ready' : 'Your build needs you',\n      lede: job.review?.message ?? job.error ?? 'It waits for your decision.',\n    }\n  }\n  if (phase === 'done') {\n    const failed = (job.items ?? []).some((row) => row.status === 'failed' || row.status === 'skipped')\n    const live = job.sitePublish?.published.length ?? 0\n    return {\n      heading: failed ? 'Most of it is ready' : 'Everything you asked for is ready',\n      lede: [\n        outcome,\n        live ? 'Your new pages are published.' : 'Everything it built is an unpublished draft until you publish it.',\n        failed ? 'Try again builds only what failed.' : '',\n      ]\n        .filter(Boolean)\n        .join(' '),\n    }\n  }\n  if (phase === 'canceled') return { heading: 'Your build was canceled', lede: 'The job was canceled.' }\n  return {\n    heading: 'Nothing could be built',\n    lede: [job.error ?? 'Something went wrong building what you asked for.', outcome].filter(Boolean).join(' '),\n  }\n}\n"],"names":["aiJobKindNoun","aiJobRefundCopy","aiBuildItemRows","aiBuildOutcomeLine","aiSitePartialCopy","aiSiteBuildPhase","job","status","CREATION_ROWS","kind","resource","label","name","aiSiteBuildRows","planStep","built","phase","items","length","site","pages","filter","row","op","id","state","map","index","ledger","indexOf","screen","aiPlanScreenFor","plan","finished","net","Math","max","floor","creditsSpent","creditsRefunded","slot","detail","sections","section","credits","aiSitePublishRow","steps","find","step","planDone","Boolean","stopped","planState","rows","startedAt","hint","AI_SITE_PLAN_HINT","pagesAsked","siteInputs","round","push","Map","output","outputs","set","get","take","left","stages","creation","create","entry","screens","forEach","page","title","reached","stage","done","current","published","sitePublish","aiSiteBuildFraction","counted","reduce","sum","min","aiSiteBuildCreditsLine","spent","refunded","refundedCredits","subject","refund","aiJobPageCopy","brand","aiBuildPageCopy","noun","generic","isAre","endsWith","why","review","message","error","heading","lede","partial","drafts","join","outcome","reason","failed","some","live"],"mappings":"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"}

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

@@ -94,6 +94,22 @@ export declare function aiSiteSeoTitle(input: {
     subject: string;
     city?: string;
 }): string;
+/**
+ * The site's search description (AGL-3596): what the site is, then who it is
+ * for, composed WITHIN the description cap at phrase boundaries rather than
+ * cut at it. Cut at 155 characters, "…for dog owners in Hillside and nearby
+ * towns who want a calm, gentle" went out as a site's description. So the
+ * longest whole composition that fits wins: all of both; the audience without
+ * its trailing clauses; what the site is alone; then what the site is, cut
+ * back the same way. Only when not even the subject fits is it clipped at a
+ * word, never on a dangling one.
+ */
+export declare function aiSiteSeoDescription(input: {
+    name: string;
+    subject: string;
+    about: string;
+    audience: string;
+}): string;
 /**
  * What the listing is built from: either answer may be missing, because the
  * guided start requires only the first of them.

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

@@ -151,6 +151,52 @@ import { aiSiteWords } from "./ai-site-job.js";
     const fits = candidates.find((candidate)=>candidate.length <= max);
     return fits != null ? fits : clip(candidates[candidates.length - 1], max);
 }
+/**
+ * Where a phrase may be cut without leaving half a thought (AGL-3596): before
+ * a relative clause, or before a "with" or "for" phrase, or at a semicolon or
+ * dash. A bare comma is not one — "a calm, gentle groom" cut at its comma
+ * ends on an adjective — and neither is "and", which joins a list.
+ */ const PHRASE_BOUNDARY = /\s+(?:that|which|who|whose|where|while|because|with|for|offering|providing|serving)\b|[;(—–]|\s-\s/gi;
+/** A phrase and its shorter forms, longest first: itself, then cut before each boundary, back to front. */ function phraseForms(text) {
+    const forms = [
+        text
+    ];
+    const cuts = [
+        ...text.matchAll(PHRASE_BOUNDARY)
+    ].map((match)=>{
+        var _match_index;
+        return (_match_index = match.index) != null ? _match_index : -1;
+    }).filter((at)=>at > 0);
+    for (const at of cuts.reverse()){
+        const form = withoutDangling(text.slice(0, at).trim());
+        if (form && !forms.includes(form)) forms.push(form);
+    }
+    return forms;
+}
+/**
+ * The site's search description (AGL-3596): what the site is, then who it is
+ * for, composed WITHIN the description cap at phrase boundaries rather than
+ * cut at it. Cut at 155 characters, "…for dog owners in Hillside and nearby
+ * towns who want a calm, gentle" went out as a site's description. So the
+ * longest whole composition that fits wins: all of both; the audience without
+ * its trailing clauses; what the site is alone; then what the site is, cut
+ * back the same way. Only when not even the subject fits is it clipped at a
+ * word, never on a dangling one.
+ */ export function aiSiteSeoDescription(input) {
+    const max = AI_SITE_SEO_LIMITS.description;
+    const lead = (what)=>input.name ? `${input.name} is ${what}` : asSubject(what);
+    const abouts = phraseForms(withoutDangling(input.about.replace(/[.!?]+$/, '')));
+    const audiences = input.audience ? phraseForms(withoutDangling(input.audience.replace(/[.!?]+$/, ''))) : [];
+    for (const about of abouts){
+        for (const audience of audiences){
+            const text = sentence(`${lead(about)}, for ${audience}`);
+            if (text.length <= max) return text;
+        }
+        const text = sentence(lead(about));
+        if (text.length <= max) return text;
+    }
+    return clip(sentence(lead(abouts[abouts.length - 1] || input.subject)), max);
+}
 /**
  * The leading article dropped and the first letter raised: "a neighborhood
  * dog groomer" is how a person answers the question and is not how a title
@@ -173,8 +219,7 @@ import { aiSiteWords } from "./ai-site-job.js";
  * describe no site at all — a job with no `businessType` has nothing to
  * propose, and an empty proposal is worse than none.
  */ export function aiSiteSeoProposal(input) {
-    var _input_about, _input_siteName, _input_audience;
-    var _input_about1;
+    var _input_about, _input_siteName, _input_audience, _input_about1;
     const subject = asSubject((_input_about = input.about) != null ? _input_about : '');
     if (!subject) return null;
     const name = ((_input_siteName = input.siteName) != null ? _input_siteName : '').replace(/\s+/g, ' ').trim();
@@ -184,8 +229,13 @@ import { aiSiteWords } from "./ai-site-job.js";
         subject,
         city: input.city
     });
-    const described = name ? `${name} is ${(_input_about1 = input.about) == null ? void 0 : _input_about1.trim()}` : subject;
-    const description = clip(sentence(audience ? `${described}, for ${audience}` : described), AI_SITE_SEO_LIMITS.description);
+    const about = ((_input_about1 = input.about) != null ? _input_about1 : '').replace(/\s+/g, ' ').trim();
+    const description = aiSiteSeoDescription({
+        name,
+        subject,
+        about,
+        audience
+    });
     return {
         kind: AI_SITE_SEO_PROPOSAL_KIND,
         values: {

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

@@ -1 +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/**\n * Words a phrase never ends on (AGL-3596): a title cut after \"for\" or \"that\"\n * reads as broken mid-sentence, which a search result shows to everybody.\n */\nconst DANGLING = new Set([\n  'a', 'an', 'and', 'as', 'at', 'by', 'for', 'from', 'in', 'into', 'of', 'on', 'or', 'so',\n  'that', 'the', 'to', 'which', 'who', 'with', 'where', 'whose', 'while', 'your', 'our', '—', '-', '–', '&',\n])\n\n/** Without the words a phrase never ends on, or the punctuation before them. */\nfunction withoutDangling(text: string): string {\n  const words = text.split(' ')\n  while (words.length > 1 && DANGLING.has(words[words.length - 1].toLowerCase())) words.pop()\n  return words.join(' ').replace(/[\\s,;:—–-]+$/, '').trim()\n}\n\n/** Held to a length, cut at a word rather than mid-word, and never on a dangling 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 withoutDangling((space > max / 2 ? cut.slice(0, space) : text.slice(0, max)).trim())\n}\n\n/**\n * Where the first clause of an answer ends: \"a dog groomer in Austin THAT\n * takes bookings for…\" is a subject and then a sentence about it. A title\n * keeps the subject.\n */\nconst CLAUSE_BOUNDARY =\n  /\\s+(?:that|which|who|whose|where|offering|providing|specializing|serving|helping|so|because|with|for|to|by|and|but)\\b|[,;:(—–]|\\s-\\s/i\n\n/**\n * A short search title (AGL-3596): the business's name, what it is and where,\n * held to the title cap and never cut mid-phrase. The answer to \"what kind of\n * site\" is often a whole sentence, and cutting that sentence at sixty\n * characters published \"…that takes bookings for\" as a site's title.\n *\n * The longest of these that fits wins: the whole answer; its first clause\n * (the subject before \"that\", \"for\", a comma…); that clause without its\n * place. The city the person gave is added where the words do not already\n * say it, and the name leads where there is one. Only when even the shortest\n * does not fit is it cut, at a word, never on a dangling one.\n */\nexport function aiSiteSeoTitle(input: { name?: string; subject: string; city?: string }): string {\n  const max = AI_SITE_SEO_LIMITS.title\n  const name = (input.name ?? '').replace(/\\s+/g, ' ').trim()\n  const subject = withoutDangling(input.subject.replace(/\\s+/g, ' ').trim())\n  const city = (input.city ?? '').replace(/\\s+/g, ' ').trim()\n  const placed = (what: string) =>\n    city && !what.toLowerCase().includes(city.toLowerCase()) ? `${what} in ${city}` : what\n  const boundary = subject.search(CLAUSE_BOUNDARY)\n  const clause = withoutDangling(boundary > 0 ? subject.slice(0, boundary) : subject)\n  const bare = withoutDangling(clause.replace(/\\s+in\\s+[^]*$/i, '')) || clause\n  const whats = [...new Set([placed(subject), subject, placed(clause), clause, bare])]\n  const candidates = name ? [...whats.map((what) => `${name} — ${what}`), name] : whats\n  const fits = candidates.find((candidate) => candidate.length <= max)\n  return fits ?? clip(candidates[candidates.length - 1], max)\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  /** The city the person gave, where they gave one. */\n  city?: 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 = aiSiteSeoTitle({ name, subject, city: input.city })\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  const city = inputs?.['city']\n  return aiSiteSeoProposal({\n    ...words,\n    ...(typeof businessName === 'string' ? { siteName: businessName } : {}),\n    ...(typeof city === 'string' ? { city } : {}),\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","DANGLING","Set","withoutDangling","text","words","split","length","has","toLowerCase","pop","join","replace","trim","clip","value","max","cut","slice","space","lastIndexOf","CLAUSE_BOUNDARY","aiSiteSeoTitle","input","name","subject","city","placed","what","includes","boundary","search","clause","bare","whats","candidates","map","fits","find","candidate","asSubject","about","toUpperCase","sentence","trimmed","test","aiSiteSeoProposal","siteName","audience","described","kind","values","notes","aiSiteSeoProposalForInputs","inputs","businessName","isRecord","Array","isArray","aiSiteSeoProposalOf","outputs","output","resource","proposal","filter","note"],"mappings":"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"}
+{"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/**\n * Words a phrase never ends on (AGL-3596): a title cut after \"for\" or \"that\"\n * reads as broken mid-sentence, which a search result shows to everybody.\n */\nconst DANGLING = new Set([\n  'a', 'an', 'and', 'as', 'at', 'by', 'for', 'from', 'in', 'into', 'of', 'on', 'or', 'so',\n  'that', 'the', 'to', 'which', 'who', 'with', 'where', 'whose', 'while', 'your', 'our', '—', '-', '–', '&',\n])\n\n/** Without the words a phrase never ends on, or the punctuation before them. */\nfunction withoutDangling(text: string): string {\n  const words = text.split(' ')\n  while (words.length > 1 && DANGLING.has(words[words.length - 1].toLowerCase())) words.pop()\n  return words.join(' ').replace(/[\\s,;:—–-]+$/, '').trim()\n}\n\n/** Held to a length, cut at a word rather than mid-word, and never on a dangling 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 withoutDangling((space > max / 2 ? cut.slice(0, space) : text.slice(0, max)).trim())\n}\n\n/**\n * Where the first clause of an answer ends: \"a dog groomer in Austin THAT\n * takes bookings for…\" is a subject and then a sentence about it. A title\n * keeps the subject.\n */\nconst CLAUSE_BOUNDARY =\n  /\\s+(?:that|which|who|whose|where|offering|providing|specializing|serving|helping|so|because|with|for|to|by|and|but)\\b|[,;:(—–]|\\s-\\s/i\n\n/**\n * A short search title (AGL-3596): the business's name, what it is and where,\n * held to the title cap and never cut mid-phrase. The answer to \"what kind of\n * site\" is often a whole sentence, and cutting that sentence at sixty\n * characters published \"…that takes bookings for\" as a site's title.\n *\n * The longest of these that fits wins: the whole answer; its first clause\n * (the subject before \"that\", \"for\", a comma…); that clause without its\n * place. The city the person gave is added where the words do not already\n * say it, and the name leads where there is one. Only when even the shortest\n * does not fit is it cut, at a word, never on a dangling one.\n */\nexport function aiSiteSeoTitle(input: { name?: string; subject: string; city?: string }): string {\n  const max = AI_SITE_SEO_LIMITS.title\n  const name = (input.name ?? '').replace(/\\s+/g, ' ').trim()\n  const subject = withoutDangling(input.subject.replace(/\\s+/g, ' ').trim())\n  const city = (input.city ?? '').replace(/\\s+/g, ' ').trim()\n  const placed = (what: string) =>\n    city && !what.toLowerCase().includes(city.toLowerCase()) ? `${what} in ${city}` : what\n  const boundary = subject.search(CLAUSE_BOUNDARY)\n  const clause = withoutDangling(boundary > 0 ? subject.slice(0, boundary) : subject)\n  const bare = withoutDangling(clause.replace(/\\s+in\\s+[^]*$/i, '')) || clause\n  const whats = [...new Set([placed(subject), subject, placed(clause), clause, bare])]\n  const candidates = name ? [...whats.map((what) => `${name} — ${what}`), name] : whats\n  const fits = candidates.find((candidate) => candidate.length <= max)\n  return fits ?? clip(candidates[candidates.length - 1], max)\n}\n\n/**\n * Where a phrase may be cut without leaving half a thought (AGL-3596): before\n * a relative clause, or before a \"with\" or \"for\" phrase, or at a semicolon or\n * dash. A bare comma is not one — \"a calm, gentle groom\" cut at its comma\n * ends on an adjective — and neither is \"and\", which joins a list.\n */\nconst PHRASE_BOUNDARY = /\\s+(?:that|which|who|whose|where|while|because|with|for|offering|providing|serving)\\b|[;(—–]|\\s-\\s/gi\n\n/** A phrase and its shorter forms, longest first: itself, then cut before each boundary, back to front. */\nfunction phraseForms(text: string): string[] {\n  const forms = [text]\n  const cuts = [...text.matchAll(PHRASE_BOUNDARY)].map((match) => match.index ?? -1).filter((at) => at > 0)\n  for (const at of cuts.reverse()) {\n    const form = withoutDangling(text.slice(0, at).trim())\n    if (form && !forms.includes(form)) forms.push(form)\n  }\n  return forms\n}\n\n/**\n * The site's search description (AGL-3596): what the site is, then who it is\n * for, composed WITHIN the description cap at phrase boundaries rather than\n * cut at it. Cut at 155 characters, \"…for dog owners in Hillside and nearby\n * towns who want a calm, gentle\" went out as a site's description. So the\n * longest whole composition that fits wins: all of both; the audience without\n * its trailing clauses; what the site is alone; then what the site is, cut\n * back the same way. Only when not even the subject fits is it clipped at a\n * word, never on a dangling one.\n */\nexport function aiSiteSeoDescription(input: { name: string; subject: string; about: string; audience: string }): string {\n  const max = AI_SITE_SEO_LIMITS.description\n  const lead = (what: string) => (input.name ? `${input.name} is ${what}` : asSubject(what))\n  const abouts = phraseForms(withoutDangling(input.about.replace(/[.!?]+$/, '')))\n  const audiences = input.audience ? phraseForms(withoutDangling(input.audience.replace(/[.!?]+$/, ''))) : []\n  for (const about of abouts) {\n    for (const audience of audiences) {\n      const text = sentence(`${lead(about)}, for ${audience}`)\n      if (text.length <= max) return text\n    }\n    const text = sentence(lead(about))\n    if (text.length <= max) return text\n  }\n  return clip(sentence(lead(abouts[abouts.length - 1] || input.subject)), max)\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  /** The city the person gave, where they gave one. */\n  city?: 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 = aiSiteSeoTitle({ name, subject, city: input.city })\n  const about = (input.about ?? '').replace(/\\s+/g, ' ').trim()\n  const description = aiSiteSeoDescription({ name, subject, about, audience })\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  const city = inputs?.['city']\n  return aiSiteSeoProposal({\n    ...words,\n    ...(typeof businessName === 'string' ? { siteName: businessName } : {}),\n    ...(typeof city === 'string' ? { city } : {}),\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","DANGLING","Set","withoutDangling","text","words","split","length","has","toLowerCase","pop","join","replace","trim","clip","value","max","cut","slice","space","lastIndexOf","CLAUSE_BOUNDARY","aiSiteSeoTitle","input","name","subject","city","placed","what","includes","boundary","search","clause","bare","whats","candidates","map","fits","find","candidate","PHRASE_BOUNDARY","phraseForms","forms","cuts","matchAll","match","index","filter","at","reverse","form","push","aiSiteSeoDescription","lead","asSubject","abouts","about","audiences","audience","sentence","toUpperCase","trimmed","test","aiSiteSeoProposal","siteName","kind","values","notes","aiSiteSeoProposalForInputs","inputs","businessName","isRecord","Array","isArray","aiSiteSeoProposalOf","outputs","output","resource","proposal","note"],"mappings":"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"}

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

@@ -122,3 +122,17 @@ export declare function aiSiteStartBrief(answers: AiSiteStartAnswers): string;
  * on the site already.
  */
 export declare function aiSiteStartInputs(answers: AiSiteStartAnswers): Omit<AiSiteJobInputs, 'batchId'>;
+/** The site inputs a guided start's answers become, by name: what a summary carries back (AGL-3596). */
+export declare const AI_SITE_START_INPUT_KEYS: readonly ["businessType", "audience", "starter", "pages", "businessName", "city", "brand", "submissions", "welcomeEmail"];
+/** A site job's scalar inputs, and nothing else its inputs carry; `null` when it has none. */
+export declare function aiSiteStartInputsOf(inputs: Readonly<Record<string, unknown>> | null | undefined): Record<string, unknown> | null;
+/**
+ * A failed start's answers, back as the questions hold them (AGL-3596), so
+ * Try again reopens the guided start filled in for the person to adjust:
+ * the inverse of {@link aiSiteStartInputs}. Read defensively — an answer the
+ * questions no longer offer goes back to its default — and held to the
+ * workspace's page band. `null` when the inputs say no kind of site at all.
+ */
+export declare function aiSiteStartAnswersFromInputs(inputs: Readonly<Record<string, unknown>> | null | undefined, options?: {
+    freeTaste?: boolean;
+}): AiSiteStartAnswers | null;

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

@@ -157,5 +157,48 @@
         welcomeEmail: answers.welcomeEmail
     };
 }
+/** The site inputs a guided start's answers become, by name: what a summary carries back (AGL-3596). */ export const AI_SITE_START_INPUT_KEYS = [
+    'businessType',
+    'audience',
+    'starter',
+    'pages',
+    'businessName',
+    'city',
+    'brand',
+    'submissions',
+    'welcomeEmail'
+];
+/** A site job's scalar inputs, and nothing else its inputs carry; `null` when it has none. */ export function aiSiteStartInputsOf(inputs) {
+    if (!inputs) return null;
+    const kept = {};
+    for (const key of AI_SITE_START_INPUT_KEYS){
+        const value = inputs[key];
+        if (typeof value === 'string' || typeof value === 'number' || typeof value === 'boolean') kept[key] = value;
+    }
+    return Object.keys(kept).length ? kept : null;
+}
+/**
+ * A failed start's answers, back as the questions hold them (AGL-3596), so
+ * Try again reopens the guided start filled in for the person to adjust:
+ * the inverse of {@link aiSiteStartInputs}. Read defensively — an answer the
+ * questions no longer offer goes back to its default — and held to the
+ * workspace's page band. `null` when the inputs say no kind of site at all.
+ */ export function aiSiteStartAnswersFromInputs(inputs, options = {}) {
+    const text = (key)=>typeof (inputs == null ? void 0 : inputs[key]) === 'string' ? inputs[key].trim() : '';
+    const siteType = text('businessType');
+    if (!siteType) return null;
+    const band = aiSitePagesBand(options.freeTaste);
+    const pages = typeof (inputs == null ? void 0 : inputs['pages']) === 'number' ? Math.round(inputs['pages']) : AI_SITE_START_ANSWERS.pages;
+    const starter = text('starter');
+    const submissions = text('submissions');
+    return {
+        siteType,
+        audience: text('audience'),
+        example: AI_SITE_START_EXAMPLES.some((entry)=>entry.id === starter) ? starter : null,
+        pages: Math.min(band.max, Math.max(band.min, pages)),
+        submissions: AI_SITE_SUBMISSIONS.includes(submissions) ? submissions : AI_SITE_START_ANSWERS.submissions,
+        welcomeEmail: options.freeTaste ? false : (inputs == null ? void 0 : inputs['welcomeEmail']) !== false
+    };
+}
 
 //# sourceMappingURL=ai-site-start.js.map

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

@@ -1 +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_SUBMISSIONS,\n  aiSitePagesBand,\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(\n  answers: AiSiteStartAnswers,\n  options: { freeTaste?: boolean } = {},\n): string | null {\n  // The workspace's own band (AGL-3594): one or two pages on the Free taste.\n  const band = aiSitePagesBand(options.freeTaste)\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 (!Number.isInteger(answers.pages) || answers.pages < band.min || answers.pages > band.max) {\n    return `A site is planned with ${band.min} to ${band.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_SUBMISSIONS","aiSitePagesBand","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","options","band","freeTaste","trim","length","Number","isInteger","min","max","includes","aiSiteStartBrief","sentences","push","toLowerCase","join","aiSiteStartInputs","businessType","starter","businessName","city","brand"],"mappings":"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"}
+{"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_SUBMISSIONS,\n  aiSitePagesBand,\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(\n  answers: AiSiteStartAnswers,\n  options: { freeTaste?: boolean } = {},\n): string | null {\n  // The workspace's own band (AGL-3594): one or two pages on the Free taste.\n  const band = aiSitePagesBand(options.freeTaste)\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 (!Number.isInteger(answers.pages) || answers.pages < band.min || answers.pages > band.max) {\n    return `A site is planned with ${band.min} to ${band.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\n/** The site inputs a guided start's answers become, by name: what a summary carries back (AGL-3596). */\nexport const AI_SITE_START_INPUT_KEYS = [\n  'businessType',\n  'audience',\n  'starter',\n  'pages',\n  'businessName',\n  'city',\n  'brand',\n  'submissions',\n  'welcomeEmail',\n] as const\n\n/** A site job's scalar inputs, and nothing else its inputs carry; `null` when it has none. */\nexport function aiSiteStartInputsOf(\n  inputs: Readonly<Record<string, unknown>> | null | undefined,\n): Record<string, unknown> | null {\n  if (!inputs) return null\n  const kept: Record<string, unknown> = {}\n  for (const key of AI_SITE_START_INPUT_KEYS) {\n    const value = inputs[key]\n    if (typeof value === 'string' || typeof value === 'number' || typeof value === 'boolean') kept[key] = value\n  }\n  return Object.keys(kept).length ? kept : null\n}\n\n/**\n * A failed start's answers, back as the questions hold them (AGL-3596), so\n * Try again reopens the guided start filled in for the person to adjust:\n * the inverse of {@link aiSiteStartInputs}. Read defensively — an answer the\n * questions no longer offer goes back to its default — and held to the\n * workspace's page band. `null` when the inputs say no kind of site at all.\n */\nexport function aiSiteStartAnswersFromInputs(\n  inputs: Readonly<Record<string, unknown>> | null | undefined,\n  options: { freeTaste?: boolean } = {},\n): AiSiteStartAnswers | null {\n  const text = (key: string) => (typeof inputs?.[key] === 'string' ? (inputs[key] as string).trim() : '')\n  const siteType = text('businessType')\n  if (!siteType) return null\n  const band = aiSitePagesBand(options.freeTaste)\n  const pages = typeof inputs?.['pages'] === 'number' ? Math.round(inputs['pages'] as number) : AI_SITE_START_ANSWERS.pages\n  const starter = text('starter')\n  const submissions = text('submissions')\n  return {\n    siteType,\n    audience: text('audience'),\n    example: AI_SITE_START_EXAMPLES.some((entry) => entry.id === starter) ? starter : null,\n    pages: Math.min(band.max, Math.max(band.min, pages)),\n    submissions: (AI_SITE_SUBMISSIONS as readonly string[]).includes(submissions)\n      ? (submissions as AiSiteSubmissions)\n      : AI_SITE_START_ANSWERS.submissions,\n    welcomeEmail: options.freeTaste ? false : inputs?.['welcomeEmail'] !== false,\n  }\n}\n"],"names":["AI_SITE_INPUT_MAX_CHARS","AI_SITE_SUBMISSIONS","aiSitePagesBand","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","options","band","freeTaste","trim","length","Number","isInteger","min","max","includes","aiSiteStartBrief","sentences","push","toLowerCase","join","aiSiteStartInputs","businessType","starter","businessName","city","brand","AI_SITE_START_INPUT_KEYS","aiSiteStartInputsOf","inputs","kept","key","value","Object","keys","aiSiteStartAnswersFromInputs","text","Math","round","some"],"mappings":"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"}

package/src/lib/model/ai-svg.d.ts

@@ -0,0 +1,69 @@
+/**
+ * @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 { AiImageAspectRatio, AiSvgStyle } from '../providers/image-contract';
+/**
+ * The SVG an illustration arrives as (AGL-3602), and the one gate it passes
+ * before it is stored.
+ *
+ * A model writes SVG as text, and SVG is a document: it can carry script,
+ * event handlers, links out and HTML. The upload route strips all of that
+ * from anything it stores (`sanitize-svg`), so a dangerous answer could never
+ * be SERVED — but a stripped answer is no longer the picture the model meant,
+ * so this does not quietly accept one. Anything the sanitizer would have to
+ * remove, and anything a self-contained static picture has no use for, is a
+ * problem the model is told about and asked to fix once; a second answer with
+ * a problem is not stored at all.
+ *
+ * A picture that passes is:
+ *
+ * - one `<svg>` root in the SVG namespace, with a `viewBox` in the shape asked
+ *   for, and balanced tags;
+ * - at most `AI_SVG_MAX_BYTES`;
+ * - self-contained: no `<image>`, no `<foreignObject>`, no `<script>`, no
+ *   `<a>`, no event handler, no link or `url(…)` to anything but a `#fragment`
+ *   in the same document, no `@import` and no `@font-face`;
+ * - static: no `<animate>`, `<set>` or other animation element;
+ * - for a logo mark, free of `<text>`: a mark, never a wordmark;
+ * - unchanged by `sanitizeSvg`.
+ */
+/** The largest illustration stored, in bytes of UTF-8. */
+export declare const AI_SVG_MAX_BYTES: number;
+/** The `viewBox` each shape is drawn in. */
+export declare const AI_SVG_VIEWBOX: Readonly<Record<AiImageAspectRatio, string>>;
+export interface AiSvgProblem {
+    /** Stable per finding, for specs and logs. */
+    code: string;
+    /** What the model is told to fix. */
+    detail: string;
+}
+export interface AiSvgCheck {
+    /** The document to store, or `null` when it has a problem. */
+    svg: string | null;
+    problems: AiSvgProblem[];
+}
+/**
+ * The gate. `markup` is the model's answer; the result is the document to
+ * store, or the problems to send back.
+ */
+export declare function checkAiSvgMarkup(markup: unknown, aspectRatio: AiImageAspectRatio, style: AiSvgStyle): AiSvgCheck;
+/** A color a person may name: `#rgb` or `#rrggbb`. */
+export declare function isAiSvgColor(value: unknown): value is string;
+/**
+ * The colors a site's theme names, in the order a picture reaches for them:
+ * the primary and secondary colors first, then the backgrounds and text.
+ */
+export declare function aiSvgThemePalette(colors: Readonly<Record<string, string>> | null | undefined): string[];